@vworlds/vecs 1.0.15 → 1.0.17

package/dist/terms/target_term.js

@@ -0,0 +1,87 @@
+import { Term } from "./term.js";
+/**
+ * Composite term that matches entities whose relationship target satisfies a
+ * given inner predicate.
+ *
+ * An entity `e` matches when it carries the relationship component
+ * `_relationshipEid` **and** the target entity stored in that component
+ * satisfies `_innerTerm`.
+ *
+ * Children: `[relationshipTerm, innerTerm]`.
+ * - `children[0]` (`relationshipTerm`): the `ComponentTerm` for the
+ *   relationship eid — fires when the relationship is added/removed from `e`.
+ * - `children[1]` (`innerTerm`): the term for the inner DSL — fires when the
+ *   target entity transitions in or out.
+ *
+ * ## Non-standard event routing
+ *
+ * `TargetTerm` overrides `_onChildEvent` and `_onChildRefresh` to implement
+ * a **fan-out** strategy: when the inner term changes (the target enters or
+ * exits), all *sources* that point at that target via the relationship must be
+ * re-evaluated. This reverses the normal bottom-up signal direction. The
+ * fan-out is why `TargetTerm` subtrees are excluded from diamond collapsing —
+ * a plain compiled predicate cannot replicate this per-source walk.
+ */
+export class TargetTerm extends Term {
+    constructor(world, key, _relationshipEid, relationshipTerm, _innerTerm, onDestroy) {
+        super(world, key, "target", false, onDestroy);
+        this._relationshipEid = _relationshipEid;
+        this._innerTerm = _innerTerm;
+        this._setChildren([relationshipTerm, _innerTerm]);
+        this._initializeFromWorld();
+    }
+    /**
+     * Build a `TargetTerm` for the given relationship eid and inner DSL.
+     *
+     * @param world - Owning world.
+     * @param relationshipEid - Numeric eid of the relationship component type.
+     * @param innerDSL - DSL expression the relationship target must satisfy.
+     * @param key - Canonical cache key.
+     * @param getTerm - Term canonicalizer / cache accessor.
+     * @param onDestroy - Called when the last consumer unsubscribes.
+     */
+    static build(world, relationshipEid, innerDSL, key, getTerm, onDestroy) {
+        const relationshipTerm = getTerm(world, relationshipEid);
+        const innerTerm = getTerm(world, innerDSL);
+        return new TargetTerm(world, key, relationshipEid, relationshipTerm, innerTerm, onDestroy);
+    }
+    /**
+     * @internal Fan-out child membership event handler.
+     *
+     * When the relationship component is added/removed from `entity`
+     * (`child === children[0]`), re-evaluate that entity directly. When the
+     * inner term changes for some target entity (`child === children[1]`), walk
+     * every source entity that points at that target via the relationship and
+     * re-evaluate each one.
+     */
+    _onChildEvent(_kind, entity, child) {
+        if (child === this._children[0]) {
+            this._sync(entity);
+            return;
+        }
+        entity.children(this._relationshipEid).forEach((source) => this._sync(source));
+    }
+    /**
+     * @internal Fan-out child refresh handler.
+     *
+     * Mirrors `_onChildEvent`: a data/shape change on the relationship component
+     * or the inner term may alter whether a source entity matches, so the same
+     * fan-out logic applies.
+     */
+    _onChildRefresh(entity, child) {
+        if (child === this._children[0]) {
+            this._sync(entity);
+            return;
+        }
+        entity.children(this._relationshipEid).forEach((source) => this._sync(source));
+    }
+    /** @internal */
+    _matches(entity) {
+        if (entity._destroyed) {
+            return false;
+        }
+        const target = entity._get(this._relationshipEid)?.target;
+        return target !== undefined && this._innerTerm.has(target);
+    }
+}
+//# sourceMappingURL=target_term.js.map

