@adobe/ecs 0.0.0-stage → 0.2.0

package/dist/implementation/world/pool.js

@@ -0,0 +1,264 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { allocateArray, freeArray } from './arrays.js';
+import { emptyBuffer } from './buffer.js';
+import { maximumPieces, startRanges } from './claims.js';
+import { controlWords, splitCount, done, epoch, lineWords, posted, ringBase, ringCapacity, ringCursor, ringNeeded, ringSize, signal, taskFields, taskWords } from './protocol.js';
+/** How long `terminate` waits for workers to leave their windows before keeping the control state. */
+const releaseTimeout = 1000;
+/** A command ring's first size in bytes; a sync point grows it to what a run's tasks needed. */
+const initialRingBytes = 1 << 16;
+const errorOf = ({ name, message, stack }) => Object.assign(new Error(message), { name, stack });
+/** Zeroed Int32 words starting on a cache line, so a block of whole lines shares none with other arrays; `blocks` records the block. */
+const allocateLines = (arena, words, blocks) => {
+    const lineBytes = lineWords * 4;
+    const bytes = words * 4 + lineBytes;
+    const offset = arena.allocate(bytes);
+    blocks.push({ offset, bytes });
+    return new Int32Array(arena.memory.buffer, Math.ceil(offset / lineBytes) * lineBytes, words).fill(0);
+};
+export const createPool = (ports, arena) => {
+    const { memory } = arena;
+    const size = ports.length;
+    let nextTask = 0;
+    const lines = [];
+    const control = allocateLines(arena, size * controlWords, lines);
+    const statuses = allocateLines(arena, size * ringSize, lines);
+    const payloads = allocateArray(arena, Float64Array, size * ringSize * taskWords);
+    const claims = allocateLines(arena, splitCount * size * lineWords, lines);
+    /** Splits' claim slots no split in flight uses: one is reused only once every task of its split is done. */
+    const freeSplits = Array.from({ length: splitCount }, (_, split) => split);
+    const open = new Array(size).fill(false);
+    /** Whether each worker was ever given a window or a run, and so may touch the control state. */
+    const windowed = new Array(size).fill(false);
+    const sent = new Array(size).fill(0);
+    /** Writes held back by a full ring, chained so they stay in order. */
+    const waiting = new Array(size).fill(0);
+    const chains = Array.from({ length: size }, () => Promise.resolve());
+    /** Each worker's command ring, in the memory. */
+    const rings = Array.from({ length: size }, () => {
+        const bytes = initialRingBytes;
+        return { offset: arena.allocate(bytes), bytes };
+    });
+    const placeRing = (worker) => {
+        const base = worker * controlWords;
+        Atomics.store(control, base + ringBase, rings[worker].offset);
+        Atomics.store(control, base + ringCapacity, rings[worker].bytes);
+        Atomics.store(control, base + ringCursor, 0);
+        Atomics.store(control, base + ringNeeded, 0);
+    };
+    for (let worker = 0; worker < size; worker++)
+        placeRing(worker);
+    /** Whether a task wrote into a command ring since the last rewind. */
+    let written = false;
+    /** The workers posted a task since `takePosted` last ran, and how many. */
+    const postedTo = new Uint8Array(size);
+    let postedCount = 0;
+    const markPosted = (worker) => {
+        if (postedTo[worker] !== 0)
+            return;
+        postedTo[worker] = 1;
+        postedCount++;
+    };
+    const kill = (slot, error) => {
+        slot.dead ??= error;
+        for (const { settle } of slot.pending.values())
+            settle({ commands: emptyBuffer, error: slot.dead });
+        slot.pending.clear();
+    };
+    const slots = ports.map((port, worker) => {
+        const slot = { port, pending: new Map(), dead: null };
+        port.onMessage(message => {
+            const pending = slot.pending.get(message.task);
+            slot.pending.delete(message.task);
+            if (pending === undefined)
+                return;
+            if (message.kind === "tables")
+                return pending.settle({ commands: emptyBuffer, kernels: message.kernels });
+            const { start, end, spill } = message;
+            const wrote = end > start || spill !== null;
+            if (wrote)
+                written = true;
+            // The ring moves only at a rewind, which waits for every task.
+            const segment = wrote && pending.tag !== null ? { bytes: spill ?? new Uint8Array(memory.buffer, rings[worker].offset + start, end - start), tag: pending.tag } : undefined;
+            pending.settle(message.kind === "done" ? { commands: emptyBuffer, segment } : { commands: emptyBuffer, segment, error: errorOf(message.error) });
+        });
+        port.onDeath(error => kill(slot, error));
+        port.post({ kind: "memory", memory, header: arena.header.byteOffset, control: control.byteOffset + worker * controlWords * 4 });
+        return slot;
+    });
+    const wake = (worker) => {
+        Atomics.add(control, worker * controlWords + signal, 1);
+        Atomics.notify(control, worker * controlWords + signal);
+    };
+    const close = () => {
+        for (let worker = 0; worker < size; worker++) {
+            if (!open[worker])
+                continue;
+            open[worker] = false;
+            Atomics.add(control, worker * controlWords + epoch, 1);
+            wake(worker);
+        }
+    };
+    /** Opens a worker's window for the current epoch, after any messages already posted to it. */
+    const ensureOpen = (worker) => {
+        if (open[worker])
+            return;
+        open[worker] = true;
+        windowed[worker] = true;
+        const current = Atomics.load(control, worker * controlWords + epoch);
+        slots[worker].port.post({ kind: "window", control: control.byteOffset, statuses: statuses.byteOffset, payloads: payloads.byteOffset, claims: claims.byteOffset, worker, epoch: current });
+    };
+    /** One brief spin for all waiters of a batch of tasks, which are short, before waiting without blocking. */
+    let spinUntil = 0;
+    /** Resolves once the worker has done `count` tasks. */
+    const whenDone = async (worker, count) => {
+        const index = worker * controlWords + done;
+        while (Atomics.load(control, index) < count) {
+            if (slots[worker].dead !== null)
+                return;
+            if (performance.now() < spinUntil)
+                continue;
+            const current = Atomics.load(control, index);
+            if (current >= count)
+                return;
+            const waited = Atomics.waitAsync(control, index, current, 50);
+            if (waited.async)
+                await waited.value;
+        }
+    };
+    const post = (worker, task, line, grain, self, participants) => {
+        markPosted(worker);
+        const slot = slots[worker];
+        if (slot.dead !== null)
+            return Promise.resolve({ commands: emptyBuffer, error: slot.dead });
+        const count = ++sent[worker];
+        const ring = (count - 1) % ringSize;
+        spinUntil = performance.now() + 2;
+        const write = () => {
+            // A write held back past a close reopens the window, behind the messages posted since.
+            ensureOpen(worker);
+            const current = Atomics.load(control, worker * controlWords + epoch);
+            const base = (worker * ringSize + ring) * taskWords;
+            payloads.set([task.kernel, task.archetype, task.start, task.end, task.tick, task.lastRun, current, task.scalars.length, line, grain, self, participants], base);
+            payloads.set(task.partials < 0 ? task.scalars : [...task.scalars, task.partials, task.partialBytes], base + taskFields);
+            Atomics.store(control, worker * controlWords + posted, count);
+            wake(worker);
+        };
+        // Written now when there's room, so the worker starts at once; otherwise in order, once the worker frees a slot.
+        let written;
+        if (waiting[worker] === 0 && count - Atomics.load(control, worker * controlWords + done) <= ringSize) {
+            write();
+            written = Promise.resolve();
+        }
+        else {
+            waiting[worker]++;
+            written = chains[worker] = chains[worker].then(async () => {
+                await whenDone(worker, count - ringSize);
+                write();
+                waiting[worker]--;
+            });
+        }
+        return (async () => {
+            await written;
+            await whenDone(worker, count);
+            if (slot.dead !== null)
+                return { commands: emptyBuffer, error: slot.dead };
+            // The worker records each task's number, negated if it failed, so a reused slot can't hide a failure.
+            const failed = Atomics.load(statuses, worker * ringSize + ring) === -count;
+            return failed ? { commands: emptyBuffer, error: new Error("A world worker's kernel failed.") } : { commands: emptyBuffer };
+        })();
+    };
+    const claimed = (first, workers, task, grain) => {
+        const pieces = Math.ceil((task.end - task.start) / grain);
+        const split = pieces <= maximumPieces ? freeSplits.pop() : undefined;
+        if (split === undefined) {
+            const share = Math.ceil((task.end - task.start) / workers / grain) * grain;
+            // Each share runs as the grain-row pieces it holds, into those pieces' partials, as claims would.
+            return Array.from({ length: workers }, (_, i) => post((first + i) % size, {
+                ...task, start: task.start + i * share, end: Math.min(task.end, task.start + (i + 1) * share),
+                partials: task.partials < 0 ? -1 : task.partials + (i * share / grain) * task.partialBytes,
+            }, -1, grain, 0, 0));
+        }
+        const line = split * size;
+        startRanges(claims.subarray(line * lineWords, (line + workers) * lineWords), workers, pieces);
+        const results = Array.from({ length: workers }, (_, i) => post((first + i) % size, task, line, grain, i, workers));
+        void Promise.all(results).then(() => freeSplits.push(split));
+        return results;
+    };
+    return {
+        size,
+        claimed,
+        takePosted: () => {
+            const count = postedCount;
+            if (count !== 0) {
+                postedTo.fill(0);
+                postedCount = 0;
+            }
+            return count;
+        },
+        broadcast: message => {
+            close();
+            for (const slot of slots)
+                if (slot.dead === null)
+                    slot.port.post(message);
+        },
+        close,
+        rewind: () => {
+            if (!written)
+                return;
+            written = false;
+            for (let worker = 0; worker < size; worker++) {
+                // A dead worker gets no more tasks, but may still be writing, so its ring is left to it.
+                if (slots[worker].dead !== null)
+                    continue;
+                const needed = Atomics.load(control, worker * controlWords + ringNeeded);
+                const ring = rings[worker];
+                if (needed > ring.bytes) {
+                    arena.free(ring.offset, ring.bytes);
+                    const bytes = Math.max(needed, 2 * ring.bytes);
+                    rings[worker] = { offset: arena.allocate(bytes), bytes };
+                }
+                placeRing(worker);
+            }
+        },
+        request: (worker, message) => new Promise(settle => {
+            close();
+            markPosted(worker);
+            const slot = slots[worker];
+            if (slot.dead !== null)
+                return settle({ commands: emptyBuffer, error: slot.dead });
+            const task = nextTask++;
+            // Its command ring is in the control state, so `terminate` waits for it to leave, as for a window.
+            windowed[worker] = true;
+            slot.pending.set(task, { settle, tag: message.kind === "run" ? { tick: message.tick, archetype: message.archetype, start: message.start } : null });
+            slot.port.post({ ...message, task });
+        }),
+        terminate: async () => {
+            close();
+            // A worker handles messages only outside its window, so its reply means it has left and won't enter again.
+            const left = slots.map((slot, worker) => !windowed[worker] ? Promise.resolve(true)
+                : slot.dead !== null ? Promise.resolve(false)
+                    : new Promise(settle => {
+                        const task = nextTask++;
+                        slot.pending.set(task, { settle: result => settle(result.error === undefined), tag: null });
+                        slot.port.post({ kind: "kernels", kernels: [], task });
+                    }));
+            let timer;
+            const timeout = new Promise(settle => { timer = setTimeout(() => settle(false), releaseTimeout); });
+            const released = await Promise.race([Promise.all(left).then(all => all.every(Boolean)), timeout]);
+            clearTimeout(timer);
+            const disposed = new Error("The world is disposed.");
+            for (const slot of slots)
+                kill(slot, disposed);
+            await Promise.all(slots.map(slot => slot.port.terminate()));
+            if (!released)
+                return;
+            for (const { offset, bytes } of lines)
+                arena.free(offset, bytes);
+            for (const { offset, bytes } of rings)
+                arena.free(offset, bytes);
+            freeArray(arena, payloads);
+        },
+    };
+};
+//# sourceMappingURL=pool.js.map

