@codexo/exojs 0.6.12 → 0.7.12

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/core/types.d.ts

@@ -1,14 +1,33 @@
 import type { Rectangle } from '@/math/Rectangle';
+/** Union of every concrete `TypedArray` constructor result. */
 export type TypedArray = Int8Array | Uint8Array | Int16Array | Uint16Array | Int32Array | Uint32Array | Uint8ClampedArray | Float32Array | Float64Array;
+/**
+ * Multiplier converting a unit-typed time value to milliseconds. Pair with
+ * {@link Time.set} / {@link Time.add} as the `factor` argument; canonical
+ * values are exposed on the `Time` class as `Time.milliseconds`,
+ * `Time.seconds`, `Time.minutes`, `Time.hours`.
+ */
 export type TimeInterval = 1 | 1000 | 60000 | 3600000;
+/**
+ * Type-level mapper that rebuilds `Enum` with every value retyped to `Type`.
+ * Useful for "table-driven" lookups keyed by an enum.
+ */
 export type TypedEnum<Enum, Type> = {
     [Key in keyof Enum]: Type;
 };
+/** Type-level extractor of an object's value type, equivalent to `T[keyof T]`. */
 export type ValueOf<T> = T[keyof T];
+/** Strips `readonly` modifiers from every property of `T`. */
 export type Mutable<T> = {
     -readonly [P in keyof T]: T[P];
 };
+/**
+ * Anything the rendering pipeline can sample as a texture source: a loaded
+ * image, an offscreen canvas, a playing video, or `null` when no source has
+ * been assigned yet.
+ */
 export type TextureSource = HTMLImageElement | HTMLCanvasElement | HTMLVideoElement | null;