package/dist/terms/target_term.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target_term.js","sourceRoot":"","sources":["../../src/terms/target_term.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAiB,MAAM,WAAW,CAAC;AAGhD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,UAAW,SAAQ,IAAI;IAClC,YACE,KAAY,EACZ,GAAW,EACM,gBAAwB,EACzC,gBAAsB,EACL,UAAgB,EACjC,SAA+B;QAE/B,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAL7B,qBAAgB,GAAhB,gBAAgB,CAAQ;QAExB,eAAU,GAAV,UAAU,CAAM;QAIjC,IAAI,CAAC,YAAY,CAAC,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC,CAAC;QAClD,IAAI,CAAC,oBAAoB,EAAE,CAAC;IAC9B,CAAC;IAED;;;;;;;;;OASG;IACI,MAAM,CAAC,KAAK,CACjB,KAAY,EACZ,eAAuB,EACvB,QAAkB,EAClB,GAAW,EACX,OAAyB,EACzB,SAA+B;QAE/B,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QACzD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC3C,OAAO,IAAI,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,eAAe,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC7F,CAAC;IAED;;;;;;;;OAQG;IACgB,aAAa,CAAC,KAAoB,EAAE,MAAc,EAAE,KAAW;QAChF,IAAI,KAAK,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;OAMG;IACgB,eAAe,CAAC,MAAc,EAAE,KAAW;QAC5D,IAAI,KAAK,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,gBAAgB;IACN,QAAQ,CAAC,MAAc;QAC/B,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,MAAM,GAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAA8B,EAAE,MAAM,CAAC;QACxF,OAAO,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/terms/term.d.ts

@@ -0,0 +1,94 @@
+import type { Entity } from "../entity/index.js";
+import type { World } from "../world/index.js";
+export declare const enum TermEventKind {
+    Enter = 0,
+    Exit = 1
+}
+/**
+ * Observer interface for a `Term` node.
+ *
+ * ## Two-signal contract
+ *
+ * Consumers receive two independent channels:
+ *
+ * - **`onTermEvent`** — the ordered **membership stream**. Only real
+ *   enter/exit flips are emitted here (no spurious duplicates). Every
+ *   consumer — including `Query`, `System`, and composite parent terms —
+ *   implements this method. It is the sole authoritative source of "who is
+ *   in the set".
+ *
+ * - **`onTermRefresh`** — an *optional* **invalidation hint**. It signals
+ *   that an entity's data or shape changed but membership *may* not have.
+ *   Only composite terms that need to pull-recompute on data changes
+ *   (e.g. `PredicateTerm`, `OnlyTerm`) implement this; membership-only
+ *   consumers such as `Query` omit it and are never woken by pure data
+ *   updates. The `?` makes the method optional so implementors that do not
+ *   care about data refreshes pay zero overhead.
+ */
+export interface TermConsumer {
+    /** Ordered membership stream. Only real enter/exit flips are emitted here. */
+    onTermEvent(kind: TermEventKind, entity: Entity): void;
+}
+export type TermKind = "world" | "component" | "empty" | "all" | "any" | "not" | "only" | "predicate" | "target" | "merged";
+/**
+ * Base class for all reactive entity-set nodes in the term graph.
+ *
+ * A `Term` maintains a live `Set<Entity>` of every entity currently satisfying
+ * its sub-predicate. It subscribes to its children via the two-signal contract
+ * defined on {@link TermConsumer} and propagates enter/exit events upward to
+ * its own consumers.
+ *
+ * Subclasses implement `_matches` (the membership test) and may override
+ * `_onChildEvent`, `_onChildRefresh`, or `onTermRefresh` to customize how
+ * signals from children are interpreted.
+ */
+export declare abstract class Term implements TermConsumer {
+    readonly world: World;
+    readonly key: string;
+    readonly kind: TermKind;
+    private readonly _pinned;
+    private readonly _onDestroy;
+    private _destroyed;
+    private readonly _childUnsubscribes;
+    protected constructor(world: World, key: string, kind: TermKind, _pinned: boolean, _onDestroy: (term: Term) => void);
+    get count(): number;
+    [Symbol.iterator](): IterableIterator<Entity>;
+    children(): readonly Term[];
+    has(entity: Entity): boolean;
+    /**
+     * Default membership-event handler: re-run `_matches` and add/remove
+     * accordingly. Composite terms typically let this default run; leaf terms
+     * use explicit `_add`/`_delete` calls instead and never receive child events.
+     */
+    onTermEvent(_kind: TermEventKind, entity: Entity): void;
+    /**
+     * Default invalidation-hint handler: re-run `_matches` via `_sync`.
+     *
+     * Terms that should *not* re-evaluate on a data/shape refresh (e.g.
+     * `NotTerm`) override this with a no-op. Terms that need the shape channel
+     * but want to override the full handler (e.g. `OnlyTerm`) override with a
+     * call to `_sync` as well — this default is already correct for most cases.
+     */
+    onTermRefresh(entity: Entity): void;
+    /**
+     * Add `consumer` to the set of active consumers and return an unsubscribe
+     * function.
+     *
+     * Consumer count drives term lifetime: when the count falls to zero on a
+     * non-pinned term the term destroys itself and cascades destruction to
+     * children. Calling the unsubscribe function more than once is safe (idempotent).
+     *
+     * @throws If the term has already been destroyed.
+     */
+    subscribe(consumer: TermConsumer): () => void;
+    /**
+     * Permanently destroy this term.
+     *
+     * Clears all consumers, unsubscribes from all children (cascading
+     * destruction when their consumer counts reach zero), clears the entity
+     * set, and calls `_onDestroy` to remove the term from the world cache.
+     * Pinned terms (`WorldTerm`, `ComponentTerm`, `EmptyTerm`) ignore this call.
+     */
+    destroy(): void;
+    private _emit;
+}

