@ecsia/scheduler 0.1.0

package/dist/graph/waves.js

@@ -0,0 +1,133 @@
+// Wave extraction + type-level conflict detection v1 + batch packing. The reduced
+// DAG is layered into waves (Kahn by in-degree); within a wave, two systems may run concurrently iff
+// their access is DISJOINT at component-type granularity (WAVE-CONFLICT). This is the explicit
+// REJECTION of becsy lane-merging: readers of a component run concurrently.
+/**
+ * Rule WAVE-CONFLICT (v1, T5): A and B are concurrency-compatible iff write-sets
+ * are disjoint AND neither writes what the other reads. Pure read–read overlap is allowed.
+ * O(accessStrideWords) per pair — never per-entity, never per-archetype. This is the single seam a v2
+ * column-level build narrows.
+ */
+export function concurrencyCompatible(a, b) {
+    const n = a.writeWords.length;
+    for (let w = 0; w < n; w++) {
+        const aw = a.writeWords[w];
+        const bw = b.writeWords[w];
+        if (aw & bw)
+            return false; // write/write
+        if (aw & b.readWords[w])
+            return false; // a-write / b-read
+        if (a.readWords[w] & bw)
+            return false; // a-read / b-write
+    }
+    return true;
+}
+/**: topological layering by in-degree (Kahn). Deterministic intra-wave order: SystemId asc. */
+function extractWaves(dag) {
+    const n = dag.n;
+    const indeg = new Int32Array(n);
+    for (let u = 0; u < n; u++) {
+        for (const v of dag.succ[u])
+            indeg[v] += 1;
+    }
+    let ready = [];
+    for (let i = 0; i < n; i++)
+        if (indeg[i] === 0)
+            ready.push(i);
+    const waves = [];
+    let placed = 0;
+    while (ready.length > 0) {
+        ready.sort((a, b) => a - b); // deterministic order within a wave
+        const wave = ready.map((i) => i);
+        waves.push(wave);
+        placed += wave.length;
+        const next = [];
+        for (const u of ready) {
+            for (const v of dag.succ[u]) {
+                const vn = v;
+                if (--indeg[vn] === 0)
+                    next.push(vn);
+            }
+        }
+        ready = next;
+    }
+    if (placed !== n) {
+        // A cycle slipped through — impossible after dag.ts cycle detection, but assert for safety.
+        throw new Error(`wave extraction dropped systems (${placed}/${n}); a cycle escaped detection`);
+    }
+    return waves;
+}
+/**
+ *: partition a wave's systems into sequential rounds via greedy graph coloring over the
+ * incompatibility graph (`A—B` iff !concurrencyCompatible). Worker-ineligible systems are pinned to a
+ * main-thread slot (workerIndex -1); each round holds at most one main-thread slot.
+ */
+function packWave(wave, systems, workers) {
+    const rounds = [];
+    const perWorkerSpawn = new Uint32Array(Math.max(workers, 0));
+    for (const id of wave) {
+        const sb = systems[id];
+        let placed = false;
+        for (const round of rounds) {
+            const compatible = round.boxes.every((other) => concurrencyCompatible(sb, other));
+            if (!compatible)
+                continue;
+            if (sb.workerEligible) {
+                // Eligible system: assign to a worker slot if any worker exists, else the main-thread slot.
+                if (workers > 0 && round.nextWorker < workers) {
+                    const wi = round.nextWorker;
+                    round.nextWorker += 1;
+                    round.members.push({ systemId: id, workerIndex: wi });
+                    round.boxes.push(sb);
+                    if (workers > 0)
+                        perWorkerSpawn[wi] += sb.maxSpawnsPerWave;
+                    placed = true;
+                    break;
+                }
+                if (workers === 0 && !round.hasMainThreadSlot) {
+                    round.hasMainThreadSlot = true;
+                    round.members.push({ systemId: id, workerIndex: -1 });
+                    round.boxes.push(sb);
+                    placed = true;
+                    break;
+                }
+            }
+            else if (!round.hasMainThreadSlot) {
+                // Ineligible system: only the single main-thread slot per round.
+                round.hasMainThreadSlot = true;
+                round.members.push({ systemId: id, workerIndex: -1 });
+                round.boxes.push(sb);
+                placed = true;
+                break;
+            }
+        }
+        if (!placed) {
+            const wi = sb.workerEligible && workers > 0 ? 0 : -1;
+            const round = {
+                members: [{ systemId: id, workerIndex: wi }],
+                boxes: [sb],
+                hasMainThreadSlot: wi === -1,
+                nextWorker: wi === -1 ? 0 : 1,
+            };
+            if (wi >= 0)
+                perWorkerSpawn[wi] += sb.maxSpawnsPerWave;
+            rounds.push(round);
+        }
+    }
+    return {
+        rounds: rounds.map((r) => r.members),
+        perWorkerSpawnHint: perWorkerSpawn,
+    };
+}
+/** Build the immutable SchedulePlan from the reduced DAG. */
+export function buildPlan(systems, dag, accessStrideWords, workers) {
+    const waveIds = extractWaves(dag);
+    const waves = waveIds.map((wave) => packWave(wave, systems, workers));
+    return Object.freeze({
+        waves,
+        systems,
+        accessStrideWords,
+        workers,
+    });
+}
+//# sourceMappingURL=waves.js.map

