@ecsia/scheduler 0.1.0

package/dist/workers/wave-sync.js

@@ -0,0 +1,88 @@
+// The Atomics wave-completion fence and the three-tier wait. The main
+// thread dispatches a round's batches, then waits until every worker has decremented the SAB counter
+// to zero. The tier is chosen ONCE at world creation by the capability probe (selectWaitTier, seams.ts).
+//
+// WaveCounter words: [0]=remaining [1]=epoch [2]=errorFlag [3]=padding.
+import { waitAsync } from './atomics-shim.js';
+const REMAINING = 0;
+const EPOCH = 1;
+const ERROR = 2;
+/**
+ * Words [0..3] are the control block (remaining, epoch, errorFlag, padding); words [4..4+workers)
+ * are the per-worker buffer `head` each worker stores before completing, so the main thread reads the
+ * record count after the fence without any postMessage on the hot path (tier-2 blocking-main path).
+ */
+export function makeWaveCounter(workers) {
+    const sab = new SharedArrayBuffer((4 + Math.max(workers, 0)) * 4);
+    return { sab, view: new Int32Array(sab) };
+}
+export function workerHead(c, workerIndex) {
+    return Atomics.load(c.view, 4 + workerIndex);
+}
+/** Worker-side completion: the last decrementer wakes the waiter. */
+export function completeWave(c) {
+    if (Atomics.sub(c.view, REMAINING, 1) === 1)
+        Atomics.notify(c.view, REMAINING);
+}
+export function setWaveError(c) {
+    Atomics.store(c.view, ERROR, 1);
+}
+export function waveErrored(c) {
+    return Atomics.load(c.view, ERROR) === 1;
+}
+/**
+ * Build a WaveSync for the chosen tier. `await` MUST loop on Atomics.load(remaining) even after a
+ * wake (spurious wakeups + the epoch guard), resolving only when remaining === 0.
+ */
+export function makeWaveSync(tier) {
+    function begin(c, batchCount) {
+        Atomics.store(c.view, REMAINING, batchCount);
+        Atomics.add(c.view, EPOCH, 1); // epoch bump: a stale notify from a previous round is ignored
+        Atomics.store(c.view, ERROR, 0);
+    }
+    function awaitTier1(c) {
+        // Tier 1: Atomics.waitAsync — browser main thread (non-blocking). Loop until remaining === 0.
+        const step = async () => {
+            while (Atomics.load(c.view, REMAINING) !== 0) {
+                const r = waitAsync(c.view, REMAINING, Atomics.load(c.view, REMAINING));
+                if (r.async)
+                    await r.value;
+            }
+        };
+        return step();
+    }
+    function awaitTier2(c) {
+        // Tier 2: blocking Atomics.wait — Node main thread or coordinator/worker may block directly.
+        while (true) {
+            const remaining = Atomics.load(c.view, REMAINING);
+            if (remaining === 0)
+                return;
+            Atomics.wait(c.view, REMAINING, remaining);
+        }
+    }
+    async function awaitTier3(c) {
+        // Tier 3: promise-poll — SAB present, waitAsync absent. Poll on a microtask/timeout.
+        while (Atomics.load(c.view, REMAINING) !== 0) {
+            await new Promise((resolve) => setTimeout(resolve, 0));
+        }
+    }
+    return {
+        begin,
+        complete: completeWave,
+        await(c) {
+            switch (tier) {
+                case 'waitAsync':
+                    return awaitTier1(c);
+                case 'coordinator-block':
+                    return awaitTier2(c);
+                case 'promise-poll':
+                    return awaitTier3(c);
+                case 'postMessage':
+                    // No Atomics fence in the postMessage transport — the pool resolves the round on message
+                    // completion (pool.ts), so this is never reached. Provide a poll for safety.
+                    return awaitTier3(c);
+            }
+        },
+    };
+}
+//# sourceMappingURL=wave-sync.js.map

package/dist/workers/wave-sync.js.map

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

package/dist/workers/worker-entry.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worker-entry.d.ts.map

package/dist/workers/worker-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-entry.d.ts","sourceRoot":"","sources":["../../src/workers/worker-entry.ts"],"names":[],"mappings":""}

package/dist/workers/worker-entry.js