package/dist/terms/term.js

@@ -0,0 +1,202 @@
+/**
+ * Base class for all reactive entity-set nodes in the term graph.
+ *
+ * A `Term` maintains a live `Set<Entity>` of every entity currently satisfying
+ * its sub-predicate. It subscribes to its children via the two-signal contract
+ * defined on {@link TermConsumer} and propagates enter/exit events upward to
+ * its own consumers.
+ *
+ * Subclasses implement `_matches` (the membership test) and may override
+ * `_onChildEvent`, `_onChildRefresh`, or `onTermRefresh` to customize how
+ * signals from children are interpreted.
+ */
+export class Term {
+    constructor(world, key, kind, _pinned, _onDestroy) {
+        this.world = world;
+        this.key = key;
+        this.kind = kind;
+        this._pinned = _pinned;
+        this._onDestroy = _onDestroy;
+        /** @internal */
+        this._children = [];
+        /** @internal */
+        this._consumers = new Set();
+        /** @internal */
+        this._entities = new Set();
+        this._destroyed = false;
+        this._childUnsubscribes = [];
+    }
+    get count() {
+        return this._entities.size;
+    }
+    [Symbol.iterator]() {
+        return this._entities[Symbol.iterator]();
+    }
+    children() {
+        return this._children;
+    }
+    has(entity) {
+        return this._entities.has(entity);
+    }
+    /**
+     * Default membership-event handler: re-run `_matches` and add/remove
+     * accordingly. Composite terms typically let this default run; leaf terms
+     * use explicit `_add`/`_delete` calls instead and never receive child events.
+     */
+    onTermEvent(_kind, entity) {
+        this._sync(entity);
+    }
+    /**
+     * Default invalidation-hint handler: re-run `_matches` via `_sync`.
+     *
+     * Terms that should *not* re-evaluate on a data/shape refresh (e.g.
+     * `NotTerm`) override this with a no-op. Terms that need the shape channel
+     * but want to override the full handler (e.g. `OnlyTerm`) override with a
+     * call to `_sync` as well — this default is already correct for most cases.
+     */
+    onTermRefresh(entity) {
+        this._sync(entity);
+    }
+    /**
+     * Add `consumer` to the set of active consumers and return an unsubscribe
+     * function.
+     *
+     * Consumer count drives term lifetime: when the count falls to zero on a
+     * non-pinned term the term destroys itself and cascades destruction to
+     * children. Calling the unsubscribe function more than once is safe (idempotent).
+     *
+     * @throws If the term has already been destroyed.
+     */
+    subscribe(consumer) {
+        if (this._destroyed) {
+            throw new Error(`Cannot subscribe to destroyed ${this.kind} term`);
+        }
+        this._consumers.add(consumer);
+        let active = true;
+        return () => {
+            if (!active) {
+                return;
+            }
+            active = false;
+            this._consumers.delete(consumer);
+            if (!this._pinned && this._consumers.size === 0) {
+                this.destroy();
+            }
+        };
+    }
+    /**
+     * Permanently destroy this term.
+     *
+     * Clears all consumers, unsubscribes from all children (cascading
+     * destruction when their consumer counts reach zero), clears the entity
+     * set, and calls `_onDestroy` to remove the term from the world cache.
+     * Pinned terms (`WorldTerm`, `ComponentTerm`, `EmptyTerm`) ignore this call.
+     */
+    destroy() {
+        if (this._destroyed || this._pinned) {
+            return;
+        }
+        this._destroyed = true;
+        this._consumers.clear();
+        while (this._childUnsubscribes.length > 0) {
+            this._childUnsubscribes.pop()();
+        }
+        this._entities.clear();
+        this._onDestroy(this);
+    }
+    /** @internal Emit an enter event and add entity; no-op if already present. */
+    _add(entity) {
+        if (this._entities.has(entity)) {
+            return;
+        }
+        this._entities.add(entity);
+        this._emit(0 /* TermEventKind.Enter */, entity);
+    }
+    /** @internal Emit an exit event and remove entity; no-op if not present. */
+    _delete(entity) {
+        if (!this._entities.delete(entity)) {
+            return;
+        }
+        this._emit(1 /* TermEventKind.Exit */, entity);
+    }
+    /** @internal Propagate a refresh hint to all consumers (both channels). */
+    _emitRefresh(entity) {
+        this._consumers.forEach((consumer) => consumer.onTermRefresh?.(entity));
+    }
+    /** @internal Register an additional cleanup callback run during `destroy`. */
+    _addChildCleanup(cleanup) {
+        this._childUnsubscribes.push(cleanup);
+    }
+    /**
+     * @internal Seed the entity set from the current world state without
+     * emitting events.
+     *
+     * Called once at the end of construction so the term starts up-to-date
+     * before any consumers subscribe.
+     */
+    _initializeFromWorld() {
+        this.world.entities.forEach((entity) => {
+            if (this._matches(entity)) {
+                this._entities.add(entity);
+            }
+        });
+    }
+    /**
+     * @internal Register `children` as this term's child nodes.
+     *
+     * For each child, subscribes **both** channels via an anonymous
+     * `TermConsumer` that routes to `_onChildEvent` and `_onChildRefresh`.
+     * Registering both channels here (rather than in subclass constructors)
+     * ensures that every composite term receives refresh hints without
+     * boilerplate — subclasses then filter in `_onChildRefresh` to decide
+     * whether to act.
+     */
+    _setChildren(children) {
+        this._children.push(...children);
+        children.forEach((child) => {
+            this._childUnsubscribes.push(child.subscribe({
+                onTermEvent: (kind, entity) => this._onChildEvent(kind, entity, child),
+                onTermRefresh: (entity) => this._onChildRefresh(entity, child),
+            }));
+        });
+    }
+    /**
+     * @internal Default child membership-event handler: forward to
+     * `onTermEvent`. Composite terms (e.g. `TargetTerm`) override this to
+     * implement non-trivial fan-out logic.
+     */
+    _onChildEvent(kind, entity, _child) {
+        this.onTermEvent(kind, entity);
+    }
+    /**
+     * @internal Default child refresh handler: forward to `onTermRefresh`.
+     *
+     * Most composites delegate to `onTermRefresh` which defaults to `_sync`.
+     * Subclasses that only want to react to *specific* child kinds (e.g.
+     * `PredicateTerm` reacting only to component-kind children) override this
+     * to filter before calling `_sync`.
+     */
+    _onChildRefresh(entity, _child) {
+        this.onTermRefresh(entity);
+    }
+    /**
+     * @internal Pull-recompute membership for `entity`.
+     *
+     * Re-evaluates `_matches` and calls `_add` or `_delete`. Because `_add` and
+     * `_delete` are idempotent, `_sync` is safe to call redundantly — it emits
+     * an event only on a real flip, which is the core of the glitch-free
+     * propagation guarantee.
+     */
+    _sync(entity) {
+        if (this._matches(entity)) {
+            this._add(entity);
+        }
+        else {
+            this._delete(entity);
+        }
+    }
+    _emit(kind, entity) {
+        this._consumers.forEach((consumer) => consumer.onTermEvent(kind, entity));
+    }
+}
+//# sourceMappingURL=term.js.map

