@adobe/ecs 0.0.0-stage → 0.2.0

package/dist/interface/registry/items.d.ts

@@ -0,0 +1,38 @@
+/** A registered system, rule or finalizer: what each constructor records, told apart by `kind`. */
+type Registered = {
+    readonly kind: string;
+    readonly name: string;
+    readonly declaration: object;
+};
+/** Whether two values are one item: the same value, or values registered under one id. */
+export declare const sameItem: (a: object, b: object) => boolean;
+/** The value first registered as this item, which stands for it wherever items compare; any other value as it is. */
+export declare const firstItemOf: (item: object) => object;
+/**
+ * The item already registered under `id` that `item` is: one of its kind with the same declaration, as a module
+ * evaluated again declares it; undefined without an id or for an id not registered. Throws for an id registered as
+ * another kind or with another declaration. `same` compares declarations.
+ */
+export declare const registeredAs: <T extends Registered>(item: T, id: string | undefined, same: (a: unknown, b: unknown) => boolean) => object | undefined;
+/**
+ * Records an item under its id: a value of an item `registeredAs` found shares its entry, and any other is a new item.
+ */
+export declare const recordItem: (item: Registered, id: string | undefined, existing: object | undefined) => void;
+/**
+ * An item's label: the one the plugin gave its constructor call's first argument, `value`, by the binding or function
+ * it's in, or an internal factory gave it; else its binding, from its id (`spawn` for `src/setup.ts#spawn`); else its
+ * kind numbered by creation (`system #3`).
+ */
+export declare const nameOf: (value: object, id: string | undefined, kind: "system" | "rule" | "finalizer" | "index") => string;
+/** The id the plugin gave an item, or null without one, as failures give it beside its label. */
+export declare const idOrNull: (item: object) => string | null;
+/** The id the plugin gave a system, rule or finalizer, by which other threads name it, if it gave one. */
+export declare const idOfItem: (item: object) => string | undefined;
+/** The item first registered under an id, or undefined where no module declaring it was imported. */
+export declare const itemOfId: (id: string) => {
+    readonly kind: string;
+    readonly name: string;
+} | undefined;
+/** The ids of every system, rule and finalizer of `kind` registered with one, as a joined thread tells the world what it imported. */
+export declare const identifiedItems: (kind: string) => readonly string[];
+export {};

package/dist/interface/registry/items.js

@@ -0,0 +1,79 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { takeLabelOfDeclaration } from './ids.js';
+/** Every system, rule and finalizer, by value: values of one id share an entry. */
+const entries = new WeakMap();
+/** Entries by the ids the plugin gave their declarations. */
+const identified = new Map();
+/** Whether two values are one item: the same value, or values registered under one id. */
+export const sameItem = (a, b) => {
+    if (a === b)
+        return true;
+    const entry = entries.get(a);
+    return entry !== undefined && entry === entries.get(b);
+};
+/** The value first registered as this item, which stands for it wherever items compare; any other value as it is. */
+export const firstItemOf = (item) => entries.get(item)?.first ?? item;
+/**
+ * The item already registered under `id` that `item` is: one of its kind with the same declaration, as a module
+ * evaluated again declares it; undefined without an id or for an id not registered. Throws for an id registered as
+ * another kind or with another declaration. `same` compares declarations.
+ */
+export const registeredAs = (item, id, same) => {
+    if (id === undefined)
+        return undefined;
+    const entry = identified.get(id);
+    if (entry === undefined)
+        return undefined;
+    if (entry.kind !== item.kind)
+        throw new Error(`Cannot declare "${item.name}" (${id}): its id is a ${entry.kind}'s.`);
+    if (!same(entry.declaration, item.declaration)) {
+        throw new Error(`Cannot declare "${item.name}" (${id}): its id is another item's, with another declaration; if a module was evaluated again with a changed declaration, reload the page.`);
+    }
+    return entry.first;
+};
+/**
+ * Records an item under its id: a value of an item `registeredAs` found shares its entry, and any other is a new item.
+ */
+export const recordItem = (item, id, existing) => {
+    const shared = existing === undefined ? undefined : entries.get(existing);
+    if (shared !== undefined) {
+        entries.set(item, shared);
+        return;
+    }
+    const entry = { kind: item.kind, declaration: item.declaration, id, first: item };
+    if (id !== undefined)
+        identified.set(id, entry);
+    entries.set(item, entry);
+};
+/** How many items of each kind were labeled by number, to number the next. */
+const anonymous = new Map();
+/**
+ * An item's label: the one the plugin gave its constructor call's first argument, `value`, by the binding or function
+ * it's in, or an internal factory gave it; else its binding, from its id (`spawn` for `src/setup.ts#spawn`); else its
+ * kind numbered by creation (`system #3`).
+ */
+export const nameOf = (value, id, kind) => {
+    const label = takeLabelOfDeclaration(value);
+    if (label !== undefined)
+        return label;
+    if (id !== undefined)
+        return id.slice(id.lastIndexOf("#") + 1);
+    const count = (anonymous.get(kind) ?? 0) + 1;
+    anonymous.set(kind, count);
+    return `${kind} #${count}`;
+};
+/** The id the plugin gave an item, or null without one, as failures give it beside its label. */
+export const idOrNull = (item) => entries.get(item)?.id ?? null;
+/** The id the plugin gave a system, rule or finalizer, by which other threads name it, if it gave one. */
+export const idOfItem = (item) => entries.get(item)?.id;
+/** The item first registered under an id, or undefined where no module declaring it was imported. */
+export const itemOfId = (id) => identified.get(id)?.first;
+/** The ids of every system, rule and finalizer of `kind` registered with one, as a joined thread tells the world what it imported. */
+export const identifiedItems = (kind) => {
+    const found = [];
+    for (const [id, entry] of identified)
+        if (entry.kind === kind)
+            found.push(id);
+    return found;
+};
+//# sourceMappingURL=items.js.map