@@ -0,0 +1,187 @@
+// The worker thread body. Bootstraps the zero-copy world view from the SAB
+// manifest in workerData, imports the user's kernel module (the dispatch mechanism: kernels are
+// functions, resolved by importing the same source on the worker side — ), then
+// runs a blocking dispatch loop driven entirely by Atomics (no per-wave postMessage on the hot path):
+//
+// 1. Atomics.wait on the wake word for the next dispatch generation (tier-2 blocking wait, OFF the
+// main thread, so the Node main thread may itself block on the wave fence without deadlock).
+// 2. Read the work descriptor (systemId, dt, matched entity indices) from the shared work SAB.
+// 3. Run the system kernel over the indices — field writes to disjoint shared columns, structural
+// ops deferred to THIS worker's SAB command buffer.
+// 4. Store the buffer head into the shared heads SAB, then Atomics.sub-decrement the wave counter
+// (the last decrementer notifies the main thread).
+//
+// The worker NEVER mutates shared structure mid-wave and NEVER reads the bitmask.
+import { parentPort, workerData } from 'node:worker_threads';
+import { makeEncoder, buildFieldCodec } from '../commands/index.js';
+import { buildWorkerWorldView, makeWriteCorralWriter } from './world-view.js';
+import { completeWave, setWaveError } from './wave-sync.js';
+import { takeReserved } from './reservation.js';
+import { NO_ENTITY } from '@ecsia/core';
+const NO_ENTITY_BITS = NO_ENTITY >>> 0;
+const WAKE = 0;
+/** Work descriptor SAB layout: [0]=systemId [1]=count [2]=dtBits(f32) [3..]=entity indices (bytes 12). */
+const WORK_INDICES_BYTE_OFFSET = 12;
+async function main() {
+    const boot = workerData;
+    const mod = (await import(boot.kernelModule));
+    const { kernels, components: defByName } = mod.buildWorkerKernels();
+    // The SystemId→name mapping is the POOL's registration order (the bootstrap), NOT the kernel
+    // module's own order — so the worker runs the system the pool dispatched, by name.
+    const names = boot.systemNames;
+    // Align each worker-side ComponentDef id to the main thread's dense assignment
+    // so column keys and command-buffer componentIds match byte-for-byte. The kernel
+    // module's defineComponent calls leave id UNREGISTERED; the manifest carries the authoritative ids.
+    for (const c of boot.components) {
+        const def = defByName.get(c.name);
+        if (def !== undefined)
+            def.id = c.id;
+    }
+    const reservation = {
+        sab: boot.reservationSab,
+        view: new Int32Array(boot.reservationSab),
+        capacity: boot.reservationCapacity,
+    };
+    const cb = {
+        workerIndex: boot.workerIndex,
+        words: new Uint32Array(boot.commandSab),
+        head: 0,
+        recordCount: 0,
+        reservation: { handles: [] },
+        reservationCursor: 0,
+        appliedCreateCount: 0,
+        // The worker's buffer is the SAB the main thread reads in place — it is FIXED, never grown off the
+        // shared backing (review issue #3). On overflow `ensureWords` caps and sets `overflowed`.
+        fixed: true,
+        overflowed: false,
+    };
+    const codecCache = new Map();
+    const codecOf = (def) => {
+        const id = def.id;
+        let c = codecCache.get(id);
+        if (c === undefined) {
+            c = buildFieldCodec(def);
+            codecCache.set(id, c);
+        }
+        return c;
+    };
+    const encoder = makeEncoder({
+        cb,
+        infoOf(def) {
+            const id = def.id;
+            return { id, codec: codecOf(def) };
+        },
+        relationCodec() {
+            // Relation payload schemas are not yet replicated into the worker
+            // boot manifest, so no payload codec is available here → setRelation emits payloadWordCount=0. The
+            // pair add itself still flows (subject, relationId, target); only the payload leg is deferred.
+            return undefined;
+        },
+        warn(message) {
+            parentPort?.postMessage({ kind: 'diagnostic', message });
+        },
+    });
+    // OP_CREATE on the worker takes its handle from the SAB reservation cursor (Atomics.sub take path).
+    // On exhaustion takeReserved returns NO_ENTITY (0xffffffff): per
+    // NOTHING and return NO_ENTITY — NOT route a NO_ENTITY handle through baseCreate (which would append a
+    // spurious OP_CREATE 0xffffffff that the apply path would try to spawn → record-table corruption).
+    const baseCreate = encoder.create;
+    encoder.create = () => {
+        const h = takeReserved(reservation);
+        if (h >>> 0 === NO_ENTITY_BITS) {
+            parentPort?.postMessage({ kind: 'diagnostic', message: 'command-buffer: reservation exhausted; raise maxSpawnsPerWave (spawn capped)' });
+            return h;
+        }
+        cb.reservation = { handles: [h] };
+        cb.reservationCursor = 0;
+        return baseCreate();
+    };
+    const writeCorral = makeWriteCorralWriter(boot.writeCorralSab);
+    const view = buildWorkerWorldView(boot.buffers, boot.indexBitsMask, encoder, writeCorral);
+    const wake = new Int32Array(boot.wakeSab);
+    const work = new Int32Array(boot.workSab);
+    const workF32 = new Float32Array(boot.workSab);
+    const heads = new Int32Array(boot.waveSab); // word 4+: per-worker head (after the 4 counter words)
+    const waveCounter = { sab: boot.waveSab, view: new Int32Array(boot.waveSab) };
+    const notice = new Int32Array(boot.noticeSab); // [0] = main thread's published re-backing generation
+    const HEAD_WORD = 4 + boot.workerIndex;
+    // Pending `columns-added` broadcasts. The dispatch loop blocks on Atomics, so
+    // a posted message only drains when the loop yields to the event loop; on a NOTICE round the loop
+    // `await`s here so the queued broadcast is delivered before we re-wrap.
+    const noticeQueue = [];
+    let noticeWaiter;
+    let appliedNoticeGen = 0;
+    parentPort?.on('message', (msg) => {
+        if (msg?.kind === 'columns-added') {
+            noticeQueue.push(msg);
+            noticeWaiter?.();
+        }
+    });
+    const nextNotice = async () => {
+        if (noticeQueue.length > 0)
+            return noticeQueue.shift();
+        await new Promise((resolve) => {
+            noticeWaiter = resolve;
+        });
+        noticeWaiter = undefined;
+        return noticeQueue.shift();
+    };
+    let lastWake = 0;
+    parentPort?.postMessage({ kind: 'ready', workerIndex: boot.workerIndex });
+    while (true) {
+        Atomics.wait(wake, WAKE, lastWake);
+        const signal = Atomics.load(wake, WAKE);
+        if (signal === lastWake)
+            continue;
+        lastWake = signal;
+        if (signal < 0)
+            return; // shutdown sentinel
+        // NOTICE round: a column re-backed on the main thread. Drain the queued
+        // `columns-added` broadcast(s) up to the published generation, re-wrap the new SABs, then ACK by
+        // completing the wave fence. No system runs this wave; the next dispatch proceeds only after this.
+        const publishedGen = Atomics.load(notice, 0);
+        if (publishedGen !== appliedNoticeGen) {
+            try {
+                while (appliedNoticeGen !== publishedGen) {
+                    const msg = await nextNotice();
+                    view.applyColumnGrowth(msg.columns.map((c) => ({ key: c.key, backing: c.backing, layout: c.layout })));
+                    appliedNoticeGen = msg.generation;
+                }
+            }
+            catch (err) {
+                setWaveError(waveCounter);
+                parentPort?.postMessage({ kind: 'error', message: String(err) });
+            }
+            completeWave(waveCounter);
+            continue;
+        }
+        const systemId = Atomics.load(work, 0);
+        const count = Atomics.load(work, 1);
+        const dt = workF32[2];
+        cb.head = 0;
+        cb.recordCount = 0;
+        cb.overflowed = false;
+        writeCorral.reset();
+        const name = names[systemId];
+        const kernel = name !== undefined ? kernels.get(name) : undefined;
+        try {
+            if (kernel !== undefined && count > 0) {
+                const indices = new Int32Array(boot.workSab, WORK_INDICES_BYTE_OFFSET, count);
+                kernel(view, indices, dt);
+            }
+        }
+        catch (err) {
+            setWaveError(waveCounter);
+            parentPort?.postMessage({ kind: 'error', message: String(err) });
+        }
+        if (cb.overflowed) {
+            // The fixed SAB buffer filled: records were capped (not lost off-SAB, not a crash). `head` still
+            // lands on a record boundary <= the SAB length, so the main-thread apply reads exactly what fit.
+            parentPort?.postMessage({ kind: 'diagnostic', message: `command-buffer overflow on worker ${boot.workerIndex}; raise commandWords (records capped this wave)` });
+        }
+        Atomics.store(heads, HEAD_WORD, cb.head);
+        completeWave(waveCounter);
+    }
+}
+void main();
+//# sourceMappingURL=worker-entry.js.map

