@adobe/ecs 0.0.0-stage → 0.2.0

package/dist/implementation/world/remote.js

@@ -0,0 +1,138 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { declarationOf, labelOf, threadOfDeclaration } from '../../interface/registry/index.js';
+import { makeLocal, makeRemote } from './archetype.js';
+import { flushBetween } from './layout-directory.js';
+import { nullTag, tagOf } from './move-log.js';
+import { startTicking } from './state.js';
+// Objects a joined thread fills: the world's storages for them hold each row's tag in place of its value, and the
+// archetypes holding them append their moves to the thread's log (`move-log.ts`).
+/** The logical thread a component's or resource's objects live on, or null for a struct. */
+const threadOfComponent = (state, id) => {
+    const declaration = declarationOf(state.keys[id]);
+    return declaration === undefined ? null : threadOfDeclaration(declaration);
+};
+/** Gives a component a joined thread fills to its log, in every archetype and batch holding it. */
+const give = (state, id, log) => {
+    state.remote[id] = log;
+    startTicking(state, [id]);
+    for (const archetype of state.archetypes) {
+        const storage = archetype.storageById[id];
+        if (storage !== undefined)
+            makeRemote(state.memory, archetype, storage, log);
+    }
+    for (const batch of state.batches)
+        for (const column of batch.columns)
+            if (column.id === id)
+                column.remote = remoteError(state, id).message;
+    log.announce(id);
+};
+/**
+ * A component the world just met, whose logical thread a joined thread claims: its objects are that thread's. No
+ * archetype holds it yet, so nothing allocates.
+ */
+export const claimComponent = (state, id) => {
+    const thread = threadOfComponent(state, id);
+    const log = thread === null ? undefined : state.claims.get(thread);
+    if (log === undefined)
+        return;
+    state.remote[id] = log;
+    state.ticked.add(id);
+    log.announce(id);
+};
+/**
+ * Between runs: a joined thread claims logical threads, so their components' objects are its own. Rows holding them
+ * start there at their starts; the world's values are released. Their ticks are kept, so the thread rebuilds them.
+ */
+export const claimThreads = (state, log, threads) => {
+    for (const thread of threads)
+        state.claims.set(thread, log);
+    state.logs.push(log);
+    state.claimed = true;
+    state.counting = true;
+    for (let id = 0; id < state.keys.length; id++) {
+        const thread = threadOfComponent(state, id);
+        if (thread !== null && state.claims.get(thread) === log)
+            give(state, id, log);
+    }
+    if (state.directory !== null)
+        state.directory.guarded = true;
+    flushBetween(state.directory, state.bumped, state.archetypes, state.entities, state.resourceEntity, state.counted);
+};
+/**
+ * Between runs: a joined thread that's gone gives back the logical threads it claimed. Rows hold the value each tag
+ * names, `null` or the start: a staged value was the thread's own.
+ */
+export const releaseThreads = (state, log) => {
+    const index = state.logs.indexOf(log);
+    if (index < 0)
+        return;
+    state.logs.splice(index, 1);
+    for (const [thread, owner] of [...state.claims])
+        if (owner === log)
+            state.claims.delete(thread);
+    for (let id = 0; id < state.remote.length; id++) {
+        if (state.remote[id] !== log)
+            continue;
+        state.remote[id] = undefined;
+        for (const archetype of [...log.archetypes]) {
+            const storage = archetype.storageById[id];
+            if (storage !== undefined)
+                makeLocal(state.memory, archetype, storage, state.starts[id]);
+        }
+        for (const batch of state.batches)
+            for (const column of batch.columns)
+                if (column.id === id)
+                    column.remote = null;
+    }
+    state.claimed = state.logs.length > 0;
+    state.counting = state.claimed || state.observer.count > 0;
+    if (state.directory !== null)
+        state.directory.guarded = state.claimed;
+    // Finalizers on the threads it gave back activate again.
+    state.unplacedSeen.clear();
+    state.activation.met = true;
+    flushBetween(state.directory, state.bumped, state.archetypes, state.entities, state.resourceEntity, state.counted);
+};
+export const remoteError = (state, id) => new Error(`"${labelOf(state.keys[id])}" lives on thread "${threadOfComponent(state, id) ?? "world"}", which a joined thread fills, so a command here gives it only its start or null.`);
+/**
+ * For a system's commands, once a joined thread fills objects: the first error of a value another thread's object can't
+ * take, with each such command dropped, by naming no entity, and each such staged spawn's value its start. Commands of
+ * the joined thread whose log is `own` give its own objects slots it staged.
+ */
+export const checkCommands = (state, buffer, own = null) => {
+    let error;
+    const { ids, values, starts, entities } = buffer;
+    for (let command = 0; command < buffer.count; command++) {
+        const end = command + 1 < buffer.count ? starts[command + 1] : buffer.named;
+        for (let k = starts[command]; k < end; k++) {
+            const id = ids[k];
+            const log = state.remote[id];
+            if (log === undefined)
+                continue;
+            const tag = tagOf(values[k], state.starts[id]);
+            if (tag >= 0 && (tag <= nullTag || log === own))
+                continue;
+            error ??= remoteError(state, id);
+            entities[command] = 0;
+            break;
+        }
+    }
+    for (let s = 0; s < buffer.stagedCount; s++) {
+        const { batch, start, end } = buffer.staged[s];
+        for (const column of batch.columns) {
+            const log = state.remote[column.id];
+            if (log === undefined)
+                continue;
+            const begin = state.starts[column.id];
+            for (let row = start; row < end; row++) {
+                const tag = tagOf(column.values[row], begin);
+                if (tag >= 0 && (tag <= nullTag || log === own))
+                    continue;
+                error ??= remoteError(state, column.id);
+                column.values[row] = begin;
+            }
+        }
+    }
+    return error;
+};
+//# sourceMappingURL=remote.js.map

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

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

