@codexo/exojs 0.6.12 → 0.7.12

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

@@ -16,8 +16,34 @@ declare enum SceneNodeTransformFlags {
     Scaling = 4,
     Origin = 8,
     Transform = 15,
-    TransformInverse = 16
+    TransformInverse = 16,
+    GlobalTransform = 256,// own _globalTransform is stale
+    BoundsRect = 512
 }
+/**
+ * Transform-bearing leaf in the scene-graph hierarchy. Carries position,
+ * rotation, scale, origin, and a 2-component {@link Vector} `anchor` used to
+ * derive `origin` from the local bounds. Implements {@link Collidable} so
+ * any node can participate directly in the SAT collision pipeline via its
+ * AABB or rotated quad.
+ *
+ * Transform state is dirty-flag-cached: position/rotation/scale/origin
+ * mutations invalidate the local transform; either kind of mutation also
+ * invalidates the global transform (own + descendants) and the bounds rect
+ * for this node and every {@link Container} ancestor up the parent chain.
+ * The caches rebuild lazily on the next read.
+ *
+ * The fast-path `isAlignedBox` getter reports `true` when the rotation is a
+ * multiple of 90°; in that case the (cheaper) AABB-based collision test is
+ * used instead of the rotated-quad SAT path.
+ *
+ * `_invalidate*` methods are exported as `public` for friend-class access
+ * from {@link Container} and {@link InteractionManager}; treat them as
+ * `@internal`.
+ *
+ * Subclasses: {@link Container} (carries children), {@link RenderNode}
+ * (carries draw payloads).
+ */
 export declare class SceneNode implements Collidable {
     readonly collisionType: CollisionType;
     readonly flags: Flags<SceneNodeTransformFlags>;
@@ -43,12 +69,19 @@ export declare class SceneNode implements Collidable {
     set x(x: number);
     get y(): number;
     set y(y: number);
+    /** Rotation angle in degrees. Wraps via `trimRotation` on assignment. */
     get rotation(): number;
     set rotation(rotation: number);
     get scale(): ObservableVector;
     set scale(scale: ObservableVector);
     get origin(): ObservableVector;
     set origin(origin: ObservableVector);
+    /**
+     * Normalized anchor in 0..1 along each axis that derives `origin` from
+     * the current bounds size. `(0, 0)` = top-left, `(0.5, 0.5)` = center,
+     * `(1, 1)` = bottom-right. Updates `origin` whenever the anchor or the
+     * local bounds change.
+     */
     get anchor(): ObservableVector;
     set anchor(anchor: ObservableVector);
     get parent(): Container | null;
@@ -89,6 +122,12 @@ export declare class SceneNode implements Collidable {
     contains(x: number, y: number): boolean;
     inView(view: View): boolean;
     destroy(): void;
+    /** Mark own + all descendants' GlobalTransform + Bounds dirty. */
+    _invalidateSubtreeTransform(): void;
+    /** Hook for Container to override. Default: no-op (leaf node has no children). */
+    protected _invalidateChildrenTransform(): void;
+    /** Mark own Bounds dirty AND propagate up to Container ancestors' Bounds. */
+    _invalidateBoundsCascade(): void;
     private _setPositionDirty;
     private _setRotationDirty;
     private _setScalingDirty;

package/dist/esm/core/SceneNode.js

@@ -4,6 +4,7 @@ import { Rectangle } from '../math/Rectangle.js';
 import { Bounds } from './Bounds.js';
 import { Flags } from '../math/Flags.js';
 import { degreesToRadians, trimRotation } from '../math/utils.js';
+import { _getCurrentInteractionManager } from '../input/interaction-hooks.js';
 import { Interval } from '../math/Interval.js';
 import { CollisionType } from '../math/Collision.js';
 import { intersectionPointRect, intersectionLineRect, intersectionRectEllipse, intersectionRectCircle, intersectionSat, getCollisionSat } from '../math/collision-detection.js';
@@ -21,10 +22,38 @@ var SceneNodeTransformFlags;
     SceneNodeTransformFlags[SceneNodeTransformFlags["Origin"] = 8] = "Origin";
     SceneNodeTransformFlags[SceneNodeTransformFlags["Transform"] = 15] = "Transform";
     SceneNodeTransformFlags[SceneNodeTransformFlags["TransformInverse"] = 16] = "TransformInverse";
+    SceneNodeTransformFlags[SceneNodeTransformFlags["GlobalTransform"] = 256] = "GlobalTransform";
+    SceneNodeTransformFlags[SceneNodeTransformFlags["BoundsRect"] = 512] = "BoundsRect";
 })(SceneNodeTransformFlags || (SceneNodeTransformFlags = {}));
+/**
+ * Transform-bearing leaf in the scene-graph hierarchy. Carries position,
+ * rotation, scale, origin, and a 2-component {@link Vector} `anchor` used to
+ * derive `origin` from the local bounds. Implements {@link Collidable} so
+ * any node can participate directly in the SAT collision pipeline via its
+ * AABB or rotated quad.
+ *
+ * Transform state is dirty-flag-cached: position/rotation/scale/origin
+ * mutations invalidate the local transform; either kind of mutation also
+ * invalidates the global transform (own + descendants) and the bounds rect
+ * for this node and every {@link Container} ancestor up the parent chain.
+ * The caches rebuild lazily on the next read.
+ *
+ * The fast-path `isAlignedBox` getter reports `true` when the rotation is a
+ * multiple of 90°; in that case the (cheaper) AABB-based collision test is
+ * used instead of the rotated-quad SAT path.
+ *
+ * `_invalidate*` methods are exported as `public` for friend-class access
+ * from {@link Container} and {@link InteractionManager}; treat them as
+ * `@internal`.
+ *
+ * Subclasses: {@link Container} (carries children), {@link RenderNode}
+ * (carries draw payloads).
+ */
 class SceneNode {
     collisionType = CollisionType.SceneNode;
-    flags = new Flags(SceneNodeTransformFlags.Transform);
+    flags = new Flags(SceneNodeTransformFlags.Transform
+        | SceneNodeTransformFlags.GlobalTransform
+        | SceneNodeTransformFlags.BoundsRect);
     _bounds = new Bounds();
     _transform = new Matrix();
     _position = new ObservableVector(this._setPositionDirty.bind(this), 0, 0);
@@ -59,6 +88,7 @@ class SceneNode {
     set y(y) {
         this._position.y = y;
     }
+    /** Rotation angle in degrees. Wraps via `trimRotation` on assignment. */
     get rotation() {
         return this._rotation;
     }
@@ -77,6 +107,12 @@ class SceneNode {
     set origin(origin) {
         this._origin.copy(origin);
     }
+    /**
+     * Normalized anchor in 0..1 along each axis that derives `origin` from
+     * the current bounds size. `(0, 0)` = top-left, `(0.5, 0.5)` = center,
+     * `(1, 1)` = bottom-right. Updates `origin` whenever the anchor or the
+     * local bounds change.
+     */
     get anchor() {
         return this._anchor;
     }
@@ -204,8 +240,10 @@ class SceneNode {
         return this._localBounds;
     }
     getBounds() {
-        this.updateParentTransform();
-        this.updateBounds();
+        if (this.flags.has(SceneNodeTransformFlags.BoundsRect)) {
+            this.updateBounds();
+            this.flags.remove(SceneNodeTransformFlags.BoundsRect);
+        }
         return this._bounds.getRect();
     }
     updateBounds() {
@@ -221,9 +259,12 @@ class SceneNode {
         return this;
     }
     getGlobalTransform() {
-        this._globalTransform.copy(this.getTransform());
-        if (this._parentNode) {
-            this._globalTransform.combine(this._parentNode.getGlobalTransform());
+        if (this.flags.has(SceneNodeTransformFlags.GlobalTransform)) {
+            this._globalTransform.copy(this.getTransform());
+            if (this._parentNode) {
+                this._globalTransform.combine(this._parentNode.getGlobalTransform());
+            }
+            this.flags.remove(SceneNodeTransformFlags.GlobalTransform);
         }
         return this._globalTransform;
     }
@@ -280,17 +321,45 @@ class SceneNode {
         this._bounds.destroy();
         this._anchor.destroy();
     }
+    /** Mark own + all descendants' GlobalTransform + Bounds dirty. */
+    _invalidateSubtreeTransform() {
+        this.flags.push(SceneNodeTransformFlags.GlobalTransform | SceneNodeTransformFlags.BoundsRect);
+        this._invalidateChildrenTransform();
+    }
+    /** Hook for Container to override. Default: no-op (leaf node has no children). */
+    _invalidateChildrenTransform() {
+        // overridden by Container
+    }
+    /** Mark own Bounds dirty AND propagate up to Container ancestors' Bounds. */
+    _invalidateBoundsCascade() {
+        this.flags.push(SceneNodeTransformFlags.BoundsRect);
+        // Notify the InteractionManager so it can mark the quadtree entry stale.
+        // The manager filters to only tracked interactive nodes so this call is
+        // O(1) for the common case (non-interactive node — fast Set.has miss).
+        _getCurrentInteractionManager()?._notifyBoundsInvalidated(this);
+        if (this._parentNode) {
+            this._parentNode._invalidateBoundsCascade();
+        }
+    }
     _setPositionDirty() {
         this.flags.push(SceneNodeTransformFlags.Translation);
+        this._invalidateSubtreeTransform();
+        this._invalidateBoundsCascade();
     }
     _setRotationDirty() {
         this.flags.push(SceneNodeTransformFlags.Rotation);
+        this._invalidateSubtreeTransform();
+        this._invalidateBoundsCascade();
     }
     _setScalingDirty() {
         this.flags.push(SceneNodeTransformFlags.Scaling);
+        this._invalidateSubtreeTransform();
+        this._invalidateBoundsCascade();
     }
     _setOriginDirty() {
         this.flags.push(SceneNodeTransformFlags.Origin);
+        this._invalidateSubtreeTransform();
+        this._invalidateBoundsCascade();
     }
     _updateOrigin() {
         const { x, y } = this._anchor;

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

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

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

@@ -1,17 +1,61 @@
+/**
+ * Listener function for a {@link Signal}. Returning `false` from a handler
+ * stops further dispatch to remaining listeners for the current invocation
+ * (subsequent dispatches are unaffected).
+ */
 type SignalHandler<Args extends Array<unknown>> = (...params: Args) => void | boolean;
 interface SignalBinding<Args extends Array<unknown>> {
     handler: SignalHandler<Args>;
     context?: object;
 }
+/**
+ * Lightweight typed event emitter. Each `Signal` represents one named
+ * notification channel (e.g. `onResize`, `onFrame`). Listeners are added with
+ * {@link Signal.add} or {@link Signal.once}, removed with
+ * {@link Signal.remove}, and notified with {@link Signal.dispatch}.
+ *
+ * `Args` is the tuple of arguments passed to listeners — type-checked end to
+ * end so a `new Signal<[number, string]>()` enforces both `dispatch(1, 'x')`
+ * and the listener signature `(n: number, s: string) => …`.
+ *
+ * `dispatch` snapshots the bindings list before iterating, so handlers may
+ * freely add or remove listeners during the same dispatch without corrupting
+ * the loop. Returning `false` from a handler short-circuits the rest of the
+ * dispatch (handy for capturing-style flows).
+ */
 export declare class Signal<Args extends Array<unknown> = []> {
     private readonly _bindings;
     get bindings(): ReadonlyArray<SignalBinding<Args>>;
+    /** `true` when `handler` is registered with the same `context`. */
     has(handler: SignalHandler<Args>, context?: object): boolean;
+    /**
+     * Register a listener. Idempotent — adding the same `(handler, context)`
+     * pair twice is a no-op. `context` becomes `this` inside the handler.
+     */
     add(handler: SignalHandler<Args>, context?: object): this;
+    /**
+     * Register a listener that auto-removes itself after the first dispatch.
+     * Wraps `handler` in a self-removing closure; calling
+     * {@link Signal.remove} with the original `handler` reference does NOT
+     * remove the wrapper — use {@link Signal.clear} or
+     * {@link Signal.clearByContext} to undo a `once` registration.
+     */
     once(handler: SignalHandler<Args>, context?: object): this;
+    /** Remove a previously registered `(handler, context)` pair. No-op if absent. */
     remove(handler: SignalHandler<Args>, context?: object): this;
+    /**
+     * Remove every listener bound to `context`. Useful when an object is
+     * being torn down and needs to detach all its subscriptions in one call.
+     */
     clearByContext(context?: object): this;
+    /** Remove every listener. */
     clear(): this;
+    /**
+     * Notify every registered listener in registration order. Returning `false`
+     * from a handler stops dispatch to the remaining listeners for this call.
+     * Listeners may safely add/remove bindings during dispatch — the iteration
+     * uses a pre-snapshot of the bindings array.
+     */
     dispatch(...params: Args): this;
     destroy(): void;
 }

package/dist/esm/core/Signal.js

@@ -1,19 +1,46 @@
 import { removeArrayItems } from './utils.js';
 
+/**
+ * Lightweight typed event emitter. Each `Signal` represents one named
+ * notification channel (e.g. `onResize`, `onFrame`). Listeners are added with
+ * {@link Signal.add} or {@link Signal.once}, removed with
+ * {@link Signal.remove}, and notified with {@link Signal.dispatch}.
+ *
+ * `Args` is the tuple of arguments passed to listeners — type-checked end to
+ * end so a `new Signal<[number, string]>()` enforces both `dispatch(1, 'x')`
+ * and the listener signature `(n: number, s: string) => …`.
+ *
+ * `dispatch` snapshots the bindings list before iterating, so handlers may
+ * freely add or remove listeners during the same dispatch without corrupting
+ * the loop. Returning `false` from a handler short-circuits the rest of the
+ * dispatch (handy for capturing-style flows).
+ */
 class Signal {
     _bindings = new Array();
     get bindings() {
         return this._bindings;
     }
+    /** `true` when `handler` is registered with the same `context`. */
     has(handler, context) {
         return this._bindings.some((binding) => (binding.handler === handler && binding.context === context));
     }
+    /**
+     * Register a listener. Idempotent — adding the same `(handler, context)`
+     * pair twice is a no-op. `context` becomes `this` inside the handler.
+     */
     add(handler, context) {
         if (!this.has(handler, context)) {
             this._bindings.push({ handler, context });
         }
         return this;
     }
+    /**
+     * Register a listener that auto-removes itself after the first dispatch.
+     * Wraps `handler` in a self-removing closure; calling
+     * {@link Signal.remove} with the original `handler` reference does NOT
+     * remove the wrapper — use {@link Signal.clear} or
+     * {@link Signal.clearByContext} to undo a `once` registration.
+     */
     once(handler, context) {
         const once = (...params) => {
             this.remove(once, context);
@@ -22,6 +49,7 @@ class Signal {
         this.add(once, context);
         return this;
     }
+    /** Remove a previously registered `(handler, context)` pair. No-op if absent. */
     remove(handler, context) {
         const index = this._bindings.findIndex((binding) => (binding.handler === handler && binding.context === context));
         if (index !== -1) {
@@ -29,6 +57,10 @@ class Signal {
         }
         return this;
     }
+    /**
+     * Remove every listener bound to `context`. Useful when an object is
+     * being torn down and needs to detach all its subscriptions in one call.
+     */
     clearByContext(context) {
         const bindings = this._bindings.filter(binding => binding.context === context);
         for (const binding of bindings) {
@@ -36,10 +68,17 @@ class Signal {
         }
         return this;
     }
+    /** Remove every listener. */
     clear() {
         this._bindings.length = 0;
         return this;
     }
+    /**
+     * Notify every registered listener in registration order. Returning `false`
+     * from a handler stops dispatch to the remaining listeners for this call.
+     * Listeners may safely add/remove bindings during dispatch — the iteration
+     * uses a pre-snapshot of the bindings array.
+     */
     dispatch(...params) {
         if (this._bindings.length) {
             // Snapshot bindings because handlers may mutate the array mid-dispatch

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

@@ -1 +1 @@
-{"version":3,"file":"Signal.js","sources":["../../../../src/core/Signal.ts"],"sourcesContent":[null],"names":[],"mappings":";;MASa,MAAM,CAAA;AAEE,IAAA,SAAS,GAAG,IAAI,KAAK,EAAuB;AAE7D,IAAA,IAAW,QAAQ,GAAA;QACf,OAAO,IAAI,CAAC,SAAS;IACzB;IAEO,GAAG,CAAC,OAA4B,EAAE,OAAgB,EAAA;QACrD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,MAAM,OAAO,CAAC,OAAO,KAAK,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IACzG;IAEO,GAAG,CAAC,OAA4B,EAAE,OAAgB,EAAA;QACrD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE;YAC7B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAC7C;AAEA,QAAA,OAAO,IAAI;IACf;IAEO,IAAI,CAAC,OAA4B,EAAE,OAAgB,EAAA;AACtD,QAAA,MAAM,IAAI,GAAG,CAAC,GAAG,MAAY,KAAU;AACnC,YAAA,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC;AACpC,QAAA,CAAC;AAED,QAAA,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC;AAEvB,QAAA,OAAO,IAAI;IACf;IAEO,MAAM,CAAC,OAA4B,EAAE,OAAgB,EAAA;QACxD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO,MAAM,OAAO,CAAC,OAAO,KAAK,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;AAEjH,QAAA,IAAI,KAAK,KAAK,EAAE,EAAE;YACd,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9C;AAEA,QAAA,OAAO,IAAI;IACf;AAEO,IAAA,cAAc,CAAC,OAAgB,EAAA;AAClC,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC;AAE9E,QAAA,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE;AAC5B,YAAA,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACxE;AAEA,QAAA,OAAO,IAAI;IACf;IAEO,KAAK,GAAA;AACR,QAAA,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;AAEzB,QAAA,OAAO,IAAI;IACf;IAEO,QAAQ,CAAC,GAAG,MAAY,EAAA;AAC3B,QAAA,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE;;;;YAIvB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE;AAEvC,YAAA,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE;AAC5B,gBAAA,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,KAAK,KAAK,EAAE;oBAC5D;gBACJ;YACJ;QACJ;AAEA,QAAA,OAAO,IAAI;IACf;IAEO,OAAO,GAAA;QACV,IAAI,CAAC,KAAK,EAAE;IAChB;AACH;;;;"}
+{"version":3,"file":"Signal.js","sources":["../../../../src/core/Signal.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAcA;;;;;;;;;;;;;;AAcG;MACU,MAAM,CAAA;AAEE,IAAA,SAAS,GAAG,IAAI,KAAK,EAAuB;AAE7D,IAAA,IAAW,QAAQ,GAAA;QACf,OAAO,IAAI,CAAC,SAAS;IACzB;;IAGO,GAAG,CAAC,OAA4B,EAAE,OAAgB,EAAA;QACrD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,MAAM,OAAO,CAAC,OAAO,KAAK,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IACzG;AAEA;;;AAGG;IACI,GAAG,CAAC,OAA4B,EAAE,OAAgB,EAAA;QACrD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE;YAC7B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAC7C;AAEA,QAAA,OAAO,IAAI;IACf;AAEA;;;;;;AAMG;IACI,IAAI,CAAC,OAA4B,EAAE,OAAgB,EAAA;AACtD,QAAA,MAAM,IAAI,GAAG,CAAC,GAAG,MAAY,KAAU;AACnC,YAAA,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC;AACpC,QAAA,CAAC;AAED,QAAA,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC;AAEvB,QAAA,OAAO,IAAI;IACf;;IAGO,MAAM,CAAC,OAA4B,EAAE,OAAgB,EAAA;QACxD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO,MAAM,OAAO,CAAC,OAAO,KAAK,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;AAEjH,QAAA,IAAI,KAAK,KAAK,EAAE,EAAE;YACd,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9C;AAEA,QAAA,OAAO,IAAI;IACf;AAEA;;;AAGG;AACI,IAAA,cAAc,CAAC,OAAgB,EAAA;AAClC,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC;AAE9E,QAAA,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE;AAC5B,YAAA,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACxE;AAEA,QAAA,OAAO,IAAI;IACf;;IAGO,KAAK,GAAA;AACR,QAAA,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;AAEzB,QAAA,OAAO,IAAI;IACf;AAEA;;;;;AAKG;IACI,QAAQ,CAAC,GAAG,MAAY,EAAA;AAC3B,QAAA,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE;;;;YAIvB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE;AAEvC,YAAA,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE;AAC5B,gBAAA,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,KAAK,KAAK,EAAE;oBAC5D;gBACJ;YACJ;QACJ;AAEA,QAAA,OAAO,IAAI;IACf;IAEO,OAAO,GAAA;QACV,IAAI,CAAC,KAAK,EAAE;IAChB;AACH;;;;"}

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

@@ -1,4 +1,16 @@
 import type { Cloneable, TimeInterval } from '@/core/types';
+/**
+ * Time-duration value object stored internally in milliseconds. Provides
+ * unit-converted accessors (`seconds`, `minutes`, `hours`) and arithmetic
+ * helpers ({@link Time.add}, {@link Time.subtract}, {@link Time.addTime}).
+ *
+ * Constants on the class hold canonical durations: {@link Time.zero},
+ * {@link Time.oneSecond}, {@link Time.oneMinute}, {@link Time.oneHour}, plus
+ * the {@link TimeInterval} multipliers used by the `factor` parameter.
+ *
+ * `Time.temp` is a shared scratch instance for hot paths — do not store the
+ * reference across calls.
+ */
 export declare class Time implements Cloneable {
     private _milliseconds;
     constructor(time?: number, factor?: TimeInterval);
@@ -10,6 +22,11 @@ export declare class Time implements Cloneable {
     set minutes(minutes: number);
     get hours(): number;
     set hours(hours: number);
+    /**
+     * Replace the stored duration with `time * factor` milliseconds. Pair
+     * with {@link Time.seconds}, {@link Time.minutes}, or {@link Time.hours}
+     * as the `factor` to construct from non-millisecond units.
+     */
     set(time?: number, factor?: TimeInterval): this;
     setMilliseconds(milliseconds: number): this;
     setSeconds(seconds: number): this;
@@ -20,9 +37,13 @@ export declare class Time implements Cloneable {
     lessThan(time: Time): boolean;
     clone(): this;
     copy(time: Time): this;
+    /** Add `value * factor` milliseconds in place. Mutates this instance. */
     add(value?: number, factor?: TimeInterval): this;
+    /** Add another `Time` value in place. Mutates this instance. */
     addTime(time: Time): this;
+    /** Subtract `value * factor` milliseconds in place. Mutates this instance. */
     subtract(value?: number, factor?: TimeInterval): this;
+    /** Subtract another `Time` value in place. Mutates this instance. */
     subtractTime(time: Time): this;
     destroy(): void;
     static readonly milliseconds: TimeInterval;

package/dist/esm/core/Time.js

@@ -1,4 +1,16 @@
 let temp = null;
+/**
+ * Time-duration value object stored internally in milliseconds. Provides
+ * unit-converted accessors (`seconds`, `minutes`, `hours`) and arithmetic
+ * helpers ({@link Time.add}, {@link Time.subtract}, {@link Time.addTime}).
+ *
+ * Constants on the class hold canonical durations: {@link Time.zero},
+ * {@link Time.oneSecond}, {@link Time.oneMinute}, {@link Time.oneHour}, plus
+ * the {@link TimeInterval} multipliers used by the `factor` parameter.
+ *
+ * `Time.temp` is a shared scratch instance for hot paths — do not store the
+ * reference across calls.
+ */
 class Time {
     _milliseconds;
     constructor(time = 0, factor = Time.milliseconds) {
@@ -28,6 +40,11 @@ class Time {
     set hours(hours) {
         this._milliseconds = hours * Time.hours;
     }
+    /**
+     * Replace the stored duration with `time * factor` milliseconds. Pair
+     * with {@link Time.seconds}, {@link Time.minutes}, or {@link Time.hours}
+     * as the `factor` to construct from non-millisecond units.
+     */
     set(time = 0, factor = Time.milliseconds) {
         this._milliseconds = time * factor;
         return this;
@@ -67,24 +84,28 @@ class Time {
         this._milliseconds = time.milliseconds;
         return this;
     }
+    /** Add `value * factor` milliseconds in place. Mutates this instance. */
     add(value = 0, factor = Time.milliseconds) {
         this._milliseconds += (value * factor);
         return this;
     }
+    /** Add another `Time` value in place. Mutates this instance. */
     addTime(time) {
         this._milliseconds += time.milliseconds;
         return this;
     }
+    /** Subtract `value * factor` milliseconds in place. Mutates this instance. */
     subtract(value = 0, factor = Time.milliseconds) {
         this._milliseconds -= (value * factor);
         return this;
     }
+    /** Subtract another `Time` value in place. Mutates this instance. */
     subtractTime(time) {
         this._milliseconds -= time.milliseconds;
         return this;
     }
     destroy() {
-        // todo - check if destroy is needed
+        // no-op — pure value class, kept for Destroyable interface conformance
     }
     static milliseconds = 1;
     static seconds = 1000;

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

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

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

@@ -1,9 +1,16 @@
 import { Clock } from './Clock';
 import { Time } from '@/core/Time';
+/**
+ * {@link Clock} variant with a fixed limit. Inherits start/stop/reset/restart
+ * semantics; adds {@link Timer.expired} (true once `elapsedTime >= limit`)
+ * and remaining-time accessors. Useful for cooldowns, delays, and any timed
+ * gating logic where you want to ask "is the duration up?" each frame.
+ */
 export declare class Timer extends Clock {
     private readonly _limit;
     constructor(limit: Time, autoStart?: boolean);
     set limit(limit: Time);
+    /** `true` once the elapsed time has reached or exceeded the configured limit. */
     get expired(): boolean;
     get remainingMilliseconds(): number;
     get remainingSeconds(): number;

package/dist/esm/core/Timer.js

@@ -1,6 +1,12 @@
 import { Clock } from './Clock.js';
 import { Time } from './Time.js';
 
+/**
+ * {@link Clock} variant with a fixed limit. Inherits start/stop/reset/restart
+ * semantics; adds {@link Timer.expired} (true once `elapsedTime >= limit`)
+ * and remaining-time accessors. Useful for cooldowns, delays, and any timed
+ * gating logic where you want to ask "is the duration up?" each frame.
+ */
 class Timer extends Clock {
     _limit;
     constructor(limit, autoStart = false) {
@@ -13,6 +19,7 @@ class Timer extends Clock {
     set limit(limit) {
         this._limit.copy(limit);
     }
+    /** `true` once the elapsed time has reached or exceeded the configured limit. */
     get expired() {
         return this.elapsedMilliseconds >= this._limit.milliseconds;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"Timer.js","sources":["../../../../src/core/Timer.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAGM,MAAO,KAAM,SAAQ,KAAK,CAAA;AAEX,IAAA,MAAM;AAEvB,IAAA,WAAA,CAAmB,KAAW,EAAE,SAAS,GAAG,KAAK,EAAA;AAC7C,QAAA,KAAK,EAAE;AAEP,QAAA,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE;QAE3B,IAAI,SAAS,EAAE;YACX,IAAI,CAAC,OAAO,EAAE;QAClB;IACJ;IAEA,IAAW,KAAK,CAAC,KAAW,EAAA;AACxB,QAAA,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;IAC3B;AAEA,IAAA,IAAW,OAAO,GAAA;QACd,OAAO,IAAI,CAAC,mBAAmB,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY;IAC/D;AAEA,IAAA,IAAW,qBAAqB,GAAA;AAC5B,QAAA,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC;IAC3E;AAEA,IAAA,IAAW,gBAAgB,GAAA;AACvB,QAAA,OAAO,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,OAAO;IACpD;AAEA,IAAA,IAAW,gBAAgB,GAAA;AACvB,QAAA,OAAO,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,OAAO;IACpD;AAEA,IAAA,IAAW,cAAc,GAAA;AACrB,QAAA,OAAO,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,KAAK;IAClD;AACH;;;;"}
+{"version":3,"file":"Timer.js","sources":["../../../../src/core/Timer.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAGA;;;;;AAKG;AACG,MAAO,KAAM,SAAQ,KAAK,CAAA;AAEX,IAAA,MAAM;AAEvB,IAAA,WAAA,CAAmB,KAAW,EAAE,SAAS,GAAG,KAAK,EAAA;AAC7C,QAAA,KAAK,EAAE;AAEP,QAAA,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE;QAE3B,IAAI,SAAS,EAAE;YACX,IAAI,CAAC,OAAO,EAAE;QAClB;IACJ;IAEA,IAAW,KAAK,CAAC,KAAW,EAAA;AACxB,QAAA,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;IAC3B;;AAGA,IAAA,IAAW,OAAO,GAAA;QACd,OAAO,IAAI,CAAC,mBAAmB,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY;IAC/D;AAEA,IAAA,IAAW,qBAAqB,GAAA;AAC5B,QAAA,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC;IAC3E;AAEA,IAAA,IAAW,gBAAgB,GAAA;AACvB,QAAA,OAAO,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,OAAO;IACpD;AAEA,IAAA,IAAW,gBAAgB,GAAA;AACvB,QAAA,OAAO,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,OAAO;IACpD;AAEA,IAAA,IAAW,cAAc,GAAA;AACrB,QAAA,OAAO,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,KAAK;IAClD;AACH;;;;"}

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

@@ -1,3 +1,15 @@
+/**
+ * Frozen snapshot of host-environment feature support: which renderer
+ * backends are available, which input modalities are present, audio /
+ * fullscreen / vibration / OffscreenCanvas / Worker support, max touch
+ * points, and the resolved devicePixelRatio.
+ *
+ * Construction is private — the only public entry is
+ * {@link Capabilities.ready}, a lazy-cached `Promise<Capabilities>` that
+ * fires the (mostly) async probes on first access. The resolved instance
+ * is frozen and never mutates. {@link Application.capabilities} returns
+ * the same instance once `app.start()` has resolved.
+ */
 export declare class Capabilities {
     private static _readyPromise;
     /**

package/dist/esm/core/capabilities.js

@@ -11,6 +11,18 @@
 const hasWindow = typeof window !== 'undefined';
 const hasDocument = typeof document !== 'undefined';
 const hasNavigator = typeof navigator !== 'undefined';
+/**
+ * Frozen snapshot of host-environment feature support: which renderer
+ * backends are available, which input modalities are present, audio /
+ * fullscreen / vibration / OffscreenCanvas / Worker support, max touch
+ * points, and the resolved devicePixelRatio.
+ *
+ * Construction is private — the only public entry is
+ * {@link Capabilities.ready}, a lazy-cached `Promise<Capabilities>` that
+ * fires the (mostly) async probes on first access. The resolved instance
+ * is frozen and never mutates. {@link Application.capabilities} returns
+ * the same instance once `app.start()` has resolved.
+ */
 class Capabilities {
     static _readyPromise = null;
     /**

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

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