package/dist/workers/worker-entry.js.map

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

package/dist/workers/worker-system.d.ts

@@ -0,0 +1,31 @@
+import type { ComponentDef, Schema } from '@ecsia/schema';
+import type { WorkerWorldView } from './world-view.js';
+import type { OrderingHint, SystemDef } from '../planner/index.js';
+export interface WorkerSystemKernel {
+    (view: WorkerWorldView, indices: Int32Array, dt: number): void;
+}
+export interface WorkerSystemDef {
+    readonly name: string;
+    readonly read?: readonly ComponentDef<Schema>[];
+    readonly write?: readonly ComponentDef<Schema>[];
+    readonly before?: readonly WorkerSystemDef[];
+    readonly after?: readonly WorkerSystemDef[];
+    readonly order?: readonly OrderingHint[];
+    readonly maxSpawnsPerWave?: number;
+    /** The worker-runnable per-batch body. Receives the matched entity indices for this dispatch. */
+    readonly kernel: WorkerSystemKernel;
+}
+/** Components a worker system reads + writes — the matching set the main thread uses for dispatch. */
+export declare function matchComponentsOf(def: WorkerSystemDef): readonly ComponentDef<Schema>[];
+/**
+ * A worker system carries its `kernel` on the SystemDef so the executor can dispatch it to a worker
+ * AND run it on the main thread. The `run` body (used by the single-thread executor's runSystem path)
+ * is a thin adapter the scheduler installs when it has the main-thread WorkerWorldView; until then it
+ * throws if invoked outside the worker-aware executor.
+ */
+export interface WorkerSystemBox {
+    readonly def: SystemDef;
+    readonly kernel: WorkerSystemKernel;
+    readonly matchComponents: readonly ComponentDef<Schema>[];
+}
+//# sourceMappingURL=worker-system.d.ts.map