package/dist/implementation/world/render-order.d.ts

@@ -0,0 +1,19 @@
+import type { RenderContext } from '../../interface/system/render.js';
+import type { Archetype } from './archetype.js';
+import type { GpuEngine } from './gpu.js';
+import type { Ordered } from './index-order.js';
+import type { WorldIndex } from './indexes.js';
+export type OrderedRender = {
+    /**
+     * Uploads what the run's one table reads; returns null, or the reason it can't be drawn: more matched archetypes
+     * and rows than an entry's 32 bits hold.
+     */
+    readonly prepare: (gpu: GpuEngine, matches: readonly Archetype[], tick: number) => string | null;
+    /** The body's context, once the work recorded before it is submitted. */
+    readonly context: (gpu: GpuEngine) => RenderContext;
+};
+/**
+ * `columns` are the accessors' component ids, in accessor order; `group` the bind group the shader declares; `key`
+ * the prefix of the runner's GPU records.
+ */
+export declare const createOrderedRender: (index: WorldIndex, ordered: Ordered, columns: readonly number[], group: number, key: string) => OrderedRender;

package/dist/implementation/world/render-order.js

@@ -0,0 +1,126 @@
+import { blockBase } from './index-sorted.js';
+/**
+ * `columns` are the accessors' component ids, in accessor order; `group` the bind group the shader declares; `key`
+ * the prefix of the runner's GPU records.
+ */
+export const createOrderedRender = (index, ordered, columns, group, key) => {
+    const width = columns.length;
+    const orderKey = `${key}order`;
+    const tablesKey = `${key}tables`;
+    const recordKey = `${key}ordered`;
+    let entries = new Int32Array(64);
+    let instances = 0;
+    let tables = new Int32Array(Math.max(1, width));
+    /** What the order block was last built from: the index's ticks, the matches, and the GPU it was written to. */
+    let builtChanged = -1;
+    let builtMoved = -1;
+    let builtMatches = -1;
+    let builtGpu = null;
+    let shift = 31;
+    const words = new Uint32Array(4);
+    let recorded = false;
+    const offsets = [0];
+    let bound = null;
+    const table = {
+        count: 0,
+        bind: pass => {
+            if (bound !== null)
+                pass.setBindGroup(group, bound.renderGroup(), offsets);
+        },
+    };
+    const list = [table];
+    let context = null;
+    /** Lists the index's entries of matched archetypes, in its order, as slot and row. */
+    const build = (matches) => {
+        const sorted = index.sorted;
+        instances = 0;
+        if (sorted === null)
+            return;
+        if (entries.length < sorted.size)
+            entries = new Int32Array(Math.max(sorted.size, 2 * entries.length));
+        const owners = ordered.owners(matches);
+        const known = owners.length;
+        const slotShift = shift;
+        const { order, lengths, stride, words: keyWords, blocks } = sorted;
+        const sortedEntries = sorted.entries;
+        for (let k = 0; k < blocks; k++) {
+            const block = order[k];
+            const base = blockBase(sorted, block) + keyWords;
+            for (let at = base, end = base + lengths[block] * stride; at < end; at += stride) {
+                const archetype = sortedEntries[at + 1];
+                const owner = archetype < known ? owners[archetype] : -1;
+                if (owner < 0)
+                    continue;
+                entries[instances++] = (owner << slotShift) | sortedEntries[at + 2];
+            }
+        }
+    };
+    const prepare = (gpu, matches, tick) => {
+        const slots = matches.length;
+        if (gpu !== builtGpu) {
+            builtGpu = gpu;
+            builtChanged = -1;
+            recorded = false;
+        }
+        // The tables block: every column's address, uploading rows the CPU changed first.
+        if (tables.length < slots * width) {
+            const grown = new Int32Array(Math.max(slots * width, 2 * tables.length));
+            grown.set(tables);
+            tables = grown;
+        }
+        let addressed = false;
+        let most = 0;
+        for (let slot = 0; slot < slots; slot++) {
+            const archetype = matches[slot];
+            const { count } = archetype;
+            if (count > most)
+                most = count;
+            for (let k = 0; k < width; k++) {
+                const storage = count === 0 ? undefined : archetype.storageById[columns[k]];
+                const address = storage === undefined ? 0 : gpu.upload(archetype, storage, tick);
+                const at = slot * width + k;
+                if (tables[at] !== address) {
+                    tables[at] = address;
+                    addressed = true;
+                }
+            }
+        }
+        if (slots !== builtMatches) {
+            // At least one bit of slot, so a row's mask is never 32 bits.
+            const slotBits = Math.max(1, Math.ceil(Math.log2(slots)));
+            shift = 32 - slotBits;
+            builtMatches = slots;
+            builtChanged = -1;
+        }
+        if (most > 2 ** shift)
+            return `with ${slots} matching archetypes an ordered table names at most ${2 ** shift} rows of each, and one holds ${most}`;
+        const rebuilt = index.changed !== builtChanged || index.moved !== builtMoved;
+        if (rebuilt) {
+            build(matches);
+            builtChanged = index.changed;
+            builtMoved = index.moved;
+        }
+        const orderAddress = gpu.uploadIndexes(orderKey, entries, instances, rebuilt);
+        const tablesAddress = gpu.uploadIndexes(tablesKey, tables, slots * width, addressed);
+        if (!recorded || words[0] !== instances || words[1] !== orderAddress || words[2] !== tablesAddress || words[3] !== shift) {
+            words[0] = instances;
+            words[1] = orderAddress;
+            words[2] = tablesAddress;
+            words[3] = shift;
+            offsets[0] = gpu.record(recordKey, words);
+            recorded = true;
+        }
+        bound = gpu;
+        table.count = instances;
+        return null;
+    };
+    const contextOf = (gpu) => {
+        if (context === null)
+            return context = { device: gpu.device, encoder: gpu.encoder(), tables: list };
+        context.device = gpu.device;
+        context.encoder = gpu.encoder();
+        return context;
+    };
+    return { prepare, context: contextOf };
+};
+//# sourceMappingURL=render-order.js.map