+/** Common playback configuration for both {@link Sound} and {@link Music}. */
 export interface PlaybackOptions {
     volume: number;
     playbackRate: number;
@@ -16,14 +35,32 @@ export interface PlaybackOptions {
     muted: boolean;
     time: number;
 }
+/**
+ * Structural interface for value types that support a deep clone and an
+ * in-place copy from a same-type source. Implemented by {@link Color},
+ * {@link Time}, {@link Vector}, {@link Matrix}, {@link Rectangle}, and
+ * other ExoJS value classes.
+ */
 export interface Cloneable {
     clone(): this;
     copy(source: this): this;
 }
+/**
+ * Structural interface for anything that holds resources requiring explicit
+ * release. ExoJS value types tend to implement this even when no external
+ * resources are held (no-op `destroy()`) so consumers can call uniformly.
+ */
 export interface Destroyable {
     destroy(): void;
 }
+/** Anything that can produce an axis-aligned bounding {@link Rectangle}. */
 export interface HasBoundingBox {
     getBounds(): Rectangle;
 }
+/**
+ * `HTMLMediaElement` ready-state events the streaming asset factories
+ * ({@link MusicFactory}, {@link VideoFactory}) accept as the load-completion
+ * signal. Pick the earliest event that meets your latency requirement;
+ * `'canplaythrough'` is the safest default.
+ */
 export type StreamingLoadEvent = 'loadedmetadata' | 'loadeddata' | 'canplay' | 'canplaythrough';

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

@@ -1,22 +1,70 @@
 import { Size } from '@/math/Size';
 import type { TextureSource } from '@/core/types';
 import { Time } from '@/core/Time';
+/**
+ * Random number in the range `[min, max]` from the module-level shared
+ * {@link Random} instance. Pass no arguments for `[0, 1)`. For deterministic
+ * sequences create your own seeded `Random` instance instead.
+ */
 export declare const rand: (min?: number, max?: number) => number;
+/** Empty function literal — useful as a default callback that does nothing. */
 export declare const noop: () => void;
+/** `preventDefault()` + `stopImmediatePropagation()` on an event in one call. */
 export declare const stopEvent: (event: Event) => void;
+/** Snapshot at module-load: `true` when `AudioContext` is defined. */
 export declare const supportsWebAudio: boolean;
+/** Snapshot at module-load: `true` when `indexedDB` is defined. */
 export declare const supportsIndexedDb: boolean;
+/** Snapshot at module-load: `true` when the touch event API is detected. */
 export declare const supportsTouchEvents: boolean;
+/** Snapshot at module-load: `true` when `PointerEvent` is defined. */
 export declare const supportsPointerEvents: boolean;
+/**
+ * Lazy-cached probe for the third `EventListenerOptions` argument to
+ * `addEventListener` (passive/capture object). Older browsers ignore the
+ * object and treat it as the boolean `useCapture`. Probed once on first call.
+ */
 export declare const supportsEventOptions: () => boolean;
+/** High-resolution monotonic clock reading in milliseconds. Wraps `performance.now()`. */
 export declare const getPreciseTime: () => number;
+/** Construct a {@link Time} value from a millisecond count. */
 export declare const milliseconds: (value: number) => Time;
+/** Construct a {@link Time} value from a second count. */
 export declare const seconds: (value: number) => Time;
+/** Construct a {@link Time} value from a minute count. */
 export declare const minutes: (value: number) => Time;
+/** Construct a {@link Time} value from an hour count. */
 export declare const hours: (value: number) => Time;
+/** Shared zero-length `ArrayBuffer` for use as a sentinel / default. */
 export declare const emptyArrayBuffer: ArrayBuffer;
+/**
+ * Remove `amount` items from `array` starting at `startIndex`, in place.
+ * Faster than `Array.prototype.splice` for the common case because it
+ * skips the allocation of a removed-items array. Returns the same array
+ * for chaining.
+ */
 export declare const removeArrayItems: <T = unknown>(array: Array<T>, startIndex: number, amount: number) => Array<T>;
+/**
+ * `true` when the host browser reports any of the given media-codec
+ * strings as playable on a transient `<audio>` element. Use to gate format
+ * selection (e.g. prefer OGG, fall back to MP3).
+ */
 export declare const supportsCodec: (...codecs: Array<string>) => boolean;
+/**
+ * Resolve the natural pixel dimensions of any `CanvasImageSource`. Returns
+ * a {@link Size.temp} scratch instance — copy if you need to retain the
+ * value. Returns {@link Size.zero} when the source has no resolvable size.
+ */
 export declare const getCanvasSourceSize: (source: CanvasImageSource) => Size;
+/**
+ * Resolve the natural pixel dimensions of a {@link TextureSource}, treating
+ * `null` as zero. Same caveats as {@link getCanvasSourceSize} — shared
+ * scratch instance.
+ */
 export declare const getTextureSourceSize: (source: TextureSource) => Size;
+/**
+ * Render any `CanvasImageSource` to the shared scratch 2D-canvas and return
+ * the result as a `data:` URL. Used by {@link Application.setCursor} to
+ * accept arbitrary image sources as the CSS cursor value.
+ */
 export declare const canvasSourceToDataUrl: (source: CanvasImageSource) => string;

package/dist/esm/core/utils.js

@@ -44,16 +44,32 @@ const getRandom = () => {
     }
     return internalRandom;
 };
+/**
+ * Random number in the range `[min, max]` from the module-level shared
+ * {@link Random} instance. Pass no arguments for `[0, 1)`. For deterministic
+ * sequences create your own seeded `Random` instance instead.
+ */
 const rand = (min, max) => getRandom().next(min, max);
+/** Empty function literal — useful as a default callback that does nothing. */
 const noop = () => { };
+/** `preventDefault()` + `stopImmediatePropagation()` on an event in one call. */
 const stopEvent = (event) => {
     event.preventDefault();
     event.stopImmediatePropagation();
 };
+/** Snapshot at module-load: `true` when `AudioContext` is defined. */
 const supportsWebAudio = typeof AudioContext !== 'undefined';
+/** Snapshot at module-load: `true` when `indexedDB` is defined. */
 const supportsIndexedDb = typeof indexedDB !== 'undefined';
+/** Snapshot at module-load: `true` when the touch event API is detected. */
 const supportsTouchEvents = canUseWindow() && 'ontouchstart' in window;
