@codexo/exojs 0.6.12 → 0.7.11

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

@@ -5,7 +5,6 @@ export * from './Bounds';
 export * from './capabilities';
 export * from './Clock';
 export * from './Color';
-export * from './Quadtree';
 export * from './Scene';
 export * from './SceneManager';
 export * from './SceneNode';

package/dist/esm/debug/BoundingBoxesLayer.d.ts

@@ -0,0 +1,18 @@
+import { DebugLayer } from './DebugLayer';
+import type { DebugLayerViewMode } from './DebugLayer';
+import type { Time } from '@/core/Time';
+import type { RenderBackend } from '@/rendering/RenderBackend';
+import type { Application } from '@/core/Application';
+/**
+ * Debug layer that draws a bounding-box outline around every visible
+ * RenderNode in the scene. Colours cycle by zIndex (HSL hue). World-space.
+ */
+export declare class BoundingBoxesLayer extends DebugLayer {
+    private _graphics;
+    constructor(app: Application);
+    get viewMode(): DebugLayerViewMode;
+    update(_delta: Time): void;
+    render(backend: RenderBackend): void;
+    destroy(): void;
+    private _walkNode;
+}

package/dist/esm/debug/BoundingBoxesLayer.js

@@ -0,0 +1,128 @@
+import { DebugLayer } from './DebugLayer.js';
+import { Graphics } from '../rendering/primitives/Graphics.js';
+import { Color } from '../core/Color.js';
+import '../math/Size.js';
+import '../core/Time.js';
+import '../core/SceneNode.js';
+import '../math/Rectangle.js';
+import '../rendering/types.js';
+import '../rendering/View.js';
+import '../rendering/texture/RenderTexture.js';
+
+// ---------------------------------------------------------------------------
+// HSL → RGB helper
+// ---------------------------------------------------------------------------
+/**
+ * Convert HSL (hue 0-360, saturation 0-1, lightness 0-1) to a Color instance.
+ * Returns an RGB Color (alpha = alpha parameter).
+ */
+function hslToColor(h, s, l, alpha) {
+    const c = (1 - Math.abs(2 * l - 1)) * s;
+    const x = c * (1 - Math.abs(((h / 60) % 2) - 1));
+    const m = l - c / 2;
+    let r = 0;
+    let g = 0;
+    let b = 0;
+    if (h < 60) {
+        r = c;
+        g = x;
+        b = 0;
+    }
+    else if (h < 120) {
+        r = x;
+        g = c;
+        b = 0;
+    }
+    else if (h < 180) {
+        r = 0;
+        g = c;
+        b = x;
+    }
+    else if (h < 240) {
+        r = 0;
+        g = x;
+        b = c;
+    }
+    else if (h < 300) {
+        r = x;
+        g = 0;
+        b = c;
+    }
+    else {
+        r = c;
+        g = 0;
+        b = x;
+    }
+    return new Color(r + m, g + m, b + m, alpha);
+}
+// ---------------------------------------------------------------------------
+/**
+ * Debug layer that draws a bounding-box outline around every visible
+ * RenderNode in the scene. Colours cycle by zIndex (HSL hue). World-space.
+ */
+class BoundingBoxesLayer extends DebugLayer {
+    _graphics = null;
+    constructor(app) {
+        super(app);
+    }
+    get viewMode() {
+        return 'world';
+    }
+    update(_delta) {
+        // State is built in render() each frame; nothing to pre-compute here.
+    }
+    render(backend) {
+        const root = this._app.sceneManager.scene?.root;
+        if (!root) {
+            return;
+        }
+        if (this._graphics === null) {
+            this._graphics = new Graphics();
+        }
+        const gfx = this._graphics;
+        gfx.clear();
+        gfx.lineWidth = 1;
+        this._walkNode(root, gfx);
+        gfx.render(backend);
+    }
+    destroy() {
+        if (this._graphics !== null) {
+            this._graphics.destroy();
+            this._graphics = null;
+        }
+    }
+    // -----------------------------------------------------------------------
+    _walkNode(node, gfx) {
+        if (!node.visible) {
+            return;
+        }
+        const bounds = node.getBounds();
+        // Skip zero-area bounds (defensive).
+        if (bounds.width > 0 && bounds.height > 0) {
+            const hue = ((node.zIndex * 30) % 360 + 360) % 360;
+            const color = hslToColor(hue, 0.7, 0.5, 0.7);
+            gfx.lineColor = color;
+            // Draw the rectangle outline as four line segments.
+            const l = bounds.left;
+            const t = bounds.top;
+            const r = bounds.right;
+            const bo = bounds.bottom;
+            gfx.moveTo(l, t);
+            gfx.lineTo(r, t);
+            gfx.lineTo(r, bo);
+            gfx.lineTo(l, bo);
+            gfx.lineTo(l, t);
+            color.destroy();
+        }
+        // Recurse into Container children.
+        const container = node;
+        if (Array.isArray(container.children)) {
+            for (const child of container.children) {
+                this._walkNode(child, gfx);
+            }
+        }
+    }
+}
+
+export { BoundingBoxesLayer };
+//# sourceMappingURL=BoundingBoxesLayer.js.map