package/dist/implementation/world/render-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-order.js","sourceRoot":"","sources":["../../../src/implementation/world/render-order.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAwB9C;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAiB,EAAE,OAAgB,EAAE,OAA0B,EAAE,KAAa,EAAE,GAAW,EAAiB,EAAE;IAC9I,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAC7B,MAAM,QAAQ,GAAG,GAAG,GAAG,OAAO,CAAC;IAC/B,MAAM,SAAS,GAAG,GAAG,GAAG,QAAQ,CAAC;IACjC,MAAM,SAAS,GAAG,GAAG,GAAG,SAAS,CAAC;IAClC,IAAI,OAAO,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAChD,+GAA+G;IAC/G,IAAI,YAAY,GAAG,CAAC,CAAC,CAAC;IACtB,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC;IACpB,IAAI,YAAY,GAAG,CAAC,CAAC,CAAC;IACtB,IAAI,QAAQ,GAAqB,IAAI,CAAC;IACtC,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,KAAK,GAAqB,IAAI,CAAC;IACnC,MAAM,KAAK,GAAiB;QACxB,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,IAAI,CAAC,EAAE;YACT,IAAI,KAAK,KAAK,IAAI;gBAAE,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;QAC/E,CAAC;KACJ,CAAC;IACF,MAAM,IAAI,GAA2B,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,OAAO,GAA0B,IAAI,CAAC;IAE1C,sFAAsF;IACtF,MAAM,KAAK,GAAG,CAAC,OAA6B,EAAQ,EAAE;QAClD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,SAAS,GAAG,CAAC,CAAC;QACd,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO;QAC5B,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI;YAAE,OAAO,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACtG,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,MAAM,SAAS,GAAG,KAAK,CAAC;QACxB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QACnE,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC;QACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACvB,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,QAAQ,CAAC;YACjD,KAAK,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,EAAE,EAAE,GAAG,GAAG,EAAE,EAAE,IAAI,MAAM,EAAE,CAAC;gBAC/E,MAAM,SAAS,GAAG,aAAa,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACxC,MAAM,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzD,IAAI,KAAK,GAAG,CAAC;oBAAE,SAAS;gBACxB,OAAO,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,SAAS,CAAC,GAAG,aAAa,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACxE,CAAC;QACL,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,GAAc,EAAE,OAA6B,EAAE,IAAY,EAAiB,EAAE;QAC3F,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnB,QAAQ,GAAG,GAAG,CAAC;YACf,YAAY,GAAG,CAAC,CAAC,CAAC;YAClB,QAAQ,GAAG,KAAK,CAAC;QACrB,CAAC;QACD,kFAAkF;QAClF,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACzE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAClB,MAAM,GAAG,KAAK,CAAC;QACnB,CAAC;QACD,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;YACtC,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC;YAC5B,IAAI,KAAK,GAAG,IAAI;gBAAE,IAAI,GAAG,KAAK,CAAC;YAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5E,MAAM,OAAO,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;gBACjF,MAAM,EAAE,GAAG,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC;gBAC5B,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC;oBACzB,MAAM,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC;oBACrB,SAAS,GAAG,IAAI,CAAC;gBACrB,CAAC;YACL,CAAC;QACL,CAAC;QACD,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;YACzB,8DAA8D;YAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1D,KAAK,GAAG,EAAE,GAAG,QAAQ,CAAC;YACtB,YAAY,GAAG,KAAK,CAAC;YACrB,YAAY,GAAG,CAAC,CAAC,CAAC;QACtB,CAAC;QACD,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK;YAAE,OAAO,QAAQ,KAAK,uDAAuD,CAAC,IAAI,KAAK,gCAAgC,IAAI,EAAE,CAAC;QACnJ,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,KAAK,YAAY,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,CAAC;QAC7E,IAAI,OAAO,EAAE,CAAC;YACV,KAAK,CAAC,OAAO,CAAC,CAAC;YACf,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC;YAC7B,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;QAC7B,CAAC;QACD,MAAM,YAAY,GAAG,GAAG,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC9E,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,SAAS,CAAC,CAAC;QACrF,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,YAAY,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,aAAa,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;YACvH,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;YACrB,KAAK,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC;YACxB,KAAK,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC;YACzB,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;YACjB,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC1C,QAAQ,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,KAAK,GAAG,GAAG,CAAC;QACZ,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;QACxB,OAAO,IAAI,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,GAAc,EAAiB,EAAE;QAChD,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,OAAO,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACpG,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAC5B,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAC3C,CAAC,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { ComponentLists } from '../../interface/system/access.js';
+/** The components every entity a system's lists match has: what it reads, writes, has and filters on, but its optional ones. */
+export declare const requiredOf: (lists: ComponentLists | undefined) => readonly symbol[];