+/** Snapshot at module-load: `true` when `PointerEvent` is defined. */
 const supportsPointerEvents = typeof PointerEvent !== 'undefined';
+/**
+ * Lazy-cached probe for the third `EventListenerOptions` argument to
+ * `addEventListener` (passive/capture object). Older browsers ignore the
+ * object and treat it as the boolean `useCapture`. Probed once on first call.
+ */
 const supportsEventOptions = () => {
     if (supportsEventOptionsValue !== null) {
         return supportsEventOptionsValue;
@@ -78,12 +94,24 @@ const supportsEventOptions = () => {
     supportsEventOptionsValue = supportsPassive;
     return supportsEventOptionsValue;
 };
+/** High-resolution monotonic clock reading in milliseconds. Wraps `performance.now()`. */
 const getPreciseTime = () => performance.now();
+/** Construct a {@link Time} value from a millisecond count. */
 const milliseconds = (value) => new Time(value, Time.milliseconds);
+/** Construct a {@link Time} value from a second count. */
 const seconds = (value) => new Time(value, Time.seconds);
+/** Construct a {@link Time} value from a minute count. */
 const minutes = (value) => new Time(value, Time.minutes);
+/** Construct a {@link Time} value from an hour count. */
 const hours = (value) => new Time(value, Time.hours);
+/** Shared zero-length `ArrayBuffer` for use as a sentinel / default. */
 const emptyArrayBuffer = new ArrayBuffer(0);
+/**
+ * Remove `amount` items from `array` starting at `startIndex`, in place.
+ * Faster than `Array.prototype.splice` for the common case because it
+ * skips the allocation of a removed-items array. Returns the same array
+ * for chaining.
+ */
 const removeArrayItems = (array, startIndex, amount) => {
     if (startIndex < array.length && amount > 0) {
         const removeCount = (startIndex + amount > array.length)
@@ -97,7 +125,17 @@ const removeArrayItems = (array, startIndex, amount) => {
     }
     return array;
 };
+/**
+ * `true` when the host browser reports any of the given media-codec
+ * strings as playable on a transient `<audio>` element. Use to gate format
+ * selection (e.g. prefer OGG, fall back to MP3).
+ */
 const supportsCodec = (...codecs) => codecs.some((codec) => getAudioElement().canPlayType(codec).replace(codecNotSupportedPattern, ''));
+/**
+ * Resolve the natural pixel dimensions of any `CanvasImageSource`. Returns
+ * a {@link Size.temp} scratch instance — copy if you need to retain the
+ * value. Returns {@link Size.zero} when the source has no resolvable size.
+ */
 const getCanvasSourceSize = (source) => {
     const dynamicSource = source;
     if (source instanceof HTMLImageElement) {
@@ -117,12 +155,22 @@ const getCanvasSourceSize = (source) => {
     }
     return Size.zero;
 };
+/**
+ * Resolve the natural pixel dimensions of a {@link TextureSource}, treating
+ * `null` as zero. Same caveats as {@link getCanvasSourceSize} — shared
+ * scratch instance.
+ */
 const getTextureSourceSize = (source) => {
     if (source === null) {
         return Size.zero;
     }
     return getCanvasSourceSize(source);
 };
+/**
+ * Render any `CanvasImageSource` to the shared scratch 2D-canvas and return
+ * the result as a `data:` URL. Used by {@link Application.setCursor} to
+ * accept arbitrary image sources as the CSS cursor value.
+ */
 const canvasSourceToDataUrl = (source) => {
     const { width, height } = getCanvasSourceSize(source);
     const canvasElement = getCanvasElement();

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

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sources":["../../../../src/core/utils.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sources":["../../../../src/core/utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAYA,MAAM,wBAAwB,GAAG,MAAM;AAEvC,IAAI,oBAAoB,GAA4B,IAAI;AACxD,IAAI,qBAAqB,GAA6B,IAAI;AAC1D,IAAI,qBAAqB,GAAoC,IAAI;AACjE,IAAI,cAAc,GAAkB,IAAI;AACxC,IAAI,yBAAyB,GAAmB,IAAI;AAEpD,MAAM,cAAc,GAAG,MAAe,OAAO,QAAQ,KAAK,WAAW;AACrE,MAAM,YAAY,GAAG,MAAe,OAAO,MAAM,KAAK,WAAW;AAEjE,MAAM,eAAe,GAAG,MAAuB;AAC3C,IAAA,IAAI,CAAC,cAAc,EAAE,EAAE;AACnB,QAAA,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC;IACzE;AAEA,IAAA,IAAI,oBAAoB,KAAK,IAAI,EAAE;AAC/B,QAAA,oBAAoB,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAqB;IAC9E;AAEA,IAAA,OAAO,oBAAoB;AAC/B,CAAC;AAED,MAAM,gBAAgB,GAAG,MAAwB;AAC7C,IAAA,IAAI,CAAC,cAAc,EAAE,EAAE;AACnB,QAAA,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC;IACpE;AAEA,IAAA,IAAI,qBAAqB,KAAK,IAAI,EAAE;AAChC,QAAA,qBAAqB,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAsB;IACjF;AAEA,IAAA,OAAO,qBAAqB;AAChC,CAAC;AAED,MAAM,gBAAgB,GAAG,MAA+B;AACpD,IAAA,IAAI,qBAAqB,KAAK,IAAI,EAAE;QAChC,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAEnD,IAAI,CAAC,OAAO,EAAE;AACV,YAAA,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC;QAC5D;QAEA,qBAAqB,GAAG,OAAO;IACnC;AAEA,IAAA,OAAO,qBAAqB;AAChC,CAAC;AAED,MAAM,SAAS,GAAG,MAAa;AAC3B,IAAA,IAAI,cAAc,KAAK,IAAI,EAAE;AACzB,QAAA,cAAc,GAAG,IAAI,MAAM,EAAE;IACjC;AAEA,IAAA,OAAO,cAAc;AACzB,CAAC;AAED;;;;AAIG;MACU,IAAI,GAAG,CAAC,GAAY,EAAE,GAAY,KAAa,SAAS,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG;AAErF;MACa,IAAI,GAAG,MAAW,EAAwB;AAEvD;AACO,MAAM,SAAS,GAAG,CAAC,KAAY,KAAU;IAC5C,KAAK,CAAC,cAAc,EAAE;IACtB,KAAK,CAAC,wBAAwB,EAAE;AACpC;AAEA;MACa,gBAAgB,GAAY,OAAO,YAAY,KAAK;AACjE;MACa,iBAAiB,GAAY,OAAO,SAAS,KAAK;AAC/D;AACO,MAAM,mBAAmB,GAAY,YAAY,EAAE,IAAI,cAAc,IAAI;AAChF;MACa,qBAAqB,GAAY,OAAO,YAAY,KAAK;AAEtE;;;;AAIG;AACI,MAAM,oBAAoB,GAAG,MAAc;AAC9C,IAAA,IAAI,yBAAyB,KAAK,IAAI,EAAE;AACpC,QAAA,OAAO,yBAAyB;IACpC;AAEA,IAAA,IAAI,CAAC,YAAY,EAAE,EAAE;QACjB,yBAAyB,GAAG,KAAK;AAEjC,QAAA,OAAO,yBAAyB;IACpC;IAEA,IAAI,eAAe,GAAG,KAAK;AAE3B,IAAA,IAAI;AACA,QAAA,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE;AAClC,YAAA,IAAI,OAAO,GAAA;gBACP,eAAe,GAAG,IAAI;AAEtB,gBAAA,OAAO,KAAK;YAChB;AACH,SAAA,CAAC;AACF,QAAA,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC;IAC5C;IAAE,OAAO,CAAC,EAAE;;IAEZ;IAEA,yBAAyB,GAAG,eAAe;AAE3C,IAAA,OAAO,yBAAyB;AACpC;AAEA;AACO,MAAM,cAAc,GAAG,MAAc,WAAW,CAAC,GAAG;AAE3D;AACO,MAAM,YAAY,GAAG,CAAC,KAAa,KAAW,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY;AACtF;AACO,MAAM,OAAO,GAAG,CAAC,KAAa,KAAW,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO;AAC5E;AACO,MAAM,OAAO,GAAG,CAAC,KAAa,KAAW,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO;AAC5E;AACO,MAAM,KAAK,GAAG,CAAC,KAAa,KAAW,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK;AAExE;MACa,gBAAgB,GAAG,IAAI,WAAW,CAAC,CAAC;AAEjD;;;;;AAKG;AACI,MAAM,gBAAgB,GAAG,CAAc,KAAe,EAAE,UAAkB,EAAE,MAAc,KAAc;IAC3G,IAAI,UAAU,GAAG,KAAK,CAAC,MAAM,IAAI,MAAM,GAAG,CAAC,EAAE;QACzC,MAAM,WAAW,GAAG,CAAC,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM;AACnD,eAAG,KAAK,CAAC,MAAM,GAAG,UAAU;cAC1B,MAAM;QAEZ,MAAM,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;AAE3C,QAAA,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE;YACtC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,WAAW,CAAC;QACrC;AAEA,QAAA,KAAK,CAAC,MAAM,GAAG,MAAM;IACzB;AAEA,IAAA,OAAO,KAAK;AAChB;AAEA;;;;AAIG;AACI,MAAM,aAAa,GAAG,CAAC,GAAG,MAAqB,KAAc,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,eAAe,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC;AAErK;;;;AAIG;AACI,MAAM,mBAAmB,GAAG,CAAC,MAAyB,KAAU;IACnE,MAAM,aAAa,GAAG,MAAqC;AAE3D,IAAA,IAAI,MAAM,YAAY,gBAAgB,EAAE;AACpC,QAAA,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC;IACnE;AAEA,IAAA,IAAI,MAAM,YAAY,gBAAgB,EAAE;AACpC,QAAA,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC;IAC/D;AAEA,IAAA,IAAI,MAAM,YAAY,UAAU,EAAE;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;IACzD;AAEA,IAAA,IAAI,OAAO,aAAa,CAAC,YAAY,KAAK,QAAQ,IAAI,OAAO,aAAa,CAAC,aAAa,KAAK,QAAQ,EAAE;AACnG,QAAA,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,YAAY,EAAE,aAAa,CAAC,aAAa,CAAC;IACjF;AAEA,IAAA,IAAI,OAAO,aAAa,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,aAAa,CAAC,MAAM,KAAK,QAAQ,EAAE;AACrF,QAAA,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC;IACnE;IAEA,OAAO,IAAI,CAAC,IAAI;AACpB;AAEA;;;;AAIG;AACI,MAAM,oBAAoB,GAAG,CAAC,MAAqB,KAAU;AAChE,IAAA,IAAI,MAAM,KAAK,IAAI,EAAE;QACjB,OAAO,IAAI,CAAC,IAAI;IACpB;AAEA,IAAA,OAAO,mBAAmB,CAAC,MAAM,CAAC;AACtC;AAEA;;;;AAIG;AACI,MAAM,qBAAqB,GAAG,CAAC,MAAyB,KAAY;IACvE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAAC,MAAM,CAAC;AACrD,IAAA,MAAM,aAAa,GAAG,gBAAgB,EAAE;AAExC,IAAA,aAAa,CAAC,KAAK,GAAG,KAAK;AAC3B,IAAA,aAAa,CAAC,MAAM,GAAG,MAAM;AAE7B,IAAA,gBAAgB,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC;AAEzD,IAAA,OAAO,aAAa,CAAC,SAAS,EAAE;AACpC;;;;"}

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

@@ -0,0 +1,26 @@
+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);
+    /** Renders in world-space so outlines align with scene node positions. */
+    get viewMode(): DebugLayerViewMode;
+    /** No per-frame pre-computation required; all state is derived in {@link render}. */
+    update(_delta: Time): void;
+    /**
+     * Walk the scene tree and draw a colored rectangle outline around every
+     * visible node that has non-zero bounds. Outline hue cycles by `zIndex`
+     * so overlapping nodes are visually distinguishable.
+     */
+    render(backend: RenderBackend): void;
+    /** Release the internal {@link Graphics} primitive. */
+    destroy(): void;
+    private _walkNode;
+}

package/dist/esm/debug/BoundingBoxesLayer.js

@@ -0,0 +1,136 @@
+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);
+    }
+    /** Renders in world-space so outlines align with scene node positions. */
+    get viewMode() {
+        return 'world';
+    }
+    /** No per-frame pre-computation required; all state is derived in {@link render}. */
+    update(_delta) {
+        // State is built in render() each frame; nothing to pre-compute here.
+    }
+    /**
+     * Walk the scene tree and draw a colored rectangle outline around every
+     * visible node that has non-zero bounds. Outline hue cycles by `zIndex`
+     * so overlapping nodes are visually distinguishable.
+     */
+    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);
+    }
+    /** Release the internal {@link Graphics} primitive. */
+    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,42 @@
+import type { Time } from '@/core/Time';
+import type { RenderBackend } from '@/rendering/RenderBackend';
+import type { Application } from '@/core/Application';
+/**
+ * Determines the coordinate space a {@link DebugLayer} renders into.
+ * `'screen'` uses the overlay's pixel-space view; `'world'` uses the scene's
+ * current world-space view and renders beneath screen-space panels.
+ */
+export type DebugLayerViewMode = 'screen' | 'world';
+/**
+ * Abstract base for a single diagnostic overlay layer. Subclasses produce a
+ * visual (outlines, text panels, sparklines, etc.) that
+ * {@link DebugOverlay} composites each frame when {@link visible} is `true`.
+ *
+ * Concrete layers are tree-shakeable via the `@codexo/exojs/debug` subpath
+ * and are not loaded unless explicitly imported.
+ */
+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;
+    /**
+     * Release any scene-graph nodes or resources owned by this layer.
+     * Called by {@link DebugOverlay.destroy}. The base implementation is a
+     * no-op; subclasses override to tear down their {@link Container} subtrees.
+     */
+    destroy(): void;
+}