package/dist/graph/waves.js.map

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

package/dist/graph/weights.d.ts

@@ -0,0 +1,7 @@
+export declare const enum EdgeWeight {
+    EXPLICIT = 5,// before/after — user-declared, never overridden
+    DENY = 4,// inAnyOrderWith(A,B) — suppresses an IMPLICIT edge between A,B
+    CLASS_HINT = 3,// beforeWritersOf(C) / afterReadersOf(C)
+    IMPLICIT = 1
+}
+//# sourceMappingURL=weights.d.ts.map

package/dist/graph/weights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weights.d.ts","sourceRoot":"","sources":["../../src/graph/weights.ts"],"names":[],"mappings":"AAGA,0BAAkB,UAAU;IAC1B,QAAQ,IAAI,CAAE,iDAAiD;IAC/D,IAAI,IAAI,CAAE,gEAAgE;IAC1E,UAAU,IAAI,CAAE,yCAAyC;IACzD,QAAQ,IAAI;CACb"}

package/dist/graph/weights.js

@@ -0,0 +1,10 @@
+// Priority-weighted conflict-edge scheme (becsy weight scheme). Highest weight
+// wins for an ordered pair; a DENY removes the IMPLICIT edge only (it cannot remove a 3/5 edge).
+export var EdgeWeight;
+(function (EdgeWeight) {
+    EdgeWeight[EdgeWeight["EXPLICIT"] = 5] = "EXPLICIT";
+    EdgeWeight[EdgeWeight["DENY"] = 4] = "DENY";
+    EdgeWeight[EdgeWeight["CLASS_HINT"] = 3] = "CLASS_HINT";
+    EdgeWeight[EdgeWeight["IMPLICIT"] = 1] = "IMPLICIT";
+})(EdgeWeight || (EdgeWeight = {}));
+//# sourceMappingURL=weights.js.map