package/dist/esm/debug/BoundingBoxesLayer.js.map

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

package/dist/esm/debug/DebugLayer.d.ts

@@ -0,0 +1,29 @@
+import type { Time } from '@/core/Time';
+import type { RenderBackend } from '@/rendering/RenderBackend';
+import type { Application } from '@/core/Application';
+export type DebugLayerViewMode = 'screen' | 'world';
+/**
+ * Base class for a debug layer. Subclasses build a visual
+ * (text, outlines, etc.) that the DebugOverlay renders each frame when
+ * `visible` is true. Tree-shake-able via the @codexo/exojs/debug subpath.
+ */
+export declare abstract class DebugLayer {
+    protected readonly _app: Application;
+    visible: boolean;
+    constructor(_app: Application);
+    /**
+     * Whether this layer renders in the scene's world-space view or in a
+     * screen-space (canvas-pixel) view. Defaults to 'screen'. Subclasses
+     * override to return 'world' when rendering at actual scene positions.
+     */
+    get viewMode(): DebugLayerViewMode;
+    /** Update internal state from this frame's data. Called only when visible. */
+    abstract update(delta: Time): void;
+    /**
+     * Render the layer's content using the backend. The DebugOverlay manages
+     * the active view based on this layer's viewMode; restore is handled by the overlay.
+     * Called only when visible.
+     */
+    abstract render(backend: RenderBackend): void;
+    destroy(): void;
+}

package/dist/esm/debug/DebugLayer.js

@@ -0,0 +1,26 @@
+/**
+ * Base class for a debug layer. Subclasses build a visual
+ * (text, outlines, etc.) that the DebugOverlay renders each frame when
+ * `visible` is true. Tree-shake-able via the @codexo/exojs/debug subpath.
+ */
+class DebugLayer {
+    _app;
+    visible = false;
+    constructor(_app) {
+        this._app = _app;
+    }
+    /**
+     * Whether this layer renders in the scene's world-space view or in a
+     * screen-space (canvas-pixel) view. Defaults to 'screen'. Subclasses
+     * override to return 'world' when rendering at actual scene positions.
+     */
+    get viewMode() {
+        return 'screen';
+    }
+    destroy() {
+        // Default: nothing. Subclasses override to release Container subtrees etc.
+    }
+}
+
+export { DebugLayer };
+//# sourceMappingURL=DebugLayer.js.map

package/dist/esm/debug/DebugLayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugLayer.js","sources":["../../../../src/debug/DebugLayer.ts"],"sourcesContent":[null],"names":[],"mappings":"AAMA;;;;AAIG;MACmB,UAAU,CAAA;AAGU,IAAA,IAAA;IAF/B,OAAO,GAAY,KAAK;AAE/B,IAAA,WAAA,CAAsC,IAAiB,EAAA;QAAjB,IAAA,CAAA,IAAI,GAAJ,IAAI;IAAgB;AAE1D;;;;AAIG;AACH,IAAA,IAAW,QAAQ,GAAA;AACf,QAAA,OAAO,QAAQ;IACnB;IAYO,OAAO,GAAA;;IAEd;AACH;;;;"}

package/dist/esm/debug/DebugOverlay.d.ts