package/dist/implementation/world/pool.js.map

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

package/dist/implementation/world/port.d.ts

@@ -0,0 +1,62 @@
+/** One end of a channel between threads: messages each way, in the order they were posted. */
+export type Channel<Send, Receive> = {
+    /** Posts a message, moving the buffers in `transfer`. */
+    readonly post: (message: Send, transfer?: ArrayBuffer[]) => void;
+    /** Sets the one handler for messages. */
+    readonly onMessage: (handler: (message: Receive) => void) => void;
+};
+/**
+ * A thread as another sees it: over a browser `Worker`, a node `worker_threads` worker, or a `MessagePort` another
+ * thread lent, whose owner reports its death and ends it.
+ */
+export type Port<Send, Receive> = Channel<Send, Receive> & {
+    /** Sets the one handler for the thread's death: a load failure, a crash or an exit. It's called at most once. */
+    readonly onDeath: (handler: (error: Error) => void) => void;
+    /** Ends the thread; resolves once it's gone, or once its owner has ended it. */
+    readonly terminate: () => Promise<void>;
+};
+/**
+ * A `MessagePort` of either platform, as both use it. A message's data is what the other end posted, typed by the
+ * channel it crosses, as the platforms' own `MessageEvent` types leave it.
+ */
+export type Endpoint = {
+    readonly postMessage: (message: unknown, transfer: ArrayBuffer[]) => void;
+    readonly addEventListener: (type: "message" | "close", listener: (event: {
+        readonly data?: any;
+    }) => void) => void;
+    readonly start: () => void;
+    readonly close: () => void;
+};
+/**
+ * A worker another thread owns, lent to this one: `port` reaches the worker, and `owner` its owner, which reports the
+ * worker's death on it and ends the worker when asked. `P` is the platform's `MessagePort`, which transfers.
+ */
+export type Lent<P extends Endpoint = Endpoint> = {
+    readonly port: P;
+    readonly owner: P;
+};
+/** A death to report once: the first error wins, and a handler set after it still hears it. */
+export declare const createDeath: () => {
+    readonly die: (error: Error) => void;
+    readonly onDeath: (handler: (error: Error) => void) => void;
+};
+/** A `MessagePort` as a channel. */
+export declare const endpointChannel: <Send, Receive>(endpoint: Endpoint) => Channel<Send, Receive>;
+/**
+ * A worker's own scope as a channel: node's `parentPort`, or a browser worker's `self`.
+ */
+export declare const scopeChannel: <Send, Receive>() => Channel<Send, Receive>;
+/**
+ * The thread a lent worker runs on, as the thread it's lent to sees it: its death is what its owner reports, or either
+ * port's `close` where the platform has it. The worker's port closing is reported once its owner answers that it
+ * reported nothing before, so an owner's report wins over the close its ending causes. `terminate` asks the owner, and
+ * closes both ports once it has, or once the owner's port closed.
+ */
+export declare const lentPort: <Send, Receive>({ port, owner }: Lent) => Port<Send, Receive>;
+/**
+ * On the owner's thread: serves a lent worker's owner end, forwarding the worker's death and ending it when the
+ * thread it's lent to asks, or when `terminate` is called here, which reports it as a death there before ending it.
+ */
+export declare const serveLent: (worker: Pick<Port<unknown, unknown>, "onDeath" | "terminate">, owner: Endpoint) => {
+    readonly terminate: () => Promise<void>;
+};

