@adobe/ecs 0.1.0 → 0.2.0

package/dist/interface/finalizer/create.js

@@ -1,10 +1,35 @@
-import { declarationOf, kindOf, labelOf } from '../registry/names.js';
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { declarationOf, kindOf, labelOf, whyUnregistered } from '../registry/names.js';
 import { takeIdOfDeclaration } from '../registry/ids.js';
-import { firstItemOf, labelOfItem, nameOf } from '../registry/items.js';
+import { firstItemOf, nameOf } from '../registry/items.js';
 import { addFinalizer, programFinalizers } from '../registry/program.js';
 import { requireRegistered, threadOf } from '../registry/threads.js';
 import { checkWorldWritten } from '../registry/written.js';
 import { checkLookup } from '../registry/indexes.js';
+import { accessOf, compact, lookupsLists, resourceUses } from '../system/resolve.js';
+/** What every finalizer's declaration holds as the world takes it: its lookups' and resources' lists from what the build inferred. */
+const resolveShared = (what, declared, access) => {
+    const uses = resourceUses(what, access, undefined);
+    if (uses.reduce.length > 0)
+        throw new Error(`${what} reduces into resources; only systems contribute to a reduction.`);
+    const lookup = lookupsLists(declared.lookup, access);
+    return {
+        ...lookup === undefined ? {} : { lookup },
+        resources: compact({ read: uses.read, write: uses.write }),
+        ...declared.before === undefined ? {} : { before: declared.before },
+        ...declared.after === undefined ? {} : { after: declared.after },
+    };
+};
+/** A finalizer's row lists: what its body reads, the rest of `with` only required. Throws for a body writing its row, which holds values from before. */
+const componentReads = (what, components, access) => {
+    const written = access.components?.write[0];
+    if (written !== undefined)
+        throw new Error(`${what} writes "${labelOf(written)}" of its row, which is read-only: it holds the values from before the entity stopped matching.`);
+    // Optional components are read where the entity had them, and never decide a stop.
+    const optional = (components.optional ?? []).filter(key => !(components.with ?? []).includes(key));
+    const read = access.components?.read ?? [...components.with ?? [], ...optional];
+    return compact({ read, has: (components.with ?? []).filter(key => !read.includes(key)), optional, not: components.not });
+};
 /** Throws if a resource is in both `read` and `write`, or a reduced one is written. */
 const checkResources = (name, resources) => {
     const writes = new Set(resources?.write);
@@ -28,7 +53,7 @@ const checkOrder = (name, thread, declaration) => {
             continue;
         const theirs = runsOn(found);
         if (theirs !== thread) {
-            throw new Error(`Finalizer "${name}" runs on thread "${thread}" and is ordered with "${labelOfItem(found)}", which runs on thread "${theirs}"; finalizers on different threads run at different times, so neither is ordered before the other.`);
+            throw new Error(`Finalizer "${name}" runs on thread "${thread}" and is ordered with "${found.name}", which runs on thread "${theirs}"; finalizers on different threads run at different times, so neither is ordered before the other.`);
         }
     }
 };