@@ -0,0 +1,48 @@
+import { PerformanceLayer } from './PerformanceLayer';
+import { BoundingBoxesLayer } from './BoundingBoxesLayer';
+import { HitTestLayer } from './HitTestLayer';
+import { PointerStackLayer } from './PointerStackLayer';
+import type { Application } from '@/core/Application';
+export interface DebugLayers {
+    readonly performance: PerformanceLayer;
+    readonly boundingBoxes: BoundingBoxesLayer;
+    readonly hitTest: HitTestLayer;
+    readonly pointerStack: PointerStackLayer;
+}
+/**
+ * Canvas-native debug overlay. Instantiate AFTER Application is constructed:
+ *
+ *     import { DebugOverlay } from '@codexo/exojs/debug';
+ *     const debug = new DebugOverlay(app);
+ *     debug.layers.performance.visible = true;  // or press F1
+ *
+ * The overlay subscribes to `app.onFrame` and renders its visible layers.
+ * World-space layers render first (under text panels) in the scene view;
+ * screen-space layers then render in the overlay's pixel-space view.
+ *
+ * Keybindings (while canvas has focus):
+ *   F1 — toggle Performance layer
+ *   F2 — toggle BoundingBoxes layer
+ *   F3 — toggle HitTest layer
+ *   F4 — toggle PointerStack layer
+ *
+ * NOTE: F-keys only fire while the canvas has focus (engine convention).
+ *
+ * The master `visible` switch suppresses all layer rendering when false
+ * without changing individual layer visibility flags.
+ */
+export declare class DebugOverlay {
+    /** Master visibility switch. When false, no layers render regardless of their individual flags. */
+    visible: boolean;
+    readonly layers: DebugLayers;
+    private readonly _app;
+    private readonly _view;
+    private readonly _onFrameHandler;
+    private readonly _onKeyDownHandler;
+    private readonly _onResizeHandler;
+    constructor(app: Application);
+    destroy(): void;
+    private _onResize;
+    private _onFrame;
+    private _onKeyDown;
+}

package/dist/esm/debug/DebugOverlay.js