package/dist/implementation/world/port.js

@@ -0,0 +1,109 @@
+/** A death to report once: the first error wins, and a handler set after it still hears it. */
+export const createDeath = () => {
+    let error = null;
+    let handler = null;
+    return {
+        die: reason => {
+            if (error !== null)
+                return;
+            error = reason;
+            handler?.(reason);
+        },
+        onDeath: next => {
+            handler = next;
+            if (error !== null)
+                next(error);
+        },
+    };
+};
+const noTransfer = [];
+/** A `MessagePort` as a channel. */
+export const endpointChannel = (endpoint) => ({
+    post: (message, transfer = noTransfer) => endpoint.postMessage(message, transfer),
+    onMessage: handler => {
+        endpoint.addEventListener("message", event => handler(event.data));
+        endpoint.start();
+    },
+});
+/**
+ * A worker's own scope as a channel: node's `parentPort`, or a browser worker's `self`.
+ */
+export const scopeChannel = () => {
+    const parent = globalThis.process?.getBuiltinModule?.("node:worker_threads")?.parentPort ?? null;
+    if (parent !== null)
+        return endpointChannel(parent);
+    return {
+        post: (message, transfer) => self.postMessage(message, { transfer }),
+        onMessage: handler => { self.onmessage = (event) => handler(event.data); },
+    };
+};
+/**
+ * The thread a lent worker runs on, as the thread it's lent to sees it: its death is what its owner reports, or either
+ * port's `close` where the platform has it. The worker's port closing is reported once its owner answers that it
+ * reported nothing before, so an owner's report wins over the close its ending causes. `terminate` asks the owner, and
+ * closes both ports once it has, or once the owner's port closed.
+ */
+export const lentPort = ({ port, owner }) => {
+    const channel = endpointChannel(port);
+    const death = createDeath();
+    const control = endpointChannel(owner);
+    let terminated = null;
+    control.onMessage(message => {
+        if (message.kind === "death")
+            death.die(new Error(message.message));
+        else if (message.kind === "closed")
+            death.die(new Error("A world worker's port closed."));
+        else
+            terminated?.();
+    });
+    port.addEventListener("close", () => control.post({ kind: "closed" }));
+    // An owner whose thread is gone can't answer; where the platform reports that, its worker is gone with it.
+    owner.addEventListener("close", () => {
+        death.die(new Error("A world worker's owner is gone."));
+        terminated?.();
+    });
+    return {
+        ...channel,
+        onDeath: death.onDeath,
+        terminate: () => new Promise(resolve => {
+            terminated = () => {
+                terminated = null;
+                port.close();
+                owner.close();
+                resolve();
+            };
+            control.post({ kind: "terminate" });
+        }),
+    };
+};
+/**
+ * On the owner's thread: serves a lent worker's owner end, forwarding the worker's death and ending it when the
+ * thread it's lent to asks, or when `terminate` is called here, which reports it as a death there before ending it.
+ */
+export const serveLent = (worker, owner) => {
+    const control = endpointChannel(owner);
+    let gone = false;
+    worker.onDeath(error => {
+        if (gone)
+            return;
+        gone = true;
+        control.post({ kind: "death", message: error.message });
+    });
+    const end = async () => {
+        // Reported before it's ended, so it comes before the worker's end it causes, here and as its port's close there.
+        if (!gone)
+            control.post({ kind: "death", message: "A world worker was terminated by its owner." });
+        gone = true;
+        await worker.terminate();
+    };
+    control.onMessage(async (message) => {
+        if (message.kind === "closed")
+            return control.post({ kind: "closed" });
+        gone = true;
+        await worker.terminate();
+        control.post({ kind: "terminated" });
+        owner.close();
+    });
+    return { terminate: end };
+};
+//# sourceMappingURL=port.js.map