package/dist/terms/term.js.map

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

package/dist/terms/world_term.d.ts

@@ -0,0 +1,68 @@
+import type { Entity } from "../entity/index.js";
+import type { World } from "../world/index.js";
+import { Term, type TermConsumer } from "./term.js";
+/**
+ * World-pinned leaf term that matches every live entity.
+ *
+ * `WorldTerm` is the "universe" node: it holds all entities that are not
+ * destroyed. Component-definition entities are first-class members too (they
+ * are ordinary entities), so world-rooted queries can enumerate them — this is
+ * what makes schema reflection possible. Every other term that needs
+ * world-lifecycle awareness (e.g. `NotTerm`, `PredicateTerm`) subscribes to
+ * this leaf via the standard membership channel so they see entity creation
+ * and destruction.
+ *
+ * ## Shape channel
+ *
+ * `WorldTerm` also maintains a separate **shape channel** via
+ * {@link subscribeShape} / {@link entityShapeChanged}. When a component is
+ * added to or removed from an entity, `build.ts` calls
+ * `entityShapeChanged`; the world term then fans that notification out to all
+ * registered shape consumers as an `onTermRefresh` call. Only terms that are
+ * sensitive to the *set* of components on an entity (currently `OnlyTerm` and
+ * merged `PredicateTerm` nodes that contain an `only(...)` sub-expression)
+ * register on this channel, keeping it zero-cost for the common case.
+ */
+export declare class WorldTerm extends Term {
+    constructor(world: World, key: string, onDestroy: (term: Term) => void);
+    /**
+     * Called by `build.ts` when a new entity is created.
+     *
+     * Adds the entity if it matches (i.e. it is live), which propagates an enter
+     * event to all consumers.
+     */
+    entityCreated(entity: Entity): void;
+    /**
+     * Called by `build.ts` when an entity is destroyed.
+     *
+     * Unconditionally removes the entity, propagating an exit event.
+     */
+    entityDestroyed(entity: Entity): void;
+    /**
+     * Called by `build.ts` when a component is added to or removed from an
+     * entity (a shape change).
+     *
+     * Notifies all {@link _shapeConsumers} via `onTermRefresh` so terms like
+     * `OnlyTerm` can re-evaluate whether the entity's component set still
+     * satisfies their exact-match predicate.
+     *
+     * Only fires for entities already in this term's set (i.e. live entities) —
+     * there is no point notifying about shape changes on entities that the world
+     * term itself does not track.
+     */
+    entityShapeChanged(entity: Entity): void;
+    /**
+     * Register `consumer` on the shape channel and return an unsubscribe
+     * function.
+     *
+     * The shape channel is separate from the standard membership channel so
+     * that component-add/remove events can be distinguished from
+     * entity-create/destroy events. Consumers on this channel receive
+     * `onTermRefresh` calls (not `onTermEvent`) because the shape change does
+     * not itself imply a membership change in the world term.
+     *
+     * @param consumer - The term or callback object to notify.
+     * @returns Cleanup function; safe to call multiple times.
+     */
+    subscribeShape(consumer: TermConsumer): () => void;
+}

