@adobe/ecs 0.0.0-stage → 0.2.0

package/dist/implementation/world/thread-finalizers.js

@@ -0,0 +1,376 @@
+import { labelOf } from '../../interface/registry/index.js';
+import { objectLayout, viewsOf } from '../../interface/registry/layout.js';
+import { writeOf } from './archetype.js';
+import { emptyViews } from './arrays.js';
+import { readCell } from './cells.js';
+import { logFinalizedWord, logStopsWord, nullTag, ownTag, slotTags, startTag } from './move-log.js';
+import { resourceValueOf, stagedValue } from './mirror.js';
+import { rowBinderOf } from './rows.js';
+import { archetypesAt, blockGroupsWord, blockHeaderBytes, blockNextWord, blockSyncWord, columnBytes, entitiesAt, groupBytesWord, groupCountWord, groupIndexWord, resourceOffsetsOf, rowsAt, tagsAt, valuesAt, } from './stop-lists.js';
+const errorOf = (error) => error instanceof Error ? { name: error.name, message: error.message, stack: error.stack } : { name: "Error", message: String(error) };
+const noTicks = new Float64Array(0);
+const noTags = new Uint32Array(0);
+/** A storage a stop list's column holds, for a row over its stops. */
+const columnStorage = (component, layout, views, values, strings) => ({
+    component, layout, views, strings: layout.kind === "string" ? strings : null, values, ...writeOf(layout), ticked: false, added: noTicks, changed: noTicks, chunkAdded: noTicks, chunkChanged: noTicks, blockAdded: noTicks, blockChanged: noTicks, tags: noTags,
+});
+/**
+ * The finalizers the world places on this thread, with what they run against: stop lists as the thread replays them,
+ * and every row they match once the world is disposed.
+ */
+export const createThreadFinalizers = (host) => {
+    const { mirror } = host;
+    const finalizers = [];
+    /** The newest block run, which the next block's offset is read from; 0 before the first. */
+    let anchor = 0;
+    /** The sync finalized through, as stored. */
+    let finalized = 0;
+    let buffer = new ArrayBuffer(0);
+    let u32 = new Uint32Array(0);
+    let f64 = new Float64Array(0);
+    const errors = [];
+    const views = () => {
+        const latest = host.refresh();
+        if (latest === buffer && u32.length > 0)
+            return;
+        buffer = latest;
+        u32 = new Uint32Array(latest);
+        f64 = new Float64Array(latest, 0, latest.byteLength >> 3);
+    };
+    const create = (leaf) => {
+        const { components, resources } = leaf.declaration;
+        const reads = components.read ?? [];
+        const objects = [];
+        const starts = [];
+        const linear = [];
+        const layouts = [];
+        const constants = [];
+        const constantLayouts = [];
+        for (const key of reads) {
+            const component = host.numberOf(key);
+            const layout = host.layoutOf(key);
+            if (layout === undefined)
+                throw new Error(`"${labelOf(key)}" has no layout here.`);
+            if (layout.kind === "object") {
+                objects.push(component);
+                starts.push(mirror.starts.get(component) ?? null);
+            }
+            // A string's stop column holds handles of records the world copied for it.
+            else if (layout.kind === "linear" || layout.kind === "string") {
+                linear.push(component);
+                layouts.push(layout);
+            }
+            else {
+                constants.push(component);
+                constantLayouts.push(layout);
+            }
+        }
+        const value = Object.create({});
+        const keys = [...new Set(resources?.read ?? [])];
+        const numbers = keys.map(host.numberOf);
+        const resolved = keys.map(() => ({ storage: undefined, row: 0 }));
+        // Its thread's object resources are read from the mirror, which may be behind the entity table as it replays.
+        const own = keys.map(key => host.layoutOf(key)?.kind === "object");
+        const resourceStarts = numbers.map(number => mirror.starts.get(number) ?? null);
+        const ownValues = keys.map(() => undefined);
+        const shared = own.includes(false);
+        // The world copies the rest for each group, in this order: by slot, its strings' handles, then its linear
+        // values, each with its key's index and layout. A constant needs no copy.
+        const stringKeys = [];
+        const stringLayouts = [];
+        const linearKeys = [];
+        const linearLayouts = [];
+        const linearStrides = [];
+        const constantKeys = [];
+        const constantStorages = [];
+        keys.forEach((key, k) => {
+            const layout = host.layoutOf(key);
+            if (layout === undefined || layout.kind === "object")
+                return;
+            if (layout.kind === "string") {
+                stringKeys.push(k);
+                stringLayouts.push(layout);
+            }
+            else if (layout.kind === "linear") {
+                linearKeys.push(k);
+                linearLayouts.push(layout);
+                linearStrides.push(layout.stride);
+            }
+            else {
+                constantKeys.push(k);
+                constantStorages.push(columnStorage(numbers[k], layout, emptyViews, [], null));
+            }
+        });
+        const resourceOffsets = resourceOffsetsOf(stringKeys.length, linearStrides);
+        if (keys.length > 0) {
+            const values = Object.create({});
+            keys.forEach((key, k) => {
+                Object.defineProperty(values, key, {
+                    get: () => {
+                        if (own[k])
+                            return ownValues[k];
+                        const { storage, row } = resolved[k];
+                        if (storage === undefined)
+                            throw new Error(`Resource "${labelOf(key)}" isn't in this world.`);
+                        return readCell(storage, row);
+                    },
+                    enumerable: true,
+                });
+            });
+            Object.defineProperty(value, "resources", { value: values, enumerable: true });
+        }
+        // Method parameters are bivariant, so the runtime can see any finalizer's body with erased parameter types.
+        const untyped = leaf;
+        return {
+            leaf, objects, starts, linear, layouts, constants, constantLayouts,
+            required: [...new Set([...reads, ...components.has ?? []])].filter(key => !(components.optional ?? []).includes(key)).map(host.numberOf),
+            excluded: (components.not ?? []).map(host.numberOf),
+            optional: (components.optional ?? []).map(host.numberOf),
+            bind: rowBinderOf(host.rows, host.numberOf, reads, [], components.optional),
+            context: value,
+            cells: copies => {
+                // Before a rebuild too, its old rows are the mirror's, which hold what the rebuild keeps.
+                for (let k = 0; k < keys.length; k++)
+                    if (own[k])
+                        ownValues[k] = resourceValueOf(mirror, numbers[k], resourceStarts[k]);
+                if (!shared)
+                    return;
+                if (copies < 0) {
+                    const found = host.resourceRow();
+                    for (let k = 0; k < keys.length; k++) {
+                        if (own[k])
+                            continue;
+                        resolved[k].storage = found?.archetype.storageById[numbers[k]];
+                        resolved[k].row = found?.row ?? 0;
+                    }
+                    return;
+                }
+                if (stringKeys.length > 0) {
+                    // One view over every handle, a slot each.
+                    const views = viewsOf(buffer, copies, 4 * stringKeys.length);
+                    for (let slot = 0; slot < stringKeys.length; slot++) {
+                        const k = stringKeys[slot];
+                        resolved[k].storage = columnStorage(numbers[k], stringLayouts[slot], views, [], host.strings);
+                        resolved[k].row = slot;
+                    }
+                }
+                for (let slot = 0; slot < linearKeys.length; slot++) {
+                    const k = linearKeys[slot];
+                    resolved[k].storage = columnStorage(numbers[k], linearLayouts[slot], viewsOf(buffer, copies + resourceOffsets[slot], linearStrides[slot]), [], null);
+                    resolved[k].row = 0;
+                }
+                for (let slot = 0; slot < constantKeys.length; slot++) {
+                    resolved[constantKeys[slot]].storage = constantStorages[slot];
+                    resolved[constantKeys[slot]].row = 0;
+                }
+            },
+            body: (row, context) => untyped.body(row, context),
+        };
+    };
+    /** Records the finalizers the world places here; one this thread never imported fails each group of its stops. */
+    const setup = (placed) => {
+        for (const { index, leaf } of placed)
+            finalizers[index] = leaf === null ? null : create(leaf);
+    };
+    /** Runs a body, keeping what it throws. */
+    const guarded = (index, finalizer, row) => {
+        try {
+            finalizer.body(row.value, finalizer.context);
+        }
+        catch (error) {
+            errors.push([index, errorOf(error)]);
+        }
+    };
+    /** One of an object read's values for a stop: by its tag, else at its row, or after a rebuild as it was. */
+    const objectOf = (tag, start, entity, archetype, row, component, old) => {
+        if (tag === startTag)
+            return start;
+        if (tag === nullTag)
+            return null;
+        if (old === null) {
+            const column = mirror.archetypes[archetype]?.byComponent[component];
+            return column === undefined ? start : column.values[row];
+        }
+        const previous = old(entity, component, start);
+        return tag === ownTag ? previous : stagedValue(mirror, (tag - slotTags) >>> 0, previous);
+    };
+    /** Whether every finalizer a block names was set up here, as null for one this thread never imported. */
+    const known = (block) => {
+        const groups = u32[(block >> 2) + blockGroupsWord];
+        let group = block + blockHeaderBytes;
+        for (let g = 0; g < groups; g++) {
+            if (finalizers[u32[(group >> 2) + groupIndexWord]] === undefined)
+                return false;
+            group += u32[(group >> 2) + groupBytesWord];
+        }
+        return true;
+    };
+    /** Runs each group of a block: the bodies of its finalizer for its stops, over a row reading the block's columns. */
+    const runBlock = (block, old) => {
+        const groups = u32[(block >> 2) + blockGroupsWord];
+        let group = block + blockHeaderBytes;
+        for (let g = 0; g < groups; g++) {
+            const index = u32[(group >> 2) + groupIndexWord];
+            const count = u32[(group >> 2) + groupCountWord];
+            const bytes = u32[(group >> 2) + groupBytesWord];
+            const finalizer = finalizers[index];
+            if (finalizer === null || finalizer === undefined) {
+                // Set up, as null, for one this thread never imported.
+                errors.push([index, errorOf(new Error(`A finalizer the world placed on this thread isn't one this thread imported, so ${count === 1 ? "a stop" : `${count} stops`} didn't run.`))]);
+                group += bytes;
+                continue;
+            }
+            const storageById = [];
+            const entityWords = entitiesAt(group) >> 3;
+            const archetypeWords = archetypesAt(group, count) >> 2;
+            const rowWords = rowsAt(group, count) >> 2;
+            const { objects, starts, linear, layouts } = finalizer;
+            for (let k = 0; k < objects.length; k++) {
+                const tags = tagsAt(group, count, k) >> 2;
+                const values = new Array(count);
+                for (let i = 0; i < count; i++) {
+                    values[i] = objectOf(u32[tags + i], starts[k], f64[entityWords + i], u32[archetypeWords + i], u32[rowWords + i], objects[k], old);
+                }
+                storageById[objects[k]] = columnStorage(objects[k], objectLayout, emptyViews, values, null);
+            }
+            let column = valuesAt(group, count, objects.length);
+            for (let k = 0; k < linear.length; k++) {
+                const layout = layouts[k];
+                const stride = layout.kind === "linear" || layout.kind === "string" ? layout.stride : 0;
+                storageById[linear[k]] = columnStorage(linear[k], layout, viewsOf(buffer, column, count * stride), [], host.strings);
+                column += columnBytes(count, stride);
+            }
+            // A shared component's value is each stop's archetype's, bound a run of one archetype's stops at a time.
+            const shared = [];
+            for (let k = 0; k < finalizer.constants.length; k++) {
+                const component = finalizer.constants[k];
+                const layout = finalizer.constantLayouts[k];
+                if (layout.kind === "constant" && layout.shared === true)
+                    shared.push(component);
+                else
+                    storageById[component] = columnStorage(component, layout, emptyViews, [], null);
+            }
+            const entities = new Float64Array(buffer, entitiesAt(group), count);
+            finalizer.cells(column);
+            if (finalizer.optional.length === 0 && shared.length === 0) {
+                const row = finalizer.bind({ id: -1, entities, storageById });
+                for (let i = 0; i < count; i++) {
+                    row.index = i;
+                    guarded(index, finalizer, row);
+                }
+            }
+            else {
+                // A stop's row has an optional component only where its archetype did: rows run a run of one
+                // archetype's stops at a time, and archetypes with the same ones share their copy of the columns.
+                const byPattern = new Map();
+                for (let i = 0; i < count;) {
+                    const id = u32[archetypeWords + i];
+                    let end = i + 1;
+                    while (end < count && u32[archetypeWords + end] === id)
+                        end++;
+                    const components = host.archetypeAt(id)?.components ?? [];
+                    let pattern = 0;
+                    finalizer.optional.forEach((component, k) => { if (components.includes(component))
+                        pattern |= 1 << k; });
+                    // With shared components, each archetype has its own copy, holding its values.
+                    const key = shared.length === 0 ? pattern : -1 - id;
+                    let archetype = byPattern.get(key);
+                    if (archetype === undefined) {
+                        const storages = [...storageById];
+                        finalizer.optional.forEach((component, k) => { if ((pattern & (1 << k)) === 0)
+                            storages[component] = undefined; });
+                        const viewed = shared.length === 0 ? undefined : host.archetypeAt(id);
+                        for (const component of shared) {
+                            const layout = viewed?.storageById[component]?.layout;
+                            storages[component] = layout === undefined ? undefined : columnStorage(component, layout, emptyViews, [], null);
+                        }
+                        byPattern.set(key, archetype = { id: -1, entities, storageById: storages });
+                    }
+                    const row = finalizer.bind(archetype);
+                    for (; i < end; i++) {
+                        row.index = i;
+                        guarded(index, finalizer, row);
+                    }
+                }
+            }
+            group += bytes;
+        }
+    };
+    const report = () => {
+        if (errors.length === 0)
+            return;
+        host.failed(errors.splice(0));
+    };
+    /** Stores the sync finalized through, once it moved on. */
+    const acknowledge = (sync) => {
+        if (((sync - finalized) | 0) <= 0)
+            return;
+        finalized = sync >>> 0;
+        Atomics.store(mirror.header, logFinalizedWord, finalized);
+    };
+    /**
+     * Runs the stop lists of every sync through `sync` not run yet, in order, then stores it as finalized through: with
+     * `old`, after the log lapped, reading this thread's objects as they were before the rebuild. False, having stopped
+     * before it, at a block naming a finalizer whose setup hasn't arrived yet.
+     */
+    const through = (sync, old) => {
+        views();
+        const { header } = mirror;
+        let complete = true;
+        for (;;) {
+            const next = anchor === 0 ? Atomics.load(header, logStopsWord) >>> 0 : Atomics.load(u32, (anchor >> 2) + blockNextWord);
+            if (next === 0)
+                break;
+            const blockSync = u32[(next >> 2) + blockSyncWord];
+            if (((sync - blockSync) | 0) < 0)
+                break;
+            if (!known(next)) {
+                acknowledge((blockSync - 1) >>> 0);
+                complete = false;
+                break;
+            }
+            runBlock(next, old);
+            anchor = next;
+        }
+        if (complete)
+            acknowledge(sync);
+        report();
+        return complete;
+    };
+    /** Whether a stop list is linked that this thread hasn't run. */
+    const pending = () => {
+        if (anchor === 0)
+            return Atomics.load(mirror.header, logStopsWord) !== 0;
+        views();
+        return Atomics.load(u32, (anchor >> 2) + blockNextWord) !== 0;
+    };
+    /** Once the world is disposed: every finalizer runs for every row it matches, reading this thread's objects there. */
+    const all = () => {
+        views();
+        for (let index = 0; index < finalizers.length; index++) {
+            const finalizer = finalizers[index];
+            if (finalizer === null || finalizer === undefined)
+                continue;
+            finalizer.cells(-1);
+            for (let id = 0; id < host.tableCount(); id++) {
+                const archetype = host.archetypeAt(id);
+                if (archetype === undefined || archetype.resource)
+                    continue;
+                const { components } = archetype;
+                if (!finalizer.required.every(component => components.includes(component)) || finalizer.excluded.some(component => components.includes(component)))
+                    continue;
+                const count = host.countOf(archetype);
+                if (count === 0)
+                    continue;
+                const row = finalizer.bind(archetype);
+                for (let i = 0; i < count; i++) {
+                    row.index = i;
+                    guarded(index, finalizer, row);
+                }
+            }
+        }
+        report();
+    };
+    return { setup, through, pending, all };
+};
+//# sourceMappingURL=thread-finalizers.js.map