package/dist/interface/registry/items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"items.js","sourceRoot":"","sources":["../../../src/interface/registry/items.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAgBlD,mFAAmF;AACnF,MAAM,OAAO,GAAG,IAAI,OAAO,EAAiB,CAAC;AAE7C,6DAA6D;AAC7D,MAAM,UAAU,GAAG,IAAI,GAAG,EAAiB,CAAC;AAE5C,0FAA0F;AAC1F,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,CAAS,EAAW,EAAE;IACtD,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7B,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC,CAAC;AAEF,qHAAqH;AACrH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;AAEtF;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAuB,IAAO,EAAE,EAAsB,EAAE,IAAyC,EAAsB,EAAE;IACjJ,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACvC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,IAAI,MAAM,EAAE,kBAAkB,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC;IACrH,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,IAAI,MAAM,EAAE,qIAAqI,CAAC,CAAC;IAC/L,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC;AACvB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAgB,EAAE,EAAsB,EAAE,QAA4B,EAAQ,EAAE;IACvG,MAAM,MAAM,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC1E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1B,OAAO;IACX,CAAC;IACD,MAAM,KAAK,GAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzF,IAAI,EAAE,KAAK,SAAS;QAAE,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF,8EAA8E;AAC9E,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAsB,EAAE,IAA+C,EAAU,EAAE;IACrH,MAAM,KAAK,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7C,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3B,OAAO,GAAG,IAAI,KAAK,KAAK,EAAE,CAAC;AAC/B,CAAC,CAAC;AAEF,iGAAiG;AACjG,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAiB,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,IAAI,CAAC;AAEvF,0GAA0G;AAC1G,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAsB,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;AAEpF,qGAAqG;AACrG,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAgE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC;AAEhI,sIAAsI;AACtI,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAqB,EAAE;IAC/D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,UAAU;QAAE,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9E,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC"}

package/dist/interface/registry/layout.d.ts