package/dist/terms/world_term.js

@@ -0,0 +1,99 @@
+import { Term } from "./term.js";
+/**
+ * World-pinned leaf term that matches every live entity.
+ *
+ * `WorldTerm` is the "universe" node: it holds all entities that are not
+ * destroyed. Component-definition entities are first-class members too (they
+ * are ordinary entities), so world-rooted queries can enumerate them — this is
+ * what makes schema reflection possible. Every other term that needs
+ * world-lifecycle awareness (e.g. `NotTerm`, `PredicateTerm`) subscribes to
+ * this leaf via the standard membership channel so they see entity creation
+ * and destruction.
+ *
+ * ## Shape channel
+ *
+ * `WorldTerm` also maintains a separate **shape channel** via
+ * {@link subscribeShape} / {@link entityShapeChanged}. When a component is
+ * added to or removed from an entity, `build.ts` calls
+ * `entityShapeChanged`; the world term then fans that notification out to all
+ * registered shape consumers as an `onTermRefresh` call. Only terms that are
+ * sensitive to the *set* of components on an entity (currently `OnlyTerm` and
+ * merged `PredicateTerm` nodes that contain an `only(...)` sub-expression)
+ * register on this channel, keeping it zero-cost for the common case.
+ */
+export class WorldTerm extends Term {
+    constructor(world, key, onDestroy) {
+        super(world, key, "world", true, onDestroy);
+        /**
+         * @internal Consumers registered via {@link subscribeShape} that want
+         * notification when any entity's component set changes.
+         */
+        this._shapeConsumers = new Set();
+        this._initializeFromWorld();
+    }
+    /**
+     * Called by `build.ts` when a new entity is created.
+     *
+     * Adds the entity if it matches (i.e. it is live), which propagates an enter
+     * event to all consumers.
+     */
+    entityCreated(entity) {
+        if (this._matches(entity)) {
+            this._add(entity);
+        }
+    }
+    /**
+     * Called by `build.ts` when an entity is destroyed.
+     *
+     * Unconditionally removes the entity, propagating an exit event.
+     */
+    entityDestroyed(entity) {
+        this._delete(entity);
+    }
+    /**
+     * Called by `build.ts` when a component is added to or removed from an
+     * entity (a shape change).
+     *
+     * Notifies all {@link _shapeConsumers} via `onTermRefresh` so terms like
+     * `OnlyTerm` can re-evaluate whether the entity's component set still
+     * satisfies their exact-match predicate.
+     *
+     * Only fires for entities already in this term's set (i.e. live entities) —
+     * there is no point notifying about shape changes on entities that the world
+     * term itself does not track.
+     */
+    entityShapeChanged(entity) {
+        if (this.has(entity)) {
+            this._shapeConsumers.forEach((consumer) => consumer.onTermRefresh?.(entity));
+        }
+    }
+    /**
+     * Register `consumer` on the shape channel and return an unsubscribe
+     * function.
+     *
+     * The shape channel is separate from the standard membership channel so
+     * that component-add/remove events can be distinguished from
+     * entity-create/destroy events. Consumers on this channel receive
+     * `onTermRefresh` calls (not `onTermEvent`) because the shape change does
+     * not itself imply a membership change in the world term.
+     *
+     * @param consumer - The term or callback object to notify.
+     * @returns Cleanup function; safe to call multiple times.
+     */
+    subscribeShape(consumer) {
+        this._shapeConsumers.add(consumer);
+        let active = true;
+        return () => {
+            if (!active) {
+                return;
+            }
+            active = false;
+            this._shapeConsumers.delete(consumer);
+        };
+    }
+    /** @internal */
+    _matches(entity) {
+        return !entity._destroyed;
+    }
+}
+//# sourceMappingURL=world_term.js.map