package/dist/graph/weights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weights.js","sourceRoot":"","sources":["../../src/graph/weights.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,iGAAiG;AAEjG,MAAM,CAAN,IAAkB,UAKjB;AALD,WAAkB,UAAU;IAC1B,mDAAY,CAAA;IACZ,2CAAQ,CAAA;IACR,uDAAc,CAAA;IACd,mDAAY,CAAA;AACd,CAAC,EALiB,UAAU,KAAV,UAAU,QAK3B"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { defineSystem, inAnyOrderWith, beforeWritersOf, afterReadersOf } from './planner/index.js';
+export type { SystemDef, SystemContext, OrderingHint } from './planner/index.js';
+export { createScheduler } from './executor/index.js';
+export type { SchedulerHandle, CreateSchedulerOptions, RoundDispatcher } from './executor/index.js';
+export type { SchedulePlan, ScheduleWave, SystemBatch } from './graph/index.js';
+export type { SystemBox } from './planner/index.js';
+export { WorkerPool } from './workers/index.js';
+export type { PoolConfig, PoolSystem } from './workers/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAClG,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGhF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAQnG,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC/E,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAGnD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -0,0 +1,21 @@
+// @ecsia/scheduler — the system access graph (read/write declarations → conflict DAG), wave-level
+// topological layering with type-level conflict detection (v1), the CORRECT single-threaded executor
+// (wave order + serial slots for command-buffer flush and deferred observers), the world.update()
+// frame loop, and the parallel-READY seams (worker dispatch + Atomics wave-sync). DEPENDS ON
+// @ecsia/core; @ecsia/core NEVER imports this package (acyclic: schema ← core ← scheduler).
+//
+// The kernel runs single-threaded WITHOUT this module; the scheduler is an opt-in layer
+// Importing it + `createScheduler(world, systems).update(dt)` pulls in the DAG +
+// waves; nothing else changes for the user.
+//
+// PUBLIC SURFACE ONLY. The DAG/wave builders, command-buffer encoder, executor
+// run loop, and worker SAB primitives are implementation internals — they live in `./internal.ts`,
+// are NOT re-exported here, and are reached by this package's own tests through a relative import.
+// The umbrella (ecsia) re-exports exactly the symbols below.
+// --- planner: the system descriptor + ordering hints ---
+export { defineSystem, inAnyOrderWith, beforeWritersOf, afterReadersOf } from './planner/index.js';
+// --- executor: the opt-in frame scheduler ---
+export { createScheduler } from './executor/index.js';
+// --- workers: the worker pool the threaded frame loop drives ---
+export { WorkerPool } from './workers/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,qGAAqG;AACrG,kGAAkG;AAClG,6FAA6F;AAC7F,4FAA4F;AAC5F,EAAE;AACF,wFAAwF;AACxF,iFAAiF;AACjF,4CAA4C;AAC5C,EAAE;AACF,+EAA+E;AAC/E,mGAAmG;AACnG,mGAAmG;AACnG,6DAA6D;AAE7D,0DAA0D;AAC1D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGlG,+CAA+C;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAYrD,kEAAkE;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/internal.d.ts

@@ -0,0 +1,13 @@
+export { lowerSystems, aggregateAccess, DEFAULT_MAX_SPAWNS_PER_WAVE } from './planner/index.js';
+export type { SystemBox, AccessMaps } from './planner/index.js';
+export { EdgeWeight, resolveOrdering, buildEdges, buildDAG, CycleError, buildPlan, concurrencyCompatible, } from './graph/index.js';
+export type { Edge, DAG, SchedulePlan, ScheduleWave, SystemBatch } from './graph/index.js';
+export { buildSchedulePlan, runUpdate, runUpdateThreaded, runWave, buildScopedQueries, makeScopedQuery, } from './executor/index.js';
+export type { ExecutorEnv } from './executor/index.js';
+export { selectWaitTier } from './executor/seams.js';
+export type { WorkerMode, WaveSync, WaveCounter, WaveSyncTier, WaveSyncTierProbe, WorkerHandle, WorkerDispatch, } from './executor/seams.js';
+export { Op, recordLen, directApplySink, flushAll, makeCommandBuffer, resetBuffer, ensureWords, makeEncoder, buildFieldCodec, } from './commands/index.js';
+export type { CommandSink, StructuralIntent, WorldApply, CommandBuffer, BufferReservation, CommandEncoder, ComponentEncodeInfo, EncoderEnv, ComponentFieldCodec, } from './commands/index.js';
+export { makeWaveCounter, makeWaveSync, completeWave, setWaveError, waveErrored, workerHead, makeReservationSab, fillReservation, takeReserved, consumedCount, buildWorkerWorldView, matchComponentsOf, hasWaitAsync, waitAsync, } from './workers/index.js';
+export type { WorkerReservationSab, WorkerWorldView, WorkerSystemDef, WorkerSystemKernel, WorkerSystemBox, WorkerBootstrap, ComponentManifestEntry, DispatchMessage, WaitAsyncResult, } from './workers/index.js';
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAA;AAC/F,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE/D,OAAO,EACL,UAAU,EACV,eAAe,EACf,UAAU,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EACT,qBAAqB,GACtB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE1F,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,OAAO,EACP,kBAAkB,EAClB,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,YAAY,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,EAAE,EACF,SAAS,EACT,eAAe,EACf,QAAQ,EACR,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,WAAW,EACX,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,UAAU,EACV,mBAAmB,GACpB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,SAAS,GACV,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,eAAe,GAChB,MAAM,oBAAoB,CAAA"}

package/dist/internal.js