@@ -0,0 +1,61 @@
+import type { Schema } from '../schema/schema.js';
+/** A path from a value to one scalar leaf: `[]` for a scalar, `[1]` for a tuple element, `["x"]` for a struct field. */
+export type Path = readonly (number | string)[];
+/** A leaf's logical type. */
+export type Scalar = "f32" | "f64" | "i32" | "u32" | "boolean";
+/** The typed array a leaf is stored through: booleans are `u8` on the CPU and `u32` in GPU layouts. */
+export type View = "f32" | "f64" | "i32" | "u32" | "u8";
+/** Views of one component's bytes; a leaf reads the one its `view` names. */
+export type Views = {
+    readonly f32: Float32Array;
+    readonly f64: Float64Array;
+    readonly i32: Int32Array;
+    readonly u32: Uint32Array;
+    readonly u8: Uint8Array;
+};
+export type TypedArray = Views[keyof Views];
+/** A scalar leaf at byte `offset` within each element. In elements of its view, a row's value is at `row * unitStride + unitOffset`. */
+export type Leaf = {
+    readonly path: Path;
+    readonly scalar: Scalar;
+    readonly view: View;
+    readonly offset: number;
+    readonly unitStride: number;
+    readonly unitOffset: number;
+};
+/**
+ * How a component's values are stored.
+ * - `constant`: a `const` schema; no storage, every value is `value`. A shared component's is one of these per archetype,
+ *   `shared`, its value the archetype's, and its component's is its start.
+ * - `linear`: interleaved elements of `stride` bytes in one column. `read` copies a value out; `write` replaces it.
+ * - `string`: the world's thread's values, as `object`'s, and a 4-byte handle per row, in one column, to each one's
+ *   record in shared memory, which other threads read; only the world's thread writes them.
+ * - `object`: a JS array of values, on its logical thread only.
+ */
+export type Layout = {
+    readonly kind: "constant";
+    readonly value: unknown;
+    readonly shared?: true;
+} | {
+    readonly kind: "linear";
+    readonly leaves: readonly Leaf[];
+    readonly stride: number;
+    readonly read: (views: Views, row: number) => unknown;
+    readonly write: (views: Views, row: number, value: unknown) => void;
+} | {
+    readonly kind: "string";
+    readonly stride: 4;
+} | {
+    readonly kind: "object";
+};
+/** The layout of values stored as they are. */
+export declare const objectLayout: Layout;
+export declare const bytesOf: (view: View) => number;
+export declare const viewsOf: (buffer: ArrayBufferLike, byteOffset: number, byteLength: number) => Views;
+/**
+ * How a schema's values are stored. Throws when a schema declares a GPU `layout` it can't meet,
+ * naming the leaf and the fix, so registration fails rather than the GPU upload.
+ */
+/** A value without a schema isn't data, so it's stored as it is. */
+export declare const layoutOf: (schema: Schema | undefined) => Layout;
+export declare const samePath: (a: Path, b: Path) => boolean;

package/dist/interface/registry/layout.js

