@vworlds/vecs 1.0.54 → 1.0.55

package/dist/world/destroy-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"destroy-order.js","sourceRoot":"","sources":["../../src/world/destroy-order.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAkB,EAAE,UAAgB;IAChE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;YAC/C,IAAI,OAAO,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7C,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QACD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;gBACzD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,UAAU,GAAG,IAAI,CAAC;IACtB,OAAO,UAAU,EAAE,CAAC;QAClB,UAAU,GAAG,KAAK,CAAC;QACnB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,CAAC,SAAiB,EAAW,EAAE,CAC5C,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACnD,IACE,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC;gBACvB,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,EACxE,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAClB,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACpB,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,SAAuC,GAAG,EAAE,CAAC,IAAI;IACtF,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;QAC/C,IAAI,OAAO,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yEAAyE;AACzE,SAAS,gBAAgB,CACvB,MAAc,EACd,UAAe,EACf,MAAkC;IAElC,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IACnD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/world/stats.d.ts

@@ -0,0 +1,51 @@
+import type { System } from "../system.js";
+/** Accumulated synchronous execution time, in milliseconds, since the last reset. */
+export interface Timing {
+    /** Number of admitted executions (not entity callbacks). */
+    runs: number;
+    /** Sum of execution durations in milliseconds. */
+    totalMs: number;
+    /** Longest execution duration in milliseconds. */
+    maxMs: number;
+}
+/** A system's timing; read its identity and cadence from the original system. */
+export interface SystemTiming extends Timing {
+    /** The original system, not a descriptor copy. */
+    system: System;
+}
+/** A named timing breakdown supplied by a world extension. */
+export interface OperationTiming extends Timing {
+    /** Stable operation name, for example `replication:encode`. */
+    name: string;
+}
+/** Opt-in world timing. Reading allocates snapshots; ticking reuses slots. */
+export declare class WorldStats {
+    private readonly _pipeline;
+    private _enabled;
+    private readonly _systems;
+    private readonly _operations;
+    private _generation;
+    /** Whether system and extension timing is enabled. Off by default. */
+    get systemsEnabled(): boolean;
+    /** Stop measuring without discarding accumulated results. */
+    disableSystems(): void;
+    /** Start measuring systems and extension operations on subsequent ticks. */
+    enableSystems(): void;
+    /** Read extension-operation snapshots in first-seen order; empty before measurement. */
+    operations(): OperationTiming[];
+    /**
+     * Record one completed extension operation, reusing its first-seen named slot.
+     * World extensions select their instrumented path with `systemsEnabled` once
+     * per frame, then call this method with a finite, non-negative duration in ms.
+     * This method neither reads a clock nor checks the switch again, so an in-flight
+     * measured frame can finish even if a callback changes the switch.
+     * Throws `RangeError` for a negative or non-finite duration.
+     */
+    recordOperation(name: string, elapsedMs: number): void;
+    /** Clear all system and operation totals without changing the enabled state. */
+    resetSystems(): void;
+    /** Read system snapshots in current pipeline order, including zero-run systems. */
+    systems(): SystemTiming[];
+    private _clear;
+    private _operationSlot;
+}

package/dist/world/stats.js

@@ -0,0 +1,88 @@
+/** Opt-in world timing. Reading allocates snapshots; ticking reuses slots. */
+export class WorldStats {
+    /** @internal Constructed by the owning world. */
+    constructor(_pipeline) {
+        this._pipeline = _pipeline;
+        this._enabled = false;
+        this._systems = new WeakMap();
+        this._operations = new Map();
+        this._generation = 0;
+    }
+    /** Whether system and extension timing is enabled. Off by default. */
+    get systemsEnabled() {
+        return this._enabled;
+    }
+    /** Stop measuring without discarding accumulated results. */
+    disableSystems() {
+        this._enabled = false;
+    }
+    /** Start measuring systems and extension operations on subsequent ticks. */
+    enableSystems() {
+        this._enabled = true;
+    }
+    /** Read extension-operation snapshots in first-seen order; empty before measurement. */
+    operations() {
+        return Array.from(this._operations.values(), (slot) => ({ ...slot }));
+    }
+    /**
+     * Record one completed extension operation, reusing its first-seen named slot.
+     * World extensions select their instrumented path with `systemsEnabled` once
+     * per frame, then call this method with a finite, non-negative duration in ms.
+     * This method neither reads a clock nor checks the switch again, so an in-flight
+     * measured frame can finish even if a callback changes the switch.
+     * Throws `RangeError` for a negative or non-finite duration.
+     */
+    recordOperation(name, elapsedMs) {
+        if (!Number.isFinite(elapsedMs) || elapsedMs < 0) {
+            throw new RangeError("operation duration must be finite and non-negative");
+        }
+        this._record(this._operationSlot(name), elapsedMs);
+    }
+    /** Clear all system and operation totals without changing the enabled state. */
+    resetSystems() {
+        this._generation++;
+        for (const slot of this._operations.values()) {
+            this._clear(slot);
+        }
+    }
+    /** Read system snapshots in current pipeline order, including zero-run systems. */
+    systems() {
+        return this._pipeline().map((system) => {
+            const { runs, totalMs, maxMs } = this._systemSlot(system);
+            return { system, runs, totalMs, maxMs };
+        });
+    }
+    /** @internal Reuse a slot after the system's first measured or read appearance. */
+    _systemSlot(system) {
+        let slot = this._systems.get(system);
+        if (!slot) {
+            slot = { system, runs: 0, totalMs: 0, maxMs: 0, generation: this._generation };
+            this._systems.set(system, slot);
+        }
+        if (slot.generation !== this._generation) {
+            this._clear(slot);
+            slot.generation = this._generation;
+        }
+        return slot;
+    }
+    /** @internal Aggregate a completed execution without allocating. */
+    _record(slot, elapsedMs) {
+        slot.runs++;
+        slot.totalMs += elapsedMs;
+        slot.maxMs = Math.max(slot.maxMs, elapsedMs);
+    }
+    _clear(slot) {
+        slot.runs = 0;
+        slot.totalMs = 0;
+        slot.maxMs = 0;
+    }
+    _operationSlot(name) {
+        let slot = this._operations.get(name);
+        if (!slot) {
+            slot = { name, runs: 0, totalMs: 0, maxMs: 0 };
+            this._operations.set(name, slot);
+        }
+        return slot;
+    }
+}
+//# sourceMappingURL=stats.js.map

package/dist/world/stats.js.map

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

package/dist/world/world.base.js

@@ -1,5 +1,7 @@
 export class Base {
     constructor() {
+        /** @internal Suspend cleanup policies only during dispose's infrastructure pass. */
+        this._tearingDownInfrastructure = false;
         /**
          * @internal Per-world registry mapping a component class to its
          * component-entity. The registry is per-world so the lookup stays off the

package/dist/world/world.base.js.map

@@ -1 +1 @@
-{"version":3,"file":"world.base.js","sourceRoot":"","sources":["../../src/world/world.base.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,IAAI;IAAjB;QACE;;;;WAIG;QACa,mBAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;QAE3D;;;WAGG;QACa,uBAAkB,GAAG,IAAI,GAAG,EAAkB,CAAC;QAE/D;;;WAGG;QACa,0BAAqB,GAAG,IAAI,OAAO,EAAkB,CAAC;QAEtE;;;;WAIG;QACI,mBAAc,GAAuB,SAAS,CAAC;QAEtD;;;;WAIG;QACI,mBAAc,GAAuB,SAAS,CAAC;IACxD,CAAC;CAAA"}
+{"version":3,"file":"world.base.js","sourceRoot":"","sources":["../../src/world/world.base.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,IAAI;IAAjB;QACE,oFAAoF;QAC7E,+BAA0B,GAAG,KAAK,CAAC;QAE1C;;;;WAIG;QACa,mBAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;QAE3D;;;WAGG;QACa,uBAAkB,GAAG,IAAI,GAAG,EAAkB,CAAC;QAE/D;;;WAGG;QACa,0BAAqB,GAAG,IAAI,OAAO,EAAkB,CAAC;QAEtE;;;;WAIG;QACI,mBAAc,GAAuB,SAAS,CAAC;QAEtD;;;;WAIG;QACI,mBAAc,GAAuB,SAAS,CAAC;IACxD,CAAC;CAAA"}

package/dist/world/world.components.d.ts

@@ -11,6 +11,8 @@ export declare class Components extends Entities {
      * and its id is drawn from the `"component"` id pool (1–899 by default).
      * Subsequent calls with the same class return the same entity. The same class
      * may be registered independently in multiple worlds.
+     * A newly registered definition inherits the current scope parent immediately.
+     * Scopes must be entered outside deferred mode. Existing lookups do not reparent it.
      *
      * Pass an explicit numeric `ceid` to pin the component to a server-assigned
      * stable id instead of auto-allocating one.

package/dist/world/world.components.js

@@ -71,6 +71,10 @@ export class Components extends Entities {
         const component = new Constructor(this, ceid, ComponentClass);
         this._entities.set(ceid, component);
         this._classRegistry.set(ComponentClass, component);
+        const parent = this._scope;
+        if (parent !== undefined) {
+            component.childOf(parent);
+        }
         // Component-definition entities are first-class entities: notify so any
         // live world-rooted query/term picks them up reactively (reflection),
         // exactly like an ordinary `world.entity()`.

package/dist/world/world.components.js.map

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

package/dist/world/world.disposal.d.ts

@@ -6,61 +6,59 @@ import type { World } from "./world.js";
  * to `Pipeline`.
  */
 export declare class Disposal extends Transfers {
-    /** `true` once {@link dispose} has started: what makes it idempotent and safe to re-enter. */
+    /** `true` once {@link dispose} has started: repeated top-level calls are idempotent. */
     private _disposeStarted;
     /**
-     * End the world's life: destroy every entity the application and its modules created, so the
+     * End the world's life: destroy application entities, then all world infrastructure, so the
      * `remove` hooks of the components they carry release what those components own (render
      * objects, handles, timers). Call it when the world is finished — a scene or route change, a
      * hot reload — and drop the reference afterwards.
      *
-     * Each entity goes through the ordinary destroy path, as if it had received
-     * {@link Entity.destroy}: every component's `remove` hook fires exactly once, cleanup policies
-     * and relationship cascades (`ChildOf`, `OwnedTarget`, `CleanupPolicy.Delete`) run as they
-     * always do, and an entity a cascade or a hook has already destroyed is skipped, never
-     * destroyed twice.
-     *
-     * ## What stays
-     *
-     * The infrastructure the world needs to stay coherent is not destroyed:
-     *
-     * - component and module entities (every {@link Component}),
-     * - the entities behind queries and systems (they carry the {@link Query} component), and
-     * - phase entities (they carry the {@link Phase} component).
-     *
-     * What those entities hold stays too: data stored on a component entity (a singleton set with
-     * {@link set}) and any entity they still carry as a component key, which cannot be destroyed
-     * while it is in use. Release such data yourself. {@link clearAllEntities} is the full wipe,
-     * infrastructure included.
+     * Both passes use the existing entity destroy path and fire every component's
+     * `remove` hook exactly once. Application cleanup retains ordinary cleanup policies
+     * and cascades. Infrastructure teardown suspends cleanup policies: it removes a
+     * component from remaining carriers instead of throwing or deleting them, and
+     * destroys children explicitly rather than through ChildOf/OwnedTarget cascades.
      *
      * ## Order
      *
-     * No order is specified among unrelated entities, so do not make a hook depend on one. The one
-     * guarantee is that an entity used as a component key is destroyed after every entity that
-     * carries it, because destroying it earlier would throw under the default cleanup policy.
+     * Queued application cleanup finishes before infrastructure teardown starts. Systems and
+     * queries go first in the infrastructure pass, then modules in reverse registration
+     * order, then the rest. Beyond these priorities the order is unspecified, not a
+     * resource dependency contract. Infrastructure carrier cycles are stripped, not
+     * reported as survivors. Nothing remains after successful disposal.
+     * {@link clearAllEntities} retains its own throwing behavior.
      *
-     * ## Pending commands
+     * ## Call site
      *
-     * Commands queued by an enclosing deferred scope are neither flushed early nor discarded: they
-     * run first, in order, and the destruction follows them in the same queue, so a hook still fires
-     * once per component instance however it was removed. An entity whose creation is still queued
-     * is created, then destroyed. At top level nothing is queued and `dispose()` returns with the
-     * application's entities gone. Called from a system, a hook or a {@link defer} block, it queues
-     * the destruction like any `destroy()` in that situation, and the destruction completes when
-     * the queue next drains: right after the running system, or at the end of the `defer` block.
+     * Call synchronously at top level: not inside {@link progress}, {@link defer}, a command drain
+     * or an entity's destroy. A refused call throws before teardown starts, leaving the world
+     * usable; call again after the enclosing operation finishes. Ordinary synchronous top-level
+     * `add`, `set` and `remove` hooks may call it. Cleanup and commands created by teardown hooks
+     * settle before this call returns.
      *
      * ## After disposal
      *
      * A disposed world must not be used again. Nothing enforces it — no other method checks, so
-     * `entity()` and `progress()` stay as cheap as ever — but the world has no application state
-     * left to run on. Calling `dispose()` again, from a hook included, does nothing. A hook that
-     * creates entities while the world is being disposed leaves them behind. A system's `exit`
-     * callback only queues its event, and a disposed world never runs the system again, so release
-     * resources in `remove` hooks, which fire during the call. A hook that throws propagates out of
+     * mutations have no disposal guard — but the world has no state left to run on. Calling
+     * `dispose()` again at top level does nothing. The call-site rule still applies during teardown.
+     * Do not create entities indefinitely from teardown hooks: the final pass repeats while it can
+     * destroy more entities. Release resources in `remove` hooks, not system `exit` callbacks,
+     * which will not run after teardown. A hook that throws propagates out of
      * the call and leaves the world partial, as it does from any destroy: treat it as a programming
      * error.
+     *
+     * @throws An `Error` for a forbidden call site before any disposal mutation,
+     * an internal-invariant error if infrastructure teardown makes no progress,
+     * or an error propagated by a teardown hook. The latter errors leave the world partial.
      */
     dispose(this: World): void;
+    /**
+     * Validate the disposal call site before teardown changes any state.
+     * Subclasses overriding {@link dispose} must call this before starting their own cleanup.
+     * @throws An `Error` inside a frame, deferred scope, command drain or entity destroy.
+     */
+    protected _assertDisposalAllowed(): void;
     /**
      * The entities {@link dispose} destroys, in an order that lets every destroy succeed: those the
      * application created, with each one used as a component key after its carriers.

package/dist/world/world.disposal.js

@@ -1,6 +1,8 @@
 import { Component } from "../component.js";
 import { Phase } from "../modules/pipeline.js";
 import { Query } from "../query/index.js";
+import { Module } from "../module.js";
+import { carriersFirst } from "./destroy-order.js";
 import { Transfers } from "./world.transfers.js";
 /**
  * World teardown. It is a layer of its own rather than a method of `World`, because the layers
@@ -10,73 +12,117 @@ import { Transfers } from "./world.transfers.js";
 export class Disposal extends Transfers {
     constructor() {
         super(...arguments);
-        /** `true` once {@link dispose} has started: what makes it idempotent and safe to re-enter. */
+        /** `true` once {@link dispose} has started: repeated top-level calls are idempotent. */
         this._disposeStarted = false;
     }
     /**
-     * End the world's life: destroy every entity the application and its modules created, so the
+     * End the world's life: destroy application entities, then all world infrastructure, so the
      * `remove` hooks of the components they carry release what those components own (render
      * objects, handles, timers). Call it when the world is finished — a scene or route change, a
      * hot reload — and drop the reference afterwards.
      *
-     * Each entity goes through the ordinary destroy path, as if it had received
-     * {@link Entity.destroy}: every component's `remove` hook fires exactly once, cleanup policies
-     * and relationship cascades (`ChildOf`, `OwnedTarget`, `CleanupPolicy.Delete`) run as they
-     * always do, and an entity a cascade or a hook has already destroyed is skipped, never
-     * destroyed twice.
-     *
-     * ## What stays
-     *
-     * The infrastructure the world needs to stay coherent is not destroyed:
-     *
-     * - component and module entities (every {@link Component}),
-     * - the entities behind queries and systems (they carry the {@link Query} component), and
-     * - phase entities (they carry the {@link Phase} component).
-     *
-     * What those entities hold stays too: data stored on a component entity (a singleton set with
-     * {@link set}) and any entity they still carry as a component key, which cannot be destroyed
-     * while it is in use. Release such data yourself. {@link clearAllEntities} is the full wipe,
-     * infrastructure included.
+     * Both passes use the existing entity destroy path and fire every component's
+     * `remove` hook exactly once. Application cleanup retains ordinary cleanup policies
+     * and cascades. Infrastructure teardown suspends cleanup policies: it removes a
+     * component from remaining carriers instead of throwing or deleting them, and
+     * destroys children explicitly rather than through ChildOf/OwnedTarget cascades.
      *
      * ## Order
      *
-     * No order is specified among unrelated entities, so do not make a hook depend on one. The one
-     * guarantee is that an entity used as a component key is destroyed after every entity that
-     * carries it, because destroying it earlier would throw under the default cleanup policy.
+     * Queued application cleanup finishes before infrastructure teardown starts. Systems and
+     * queries go first in the infrastructure pass, then modules in reverse registration
+     * order, then the rest. Beyond these priorities the order is unspecified, not a
+     * resource dependency contract. Infrastructure carrier cycles are stripped, not
+     * reported as survivors. Nothing remains after successful disposal.
+     * {@link clearAllEntities} retains its own throwing behavior.
      *
-     * ## Pending commands
+     * ## Call site
      *
-     * Commands queued by an enclosing deferred scope are neither flushed early nor discarded: they
-     * run first, in order, and the destruction follows them in the same queue, so a hook still fires
-     * once per component instance however it was removed. An entity whose creation is still queued
-     * is created, then destroyed. At top level nothing is queued and `dispose()` returns with the
-     * application's entities gone. Called from a system, a hook or a {@link defer} block, it queues
-     * the destruction like any `destroy()` in that situation, and the destruction completes when
-     * the queue next drains: right after the running system, or at the end of the `defer` block.
+     * Call synchronously at top level: not inside {@link progress}, {@link defer}, a command drain
+     * or an entity's destroy. A refused call throws before teardown starts, leaving the world
+     * usable; call again after the enclosing operation finishes. Ordinary synchronous top-level
+     * `add`, `set` and `remove` hooks may call it. Cleanup and commands created by teardown hooks
+     * settle before this call returns.
      *
      * ## After disposal
      *
      * A disposed world must not be used again. Nothing enforces it — no other method checks, so
-     * `entity()` and `progress()` stay as cheap as ever — but the world has no application state
-     * left to run on. Calling `dispose()` again, from a hook included, does nothing. A hook that
-     * creates entities while the world is being disposed leaves them behind. A system's `exit`
-     * callback only queues its event, and a disposed world never runs the system again, so release
-     * resources in `remove` hooks, which fire during the call. A hook that throws propagates out of
+     * mutations have no disposal guard — but the world has no state left to run on. Calling
+     * `dispose()` again at top level does nothing. The call-site rule still applies during teardown.
+     * Do not create entities indefinitely from teardown hooks: the final pass repeats while it can
+     * destroy more entities. Release resources in `remove` hooks, not system `exit` callbacks,
+     * which will not run after teardown. A hook that throws propagates out of
      * the call and leaves the world partial, as it does from any destroy: treat it as a programming
      * error.
+     *
+     * @throws An `Error` for a forbidden call site before any disposal mutation,
+     * an internal-invariant error if infrastructure teardown makes no progress,
+     * or an error propagated by a teardown hook. The latter errors leave the world partial.
      */
     dispose() {
+        this._assertDisposalAllowed();
         if (this._disposeStarted) {
             return;
         }
         this._disposeStarted = true;
-        // The destroys are queued commands, as `Entity.destroy()` makes them in a deferred scope, so a
-        // queue that is already filling runs ahead of them. At top level this scope drains them now.
-        this.defer(() => {
-            for (const entity of this._destroyOrder()) {
-                this._enqueue({ kind: 4 /* CommandKind.Destroy */, entity });
+        // Settle application hooks and any entities they create before removing infrastructure.
+        let applications = this._destroyOrder();
+        while (applications.length > 0) {
+            this.defer(() => {
+                for (const entity of applications) {
+                    this._enqueue({ kind: 4 /* CommandKind.Destroy */, entity });
+                }
+            });
+            applications = this._destroyOrder();
+        }
+        this._tearingDownInfrastructure = true;
+        try {
+            while (this._entities.size > 0) {
+                const entities = this._entities.values().filter((entity) => !entity.destroyed);
+                // The class registry is insertion-ordered; the dense entity map swaps entries on deletion.
+                const modules = [...this._classRegistry.values()]
+                    .filter((entity) => entity instanceof Module && !entity.destroyed)
+                    .reverse();
+                const queryEid = this.getEntity(Query)?.eid;
+                const queries = entities.filter((entity) => queryEid !== undefined && entity.has(queryEid));
+                const priority = new Set([...queries, ...modules]);
+                const ordered = [
+                    ...queries,
+                    ...modules,
+                    ...entities.filter((entity) => !priority.has(entity)),
+                ];
+                let destroyed = 0;
+                for (const entity of ordered) {
+                    if (!entity.destroyed) {
+                        entity._destroy();
+                        if (entity.destroyed) {
+                            destroyed++;
+                        }
+                        this.flush();
+                    }
+                }
+                this.flush();
+                if (destroyed === 0 && this._entities.size > 0) {
+                    throw new Error(`Internal invariant: infrastructure teardown made no progress; registered entities: ${this._entities
+                        .values()
+                        .map((entity) => `${entity.eid} (${entity.meta.Class.name}, destroyed=${entity.destroyed})`)
+                        .join(", ")}`);
+                }
             }
-        });
+        }
+        finally {
+            this._tearingDownInfrastructure = false;
+        }
+    }
+    /**
+     * Validate the disposal call site before teardown changes any state.
+     * Subclasses overriding {@link dispose} must call this before starting their own cleanup.
+     * @throws An `Error` inside a frame, deferred scope, command drain or entity destroy.
+     */
+    _assertDisposalAllowed() {
+        if (this.deferred || this._frameInProgress || this._deletionScope) {
+            throw new Error("dispose() must be called outside progress(), defer, a command drain or an entity's destroy");
+        }
     }
     /**
      * The entities {@link dispose} destroys, in an order that lets every destroy succeed: those the
@@ -89,58 +135,7 @@ export class Disposal extends Transfers {
         const isInfrastructure = (entity) => entity instanceof Component ||
             (queryEid !== undefined && entity.has(queryEid)) ||
             (phaseEid !== undefined && entity.has(phaseEid));
-        const entities = this._entities.values();
-        // In a deferred scope an entity created earlier is only queued, not registered yet. Its
-        // creation runs ahead of the destroy that is queued after it.
-        for (const command of this._commandQueue) {
-            if (command.kind === 0 /* CommandKind.CreateEntity */ &&
-                !command.entity.destroyed &&
-                this._entities.get(command.entity.eid) !== command.entity) {
-                entities.push(command.entity);
-            }
-        }
-        return carriersFirst(entities.filter((entity) => !isInfrastructure(entity)), isInfrastructure);
-    }
-}
-/**
- * Order `entities` so that an entity used as a component key follows every entity that carries it.
- *
- * A key destroyed while still carried throws under the default cleanup policy, so carriers go
- * first. A key that something outside `entities` carries, which is infrastructure in practice, or
- * that is caught in a cycle, cannot be ordered and is left out: destroying it would throw or strip
- * the infrastructure.
- */
-function carriersFirst(entities, isInfrastructure) {
-    const ordered = [];
-    const keys = new Set();
-    for (const entity of entities) {
-        if (entity.instanceCount() === 0) {
-            ordered.push(entity);
-        }
-        else {
-            keys.add(entity);
-        }
-    }
-    let progressed = keys.size > 0;
-    while (progressed) {
-        progressed = false;
-        for (const key of keys) {
-            if (!isCarried(key, keys, isInfrastructure)) {
-                ordered.push(key);
-                keys.delete(key);
-                progressed = true;
-            }
-        }
-    }
-    return ordered;
-}
-/** Whether `key` is still carried by another key that waits to be ordered, or by infrastructure. */
-function isCarried(key, waiting, isInfrastructure) {
-    for (const carrier of key.meta._carriers ?? []) {
-        if (carrier !== key && (waiting.has(carrier) || isInfrastructure(carrier))) {
-            return true;
-        }
+        return carriersFirst(this._entities.values().filter((entity) => !entity.destroyed && !isInfrastructure(entity)));
     }
-    return false;
 }
 //# sourceMappingURL=world.disposal.js.map

