iris-ecs 0.0.1 → 0.0.2

package/dist/scheduler.d.ts

@@ -1,10 +1,69 @@
 import type { World } from "./world.js";
 /**
- * Schedule identifier.
+ * Schedule label brand for nominal typing.
+ */
+declare const SCHEDULE_LABEL_BRAND: unique symbol;
+/**
+ * Schedule label (branded string).
+ *
+ * Identifies a schedule within the pipeline. Built-in labels are provided
+ * for common lifecycle stages, custom labels created via defineSchedule().
+ */
+export type ScheduleLabel = string & {
+    [SCHEDULE_LABEL_BRAND]: true;
+};
+/**
+ * Define a custom schedule label.
+ *
+ * @param name - Schedule name (must be unique when inserted into pipeline)
+ * @returns Schedule label
+ *
+ * @example
+ * ```typescript
+ * const Physics = defineSchedule("Physics");
+ * insertScheduleAfter(world, Physics, PreUpdate);
+ * addSystem(world, gravitySystem, { schedule: Physics });
+ * ```
+ */
+export declare function defineSchedule(name: string): ScheduleLabel;
+/**
+ * Startup schedule. Runs once before the first frame.
+ */
+export declare const Startup: ScheduleLabel;
+/**
+ * Shutdown schedule. Runs once when stop() is called.
+ */
+export declare const Shutdown: ScheduleLabel;
+/**
+ * First schedule in the main loop. Runs every frame before PreUpdate.
  *
- * Provides autocomplete for common schedules while allowing custom names.
+ * @example
+ * ```typescript
+ * addSystem(world, inputSystem, { schedule: First });
+ * ```
+ */
+export declare const First: ScheduleLabel;
+/**
+ * Pre-update schedule. Runs every frame before Update.
+ */
+export declare const PreUpdate: ScheduleLabel;
+/**
+ * Update schedule. Default schedule for systems. Runs every frame.
+ *
+ * @example
+ * ```typescript
+ * addSystem(world, physicsSystem); // defaults to Update
+ * ```
  */
-export type ScheduleId = "runtime" | "startup" | "shutdown" | (string & {});
+export declare const Update: ScheduleLabel;
+/**
+ * Post-update schedule. Runs every frame after Update.
+ */
+export declare const PostUpdate: ScheduleLabel;
+/**
+ * Last schedule in the main loop. Runs every frame after PostUpdate.
+ */
+export declare const Last: ScheduleLabel;
 /**
  * System function signature.
  *
@@ -20,9 +79,9 @@ export type SystemOptions = {
      */
     name?: string;
     /**
-     * Schedule this system belongs to. Defaults to 'runtime'.
+     * Schedule this system belongs to. Defaults to Update.
      */
-    schedule?: ScheduleId;
+    schedule?: ScheduleLabel;
     /**
      * Run before these systems (within same schedule).
      */