@@ -0,0 +1,117 @@
+import { View } from '../rendering/View.js';
+import { Keyboard } from '../input/types.js';
+import { PerformanceLayer } from './PerformanceLayer.js';
+import { BoundingBoxesLayer } from './BoundingBoxesLayer.js';
+import { HitTestLayer } from './HitTestLayer.js';
+import { PointerStackLayer } from './PointerStackLayer.js';
+
+/**
+ * Canvas-native debug overlay. Instantiate AFTER Application is constructed:
+ *
+ *     import { DebugOverlay } from '@codexo/exojs/debug';
+ *     const debug = new DebugOverlay(app);
+ *     debug.layers.performance.visible = true;  // or press F1
+ *
+ * The overlay subscribes to `app.onFrame` and renders its visible layers.
+ * World-space layers render first (under text panels) in the scene view;
+ * screen-space layers then render in the overlay's pixel-space view.
+ *
+ * Keybindings (while canvas has focus):
+ *   F1 — toggle Performance layer
+ *   F2 — toggle BoundingBoxes layer
+ *   F3 — toggle HitTest layer
+ *   F4 — toggle PointerStack layer
+ *
+ * NOTE: F-keys only fire while the canvas has focus (engine convention).
+ *
+ * The master `visible` switch suppresses all layer rendering when false
+ * without changing individual layer visibility flags.
+ */
+class DebugOverlay {
+    /** Master visibility switch. When false, no layers render regardless of their individual flags. */
+    visible = true;
+    layers;
+    _app;
+    _view;
+    _onFrameHandler;
+    _onKeyDownHandler;
+    _onResizeHandler;
+    constructor(app) {
+        this._app = app;
+        this._view = new View(app.canvas.width / 2, app.canvas.height / 2, app.canvas.width, app.canvas.height);
+        this.layers = {
+            performance: new PerformanceLayer(app),
+            boundingBoxes: new BoundingBoxesLayer(app),
+            hitTest: new HitTestLayer(app),
+            pointerStack: new PointerStackLayer(app),
+        };
+        this._onFrameHandler = this._onFrame.bind(this);
+        this._onKeyDownHandler = this._onKeyDown.bind(this);
+        this._onResizeHandler = this._onResize.bind(this);
+        app.onFrame.add(this._onFrameHandler);
+        app.inputManager.onKeyDown.add(this._onKeyDownHandler);
+        app.onResize.add(this._onResizeHandler);
+    }
+    destroy() {
+        this._app.onFrame.remove(this._onFrameHandler);
+        this._app.inputManager.onKeyDown.remove(this._onKeyDownHandler);
+        this._app.onResize.remove(this._onResizeHandler);
+        for (const layer of Object.values(this.layers)) {
+            layer.destroy();
+        }
+        this._view.destroy();
+    }
+    _onResize(width, height) {
+        this._view.resize(width, height);
+        this._view.setCenter(width / 2, height / 2);
+    }
+    _onFrame(delta) {
+        if (!this.visible)
+            return;
+        const layers = Object.values(this.layers);
+        const visibleLayers = layers.filter(l => l.visible);
+        if (visibleLayers.length === 0)
+            return;
+        const backend = this._app.backend;
+        const sceneView = backend.view; // capture scene's current view
+        // --- World-space layers first (render under screen-space text panels) ---
+        const worldLayers = visibleLayers.filter(l => l.viewMode === 'world');
+        for (const layer of worldLayers) {
+            layer.update(delta);
+            layer.render(backend);
+        }
+        // --- Screen-space layers: swap to overlay's pixel view ---
+        const screenLayers = visibleLayers.filter(l => l.viewMode === 'screen');
+        if (screenLayers.length > 0) {
+            backend.setView(this._view);
+            try {
+                for (const layer of screenLayers) {
+                    layer.update(delta);
+                    layer.render(backend);
+                }
+            }
+            finally {
+                backend.setView(sceneView);
+            }
+        }
+    }
+    _onKeyDown(channel) {
+        switch (channel) {
+            case Keyboard.F1:
+                this.layers.performance.visible = !this.layers.performance.visible;
+                break;
+            case Keyboard.F2:
+                this.layers.boundingBoxes.visible = !this.layers.boundingBoxes.visible;
+                break;
+            case Keyboard.F3:
+                this.layers.hitTest.visible = !this.layers.hitTest.visible;
+                break;
+            case Keyboard.F4:
+                this.layers.pointerStack.visible = !this.layers.pointerStack.visible;
+                break;
+        }
+    }
+}
+
+export { DebugOverlay };
+//# sourceMappingURL=DebugOverlay.js.map

package/dist/esm/debug/DebugOverlay.js.map

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

package/dist/esm/debug/HitTestLayer.d.ts

@@ -0,0 +1,23 @@
+import { DebugLayer } from './DebugLayer';
+import type { DebugLayerViewMode } from './DebugLayer';
+import type { Time } from '@/core/Time';
+import type { RenderBackend } from '@/rendering/RenderBackend';
+import type { Application } from '@/core/Application';
+/**
+ * Debug layer that draws outlines around interactive scene nodes.
+ * - Magenta: interactive but idle.
+ * - Yellow: currently hovered.
+ * - Cyan: pointer-captured (drag in progress).
+ * - Faint gray quadrant outlines when the spatial index is active (i.e.
+ *   at least one interactive node is present in the scene).
+ * World-space.
+ */
+export declare class HitTestLayer extends DebugLayer {
+    private _graphics;
+    constructor(app: Application);
+    get viewMode(): DebugLayerViewMode;
+    update(_delta: Time): void;
+    render(backend: RenderBackend): void;
+    destroy(): void;
+    private _walkNode;
+}

package/dist/esm/debug/HitTestLayer.js