package/dist/world/world.disposal.js.map

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

package/dist/world/world.entities.d.ts

@@ -31,6 +31,26 @@ export declare class Entities extends Deferred {
      * A foreign `Entity` ref throws (see {@link getEntity}).
      */
     entity(this: World, ref: ComponentRef): Entity;
-    /** Destroy every entity currently tracked by the world. */
+    /**
+     * Destroy every tracked entity, ordering both carriers and ChildOf children
+     * before their keys/parents. Retains ordinary cleanup policies; throws when
+     * dependency cycles prevent safe destruction (unlike dispose's final pass).
+     */
     clearAllEntities(): void;
+    /**
+     * Parent entities created synchronously in `fn`'s body to `parent` through ChildOf.
+     * Includes components, modules, queries, systems and ordinary entities. Existing
+     * lookups are not reparented; an explicit childOf call replaces the scope parent.
+     * Nested scopes restore their caller in finally, even when fn throws.
+     * Entities created by deferred callbacks inside the body are not parented:
+     * query.forEach, enter backfill during query build, or an explicit world.defer.
+     * These are run-time data; the same callback outside the scope would not parent
+     * them either. For example, health bars created per existing ship by an enter
+     * or forEach callback remain roots, unlike definitions created directly in init.
+     * Throws while deferred: call outside progress() and defer, not during a command
+     * drain. Schedule lazy module loading after progress() returns.
+     * The parent must be a live entity of this world. This is a synchronous scope,
+     * not an async context; it does not change deferral or catch callback errors.
+     */
+    scope(this: World, parent: Entity, fn: () => void): void;
 }