@adobe/ecs 0.1.0 → 0.2.1

package/dist/interface/registry/declarations.js

@@ -1,8 +1,9 @@
+import { declarationsName } from './ids.js';
 import { layoutOf } from './layout.js';
-import { claimKey, declarationOf, failRegistration, firstKeyOf, kindOf, labelOf, requireKey, sameDeclaration } from './names.js';
+import { claimKey, declarationOf, failRegistration, firstKeyOf, installCatchUp, kindOf, labelOf, recordFailure, requireKey, sameDeclaration } from './names.js';
 import { isReduction } from './reduction.js';
-import { allowsNull, hasBoolean, isEntity, isString, isStruct } from './schemas.js';
-import { isTrait } from './traits.js';
+import { allowsNull, hasBoolean, isComparable, isEntity, isString, isStruct, matchesSchema } from './schemas.js';
+import { addTrait, isTrait } from './traits.js';
 /** The value schema of any registered component or resource, or undefined for a value that isn't data. */
 export const schemaOf = (key) => declarationOf(key)?.type;
 /** Global constructors of Transferable values, where the platform has them. */
@@ -22,19 +23,50 @@ const isInstance = (value, name) => {
 export const threadOfDeclaration = (declaration) => {
     if (declaration.type !== undefined && (isStruct(declaration.type) || isString(declaration.type)))
         return null;
+    // A shared component's value is its archetype's, which every thread reads.
+    if (declaration.shared === true)
+        return null;
     return typeof declaration.thread === "string" ? declaration.thread : "world";
 };
+/** Whether a schema, or any schema inside it, holds a `default`. */
+const holdsDefault = (schema) => {
+    if ("default" in schema)
+        return true;
+    if ("anyOf" in schema)
+        return schema.anyOf.some(holdsDefault);
+    if ("allOf" in schema)
+        return schema.allOf.some(holdsDefault);
+    if ("const" in schema)
+        return false;
+    switch (schema.type) {
+        case "object": return Object.values(schema.properties).some(holdsDefault);
+        case "array":
+        case "set": return holdsDefault(schema.items);
+        case "map": return holdsDefault(schema.keys) || holdsDefault(schema.values);
+        default: return false;
+    }
+};
 /** Throws for a declaration whose traits can't hold, so far as values tell: types check the rest. */
 const check = (kind, key, declaration) => {
     const fail = (message) => failRegistration(kind, key, message);
     for (const trait of Reflect.ownKeys(declaration)) {
-        if (trait !== "default" && !isTrait(trait))
+        if (trait !== "default" && trait !== "fresh" && !isTrait(trait))
             fail(`${labelOf(trait)} isn't a registered trait.`);
     }
-    const { type } = declaration;
-    if (type !== undefined && "default" in declaration && (kind === "component" || "default" in type)) {
-        fail(kind === "component" ? "its schema holds its default." : "its default is given twice, by its schema and its declaration.");
+    const { type, fresh } = declaration;
+    if (type !== undefined && holdsDefault(type))
+        fail("its schema holds a default, which a schema never does: its start is its declaration's default.");
+    if (fresh !== undefined) {
+        if (fresh !== "Map" && fresh !== "Set")
+            fail(`fresh is "Map" or "Set".`);
+        if ("default" in declaration)
+            fail("it starts fresh, so it has no default.");
+        if (type !== undefined && "type" in type && (type.type === "set" || type.type === "map") && (type.type === "set") !== (fresh === "Set"))
+            fail(`a ${type.type} starts as a fresh ${type.type === "set" ? "Set" : "Map"}.`);
     }
+    // A start however the build found it, a literal, its type's namespace's or an identity, is one of its type's values.
+    if (type !== undefined && "default" in declaration && !matchesSchema(type, declaration.default))
+        fail(`its default, ${labelOf(declaration.default)}, isn't one of its type's values.`);
     try {
         layoutOf(type);
     }
@@ -55,8 +87,12 @@ const check = (kind, key, declaration) => {
     }
     if (declaration.derived !== undefined && kind !== "component")
         fail("only a component is derived.");
-    if (declaration.derived === true && type !== undefined && !("default" in type || "const" in type || allowsNull(type))) {
-        fail("a derived component's type has a default, which it starts at.");
+    if (declaration.derived === true && declaration.within !== undefined)
+        fail("a derived component's rule covers within.");
+    if (declaration.derived === true && declaration.reference !== undefined)
+        fail("a rule can't set a derived component's target, so it's no reference.");
+    if (declaration.derived === true && type !== undefined && fresh === undefined && !("default" in declaration || "const" in type || allowsNull(type))) {
+        fail("a derived component has a default, which it starts at.");
     }
     if (declaration.reduce !== undefined) {
         const operator = declaration.reduce;
@@ -80,6 +116,21 @@ const check = (kind, key, declaration) => {
     }
     if (isInstance(declaration.default, "Node") && thread !== "main")
         fail(`a DOM Node lives on "main".`);
+    const { shared } = declaration;
+    if (shared !== undefined) {
+        if (shared !== true)
+            fail("shared is true.");
+        if (kind !== "component")
+            fail("only a component is shared.");
+        if (type === undefined || !isComparable(type))
+            fail("a shared component's value is comparable data: numbers, booleans, strings, and arrays and objects of those.");
+        if (thread !== undefined)
+            fail("a shared value lives in shared memory, so it has no thread.");
+        if (declaration.derived !== undefined)
+            fail("a derived component isn't shared: its rule adds it with its default.");
+        if (declaration.reference !== undefined)
+            fail("a reference isn't shared: its target despawning acts on each holder.");
+    }
     const { transfer } = declaration;
     if (transfer !== undefined) {
         if (transfer !== true)
@@ -95,7 +146,7 @@ const check = (kind, key, declaration) => {
  * Registers a declaration of `kind` under `key`, fixed from then on. The same declaration again is accepted, and so is
  * a new symbol with the id of a key of this kind, as a module evaluated again makes it.
  */
-export const createRegistry = (kind) => (key, declaration) => {
+const createRegistry = (kind) => (key, declaration) => {
     const symbol = requireKey(kind, key);
     const existing = kindOf(symbol);
     if (existing === kind && sameDeclaration(declarationOf(symbol), declaration))
@@ -104,4 +155,63 @@ export const createRegistry = (kind) => (key, declaration) => {
         check(kind, symbol, declaration);
     claimKey(symbol, kind, declaration);
 };
+/** Registers a component: the package's own, and tests' keys made at runtime; the build declares every other. */
+export const registerComponent = createRegistry("component");
+/** Registers a resource: the package's own, and tests' keys made at runtime; the build declares every other. */
+export const registerResource = createRegistry("resource");
+/** The global map of what the build declared, made here when no generated code made it first. */
+const declared = (() => {
+    const name = Symbol.for(declarationsName);
+    const found = Reflect.get(globalThis, name);
+    if (found instanceof Map)
+        return found;
+    const made = new Map();
+    Reflect.set(globalThis, name, made);
+    return made;
+})();
+/** Whether a value the generated code recorded is a declaration: an object of traits, as the build wrote it. */
+const isDeclaration = (value) => typeof value === "object" && value !== null;
+/** Registers one key the build declared, as its kind says. */
+const registerDeclared = (key, entry) => {
+    const kind = typeof entry === "object" && entry !== null ? Reflect.get(entry, "kind") : undefined;
+    const declaration = typeof entry === "object" && entry !== null ? Reflect.get(entry, "declaration") : undefined;
+    if (kind === "trait")
+        addTrait(key);
+    else if (kind === "component" && isDeclaration(declaration))
+        registerComponent(key, declaration);
+    else if (kind === "resource" && isDeclaration(declaration))
+        registerResource(key, declaration);
+};
+/** How many of the map's entries this copy registered. */
+let seen = 0;
+let catching = false;
+/**
+ * Registers what the build declared since this last ran, in the order modules evaluated, as each module registered
+ * its keys when it was evaluated. A declaration that fails is recorded for its own key, whose every use fails giving
+ * it as the reason, and never for a read of another key. Reads of keys while it runs see those registered so far.
+ */
+const catchUp = () => {
+    if (catching || declared.size === seen)
+        return;
+    catching = true;
+    try {
+        let index = 0;
+        for (const [key, entry] of declared) {
+            if (index++ < seen)
+                continue;
+            seen++;
+            try {
+                registerDeclared(key, entry);
+            }
+            catch (error) {
+                if (typeof key === "symbol")
+                    recordFailure(key, error instanceof Error ? error.message : String(error));
+            }
+        }
+    }
+    finally {
+        catching = false;
+    }
+};
+installCatchUp(catchUp);
 //# sourceMappingURL=declarations.js.map

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

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

package/dist/interface/registry/finalizer-order.js

@@ -1,4 +1,4 @@
-import { firstItemOf, labelOfItem } from './items.js';
+import { firstItemOf } from './items.js';
 import { firstKeyOf, labelOf } from './names.js';
 /**
  * Finalizers in run order: `before` and `after` first, then registration order. Throws for a cycle, and for two that
@@ -35,7 +35,7 @@ export const orderFinalizers = (runners) => {
                 ready.push(other);
     }
     if (order.length < runners.length) {
-        const cycle = runners.filter((_, index) => !order.includes(index)).map(runner => `"${labelOfItem(runner)}"`).join(", ");
+        const cycle = runners.filter((_, index) => !order.includes(index)).map(runner => `"${runner.name}"`).join(", ");
         throw new Error(`Finalizers ${cycle} are ordered in a cycle.`);
     }
     const reaches = (from, to) => {
@@ -58,7 +58,7 @@ export const orderFinalizers = (runners) => {
         for (let b = a + 1; b < runners.length; b++) {
             const conflict = [...writes[a]].find(key => writes[b].has(key) || reads[b].has(key)) ?? [...writes[b]].find(key => reads[a].has(key));
             if (conflict !== undefined && !reaches(a, b) && !reaches(b, a)) {
-                throw new Error(`Finalizers "${labelOfItem(runners[a])}" and "${labelOfItem(runners[b])}" both access "${labelOf(conflict)}", one writing it; order them with before or after.`);
+                throw new Error(`Finalizers "${runners[a].name}" and "${runners[b].name}" both access "${labelOf(conflict)}", one writing it; order them with before or after.`);
             }
         }
     return order.map(index => runners[index]);

package/dist/interface/registry/finalizer-order.js.map

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

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

@@ -3,6 +3,12 @@
  * system's, rule's or finalizer's declaration to id. Its version changes with the map's format.
  */
 export declare const idsName = "@adobe/ecs/ids@1";
+/**
+ * The `Symbol.for` name of the global `Map` code the plugin generates fills, from each key a module declares to its
+ * kind and declaration, `{ kind, declaration }`, in the order modules evaluate. Every copy of the package reads it and
+ * none changes it. Its version changes with the format.
+ */
+export declare const declarationsName = "@adobe/ecs/declarations@1";
 /** The id the plugin gave a key, its module path and binding (`src/keys.ts#position`), if it gave one. */
 export declare const idOfKey: (key: symbol) => string | undefined;
 /**
@@ -10,3 +16,20 @@ export declare const idOfKey: (key: symbol) => string | undefined;
  * it gave one, taken out of the map so the object declares nothing else under it.
  */
 export declare const takeIdOfDeclaration: (declaration: object) => string | undefined;
+/**
+ * The `Symbol.for` name of the global `WeakMap` from a declaration to the label the plugin gave a constructor call that
+ * isn't a top-level binding's, by the binding or function it's in, or an internal factory gave its declaration. Weak,
+ * so a declaration whose constructor threw before taking its label isn't kept.
+ */
+export declare const labelsName = "@adobe/ecs/labels@1";
+/** The label given the declaration a constructor call passes, if any, taken out of the map. */
+export declare const takeLabelOfDeclaration: (declaration: object) => string | undefined;
+/**
+ * The `Symbol.for` name of the global `WeakMap` from a declaration, or the body of a system declaring nothing, to what
+ * the build inferred its body uses (`Access` in `system/resolve.ts`), which the plugin fills where it calls a
+ * constructor; an internal factory making declarations at runtime gives its own first, which the plugin's doesn't
+ * replace. Its version changes with the format.
+ */
+export declare const accessName = "@adobe/ecs/access@1";
+/** What the build inferred the body a declaration or body is made with uses, if it inferred it, taken out of the map. */
+export declare const takeAccessOf: (declaration: object) => unknown;

package/dist/interface/registry/ids.js

@@ -1,9 +1,16 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
 /**
  * The `Symbol.for` name of the global `Map` that code the plugin generates fills: from key to id, and from a
  * system's, rule's or finalizer's declaration to id. Its version changes with the map's format.
  */
 export const idsName = "@adobe/ecs/ids@1";
 const ids = Symbol.for(idsName);
+/**
+ * The `Symbol.for` name of the global `Map` code the plugin generates fills, from each key a module declares to its
+ * kind and declaration, `{ kind, declaration }`, in the order modules evaluate. Every copy of the package reads it and
+ * none changes it. Its version changes with the format.
+ */
+export const declarationsName = "@adobe/ecs/declarations@1";
 const idsMap = () => {
     const map = Reflect.get(globalThis, ids);
     return map instanceof Map ? map : undefined;
@@ -25,4 +32,39 @@ export const takeIdOfDeclaration = (declaration) => {
     map?.delete(declaration);
     return typeof id === "string" ? id : undefined;
 };
+/**
+ * The `Symbol.for` name of the global `WeakMap` from a declaration to the label the plugin gave a constructor call that
+ * isn't a top-level binding's, by the binding or function it's in, or an internal factory gave its declaration. Weak,
+ * so a declaration whose constructor threw before taking its label isn't kept.
+ */
+export const labelsName = "@adobe/ecs/labels@1";
+const labels = Symbol.for(labelsName);
+/** The label given the declaration a constructor call passes, if any, taken out of the map. */
+export const takeLabelOfDeclaration = (declaration) => {
+    const map = Reflect.get(globalThis, labels);
+    if (!(map instanceof WeakMap || map instanceof Map))
+        return undefined;
+    const label = map.get(declaration);
+    if (label === undefined)
+        return undefined;
+    map.delete(declaration);
+    return typeof label === "string" ? label : undefined;
+};
+/**
+ * The `Symbol.for` name of the global `WeakMap` from a declaration, or the body of a system declaring nothing, to what
+ * the build inferred its body uses (`Access` in `system/resolve.ts`), which the plugin fills where it calls a
+ * constructor; an internal factory making declarations at runtime gives its own first, which the plugin's doesn't
+ * replace. Its version changes with the format.
+ */
+export const accessName = "@adobe/ecs/access@1";
+const access = Symbol.for(accessName);
+/** What the build inferred the body a declaration or body is made with uses, if it inferred it, taken out of the map. */
+export const takeAccessOf = (declaration) => {
+    const map = Reflect.get(globalThis, access);
+    if (!(map instanceof WeakMap))
+        return undefined;
+    const found = map.get(declaration);
+    map.delete(declaration);
+    return found;
+};
 //# sourceMappingURL=ids.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../src/interface/registry/ids.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,kBAAkB,CAAC;AAE1C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAEhC,MAAM,MAAM,GAAG,GAAsC,EAAE;IACnD,MAAM,GAAG,GAAY,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC,CAAC;AAEF,0GAA0G;AAC1G,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAsB,EAAE;IACvD,MAAM,EAAE,GAAY,MAAM,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,WAAmB,EAAsB,EAAE;IAC3E,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,GAAY,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IAC1C,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACvC,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACzB,OAAO,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC,CAAC"}
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../src/interface/registry/ids.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,kBAAkB,CAAC;AAE1C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAEhC;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,2BAA2B,CAAC;AAE5D,MAAM,MAAM,GAAG,GAAsC,EAAE;IACnD,MAAM,GAAG,GAAY,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC,CAAC;AAEF,0GAA0G;AAC1G,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAsB,EAAE;IACvD,MAAM,EAAE,GAAY,MAAM,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,WAAmB,EAAsB,EAAE;IAC3E,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,GAAY,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IAC1C,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACvC,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACzB,OAAO,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,qBAAqB,CAAC;AAEhD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAEtC,+FAA+F;AAC/F,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,WAAmB,EAAsB,EAAE;IAC9E,MAAM,GAAG,GAAY,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,CAAC,GAAG,YAAY,OAAO,IAAI,GAAG,YAAY,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACtE,MAAM,KAAK,GAAY,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC5C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACxB,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,qBAAqB,CAAC;AAEhD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAEtC,yHAAyH;AACzH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,WAAmB,EAAW,EAAE;IACzD,MAAM,GAAG,GAAY,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,CAAC,GAAG,YAAY,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,KAAK,GAAY,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC5C,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC"}

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

@@ -2,7 +2,7 @@
 export type { AnyDeclaration } from './declarations.js';
 export { schemaOf, threadOfDeclaration } from './declarations.js';
 export type { Kind } from './names.js';
-export { declarationOf, firstKeyOf, keyOfId, kindOf, labelOf, newestKeyOf } from './names.js';
+export { declarationOf, firstKeyOf, keyOfId, kindOf, labelOf, newestKeyOf, whyUnregistered } from './names.js';
 export type { Item } from './program.js';
 export { definitionOf, programFinalizers, programRules, programVersion, requireDefinition } from './program.js';
 export type { Schedule } from './schedule.js';
@@ -15,7 +15,7 @@ export { isTrait } from './traits.js';
 export { idOfKey } from './ids.js';
 export { isWorldWritten } from './written.js';
 export { sameDeclaration } from './names.js';
-export { firstItemOf, identifiedItems, idOfItem, itemOfId, labelOfItem, sameItem } from './items.js';
+export { firstItemOf, identifiedItems, idOfItem, idOrNull, itemOfId, sameItem } from './items.js';
 export { allowsNull, conditional, isStruct } from './schemas.js';
 export { isReduction, reductionOperators } from './reduction.js';
 export type { Definition } from '../system/definition.js';
@@ -23,7 +23,7 @@ export type { Leaf } from '../system/leaf.js';
 export type { Composite } from '../system/composite.js';
 export type { Rule } from '../rule/created.js';
 export type { Finalizer } from '../finalizer/created.js';
-export { archetypeIndexOf } from './archetypes.js';
+export { archetypeIndexKey, internArchetype, type Interned } from './archetypes.js';
 export { indexDefinitionOf, indexOfLookup, lookupKeysOf, orderKeysOf, watchedBy, watchesEntries } from './indexes.js';
 export type { Created as IndexDefinition } from '../indexes/created.js';
 export type { Declaration as IndexDeclaration } from '../indexes/declaration.js';

package/dist/interface/registry/index.js

@@ -1,5 +1,5 @@
 export { schemaOf, threadOfDeclaration } from './declarations.js';
-export { declarationOf, firstKeyOf, keyOfId, kindOf, labelOf, newestKeyOf } from './names.js';
+export { declarationOf, firstKeyOf, keyOfId, kindOf, labelOf, newestKeyOf, whyUnregistered } from './names.js';
 export { definitionOf, programFinalizers, programRules, programVersion, requireDefinition } from './program.js';
 export { accessOf, isLeaf, isObserver, reducedBy, scheduleOf } from './schedule.js';
 export { strataOf } from './strata.js';
@@ -8,9 +8,9 @@ export { isTrait } from './traits.js';
 export { idOfKey } from './ids.js';
 export { isWorldWritten } from './written.js';
 export { sameDeclaration } from './names.js';
-export { firstItemOf, identifiedItems, idOfItem, itemOfId, labelOfItem, sameItem } from './items.js';
+export { firstItemOf, identifiedItems, idOfItem, idOrNull, itemOfId, sameItem } from './items.js';
 export { allowsNull, conditional, isStruct } from './schemas.js';
 export { isReduction, reductionOperators } from './reduction.js';
-export { archetypeIndexOf } from './archetypes.js';
+export { archetypeIndexKey, internArchetype } from './archetypes.js';
 export { indexDefinitionOf, indexOfLookup, lookupKeysOf, orderKeysOf, watchedBy, watchesEntries } from './indexes.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interface/registry/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9F,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEhH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEpF,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrG,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interface/registry/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE/G,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEhH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEpF,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAClG,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMjE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAiB,MAAM,iBAAiB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/interface/registry/indexes.js

@@ -1,4 +1,4 @@
-import { labelOfItem, recordItem, registeredAs } from './items.js';
+import { recordItem, registeredAs } from './items.js';
 import { firstKeyOf, labelOf, sameDeclaration } from './names.js';
 /**
  * Records an index under the id the plugin gave its declaration and returns it; declared again under that id the same,
@@ -52,7 +52,7 @@ export const checkLookup = (what, name, lookupName, lookup) => {
     const check = (verb, keys) => {
         for (const key of keys ?? []) {
             if (!held.has(firstKeyOf(key)))
-                throw new Error(`${what} "${name}": lookup "${lookupName}" ${verb} "${labelOf(key)}", which not every entity index "${labelOfItem(index)}" holds has; name its key parts or its has.`);
+                throw new Error(`${what} "${name}": lookup "${lookupName}" ${verb} "${labelOf(key)}", which not every entity index "${index.name}" holds has; name its key parts or its has.`);
         }
     };
     check("reads", lookup.read);

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

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

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

@@ -8,14 +8,6 @@ type Registered = {
 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;
-/**
- * How errors and reports name a system, rule or finalizer: its name while no other registered item has it, else its
- * name with its id when the plugin gave one, and without one its name numbered by registration order. An item not
- * registered is named by its name.
- */
-export declare const labelOfItem: (item: {
-    readonly name: string;
-}) => string;
 /**
  * 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
@@ -27,10 +19,13 @@ export declare const registeredAs: <T extends Registered>(item: T, id: string |
  */
 export declare const recordItem: (item: Registered, id: string | undefined, existing: object | undefined) => void;
 /**
- * An item's name: the one its declaration gives; without one, its binding with the id the plugin gave it
- * (`spawn (src/setup.ts#spawn)`), and without an id, its kind numbered by creation (`system #3`).
+ * 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: (name: string | undefined, id: string | undefined, kind: "system" | "rule" | "finalizer" | "index") => string;
+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. */

package/dist/interface/registry/items.js

@@ -1,11 +1,9 @@
+// © 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();
-/** Numbered labels given, so each item's is unique. */
-const labels = new Set();
-/** How many registered items have each name. */
-const named = 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)
@@ -15,17 +13,6 @@ export const sameItem = (a, 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;
-/**
- * How errors and reports name a system, rule or finalizer: its name while no other registered item has it, else its
- * name with its id when the plugin gave one, and without one its name numbered by registration order. An item not
- * registered is named by its name.
- */
-export const labelOfItem = (item) => {
-    const entry = entries.get(item);
-    if (entry === undefined || (named.get(entry.name) ?? 0) <= 1)
-        return item.name;
-    return entry.id === undefined ? entry.numbered : `${entry.name} (${entry.id})`;
-};
 /**
  * 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
@@ -44,23 +31,6 @@ export const registeredAs = (item, id, same) => {
     }
     return entry.first;
 };
-/** A label for an item registered now without an id, its name numbered when another item's has it. */
-const numberedFor = (name) => {
-    let label = name;
-    for (let n = 2; labels.has(label); n++)
-        label = `${name}#${n}`;
-    labels.add(label);
-    return label;
-};
-/** An item without an id is forgotten once collected: its name's count and numbered label go with it. */
-const forgotten = new FinalizationRegistry(({ name, numbered }) => {
-    labels.delete(numbered);
-    const count = (named.get(name) ?? 0) - 1;
-    if (count > 0)
-        named.set(name, count);
-    else
-        named.delete(name);
-});
 /**
  * Records an item under its id: a value of an item `registeredAs` found shares its entry, and any other is a new item.
  */
@@ -70,29 +40,30 @@ export const recordItem = (item, id, existing) => {
         entries.set(item, shared);
         return;
     }
-    const entry = { kind: item.kind, declaration: item.declaration, name: item.name, id, numbered: numberedFor(item.name), first: item };
-    named.set(item.name, (named.get(item.name) ?? 0) + 1);
+    const entry = { kind: item.kind, declaration: item.declaration, id, first: item };
     if (id !== undefined)
         identified.set(id, entry);
-    else
-        forgotten.register(item, { name: item.name, numbered: entry.numbered });
     entries.set(item, entry);
 };
-/** How many items of each kind were declared without a name or an id, to number their labels. */
+/** How many items of each kind were labeled by number, to number the next. */
 const anonymous = new Map();
 /**
- * An item's name: the one its declaration gives; without one, its binding with the id the plugin gave it
- * (`spawn (src/setup.ts#spawn)`), and without an id, its kind numbered by creation (`system #3`).
+ * 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 = (name, id, kind) => {
-    if (name !== undefined)
-        return name;
+export const nameOf = (value, id, kind) => {
+    const label = takeLabelOfDeclaration(value);
+    if (label !== undefined)
+        return label;
     if (id !== undefined)
-        return `${id.slice(id.lastIndexOf("#") + 1)} (${id})`;
+        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. */

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

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

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

@@ -25,7 +25,8 @@ export type Leaf = {
 };
 /**
  * How a component's values are stored.
- * - `constant`: a `const` schema; no storage, every value is `value`.
+ * - `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.
@@ -34,6 +35,7 @@ export type Leaf = {
 export type Layout = {
     readonly kind: "constant";
     readonly value: unknown;
+    readonly shared?: true;
 } | {
     readonly kind: "linear";
     readonly leaves: readonly Leaf[];