@adobe/ecs 0.2.3 → 0.3.0

package/dist/interface/system/commands.d.ts

@@ -2,6 +2,7 @@ import type { Component } from '../component/component.js';
 import type { Entity } from '../entity/entity.js';
 import type { Essential, Shared } from '../component/value.js';
 import type { Table } from '../world/table/table.js';
+import type { SharedOnly } from './shared-only.js';
 import type { ValuesOf } from './values-of.js';
 /** The value an `add` of one component takes: none for a tag. */
 type ValueArgument<K extends Essential> = Component<K> extends true ? [value?: true] : [value: Component<K>];
@@ -65,6 +66,20 @@ export type Commands = {
      */
     spawn<const C extends readonly Essential[], const P extends Preset<C> = {}>(components: Spawned<C, P>, ...constant: RequiresPreset<C> extends true ? [constant?: P & SharedPreset<C> & Named<C, P>] : [constant?: P & Named<C, P>]): (...values: SpawnValues<C, P>) => Entity;
     despawn(entity: Entity): void;
+    /**
+     * Despawns, as a `despawn` of each would, every entity alive before its sync point that has each component of
+     * `with` and none of `not` once the commands issued before it apply, as a row system over the same query despawning
+     * each of its rows would; never one the sync point spawns, whenever spawned. Derived components may be named. `where` keeps it to the archetypes holding these values of shared components,
+     * each one required as `with` requires it, as a system's `where` of values does. Never the resource entity. Only on
+     * the world's thread: a joined thread's throws.
+     */
+    despawnWhere<const W extends object = {}>(query: {
+        readonly with: readonly [Component.Key, ...Component.Key[]];
+        readonly not?: readonly Component.Key[];
+        readonly where?: W & SharedOnly<NoInfer<W>> & {
+            readonly [K in Shared]?: Component<K>;
+        };
+    }): void;
     /** Adds or replaces one component's value, marking it changed. */
     add<K extends Essential>(entity: Entity, component: K, ...value: ValueArgument<K>): void;
     /** Adds or replaces the values of `components`, marking them changed. */
@@ -79,12 +94,23 @@ export type Commands = {
      * outside them isn't spawned, nor anything it owns, through owner references, as despawning its owner would; a
      * weak reference to one is left out of its row, which is spawned without it; any other value naming one is
      * `Entity.none`. Returns, at once, each table's new entities, alive at the sync point. A column's stride must be its
-     * component's in this world, and its length its table's count. `resources` sets each resource it names, by key, at
-     * the sync point, as commands apply, each value checked against its resource's schema; not one only the world
-     * writes, nor one living on another thread. On the world's thread only.
+     * component's in this world, and its length its table's count. On the world's thread only.
+     * - `existing` maps entities to ones already alive in this world, which stand for them: a row whose entity it maps
+     *   isn't spawned, its entry in the result is the entity it maps to, and every value naming one it maps names that
+     *   entity, whether or not it's in the tables. Fails for one that isn't alive.
+     * - `update` writes each row `existing` maps onto the entity standing for it, as `commands.add` of its table's
+     *   components would: adding those the entity lacks, replacing and marking changed those it has, and leaving its
+     *   other components as they are. Its entity values are rewritten as a spawned row's are, but a reference naming an
+     *   entity that isn't there, weak or owner, is left out, so the entity's own stands.
+     * - `resources` sets each resource it names, by key, at the sync point, as commands apply, each value checked
+     *   against its resource's schema; not one only the world writes, nor one living on another thread.
      */
-    spawnTables(tables: readonly Table[], resources?: {
-        readonly [key: symbol]: unknown;
+    spawnTables(tables: readonly Table[], options?: {
+        readonly resources?: {
+            readonly [key: symbol]: unknown;
+        };
+        readonly existing?: ReadonlyMap<Entity, Entity>;
+        readonly update?: boolean;
     }): Table.Spawned;
 };
 export {};

package/dist/interface/system/create-resolved.js

@@ -2,6 +2,7 @@
 import { nameOf } from '../registry/items.js';
 import { claimSystem } from '../registry/program.js';
 import { checkLeaf, inputSchemaOf } from './check.js';
+import { noCommands } from './resolve.js';
 /**
  * Makes a system of a declaration as the world takes it, with what its body reads and writes already listed: for the
  * implementation's own systems, such as those standing for a joined thread's, whose bodies no build reads. Checks it
@@ -10,7 +11,7 @@ import { checkLeaf, inputSchemaOf } from './check.js';
 export const createResolved = (declaration, body, input) => {
     const name = nameOf(declaration, undefined, "system");
     const schema = inputSchemaOf(name, body, declaration.components === undefined ? 1 : 2, input);
-    const system = { kind: "system", name, declaration, input: schema, body };
+    const system = { kind: "system", name, declaration, input: schema, body, commands: noCommands };
     checkLeaf(system);
     claimSystem(system, undefined);
     return system;

package/dist/interface/system/create-resolved.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-resolved.js","sourceRoot":"","sources":["../../../src/interface/system/create-resolved.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKtD;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,WAAqB,EAAE,IAAkB,EAAE,KAAe,EAAmB,EAAE;IAC1G,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9F,MAAM,MAAM,GAA2B,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAClG,SAAS,CAAC,MAAM,CAAC,CAAC;IAClB,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC"}
+{"version":3,"file":"create-resolved.js","sourceRoot":"","sources":["../../../src/interface/system/create-resolved.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,WAAqB,EAAE,IAAkB,EAAE,KAAe,EAAmB,EAAE;IAC1G,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9F,MAAM,MAAM,GAA2B,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IACxH,SAAS,CAAC,MAAM,CAAC,CAAC;IAClB,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC"}

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

@@ -9,7 +9,7 @@ import type { Listed, Property } from './property.js';
 import type { System } from './system.js';
 import type { OneThread, ThreadedBy, ThreadsOf } from './threads.js';
 import type { HeldBy } from './values.js';
-import type { Shared } from '../component/value.js';
+import type { SharedOnly } from './shared-only.js';
 type Lookups<D> = Property<D, "lookup">;
 /** A lookup's `changed` names what it requires: a lookup by entity's `with`, an index lookup's what its index holds. */
 type LookupChanges<D> = {
@@ -86,11 +86,7 @@ type Where<D> = D extends {
     };
 } ? {
     readonly components?: {
-        readonly where?: {
-            readonly [K in Exclude<keyof W, Shared>]: {
-                readonly "error: where names only shared components, which each archetype holds one value of": K;
-            };
-        };
+        readonly where?: SharedOnly<W>;
     };
 } & (D extends {
     readonly up: object;
@@ -139,6 +135,14 @@ type Validate<D extends Declaration> = LookupChanges<D> & Where<D> & Conditions<
 } : {}) & (D extends {
     readonly readonly: true;
 } ? Readonly : {}) & (D extends {
+    readonly tables: {
+        readonly where: infer W;
+    };
+} ? {
+    readonly tables?: {
+        readonly where?: SharedOnly<W>;
+    };
+} : {}) & (D extends {
     readonly tables: object;
 } ? (D extends {
     readonly readonly: true;

package/dist/interface/system/create.js

@@ -2,7 +2,7 @@ import { takeIdOfDeclaration } from '../registry/ids.js';
 import { nameOf } from '../registry/items.js';
 import { claimSystem } from '../registry/program.js';
 import { checkComposite, checkLeaf, inputSchemaOf } from './check.js';
-import { accessOf, compact, componentLists, lookupsLists, resourceUses, upReads, whereReadsOf } from './resolve.js';
+import { accessOf, commandListsOf, compact, componentLists, lookupsLists, resourceUses, upReads, whereReadsOf } from './resolve.js';
 // The plugin passes the schema of the body's input as a third argument.
 export function create(first, second, input) {
     // The plugin gives its id to the call's first argument: the declaration, the members, or the body made into a
@@ -17,9 +17,10 @@ export function create(first, second, input) {
     if (body === undefined)
         throw new Error("A system needs a body, and a composite its systems.");
     const name = nameOf(first, id, "system");
-    const declaration = resolve(`System "${name}"`, declared, accessOf(`System "${name}"`, first));
+    const access = accessOf(`System "${name}"`, first);
+    const declaration = resolve(`System "${name}"`, declared, access);
     const schema = inputSchemaOf(name, body, declaration.components === undefined ? 1 : 2, input);
-    const system = { kind: "system", name, declaration, input: schema, body };
+    const system = { kind: "system", name, declaration, input: schema, body, commands: commandListsOf(`System "${name}"`, access) };
     checkLeaf(system);
     claimSystem(system, id);
     return system;
@@ -37,7 +38,7 @@ const resolve = (what, declared, access) => {
             uses.read.push(key);
     const resolved = {
         ...rest,
-        ...components === undefined ? {} : { components: componentLists(components, access.components, reading, whereReads) },
+        ...components === undefined ? {} : { components: componentLists(components, components.whole === true ? null : access.components, reading, whereReads) },
         ...lookup === undefined ? {} : { lookup: lookupsLists(lookup, access) },
         ...up === undefined ? {} : { up: { through: up.through, read: upReads(what, access) } },
     };

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

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

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

@@ -1,4 +1,5 @@
 import type { Index } from '../indexes/index-type.js';
+import type { Resource } from '../resource/resource.js';
 import type { ComponentAccess, ComponentLists, ResourceAccess, ResourceLists, SystemLookup, SystemLookupLists, Up, UpLists } from './access.js';
 import type { Shader } from './render.js';
 import type { System } from './system.js';
@@ -53,10 +54,16 @@ export type Declaration = {
     readonly target?: string;
     /** Makes this a render system (see `render`): its body records GPU work over the GPU copy of the components it names. */
     readonly shader?: Shader;
-    /** Hard constraint. */
-    readonly before?: readonly System<unknown>[];
-    /** Hard constraint. */
-    readonly after?: readonly System<unknown>[];
+    /**
+     * Hard constraint: runs before each system listed, and, for a resource listed, before every other system of the
+     * composite that uses it, but those its constraints already order before it and those listing it in `before` too.
+     */
+    readonly before?: readonly (System<unknown> | Resource.Key)[];
+    /**
+     * Hard constraint: runs after each system listed, and, for a resource listed, after every other system of the
+     * composite that uses it, but those its constraints already order after it and those listing it in `after` too.
+     */
+    readonly after?: readonly (System<unknown> | Resource.Key)[];
     /** Runs inside the span of the systems listed: after what they follow and before what follows them. */
     readonly during?: readonly System<unknown>[];
     /**

package/dist/interface/system/describe.d.ts

@@ -0,0 +1,120 @@
+import type { System } from './system.js';
+/**
+ * Describes how a system or composite runs: its tiers in run order, systems in one tier having no ordering path between
+ * them, each with the sync point after it, if any, and its readonly systems apart, which run after its last sync
+ * point. For each system, what the build inferred it reads, writes, looks up and commands, whether it takes its row
+ * whole, and the systems it follows directly, with what ordered it after each. `text` gives it all to read; the rest
+ * is data to assert on.
+ */
+export declare const describe: <I, R>(system: System<I, R>) => {
+    tiers: {
+        systems: {
+            /** The system, the value its constructor returned. */
+            system: System<unknown, unknown>;
+            name: string;
+            components: {
+                read: symbol[];
+                write: readonly symbol[];
+                /** What it requires without reading: `with` members it doesn't use, `added` and `changed` filters' among them. */
+                has: readonly symbol[];
+                optional: readonly symbol[];
+                not: readonly symbol[];
+                added: readonly symbol[];
+                changed: readonly symbol[];
+                /** What it reads of each row's parent, through `up`. */
+                parent: readonly symbol[];
+            };
+            resources: {
+                read: readonly symbol[];
+                write: readonly symbol[];
+                reduce: readonly symbol[];
+                changed: readonly symbol[];
+                is: readonly symbol[];
+                not: readonly symbol[];
+            };
+            lookups: {
+                name: string;
+                /** The label of the index it looks up through, or null for a lookup by entity. */
+                index: string | null;
+                read: readonly symbol[];
+            }[];
+            /** The label of the sorted index ordering its rows, or null. */
+            order: string | null;
+            /** What its commands name by kind, and whether it despawns; null where the build couldn't follow them. */
+            commands: {
+                spawn: readonly symbol[];
+                add: readonly symbol[];
+                remove: readonly symbol[];
+                despawn: boolean;
+            } | null;
+            /** Whether it takes its row whole (`components: { whole: true }`), every member written. */
+            whole: boolean;
+            /** The systems it follows directly, with what ordered it after each and the keys that need that order. */
+            after: {
+                system: System<unknown, unknown>;
+                name: string;
+                because: "before" | "after" | "during" | "reduction";
+                conflicts: readonly symbol[];
+            }[];
+        }[];
+        /**
+         * Why a sync point follows the tier, applying the commands so far: each system whose commands may change what a
+         * later one that follows it uses, through `keys`, none listed where it despawns or a cascade could; null for none.
+         */
+        sync: {
+            from: System<unknown, unknown>;
+            to: System<unknown, unknown>;
+            keys: readonly symbol[];
+        }[] | null;
+    }[];
+    readonly: {
+        /** The system, the value its constructor returned. */
+        system: System<unknown, unknown>;
+        name: string;
+        components: {
+            read: symbol[];
+            write: readonly symbol[];
+            /** What it requires without reading: `with` members it doesn't use, `added` and `changed` filters' among them. */
+            has: readonly symbol[];
+            optional: readonly symbol[];
+            not: readonly symbol[];
+            added: readonly symbol[];
+            changed: readonly symbol[];
+            /** What it reads of each row's parent, through `up`. */
+            parent: readonly symbol[];
+        };
+        resources: {
+            read: readonly symbol[];
+            write: readonly symbol[];
+            reduce: readonly symbol[];
+            changed: readonly symbol[];
+            is: readonly symbol[];
+            not: readonly symbol[];
+        };
+        lookups: {
+            name: string;
+            /** The label of the index it looks up through, or null for a lookup by entity. */
+            index: string | null;
+            read: readonly symbol[];
+        }[];
+        /** The label of the sorted index ordering its rows, or null. */
+        order: string | null;
+        /** What its commands name by kind, and whether it despawns; null where the build couldn't follow them. */
+        commands: {
+            spawn: readonly symbol[];
+            add: readonly symbol[];
+            remove: readonly symbol[];
+            despawn: boolean;
+        } | null;
+        /** Whether it takes its row whole (`components: { whole: true }`), every member written. */
+        whole: boolean;
+        /** The systems it follows directly, with what ordered it after each and the keys that need that order. */
+        after: {
+            system: System<unknown, unknown>;
+            name: string;
+            because: "before" | "after" | "during" | "reduction";
+            conflicts: readonly symbol[];
+        }[];
+    }[];
+    text: string;
+};

package/dist/interface/system/describe.js

@@ -0,0 +1,116 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { indexDefinitionOf } from '../registry/indexes.js';
+import { labelOf } from '../registry/names.js';
+import { requireDefinition } from '../registry/program.js';
+import { isLeaf, placementsOf, scheduleOf } from '../registry/schedule.js';
+const none = [];
+/** A leaf as the system value it is. */
+const asSystem = (leaf) => leaf;
+/** What the build inferred one system uses, and what placed it, as plain data. */
+const describeLeaf = (leaf, placements) => {
+    const { components, resources, lookup, up, order } = leaf.declaration;
+    const commands = leaf.commands();
+    return {
+        /** The system, the value its constructor returned. */
+        system: asSystem(leaf),
+        name: leaf.name,
+        components: {
+            read: [...components?.read ?? none, ...up === undefined ? none : [up.through]],
+            write: components?.write ?? none,
+            /** What it requires without reading: `with` members it doesn't use, `added` and `changed` filters' among them. */
+            has: components?.has ?? none,
+            optional: components?.optional ?? none,
+            not: components?.not ?? none,
+            added: components?.added ?? none,
+            changed: components?.changed ?? none,
+            /** What it reads of each row's parent, through `up`. */
+            parent: up?.read ?? none,
+        },
+        resources: {
+            read: resources?.read ?? none,
+            write: resources?.write ?? none,
+            reduce: resources?.reduce ?? none,
+            changed: resources?.changed ?? none,
+            is: resources?.is ?? none,
+            not: resources?.not ?? none,
+        },
+        lookups: Object.entries(lookup ?? {}).map(([name, used]) => ({
+            name,
+            /** The label of the index it looks up through, or null for a lookup by entity. */
+            index: "index" in used && used.index !== undefined ? indexDefinitionOf(used.index)?.name ?? null : null,
+            read: used.read ?? none,
+        })),
+        /** The label of the sorted index ordering its rows, or null. */
+        order: indexDefinitionOf(order)?.name ?? null,
+        /** What its commands name by kind, and whether it despawns; null where the build couldn't follow them. */
+        commands: commands === null ? null : {
+            spawn: commands?.spawn ?? none,
+            add: commands?.add ?? none,
+            remove: commands?.remove ?? none,
+            despawn: commands?.despawn === true,
+        },
+        /** Whether it takes its row whole (`components: { whole: true }`), every member written. */
+        whole: components?.whole === true,
+        /** The systems it follows directly, with what ordered it after each and the keys that need that order. */
+        after: placements.map(placement => ({ system: asSystem(placement.leaf), name: placement.leaf.name, because: placement.because, conflicts: placement.conflicts })),
+    };
+};
+const keys = (list) => list.map(labelOf).join(" ");
+/** A system's lines of text, after its name in a column of `width`. */
+const linesOf = (system, width) => {
+    const lines = [];
+    const add = (label, text) => { if (text !== "")
+        lines.push(`${label.padEnd(10)}${text}`); };
+    const { components, resources, commands } = system;
+    add("reads", keys(components.read));
+    add("writes", `${keys(components.write)}${system.whole ? " (its whole row)" : ""}`);
+    add("requires", [keys(components.has), components.not.length === 0 ? "" : `not ${keys(components.not)}`, components.optional.length === 0 ? "" : `optional ${keys(components.optional)}`].filter(text => text !== "").join(", "));
+    add("filters", [...components.added.map(key => `added ${labelOf(key)}`), ...components.changed.map(key => `changed ${labelOf(key)}`), ...resources.changed.map(key => `changed ${labelOf(key)}`)].join(", "));
+    add("parent", keys(components.parent));
+    add("resources", [resources.read.length === 0 ? "" : `reads ${keys(resources.read)}`, resources.write.length === 0 ? "" : `writes ${keys(resources.write)}`,
+        resources.reduce.length === 0 ? "" : `reduces ${keys(resources.reduce)}`, resources.is.length === 0 ? "" : `while ${keys(resources.is)}`,
+        resources.not.length === 0 ? "" : `unless ${keys(resources.not)}`].filter(text => text !== "").join(", "));
+    for (const lookup of system.lookups)
+        add("looks up", `${lookup.name}${lookup.index === null ? "" : ` through ${lookup.index}`}${lookup.read.length === 0 ? "" : `: ${keys(lookup.read)}`}`);
+    if (system.order !== null)
+        add("ordered", `by ${system.order}`);
+    if (commands === null)
+        add("commands", "unknown: the build couldn't follow them");
+    else
+        add("commands", [commands.spawn.length === 0 ? "" : `spawn ${keys(commands.spawn)}`, commands.add.length === 0 ? "" : `add ${keys(commands.add)}`,
+            commands.remove.length === 0 ? "" : `remove ${keys(commands.remove)}`, commands.despawn ? "despawn" : ""].filter(text => text !== "").join(", "));
+    add("after", system.after.map(placement => `${placement.name} (${placement.because}${placement.conflicts.length === 0 ? "" : `: ${keys(placement.conflicts)}`})`).join(", "));
+    const indent = " ".repeat(width);
+    return lines.length === 0 ? [system.name] : lines.map((line, i) => `${i === 0 ? system.name.padEnd(width) : indent}${line}`);
+};
+/**
+ * Describes how a system or composite runs: its tiers in run order, systems in one tier having no ordering path between
+ * them, each with the sync point after it, if any, and its readonly systems apart, which run after its last sync
+ * point. For each system, what the build inferred it reads, writes, looks up and commands, whether it takes its row
+ * whole, and the systems it follows directly, with what ordered it after each. `text` gives it all to read; the rest
+ * is data to assert on.
+ */
+export const describe = (system) => {
+    const definition = requireDefinition(system);
+    const schedule = scheduleOf(definition);
+    const placements = placementsOf(definition);
+    const tiers = schedule.tiers.map((tier, t) => ({
+        systems: tier.map(leaf => describeLeaf(leaf, placements.get(leaf) ?? none)),
+        /**
+         * Why a sync point follows the tier, applying the commands so far: each system whose commands may change what a
+         * later one that follows it uses, through `keys`, none listed where it despawns or a cascade could; null for none.
+         */
+        sync: schedule.syncs[t]?.map(reason => ({ from: asSystem(reason.from), to: asSystem(reason.to), keys: reason.keys })) ?? null,
+    }));
+    const readonly = schedule.observer.flatMap(member => isLeaf(member) ? [describeLeaf(member, none)] : []);
+    const width = Math.max(0, ...[...tiers.flatMap(tier => tier.systems), ...readonly].map(described => described.name.length)) + 2;
+    const text = [
+        ...tiers.flatMap((tier, t) => [
+            ...tier.systems.flatMap((described, i) => linesOf(described, width).map((line, l) => `${(i === 0 && l === 0 ? `tier ${t}` : "").padEnd(8)}${line}`)),
+            ...(tier.sync ?? none).map((reason, r) => `${(r === 0 ? "sync" : "").padEnd(8)}${reason.from.name}'s commands${reason.keys.length === 0 ? "" : ` of ${keys(reason.keys)}`}, for ${reason.to.name}`),
+        ]),
+        ...readonly.length === 0 ? none : ["readonly", ...readonly.flatMap(described => linesOf(described, width).map(line => `${"".padEnd(8)}${line}`))],
+    ].map(line => line.trimEnd()).join("\n");
+    return { tiers, readonly, text };
+};
+//# sourceMappingURL=describe.js.map

package/dist/interface/system/describe.js.map

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

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

@@ -1,3 +1,4 @@
 export type { Commands } from './commands.js';
 export * from './create.js';
+export { describe } from './describe.js';
 export { render, type RenderContext, type RenderTable } from './render.js';

package/dist/interface/system/index.js

@@ -1,3 +1,4 @@
 export * from './create.js';
+export { describe } from './describe.js';
 export { render } from './render.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interface/system/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAwC,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interface/system/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAwC,MAAM,aAAa,CAAC"}

package/dist/interface/system/leaf.d.ts

@@ -1,4 +1,5 @@
 import type { Schema } from '../schema/schema.js';
+import type { CommandLists } from './access.js';
 import type { Resolved } from './declaration.js';
 import type { Name } from './name.js';
 /** The schema of a body's input: an object of named fields. */
@@ -16,4 +17,10 @@ export type Leaf = {
     readonly declaration: Resolved;
     readonly input: InputSchema | undefined;
     readonly body: (...parameters: never[]) => void;
+    /**
+     * What its body's commands name, as the build inferred them, read at first need: null where it couldn't follow
+     * them, undefined for none. Apart from its declaration, so a module evaluated again with other commands declares the
+     * same system.
+     */
+    readonly commands: () => CommandLists | null | undefined;
 };

package/dist/interface/system/render.js

@@ -4,7 +4,7 @@ import { claimSystem } from '../registry/program.js';
 import { gpuDevice } from '../resources/gpu-device.js';
 import { accessorsOf } from '../gpu/accessors.js';
 import { checkLeaf } from './check.js';
-import { accessOf, compact, resourceUses } from './resolve.js';
+import { accessOf, compact, noCommands, resourceUses } from './resolve.js';
 /**
  * Declares a render system: it runs once per run on `gpuDevice`'s thread, in schedule order, and records GPU work over
  * the GPU copy of the components its accessors name, which the world uploads first as needed. It runs only while the
@@ -33,6 +33,7 @@ export const render = (declaration, body) => {
         },
         input: undefined,
         body,
+        commands: noCommands,
     };
     if (uses.write.length > 0 || uses.reduce.length > 0)
         throw new Error(`${what} writes or reduces into resources; a render system only reads.`);

package/dist/interface/system/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/interface/system/render.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAsD/D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAClB,WAAuG,EACvG,IAA6B,EACvB,EAAE;IACR,MAAM,EAAE,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,WAAW,IAAI,GAAG,CAAC;IAChC,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,CAAS,CAAC,GAAG,WAAW,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACjF,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;IACjE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,WAAW,CAAC;IACvD,MAAM,MAAM,GAAkB;QAC1B,IAAI,EAAE,QAAQ;QACd,IAAI;QACJ,WAAW,EAAE;YACT,GAAG,IAAI;YACP,UAAU,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;YACrH,SAAS,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;SACnE;QACD,KAAK,EAAE,SAAS;QAChB,IAAI;KACP,CAAC;IACF,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,gEAAgE,CAAC,CAAC;IAC9I,SAAS,CAAC,MAAM,CAAC,CAAC;IAClB,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,mBAAmB,SAAS,GAAG,CAAC,CAAC;IACnG,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC"}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/interface/system/render.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAsD3E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAClB,WAAuG,EACvG,IAA6B,EACvB,EAAE;IACR,MAAM,EAAE,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,WAAW,IAAI,GAAG,CAAC;IAChC,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,CAAS,CAAC,GAAG,WAAW,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACjF,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;IACjE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,WAAW,CAAC;IACvD,MAAM,MAAM,GAAkB;QAC1B,IAAI,EAAE,QAAQ;QACd,IAAI;QACJ,WAAW,EAAE;YACT,GAAG,IAAI;YACP,UAAU,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;YACrH,SAAS,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;SACnE;QACD,KAAK,EAAE,SAAS;QAChB,IAAI;QACJ,QAAQ,EAAE,UAAU;KACvB,CAAC;IACF,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,gEAAgE,CAAC,CAAC;IAC9I,SAAS,CAAC,MAAM,CAAC,CAAC;IAClB,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,mBAAmB,SAAS,GAAG,CAAC,CAAC;IACnG,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC"}

package/dist/interface/system/resolve.d.ts

@@ -1,4 +1,4 @@
-import type { ComponentAccess, ComponentLists, Lookup, SystemLookup, SystemLookupLists } from './access.js';
+import type { CommandLists, ComponentAccess, ComponentLists, Lookup, SystemLookup, SystemLookupLists } from './access.js';
 type Key = symbol;
 /** What a body reads and writes of a group of keys, and those it changes inside their values, read as well. */
 type Used = {
@@ -23,6 +23,11 @@ export type Access = {
     readonly up: readonly Key[] | null;
     /** The resources the predicates of its declaration's `where` read; absent without predicates. */
     readonly where?: readonly Key[] | null;
+    /**
+     * What its commands name, keys or lists of them, by kind, and whether it despawns, or a function giving that; absent
+     * where no build said.
+     */
+    readonly commands?: unknown;
     readonly at: string;
 };
 /**
@@ -63,6 +68,14 @@ export declare const resourceUses: (what: string, access: Access, is: readonly K
  * them, since the world couldn't tell when to evaluate them again.
  */
 export declare const whereReadsOf: (what: string, components: ComponentAccess | undefined, access: Access) => readonly Key[];
+/**
+ * What a body's commands name, as the world takes it, read at the first call and kept: null where the build couldn't
+ * follow them, nothing for none. The build gives them as a function, so a list declared below the system is read once
+ * its module has loaded; one still uninitialized then, as an import cycle leaves it, throws naming it.
+ */
+export declare const commandListsOf: (what: string, access: Access) => (() => CommandLists | null | undefined);
+/** The command lists of a system whose body issues none. */
+export declare const noCommands: () => undefined;
 /** What a body reads of its parent's values. */
 export declare const upReads: (what: string, access: Access) => readonly Key[];
 export {};

package/dist/interface/system/resolve.js

@@ -4,6 +4,11 @@ import { indexDefinitionOf } from '../registry/indexes.js';
 import { declarationOf, labelOf } from '../registry/names.js';
 import { isString, isStruct } from '../registry/schemas.js';
 const isKeys = (value) => Array.isArray(value) && value.every(key => typeof key === "symbol");
+const isNamed = (value) => Array.isArray(value) && value.every(item => typeof item === "symbol" || isKeys(item));
+/** A binding a command named that holds neither a key nor a list of them isn't followed. */
+const isCommanded = (value) => typeof value === "object" && value !== null
+    && isNamed(Reflect.get(value, "spawn")) && isNamed(Reflect.get(value, "add")) && isNamed(Reflect.get(value, "remove"))
+    && typeof Reflect.get(value, "despawn") === "boolean";
 const isUsed = (value) => typeof value === "object" && value !== null
     && isKeys(Reflect.get(value, "read")) && isKeys(Reflect.get(value, "write"))
     && (Reflect.get(value, "mutate") === undefined || isKeys(Reflect.get(value, "mutate")));
@@ -79,7 +84,7 @@ export const componentLists = (components, used, reading, whereReads = []) => {
         : used.write;
     const read = used === null ? without(held, write) : without(used.read, write);
     const has = [...without(members, read, write), ...without(filtered, read, write)];
-    return compact({ read, write, has, optional, not: components.not, added: components.added, changed: components.changed, where, whereReads });
+    return compact({ read, write, has, optional, not: components.not, added: components.added, changed: components.changed, where, whereReads, whole: components.whole });
 };
 /**
  * A lookup's lists: what the body reads of its rows, the rest of its `with` only required. Without the body's uses,
@@ -133,6 +138,50 @@ export const whereReadsOf = (what, components, access) => {
         throw new Error(`${what}'s where predicates (${access.at}) read resources in a way the build can't follow, so it can't tell when to evaluate them again: index them by key directly, or destructure them by key, in a predicate written in place in a module built with Compiler.plugin().`);
     return reads;
 };
+/**
+ * What a body's commands name, as the world takes it, read at the first call and kept: null where the build couldn't
+ * follow them, nothing for none. The build gives them as a function, so a list declared below the system is read once
+ * its module has loaded; one still uninitialized then, as an import cycle leaves it, throws naming it.
+ */
+export const commandListsOf = (what, access) => {
+    let read = false;
+    let lists;
+    return () => {
+        if (!read) {
+            lists = listsOf(what, access.commands);
+            read = true;
+        }
+        return lists;
+    };
+};
+/** The command lists of a system whose body issues none. */
+export const noCommands = () => undefined;
+const listsOf = (what, given) => {
+    const commands = typeof given === "function" ? evaluated(what, () => Reflect.apply(given, undefined, [])) : given;
+    if (commands === undefined)
+        return undefined;
+    if (!isCommanded(commands))
+        return null;
+    if (!commands.despawn && commands.spawn.length + commands.add.length + commands.remove.length === 0)
+        return undefined;
+    const flat = (named) => [...new Set(named.flat())];
+    const lists = compact({ spawn: flat(commands.spawn), add: flat(commands.add), remove: flat(commands.remove), despawn: commands.despawn ? true : undefined });
+    return Object.keys(lists).length === 0 ? undefined : lists;
+};
+/** What the build's function of a body's commands gives. */
+const evaluated = (what, commands) => {
+    try {
+        return commands();
+    }
+    catch (error) {
+        if (!(error instanceof ReferenceError))
+            throw error;
+        // Engines quote the binding in the message: "Cannot access 'standard' before initialization", or "can't access
+        // lexical declaration 'standard' before initialization".
+        const binding = /'([A-Za-z_$][\w$]*)'/.exec(error.message)?.[1];
+        throw new Error(`${what} names ${binding === undefined ? "a declaration" : `"${binding}"`} in its commands before it's initialized: declare it above the system.`, { cause: error });
+    }
+};
 /** What a body reads of its parent's values. */
 export const upReads = (what, access) => followed(what, access.up, "its parent's values", access);
 //# sourceMappingURL=resolve.js.map