package/dist/workers/worker-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-system.d.ts","sourceRoot":"","sources":["../../src/workers/worker-system.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAElE,MAAM,WAAW,kBAAkB;IACjC,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/D;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,iGAAiG;IACjG,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;CACpC;AAED,sGAAsG;AACtG,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,eAAe,GAAG,SAAS,YAAY,CAAC,MAAM,CAAC,EAAE,CAKvF;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;IACnC,QAAQ,CAAC,eAAe,EAAE,SAAS,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;CAC1D"}

package/dist/workers/worker-system.js

@@ -0,0 +1,20 @@
+// A WORKER-ELIGIBLE system: its body is expressed against the
+// `WorkerWorldView` (shared-SAB column field access + the command encoder) and an explicit list of
+// matched entity indices, so the SAME kernel runs identically on a worker thread (over the shared
+// buffer set) and on the main thread (single-thread mode) — the structural guarantee behind
+// serial-equivalence: there is ONE body, not two.
+//
+// The main thread does the bitmask-free archetype MATCHING (it owns the query engine) and hands the
+// worker the matched entity indices; the worker runs the per-entity kernel reading ARCHETYPE TABLES
+// ONLY (never the bitmask). Field writes go to disjoint shared columns; structural ops
+// are deferred to the worker's command buffer.
+/** Components a worker system reads + writes — the matching set the main thread uses for dispatch. */
+export function matchComponentsOf(def) {
+    const set = new Map();
+    for (const c of def.read ?? [])
+        set.set(c, true);
+    for (const c of def.write ?? [])
+        set.set(c, true);
+    return [...set.keys()];
+}
+//# sourceMappingURL=worker-system.js.map

package/dist/workers/worker-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-system.js","sourceRoot":"","sources":["../../src/workers/worker-system.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,mGAAmG;AACnG,kGAAkG;AAClG,4FAA4F;AAC5F,kDAAkD;AAClD,EAAE;AACF,oGAAoG;AACpG,oGAAoG;AACpG,uFAAuF;AACvF,+CAA+C;AAsB/C,sGAAsG;AACtG,MAAM,UAAU,iBAAiB,CAAC,GAAoB;IACpD,MAAM,GAAG,GAAG,IAAI,GAAG,EAA8B,CAAA;IACjD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE;QAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;IAChD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE;QAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;IACjD,OAAO,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;AACxB,CAAC"}