@@ -0,0 +1,109 @@
+import { DebugLayer } from './DebugLayer.js';
+import { Graphics } from '../rendering/primitives/Graphics.js';
+import { Color } from '../core/Color.js';
+import '../math/Size.js';
+import '../core/Time.js';
+import '../core/SceneNode.js';
+import '../math/Rectangle.js';
+import '../rendering/types.js';
+import '../rendering/View.js';
+import '../rendering/texture/RenderTexture.js';
+
+// Color constants (created once, reused).
+const colorIdle = new Color(1, 0, 1, 0.6); // magenta
+const colorHovered = new Color(1, 1, 0, 0.9); // yellow
+const colorCaptured = new Color(0, 1, 1, 0.9); // cyan
+const colorQuadrant = new Color(0.5, 0.5, 0.5, 0.3); // faint gray
+/**
+ * Debug layer that draws outlines around interactive scene nodes.
+ * - Magenta: interactive but idle.
+ * - Yellow: currently hovered.
+ * - Cyan: pointer-captured (drag in progress).
+ * - Faint gray quadrant outlines when the spatial index is active (i.e.
+ *   at least one interactive node is present in the scene).
+ * World-space.
+ */
+class HitTestLayer extends DebugLayer {
+    _graphics = null;
+    constructor(app) {
+        super(app);
+    }
+    get viewMode() {
+        return 'world';
+    }
+    update(_delta) {
+        // Nothing to pre-compute; all state is read in render().
+    }
+    render(backend) {
+        const root = this._app.sceneManager.scene?.root;
+        if (!root) {
+            return;
+        }
+        if (this._graphics === null) {
+            this._graphics = new Graphics();
+        }
+        const gfx = this._graphics;
+        gfx.clear();
+        gfx.lineWidth = 1;
+        // Determine hovered and captured sets for color-coding.
+        const interaction = this._app.interaction;
+        const hoveredNode = interaction.getHoveredNode();
+        const capturedNodes = new Set(interaction.getCapturedNodes());
+        // Walk scene and draw outlines for interactive nodes.
+        this._walkNode(root, gfx, hoveredNode, capturedNodes);
+        // Draw quadtree regions when the spatial index is active.
+        const quadtree = interaction._getDebugQuadtree();
+        if (quadtree !== null) {
+            gfx.lineColor = colorQuadrant;
+            quadtree._walkBounds((rect) => {
+                gfx.moveTo(rect.left, rect.top);
+                gfx.lineTo(rect.right, rect.top);
+                gfx.lineTo(rect.right, rect.bottom);
+                gfx.lineTo(rect.left, rect.bottom);
+                gfx.lineTo(rect.left, rect.top);
+            });
+        }
+        gfx.render(backend);
+    }
+    destroy() {
+        if (this._graphics !== null) {
+            this._graphics.destroy();
+            this._graphics = null;
+        }
+    }
+    // -----------------------------------------------------------------------
+    _walkNode(node, gfx, hovered, captured) {
+        if (!node.visible) {
+            return;
+        }
+        if (node.interactive) {
+            const bounds = node.getBounds();
+            if (bounds.width > 0 && bounds.height > 0) {
+                if (captured.has(node)) {
+                    gfx.lineColor = colorCaptured;
+                }
+                else if (node === hovered) {
+                    gfx.lineColor = colorHovered;
+                }
+                else {
+                    gfx.lineColor = colorIdle;
+                }
+                gfx.moveTo(bounds.left, bounds.top);
+                gfx.lineTo(bounds.right, bounds.top);
+                gfx.lineTo(bounds.right, bounds.bottom);
+                gfx.lineTo(bounds.left, bounds.bottom);
+                gfx.lineTo(bounds.left, bounds.top);
+            }
+        }
+        // Recurse into Container children.
+        const container = node;
+        if (Array.isArray(container.children)) {
+            for (const child of container.children) {
+                this._walkNode(child, gfx, hovered, captured);
+            }
+        }
+    }
+}
+
+export { HitTestLayer };
+//# sourceMappingURL=HitTestLayer.js.map

package/dist/esm/debug/HitTestLayer.js.map

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

package/dist/esm/debug/PerformanceLayer.d.ts

@@ -0,0 +1,21 @@
+import { DebugLayer } from './DebugLayer';
+import type { Time } from '@/core/Time';
+import type { RenderBackend } from '@/rendering/RenderBackend';
+import type { Application } from '@/core/Application';
+export declare class PerformanceLayer extends DebugLayer {
+    private readonly _fpsSamples;
+    private _fpsSampleIndex;
+    private readonly _sparkSamples;
+    private _sparkSampleIndex;
+    private _root;
+    private _textFps;
+    private _textFrame;
+    private _textDraws;
+    private _textNodes;
+    private _sparkline;
+    constructor(app: Application);
+    update(delta: Time): void;
+    render(backend: RenderBackend): void;
+    destroy(): void;
+    private _build;
+}