import { defineComponent } from "../component";
import { defineRelationship } from "../relationship";

// ── Task component ────────────────────────────────────
/**
 * Core component for behaviour-tree tasks.
 *
 * `kind` determines how the task evaluates its children:
 * - `"leaf"` — terminal node; external logic drives it to completion.
 * - `"sequential"` — runs children one at a time, left to right.
 *   Succeeds when all children succeed; fails when any child fails.
 * - `"parallel"` — schedules all children at once.
 *   Succeeds when all children succeed; fails when any child fails.
 * - `"random"` — picks one child at random each time it's scheduled.
 *   Succeeds/fails with that child's result.
 */
export const Task = defineComponent("task", {
  kind: "leaf" as "leaf" | "sequential" | "parallel" | "random",
});

export type TaskKind = typeof Task.type["kind"];

// ── Status tags (zero-size — presence is the signal) ──
/** A task that should be executed this tick. */
export const Scheduled = defineComponent("scheduled", {});

/** A task that is currently executing (multi-frame leaves). */
export const Running = defineComponent("running", {});

/** The task completed successfully. */
export const Succeeded = defineComponent("succeeded", {});

/** The task failed. */
export const Failed = defineComponent("failed", {});

/** The task was cancelled externally. */
export const Cancelled = defineComponent("cancelled", {});

/** All terminal status tags. */
export const TERMINAL_TAGS = [Succeeded, Failed, Cancelled] as const;

// ── Relationship ──────────────────────────────────────
/** Parent → child edge in the task tree. */
export const ChildOf = defineRelationship("taskChild");