package/dist/implementation/world/thread-finalizers.js.map

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

package/dist/implementation/world/thread-indexes.d.ts

@@ -0,0 +1,28 @@
+import type { Layout } from '../../interface/registry/layout.js';
+import { type LookupArchetype } from './index-lookups.js';
+import type { RowHost } from './rows.js';
+import type { Key } from './state.js';
+/** How many f64 words a lookup's index record takes, as `writeIndexParameters` (`kernel-indexes.ts`) writes it. */
+export declare const recordWordsOf: (sorted: boolean, watched: number) => number;
+/**
+ * A joined thread's lookup through one of the world's indexes, which lives in the memory: the function its body calls,
+ * and `refresh`, which points its views at the index's arrays as the world wrote them into its record before the task.
+ */
+export type ThreadIndex = {
+    readonly lookup: (...key: unknown[]) => unknown;
+    readonly refresh: (buffer: ArrayBufferLike) => void;
+};
+/** What a joined thread knows of a lookup through an index: its key's layouts, the index's kind, its rows' reads and its record. */
+export type ThreadIndexSetup = {
+    readonly layouts: readonly Layout[];
+    readonly sorted: boolean;
+    readonly unique: boolean;
+    readonly reads: readonly Key[];
+    readonly readIds: readonly number[];
+    readonly watched: number;
+    /** The byte offset of the record the world writes before each task. */
+    readonly record: number;
+};
+export declare const createThreadIndex: (rows: RowHost, archetypeAt: (id: number) => LookupArchetype | undefined, replaced: {
+    readonly count: number;
+}, setup: ThreadIndexSetup) => ThreadIndex;