@@ -0,0 +1,318 @@
+import { isString, numberConstants } from './schemas.js';
+/** The layout of every string. */
+const stringLayout = { kind: "string", stride: 4 };
+/** The layout of values stored as they are. */
+export const objectLayout = { kind: "object" };
+export const bytesOf = (view) => view === "f64" ? 8 : view === "u8" ? 1 : 4;
+export const viewsOf = (buffer, byteOffset, byteLength) => ({
+    f32: new Float32Array(buffer, byteOffset, byteLength >> 2),
+    f64: new Float64Array(buffer, byteOffset, Math.floor(byteLength / 8)),
+    i32: new Int32Array(buffer, byteOffset, byteLength >> 2),
+    u32: new Uint32Array(buffer, byteOffset, byteLength >> 2),
+    u8: new Uint8Array(buffer, byteOffset, byteLength),
+});
+const integerScalar = ({ minimum, maximum }) => {
+    if (minimum === undefined || maximum === undefined)
+        return "f64";
+    if (minimum >= 0 && maximum <= 0xFFFFFFFF)
+        return "u32";
+    if (minimum >= -0x80000000 && maximum <= 0x7FFFFFFF)
+        return "i32";
+    return "f64";
+};
+/** `null` if the schema isn't linear: numbers, booleans, fixed-length tuples and structs of those. */
+const shapeOf = (schema) => {
+    // A union of number constants is a number: integers at the narrowest width holding them, and with -0, which an
+    // integer can't hold, f64.
+    const constants = numberConstants(schema);
+    if (constants !== null) {
+        return { kind: "scalar", scalar: constants.every(constant => Number.isInteger(constant) && !Object.is(constant, -0)) ? integerScalar({ minimum: Math.min(...constants), maximum: Math.max(...constants) }) : "f64" };
+    }
+    if (!("type" in schema))
+        return null;
+    switch (schema.type) {
+        case "number": return { kind: "scalar", scalar: schema.precision === 1 ? "f32" : "f64" };
+        case "integer": return { kind: "scalar", scalar: "format" in schema ? "f64" : integerScalar(schema) };
+        case "boolean": return { kind: "scalar", scalar: "boolean" };
+        case "array": {
+            const length = schema.minItems;
+            if (length === undefined || length !== schema.maxItems)
+                return null;
+            const item = shapeOf(schema.items);
+            return item === null ? null : { kind: "tuple", items: new Array(length).fill(item) };
+        }
+        case "object": {
+            const names = Object.keys(schema.properties);
+            const { required } = schema;
+            if (required !== undefined && names.some(name => !required.includes(name)))
+                return null;
+            const items = [];
+            for (const name of names) {
+                const item = shapeOf(schema.properties[name]);
+                if (item === null)
+                    return null;
+                items.push(item);
+            }
+            return { kind: "struct", names, items };
+        }
+        default: return null;
+    }
+};
+const roundUp = (value, alignment) => Math.ceil(value / alignment) * alignment;
+const describe = (path) => path.length === 0 ? "the value" : `[${path.map(key => JSON.stringify(key)).join("][")}]`;
+const gpuScalar = (scalar, path) => {
+    if (scalar === "f64")
+        throw new Error(`${describe(path)} is f64, which isn't GPU compatible: use a number with precision: 1, or an integer with minimum and maximum within i32 or u32.`);
+    return scalar === "boolean" ? "u32" : scalar;
+};
+const sameScalar = (items) => {
+    const first = items[0];
+    if (first?.kind !== "scalar")
+        return null;
+    return items.every(item => item.kind === "scalar" && item.scalar === first.scalar) ? first.scalar : null;
+};
+const place = (shape, path, rules) => {
+    if (shape.kind === "scalar") {
+        const view = rules === "cpu" ? (shape.scalar === "boolean" ? "u8" : shape.scalar) : gpuScalar(shape.scalar, path);
+        const size = bytesOf(view);
+        return { size, align: size, leaves: [{ path, scalar: shape.scalar, view, offset: 0 }] };
+    }
+    const keys = shape.kind === "struct" ? shape.names : shape.items.map((_, i) => i);
+    const items = shape.items.map((item, i) => place(item, [...path, keys[i]], rules));
+    if (rules === "storage" && shape.kind === "tuple") {
+        const scalar = sameScalar(shape.items);
+        const length = shape.items.length;
+        // WGSL vec2/vec3/vec4: 4-byte components, aligned to 8, 16, 16; a vec3 is 12 bytes, so a scalar can follow it.
+        if (scalar !== null && length >= 2 && length <= 4) {
+            return { size: 4 * length, align: length === 2 ? 8 : 16, leaves: items.map((item, i) => ({ ...item.leaves[0], offset: 4 * i })) };
+        }
+        if (!shape.items.every(item => JSON.stringify(item) === JSON.stringify(shape.items[0]))) {
+            throw new Error(`${describe(path)} mixes element types, which a WGSL array can't: use a struct.`);
+        }
+        // WGSL array<T, N>: elements at a stride of T's size rounded up to its alignment.
+        const element = items[0];
+        const stride = roundUp(element.size, element.align);
+        return {
+            size: stride * length,
+            align: element.align,
+            leaves: items.flatMap((item, i) => item.leaves.map(leaf => ({ ...leaf, offset: leaf.offset + i * stride }))),
+        };
+    }
+    const align = rules === "vertex" ? 4 : Math.max(...items.map(item => item.align));
+    return pack(items, align, rules === "vertex" ? 4 : 0);
+};
+/** Members in order, each at its alignment (or `memberAlign` when set), padded to the aggregate's alignment. */
+const pack = (items, align, memberAlign) => {
+    let offset = 0;
+    const leaves = [];
+    for (const item of items) {
+        offset = roundUp(offset, memberAlign === 0 ? item.align : Math.min(memberAlign, item.align));
+        for (const leaf of item.leaves)
+            leaves.push({ ...leaf, offset: offset + leaf.offset });
+        offset += item.size;
+    }
+    return { size: roundUp(offset, align), align, leaves };
+};
+const element = (value, key) => typeof value === "object" && value !== null ? Reflect.get(value, key) : undefined;
+/** A tuple of 2 to 4 same-typed scalars in consecutive elements of one view. */
+const lanesNode = (view, unitStride, unitOffset, length) => {
+    const write = (views, row, value) => {
+        const target = views[view];
+        const index = row * unitStride + unitOffset;
+        if (Array.isArray(value))
+            for (let i = 0; i < length; i++)
+                target[index + i] = Number(value[i]);
+        else
+            for (let i = 0; i < length; i++)
+                target[index + i] = Number(element(value, i));
+    };
+    if (length === 2)
+        return {
+            read: (views, row) => {
+                const target = views[view];
+                const index = row * unitStride + unitOffset;
+                return [target[index], target[index + 1]];
+            },
+            write,
+        };
+    if (length === 3)
+        return {
+            read: (views, row) => {
+                const target = views[view];
+                const index = row * unitStride + unitOffset;
+                return [target[index], target[index + 1], target[index + 2]];
+            },
+            write,
+        };
+    return {
+        read: (views, row) => {
+            const target = views[view];
+            const index = row * unitStride + unitOffset;
+            return [target[index], target[index + 1], target[index + 2], target[index + 3]];
+        },
+        write,
+    };
+};
+/** Builds read/write closures over placed leaves, consuming them in shape order. */
+const nodeOf = (shape, leaves, next) => {
+    if (shape.kind === "scalar") {
+        const { view, unitStride, unitOffset } = leaves[next.index++];
+        return shape.scalar === "boolean"
+            ? { read: (views, row) => views[view][row * unitStride + unitOffset] !== 0, write: (views, row, value) => { views[view][row * unitStride + unitOffset] = Number(value); } }
+            : { read: (views, row) => views[view][row * unitStride + unitOffset], write: (views, row, value) => { views[view][row * unitStride + unitOffset] = Number(value); } };
+    }
+    const first = next.index;
+    const items = shape.items.map(item => nodeOf(item, leaves, next));
+    const tupleLeaves = leaves.slice(first, next.index);
+    // A tuple of same-typed non-boolean scalars, like a vec3: one loop over its leaves.
+    if (shape.kind === "tuple" && shape.items.every(item => item.kind === "scalar" && item.scalar !== "boolean") && tupleLeaves.every(leaf => leaf.view === tupleLeaves[0].view)) {
+        const view = tupleLeaves[0].view;
+        const strides = tupleLeaves.map(leaf => leaf.unitStride);
+        const offsets = tupleLeaves.map(leaf => leaf.unitOffset);
+        const length = tupleLeaves.length;
+        const [{ unitStride, unitOffset }] = tupleLeaves;
+        // Lanes next to each other, as in a vec2, vec3 or vec4: array literals and straight-line stores.
+        if (length >= 2 && length <= 4 && tupleLeaves.every((leaf, i) => leaf.unitStride === unitStride && leaf.unitOffset === unitOffset + i))
+            return lanesNode(view, unitStride, unitOffset, length);
+        return {
+            read: (views, row) => {
+                const target = views[view];
+                const value = new Array(length);
+                for (let i = 0; i < length; i++)
+                    value[i] = target[row * strides[i] + offsets[i]];
+                return value;
+            },
+            write: (views, row, value) => {
+                const target = views[view];
+                if (Array.isArray(value))
+                    for (let i = 0; i < length; i++)
+                        target[row * strides[i] + offsets[i]] = Number(value[i]);
+                else
+                    for (let i = 0; i < length; i++)
+                        target[row * strides[i] + offsets[i]] = Number(element(value, i));
+            },
+        };
+    }
+    if (shape.kind === "tuple") {
+        return {
+            read: (views, row) => {
+                const value = new Array(items.length);
+                for (let i = 0; i < items.length; i++)
+                    value[i] = items[i].read(views, row);
+                return value;
+            },
+            write: (views, row, value) => {
+                if (Array.isArray(value))
+                    for (let i = 0; i < items.length; i++)
+                        items[i].write(views, row, value[i]);
+                else
+                    for (let i = 0; i < items.length; i++)
+                        items[i].write(views, row, element(value, i));
+            },
+        };
+    }
+    const { names } = shape;
+    return {
+        read: (views, row) => {
+            const value = {};
+            for (let i = 0; i < names.length; i++)
+                value[names[i]] = items[i].read(views, row);
+            return value;
+        },
+        write: (views, row, value) => {
+            for (let i = 0; i < names.length; i++)
+                items[i].write(views, row, element(value, names[i]));
+        },
+    };
+};
+/** Whether code can be generated here; a content security policy without `'unsafe-eval'` forbids it. */
+let generating = true;
+/** A struct member's name as an object literal's key: quoted, and computed for `__proto__`, which a plain key would make the prototype. */
+const propertyOf = (name) => name === "__proto__" ? `[${JSON.stringify(name)}]` : JSON.stringify(name);
+/**
+ * A struct's or nested tuple's read and write as straight-line code: one literal of its leaves' loads, and one store per
+ * leaf, rather than a call per leaf and properties added one at a time. Only numbers, view names and quoted member
+ * names are written into the code. A value that isn't an object is written through `fallback`. Null where code can't
+ * be generated.
+ */
+const generatedNode = (shape, leaves, fallback) => {
+    if (!generating)
+        return null;
+    const at = (leaf) => `views.${leaf.view}[row * ${leaf.unitStride} + ${leaf.unitOffset}]`;
+    let next = 0;
+    const literal = (node) => {
+        if (node.kind === "scalar") {
+            const leaf = leaves[next++];
+            return leaf.scalar === "boolean" ? `${at(leaf)} !== 0` : at(leaf);
+        }
+        if (node.kind === "tuple")
+            return `[${node.items.map(literal).join(", ")}]`;
+        return `{ ${node.items.map((item, i) => `${propertyOf(node.names[i])}: ${literal(item)}`).join(", ")} }`;
+    };
+    const read = literal(shape);
+    next = 0;
+    let temporaries = 0;
+    // A member of `value` is read directly when `value` is known to be an object, and through `element` otherwise.
+    const stores = (node, value, object) => {
+        if (node.kind === "scalar")
+            return [`${at(leaves[next++])} = Number(${value});`];
+        const keys = node.kind === "struct" ? node.names.map(name => JSON.stringify(name)) : node.items.map((_, i) => String(i));
+        return node.items.flatMap((item, i) => {
+            const member = object ? `${value}[${keys[i]}]` : `element(${value}, ${keys[i]})`;
+            if (item.kind === "scalar")
+                return stores(item, member, false);
+            const temporary = `t${temporaries++}`;
+            return [`const ${temporary} = ${member};`, ...stores(item, temporary, false)];
+        });
+    };
+    const body = [
+        `return { read: (views, row) => (${read}), write: (views, row, value) => {`,
+        `if (typeof value !== "object" || value === null) { fallback.write(views, row, value); return; }`,
+        ...stores(shape, "value", true),
+        "} };",
+    ].join("\n");
+    try {
+        // The factory returns the node its body above makes.
+        const node = new Function("element", "fallback", body)(element, fallback);
+        return node;
+    }
+    catch {
+        generating = false;
+        return null;
+    }
+};
+const gpuLayoutOf = (schema) => "type" in schema && (schema.type === "object" || schema.type === "array") ? schema.layout : undefined;
+/**
+ * How a schema's values are stored. Throws when a schema declares a GPU `layout` it can't meet,
+ * naming the leaf and the fix, so registration fails rather than the GPU upload.
+ */
+/** A value without a schema isn't data, so it's stored as it is. */
+export const layoutOf = (schema) => {
+    if (schema === undefined)
+        return objectLayout;
+    if ("const" in schema)
+        return { kind: "constant", value: schema.const };
+    if (isString(schema))
+        return stringLayout;
+    const rules = gpuLayoutOf(schema) ?? "cpu";
+    const shape = shapeOf(schema);
+    if (shape === null) {
+        if (rules !== "cpu")
+            throw new Error(`A ${rules} layout needs numbers, integers, booleans, fixed-length tuples and structs with every property required.`);
+        return objectLayout;
+    }
+    const placed = place(shape, [], rules);
+    // An array of elements: each is padded to its alignment.
+    const stride = roundUp(placed.size, placed.align);
+    const leaves = placed.leaves.map(leaf => ({
+        ...leaf,
+        unitStride: stride / bytesOf(leaf.view),
+        unitOffset: leaf.offset / bytesOf(leaf.view),
+    }));
+    const built = nodeOf(shape, leaves, { index: 0 });
+    // Scalars and tuples of scalars are already straight-line.
+    const node = shape.kind === "struct" || (shape.kind === "tuple" && shape.items.some(item => item.kind !== "scalar")) ? generatedNode(shape, leaves, built) ?? built : built;
+    return { kind: "linear", leaves, stride, read: node.read, write: node.write };
+};
+export const samePath = (a, b) => a.length === b.length && a.every((key, i) => key === b[i]);
+//# sourceMappingURL=layout.js.map