@@ -0,0 +1,12 @@
+// @ecsia/scheduler — INTERNAL surface. NOT part of the published package (`package.json#exports` only
+// maps `.` → index.ts). These are builders/primitives consumed by this package's own tests via a
+// RELATIVE import (`../src/internal.js`); they are deliberately kept OFF the public `index.ts` so the
+// published surface stays curated. No sibling package imports `@ecsia/scheduler`,
+// so nothing here is cross-package — it is test-reachable internals only.
+export { lowerSystems, aggregateAccess, DEFAULT_MAX_SPAWNS_PER_WAVE } from './planner/index.js';
+export { EdgeWeight, resolveOrdering, buildEdges, buildDAG, CycleError, buildPlan, concurrencyCompatible, } from './graph/index.js';
+export { buildSchedulePlan, runUpdate, runUpdateThreaded, runWave, buildScopedQueries, makeScopedQuery, } from './executor/index.js';
+export { selectWaitTier } from './executor/seams.js';
+export { Op, recordLen, directApplySink, flushAll, makeCommandBuffer, resetBuffer, ensureWords, makeEncoder, buildFieldCodec, } from './commands/index.js';
+export { makeWaveCounter, makeWaveSync, completeWave, setWaveError, waveErrored, workerHead, makeReservationSab, fillReservation, takeReserved, consumedCount, buildWorkerWorldView, matchComponentsOf, hasWaitAsync, waitAsync, } from './workers/index.js';
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,iGAAiG;AACjG,sGAAsG;AACtG,kFAAkF;AAClF,0EAA0E;AAE1E,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAA;AAG/F,OAAO,EACL,UAAU,EACV,eAAe,EACf,UAAU,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EACT,qBAAqB,GACtB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,OAAO,EACP,kBAAkB,EAClB,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAWpD,OAAO,EACL,EAAE,EACF,SAAS,EACT,eAAe,EACf,QAAQ,EACR,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,WAAW,EACX,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAa5B,OAAO,EACL,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,SAAS,GACV,MAAM,oBAAoB,CAAA"}

package/dist/planner/access.d.ts

@@ -0,0 +1,18 @@
+import type { ComponentId, SystemId } from '@ecsia/schema';
+import type { SystemBox, SystemDef } from './types.js';
+export interface AccessMaps {
+    /** Who reads each id. */
+    readonly readers: Map<ComponentId, Set<SystemId>>;
+    /** Who writes each id. */
+    readonly writers: Map<ComponentId, Set<SystemId>>;
+}
+/**
+ * Lower the registered SystemDefs into immutable SystemBoxes. `strideWords` is the single canonical
+ * fixed-component-id width (= accessStrideWords = ceil(registeredComponentCount/32)) shared with
+ * the bitmask and registry; it does NOT add a separate `+ numRelations` term ( C4)
+ * because presence ids are already counted.
+ */
+export declare function lowerSystems(defs: readonly SystemDef[], strideWords: number): SystemBox[];
+/** Aggregate the per-id reader/writer sets from the lowered systems' declared access only. */
+export declare function aggregateAccess(systems: readonly SystemBox[]): AccessMaps;
+//# sourceMappingURL=access.d.ts.map

package/dist/planner/access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../src/planner/access.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAgB,WAAW,EAAU,QAAQ,EAAE,MAAM,eAAe,CAAA;AAEhF,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEtD,MAAM,WAAW,UAAU;IACzB,yBAAyB;IACzB,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;IACjD,0BAA0B;IAC1B,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;CAClD;AA0CD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,CAoBzF;AAED,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,UAAU,CAgBzE"}

package/dist/planner/access.js