package/dist/implementation/world/thread-indexes.js

@@ -0,0 +1,72 @@
+import { recordKey } from './index-hash.js';
+import { keyPartsOf } from './index-keys.js';
+import { lookupFunction } from './index-lookups.js';
+import { sortedStride } from './index-sorted.js';
+/** How many f64 words a lookup's index record takes, as `writeIndexParameters` (`kernel-indexes.ts`) writes it. */
+export const recordWordsOf = (sorted, watched) => (sorted ? 11 : 7) + watched;
+const none32 = new Uint32Array(0);
+const noneI32 = new Int32Array(0);
+const none64 = new Float64Array(0);
+/** A view from `at` to the end of the memory, the same one while neither changed. */
+const spanning = (current, buffer, at, make) => current.buffer === buffer && current.byteOffset === at ? current : make(buffer, at);
+const u32From = (buffer, at) => new Uint32Array(buffer, at);
+const i32From = (buffer, at) => new Int32Array(buffer, at);
+const f64From = (buffer, at) => new Float64Array(buffer, at);
+export const createThreadIndex = (rows, archetypeAt, replaced, setup) => {
+    const { parts, words } = keyPartsOf(setup.layouts);
+    const watchedPositions = Array.from({ length: setup.watched }, (_, k) => k);
+    const hashWatched = new Map();
+    const sortedWatched = new Map();
+    // The world sorts a hash index's buckets before writing its record, so this view has none unsorted.
+    const hash = setup.sorted ? null : { words, stride: recordKey + words, slots: none32, records: none32, ticks: none64, cleared: 0, entries: noneI32, unsorted: 0, watched: hashWatched };
+    const sorted = !setup.sorted ? null : {
+        words, stride: sortedStride(words), parts, objects: false, entries: none32, lengths: noneI32, order: noneI32, blocks: 0, counts: noneI32, tree: none64, leaves: 1,
+        fences: none32, size: 0, cleared: 0, watched: sortedWatched,
+    };
+    const index = { parts, words, unique: setup.unique, hash, sorted };
+    const since = { value: 0 };
+    const lookup = lookupFunction({ rows, archetypeAt, index, unique: setup.unique, reads: setup.reads, readIds: setup.readIds, watched: watchedPositions, since, replaced });
+    const count = recordWordsOf(setup.sorted, setup.watched);
+    let record = none64;
+    const refresh = (buffer) => {
+        if (record.buffer !== buffer)
+            record = new Float64Array(buffer, setup.record, count);
+        if (hash !== null) {
+            const slots = record[0];
+            const length = (record[1] + 1) * 2;
+            if (hash.slots.buffer !== buffer || hash.slots.byteOffset !== slots || hash.slots.length !== length)
+                hash.slots = new Uint32Array(buffer, slots, length);
+            hash.records = spanning(hash.records, buffer, record[2], u32From);
+            hash.entries = spanning(hash.entries, buffer, record[3], i32From);
+            hash.ticks = spanning(hash.ticks, buffer, record[4], f64From);
+            hash.cleared = record[5];
+            since.value = record[6];
+            for (let k = 0; k < setup.watched; k++)
+                hashWatched.set(k, spanning(hashWatched.get(k) ?? none64, buffer, record[7 + k], f64From));
+            return;
+        }
+        if (sorted === null)
+            return;
+        sorted.fences = spanning(sorted.fences, buffer, record[0], u32From);
+        sorted.blocks = record[1];
+        sorted.order = spanning(sorted.order, buffer, record[2], i32From);
+        sorted.lengths = spanning(sorted.lengths, buffer, record[3], i32From);
+        sorted.entries = spanning(sorted.entries, buffer, record[4], u32From);
+        sorted.counts = spanning(sorted.counts, buffer, record[5], i32From);
+        sorted.size = record[6];
+        sorted.tree = spanning(sorted.tree, buffer, record[7], f64From);
+        sorted.leaves = record[8];
+        sorted.cleared = record[9];
+        since.value = record[10];
+        for (let k = 0; k < setup.watched; k++) {
+            const watch = sortedWatched.get(k);
+            const at = record[11 + k];
+            if (watch === undefined)
+                sortedWatched.set(k, { tree: f64From(buffer, at) });
+            else
+                watch.tree = spanning(watch.tree, buffer, at, f64From);
+        }
+    };
+    return { lookup, refresh };
+};
+//# sourceMappingURL=thread-indexes.js.map