@@ -40,9 +65,15 @@ const checkOrder = (name, thread, declaration) => {
  * or looks up entities on another thread than the world's, or is ordered with a finalizer on another thread, in a cycle
  * or with a resource conflict.
  */
-export const create = (declaration, body) => {
-    const id = takeIdOfDeclaration(declaration);
-    const name = nameOf(declaration.name, id, "finalizer");
+export const create = (declared, body) => {
+    const id = takeIdOfDeclaration(declared);
+    const name = nameOf(declared, id, "finalizer");
+    const what = `Finalizer "${name}"`;
+    const access = accessOf(what, declared);
+    const declaration = {
+        ...resolveShared(what, declared, access),
+        components: componentReads(what, declared.components, access),
+    };
     const finalizer = { kind: "finalizer", name, declaration, body };
     checkResources(name, declaration.resources);
     const thread = threadOf(declaration, "Finalizer", name);
@@ -69,9 +100,11 @@ export const create = (declaration, body) => {
  * on the world's thread. Throws as `create` does, for a watched component that isn't registered or is derived, and for
  * one watching or reading another thread's values.
  */
-export const changes = (declaration, body) => {
-    const id = takeIdOfDeclaration(declaration);
-    const name = nameOf(declaration.name, id, "finalizer");
+export const changes = (declared, body) => {
+    const id = takeIdOfDeclaration(declared);
+    const name = nameOf(declared, id, "finalizer");
+    const what = `Finalizer "${name}"`;
+    const declaration = { ...resolveShared(what, declared, accessOf(what, declared)), ...declared.watch === undefined ? {} : { watch: declared.watch } };
     const finalizer = { kind: "changes", name, declaration, body };
     checkResources(name, declaration.resources);
     requireRegistered("Finalizer", name, "resource", declaration.resources?.read);
@@ -84,7 +117,7 @@ export const changes = (declaration, body) => {
     }
     for (const key of declaration.watch ?? []) {
         if (kindOf(key) !== "component")
-            throw new Error(`Finalizer "${name}" watches "${labelOf(key)}", which isn't a registered component.`);
+            throw new Error(`Finalizer "${name}" watches "${labelOf(key)}", which isn't a registered component: ${whyUnregistered(key)}.`);
         if (declarationOf(key)?.derived === true)
             throw new Error(`Finalizer "${name}" watches "${labelOf(key)}", which is derived; it sees only components user code adds and removes.`);
     }

package/dist/interface/finalizer/create.js.map

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

package/dist/interface/finalizer/created.d.ts

@@ -1,16 +1,16 @@
-import type { ChangesDeclaration, Declaration } from './declaration.js';
+import type { Resolved, ResolvedChanges } from './declaration.js';
 /** Runs, inside a sync point, for each entity that stops matching its components. */
-export type Leaf<D extends Declaration = Declaration> = {
+export type Leaf = {
     readonly kind: "finalizer";
     readonly name: string;
-    readonly declaration: D;
+    readonly declaration: Resolved;
     body: (...parameters: never[]) => void;
 };
 /** Runs, inside a sync point, with all its structural changes to the components it watches. */
-export type Changes<D extends ChangesDeclaration = ChangesDeclaration> = {
+export type Changes = {
     readonly kind: "changes";
     readonly name: string;
-    readonly declaration: D;
+    readonly declaration: ResolvedChanges;
     body: (...parameters: never[]) => void;
 };
 export type Finalizer = Leaf | Changes;

package/dist/interface/finalizer/declaration.d.ts

@@ -1,30 +1,28 @@
 import type { Component } from '../component/component.js';
-import type { Resource } from '../resource/resource.js';
+import type { SystemLookupLists, ResourceLists } from '../system/access.js';
 import type { Lookup } from '../system/access.js';
 import type { Finalizer } from './finalizer.js';
-import type { Name } from './name.js';
 import type { Essential } from '../component/value.js';
-import type { Reduced } from '../resource/reduction.js';
-import type { WorldWritten } from '../resource/written.js';
+/**
+ * What every finalizer declares. What its body reads of its row and lookups, and reads and writes of resources, the
+ * build infers; resource writes take the sync point's tick, so each system sees them once.
+ */
 type Shared = {
-    readonly name?: Name;
     /** Read-only access to other entities, as they are before the sync point applies. */
     readonly lookup?: {
         readonly [name: string]: Lookup;
     };
-    /** Writes take the sync point's tick, so each system sees them once. A resource in `write` is also readable. */
-    readonly resources?: {
-        readonly read?: readonly Resource.Key[];
-        readonly write?: readonly Exclude<Resource.Key, Reduced | WorldWritten>[];
-    };
     readonly before?: readonly Finalizer[];
     readonly after?: readonly Finalizer[];
 };
-/** A finalizer that runs for each entity that stops matching its components. */
+/**
+ * A finalizer that runs for each entity that stops matching its components: those with every one in `with` and none in
+ * `not`. Its `optional` components, which never decide a stop, its row reads where the entity had them.
+ */
 export type Declaration = Shared & {
     readonly components: {
-        readonly read?: readonly Component.Key[];
-        readonly has?: readonly Component.Key[];
+        readonly with?: readonly Component.Key[];
+        readonly optional?: readonly Component.Key[];
         readonly not?: readonly Component.Key[];
     };
 };
@@ -35,4 +33,26 @@ export type Declaration = Shared & {
 export type ChangesDeclaration = Shared & {
     readonly watch?: readonly Essential[];
 };
+type Key = symbol;
+/** What every finalizer's declaration holds as the world takes it, with what the build inferred its body uses. */
+type ResolvedShared = {
+    readonly lookup?: {
+        readonly [name: string]: SystemLookupLists;
+    };
+    readonly resources?: Pick<ResourceLists, "read" | "write">;
+    readonly before?: readonly Finalizer[];
+    readonly after?: readonly Finalizer[];
+};
+/** A finalizer's declaration as the world takes it: what its body reads of its row in `read`, the rest of `with` in `has`. */
+export type Resolved = ResolvedShared & {
+    readonly components: {
+        readonly read?: readonly Key[];
+        readonly has?: readonly Key[];
+        readonly optional?: readonly Key[];
+        readonly not?: readonly Key[];
+    };
+};
+export type ResolvedChanges = ResolvedShared & {
+    readonly watch?: readonly Key[];
+};
 export {};

package/dist/interface/finalizer/finalizer.d.ts

@@ -1,6 +1,6 @@
 /**
- * A finalizer, the value `Finalizer.create` or `Finalizer.changes` returned: identified by that value, labeled by its
- * name, and listed in other finalizers' `before` and `after`.
+ * A finalizer, the value `Finalizer.create` or `Finalizer.changes` returned: identified by that value, labeled by
+ * `name`, the binding it's declared at, and listed in other finalizers' `before` and `after`.
  */
 export type Finalizer = {
     readonly name: string;

package/dist/interface/finalizer/finalizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"finalizer.js","sourceRoot":"","sources":["../../../src/interface/finalizer/finalizer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,SAAS,MAAM,YAAY,CAAC"}
+{"version":3,"file":"finalizer.js","sourceRoot":"","sources":["../../../src/interface/finalizer/finalizer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,SAAS,MAAM,YAAY,CAAC"}

package/dist/interface/finalizer/index.js

@@ -1,2 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
 export * from './create.js';
 //# sourceMappingURL=index.js.map

package/dist/interface/finalizer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interface/finalizer/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interface/finalizer/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,cAAc,aAAa,CAAC"}

package/dist/interface/gpu/accessors.d.ts

@@ -7,8 +7,9 @@ export type Accessor = {
 };
 /**
  * Accessors for a render system's shader, in `accessors` order, or the reason one can't be read on the GPU: scalars
- * and tuples of two to four scalars of one type, laid out in 4-byte words.
+ * and tuples of two to four scalars of one type, laid out in 4-byte words. An `ordered` system's accessors take a
+ * row's position in its order, which `ecs_address` resolves to a table's column.
  */
-export declare const accessorsOf: (shader: Shader) => readonly Accessor[] | string;
+export declare const accessorsOf: (shader: Shader, ordered?: boolean) => readonly Accessor[] | string;
 /** The WGSL declarations of a render system's bind group and accessors. */
-export declare const declarationsOf: (group: number, accessors: readonly Accessor[]) => string;
+export declare const declarationsOf: (group: number, accessors: readonly Accessor[], ordered?: boolean) => string;

package/dist/interface/gpu/accessors.js

@@ -1,3 +1,4 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
 import { layoutOf } from '../registry/layout.js';
 import { declarationOf } from '../registry/index.js';
 import { labelOf } from '../registry/names.js';
@@ -20,21 +21,24 @@ const reserved = new Set(("alias break case const const_assert continue continui
     + "NULL Self abstract active alignas alignof as asm asm_fragment async attribute auto await become cast catch class co_await co_return co_yield coherent column_major common compile compile_fragment concept const_cast consteval constexpr constinit crate debugger decltype delete demote demote_to_helper do dynamic_cast enum explicit export extends extern external fallthrough filter final finally friend from fxgroup get goto groupshared highp impl implements import inline instanceof interface layout lowp macro macro_rules match mediump meta mod module move mut mutable namespace new nil noexcept noinline nointerpolation non_coherent noncoherent noperspective null nullptr of operator package packoffset partition pass patch pixelfragment precise precision premerge priv protected pub public readonly ref regardless register reinterpret_cast require resource restrict self set shared sizeof smooth snorm static static_assert static_cast std subroutine super target template this thread_local throw trait try type typedef typeid typename typeof union unless unorm unsafe unsized use using varying virtual volatile wgsl where with writeonly yield").split(" "));
 /**
  * Accessors for a render system's shader, in `accessors` order, or the reason one can't be read on the GPU: scalars
- * and tuples of two to four scalars of one type, laid out in 4-byte words.
+ * and tuples of two to four scalars of one type, laid out in 4-byte words. An `ordered` system's accessors take a
+ * row's position in its order, which `ecs_address` resolves to a table's column.
  */
-export const accessorsOf = (shader) => {
+export const accessorsOf = (shader, ordered = false) => {
     const accessors = [];
     const entries = Object.entries(shader.accessors);
     // A table record is a row count, then a word address per accessor.
     if (entries.length > 63)
         return "it names more than 63 accessors";
-    for (const [name, key] of entries) {
+    for (const [column, [name, key]] of entries.entries()) {
         const component = labelOf(key);
         if (!/^[A-Za-z][A-Za-z0-9_]*$/.test(name) || name.startsWith("ecs_") || reserved.has(name))
             return `"${name}" isn't usable as a WGSL function name`;
         const declaration = declarationOf(key);
         if (declaration === undefined)
             return `"${component}" has no registered schema`;
+        if (declaration.shared === true)
+            return `"${component}" is shared, so it has no column: its value is its archetype's`;
         const layout = layoutOf(declaration.type);
         if (layout.kind !== "linear")
             return `"${component}" isn't stored in linear memory`;
@@ -44,27 +48,40 @@ export const accessorsOf = (shader) => {
             return `"${component}" isn't laid out in 4-byte words of f32, i32, u32 or booleans; give it a "storage" or "vertex" layout or 4-byte scalars`;
         }
         const words = stride / 4;
-        const word = (leaf) => `ecs_table.ecs_${name} + row * ${words}u + ${leaf.offset / 4}u`;
+        const word = ordered
+            ? (leaf) => `ecs_base + ${leaf.offset / 4}u`
+            : (leaf) => `ecs_table.ecs_${name} + row * ${words}u + ${leaf.offset / 4}u`;
+        const base = ordered ? `let ecs_base = ecs_address(row, ${column}u, ${words}u); ` : "";
         const [first] = leaves;
         if (leaves.length === 1 && first.path.length === 0) {
-            accessors.push({ name, component: key, code: `fn ${name}(row: u32) -> ${types[0]} { return ${readOf(first, word(first))}; }` });
+            accessors.push({ name, component: key, code: `fn ${name}(row: u32) -> ${types[0]} { ${base}return ${readOf(first, word(first))}; }` });
             continue;
         }
         const tuple = leaves.length >= 2 && leaves.length <= 4 && leaves.every((leaf, i) => leaf.path.length === 1 && leaf.path[0] === i && types[i] === types[0]);
         if (!tuple)
             return `"${component}" isn't a scalar or a tuple of two to four scalars of one type`;
         const items = leaves.map(leaf => readOf(leaf, word(leaf))).join(", ");
-        accessors.push({ name, component: key, code: `fn ${name}(row: u32) -> vec${leaves.length}<${types[0]}> { return vec${leaves.length}<${types[0]}>(${items}); }` });
+        accessors.push({ name, component: key, code: `fn ${name}(row: u32) -> vec${leaves.length}<${types[0]}> { ${base}return vec${leaves.length}<${types[0]}>(${items}); }` });
     }
     return accessors;
 };
 /** The WGSL declarations of a render system's bind group and accessors. */
-export const declarationsOf = (group, accessors) => [
+export const declarationsOf = (group, accessors, ordered = false) => [
     `@group(${group}) @binding(0) var<storage, read> ecs_heap: array<u32>;`,
-    `struct EcsTable { ecs_rows: u32, ${accessors.map(accessor => `ecs_${accessor.name}: u32`).join(", ")} }`,
+    ordered
+        ? "struct EcsTable { ecs_rows: u32, ecs_order: u32, ecs_tables: u32, ecs_shift: u32 }"
+        : `struct EcsTable { ecs_rows: u32, ${accessors.map(accessor => `ecs_${accessor.name}: u32`).join(", ")} }`,
     `@group(${group}) @binding(1) var<uniform> ecs_table: EcsTable;`,
     `fn ecs_count() -> u32 { return ecs_table.ecs_rows; }`,
+    ...ordered ? [orderedAddress(accessors.length)] : [],
     ...accessors.map(accessor => accessor.code),
     "",
 ].join("\n");
+/**
+ * The word address of a column's value at a position of an ordered system's order. The order block holds, by position,
+ * a table's slot above `ecs_shift` bits and its row below them; the tables block holds, by slot, a word address per
+ * accessor.
+ */
+const orderedAddress = (columns) => "fn ecs_address(row: u32, column: u32, words: u32) -> u32 { let ecs_entry = ecs_heap[ecs_table.ecs_order + row]; "
+    + `return ecs_heap[ecs_table.ecs_tables + (ecs_entry >> ecs_table.ecs_shift) * ${columns}u + column] + (ecs_entry & ((1u << ecs_table.ecs_shift) - 1u)) * words; }`;
 //# sourceMappingURL=accessors.js.map

package/dist/interface/gpu/accessors.js.map

@@ -1 +1 @@
-{"version":3,"file":"accessors.js","sourceRoot":"","sources":["../../../src/interface/gpu/accessors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"accessors.js","sourceRoot":"","sources":["../../../src/interface/gpu/accessors.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,QAAQ,EAAa,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAK/C,MAAM,MAAM,GAAG,CAAC,IAAU,EAAiB,EAAE;IACzC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,OAAO,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAChG,CAAC,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,IAAU,EAAE,IAAY,EAAU,EAAE;IAChD,MAAM,OAAO,GAAG,YAAY,IAAI,GAAG,CAAC;IACpC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QAClB,KAAK,SAAS,CAAC,CAAC,OAAO,IAAI,OAAO,SAAS,CAAC;QAC5C,KAAK,KAAK,CAAC,CAAC,OAAO,gBAAgB,OAAO,GAAG,CAAC;QAC9C,KAAK,KAAK,CAAC,CAAC,OAAO,gBAAgB,OAAO,GAAG,CAAC;QAC9C,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC;IAC5B,CAAC;AACL,CAAC,CAAC;AAEF,mEAAmE;AACnE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,gLAAgL;MACpM,ynCAAynC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AAE7oC;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAc,EAAE,OAAO,GAAG,KAAK,EAAgC,EAAE;IACzF,MAAM,SAAS,GAAe,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjD,mEAAmE;IACnE,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,iCAAiC,CAAC;IAClE,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,IAAI,wCAAwC,CAAC;QACpJ,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,WAAW,KAAK,SAAS;YAAE,OAAO,IAAI,SAAS,4BAA4B,CAAC;QAChF,IAAI,WAAW,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,SAAS,gEAAgE,CAAC;QACtH,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,SAAS,iCAAiC,CAAC;QACpF,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACtG,OAAO,IAAI,SAAS,yHAAyH,CAAC;QAClJ,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,OAAO;YAChB,CAAC,CAAC,CAAC,IAAU,EAAU,EAAE,CAAC,cAAc,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG;YAC1D,CAAC,CAAC,CAAC,IAAU,EAAU,EAAE,CAAC,iBAAiB,IAAI,YAAY,KAAK,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC;QAC9F,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,mCAAmC,MAAM,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;QACvB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjD,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,IAAI,iBAAiB,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,UAAU,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACvI,SAAS;QACb,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3J,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,SAAS,gEAAgE,CAAC;QACjG,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtE,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,IAAI,oBAAoB,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,IAAI,aAAa,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC,CAAC;IAC7K,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAE,SAA8B,EAAE,OAAO,GAAG,KAAK,EAAU,EAAE,CAAC;IACtG,UAAU,KAAK,wDAAwD;IACvE,OAAO;QACH,CAAC,CAAC,oFAAoF;QACtF,CAAC,CAAC,oCAAoC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,QAAQ,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;IAC/G,UAAU,KAAK,iDAAiD;IAChE,sDAAsD;IACtD,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;IACpD,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC3C,EAAE;CACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;;GAIG;AACH,MAAM,cAAc,GAAG,CAAC,OAAe,EAAU,EAAE,CAC/C,kHAAkH;MAChH,+EAA+E,OAAO,2EAA2E,CAAC"}

package/dist/interface/gpu/gpu.js.map

@@ -1 +1 @@
-{"version":3,"file":"gpu.js","sourceRoot":"","sources":["../../../src/interface/gpu/gpu.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC"}
+{"version":3,"file":"gpu.js","sourceRoot":"","sources":["../../../src/interface/gpu/gpu.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC"}

package/dist/interface/gpu/index.js

@@ -1,3 +1,4 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
 export { layout } from './layout.js';
 export { wgsl } from './wgsl.js';
 //# sourceMappingURL=index.js.map

package/dist/interface/gpu/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interface/gpu/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interface/gpu/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/interface/gpu/layout.js

@@ -1,3 +1,4 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
 import { recordBytes } from './record.js';
 const layouts = new WeakMap();
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../../src/interface/gpu/layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAiC,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAiB,EAAsB,EAAE;IAC5D,IAAI,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,GAAG,cAAc,CAAC,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC;QAC5F,QAAQ,GAAG,MAAM,CAAC,qBAAqB,CAAC;YACpC,OAAO,EAAE;gBACL,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE;gBACjE,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,EAAE;aAC/G;SACJ,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC,CAAC"}
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../../src/interface/gpu/layout.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAiC,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAiB,EAAsB,EAAE;IAC5D,IAAI,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,GAAG,cAAc,CAAC,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC;QAC5F,QAAQ,GAAG,MAAM,CAAC,qBAAqB,CAAC;YACpC,OAAO,EAAE;gBACL,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE;gBACjE,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,EAAE;aAC/G;SACJ,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC,CAAC"}

package/dist/interface/gpu/record.js

@@ -1,3 +1,4 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
 /**
  * Bytes per parameter or table record, the dynamic offset alignment WebGPU guarantees. A record is `u32` words: a
  * row count, then a word address in the heap per column, then, for kernels, scalars as f32 bits.

package/dist/interface/gpu/record.js.map

@@ -1 +1 @@
-{"version":3,"file":"record.js","sourceRoot":"","sources":["../../../src/interface/gpu/record.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC"}
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../../src/interface/gpu/record.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC"}

package/dist/interface/gpu/wgsl.d.ts

@@ -2,7 +2,8 @@ import type { System } from '../system/system.js';
 /**
  * The WGSL a render system's shaders include: its bind group at `shader.group` (the heap and its table record), and a
  * function per accessor returning that component of a row, such as `fn position(row: u32) -> vec3<f32>`, plus
- * `ecs_count()`. Depends only on registered schemas, so pipelines can be built before any world exists.
+ * `ecs_count()`. For a system with `order`, `row` is an instance's position in its order and `ecs_count()` the number
+ * of instances. Depends only on registered schemas, so pipelines can be built before any world exists.
  * Throws if the system isn't a render system or a component can't be read on the GPU.
  */
 export declare const wgsl: (system: System<unknown>) => string;

package/dist/interface/gpu/wgsl.js

@@ -1,20 +1,24 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
 import { definitionOf } from '../registry/index.js';
 import { accessorsOf, declarationsOf } from './accessors.js';
 /**
  * The WGSL a render system's shaders include: its bind group at `shader.group` (the heap and its table record), and a
  * function per accessor returning that component of a row, such as `fn position(row: u32) -> vec3<f32>`, plus
- * `ecs_count()`. Depends only on registered schemas, so pipelines can be built before any world exists.
+ * `ecs_count()`. For a system with `order`, `row` is an instance's position in its order and `ecs_count()` the number
+ * of instances. Depends only on registered schemas, so pipelines can be built before any world exists.
  * Throws if the system isn't a render system or a component can't be read on the GPU.
  */
 export const wgsl = (system) => {
     const definition = definitionOf(system);
-    const shader = definition?.kind === "render" ? definition.declaration.shader : undefined;
-    if (shader === undefined)
+    const declaration = definition?.kind === "render" ? definition.declaration : undefined;
+    const shader = declaration?.shader;
+    if (declaration === undefined || shader === undefined)
         throw new Error(`System "${system.name}" isn't a render system.`);
     const { name } = system;
-    const accessors = accessorsOf(shader);
+    const ordered = declaration.order !== undefined;
+    const accessors = accessorsOf(shader, ordered);
     if (typeof accessors === "string")
         throw new Error(`Render system "${name}": ${accessors}.`);
-    return declarationsOf(shader.group ?? 0, accessors);
+    return declarationsOf(shader.group ?? 0, accessors, ordered);
 };
 //# sourceMappingURL=wgsl.js.map

package/dist/interface/gpu/wgsl.js.map

@@ -1 +1 @@
-{"version":3,"file":"wgsl.js","sourceRoot":"","sources":["../../../src/interface/gpu/wgsl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,MAAuB,EAAU,EAAE;IACpD,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,UAAU,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,0BAA0B,CAAC,CAAC;IAC5F,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IACxB,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,MAAM,SAAS,GAAG,CAAC,CAAC;IAC7F,OAAO,cAAc,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;AACxD,CAAC,CAAC"}
+{"version":3,"file":"wgsl.js","sourceRoot":"","sources":["../../../src/interface/gpu/wgsl.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,MAAuB,EAAU,EAAE;IACpD,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,UAAU,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACvF,MAAM,MAAM,GAAG,WAAW,EAAE,MAAM,CAAC;IACnC,IAAI,WAAW,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,0BAA0B,CAAC,CAAC;IACzH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IACxB,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,KAAK,SAAS,CAAC;IAChD,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,MAAM,SAAS,GAAG,CAAC,CAAC;IAC7F,OAAO,cAAc,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AACjE,CAAC,CAAC"}

package/dist/interface/index.d.ts

@@ -1,4 +1,3 @@
-export { Archetype } from './archetype/archetype.js';
 export { Component } from './component/component.js';
 export { Entity } from './entity/entity.js';
 export { Finalizer } from './finalizer/finalizer.js';
@@ -6,12 +5,10 @@ export { Gpu } from './gpu/gpu.js';
 export { Index } from './indexes/index-type.js';
 export * from './math/index.js';
 export * from './resources/index.js';
-export { Report } from './report/report.js';
 export { Resource } from './resource/resource.js';
 export { Rule } from './rule/rule.js';
 export type { Schema } from './schema/schema.js';
 export { System } from './system/system.js';
-export { Trait } from './trait/trait.js';
 export type { World } from './world/world.js';
 export type { Components } from './component/types.js';
 export type { Resources } from './resource/types.js';

package/dist/interface/index.js

@@ -1,4 +1,4 @@
-export { Archetype } from './archetype/archetype.js';
+// © 2026 Adobe. MIT License. See /LICENSE for details.
 export { Component } from './component/component.js';
 export { Entity } from './entity/entity.js';
 export { Finalizer } from './finalizer/finalizer.js';
@@ -6,9 +6,7 @@ export { Gpu } from './gpu/gpu.js';
 export { Index } from './indexes/index-type.js';
 export * from './math/index.js';
 export * from './resources/index.js';
-export { Report } from './report/report.js';
 export { Resource } from './resource/resource.js';
 export { Rule } from './rule/rule.js';
 export { System } from './system/system.js';
-export { Trait } from './trait/trait.js';
 //# sourceMappingURL=index.js.map

package/dist/interface/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interface/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interface/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/interface/indexes/create.d.ts

@@ -1,30 +1,39 @@
 import type { Component } from '../component/component.js';
+import type { Shared } from '../component/value.js';
 import type { Listed, Property } from '../system/property.js';
 import type { Declaration } from './declaration.js';
 import type { Index } from './index-type.js';
-/** `not` excludes what the index holds by: its key parts and `has`. An index without a key isn't unique. */
+/**
+ * `not` excludes what the index holds by: its key parts and `with`. An index without a key isn't unique. A key part is
+ * a value each entity holds, never a shared component's, which systems filter by with `where`.
+ */
 type Validate<D extends Declaration> = {
     readonly components?: {
-        readonly not?: readonly Exclude<Component.Key, D["key"][number] | Listed<Property<D, "components">, "has">>[];
+        readonly not?: readonly Exclude<Component.Key, D["key"][number] | Listed<Property<D, "components">, "with">>[];
+        readonly has?: never;
     };
 } & (D["key"] extends readonly [] ? {
     readonly unique?: false;
-} : unknown);
+} : unknown) & ([D["key"][number] & Shared] extends [never] ? unknown : {
+    readonly key: {
+        readonly "error: a key part is a value each entity holds; filter by a shared component with where": D["key"][number] & Shared;
+    };
+});
 /**
  * Declares an index over components' values and returns it; nothing is built until a world's system or finalizer uses
- * it. It holds the entities with every key part and every component in `has`, and none in `not`, keyed by the values
+ * it. It holds the entities with every key part and every component in `with`, and none in `not`, keyed by the values
  * of `key`, compared part by part: numbers and tuples by value, an entity with its generation, so a stale one finds
- * nothing. With an empty key it holds those entities, every entity but the resource entity when `has` and `not` are
+ * nothing. With an empty key it holds those entities, every entity but the resource entity when `with` and `not` are
  * empty too, and its lookup takes no key and gives them all, in entity order.
  * - `sorted`: keeps key order, numbers numerically, NaN last, booleans false first, strings by code point, tuples
  *   element by element, then entity order, so a lookup takes a prefix of the key whose last part may be a comparison.
  * - `unique`: at most one entity per key: a lookup by a whole key returns its row or null. When two entities share a
- *   key, the one with the lower entity index is kept, and the run that found them reports an `"index"` failure.
+ *   key, the one with the lower entity index is kept, and the index fails the run or tick that found them.
  *
- * Throws if a key part isn't a registered component of data, is listed twice or is a set or map, a sorted part has no
+ * Throws if a key part isn't a registered component of data, is listed twice, is a set or map or shared, a sorted part has no
  * order, its object parts live on different threads, or on another than the world's beside a string, which the world
- * keeps its keys of, it's unique without a key, or `has` or `not` names a key that isn't a registered component
- * or `not` names a key part or a `has` component.
+ * keeps its keys of, it's unique without a key, or `with` or `not` names a key that isn't a registered component
+ * or `not` names a key part or a `with` component.
  */
 export declare const create: <const D extends Declaration>(declaration: D & Validate<D>) => Index<D>;
 export {};