@@ -43,7 +102,7 @@ export type SystemMeta = {
     /**
      * Schedule this system belongs to.
      */
-    schedule: ScheduleId;
+    schedule: ScheduleLabel;
     /**
      * Registration order (for stable sort).
      */
@@ -63,44 +122,87 @@ export type SystemMeta = {
  * @param world - World instance
  * @param runner - System function (must be named unless name option provided)
  * @param options - Registration options (name, schedule, before, after)
- * @returns void
+ *
  * @example
+ * ```typescript
  * addSystem(world, physicsSystem);
- * addSystem(world, renderSystem, { after: "physicsSystem" });
+ * addSystem(world, renderSystem, { schedule: PostUpdate, after: "physicsSystem" });
+ * ```
  */
 export declare function addSystem(world: World, runner: SystemRunner, options?: SystemOptions): void;
 /**
- * Builds an execution order from registered systems using topological sort.
- * Systems are ordered by before/after constraints, with registration order as tiebreaker.
+ * Insert a schedule before an existing schedule in the pipeline.
+ *
+ * @param world - World instance
+ * @param schedule - New schedule label to insert
+ * @param anchor - Existing schedule label to insert before
+ *
+ * @example
+ * ```typescript
+ * const Physics = defineSchedule("Physics");
+ * insertScheduleBefore(world, Physics, Update);
+ * ```
+ */
+export declare function insertScheduleBefore(world: World, schedule: ScheduleLabel, anchor: ScheduleLabel): void;
+/**
+ * Insert a schedule after an existing schedule in the pipeline.
  *
  * @param world - World instance
- * @param scheduleId - Schedule identifier (defaults to "runtime")
- * @returns void
+ * @param schedule - New schedule label to insert
+ * @param anchor - Existing schedule label to insert after
+ *
  * @example
- * buildSchedule(world);
- * buildSchedule(world, "startup");
+ * ```typescript
+ * const Render = defineSchedule("Render");
+ * insertScheduleAfter(world, Render, PostUpdate);
+ * ```
  */
-export declare function buildSchedule(world: World, scheduleId?: ScheduleId): void;
+export declare function insertScheduleAfter(world: World, schedule: ScheduleLabel, anchor: ScheduleLabel): void;
 /**
- * Executes a schedule synchronously. Throws if any system returns a Promise.
+ * Execute one frame. Runs startup on first call, then all pipeline schedules,
+ * then flushes events.
  *
  * @param world - World instance
- * @param scheduleId - Schedule identifier (defaults to "runtime")
- * @returns void
+ * @returns Promise that resolves when the frame completes
+ *
  * @example
- * executeSchedule(world);
- * executeSchedule(world, "startup");
+ * ```typescript
+ * // Game loop
+ * await runOnce(world);
+ * ```
  */
-export declare function executeSchedule(world: World, scheduleId?: ScheduleId): void;
+export declare function runOnce(world: World): Promise<void>;
 /**
- * Executes a schedule with async support. Awaits systems that return Promises.
+ * Start the main loop using requestAnimationFrame.
+ *
+ * Startup schedule runs automatically on first frame. Each frame executes
+ * all pipeline schedules in order. Call stop() to end the loop.
  *
  * @param world - World instance
- * @param scheduleId - Schedule identifier (defaults to "runtime")
- * @returns Promise that resolves when all systems complete
+ *
+ * @example
+ * ```typescript
+ * addSystem(world, physicsSystem);
+ * addSystem(world, renderSystem, { schedule: PostUpdate });
+ * run(world);
+ * // ... later
+ * await stop(world);
+ * ```
+ */
+export declare function run(world: World): void;
+/**
+ * Stop the main loop and run the shutdown schedule.
+ *
+ * @param world - World instance
+ * @returns Promise that resolves when shutdown completes
+ *
  * @example
- * await executeScheduleAsync(world);
- * await executeScheduleAsync(world, "startup");
+ * ```typescript
+ * run(world);
+ * // ... later
+ * await stop(world);
+ * ```
  */
-export declare function executeScheduleAsync(world: World, scheduleId?: ScheduleId): Promise<void>;
+export declare function stop(world: World): Promise<void>;
+export {};
 //# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMxC;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE5E;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,UAAU,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB;;OAEG;IACH,MAAM,EAAE,YAAY,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,UAAU,CAAC;IAErB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAuB3F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,GAAE,UAAsB,GAAG,IAAI,CAwFpF;AA0BD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,GAAE,UAAsB,GAAG,IAAI,CA2BtF;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,GAAE,UAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B1G"}
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMxC;;GAEG;AACH,OAAO,CAAC,MAAM,oBAAoB,EAAE,OAAO,MAAM,CAAC;AAElD;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IAAE,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAMtE;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAE1D;AAMD;;GAEG;AACH,eAAO,MAAM,OAAO,eAA4B,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,QAAQ,eAA6B,CAAC;AAEnD;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,eAA0B,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,SAAS,eAA8B,CAAC;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,eAA2B,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,UAAU,eAA+B,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,IAAI,eAAyB,CAAC;AAM3C;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB;;OAEG;IACH,MAAM,EAAE,YAAY,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,aAAa,CAAC;IAExB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAMF;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAyB3F;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAavG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAatG;AAoLD;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBzD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAOtC;AAyBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBtD"}

package/dist/scheduler.js

@@ -1,13 +1,79 @@
+import { flushEvents } from "./event.js";
+// ============================================================================
+// Schedule Definition
+// ============================================================================
+/**
+ * Define a custom schedule label.
+ *
+ * @param name - Schedule name (must be unique when inserted into pipeline)
+ * @returns Schedule label
+ *
+ * @example
+ * ```typescript
+ * const Physics = defineSchedule("Physics");
+ * insertScheduleAfter(world, Physics, PreUpdate);
+ * addSystem(world, gravitySystem, { schedule: Physics });
+ * ```
+ */
+export function defineSchedule(name) {
+    return name;
+}
+// ============================================================================
+// Built-in Schedule Labels
+// ============================================================================
+/**
+ * Startup schedule. Runs once before the first frame.
+ */
+export const Startup = defineSchedule("Startup");
+/**
+ * Shutdown schedule. Runs once when stop() is called.
+ */
+export const Shutdown = defineSchedule("Shutdown");
+/**
+ * First schedule in the main loop. Runs every frame before PreUpdate.
+ *
+ * @example
+ * ```typescript
+ * addSystem(world, inputSystem, { schedule: First });
+ * ```
+ */
+export const First = defineSchedule("First");
+/**
+ * Pre-update schedule. Runs every frame before Update.
+ */
+export const PreUpdate = defineSchedule("PreUpdate");
+/**
+ * Update schedule. Default schedule for systems. Runs every frame.
+ *
+ * @example
+ * ```typescript
+ * addSystem(world, physicsSystem); // defaults to Update
+ * ```
+ */
+export const Update = defineSchedule("Update");
+/**
+ * Post-update schedule. Runs every frame after Update.
+ */
+export const PostUpdate = defineSchedule("PostUpdate");
+/**
+ * Last schedule in the main loop. Runs every frame after PostUpdate.
+ */
+export const Last = defineSchedule("Last");
+// ============================================================================
+// System Registration
+// ============================================================================
 /**
  * Registers a system in the world for later scheduling.
  *
  * @param world - World instance
  * @param runner - System function (must be named unless name option provided)
  * @param options - Registration options (name, schedule, before, after)
- * @returns void
+ *
  * @example
+ * ```typescript
  * addSystem(world, physicsSystem);
- * addSystem(world, renderSystem, { after: "physicsSystem" });
+ * addSystem(world, renderSystem, { schedule: PostUpdate, after: "physicsSystem" });
+ * ```
  */
 export function addSystem(world, runner, options) {
     // Derive system name from function name or explicit option
@@ -23,33 +89,81 @@ export function addSystem(world, runner, options) {
     const after = options?.after;
     world.systems.byId.set(name, {
         runner,
-        schedule: options?.schedule ?? "runtime",
+        schedule: options?.schedule ?? Update,
         index: world.systems.nextIndex++,
         before: !before ? [] : Array.isArray(before) ? before : [before],
         after: !after ? [] : Array.isArray(after) ? after : [after],
     });
+    world.schedules.dirty = true;
 }
+// ============================================================================
+// Pipeline Management
+// ============================================================================
 /**
- * Builds an execution order from registered systems using topological sort.
- * Systems are ordered by before/after constraints, with registration order as tiebreaker.
+ * Insert a schedule before an existing schedule in the pipeline.
+ *
+ * @param world - World instance
+ * @param schedule - New schedule label to insert
+ * @param anchor - Existing schedule label to insert before
+ *
+ * @example
+ * ```typescript
+ * const Physics = defineSchedule("Physics");
+ * insertScheduleBefore(world, Physics, Update);
+ * ```
+ */
+export function insertScheduleBefore(world, schedule, anchor) {
+    const idx = world.schedules.pipeline.indexOf(anchor);
+    if (idx === -1) {
+        throw new Error(`Schedule "${anchor}" not found in pipeline`);
+    }
+    if (world.schedules.pipeline.includes(schedule)) {
+        throw new Error(`Schedule "${schedule}" already in pipeline`);
+    }
+    world.schedules.pipeline.splice(idx, 0, schedule);
+    world.schedules.dirty = true;
+}
+/**
+ * Insert a schedule after an existing schedule in the pipeline.
  *
  * @param world - World instance
- * @param scheduleId - Schedule identifier (defaults to "runtime")
- * @returns void
+ * @param schedule - New schedule label to insert
+ * @param anchor - Existing schedule label to insert after
+ *
  * @example
- * buildSchedule(world);
- * buildSchedule(world, "startup");
+ * ```typescript
+ * const Render = defineSchedule("Render");
+ * insertScheduleAfter(world, Render, PostUpdate);
+ * ```
+ */
+export function insertScheduleAfter(world, schedule, anchor) {
+    const idx = world.schedules.pipeline.indexOf(anchor);
+    if (idx === -1) {
+        throw new Error(`Schedule "${anchor}" not found in pipeline`);
+    }
+    if (world.schedules.pipeline.includes(schedule)) {
+        throw new Error(`Schedule "${schedule}" already in pipeline`);
+    }
+    world.schedules.pipeline.splice(idx + 1, 0, schedule);
+    world.schedules.dirty = true;
+}
+// ============================================================================
+// Schedule Building (Internal)
+// ============================================================================
+/**
+ * Builds an execution order from registered systems using topological sort.
+ * Systems are ordered by before/after constraints, with registration order as tiebreaker.
  */
-export function buildSchedule(world, scheduleId = "runtime") {
+function buildSchedule(world, scheduleLabel) {
     // Filter systems belonging to this schedule
     const scheduleSystems = new Map();
     for (const [name, meta] of world.systems.byId) {
-        if (meta.schedule === scheduleId) {
+        if (meta.schedule === scheduleLabel) {
             scheduleSystems.set(name, meta);
         }
     }
     if (scheduleSystems.size === 0) {
-        world.schedules.byId.set(scheduleId, []);
+        world.schedules.byId.set(scheduleLabel, []);
         return;
     }
     // Build dependency graph for Kahn's algorithm
@@ -63,7 +177,7 @@ export function buildSchedule(world, scheduleId = "runtime") {
     for (const [name, meta] of scheduleSystems) {
         for (const beforeName of meta.before) {
             if (!scheduleSystems.has(beforeName)) {
-                throw new Error(`System "${name}" references unknown system "${beforeName}" in schedule "${scheduleId}"`);
+                throw new Error(`System "${name}" references unknown system "${beforeName}" in schedule "${scheduleLabel}"`);
             }
             // "A before B" means edge A -> B (A must run first)
             adjacency.get(name).push(beforeName);
@@ -71,7 +185,7 @@ export function buildSchedule(world, scheduleId = "runtime") {
         }
         for (const afterName of meta.after) {
             if (!scheduleSystems.has(afterName)) {
-                throw new Error(`System "${name}" references unknown system "${afterName}" in schedule "${scheduleId}"`);
+                throw new Error(`System "${name}" references unknown system "${afterName}" in schedule "${scheduleLabel}"`);
             }
             // "A after B" means edge B -> A (B must run first)
             adjacency.get(afterName).push(name);
@@ -106,9 +220,9 @@ export function buildSchedule(world, scheduleId = "runtime") {
                 remaining.push(name);
             }
         }
-        throw new Error(`Circular dependency in schedule "${scheduleId}": ${remaining.join(", ")}`);
+        throw new Error(`Circular dependency in schedule "${scheduleLabel}": ${remaining.join(", ")}`);
     }
-    world.schedules.byId.set(scheduleId, result);
+    world.schedules.byId.set(scheduleLabel, result);
 }
 /**
  * Inserts a system name into the queue maintaining sorted order by registration index.
@@ -132,73 +246,155 @@ function insertSorted(queue, name, systems) {
     queue.splice(low, 0, name);
 }
 /**
- * Executes a schedule synchronously. Throws if any system returns a Promise.
- *
- * @param world - World instance
- * @param scheduleId - Schedule identifier (defaults to "runtime")
- * @returns void
- * @example
- * executeSchedule(world);
- * executeSchedule(world, "startup");
+ * Rebuilds all schedules in the pipeline plus Startup and Shutdown.
  */
-export function executeSchedule(world, scheduleId = "runtime") {
-    const order = world.schedules.byId.get(scheduleId);
-    if (!order) {
-        throw new Error(`Schedule "${scheduleId}" not built`);
+function rebuildPipeline(world) {
+    // Build Startup and Shutdown schedules
+    buildSchedule(world, Startup);
+    buildSchedule(world, Shutdown);
+    // Build all pipeline schedules
+    for (let i = 0; i < world.schedules.pipeline.length; i++) {
+        buildSchedule(world, world.schedules.pipeline[i]);
+    }
+    world.schedules.dirty = false;
+}
+// ============================================================================
+// Schedule Execution (Internal)
+// ============================================================================
+/**
+ * Executes a single schedule. Awaits async systems.
+ */
+async function executeSchedule(world, scheduleLabel) {
+    const order = world.schedules.byId.get(scheduleLabel);
+    if (!order || order.length === 0) {
+        return;
     }
     // Track execution context for systems that need to know their environment
-    world.execution.scheduleId = scheduleId;
-    world.execution.tick++;
+    world.execution.scheduleLabel = scheduleLabel;
     try {
         for (const systemId of order) {
+            world.execution.tick++;
             world.execution.systemId = systemId;
             const meta = world.systems.byId.get(systemId);
             const result = meta.runner(world);
-            // Fail fast if async system detected in sync execution
+            // Await async systems, sync systems pass through unchanged
             if (result instanceof Promise) {
-                throw new Error(`System "${systemId}" returned Promise - use runScheduleAsync`);
+                await result;
             }
         }
     }
     finally {
-        // Always clear execution context, even on error
-        world.execution.scheduleId = null;
+        world.execution.tick++;
+        world.execution.scheduleLabel = null;
         world.execution.systemId = null;
     }
 }
+// ============================================================================
+// Public Execution API
+// ============================================================================
 /**
- * Executes a schedule with async support. Awaits systems that return Promises.
+ * Execute one frame. Runs startup on first call, then all pipeline schedules,
+ * then flushes events.
  *
  * @param world - World instance
- * @param scheduleId - Schedule identifier (defaults to "runtime")
- * @returns Promise that resolves when all systems complete
+ * @returns Promise that resolves when the frame completes
+ *
  * @example
- * await executeScheduleAsync(world);
- * await executeScheduleAsync(world, "startup");
+ * ```typescript
+ * // Game loop
+ * await runOnce(world);
+ * ```
  */
-export async function executeScheduleAsync(world, scheduleId = "runtime") {
-    const order = world.schedules.byId.get(scheduleId);
-    if (!order) {
-        throw new Error(`Schedule "${scheduleId}" not built`);
+export async function runOnce(world) {
+    // Rebuild all schedules if pipeline is dirty
+    if (world.schedules.dirty) {
+        rebuildPipeline(world);
     }
-    // Track execution context for systems that need to know their environment
-    world.execution.scheduleId = scheduleId;
-    world.execution.tick++;
-    try {
-        for (const systemId of order) {
-            world.execution.systemId = systemId;
-            const meta = world.systems.byId.get(systemId);
-            const result = meta.runner(world);
-            // Await async systems, sync systems pass through unchanged
-            if (result instanceof Promise) {
-                await result;
-            }
+    // Run startup schedule on first call
+    if (!world.execution.startupRan) {
+        await executeSchedule(world, Startup);
+        world.execution.startupRan = true;
+        world.execution.shutdownRan = false;
+    }
+    // Run all pipeline schedules in order
+    for (let i = 0; i < world.schedules.pipeline.length; i++) {
+        await executeSchedule(world, world.schedules.pipeline[i]);
+    }
+    // Flush events at end of frame
+    flushEvents(world);
+}
+/**
+ * Start the main loop using requestAnimationFrame.
+ *
+ * Startup schedule runs automatically on first frame. Each frame executes
+ * all pipeline schedules in order. Call stop() to end the loop.
+ *
+ * @param world - World instance
+ *
+ * @example
+ * ```typescript
+ * addSystem(world, physicsSystem);
+ * addSystem(world, renderSystem, { schedule: PostUpdate });
+ * run(world);
+ * // ... later
+ * await stop(world);
+ * ```
+ */
+export function run(world) {
+    if (world.execution.running) {
+        return;
+    }
+    world.execution.running = true;
+    scheduleFrame(world);
+}
+/**
+ * Schedules the next animation frame for the game loop.
+ */
+function scheduleFrame(world) {
+    world.execution.rafHandle = requestAnimationFrame(async () => {
+        if (!world.execution.running) {
+            return;
+        }
+        try {
+            await runOnce(world);
+        }
+        catch (error) {
+            world.execution.running = false;
+            world.execution.rafHandle = null;
+            throw error;
+        }
+        if (world.execution.running) {
+            scheduleFrame(world);
         }
+    });
+}
+/**
+ * Stop the main loop and run the shutdown schedule.
+ *
+ * @param world - World instance
+ * @returns Promise that resolves when shutdown completes
+ *
+ * @example
+ * ```typescript
+ * run(world);
+ * // ... later
+ * await stop(world);
+ * ```
+ */
+export async function stop(world) {
+    world.execution.running = false;
+    if (world.execution.rafHandle !== null) {
+        cancelAnimationFrame(world.execution.rafHandle);
+        world.execution.rafHandle = null;
     }
-    finally {
-        // Always clear execution context, even on error
-        world.execution.scheduleId = null;
-        world.execution.systemId = null;
+    // Rebuild if needed before shutdown
+    if (world.schedules.dirty) {
+        rebuildPipeline(world);
+    }
+    if (!world.execution.shutdownRan) {
+        await executeSchedule(world, Shutdown);
+        world.execution.shutdownRan = true;
+        world.execution.startupRan = false;
     }
 }
 //# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"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"}