package/dist/workers/world-view.d.ts

@@ -0,0 +1,39 @@
+import type { ColumnGrowthNotice, RegionKey, SharedHandleManifest } from '@ecsia/core';
+import type { CommandEncoder } from '../commands/index.js';
+declare const REC_ARCH_ID: RegionKey;
+declare const REC_ARCH_ROW: RegionKey;
+export interface WorkerWorldView {
+    /** (archetypeId, row) of an entity index, from the shared record regions. */
+    locationOf(index: number): {
+        archetypeId: number;
+        row: number;
+    };
+    /** Read field `fieldIndex` of component `componentId` for entity index `index`. */
+    readField(index: number, componentId: number, fieldIndex: number): number;
+    /** Write field `fieldIndex` of component `componentId` for entity index `index` (disjoint SAB write). */
+    writeField(index: number, componentId: number, fieldIndex: number, value: number): void;
+    /** The structural-op encoder for this worker (defers create/destroy/add/remove to the command buffer). */
+    readonly commands: CommandEncoder;
+    /**
+     * Re-wrap re-backed columns onto their new SAB. The
+     * pool drains the main thread's re-backing journal at the wave fence and delivers the new backings
+     * here BEFORE the next dispatch, so the worker stops reading the abandoned buffer. In-place `.grow()`
+     * never produces a notice — those views length-track automatically.
+     */
+    applyColumnGrowth(notices: readonly ColumnGrowthNotice[]): void;
+}
+/**
+ * Worker write-corral writer. Wraps the per-worker corral SAB. `push`
+ * stages one `(index, componentId)` value-write entry: word [0] is the running entry count, entries
+ * follow as `[index, componentId]` pairs. Single-writer (this worker only), no atomics — the main
+ * thread reads it only after the wave fence. On overflow the corral caps (the merge would read past
+ * the SAB otherwise); the cap is diagnosed at merge time by the pool.
+ */
+export interface WriteCorralWriter {
+    push(index: number, componentId: number): void;
+    reset(): void;
+}
+export declare function makeWriteCorralWriter(sab: SharedArrayBuffer): WriteCorralWriter;
+export declare function buildWorkerWorldView(manifest: SharedHandleManifest, indexBitsMask: number, commands: CommandEncoder, writeCorral?: WriteCorralWriter): WorkerWorldView;
+export { REC_ARCH_ID, REC_ARCH_ROW };
+//# sourceMappingURL=world-view.d.ts.map

package/dist/workers/world-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-view.d.ts","sourceRoot":"","sources":["../../src/workers/world-view.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAA0B,SAAS,EAAE,oBAAoB,EAAc,MAAM,aAAa,CAAA;AAC1H,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,QAAA,MAAM,WAAW,EAA2B,SAAS,CAAA;AACrD,QAAA,MAAM,YAAY,EAA4B,SAAS,CAAA;AAavD,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/D,mFAAmF;IACnF,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAA;IACzE,yGAAyG;IACzG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACvF,0GAA0G;IAC1G,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC;;;;;OAKG;IACH,iBAAiB,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI,CAAA;CAChE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9C,KAAK,IAAI,IAAI,CAAA;CACd;AAKD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,iBAAiB,GAAG,iBAAiB,CAgB/E;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,oBAAoB,EAC9B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,cAAc,EACxB,WAAW,CAAC,EAAE,iBAAiB,GAC9B,eAAe,CAiDjB;AAED,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,CAAA"}

package/dist/workers/world-view.js