package/dist/implementation/world/port.js.map

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

package/dist/implementation/world/prepared-lookup.d.ts

@@ -0,0 +1,11 @@
+import { type Shape } from './index-lookups.js';
+/** Arguments a site passes at most: its key's scalars, flattened from literals. */
+export declare const maximumArguments = 16;
+/**
+ * One index lookup call site of a main-thread body, for code the plugin emits: `find(lookup, ...values)` takes the
+ * key as `shape` flattened it, so a literal tuple or comparison builds nothing, and returns the site's own list, or row
+ * for a unique index, reused each time it runs. A function that isn't an index lookup is called as written.
+ */
+export declare const prepareLookup: (shape: Shape) => {
+    find: (lookup: unknown, a0?: unknown, a1?: unknown, a2?: unknown, a3?: unknown, a4?: unknown, a5?: unknown, a6?: unknown, a7?: unknown, a8?: unknown, a9?: unknown, a10?: unknown, a11?: unknown, a12?: unknown, a13?: unknown, a14?: unknown, a15?: unknown) => unknown;
+};

package/dist/implementation/world/prepared-lookup.js

@@ -0,0 +1,99 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { createSite, indexLookupOf } from './index-lookups.js';
+/** Arguments a site passes at most: its key's scalars, flattened from literals. */
+export const maximumArguments = 16;
+/** How many arguments a shape passes. */
+const countOf = (shape) => {
+    let count = 0;
+    for (const form of shape) {
+        if (typeof form === "number")
+            count += Math.max(1, form);
+        else
+            for (const [, operand] of form)
+                count += Math.max(1, operand);
+    }
+    return count;
+};
+/** The arguments a call with literals would have passed, built back from the values a shape flattened them into. */
+const argumentsOf = (shape, values) => {
+    const built = [];
+    let next = 0;
+    const operand = (form) => {
+        if (form === 0)
+            return values[next++];
+        const tuple = values.slice(next, next + form);
+        next += form;
+        return tuple;
+    };
+    for (const form of shape) {
+        if (typeof form === "number")
+            built.push(operand(form));
+        else {
+            const comparison = {};
+            for (const [operator, count] of form)
+                comparison[operator] = operand(count);
+            built.push(comparison);
+        }
+    }
+    return built;
+};
+/**
+ * One index lookup call site of a main-thread body, for code the plugin emits: `find(lookup, ...values)` takes the
+ * key as `shape` flattened it, so a literal tuple or comparison builds nothing, and returns the site's own list, or row
+ * for a unique index, reused each time it runs. A function that isn't an index lookup is called as written.
+ */
+export const prepareLookup = (shape) => {
+    const count = countOf(shape);
+    let last = null;
+    let site = null;
+    const sites = new WeakMap();
+    /** The site for `lookup`, or null for a function that isn't an index lookup. */
+    const siteOf = (lookup) => {
+        const found = indexLookupOf(lookup);
+        if (found === undefined || typeof lookup !== "function")
+            return null;
+        const made = sites.get(lookup) ?? createSite(found, shape);
+        sites.set(lookup, made);
+        last = lookup;
+        site = made;
+        return made;
+    };
+    /** A call of a function that isn't an index lookup, with the arguments a call with literals would have passed. */
+    const asWritten = (lookup, values) => typeof lookup === "function" ? Reflect.apply(lookup, undefined, argumentsOf(shape, values)) : undefined;
+    // The commonest counts take exactly their arguments, so a call passes nothing more.
+    switch (count) {
+        case 0: return {
+            find: (lookup) => {
+                const current = lookup === last ? site : siteOf(lookup);
+                return current === null ? asWritten(lookup, []) : current.find();
+            },
+        };
+        case 1: return {
+            find: (lookup, a0) => {
+                const current = lookup === last ? site : siteOf(lookup);
+                return current === null ? asWritten(lookup, [a0]) : current.find(a0);
+            },
+        };
+        case 2: return {
+            find: (lookup, a0, a1) => {
+                const current = lookup === last ? site : siteOf(lookup);
+                return current === null ? asWritten(lookup, [a0, a1]) : current.find(a0, a1);
+            },
+        };
+        case 3: return {
+            find: (lookup, a0, a1, a2) => {
+                const current = lookup === last ? site : siteOf(lookup);
+                return current === null ? asWritten(lookup, [a0, a1, a2]) : current.find(a0, a1, a2);
+            },
+        };
+        default: return {
+            find: (lookup, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15) => {
+                const current = lookup === last ? site : siteOf(lookup);
+                if (current === null)
+                    return asWritten(lookup, [a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15].slice(0, count));
+                return current.find(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15);
+            },
+        };
+    }
+};
+//# sourceMappingURL=prepared-lookup.js.map