package/dist/implementation/world/required.js

@@ -0,0 +1,9 @@
+/** The components every entity a system's lists match has: what it reads, writes, has and filters on, but its optional ones. */
+export const requiredOf = (lists) => {
+    if (lists === undefined)
+        return [];
+    const { optional } = lists;
+    const all = new Set([...lists.read ?? [], ...lists.write ?? [], ...lists.has ?? [], ...lists.added ?? [], ...lists.changed ?? []]);
+    return optional === undefined ? [...all] : [...all].filter(key => !optional.includes(key));
+};
+//# sourceMappingURL=required.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"required.js","sourceRoot":"","sources":["../../../src/implementation/world/required.ts"],"names":[],"mappings":"AAGA,gIAAgI;AAChI,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAiC,EAAqB,EAAE;IAC/E,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAC3B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;IACnI,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/F,CAAC,CAAC"}

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

@@ -0,0 +1,23 @@
+import type { Storage } from './archetype.js';
+import { type Key, type State } from './state.js';
+/** Resources are components on one entity, so they share storage, ticks and sync with every other component. */
+export type ResourceCell = {
+    readonly storage: Storage;
+    readonly row: number;
+};
+/**
+ * A resource's value before anything writes it: the one given at the world's creation, or the start the world made
+ * for it, so a fresh `Map` or `Set` is one value however often it's read.
+ */
+export declare const initialOf: (state: State, key: Key) => unknown;
+/**
+ * Adds any missing resources with their initial values, as their own sync point, between runs; commands that are
+ * pending stay for the next run.
+ */
+export declare const ensureResources: (state: State, keys: Iterable<Key>) => void;
+/** Sets a resource as its own sync point, between runs, so systems see the change as they see any write. */
+export declare const setResource: (state: State, key: Key, value: unknown) => void;
+/** Where a resource lives now, or `undefined` if no registered system uses it. Valid until the next sync point. */
+export declare const findResource: (state: State, key: Key) => ResourceCell | undefined;
+/** Where a resource lives now. Valid until the next sync point. */
+export declare const resourceCell: (state: State, key: Key) => ResourceCell;