package/dist/esm/debug/DebugLayer.js

@@ -0,0 +1,34 @@
+/**
+ * Abstract base for a single diagnostic overlay layer. Subclasses produce a
+ * visual (outlines, text panels, sparklines, etc.) that
+ * {@link DebugOverlay} composites each frame when {@link visible} is `true`.
+ *
+ * Concrete layers are tree-shakeable via the `@codexo/exojs/debug` subpath
+ * and are not loaded unless explicitly imported.
+ */
+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';
+    }
+    /**
+     * Release any scene-graph nodes or resources owned by this layer.
+     * Called by {@link DebugOverlay.destroy}. The base implementation is a
+     * no-op; subclasses override to tear down their {@link Container} subtrees.
+     */
+    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":"AAWA;;;;;;;AAOG;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;AAYA;;;;AAIG;IACI,OAAO,GAAA;;IAEd;AACH;;;;"}

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

@@ -0,0 +1,59 @@
+import { PerformanceLayer } from './PerformanceLayer';
+import { BoundingBoxesLayer } from './BoundingBoxesLayer';
+import { HitTestLayer } from './HitTestLayer';
+import { PointerStackLayer } from './PointerStackLayer';
+import type { Application } from '@/core/Application';
+/**
+ * Typed map of the four built-in diagnostic layers managed by
+ * {@link DebugOverlay}. Access individual layers to toggle visibility or
+ * interact with layer-specific state.
+ */
+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;
+    /** The four built-in diagnostic layers. Toggle each layer's `visible` flag or use the F1–F4 keybindings. */
+    readonly layers: DebugLayers;
+    private readonly _app;
+    private readonly _view;
+    private readonly _onFrameHandler;
+    private readonly _onKeyDownHandler;
+    private readonly _onResizeHandler;
+    constructor(app: Application);
+    /**
+     * Unsubscribe from all application events, destroy every layer, and
+     * release the overlay's internal {@link View}. Call this when you no
+     * longer need the overlay to avoid memory leaks.
+     */
+    destroy(): void;
+    private _onResize;
+    private _onFrame;
+    private _onKeyDown;
+}