@@ -0,0 +1,92 @@
+// System registration & access aggregation. Lowers each declared `SystemDef` into
+// an immutable `SystemBox`, resolving the declared `{read,write}` ComponentDefs to dense ComponentIds
+// and packing them into fixed-width access signature words for the O(words) disjointness test.
+//
+// Pair IDs are component IDs: a declared read/write of a relation expands to the relation's
+// presence id, an ordinary ComponentId in the same dense space. The defs a user passes carry their
+// registered `.id` already, so resolution here is a `.id` read — no registry handle required.
+import { DEFAULT_MAX_SPAWNS_PER_WAVE } from './types.js';
+const UNREGISTERED = -1;
+function idOf(def) {
+    const id = def.id;
+    if (id === UNREGISTERED) {
+        throw new Error(`system declares access to component '${def.name}' which is not registered with this world`);
+    }
+    return id;
+}
+/** Sorted-ascending, de-duped ComponentIds for a declared access set. */
+function resolveIds(defs) {
+    if (defs === undefined || defs.length === 0)
+        return [];
+    const seen = new Set();
+    for (const def of defs)
+        seen.add(idOf(def));
+    return [...seen].sort((a, b) => a - b);
+}
+/** A system is worker-ineligible if any declared component carries a non-shareable (object) field. */
+function computeWorkerEligible(def) {
+    const all = [...(def.read ?? []), ...(def.write ?? [])];
+    for (const c of all) {
+        for (const f of c.fields) {
+            if (!f.shareable)
+                return false;
+        }
+    }
+    return true;
+}
+function packWords(ids, strideWords) {
+    const words = new Uint32Array(strideWords);
+    for (const c of ids) {
+        const i = c;
+        words[i >>> 5] = (words[i >>> 5] | (1 << (i & 31))) >>> 0;
+    }
+    return words;
+}
+/**
+ * Lower the registered SystemDefs into immutable SystemBoxes. `strideWords` is the single canonical
+ * fixed-component-id width (= accessStrideWords = ceil(registeredComponentCount/32)) shared with
+ * the bitmask and registry; it does NOT add a separate `+ numRelations` term ( C4)
+ * because presence ids are already counted.
+ */
+export function lowerSystems(defs, strideWords) {
+    return defs.map((def, i) => {
+        const readIds = resolveIds(def.read);
+        const writeIds = resolveIds(def.write);
+        return Object.freeze({
+            id: i,
+            name: def.name,
+            def,
+            run: def.run,
+            readIds,
+            writeIds,
+            readWords: packWords(readIds, strideWords),
+            writeWords: packWords(writeIds, strideWords),
+            // `before`/`after` resolved to SystemIds in graph/edges.ts (needs the full id map).
+            before: [],
+            after: [],
+            maxSpawnsPerWave: def.maxSpawnsPerWave ?? DEFAULT_MAX_SPAWNS_PER_WAVE,
+            workerEligible: computeWorkerEligible(def),
+        });
+    });
+}
+/** Aggregate the per-id reader/writer sets from the lowered systems' declared access only. */
+export function aggregateAccess(systems) {
+    const readers = new Map();
+    const writers = new Map();
+    const getOrInit = (m, c) => {
+        let s = m.get(c);
+        if (s === undefined) {
+            s = new Set();
+            m.set(c, s);
+        }
+        return s;
+    };
+    for (const sb of systems) {
+        for (const c of sb.readIds)
+            getOrInit(readers, c).add(sb.id);
+        for (const c of sb.writeIds)
+            getOrInit(writers, c).add(sb.id);
+    }
+    return { readers, writers };
+}
+//# sourceMappingURL=access.js.map

package/dist/planner/access.js.map

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

package/dist/planner/define-system.d.ts

@@ -0,0 +1,14 @@
+import type { ComponentDef, Schema } from '@ecsia/schema';
+import type { OrderingHint, SystemDef } from './types.js';
+export declare function defineSystem(def: SystemDef): SystemDef;
+/**
+ * Records a DENY (weight 4): suppress any IMPLICIT (weight 1) edge between `a` and `b` in both
+ * directions ("no implicit edge between these — the user knows it is safe"). Does NOT override an
+ * EXPLICIT (5) edge.
+ */
+export declare function inAnyOrderWith(a: SystemDef, b: SystemDef): OrderingHint;
+/** CLASS_HINT (weight 3): this system runs before all current writers of `c`. */
+export declare function beforeWritersOf(c: ComponentDef<Schema>): OrderingHint;
+/** CLASS_HINT (weight 3): this system runs after all current readers of `c`. */
+export declare function afterReadersOf(c: ComponentDef<Schema>): OrderingHint;
+//# sourceMappingURL=define-system.d.ts.map

package/dist/planner/define-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-system.d.ts","sourceRoot":"","sources":["../../src/planner/define-system.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEzD,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,CAQtD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,YAAY,CAEvE;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,YAAY,CAErE;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,YAAY,CAEpE"}