package/dist/terms/world_term.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world_term.js","sourceRoot":"","sources":["../../src/terms/world_term.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAqB,MAAM,WAAW,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,SAAU,SAAQ,IAAI;IAOjC,YAAmB,KAAY,EAAE,GAAW,EAAE,SAA+B;QAC3E,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAP9C;;;WAGG;QACc,oBAAe,GAAG,IAAI,GAAG,EAAgB,CAAC;QAIzD,IAAI,CAAC,oBAAoB,EAAE,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACI,aAAa,CAAC,MAAc;QACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,eAAe,CAAC,MAAc;QACnC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;OAWG;IACI,kBAAkB,CAAC,MAAc;QACtC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,cAAc,CAAC,QAAsB;QAC1C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,MAAM,GAAG,KAAK,CAAC;YACf,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC,CAAC;IACJ,CAAC;IAED,gBAAgB;IACN,QAAQ,CAAC,MAAc;QAC/B,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;IAC5B,CAAC;CACF"}

package/dist/timer.js

@@ -49,7 +49,7 @@ export class IntervalTickSource extends BaseTickSource {
         super();
         this._accumulator = 0;
         if (intervalSeconds <= 0) {
-            throw "interval seconds must be greater than 0";
+            throw new Error("interval seconds must be greater than 0");
         }
         this._intervalMs = intervalSeconds * 1000;
     }