package/dist/implementation/world/resources.js

@@ -0,0 +1,66 @@
+import { indexOf, reserve } from './entities.js';
+import { idOf } from './state.js';
+import { synchronizeAlone } from './synchronize.js';
+import { addCommand, createBuffer, spawnCommand } from './buffer.js';
+import { pushValues } from './commands.js';
+import { labelOf } from '../../interface/registry/index.js';
+/**
+ * A resource's value before anything writes it: the one given at the world's creation, or the start the world made
+ * for it, so a fresh `Map` or `Set` is one value however often it's read.
+ */
+export const initialOf = (state, key) => state.initial.has(key) ? state.initial.get(key) : state.starts[idOf(state, key)];
+/**
+ * Adds any missing resources with their initial values, as their own sync point, between runs; commands that are
+ * pending stay for the next run.
+ */
+export const ensureResources = (state, keys) => {
+    const index = state.resourceEntity < 0 ? -1 : indexOf(state.resourceEntity);
+    const archetype = index < 0 ? undefined : state.archetypes[state.entities.archetype[index]];
+    const values = {};
+    for (const key of keys) {
+        const id = idOf(state, key);
+        // A joined thread's object starts there; the world holds none of its values.
+        if (archetype?.storageOf.has(id) !== true)
+            values[key] = state.remote[id] === undefined ? initialOf(state, key) : state.starts[id];
+    }
+    if (Reflect.ownKeys(values).length === 0)
+        return;
+    const buffer = createBuffer();
+    if (index < 0) {
+        state.resourceEntity = reserve(state.entities);
+        pushValues(state, buffer, spawnCommand, state.resourceEntity, values);
+    }
+    else {
+        pushValues(state, buffer, addCommand, state.resourceEntity, values);
+    }
+    synchronizeAlone(state, buffer);
+};
+/** Sets a resource as its own sync point, between runs, so systems see the change as they see any write. */
+export const setResource = (state, key, value) => {
+    if (findResource(state, key) === undefined) {
+        // No registered system uses it yet; it starts at this value when one does.
+        state.initial.set(key, value);
+        return;
+    }
+    const buffer = createBuffer();
+    pushValues(state, buffer, addCommand, state.resourceEntity, { [key]: value });
+    synchronizeAlone(state, buffer);
+};
+/** Where a resource lives now, or `undefined` if no registered system uses it. Valid until the next sync point. */
+export const findResource = (state, key) => {
+    if (state.resourceEntity < 0)
+        return undefined;
+    const index = indexOf(state.resourceEntity);
+    const storage = state.archetypes[state.entities.archetype[index]]?.storageOf.get(idOf(state, key));
+    return storage === undefined ? undefined : { storage, row: state.entities.row[index] };
+};
+/** Where a resource lives now. Valid until the next sync point. */
+export const resourceCell = (state, key) => {
+    const index = indexOf(state.resourceEntity);
+    const archetype = state.archetypes[state.entities.archetype[index]];
+    const storage = archetype?.storageOf.get(idOf(state, key));
+    if (storage === undefined)
+        throw new Error(`Resource "${labelOf(key)}" isn't in this world.`);
+    return { storage, row: state.entities.row[index] };
+};
+//# sourceMappingURL=resources.js.map

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

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

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