package/dist/planner/define-system.js

@@ -0,0 +1,30 @@
+// `defineSystem` + the ordering-hint combinators. `defineSystem` is
+// identity + light validation; it returns a branded SystemDef the scheduler consumes. The scheduler
+// never infers write-intent from runtime `entity.write(C)` calls — `read`/`write` here is the sole
+// conflict-detection source.
+export function defineSystem(def) {
+    if (typeof def.name !== 'string' || def.name.length === 0) {
+        throw new Error('defineSystem: `name` is required and must be a non-empty string');
+    }
+    if (typeof def.run !== 'function') {
+        throw new Error(`defineSystem('${def.name}'): \`run\` must be a function`);
+    }
+    return Object.freeze({ ...def, __ecsiaSystem: true });
+}
+/**
+ * Records a DENY (weight 4): suppress any IMPLICIT (weight 1) edge between `a` and `b` in both
+ * directions ("no implicit edge between these — the user knows it is safe"). Does NOT override an
+ * EXPLICIT (5) edge.
+ */
+export function inAnyOrderWith(a, b) {
+    return { kind: 'deny', a, b };
+}
+/** CLASS_HINT (weight 3): this system runs before all current writers of `c`. */
+export function beforeWritersOf(c) {
+    return { kind: 'beforeWritersOf', component: c };
+}
+/** CLASS_HINT (weight 3): this system runs after all current readers of `c`. */
+export function afterReadersOf(c) {
+    return { kind: 'afterReadersOf', component: c };
+}
+//# sourceMappingURL=define-system.js.map

package/dist/planner/define-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-system.js","sourceRoot":"","sources":["../../src/planner/define-system.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,oGAAoG;AACpG,mGAAmG;AACnG,6BAA6B;AAK7B,MAAM,UAAU,YAAY,CAAC,GAAc;IACzC,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;IACpF,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,CAAC,IAAI,gCAAgC,CAAC,CAAA;IAC5E,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,aAAa,EAAE,IAAa,EAAE,CAAC,CAAA;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,CAAY,EAAE,CAAY;IACvD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;AAC/B,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,eAAe,CAAC,CAAuB;IACrD,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC,EAAE,CAAA;AAClD,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,CAAuB;IACpD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC,EAAE,CAAA;AACjD,CAAC"}

package/dist/planner/index.d.ts

@@ -0,0 +1,6 @@
+export { defineSystem, inAnyOrderWith, beforeWritersOf, afterReadersOf } from './define-system.js';
+export { lowerSystems, aggregateAccess } from './access.js';
+export type { AccessMaps } from './access.js';
+export { DEFAULT_MAX_SPAWNS_PER_WAVE } from './types.js';
+export type { SystemDef, SystemContext, SystemBox, OrderingHint } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/planner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/planner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAClG,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC3D,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAA;AACxD,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/planner/index.js

@@ -0,0 +1,4 @@
+export { defineSystem, inAnyOrderWith, beforeWritersOf, afterReadersOf } from './define-system.js';
+export { lowerSystems, aggregateAccess } from './access.js';
+export { DEFAULT_MAX_SPAWNS_PER_WAVE } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/planner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/planner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAClG,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAA"}

package/dist/planner/types.d.ts