package/dist/implementation/world/thread-indexes.js.map

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

package/dist/implementation/world/thread-observer.d.ts

@@ -0,0 +1,43 @@
+import type { Leaf } from '../../interface/system/leaf.js';
+import { type ObserverSetup, type ToWorld } from './joining.js';
+import type { Mirror } from './mirror.js';
+import type { ThreadDirectory } from './thread-directory.js';
+import { type ThreadRunner } from './thread-systems.js';
+/** What the thread gives its observer systems. */
+export type ThreadObserverHost = {
+    readonly directory: ThreadDirectory;
+    readonly mirror: Mirror | null;
+    readonly post: (message: ToWorld) => void;
+    /** Brings the mirror up to the newest published sync; false while it can't yet. */
+    readonly current: () => boolean;
+    /** This thread's own observer system by its number, while it lives. */
+    readonly localOf: (number: number) => Local | undefined;
+};
+/**
+ * An observer system of this thread's own, by its number for it: its value, its runner once the world placed it, the
+ * newest of its runs a post ran for, and what that post's body returned or threw, which those runs settle with.
+ */
+export type Local = {
+    readonly number: number;
+    readonly leaf: Leaf;
+    runner: ThreadRunner | null;
+    ran: number;
+    value: unknown;
+    error: unknown;
+    /** Whether it's placed on this thread now: false once removed, until placed again. */
+    placed: boolean;
+    /** The last of this thread's runs posted before it was last removed here: those that didn't run then never do. */
+    stopped: number;
+};
+export declare const createThreadObserver: (host: ThreadObserverHost) => {
+    setup: (systems: readonly ObserverSetup[]) => void;
+    unplace: (indexes: readonly number[]) => void;
+    stop: (local: Local) => void;
+    process: () => number;
+    /** Whether any observer system is placed here. */
+    active: () => boolean;
+    /** For tests of what a thread holds: how many observer systems are placed here. */
+    placedCount: () => number;
+};
+/** Whether a post ran for run `sequence` of a local observer system, or none ever will, since it was removed first. */
+export declare const settledFor: (local: Local, sequence: number) => boolean;