@codexo/exojs 0.13.0 → 0.15.0

package/dist/esm/core/Perf.js

@@ -1,13 +1,14 @@
 // Thin wrappers around the User Timing API (performance.mark /
-// performance.measure). All calls are guarded against environments where
-// `performance` or individual User Timing methods are unavailable (e.g.
-// some jsdom configurations, older browsers), so they are always safe to call.
+// performance.measure), grouped under the `Perf` namespace. All calls are
+// guarded against environments where `performance` or individual User Timing
+// methods are unavailable (e.g. some jsdom configurations, older browsers), so
+// they are always safe to call.
 const hasPerf = typeof performance !== 'undefined';
 /**
  * Emit a named `PerformanceMark` at the current instant.
  * No-op when the User Timing API is unavailable.
  */
-const perfMark = (name) => {
+const mark = (name) => {
     if (hasPerf && typeof performance.mark === 'function')
         performance.mark(name);
 };
@@ -18,7 +19,7 @@ const perfMark = (name) => {
  * - Returns the created `PerformanceMeasure`, or `undefined` if the API is
  *   unavailable or either mark was never emitted.
  */
-const perfMeasure = (name, startMark, endMark) => {
+const measure = (name, startMark, endMark) => {
     if (!hasPerf || typeof performance.measure !== 'function')
         return undefined;
     try {
@@ -32,7 +33,7 @@ const perfMeasure = (name, startMark, endMark) => {
  * Remove all marks with the given name, or all marks when `name` is omitted.
  * No-op when the User Timing API is unavailable.
  */
-const perfClearMarks = (name) => {
+const clearMarks = (name) => {
     if (hasPerf && typeof performance.clearMarks === 'function')
         performance.clearMarks(name);
 };
@@ -40,10 +41,16 @@ const perfClearMarks = (name) => {
  * Remove all measures with the given name, or all measures when `name` is omitted.
  * No-op when the User Timing API is unavailable.
  */
-const perfClearMeasures = (name) => {
+const clearMeasures = (name) => {
     if (hasPerf && typeof performance.clearMeasures === 'function')
         performance.clearMeasures(name);
 };
+/**
+ * User Timing helpers (`performance.mark`/`measure`), grouped as a namespace so
+ * the public API carries no loose `perf*` functions. All methods are safe no-ops
+ * where the User Timing API is unavailable.
+ */
+const Perf = { mark, measure, clearMarks, clearMeasures };
 
-export { perfClearMarks, perfClearMeasures, perfMark, perfMeasure };
+export { Perf };
 //# sourceMappingURL=Perf.js.map

package/dist/esm/core/Perf.js.map

@@ -1 +1 @@
-{"version":3,"file":"Perf.js","sources":["../../../../src/core/Perf.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AAEA,MAAM,OAAO,GAAG,OAAO,WAAW,KAAK,WAAW;AAElD;;;AAGG;AACI,MAAM,QAAQ,GAAG,CAAC,IAAY,KAAU;AAC7C,IAAA,IAAI,OAAO,IAAI,OAAO,WAAW,CAAC,IAAI,KAAK,UAAU;AAAE,QAAA,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;AAC/E;AAEA;;;;;;AAMG;AACI,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,SAAiB,EAAE,OAAgB,KAAoC;IAC/G,IAAI,CAAC,OAAO,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,UAAU;AAAE,QAAA,OAAO,SAAS;AAC3E,IAAA,IAAI;QACF,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC;IACtD;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,SAAS;IAClB;AACF;AAEA;;;AAGG;AACI,MAAM,cAAc,GAAG,CAAC,IAAa,KAAU;AACpD,IAAA,IAAI,OAAO,IAAI,OAAO,WAAW,CAAC,UAAU,KAAK,UAAU;AAAE,QAAA,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC;AAC3F;AAEA;;;AAGG;AACI,MAAM,iBAAiB,GAAG,CAAC,IAAa,KAAU;AACvD,IAAA,IAAI,OAAO,IAAI,OAAO,WAAW,CAAC,aAAa,KAAK,UAAU;AAAE,QAAA,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC;AACjG;;;;"}
+{"version":3,"file":"Perf.js","sources":["../../../../src/core/Perf.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AAEA,MAAM,OAAO,GAAG,OAAO,WAAW,KAAK,WAAW;AAElD;;;AAGG;AACH,MAAM,IAAI,GAAG,CAAC,IAAY,KAAU;AAClC,IAAA,IAAI,OAAO,IAAI,OAAO,WAAW,CAAC,IAAI,KAAK,UAAU;AAAE,QAAA,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;AAC/E,CAAC;AAED;;;;;;AAMG;AACH,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,SAAiB,EAAE,OAAgB,KAAoC;IACpG,IAAI,CAAC,OAAO,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,UAAU;AAAE,QAAA,OAAO,SAAS;AAC3E,IAAA,IAAI;QACF,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC;IACtD;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,SAAS;IAClB;AACF,CAAC;AAED;;;AAGG;AACH,MAAM,UAAU,GAAG,CAAC,IAAa,KAAU;AACzC,IAAA,IAAI,OAAO,IAAI,OAAO,WAAW,CAAC,UAAU,KAAK,UAAU;AAAE,QAAA,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC;AAC3F,CAAC;AAED;;;AAGG;AACH,MAAM,aAAa,GAAG,CAAC,IAAa,KAAU;AAC5C,IAAA,IAAI,OAAO,IAAI,OAAO,WAAW,CAAC,aAAa,KAAK,UAAU;AAAE,QAAA,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC;AACjG,CAAC;AAED;;;;AAIG;AACI,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa;;;;"}

package/dist/esm/core/Registry.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Options for a {@link Registry}.
+ *
+ * @typeParam Key - lookup key, typically a constructor token.
+ * @typeParam Value - stored value.
+ * @internal
+ */
+export interface RegistryOptions<Key, Value> {
+    /**
+     * Resolution walker. Given a key with no direct entry, returns the next key
+     * to try (e.g. the prototype-chain parent), or `null` to stop. Omit for
+     * exact-match-only lookup.
+     */
+    walk?: (key: Key) => Key | null;
+    /**
+     * Per-value disposer, invoked once per **unique** value during
+     * {@link Registry.destroy}. Values shared across several keys (e.g. one
+     * renderer bound to multiple drawable types) are disposed exactly once.
+     */
+    dispose?: (value: Value) => void;
+}
+/**
+ * Generic key→value store with inheritance-aware resolution.
+ *
+ * Backs the engine's constructor-keyed dispatch registries
+ * ({@link FactoryRegistry}, {@link RendererRegistry}). Both previously
+ * duplicated the same prototype-chain walk and destroy-time de-duplication;
+ * this primitive owns that shared mechanism.
+ *
+ * Conflict policy and error messaging stay with the caller: {@link Registry.set}
+ * always overwrites and {@link Registry.resolve} returns `undefined` on a miss,
+ * so each owner enforces its own throw/overwrite behaviour with a
+ * domain-specific message.
+ *
+ * @typeParam Key - lookup key, typically a constructor token.
+ * @typeParam Value - stored value; must never be `undefined`.
+ * @internal
+ */
+export declare class Registry<Key, Value> {
+    private readonly _entries;
+    private readonly _walk;
+    private readonly _dispose;
+    constructor(options?: RegistryOptions<Key, Value>);
+    /** Stores `value` under `key`, overwriting any existing entry. */
+    set(key: Key, value: Value): void;
+    /** Returns `true` if `key` has a direct entry (no walk). */
+    hasOwn(key: Key): boolean;
+    /** Returns `true` if `key` or any of its walk-ancestors has an entry. */
+    has(key: Key): boolean;
+    /**
+     * Returns the value for `key`, walking the key hierarchy on a direct miss.
+     * Returns `undefined` if neither `key` nor any ancestor matches.
+     */
+    resolve(key: Key): Value | undefined;
+    /** Iterates every stored value (including duplicates from shared entries). */
+    values(): IterableIterator<Value>;
+    /**
+     * Disposes every unique value (if a disposer was configured) and clears the
+     * store.
+     */
+    destroy(): void;
+    private _find;
+}
+//# sourceMappingURL=Registry.d.ts.map

package/dist/esm/core/Registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Registry.d.ts","sourceRoot":"","sources":["../../../src/core/Registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,eAAe,CAAC,GAAG,EAAE,KAAK;IACzC;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,GAAG,IAAI,CAAC;IAEhC;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,QAAQ,CAAC,GAAG,EAAE,KAAK;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAC1D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;gBAExC,OAAO,GAAE,eAAe,CAAC,GAAG,EAAE,KAAK,CAAM;IAK5D,kEAAkE;IAC3D,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAIxC,4DAA4D;IACrD,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO;IAIhC,yEAAyE;IAClE,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO;IAI7B;;;OAGG;IACI,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,KAAK,GAAG,SAAS;IAI3C,8EAA8E;IACvE,MAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC;IAIxC;;;OAGG;IACI,OAAO,IAAI,IAAI;IAetB,OAAO,CAAC,KAAK;CAcd"}

package/dist/esm/core/Registry.js

@@ -0,0 +1,79 @@
+/**
+ * Generic key→value store with inheritance-aware resolution.
+ *
+ * Backs the engine's constructor-keyed dispatch registries
+ * ({@link FactoryRegistry}, {@link RendererRegistry}). Both previously
+ * duplicated the same prototype-chain walk and destroy-time de-duplication;
+ * this primitive owns that shared mechanism.
+ *
+ * Conflict policy and error messaging stay with the caller: {@link Registry.set}
+ * always overwrites and {@link Registry.resolve} returns `undefined` on a miss,
+ * so each owner enforces its own throw/overwrite behaviour with a
+ * domain-specific message.
+ *
+ * @typeParam Key - lookup key, typically a constructor token.
+ * @typeParam Value - stored value; must never be `undefined`.
+ * @internal
+ */
+class Registry {
+    _entries = new Map();
+    _walk;
+    _dispose;
+    constructor(options = {}) {
+        this._walk = options.walk ?? null;
+        this._dispose = options.dispose ?? null;
+    }
+    /** Stores `value` under `key`, overwriting any existing entry. */
+    set(key, value) {
+        this._entries.set(key, value);
+    }
+    /** Returns `true` if `key` has a direct entry (no walk). */
+    hasOwn(key) {
+        return this._entries.has(key);
+    }
+    /** Returns `true` if `key` or any of its walk-ancestors has an entry. */
+    has(key) {
+        return this._find(key) !== undefined;
+    }
+    /**
+     * Returns the value for `key`, walking the key hierarchy on a direct miss.
+     * Returns `undefined` if neither `key` nor any ancestor matches.
+     */
+    resolve(key) {
+        return this._find(key);
+    }
+    /** Iterates every stored value (including duplicates from shared entries). */
+    values() {
+        return this._entries.values();
+    }
+    /**
+     * Disposes every unique value (if a disposer was configured) and clears the
+     * store.
+     */
+    destroy() {
+        if (this._dispose !== null) {
+            const seen = new Set();
+            for (const value of this._entries.values()) {
+                if (!seen.has(value)) {
+                    seen.add(value);
+                    this._dispose(value);
+                }
+            }
+        }
+        this._entries.clear();
+    }
+    _find(key) {
+        let current = key;
+        let value;
+        while (current !== null && value === undefined) {
+            value = this._entries.get(current);
+            if (value === undefined) {
+                current = this._walk !== null ? this._walk(current) : null;
+            }
+        }
+        return value;
+    }
+}
+
+export { Registry };
+//# sourceMappingURL=Registry.js.map

package/dist/esm/core/Registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Registry.js","sources":["../../../../src/core/Registry.ts"],"sourcesContent":[null],"names":[],"mappings":"AAuBA;;;;;;;;;;;;;;;;AAgBG;MACU,QAAQ,CAAA;AACF,IAAA,QAAQ,GAAG,IAAI,GAAG,EAAc;AAChC,IAAA,KAAK;AACL,IAAA,QAAQ;AAEzB,IAAA,WAAA,CAAmB,UAAuC,EAAE,EAAA;QAC1D,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI;QACjC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI;IACzC;;IAGO,GAAG,CAAC,GAAQ,EAAE,KAAY,EAAA;QAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC;IAC/B;;AAGO,IAAA,MAAM,CAAC,GAAQ,EAAA;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;IAC/B;;AAGO,IAAA,GAAG,CAAC,GAAQ,EAAA;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS;IACtC;AAEA;;;AAGG;AACI,IAAA,OAAO,CAAC,GAAQ,EAAA;AACrB,QAAA,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;IACxB;;IAGO,MAAM,GAAA;AACX,QAAA,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;IAC/B;AAEA;;;AAGG;IACI,OAAO,GAAA;AACZ,QAAA,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE;AAC1B,YAAA,MAAM,IAAI,GAAG,IAAI,GAAG,EAAS;YAE7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE;gBAC1C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;AACpB,oBAAA,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;AACf,oBAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBACtB;YACF;QACF;AAEA,QAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;IACvB;AAEQ,IAAA,KAAK,CAAC,GAAQ,EAAA;QACpB,IAAI,OAAO,GAAe,GAAG;AAC7B,QAAA,IAAI,KAAwB;QAE5B,OAAO,OAAO,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE;YAC9C,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;AAElC,YAAA,IAAI,KAAK,KAAK,SAAS,EAAE;AACvB,gBAAA,OAAO,GAAG,IAAI,CAAC,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI;YAC5D;QACF;AAEA,QAAA,OAAO,KAAK;IACd;AACD;;;;"}

package/dist/esm/core/Scene.d.ts

@@ -4,13 +4,18 @@ import { Container } from '#rendering/Container';
 import type { RenderingContext } from '#rendering/RenderingContext';
 import type { RenderNode } from '#rendering/RenderNode';
 import type { Loader } from '#resources/Loader';
+import { UIRoot } from '#ui/UIRoot';
 import type { Application } from './Application';
+import { type SerializedScene } from './serialization/types';
+import { Signal } from './Signal';
+import { SystemRegistry } from './SystemRegistry';
 import type { Time } from './Time';
+import type { Destroyable } from './types';
 /**
  * Scene-bound input proxy. Bindings created here are automatically unbound
  * when the owning scene is destroyed. Access via {@link Scene.inputs}.
  */
-declare class SceneInputs {
+declare class SceneInputs implements Destroyable {
     private readonly _scene;
     private readonly _bindings;
     constructor(_scene: Scene);
@@ -18,33 +23,20 @@ declare class SceneInputs {
     onActive(channel: InputChannel | readonly InputChannel[], callback: (value: number) => void, options?: InputBindingOptions): InputBinding;
     onStop(channel: InputChannel | readonly InputChannel[], callback: (value: number) => void, options?: InputBindingOptions): InputBinding;
     onTrigger(channel: InputChannel | readonly InputChannel[], callback: (value: number) => void, options?: InputBindingOptions): InputBinding;
-    /** @internal */
-    _disposeAll(): void;
+    destroy(): void;
     private _track;
 }
 /**
  * Scene-bound tween proxy. Tweens created or added here are automatically
  * stopped when the owning scene is destroyed. Access via {@link Scene.tweens}.
  */
-declare class SceneTweens {
+declare class SceneTweens implements Destroyable {
     private readonly _scene;
     private readonly _tweens;
     constructor(_scene: Scene);
     create<T extends object>(target: T): Tween<T>;
     add(tween: Tween): this;
-    /** @internal */
-    _disposeAll(): void;
-}
-/**
- * How a {@link Scene} composes with scenes already on the stack.
- * - `'overlay'`: render on top, scenes below also render and update.
- * - `'modal'`: render on top, scenes below render but do not update.
- * - `'opaque'`: render on top, scenes below neither render nor update.
- */
-export type SceneStackMode = 'overlay' | 'modal' | 'opaque';
-/** Bag of overrides for {@link Scene.setParticipationPolicy}. */
-export interface SceneParticipationPolicy {
-    mode?: SceneStackMode;
+    destroy(): void;
 }
 /**
  * A scene's lifecycle host. Subclass to define scene behavior:
@@ -68,9 +60,20 @@ export interface SceneParticipationPolicy {
 export declare class Scene {
     protected _app: Application | null;
     protected readonly _root: Container;
-    protected _stackMode: SceneStackMode;
+    /**
+     * When `true`, the scene's `update` and systems are skipped each frame while
+     * it keeps drawing — the simple way to freeze gameplay behind a pause menu
+     * (show a panel on `scene.ui`, then set `scene.paused = true`).
+     */
+    paused: boolean;
+    /** Dispatched after the scene finishes loading (after load() and init() complete). */
+    readonly onLoad: Signal<[]>;
+    /** Dispatched when the scene is about to be unloaded. */
+    readonly onUnload: Signal<[]>;
     private _inputs;
     private _tweens;
+    private _systems;
+    private readonly _disposal;
     get app(): Application | null;
     set app(app: Application | null);
     /**
@@ -103,11 +106,61 @@ export declare class Scene {
      * Throws if accessed before the scene is attached to an {@link Application}.
      */
     get tweens(): SceneTweens;
-    get stackMode(): SceneStackMode;
-    set stackMode(mode: SceneStackMode);
+    /**
+     * Register a {@link Destroyable} to be destroyed automatically when this
+     * scene is destroyed (reverse registration order). Returns its argument for
+     * fluent capture: `const world = this.track(new PhysicsWorld())`. The
+     * scene-bound `tweens` and `inputs` registries are tracked the same way.
+     */
+    track<T extends Destroyable>(item: T): T;
+    /**
+     * Scene-bound system registry. Add tickable {@link System}s (e.g. a physics
+     * world) via `this.systems.add(world)`; each is updated once per frame after
+     * {@link Scene.update} (ascending `order`) and destroyed with the scene — no
+     * manual `step()` / `destroy()` wiring. Available before the scene is
+     * attached to an Application (systems tick only while the scene is active).
+     */
+    get systems(): SystemRegistry;
+    /** @internal — called by {@link SceneManager} each frame after `update`. */
+    _tickSystems(delta: Time): void;
+    private _ui;
+    /**
+     * Scene-bound UI layer, rendered screen-fixed on top of the scene content
+     * (after {@link Scene.draw}). Lazily created and destroyed with the scene;
+     * add widgets via `this.ui.addChild(...)`.
+     *
+     * Unlike {@link Scene.root}, the UI layer **is** auto-rendered each frame — a
+     * first-class overlay that always sits above the world. Its children live in
+     * screen space (origin top-left, `0..width` × `0..height`); pointer and
+     * keyboard input route to them ahead of the world layer.
+     */
+    get ui(): UIRoot;
+    /** @internal — the UI layer if materialized, else `null` (no lazy allocation). */
+    _peekUI(): UIRoot | null;
     addChild(child: RenderNode): this;
     removeChild(child: RenderNode): this;
-    setParticipationPolicy(policy: SceneParticipationPolicy): this;
+    /**
+     * Serialize this scene's structural root subtree to a plain, JSON-able
+     * {@link SerializedScene} descriptor.
+     *
+     * Captures **data, not behaviour**: structure, transforms, visuals and asset
+     * references — never update logic, signal handlers, tweens or systems. When
+     * the scene is attached to an {@link Application}, texture/asset references
+     * resolve to their {@link Loader} source keys. Reattach behaviour in code
+     * after {@link Scene.deserialize}.
+     */
+    serialize(): SerializedScene;
+    /**
+     * Rebuild this scene's root subtree from a {@link SerializedScene} produced
+     * by {@link Scene.serialize}. Existing root children are removed first, then
+     * the descriptor's children are reconstructed under {@link Scene.root}.
+     *
+     * Assets referenced by the data must already be loaded into the
+     * application's {@link Loader} (pre-load contract). Older documents are
+     * migrated to the current format; documents newer than the running engine
+     * throw. Returns `this`.
+     */
+    deserialize(data: SerializedScene): this;
     /**
      * Async asset preload hook. Called once before {@link Scene.init} the
      * first time the scene is pushed. Use the loader to register and
@@ -127,6 +180,15 @@ export declare class Scene {
      * positions, advance timers, drive AI here. Override in subclass.
      */
     update(_delta: Time): void;
+    /**
+     * Fixed-timestep logic hook. Called zero or more times per frame with a
+     * constant `delta` ({@link Application.fixedTimeStep}) before {@link Scene.update},
+     * so physics and deterministic gameplay advance at a frame-rate-independent
+     * rate. Put `physicsWorld.step(delta)` and movement here; leave camera, UI and
+     * purely visual work in {@link Scene.update}. Default is a no-op. Override in
+     * subclass.
+     */
+    fixedUpdate(_delta: Time): void;
     /**
      * Explicit per-frame rendering entry point. Override to choose
      * what gets rendered.

package/dist/esm/core/Scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Scene.d.ts","sourceRoot":"","sources":["../../../src/core/Scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC;;;GAGG;AACH,cAAM,WAAW;IAGI,OAAO,CAAC,QAAQ,CAAC,MAAM;IAF1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;gBAEjB,MAAM,EAAE,KAAK;IAE1C,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY;IAIxI,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY;IAIzI,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY;IAIvI,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY;IAIjJ,gBAAgB;IACT,WAAW,IAAI,IAAI;IAQ1B,OAAO,CAAC,MAAM;CAKf;AAED;;;GAGG;AACH,cAAM,WAAW;IAGI,OAAO,CAAC,QAAQ,CAAC,MAAM;IAF1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAER,MAAM,EAAE,KAAK;IAE1C,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAO7C,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAO9B,gBAAgB;IACT,WAAW,IAAI,IAAI;CAO3B;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5D,iEAAiE;AACjE,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,KAAK;IAChB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAQ;IAC1C,SAAS,CAAC,QAAQ,CAAC,KAAK,YAAmB;IAC3C,SAAS,CAAC,UAAU,EAAE,cAAc,CAAa;IACjD,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAA4B;IAE3C,IAAW,GAAG,IAAI,WAAW,GAAG,IAAI,CAEnC;IAED,IAAW,GAAG,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,EAErC;IAED;;;;;;;;;;;;OAYG;IACH,IAAW,IAAI,IAAI,SAAS,CAE3B;IAED;;;;;;OAMG;IACH,IAAW,MAAM,IAAI,WAAW,CAU/B;IAED;;;;;;OAMG;IACH,IAAW,MAAM,IAAI,WAAW,CAU/B;IAED,IAAW,SAAS,IAAI,cAAc,CAErC;IAED,IAAW,SAAS,CAAC,IAAI,EAAE,cAAc,EAExC;IAEM,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAMjC,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAMpC,sBAAsB,CAAC,MAAM,EAAE,wBAAwB,GAAG,IAAI;IAQrE;;;;;OAKG;IACI,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIlD;;;;OAIG;IACI,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIlD;;;;OAIG;IACI,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI;IAIjC;;;;;;;;;;;;;;OAcG;IACI,IAAI,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAI7C;;;;OAIG;IACI,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI7C,OAAO,IAAI,IAAI;CAQvB"}
+{"version":3,"file":"Scene.d.ts","sourceRoot":"","sources":["../../../src/core/Scene.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/Scene.js

@@ -1,4 +1,10 @@
 import { Container } from '../rendering/Container.js';
+import { UIRoot } from '../ui/UIRoot.js';
+import { DisposalScope } from './DisposalScope.js';
+import { serializeTree, migrate, deserializeInto } from './serialization/serialize.js';
+import { SERIALIZATION_VERSION } from './serialization/types.js';
+import { Signal } from './Signal.js';
+import { SystemRegistry } from './SystemRegistry.js';
 
 /**
  * Scene-bound input proxy. Bindings created here are automatically unbound
@@ -22,8 +28,7 @@ class SceneInputs {
     onTrigger(channel, callback, options) {
         return this._track(this._scene.app.input.onTrigger(channel, callback, options));
     }
-    /** @internal */
-    _disposeAll() {
+    destroy() {
         for (const binding of this._bindings) {
             binding.unbind();
         }
@@ -54,8 +59,7 @@ class SceneTweens {
         this._tweens.add(tween);
         return this;
     }
-    /** @internal */
-    _disposeAll() {
+    destroy() {
         for (const tween of this._tweens) {
             tween.stop();
         }
@@ -84,9 +88,20 @@ class SceneTweens {
 class Scene {
     _app = null;
     _root = new Container();
-    _stackMode = 'overlay';
+    /**
+     * When `true`, the scene's `update` and systems are skipped each frame while
+     * it keeps drawing — the simple way to freeze gameplay behind a pause menu
+     * (show a panel on `scene.ui`, then set `scene.paused = true`).
+     */
+    paused = false;
+    /** Dispatched after the scene finishes loading (after load() and init() complete). */
+    onLoad = new Signal();
+    /** Dispatched when the scene is about to be unloaded. */
+    onUnload = new Signal();
     _inputs = null;
     _tweens = null;
+    _systems = null;
+    _disposal = new DisposalScope();
     get app() {
         return this._app;
     }
@@ -121,7 +136,7 @@ class Scene {
             if (this._app === null) {
                 throw new Error('Scene.inputs is unavailable before the scene is attached to an Application.');
             }
-            this._inputs = new SceneInputs(this);
+            this._inputs = this._disposal.track(new SceneInputs(this));
         }
         return this._inputs;
     }
@@ -137,15 +152,62 @@ class Scene {
             if (this._app === null) {
                 throw new Error('Scene.tweens is unavailable before the scene is attached to an Application.');
             }
-            this._tweens = new SceneTweens(this);
+            this._tweens = this._disposal.track(new SceneTweens(this));
         }
         return this._tweens;
     }
-    get stackMode() {
-        return this._stackMode;
+    /**
+     * Register a {@link Destroyable} to be destroyed automatically when this
+     * scene is destroyed (reverse registration order). Returns its argument for
+     * fluent capture: `const world = this.track(new PhysicsWorld())`. The
+     * scene-bound `tweens` and `inputs` registries are tracked the same way.
+     */
+    track(item) {
+        return this._disposal.track(item);
     }
-    set stackMode(mode) {
-        this._stackMode = mode;
+    /**
+     * Scene-bound system registry. Add tickable {@link System}s (e.g. a physics
+     * world) via `this.systems.add(world)`; each is updated once per frame after
+     * {@link Scene.update} (ascending `order`) and destroyed with the scene — no
+     * manual `step()` / `destroy()` wiring. Available before the scene is
+     * attached to an Application (systems tick only while the scene is active).
+     */
+    get systems() {
+        if (this._systems === null) {
+            this._systems = this._disposal.track(new SystemRegistry());
+        }
+        return this._systems;
+    }
+    /** @internal — called by {@link SceneManager} each frame after `update`. */
+    _tickSystems(delta) {
+        this._systems?._tick(delta);
+    }
+    _ui = null;
+    /**
+     * Scene-bound UI layer, rendered screen-fixed on top of the scene content
+     * (after {@link Scene.draw}). Lazily created and destroyed with the scene;
+     * add widgets via `this.ui.addChild(...)`.
+     *
+     * Unlike {@link Scene.root}, the UI layer **is** auto-rendered each frame — a
+     * first-class overlay that always sits above the world. Its children live in
+     * screen space (origin top-left, `0..width` × `0..height`); pointer and
+     * keyboard input route to them ahead of the world layer.
+     */
+    get ui() {
+        if (this._ui === null) {
+            this._ui = this._disposal.track(new UIRoot());
+            // If the scene is already active (its root carries a stage), bind the UI
+            // layer now; otherwise SceneManager attaches it when the scene activates.
+            if (this._root._getStage() !== null) {
+                this._app?.interaction.attachUIRoot(this._ui);
+            }
+        }
+        return this._ui;
+    }
+    /** @internal — the UI layer if materialized, else `null` (no lazy allocation). */
+    // eslint-disable-next-line @typescript-eslint/naming-convention -- UI is an acronym (cf. HTMLText)
+    _peekUI() {
+        return this._ui;
     }
     addChild(child) {
         this._root.addChild(child);
@@ -155,9 +217,43 @@ class Scene {
         this._root.removeChild(child);
         return this;
     }
-    setParticipationPolicy(policy) {
-        if (policy.mode) {
-            this._stackMode = policy.mode;
+    /**
+     * Serialize this scene's structural root subtree to a plain, JSON-able
+     * {@link SerializedScene} descriptor.
+     *
+     * Captures **data, not behaviour**: structure, transforms, visuals and asset
+     * references — never update logic, signal handlers, tweens or systems. When
+     * the scene is attached to an {@link Application}, texture/asset references
+     * resolve to their {@link Loader} source keys. Reattach behaviour in code
+     * after {@link Scene.deserialize}.
+     */
+    serialize() {
+        const loader = this._app?.loader ?? null;
+        const registry = this._app?.serializers;
+        const data = { version: SERIALIZATION_VERSION, root: serializeTree(this._root, loader, registry) };
+        const ui = this._peekUI();
+        if (ui !== null) {
+            data.ui = serializeTree(ui, loader, registry);
+        }
+        return data;
+    }
+    /**
+     * Rebuild this scene's root subtree from a {@link SerializedScene} produced
+     * by {@link Scene.serialize}. Existing root children are removed first, then
+     * the descriptor's children are reconstructed under {@link Scene.root}.
+     *
+     * Assets referenced by the data must already be loaded into the
+     * application's {@link Loader} (pre-load contract). Older documents are
+     * migrated to the current format; documents newer than the running engine
+     * throw. Returns `this`.
+     */
+    deserialize(data) {
+        const migrated = migrate(data);
+        const loader = this._app?.loader ?? null;
+        const registry = this._app?.serializers;
+        deserializeInto(this._root, migrated.root, loader, registry);
+        if (migrated.ui !== undefined) {
+            deserializeInto(this.ui, migrated.ui, loader, registry);
         }
         return this;
     }
@@ -186,6 +282,17 @@ class Scene {
     update(_delta) {
         // override in subclass
     }
+    /**
+     * Fixed-timestep logic hook. Called zero or more times per frame with a
+     * constant `delta` ({@link Application.fixedTimeStep}) before {@link Scene.update},
+     * so physics and deterministic gameplay advance at a frame-rate-independent
+     * rate. Put `physicsWorld.step(delta)` and movement here; leave camera, UI and
+     * purely visual work in {@link Scene.update}. Default is a no-op. Override in
+     * subclass.
+     */
+    fixedUpdate(_delta) {
+        // override in subclass
+    }
     /**
      * Explicit per-frame rendering entry point. Override to choose
      * what gets rendered.
@@ -213,10 +320,14 @@ class Scene {
         // override in subclass
     }
     destroy() {
-        this._inputs?._disposeAll();
+        // Destroys everything tracked (scene-bound tweens/inputs + user-tracked
+        // resources) in reverse registration order, then the scene-graph root.
+        this._disposal.destroy();
         this._inputs = null;
-        this._tweens?._disposeAll();
         this._tweens = null;
+        this._systems = null;
+        this.onLoad.destroy();
+        this.onUnload.destroy();
         this._root.destroy();
         this._app = null;
     }

package/dist/esm/core/Scene.js.map

@@ -1 +1 @@
-{"version":3,"file":"Scene.js","sources":["../../../../src/core/Scene.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAUA;;;AAGG;AACH,MAAM,WAAW,CAAA;AAGqB,IAAA,MAAA;AAFnB,IAAA,SAAS,GAAG,IAAI,GAAG,EAAgB;AAEpD,IAAA,WAAA,CAAoC,MAAa,EAAA;QAAb,IAAA,CAAA,MAAM,GAAN,MAAM;IAAU;AAE7C,IAAA,OAAO,CAAC,OAA+C,EAAE,QAAiC,EAAE,OAA6B,EAAA;QAC9H,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChF;AAEO,IAAA,QAAQ,CAAC,OAA+C,EAAE,QAAiC,EAAE,OAA6B,EAAA;QAC/H,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjF;AAEO,IAAA,MAAM,CAAC,OAA+C,EAAE,QAAiC,EAAE,OAA6B,EAAA;QAC7H,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/E;AAEO,IAAA,SAAS,CAAC,OAA+C,EAAE,QAAiC,EAAE,OAA6B,EAAA;QAChI,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClF;;IAGO,WAAW,GAAA;AAChB,QAAA,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,SAAS,EAAE;YACpC,OAAO,CAAC,MAAM,EAAE;QAClB;AAEA,QAAA,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE;IACxB;AAEQ,IAAA,MAAM,CAAC,OAAqB,EAAA;AAClC,QAAA,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;AAE3B,QAAA,OAAO,OAAO;IAChB;AACD;AAED;;;AAGG;AACH,MAAM,WAAW,CAAA;AAGqB,IAAA,MAAA;AAFnB,IAAA,OAAO,GAAG,IAAI,GAAG,EAAS;AAE3C,IAAA,WAAA,CAAoC,MAAa,EAAA;QAAb,IAAA,CAAA,MAAM,GAAN,MAAM;IAAU;AAE7C,IAAA,MAAM,CAAmB,MAAS,EAAA;AACvC,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;AACpD,QAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;AAEvB,QAAA,OAAO,KAAK;IACd;AAEO,IAAA,GAAG,CAAC,KAAY,EAAA;QACrB,IAAI,CAAC,MAAM,CAAC,GAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;AAClC,QAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;AAEvB,QAAA,OAAO,IAAI;IACb;;IAGO,WAAW,GAAA;AAChB,QAAA,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE;YAChC,KAAK,CAAC,IAAI,EAAE;QACd;AAEA,QAAA,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE;IACtB;AACD;AAeD;;;;;;;;;;;;;;;;;;AAkBG;MACU,KAAK,CAAA;IACN,IAAI,GAAuB,IAAI;AACtB,IAAA,KAAK,GAAG,IAAI,SAAS,EAAE;IAChC,UAAU,GAAmB,SAAS;IACxC,OAAO,GAAuB,IAAI;IAClC,OAAO,GAAuB,IAAI;AAE1C,IAAA,IAAW,GAAG,GAAA;QACZ,OAAO,IAAI,CAAC,IAAI;IAClB;IAEA,IAAW,GAAG,CAAC,GAAuB,EAAA;AACpC,QAAA,IAAI,CAAC,IAAI,GAAG,GAAG;IACjB;AAEA;;;;;;;;;;;;AAYG;AACH,IAAA,IAAW,IAAI,GAAA;QACb,OAAO,IAAI,CAAC,KAAK;IACnB;AAEA;;;;;;AAMG;AACH,IAAA,IAAW,MAAM,GAAA;AACf,QAAA,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE;AACzB,YAAA,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE;AACtB,gBAAA,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC;YAChG;YAEA,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC;QACtC;QAEA,OAAO,IAAI,CAAC,OAAO;IACrB;AAEA;;;;;;AAMG;AACH,IAAA,IAAW,MAAM,GAAA;AACf,QAAA,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE;AACzB,YAAA,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE;AACtB,gBAAA,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC;YAChG;YAEA,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC;QACtC;QAEA,OAAO,IAAI,CAAC,OAAO;IACrB;AAEA,IAAA,IAAW,SAAS,GAAA;QAClB,OAAO,IAAI,CAAC,UAAU;IACxB;IAEA,IAAW,SAAS,CAAC,IAAoB,EAAA;AACvC,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI;IACxB;AAEO,IAAA,QAAQ,CAAC,KAAiB,EAAA;AAC/B,QAAA,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;AAE1B,QAAA,OAAO,IAAI;IACb;AAEO,IAAA,WAAW,CAAC,KAAiB,EAAA;AAClC,QAAA,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC;AAE7B,QAAA,OAAO,IAAI;IACb;AAEO,IAAA,sBAAsB,CAAC,MAAgC,EAAA;AAC5D,QAAA,IAAI,MAAM,CAAC,IAAI,EAAE;AACf,YAAA,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,IAAI;QAC/B;AAEA,QAAA,OAAO,IAAI;IACb;AAEA;;;;;AAKG;AACI,IAAA,IAAI,CAAC,OAAe,EAAA;;IAE3B;AAEA;;;;AAIG;AACI,IAAA,IAAI,CAAC,OAAe,EAAA;;IAE3B;AAEA;;;;AAIG;AACI,IAAA,MAAM,CAAC,MAAY,EAAA;;IAE1B;AAEA;;;;;;;;;;;;;;AAcG;AACI,IAAA,IAAI,CAAC,QAA0B,EAAA;;IAEtC;AAEA;;;;AAIG;AACI,IAAA,MAAM,CAAC,OAAe,EAAA;;IAE7B;IAEO,OAAO,GAAA;AACZ,QAAA,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE;AAC3B,QAAA,IAAI,CAAC,OAAO,GAAG,IAAI;AACnB,QAAA,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE;AAC3B,QAAA,IAAI,CAAC,OAAO,GAAG,IAAI;AACnB,QAAA,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE;AACpB,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI;IAClB;AACD;;;;"}
+{"version":3,"file":"Scene.js","sources":["../../../../src/core/Scene.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}