@@ -0,0 +1,74 @@
+import type { ComponentDef, ComponentId, Schema, SystemId, Tick } from '@ecsia/schema';
+import type { World } from '@ecsia/core';
+/** The context a system body receives each tick. */
+export interface SystemContext {
+    readonly world: World;
+    readonly dt: number;
+    readonly tick: Tick;
+    /** The same `query()` the world exposes, scoped (dev-mode access-guarded) for the wave. */
+    readonly query: World['query'];
+}
+/**
+ * An ordering hint produced by `inAnyOrderWith` / `beforeWritersOf` / `afterReadersOf`. These
+ * are passed in `SystemDef.order` (ecsia's surface for the becsy weight scheme) and resolved against
+ * the registered systems at plan time.
+ */
+export type OrderingHint = {
+    readonly kind: 'deny';
+    readonly a: SystemDef;
+    readonly b: SystemDef;
+} | {
+    readonly kind: 'beforeWritersOf';
+    readonly component: ComponentDef<Schema>;
+} | {
+    readonly kind: 'afterReadersOf';
+    readonly component: ComponentDef<Schema>;
+};
+export interface SystemDef {
+    readonly name: string;
+    /** Declared read access — scheduler conflict input. */
+    readonly read?: readonly ComponentDef<Schema>[];
+    /** Declared write access — the SOLE source of write-intent. */
+    readonly write?: readonly ComponentDef<Schema>[];
+    /** Explicit ordering: this runs BEFORE these (EdgeWeight.EXPLICIT = 5). */
+    readonly before?: readonly SystemDef[];
+    /** Explicit ordering: this runs AFTER these. */
+    readonly after?: readonly SystemDef[];
+    /** Coarse hints + denial edges. */
+    readonly order?: readonly OrderingHint[];
+    /** Reservation sizing for OP_CREATE mid-wave (default 64). */
+    readonly maxSpawnsPerWave?: number;
+    readonly run: (ctx: SystemContext) => void;
+    /** Branding marker so a plain object can't be mistaken for a validated SystemDef. */
+    readonly __ecsiaSystem?: true;
+}
+/**
+ * The internal lowered form. Immutable, declaration-derived ONLY: all
+ * plan-derived state lives in the separate `SchedulePlan` so it never goes stale across re-plans
+ * (report "Planner metadata on SystemBox mutable fields — stale across re-plans (HMR)").
+ */
+export interface SystemBox {
+    readonly id: SystemId;
+    readonly name: string;
+    readonly def: SystemDef;
+    readonly run: (ctx: SystemContext) => void;
+    /** Declared access, resolved to dense ComponentIds (pair ids included — ). Sorted, de-duped. */
+    readonly readIds: readonly ComponentId[];
+    readonly writeIds: readonly ComponentId[];
+    /** Packed access signatures for the O(words) disjointness test. length = accessStrideWords. */
+    readonly readWords: Uint32Array;
+    readonly writeWords: Uint32Array;
+    /** Explicit ordering edges, resolved to SystemIds. */
+    readonly before: readonly SystemId[];
+    readonly after: readonly SystemId[];
+    /** Reservation sizing for OP_CREATE mid-wave. */
+    readonly maxSpawnsPerWave: number;
+    /**
+     * Worker-eligibility: false if the system reads/writes any object<T> (restrictedToMainThread)
+     * component. Such a system is pinned to a main-thread batch; the
+     * object-field boundary is structural at schedule time, not a runtime throw.
+     */
+    readonly workerEligible: boolean;
+}
+export declare const DEFAULT_MAX_SPAWNS_PER_WAVE = 64;
+//# sourceMappingURL=types.d.ts.map

package/dist/planner/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/planner/types.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACtF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,2FAA2F;IAC3F,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;CAC/B;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC,MAAM,CAAC,CAAA;CAAE,GAC9E;IAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC,MAAM,CAAC,CAAA;CAAE,CAAA;AAEjF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uDAAuD;IACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;IAC/C,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;IAChD,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,SAAS,EAAE,CAAA;IACtC,gDAAgD;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,CAAA;IACrC,mCAAmC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IACxC,8DAA8D;IAC9D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAA;IAC1C,qFAAqF;IACrF,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAA;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAA;IACvB,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAA;IAE1C,gGAAgG;IAChG,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;IAEzC,+FAA+F;IAC/F,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAA;IAC/B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAA;IAEhC,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;IAEnC,iDAAiD;IACjD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IAEjC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;CACjC;AAED,eAAO,MAAM,2BAA2B,KAAK,CAAA"}

package/dist/planner/types.js

@@ -0,0 +1,6 @@
+// System-definition public types and the internal
+// lowered `SystemBox`. `defineSystem` lives in @ecsia/scheduler because the
+// kernel runs single-threaded WITHOUT this package (`defineSystem` + `world.update`
+// pull in the scheduler layer); a relation-free kernel never imports it.
+export const DEFAULT_MAX_SPAWNS_PER_WAVE = 64;
+//# sourceMappingURL=types.js.map

package/dist/planner/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/planner/types.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,4EAA4E;AAC5E,oFAAoF;AACpF,yEAAyE;AA6EzE,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAA"}

package/dist/workers/atomics-shim.d.ts