package/dist/interface/registry/layout.js.map

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

package/dist/interface/registry/names.d.ts

@@ -0,0 +1,46 @@
+import type { AnyDeclaration } from './declarations.js';
+/** What a key names. */
+export type Kind = "component" | "resource" | "trait";
+/** Installs what registers the build's declarations, which every read of keys runs first. */
+export declare const installCatchUp: (update: () => void) => void;
+/** Records why a key the build declared failed to register. */
+export declare const recordFailure: (key: symbol, message: string) => void;
+/** Whether a key is a component, a resource or a trait. */
+export declare const kindOf: (key: unknown) => Kind | undefined;
+/** The declaration of a registered component or resource. */
+export declare const declarationOf: (key: unknown) => AnyDeclaration | undefined;
+/** Whether two values are one key: the same value, or symbols registered under one id. */
+export declare const sameKey: (a: unknown, b: unknown) => boolean;
+/** The symbol first registered as this key, which stands for it wherever keys are compared; any other value as it is. */
+export declare const firstKeyOf: <K>(key: K) => K | symbol;
+/** The symbol last registered as this key, by which a world gives values; any other value as it is. */
+export declare const newestKeyOf: <K>(key: K) => K | symbol;
+/**
+ * How errors name a key: its description, or without one its binding from its id, whatever other keys
+ * have; for display only, with its id (`idOfKey`) to tell keys of one label apart. Any other value is named as text.
+ */
+export declare const labelOf: (key: unknown) => string;
+/** Throws, naming the key by its label, and by `id` too where the failure is its id's, for a key registration can't take. */
+export declare const failRegistration: (kind: Kind, key: unknown, message: string, id?: string) => never;
+/** The key, or a throw for one that isn't a plain `Symbol(...)`: a `Symbol.for` or well-known symbol is shared. */
+export declare const requireKey: (kind: Kind, key: unknown) => symbol;
+/**
+ * Whether two declarations are the same, as a module evaluated again declares them, such as on a hot reload. Keys
+ * compare as `sameKey` does, and systems and finalizers they list as `sameItem` does, since evaluating their modules
+ * again makes new values of them.
+ */
+export declare const sameDeclaration: (a: unknown, b: unknown) => boolean;
+/**
+ * Records a key as a component, resource or trait, with its declaration. A symbol whose id is already a registered
+ * key's, of its kind with the same declaration, as a module evaluated again makes it, is that key. Throws for a key
+ * that isn't a plain `Symbol(...)`, one already registered, or one whose id is another kind's or has another
+ * declaration.
+ */
+export declare const claimKey: (key: unknown, kind: Kind, declaration?: AnyDeclaration) => void;
+/** The symbol last registered under an id, by which a world gives values, or undefined where none was. */
+export declare const keyOfId: (id: string) => symbol | undefined;
+/**
+ * Why a key isn't registered, for errors: its declaration failed to register; or the build registers keys from their
+ * declarations, so either its module wasn't built with the plugin, which gives keys ids, or it isn't declared.
+ */
+export declare const whyUnregistered: (key: unknown) => string;