@@ -0,0 +1,111 @@
+import type { Entity } from '../../interface/entity/entity.js';
+import type { Resolved } from '../../interface/system/declaration.js';
+import type { SystemLookupLists } from '../../interface/system/access.js';
+import type { Commands } from '../../interface/system/commands.js';
+import type { Layout } from '../../interface/registry/layout.js';
+import { type Archetype, type Storage } from './archetype.js';
+import { type Key, type State } from './state.js';
+import { type ReductionTarget } from './reductions.js';
+import { type Since } from './index-lookups.js';
+import type { WorldIndex } from './indexes.js';
+/**
+ * What an accessor row reads and writes: a storage, or a joined thread's view of one. A joined thread's own objects
+ * have `tags`, the world's tags of their rows, which a write marks as the thread's own value.
+ */
+export type RowStorage = Pick<Storage, "layout" | "views" | "strings" | "values" | "write" | "ticked" | "added" | "changed" | "chunkAdded" | "chunkChanged" | "blockAdded" | "blockChanged" | "tags">;
+/** What a row binds to: an archetype, or a joined thread's view of one. */
+export type RowArchetype = {
+    readonly id: number;
+    readonly entities: Float64Array;
+    readonly storageById: readonly (RowStorage | undefined)[];
+};
+/**
+ * What rows need of their world: layouts by component id, the rows made so far, the running system's tick, and on a
+ * joined thread, that its strings are read out of their records, since only the world's thread holds their values.
+ */
+export type RowHost = {
+    readonly layouts: readonly Layout[];
+    readonly rows: Map<string, Row>;
+    readonly tick: number;
+    readonly records?: true;
+};
+/**
+ * An accessor row for the declared components of a system. `bind` points it at an archetype's storages and `index`
+ * selects the row. Reads copy linear values out; writes replace the whole value and stamp `changed` with the running
+ * system's tick.
+ */
+export type Row = {
+    readonly value: object;
+    index: number;
+    entities: Float64Array;
+    /** Points the row at another archetype's storages. Views are replaced only at sync points, so a binding lasts a pass. */
+    readonly bind: (archetype: RowArchetype) => void;
+};
+/**
+ * A row of an archetype's `keys`. `absent` is undefined for a member and, for an optional component, whether the
+ * archetype lacks it: one it lacks reads as `undefined` and assigning it fails its system, and one it has fails its
+ * system when assigned `undefined`.
+ */
+export declare const createRow: (host: RowHost, archetype: RowArchetype, keys: readonly Key[], ids: readonly number[], writes: readonly Key[], absent?: readonly (boolean | undefined)[]) => Row;
+/**
+ * Makes read-only accessor rows for `keys` whose values share one hidden class: every value's own accessors are the
+ * same functions, finding the row through the value. A body reading many rows at once, as a list's, sees one map.
+ */
+export declare const sharedRows: (host: RowHost, keys: readonly Key[], ids: readonly number[]) => (archetype: RowArchetype) => Row;
+/**
+ * Binds a read-only accessor row of its own, for the parents an `up` system reads, to an archetype. It isn't shared,
+ * so binding it never moves the row a system runs over, even when both read the same components.
+ */
+export declare const parentBinder: (state: State, reads: readonly Key[]) => (archetype: Archetype) => Row;
+/**
+ * Binds the accessor row for `reads` and `writes` to an archetype. The row is shared by every system of its host that
+ * declares the same ones, so a body sees one row shape whichever system or archetype it runs over. A host's systems
+ * run one at a time, so a binding lasts for one system's pass over one archetype. `idOfKey` gives each key's component.
+ */
+export declare const rowBinderOf: <A extends RowArchetype>(host: RowHost, idOfKey: (key: Key) => number, reads: readonly Key[], writes: readonly Key[], optional?: readonly Key[]) => (archetype: A) => Row;
+/** The accessor row binder for main-thread systems of a world. */
+export declare const rowBinder: (state: State, reads: readonly Key[], writes: readonly Key[], optional?: readonly Key[]) => (archetype: Archetype) => Row;
+/** What a lookup by entity reading nothing gives every entity it finds. */
+export declare const emptyRow: object;
+/** A lookup by entity's row with `changed`: its `read` values by component, and `changed`. */
+export type ChangedRow = {
+    [key: Key]: unknown;
+    changed: boolean;
+};
+/** A row for a lookup's `read` and `changed`, every field present from the start, so its writes keep one hidden class. */
+export declare const changedRowOf: (keys: readonly Key[]) => ChangedRow;
+/**
+ * A lookup returning `read` values keyed by component, for main-thread systems: a new object each call, the shared
+ * empty one for a lookup reading nothing, and with `changed` one row reused, its `changed` as of `since`.
+ */
+export declare const createObjectLookup: (state: State, lookup: SystemLookupLists, since: Since) => (entity: Entity) => object | null;
+/**
+ * A lookup returning `read` values in declared order, for kernels: a new array each call, and with `changed` one array
+ * reused, whether a component it watches may have changed after `since` last.
+ */
+export declare const createArrayLookup: (state: State, lookup: SystemLookupLists, since: Since) => (entity: Entity) => readonly unknown[] | null;
+/**
+ * A body's context: its resources, lookups, reductions and commands, each under its own key and present only
+ * when declared. `bind` resolves the resources' cells for a run; `reduced[t]` holds the leaves of the fold into its
+ * `t`th reduction target so far this run.
+ */
+export type Context = {
+    readonly value: {
+        up?: unknown;
+    };
+    readonly bind: () => void;
+    readonly reduced: readonly Float64Array[];
+};
+/**
+ * What a context holds beyond the declaration's resources and lookups, and for lookups through indexes, the index of
+ * each by name and the `lastRun` their lists compare with.
+ */
+type Extras = {
+    readonly targets?: readonly ReductionTarget[];
+    readonly commands?: Commands;
+    readonly indexes?: ReadonlyMap<string, WorldIndex>;
+    readonly since?: Since;
+};
+/** Resource cells are resolved once per run: they move only at sync points. An unresolved resource throws on access. */
+export declare const createContext: (state: State, declaration: Pick<Resolved, "lookup" | "resources">, { targets, commands, indexes, since }?: Extras) => Context;
+export {};