@@ -0,0 +1,8 @@
+export interface WaitAsyncResult {
+    readonly async: boolean;
+    readonly value: 'ok' | 'not-equal' | 'timed-out' | Promise<'ok' | 'timed-out'>;
+}
+export declare function hasWaitAsync(): boolean;
+/** Call Atomics.waitAsync. Caller MUST have probed `hasWaitAsync()` first. */
+export declare function waitAsync(view: Int32Array, index: number, value: number): WaitAsyncResult;
+//# sourceMappingURL=atomics-shim.d.ts.map

package/dist/workers/atomics-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomics-shim.d.ts","sourceRoot":"","sources":["../../src/workers/atomics-shim.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC,IAAI,GAAG,WAAW,CAAC,CAAA;CAC/E;AAMD,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAIzF"}

package/dist/workers/atomics-shim.js

@@ -0,0 +1,14 @@
+// Localized shim for Atomics.waitAsync (lib ES2023 omits it; it is the ES2024 addition). The runtime
+// (Node >= 20, capable browsers) provides it; we only need the type to call it on the tier-1 path.
+// Probed at runtime before use (selectWaitTier), so on engines that lack it this code never runs.
+export function hasWaitAsync() {
+    return typeof Atomics.waitAsync === 'function';
+}
+/** Call Atomics.waitAsync. Caller MUST have probed `hasWaitAsync()` first. */
+export function waitAsync(view, index, value) {
+    const fn = Atomics.waitAsync;
+    if (fn === undefined)
+        throw new Error('Atomics.waitAsync unavailable (probe with hasWaitAsync first)');
+    return fn(view, index, value);
+}
+//# sourceMappingURL=atomics-shim.js.map

package/dist/workers/atomics-shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomics-shim.js","sourceRoot":"","sources":["../../src/workers/atomics-shim.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,mGAAmG;AACnG,kGAAkG;AAWlG,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAQ,OAAgC,CAAC,SAAS,KAAK,UAAU,CAAA;AAC1E,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,SAAS,CAAC,IAAgB,EAAE,KAAa,EAAE,KAAa;IACtE,MAAM,EAAE,GAAI,OAAgC,CAAC,SAAS,CAAA;IACtD,IAAI,EAAE,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAA;IACtG,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;AAC/B,CAAC"}

package/dist/workers/index.d.ts

@@ -0,0 +1,13 @@
+export { WorkerPool } from './pool.js';
+export type { PoolConfig, PoolSystem } from './pool.js';
+export { makeWaveCounter, makeWaveSync, completeWave, setWaveError, waveErrored, workerHead } from './wave-sync.js';
+export { makeReservationSab, fillReservation, takeReserved, consumedCount } from './reservation.js';
+export type { WorkerReservationSab } from './reservation.js';
+export { buildWorkerWorldView } from './world-view.js';
+export type { WorkerWorldView } from './world-view.js';
+export { matchComponentsOf } from './worker-system.js';
+export type { WorkerSystemDef, WorkerSystemKernel, WorkerSystemBox } from './worker-system.js';
+export type { WorkerBootstrap, ComponentManifestEntry, DispatchMessage } from './manifest.js';
+export { hasWaitAsync, waitAsync } from './atomics-shim.js';
+export type { WaitAsyncResult } from './atomics-shim.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/workers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workers/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACnH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACnG,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC9F,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC7F,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/workers/index.js

@@ -0,0 +1,10 @@
+// @ecsia/scheduler/workers — the parallel execution layer: SAB allocation + one-time column/region
+// transfer to a fixed worker pool, the wave dispatch loop, the three-tier Atomics wave-sync, the
+// reservation Atomics.sub take path, and the deterministic command-buffer merge (serial-equivalence).
+export { WorkerPool } from './pool.js';
+export { makeWaveCounter, makeWaveSync, completeWave, setWaveError, waveErrored, workerHead } from './wave-sync.js';
+export { makeReservationSab, fillReservation, takeReserved, consumedCount } from './reservation.js';
+export { buildWorkerWorldView } from './world-view.js';
+export { matchComponentsOf } from './worker-system.js';
+export { hasWaitAsync, waitAsync } from './atomics-shim.js';
+//# sourceMappingURL=index.js.map

package/dist/workers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workers/index.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,iGAAiG;AACjG,sGAAsG;AAEtG,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACnH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAGtD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA"}