package/dist/implementation/world/prepared-lookup.js.map

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

package/dist/implementation/world/prepared-spawn.d.ts

@@ -0,0 +1,39 @@
+import type { Commands } from '../../interface/system/commands.js';
+import type { Essential } from '../../interface/component/value.js';
+import type { Entity } from '../../interface/entity/entity.js';
+import { type Positional } from './lists.js';
+import type { Key } from './state.js';
+/**
+ * One spawn site's staging, for code the compiler emits for `commands.spawn(components)({ ... })` with literal keys:
+ * `begin(commands, components)` returns the function spawning with the site's values in its key order, generated for
+ * the shape so its stores are specialized, or null when the spawn must go through `fallback`.
+ */
+export type PreparedSpawn = {
+    readonly begin: (commands: Commands, components: readonly Essential[]) => Positional | null;
+    readonly fallback: (commands: Commands, components: readonly Essential[], values: readonly unknown[]) => Entity;
+};
+/**
+ * The compiler's hook for a main-thread spawn site with literal keys: the call becomes a per-site function taking the
+ * values in key order, so no value object is built and nothing is read by key. `keys` is called on first use, after
+ * the module's key constants are initialized. Commands it didn't make go through `commands.spawn` as written.
+ */
+export declare const prepareSpawn: (keys: () => readonly Key[]) => PreparedSpawn;
+/**
+ * One add site's command, for code the compiler emits for `commands.add(entity, components, { ... })` with literal
+ * keys: `begin(commands, entity, components)` appends the add command and returns true, or false when the add must go
+ * through `fallback`; then `value(k, value)` appends value `k`, `undefined` as its start; `end()` appends the starts of
+ * the components the site gives no value.
+ */
+export type PreparedAdd = {
+    readonly begin: (commands: Commands, entity: Entity, components: readonly Essential[]) => boolean;
+    readonly value: (k: number, value: unknown) => void;
+    readonly end: () => void;
+    readonly fallback: (commands: Commands, entity: Entity, components: readonly Essential[], values: readonly unknown[]) => void;
+};
+/**
+ * The compiler's hook for a main-thread add site with literal keys: the call becomes a per-site function taking the
+ * entity and values in key order, so no value object is built and nothing is read by key. Ids are resolved once per
+ * world and list, so a key that isn't a component commands may add throws before anything is appended, as
+ * `commands.add` does. Commands it didn't make go through `commands.add` as written.
+ */
+export declare const prepareAdd: (keys: () => readonly Key[]) => PreparedAdd;