@@ -0,0 +1,85 @@
+// The worker-side (and main-thread-mirror) zero-copy view over the shared buffer set. It
+// re-wraps every column + region SAB by reference (LENGTH-TRACKING views) so a worker
+// reads/writes Position.x as a direct indexed load on the SAME
+// Float32Array the main thread uses — no value copy. Workers read ARCHETYPE TABLES ONLY here: an
+// entity's (archetypeId, row) comes from the shared entity-record regions, never the bitmask
+import { elementCtor } from '@ecsia/core';
+const REC_ARCH_ID = 'entity.archetypeId';
+const REC_ARCH_ROW = 'entity.archetypeRow';
+/** Re-wrap a manifest column/region SAB as a length-tracking view of its element kind. */
+function wrap(backing, element) {
+    const Ctor = elementCtor(element);
+    return new Ctor(backing);
+}
+const CORRAL_COUNT_WORD = 0;
+const CORRAL_HEADER_WORDS = 1;
+export function makeWriteCorralWriter(sab) {
+    const view = new Uint32Array(sab);
+    const capacityPairs = (view.length - CORRAL_HEADER_WORDS) >>> 1;
+    return {
+        push(index, componentId) {
+            const n = view[CORRAL_COUNT_WORD];
+            if (n >= capacityPairs)
+                return; // capped; pool diagnoses on merge
+            const base = CORRAL_HEADER_WORDS + n * 2;
+            view[base] = index >>> 0;
+            view[base + 1] = componentId >>> 0;
+            view[CORRAL_COUNT_WORD] = n + 1;
+        },
+        reset() {
+            view[CORRAL_COUNT_WORD] = 0;
+        },
+    };
+}
+export function buildWorkerWorldView(manifest, indexBitsMask, commands, writeCorral) {
+    // archetypeId:componentId.fieldIndex → column view.
+    const columns = new Map();
+    for (const col of manifest.columns) {
+        columns.set(col.key, { view: wrap(col.backing, col.layout.element), stride: col.layout.stride });
+    }
+    const regions = new Map();
+    for (const reg of manifest.regions) {
+        regions.set(reg.key, wrap(reg.backing, reg.element));
+    }
+    const archIdRegion = regions.get(REC_ARCH_ID);
+    const archRowRegion = regions.get(REC_ARCH_ROW);
+    if (archIdRegion === undefined || archRowRegion === undefined) {
+        throw new Error('worker view: entity-record regions missing from manifest (not SAB-backed?)');
+    }
+    function colKey(archetypeId, componentId, fieldIndex) {
+        return `${archetypeId}:${componentId}.${fieldIndex}`;
+    }
+    return {
+        locationOf(index) {
+            return { archetypeId: archIdRegion[index] >>> 0, row: archRowRegion[index] >>> 0 };
+        },
+        readField(index, componentId, fieldIndex) {
+            const { archetypeId, row } = this.locationOf(index);
+            const col = columns.get(colKey(archetypeId, componentId, fieldIndex));
+            if (col === undefined)
+                return 0;
+            return col.view[row * col.stride];
+        },
+        writeField(index, componentId, fieldIndex, value) {
+            const { archetypeId, row } = this.locationOf(index);
+            const col = columns.get(colKey(archetypeId, componentId, fieldIndex));
+            if (col === undefined)
+                return;
+            col.view[row * col.stride] = value;
+            // Stage the value write into this worker's corral so the serial merge feeds the write log
+            // (drives onChange + `.changed` for worker writes). fieldIndex collapses to component granularity
+            // — matching the main-thread trackWrite default.
+            writeCorral?.push(index, componentId);
+        },
+        commands,
+        applyColumnGrowth(notices) {
+            for (const n of notices) {
+                columns.set(n.key, { view: wrap(n.backing, n.layout.element), stride: n.layout.stride });
+            }
+        },
+    };
+    // indexBitsMask reserved for handle→index narrowing in callers; kept for API symmetry.
+    void indexBitsMask;
+}
+export { REC_ARCH_ID, REC_ARCH_ROW };
+//# sourceMappingURL=world-view.js.map

package/dist/workers/world-view.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@ecsia/scheduler",
+  "version": "0.1.0",
+  "description": "System scheduler for ecsia: declare what each system reads and writes, and non-conflicting systems run in parallel across worker threads.",
+  "keywords": [
+    "ecs",
+    "entity-component-system",
+    "ecsia",
+    "scheduler",
+    "parallel",
+    "worker-threads",
+    "atomics",
+    "data-oriented",
+    "typescript"
+  ],
+  "license": "MIT",
+  "author": "Andy Aragon",
+  "homepage": "https://github.com/andymai/ecsia",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/andymai/ecsia.git",
+    "directory": "packages/scheduler"
+  },
+  "bugs": {
+    "url": "https://github.com/andymai/ecsia/issues"
+  },
+  "engines": {
+    "node": ">=22.13"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@ecsia/core": "0.1.0",
+    "@ecsia/schema": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  }
+}