@@ -93,7 +93,7 @@ export class RateTickSource extends BaseTickSource {
         super();
         this._counter = 0;
         if (!Number.isInteger(rate) || rate <= 0) {
-            throw "rate must be a positive integer";
+            throw new Error("rate must be a positive integer");
         }
         this._rate = rate;
         this._source = source;

package/dist/timer.js.map

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

package/dist/util/array_map.js

@@ -77,6 +77,18 @@ export class ArrayMap {
             }
         }
     }
+    /** Return every present value in ascending key order. */
+    values() {
+        const out = [];
+        const backend = this._backend;
+        for (let i = 0; i < backend.length; i++) {
+            const value = backend[i];
+            if (value !== undefined) {
+                out.push(value);
+            }
+        }
+        return out;
+    }
     /** Remove all entries and reset {@link size} to zero. */
     clear() {
         this._backend.length = 0;

package/dist/util/array_map.js.map

@@ -1 +1 @@
-{"version":3,"file":"array_map.js","sourceRoot":"","sources":["../../src/util/array_map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,QAAQ;IAArB;QACU,aAAQ,GAAsB,EAAE,CAAC;QACjC,UAAK,GAAW,CAAC,CAAC;IAwE5B,CAAC;IAtEC,kDAAkD;IAClD,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACI,GAAG,CAAC,GAAW,EAAE,KAAQ;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,GAAW;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,OAAO,CAAC,QAA2D;QACxE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED,yDAAyD;IAClD,KAAK;QACV,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;CACF"}
+{"version":3,"file":"array_map.js","sourceRoot":"","sources":["../../src/util/array_map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,QAAQ;IAArB;QACU,aAAQ,GAAsB,EAAE,CAAC;QACjC,UAAK,GAAW,CAAC,CAAC;IAqF5B,CAAC;IAnFC,kDAAkD;IAClD,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACI,GAAG,CAAC,GAAW,EAAE,KAAQ;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,GAAW;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,OAAO,CAAC,QAA2D;QACxE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED,yDAAyD;IAClD,MAAM;QACX,MAAM,GAAG,GAAQ,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,yDAAyD;IAClD,KAAK;QACV,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;CACF"}