kiwiengine 0.0.1-alpha → 0.5.2

package/lib/renderer/renderer.js

@@ -0,0 +1,145 @@
+import { autoDetectRenderer, Container as PixiContainer } from 'pixi.js';
+import { debugMode } from '../debug';
+import { setStyle } from '../dom/dom-utils';
+import { RenderableNode } from '../node/core/renderable';
+import { Camera } from './camera';
+import { RendererContainerManager } from './container-manager';
+import { FpsDisplay } from './fps-display';
+import { Layer } from './layer';
+import { Ticker } from './ticker';
+export class Renderer extends RenderableNode {
+    container;
+    #containerManager;
+    #ticker = new Ticker((dt) => this.#render(dt));
+    camera = new Camera();
+    fpsDisplay;
+    #logicalWidth;
+    #logicalHeight;
+    #backgroundColor;
+    #backgroundAlpha;
+    #pixiRenderer;
+    #layers = {};
+    _isSizeDirty = false;
+    canvasWidth = 0;
+    canvasHeight = 0;
+    canvasLeft = 0;
+    canvasTop = 0;
+    viewportScale = 1;
+    centerX = 0;
+    centerY = 0;
+    constructor(container, options) {
+        super(new PixiContainer({ sortableChildren: true }));
+        this.container = container;
+        this.renderer = this;
+        this.worldTransform.x.v = 0;
+        this.worldTransform.y.v = 0;
+        this.worldTransform.resetDirty();
+        this.#containerManager = new RendererContainerManager(container);
+        this.#containerManager.on('resize', (width, height) => this.#updateSize(width, height));
+        this.camera.on('positionChanged', () => this.#updatePosition());
+        this.camera.on('scaleChanged', () => this.#updatePosition());
+        if (options) {
+            if (options.logicalWidth !== undefined)
+                this.#logicalWidth = options.logicalWidth;
+            if (options.logicalHeight !== undefined)
+                this.#logicalHeight = options.logicalHeight;
+            if (options.backgroundColor !== undefined)
+                this.#backgroundColor = options.backgroundColor;
+            if (options.backgroundAlpha !== undefined)
+                this.#backgroundAlpha = options.backgroundAlpha;
+            if (options.layers) {
+                for (const layerOption of options.layers) {
+                    const layer = new Layer(layerOption.drawOrder);
+                    this._pixiContainer.addChild(layer._pixiContainer);
+                    this.#layers[layerOption.name] = layer;
+                }
+            }
+        }
+        if (debugMode) {
+            this.fpsDisplay = new FpsDisplay(container);
+        }
+        this.init();
+    }
+    async init() {
+        const options = {
+            eventMode: 'none',
+            resolution: window.devicePixelRatio,
+        };
+        if (this.#logicalWidth)
+            options.width = this.#logicalWidth;
+        if (this.#logicalHeight)
+            options.height = this.#logicalHeight;
+        if (this.#backgroundColor)
+            options.backgroundColor = this.#backgroundColor;
+        if (this.#backgroundAlpha)
+            options.backgroundAlpha = this.#backgroundAlpha;
+        const pr = await autoDetectRenderer(options);
+        setStyle(pr.canvas, {
+            position: 'absolute',
+            touchAction: 'auto',
+        });
+        this.container.appendChild(pr.canvas);
+        this.#pixiRenderer = pr;
+        const cr = this.container.getBoundingClientRect();
+        this.#updateSize(cr.width, cr.height);
+    }
+    #updatePosition() {
+        const S = this.camera.scale;
+        this._pixiContainer.scale = S;
+        this._pixiContainer.position.set(this.centerX - this.camera.x * S, this.centerY - this.camera.y * S);
+    }
+    #updateSize(containerWidth, containerHeight) {
+        const canvasWidth = this.#logicalWidth ?? containerWidth;
+        const canvasHeight = this.#logicalHeight ?? containerHeight;
+        this.canvasWidth = canvasWidth;
+        this.canvasHeight = canvasHeight;
+        this.centerX = canvasWidth / 2;
+        this.centerY = canvasHeight / 2;
+        this.#updatePosition();
+        const S = Math.min(containerWidth / canvasWidth, containerHeight / canvasHeight);
+        this.viewportScale = S;
+        const displayWidth = canvasWidth * S;
+        const displayHeight = canvasHeight * S;
+        const canvasLeft = (containerWidth - displayWidth) / 2;
+        const canvasTop = (containerHeight - displayHeight) / 2;
+        this.canvasLeft = canvasLeft;
+        this.canvasTop = canvasTop;
+        if (this.#pixiRenderer) {
+            this.#pixiRenderer.resize(canvasWidth, canvasHeight);
+            setStyle(this.#pixiRenderer.canvas, {
+                width: `${displayWidth}px`,
+                height: `${displayHeight}px`,
+                left: `${canvasLeft}px`,
+                top: `${canvasTop}px`,
+            });
+            this.emit('resize', canvasWidth, canvasHeight);
+        }
+        this._isSizeDirty = true;
+    }
+    #render(dt) {
+        this._isSizeDirty = false;
+        this.update(dt);
+        this._updateWorldTransform();
+        this.#pixiRenderer?.render(this._pixiContainer);
+        this.fpsDisplay?.update();
+    }
+    _addToLayer(node, layerName) {
+        const layer = this.#layers[layerName];
+        if (!layer)
+            throw new Error(`Layer ${layerName} does not exist.`);
+        layer._pixiContainer.addChild(node._pixiContainer);
+    }
+    remove() {
+        this.#containerManager.remove();
+        this.#ticker.remove();
+        this.#pixiRenderer?.destroy();
+        this.fpsDisplay?.remove();
+        super.remove();
+    }
+    screenToWorld(screenX, screenY) {
+        const x = (screenX - this.canvasLeft) / this.viewportScale - this.canvasWidth / 2;
+        const y = (screenY - this.canvasTop) / this.viewportScale - this.canvasHeight / 2;
+        return { x, y };
+    }
+}
+//# sourceMappingURL=renderer.js.map

package/lib/renderer/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../src/renderer/renderer.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventMap } from '@webtaku/event-emitter'\nimport { AutoDetectOptions, autoDetectRenderer, ColorSource, Container as PixiContainer, Renderer as PixiRenderer } from 'pixi.js'\nimport { debugMode } from '../debug'\nimport { setStyle } from '../dom/dom-utils'\nimport { RenderableNode } from '../node/core/renderable'\nimport { Camera } from './camera'\nimport { RendererContainerManager } from './container-manager'\nimport { FpsDisplay } from './fps-display'\nimport { Layer } from './layer'\nimport { Ticker } from './ticker'\n\nexport type RendererOptions = {\n  logicalWidth?: number\n  logicalHeight?: number\n  backgroundColor?: ColorSource\n  backgroundAlpha?: number\n  layers?: { name: string; drawOrder: number }[]\n}\n\nexport class Renderer extends RenderableNode<PixiContainer, {\n  resize: (width: number, height: number) => void\n}> {\n  #containerManager: RendererContainerManager\n  #ticker = new Ticker((dt) => this.#render(dt))\n  camera = new Camera()\n  fpsDisplay?: FpsDisplay\n\n  #logicalWidth?: number\n  #logicalHeight?: number\n  #backgroundColor?: ColorSource\n  #backgroundAlpha?: number\n\n  #pixiRenderer?: PixiRenderer\n  #layers: { [name: string]: Layer } = {}\n  _isSizeDirty = false\n\n  canvasWidth = 0\n  canvasHeight = 0\n  canvasLeft = 0\n  canvasTop = 0\n  viewportScale = 1\n  centerX = 0\n  centerY = 0\n\n  constructor(public container: HTMLElement, options?: RendererOptions) {\n    super(new PixiContainer({ sortableChildren: true }))\n    this.renderer = this\n\n    this.worldTransform.x.v = 0\n    this.worldTransform.y.v = 0\n    this.worldTransform.resetDirty()\n\n    this.#containerManager = new RendererContainerManager(container)\n    this.#containerManager.on('resize', (width, height) => this.#updateSize(width, height))\n\n    this.camera.on('positionChanged', () => this.#updatePosition())\n    this.camera.on('scaleChanged', () => this.#updatePosition())\n\n    if (options) {\n      if (options.logicalWidth !== undefined) this.#logicalWidth = options.logicalWidth\n      if (options.logicalHeight !== undefined) this.#logicalHeight = options.logicalHeight\n      if (options.backgroundColor !== undefined) this.#backgroundColor = options.backgroundColor\n      if (options.backgroundAlpha !== undefined) this.#backgroundAlpha = options.backgroundAlpha\n\n      if (options.layers) {\n        for (const layerOption of options.layers) {\n          const layer = new Layer(layerOption.drawOrder)\n          this._pixiContainer.addChild(layer._pixiContainer)\n          this.#layers[layerOption.name] = layer\n        }\n      }\n    }\n\n    if (debugMode) {\n      this.fpsDisplay = new FpsDisplay(container)\n    }\n\n    this.init()\n  }\n\n  private async init() {\n    const options: Partial<AutoDetectOptions> = {\n      eventMode: 'none',\n      resolution: window.devicePixelRatio,\n    }\n\n    if (this.#logicalWidth) options.width = this.#logicalWidth\n    if (this.#logicalHeight) options.height = this.#logicalHeight\n    if (this.#backgroundColor) options.backgroundColor = this.#backgroundColor\n    if (this.#backgroundAlpha) options.backgroundAlpha = this.#backgroundAlpha\n\n    const pr = await autoDetectRenderer(options)\n\n    setStyle(pr.canvas, {\n      position: 'absolute',\n      touchAction: 'auto',\n    })\n    this.container.appendChild(pr.canvas)\n\n    this.#pixiRenderer = pr\n\n    const cr = this.container.getBoundingClientRect()\n    this.#updateSize(cr.width, cr.height)\n  }\n\n  #updatePosition() {\n    const S = this.camera.scale\n    this._pixiContainer.scale = S\n    this._pixiContainer.position.set(\n      this.centerX - this.camera.x * S,\n      this.centerY - this.camera.y * S\n    )\n  }\n\n  #updateSize(containerWidth: number, containerHeight: number) {\n    const canvasWidth = this.#logicalWidth ?? containerWidth\n    const canvasHeight = this.#logicalHeight ?? containerHeight\n    this.canvasWidth = canvasWidth\n    this.canvasHeight = canvasHeight\n\n    this.centerX = canvasWidth / 2\n    this.centerY = canvasHeight / 2\n    this.#updatePosition()\n\n    const S = Math.min(containerWidth / canvasWidth, containerHeight / canvasHeight)\n    this.viewportScale = S\n\n    const displayWidth = canvasWidth * S\n    const displayHeight = canvasHeight * S\n\n    const canvasLeft = (containerWidth - displayWidth) / 2\n    const canvasTop = (containerHeight - displayHeight) / 2\n    this.canvasLeft = canvasLeft\n    this.canvasTop = canvasTop\n\n    if (this.#pixiRenderer) {\n      this.#pixiRenderer.resize(canvasWidth, canvasHeight)\n\n      setStyle(this.#pixiRenderer.canvas, {\n        width: `${displayWidth}px`,\n        height: `${displayHeight}px`,\n        left: `${canvasLeft}px`,\n        top: `${canvasTop}px`,\n      })\n\n      this.emit('resize', canvasWidth, canvasHeight)\n    }\n\n    this._isSizeDirty = true\n  }\n\n  #render(dt: number) {\n    this._isSizeDirty = false\n\n    this.update(dt)\n    this._updateWorldTransform()\n    this.#pixiRenderer?.render(this._pixiContainer)\n    this.fpsDisplay?.update()\n  }\n\n  _addToLayer(node: RenderableNode<PixiContainer, EventMap>, layerName: string) {\n    const layer = this.#layers[layerName]\n    if (!layer) throw new Error(`Layer ${layerName} does not exist.`)\n    layer._pixiContainer.addChild(node._pixiContainer)\n  }\n\n  override remove() {\n    this.#containerManager.remove()\n    this.#ticker.remove()\n    this.#pixiRenderer?.destroy()\n    this.fpsDisplay?.remove()\n    super.remove()\n  }\n\n  screenToWorld(screenX: number, screenY: number) {\n    const x = (screenX - this.canvasLeft) / this.viewportScale - this.canvasWidth / 2\n    const y = (screenY - this.canvasTop) / this.viewportScale - this.canvasHeight / 2\n    return { x, y }\n  }\n}\n"]}

package/lib/renderer/ticker.js

@@ -0,0 +1,56 @@
+import { debugMode } from '../debug';
+export class Ticker {
+    #fpsCap;
+    #frameId = 0;
+    constructor(onTick) {
+        let prevTime = 0;
+        let lagSeconds = 0;
+        const step = (timestamp) => {
+            const dt = (timestamp - prevTime) / 1000;
+            if (dt > 0) {
+                const fpsCap = this.#fpsCap;
+                if (fpsCap !== undefined && fpsCap > 0) {
+                    lagSeconds += dt;
+                    const fixedStep = 1 / fpsCap;
+                    if (lagSeconds >= fixedStep) {
+                        onTick(fixedStep);
+                        if (lagSeconds >= fixedStep * 2) {
+                            onTick(dt);
+                            lagSeconds = 0;
+                        }
+                        else {
+                            lagSeconds -= fixedStep;
+                        }
+                    }
+                }
+                else {
+                    onTick(dt);
+                }
+                prevTime = timestamp;
+            }
+            this.#frameId = requestAnimationFrame(step);
+        };
+        this.#frameId = requestAnimationFrame(step);
+        if (debugMode) {
+            if (!document.hasFocus())
+                this.#fpsCap = 6;
+            window.addEventListener('blur', this.#blurListener);
+            window.addEventListener('focus', this.#focusListener);
+            window.addEventListener('pageshow', this.#pageshowListener);
+        }
+    }
+    #blurListener = () => { this.#fpsCap = 6; };
+    #focusListener = () => { this.#fpsCap = undefined; };
+    #pageshowListener = (event) => {
+        if (event.persisted) {
+            this.#fpsCap = undefined;
+        }
+    };
+    remove() {
+        cancelAnimationFrame(this.#frameId);
+        window.removeEventListener('blur', this.#blurListener);
+        window.removeEventListener('focus', this.#focusListener);
+        window.removeEventListener('pageshow', this.#pageshowListener);
+    }
+}
+//# sourceMappingURL=ticker.js.map

package/lib/renderer/ticker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticker.js","sourceRoot":"","sources":["../../src/renderer/ticker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,OAAO,MAAM;IACjB,OAAO,CAAS;IAChB,QAAQ,GAAG,CAAC,CAAA;IAEZ,YAAY,MAA4B;QACtC,IAAI,QAAQ,GAAG,CAAC,CAAA;QAChB,IAAI,UAAU,GAAG,CAAC,CAAA;QAElB,MAAM,IAAI,GAAG,CAAC,SAAiB,EAAE,EAAE;YACjC,MAAM,EAAE,GAAG,CAAC,SAAS,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAA;YACxC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;gBACX,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAA;gBAC3B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvC,UAAU,IAAI,EAAE,CAAA;oBAChB,MAAM,SAAS,GAAG,CAAC,GAAG,MAAM,CAAA;oBAC5B,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;wBAC5B,MAAM,CAAC,SAAS,CAAC,CAAA;wBACjB,IAAI,UAAU,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;4BAAC,MAAM,CAAC,EAAE,CAAC,CAAC;4BAAC,UAAU,GAAG,CAAC,CAAA;wBAAC,CAAC;6BAC1D,CAAC;4BAAC,UAAU,IAAI,SAAS,CAAA;wBAAC,CAAC;oBAClC,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,EAAE,CAAC,CAAA;gBACZ,CAAC;gBACD,QAAQ,GAAG,SAAS,CAAA;YACtB,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAA;QAC7C,CAAC,CAAA;QACD,IAAI,CAAC,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAA;QAE3C,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE;gBAAE,IAAI,CAAC,OAAO,GAAG,CAAC,CAAA;YAC1C,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,CAAA;YACnD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;YACrD,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAA;QAC7D,CAAC;IACH,CAAC;IAED,aAAa,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,CAAA,CAAC,CAAC,CAAA;IAC1C,cAAc,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA,CAAC,CAAC,CAAA;IACnD,iBAAiB,GAAG,CAAC,KAA0B,EAAE,EAAE;QACjD,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;QAC1B,CAAC;IACH,CAAC,CAAA;IAED,MAAM;QACJ,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACnC,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,CAAA;QACtD,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;QACxD,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAA;IAChE,CAAC;CACF","sourcesContent":["import { debugMode } from '../debug'\n\nexport class Ticker {\n  #fpsCap?: number\n  #frameId = 0\n\n  constructor(onTick: (dt: number) => void) {\n    let prevTime = 0\n    let lagSeconds = 0\n\n    const step = (timestamp: number) => {\n      const dt = (timestamp - prevTime) / 1000\n      if (dt > 0) {\n        const fpsCap = this.#fpsCap\n        if (fpsCap !== undefined && fpsCap > 0) {\n          lagSeconds += dt\n          const fixedStep = 1 / fpsCap\n          if (lagSeconds >= fixedStep) {\n            onTick(fixedStep)\n            if (lagSeconds >= fixedStep * 2) { onTick(dt); lagSeconds = 0 }\n            else { lagSeconds -= fixedStep }\n          }\n        } else {\n          onTick(dt)\n        }\n        prevTime = timestamp\n      }\n      this.#frameId = requestAnimationFrame(step)\n    }\n    this.#frameId = requestAnimationFrame(step)\n\n    if (debugMode) {\n      if (!document.hasFocus()) this.#fpsCap = 6\n      window.addEventListener('blur', this.#blurListener)\n      window.addEventListener('focus', this.#focusListener)\n      window.addEventListener('pageshow', this.#pageshowListener)\n    }\n  }\n\n  #blurListener = () => { this.#fpsCap = 6 }\n  #focusListener = () => { this.#fpsCap = undefined }\n  #pageshowListener = (event: PageTransitionEvent) => {\n    if (event.persisted) {\n      this.#fpsCap = undefined\n    }\n  }\n\n  remove() {\n    cancelAnimationFrame(this.#frameId)\n    window.removeEventListener('blur', this.#blurListener)\n    window.removeEventListener('focus', this.#focusListener)\n    window.removeEventListener('pageshow', this.#pageshowListener)\n  }\n}\n"]}

package/lib/renderer/ticker.test.js

@@ -0,0 +1,241 @@
+"use strict";
+/** @jest-environment jsdom */
+// Simulated monotonic clock (ms)
+let nowMs = 0;
+// RAF callback registry: id -> cb
+const rafCallbacks = new Map();
+let nextRafId = 1;
+const installTimeAndRafMocks = () => {
+    jest.spyOn(performance, 'now').mockImplementation(() => nowMs);
+    jest
+        .spyOn(window, 'requestAnimationFrame')
+        .mockImplementation((cb) => {
+        const id = nextRafId++;
+        rafCallbacks.set(id, cb);
+        return id;
+    });
+    jest.spyOn(window, 'cancelAnimationFrame').mockImplementation((id) => {
+        rafCallbacks.delete(id);
+    });
+};
+const resetHarness = () => {
+    nowMs = 0;
+    rafCallbacks.clear();
+    nextRafId = 1;
+};
+/**
+ * Advance a single frame: move the clock by advanceMs and
+ * run only the currently registered RAF callbacks
+ * (callbacks registered during this step run on the next step).
+ */
+const step = (advanceMs) => {
+    nowMs += advanceMs;
+    const cbs = [...rafCallbacks.values()];
+    rafCallbacks.clear();
+    for (const cb of cbs)
+        cb(nowMs);
+};
+/** Advance multiple frames (helper) */
+const advance = (totalMs, stepMs = 16) => {
+    const n = Math.floor(totalMs / stepMs);
+    for (let i = 0; i < n; i++)
+        step(stepMs);
+    const remain = totalMs - n * stepMs;
+    if (remain > 0)
+        step(remain);
+};
+/**
+ * Helper to (re)load Ticker with a specific debugMode value.
+ * Uses jest.resetModules + jest.doMock to inject the desired export.
+ */
+const loadTickerWithDebug = async (debug) => {
+    jest.resetModules();
+    jest.doMock('../debug', () => ({ debugMode: debug }), { virtual: true });
+    const mod = await import('./ticker');
+    return mod.Ticker;
+};
+/** Small helpers to read arguments cleanly */
+const argOf = (mockFn, nthZeroBased) => mockFn.mock.calls[nthZeroBased][0];
+const lastArg = (mockFn) => {
+    const i = mockFn.mock.calls.length - 1;
+    return mockFn.mock.calls[i][0];
+};
+/** ----------------------- Lifecycle -------------------------- **/
+beforeEach(() => {
+    resetHarness();
+    jest.restoreAllMocks();
+    installTimeAndRafMocks();
+});
+afterEach(() => {
+    jest.restoreAllMocks();
+    resetHarness();
+});
+/** ----------------------- Tests ------------------------------ **/
+describe('uncapped mode (debugMode=false)', () => {
+    it('calls onTick once per frame with raw deltaTime (seconds)', async () => {
+        const Ticker = await loadTickerWithDebug(false);
+        const spy = jest.fn();
+        const ticker = new Ticker(spy); // default: uncapped
+        step(10); // 0.010
+        step(20); // 0.020
+        step(30); // 0.030
+        expect(spy).toHaveBeenCalledTimes(3);
+        // Assert shapes, then values
+        expect(spy).toHaveBeenNthCalledWith(1, expect.any(Number));
+        expect(spy).toHaveBeenNthCalledWith(2, expect.any(Number));
+        expect(spy).toHaveBeenNthCalledWith(3, expect.any(Number));
+        expect(argOf(spy, 0)).toBeCloseTo(0.010, 6);
+        expect(argOf(spy, 1)).toBeCloseTo(0.020, 6);
+        expect(argOf(spy, 2)).toBeCloseTo(0.030, 6);
+        ticker.remove();
+    });
+    it('does not call onTick when deltaTime <= 0', async () => {
+        const Ticker = await loadTickerWithDebug(false);
+        const spy = jest.fn();
+        const ticker = new Ticker(spy);
+        step(0);
+        expect(spy).not.toHaveBeenCalled();
+        step(5);
+        expect(spy).toHaveBeenCalledTimes(1);
+        expect(spy).toHaveBeenLastCalledWith(expect.any(Number));
+        expect(lastArg(spy)).toBeCloseTo(0.005, 6);
+        ticker.remove();
+    });
+});
+describe('capped mode via blur (debugMode=true -> 6fps)', () => {
+    it('accumulates lag and calls at fixed-step boundaries (avoid exact boundary)', async () => {
+        const Ticker = await loadTickerWithDebug(true);
+        jest.spyOn(document, 'hasFocus').mockReturnValue(true);
+        const spy = jest.fn();
+        const ticker = new Ticker(spy);
+        // Apply 6fps cap using blur (fixedStep ≈ 1/6 ≈ 0.1666667s)
+        window.dispatchEvent(new Event('blur'));
+        // 100 + 70 = 170ms -> crosses one boundary -> one call ≈ fixedStep
+        step(100);
+        step(70);
+        expect(spy).toHaveBeenCalledTimes(1);
+        expect(spy).toHaveBeenLastCalledWith(expect.any(Number));
+        expect(lastArg(spy)).toBeCloseTo(1 / 6, 6);
+        // Remaining lag ≈ 0.0033s
+        step(91); // still below another boundary
+        expect(spy).toHaveBeenCalledTimes(1);
+        step(80); // crosses again
+        expect(spy).toHaveBeenCalledTimes(2);
+        expect(spy).toHaveBeenLastCalledWith(expect.any(Number));
+        expect(lastArg(spy)).toBeCloseTo(1 / 6, 6);
+        ticker.remove();
+    });
+    it('long frame (delta >= 2*fixedStep) triggers two calls: fixedStep then raw delta; then lag resets', async () => {
+        const Ticker = await loadTickerWithDebug(true);
+        jest.spyOn(document, 'hasFocus').mockReturnValue(true);
+        const spy = jest.fn();
+        const ticker = new Ticker(spy);
+        window.dispatchEvent(new Event('blur')); // enable 6fps cap
+        // 500ms (0.5s) >= 2 * (1/6 ≈ 0.3333s)
+        step(500);
+        expect(spy).toHaveBeenCalledTimes(2);
+        expect(spy).toHaveBeenNthCalledWith(1, expect.any(Number));
+        expect(argOf(spy, 0)).toBeCloseTo(1 / 6, 6);
+        expect(spy).toHaveBeenNthCalledWith(2, expect.any(Number));
+        expect(argOf(spy, 1)).toBeCloseTo(0.5, 6);
+        // Repeat pattern
+        step(500);
+        expect(spy).toHaveBeenCalledTimes(4);
+        expect(spy).toHaveBeenNthCalledWith(3, expect.any(Number));
+        expect(argOf(spy, 2)).toBeCloseTo(1 / 6, 6);
+        expect(spy).toHaveBeenNthCalledWith(4, expect.any(Number));
+        expect(argOf(spy, 3)).toBeCloseTo(0.5, 6);
+        ticker.remove();
+    });
+});
+describe('runtime transitions via focus/pageshow (debugMode=true)', () => {
+    it('blur -> capped(6fps) / focus -> uncapped: after focus, raw delta behavior resumes', async () => {
+        const Ticker = await loadTickerWithDebug(true);
+        jest.spyOn(document, 'hasFocus').mockReturnValue(true);
+        const spy = jest.fn();
+        const ticker = new Ticker(spy);
+        // Enter capped mode and get one fixed-step call
+        window.dispatchEvent(new Event('blur'));
+        step(170);
+        expect(spy).toHaveBeenCalledTimes(1);
+        expect(spy).toHaveBeenLastCalledWith(expect.any(Number));
+        expect(lastArg(spy)).toBeCloseTo(1 / 6, 6);
+        // Back to uncapped
+        window.dispatchEvent(new Event('focus'));
+        spy.mockClear();
+        step(16);
+        step(33);
+        expect(spy).toHaveBeenCalledTimes(2);
+        expect(spy).toHaveBeenNthCalledWith(1, expect.any(Number));
+        expect(argOf(spy, 0)).toBeCloseTo(0.016, 6);
+        expect(spy).toHaveBeenNthCalledWith(2, expect.any(Number));
+        expect(argOf(spy, 1)).toBeCloseTo(0.033, 6);
+        ticker.remove();
+    });
+    it('pageshow(persisted=true) sets fpsCap to uncapped again', async () => {
+        const Ticker = await loadTickerWithDebug(true);
+        jest.spyOn(document, 'hasFocus').mockReturnValue(true);
+        const spy = jest.fn();
+        const ticker = new Ticker(spy);
+        window.dispatchEvent(new Event('blur'));
+        step(200); // > 1/6s => fixed-step call
+        expect(spy).toHaveBeenCalledTimes(1);
+        expect(spy).toHaveBeenLastCalledWith(expect.any(Number));
+        expect(lastArg(spy)).toBeCloseTo(1 / 6, 6);
+        // Create a pageshow event with persisted=true (jsdom lacks PageTransitionEvent)
+        const evt = new Event('pageshow');
+        Object.defineProperty(evt, 'persisted', { value: true });
+        window.dispatchEvent(evt);
+        spy.mockClear();
+        step(25);
+        step(40);
+        expect(spy).toHaveBeenCalledTimes(2);
+        expect(spy).toHaveBeenNthCalledWith(1, expect.any(Number));
+        expect(argOf(spy, 0)).toBeCloseTo(0.025, 6);
+        expect(spy).toHaveBeenNthCalledWith(2, expect.any(Number));
+        expect(argOf(spy, 1)).toBeCloseTo(0.040, 6);
+        ticker.remove();
+    });
+});
+describe('remove()', () => {
+    it('cancels next RAF and stops future ticks; also cleans up listeners', async () => {
+        const Ticker = await loadTickerWithDebug(true);
+        // Ensure the ticker starts in uncapped mode so the first small step triggers a tick.
+        jest.spyOn(document, 'hasFocus').mockReturnValue(true);
+        const spy = jest.fn();
+        const cancelSpy = jest.spyOn(window, 'cancelAnimationFrame');
+        const ticker = new Ticker(spy);
+        step(16); // ~0.016s -> should tick in uncapped mode
+        expect(spy).toHaveBeenCalledTimes(1);
+        ticker.remove();
+        expect(cancelSpy).toHaveBeenCalled();
+        spy.mockClear();
+        advance(200, 16);
+        expect(spy).not.toHaveBeenCalled();
+        // Listeners are cleaned up (dispatching events does nothing and does not throw)
+        expect(() => window.dispatchEvent(new Event('blur'))).not.toThrow();
+        expect(() => window.dispatchEvent(new Event('focus'))).not.toThrow();
+    });
+});
+describe('long-running sanity (ragged frames, capped=6fps)', () => {
+    it('produces a reasonable number of calls; includes fixedStep calls', async () => {
+        const Ticker = await loadTickerWithDebug(true);
+        jest.spyOn(document, 'hasFocus').mockReturnValue(true);
+        const spy = jest.fn();
+        const ticker = new Ticker(spy);
+        window.dispatchEvent(new Event('blur')); // 6fps -> fixedStep ≈ 0.1667
+        // Total ~1000ms with some long frames to trigger the split branch
+        const frames = [33, 33, 35, 201, 51, 61, 41, 201, 201, 251];
+        for (const ms of frames)
+            step(ms);
+        const calls = spy.mock.calls.length;
+        // With lag resets/rounding, tolerate a loose range
+        expect(calls).toBeGreaterThanOrEqual(5);
+        expect(calls).toBeLessThanOrEqual(9);
+        // At least one call should be exactly the fixed step (~1/6)
+        const hasFixedStep = spy.mock.calls.some(([dt]) => Math.abs(dt - 1 / 6) < 1e-6);
+        expect(hasFixedStep).toBe(true);
+        ticker.remove();
+    });
+});
+//# sourceMappingURL=ticker.test.js.map

package/lib/renderer/ticker.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticker.test.js","sourceRoot":"","sources":["../../src/renderer/ticker.test.ts"],"names":[],"mappings":";AAAA,8BAA8B;AAqB9B,iCAAiC;AACjC,IAAI,KAAK,GAAG,CAAC,CAAA;AAEb,kCAAkC;AAClC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAmB,CAAA;AAC/C,IAAI,SAAS,GAAG,CAAC,CAAA;AAEjB,MAAM,sBAAsB,GAAG,GAAG,EAAE;IAClC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;IAE9D,IAAI;SACD,KAAK,CAAC,MAAM,EAAE,uBAAuB,CAAC;SACtC,kBAAkB,CAAC,CAAC,EAAW,EAAE,EAAE;QAClC,MAAM,EAAE,GAAG,SAAS,EAAE,CAAA;QACtB,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QACxB,OAAO,EAAuB,CAAA;IAChC,CAAC,CAAC,CAAA;IAEJ,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,kBAAkB,CAAC,CAAC,EAAU,EAAE,EAAE;QAC3E,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACzB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,GAAG,EAAE;IACxB,KAAK,GAAG,CAAC,CAAA;IACT,YAAY,CAAC,KAAK,EAAE,CAAA;IACpB,SAAS,GAAG,CAAC,CAAA;AACf,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,IAAI,GAAG,CAAC,SAAiB,EAAE,EAAE;IACjC,KAAK,IAAI,SAAS,CAAA;IAClB,MAAM,GAAG,GAAG,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAAA;IACtC,YAAY,CAAC,KAAK,EAAE,CAAA;IACpB,KAAK,MAAM,EAAE,IAAI,GAAG;QAAE,EAAE,CAAC,KAAK,CAAC,CAAA;AACjC,CAAC,CAAA;AAED,uCAAuC;AACvC,MAAM,OAAO,GAAG,CAAC,OAAe,EAAE,MAAM,GAAG,EAAE,EAAE,EAAE;IAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,CAAA;IACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IACxC,MAAM,MAAM,GAAG,OAAO,GAAG,CAAC,GAAG,MAAM,CAAA;IACnC,IAAI,MAAM,GAAG,CAAC;QAAE,IAAI,CAAC,MAAM,CAAC,CAAA;AAC9B,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,mBAAmB,GAAG,KAAK,EAAE,KAAc,EAAE,EAAE;IACnD,IAAI,CAAC,YAAY,EAAE,CAAA;IACnB,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;IACxE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAA;IACpC,OAAQ,GAAW,CAAC,MAAkE,CAAA;AACxF,CAAC,CAAA;AAED,8CAA8C;AAC9C,MAAM,KAAK,GAAG,CAAC,MAAiB,EAAE,YAAoB,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAW,CAAA;AACvG,MAAM,OAAO,GAAG,CAAC,MAAiB,EAAE,EAAE;IACpC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;IACtC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAW,CAAA;AAC1C,CAAC,CAAA;AAED,oEAAoE;AAEpE,UAAU,CAAC,GAAG,EAAE;IACd,YAAY,EAAE,CAAA;IACd,IAAI,CAAC,eAAe,EAAE,CAAA;IACtB,sBAAsB,EAAE,CAAA;AAC1B,CAAC,CAAC,CAAA;AAEF,SAAS,CAAC,GAAG,EAAE;IACb,IAAI,CAAC,eAAe,EAAE,CAAA;IACtB,YAAY,EAAE,CAAA;AAChB,CAAC,CAAC,CAAA;AAEF,oEAAoE;AAEpE,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,CAAA;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;QACrB,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,CAAA,CAAC,oBAAoB;QAEnD,IAAI,CAAC,EAAE,CAAC,CAAA,CAAC,QAAQ;QACjB,IAAI,CAAC,EAAE,CAAC,CAAA,CAAC,QAAQ;QACjB,IAAI,CAAC,EAAE,CAAC,CAAA,CAAC,QAAQ;QAEjB,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QAEpC,6BAA6B;QAC7B,MAAM,CAAC,GAAG,CAAC,CAAC,uBAAuB,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAC1D,MAAM,CAAC,GAAG,CAAC,CAAC,uBAAuB,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAC1D,MAAM,CAAC,GAAG,CAAC,CAAC,uBAAuB,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAE1D,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QAC3C,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QAC3C,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QAE3C,MAAM,CAAC,MAAM,EAAE,CAAA;IACjB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,CAAA;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;QACrB,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,CAAA;QAE9B,IAAI,CAAC,CAAC,CAAC,CAAA;QACP,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;QAElC,IAAI,CAAC,CAAC,CAAC,CAAA;QACP,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACpC,MAAM,CAAC,GAAG,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QACxD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QAE1C,MAAM,CAAC,MAAM,EAAE,CAAA;IACjB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,+CAA+C,EAAE,GAAG,EAAE;IAC7D,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QACzF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAA;QAC9C,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QAEtD,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;QACrB,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,CAAA;QAE9B,2DAA2D;QAC3D,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;QAEvC,mEAAmE;QACnE,IAAI,CAAC,GAAG,CAAC,CAAA;QACT,IAAI,CAAC,EAAE,CAAC,CAAA;QACR,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACpC,MAAM,CAAC,GAAG,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QACxD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;QAE1C,0BAA0B;QAC1B,IAAI,CAAC,EAAE,CAAC,CAAA,CAAC,+BAA+B;QACxC,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACpC,IAAI,CAAC,EAAE,CAAC,CAAA,CAAC,gBAAgB;QACzB,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACpC,MAAM,CAAC,GAAG,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QACxD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;QAE1C,MAAM,CAAC,MAAM,EAAE,CAAA;IACjB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iGAAiG,EAAE,KAAK,IAAI,EAAE;QAC/G,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAA;QAC9C,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QAEtD,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;QACrB,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,CAAA;QAE9B,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA,CAAC,kBAAkB;QAE1D,sCAAsC;QACtC,IAAI,CAAC,GAAG,CAAC,CAAA;QACT,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QAEpC,MAAM,CAAC,GAAG,CAAC,CAAC,uBAAuB,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAC1D,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;QAE3C,MAAM,CAAC,GAAG,CAAC,CAAC,uBAAuB,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAC1D,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QAEzC,iBAAiB;QACjB,IAAI,CAAC,GAAG,CAAC,CAAA;QACT,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QAEpC,MAAM,CAAC,GAAG,CAAC,CAAC,uBAAuB,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAC1D,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;QAE3C,MAAM,CAAC,GAAG,CAAC,CAAC,uBAAuB,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAC1D,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QAEzC,MAAM,CAAC,MAAM,EAAE,CAAA;IACjB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,yDAAyD,EAAE,GAAG,EAAE;IACvE,EAAE,CAAC,mFAAmF,EAAE,KAAK,IAAI,EAAE;QACjG,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAA;QAC9C,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QAEtD,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;QACrB,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,CAAA;QAE9B,gDAAgD;QAChD,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;QACvC,IAAI,CAAC,GAAG,CAAC,CAAA;QACT,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACpC,MAAM,CAAC,GAAG,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QACxD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;QAE1C,mBAAmB;QACnB,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;QAExC,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,IAAI,CAAC,EAAE,CAAC,CAAA;QACR,IAAI,CAAC,EAAE,CAAC,CAAA;QACR,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QAEpC,MAAM,CAAC,GAAG,CAAC,CAAC,uBAAuB,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAC1D,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QAE3C,MAAM,CAAC,GAAG,CAAC,CAAC,uBAAuB,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAC1D,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QAE3C,MAAM,CAAC,MAAM,EAAE,CAAA;IACjB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAA;QAC9C,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QAEtD,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;QACrB,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,CAAA;QAE9B,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;QACvC,IAAI,CAAC,GAAG,CAAC,CAAA,CAAC,4BAA4B;QACtC,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACpC,MAAM,CAAC,GAAG,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QACxD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;QAE1C,gFAAgF;QAChF,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,UAAU,CAAoC,CAAA;QACpE,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACxD,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;QAEzB,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,IAAI,CAAC,EAAE,CAAC,CAAA;QACR,IAAI,CAAC,EAAE,CAAC,CAAA;QACR,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QAEpC,MAAM,CAAC,GAAG,CAAC,CAAC,uBAAuB,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAC1D,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QAE3C,MAAM,CAAC,GAAG,CAAC,CAAC,uBAAuB,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAC1D,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QAE3C,MAAM,CAAC,MAAM,EAAE,CAAA;IACjB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAA;QAE9C,qFAAqF;QACrF,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QAEtD,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;QACrB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;QAE5D,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,CAAA;QAE9B,IAAI,CAAC,EAAE,CAAC,CAAA,CAAC,0CAA0C;QACnD,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QAEpC,MAAM,CAAC,MAAM,EAAE,CAAA;QACf,MAAM,CAAC,SAAS,CAAC,CAAC,gBAAgB,EAAE,CAAA;QAEpC,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;QAChB,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;QAElC,gFAAgF;QAChF,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;QACnE,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;IACtE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,kDAAkD,EAAE,GAAG,EAAE;IAChE,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAA;QAC9C,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QAEtD,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;QACrB,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,CAAA;QAE9B,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA,CAAC,6BAA6B;QAErE,kEAAkE;QAClE,MAAM,MAAM,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;QAC3D,KAAK,MAAM,EAAE,IAAI,MAAM;YAAE,IAAI,CAAC,EAAE,CAAC,CAAA;QAEjC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;QACnC,mDAAmD;QACnD,MAAM,CAAC,KAAK,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,KAAK,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAA;QAEpC,4DAA4D;QAC5D,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAE,EAAa,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;QAC3F,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAE/B,MAAM,CAAC,MAAM,EAAE,CAAA;IACjB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA","sourcesContent":["/** @jest-environment jsdom */\n\n/**\n * Test Suite — Ticker (Jest)\n * -------------------------------------------------------\n * Goals\n *  - Avoid floating-point pitfalls around fixed step boundaries\n *  - Validate uncapped, capped via blur (6fps), long frame split,\n *    focus/pageshow transitions, and remove()\n *  - In this implementation: no setFixedFps; debugMode + focus/blur/pageshow control fps cap\n *\n * Principles\n *  - Do not assert exactly at the boundary (e.g., prefer 170ms over ~166ms)\n *  - Validate deltaTime using toBeCloseTo + loose call count checks\n */\n\n/** ----------------------- Time & RAF harness ----------------------- **/\n\n// Local callback type to avoid depending on DOM lib typings.\ntype FrameCb = (time: number) => void\n\n// Simulated monotonic clock (ms)\nlet nowMs = 0\n\n// RAF callback registry: id -> cb\nconst rafCallbacks = new Map<number, FrameCb>()\nlet nextRafId = 1\n\nconst installTimeAndRafMocks = () => {\n  jest.spyOn(performance, 'now').mockImplementation(() => nowMs)\n\n  jest\n    .spyOn(window, 'requestAnimationFrame')\n    .mockImplementation((cb: FrameCb) => {\n      const id = nextRafId++\n      rafCallbacks.set(id, cb)\n      return id as unknown as number\n    })\n\n  jest.spyOn(window, 'cancelAnimationFrame').mockImplementation((id: number) => {\n    rafCallbacks.delete(id)\n  })\n}\n\nconst resetHarness = () => {\n  nowMs = 0\n  rafCallbacks.clear()\n  nextRafId = 1\n}\n\n/**\n * Advance a single frame: move the clock by advanceMs and\n * run only the currently registered RAF callbacks\n * (callbacks registered during this step run on the next step).\n */\nconst step = (advanceMs: number) => {\n  nowMs += advanceMs\n  const cbs = [...rafCallbacks.values()]\n  rafCallbacks.clear()\n  for (const cb of cbs) cb(nowMs)\n}\n\n/** Advance multiple frames (helper) */\nconst advance = (totalMs: number, stepMs = 16) => {\n  const n = Math.floor(totalMs / stepMs)\n  for (let i = 0; i < n; i++) step(stepMs)\n  const remain = totalMs - n * stepMs\n  if (remain > 0) step(remain)\n}\n\n/**\n * Helper to (re)load Ticker with a specific debugMode value.\n * Uses jest.resetModules + jest.doMock to inject the desired export.\n */\nconst loadTickerWithDebug = async (debug: boolean) => {\n  jest.resetModules()\n  jest.doMock('../debug', () => ({ debugMode: debug }), { virtual: true })\n  const mod = await import('./ticker')\n  return (mod as any).Ticker as new (onTick: (dt: number) => void) => { remove(): void }\n}\n\n/** Small helpers to read arguments cleanly */\nconst argOf = (mockFn: jest.Mock, nthZeroBased: number) => mockFn.mock.calls[nthZeroBased][0] as number\nconst lastArg = (mockFn: jest.Mock) => {\n  const i = mockFn.mock.calls.length - 1\n  return mockFn.mock.calls[i][0] as number\n}\n\n/** ----------------------- Lifecycle -------------------------- **/\n\nbeforeEach(() => {\n  resetHarness()\n  jest.restoreAllMocks()\n  installTimeAndRafMocks()\n})\n\nafterEach(() => {\n  jest.restoreAllMocks()\n  resetHarness()\n})\n\n/** ----------------------- Tests ------------------------------ **/\n\ndescribe('uncapped mode (debugMode=false)', () => {\n  it('calls onTick once per frame with raw deltaTime (seconds)', async () => {\n    const Ticker = await loadTickerWithDebug(false)\n    const spy = jest.fn()\n    const ticker = new Ticker(spy) // default: uncapped\n\n    step(10) // 0.010\n    step(20) // 0.020\n    step(30) // 0.030\n\n    expect(spy).toHaveBeenCalledTimes(3)\n\n    // Assert shapes, then values\n    expect(spy).toHaveBeenNthCalledWith(1, expect.any(Number))\n    expect(spy).toHaveBeenNthCalledWith(2, expect.any(Number))\n    expect(spy).toHaveBeenNthCalledWith(3, expect.any(Number))\n\n    expect(argOf(spy, 0)).toBeCloseTo(0.010, 6)\n    expect(argOf(spy, 1)).toBeCloseTo(0.020, 6)\n    expect(argOf(spy, 2)).toBeCloseTo(0.030, 6)\n\n    ticker.remove()\n  })\n\n  it('does not call onTick when deltaTime <= 0', async () => {\n    const Ticker = await loadTickerWithDebug(false)\n    const spy = jest.fn()\n    const ticker = new Ticker(spy)\n\n    step(0)\n    expect(spy).not.toHaveBeenCalled()\n\n    step(5)\n    expect(spy).toHaveBeenCalledTimes(1)\n    expect(spy).toHaveBeenLastCalledWith(expect.any(Number))\n    expect(lastArg(spy)).toBeCloseTo(0.005, 6)\n\n    ticker.remove()\n  })\n})\n\ndescribe('capped mode via blur (debugMode=true -> 6fps)', () => {\n  it('accumulates lag and calls at fixed-step boundaries (avoid exact boundary)', async () => {\n    const Ticker = await loadTickerWithDebug(true)\n    jest.spyOn(document, 'hasFocus').mockReturnValue(true)\n\n    const spy = jest.fn()\n    const ticker = new Ticker(spy)\n\n    // Apply 6fps cap using blur (fixedStep ≈ 1/6 ≈ 0.1666667s)\n    window.dispatchEvent(new Event('blur'))\n\n    // 100 + 70 = 170ms -> crosses one boundary -> one call ≈ fixedStep\n    step(100)\n    step(70)\n    expect(spy).toHaveBeenCalledTimes(1)\n    expect(spy).toHaveBeenLastCalledWith(expect.any(Number))\n    expect(lastArg(spy)).toBeCloseTo(1 / 6, 6)\n\n    // Remaining lag ≈ 0.0033s\n    step(91) // still below another boundary\n    expect(spy).toHaveBeenCalledTimes(1)\n    step(80) // crosses again\n    expect(spy).toHaveBeenCalledTimes(2)\n    expect(spy).toHaveBeenLastCalledWith(expect.any(Number))\n    expect(lastArg(spy)).toBeCloseTo(1 / 6, 6)\n\n    ticker.remove()\n  })\n\n  it('long frame (delta >= 2*fixedStep) triggers two calls: fixedStep then raw delta; then lag resets', async () => {\n    const Ticker = await loadTickerWithDebug(true)\n    jest.spyOn(document, 'hasFocus').mockReturnValue(true)\n\n    const spy = jest.fn()\n    const ticker = new Ticker(spy)\n\n    window.dispatchEvent(new Event('blur')) // enable 6fps cap\n\n    // 500ms (0.5s) >= 2 * (1/6 ≈ 0.3333s)\n    step(500)\n    expect(spy).toHaveBeenCalledTimes(2)\n\n    expect(spy).toHaveBeenNthCalledWith(1, expect.any(Number))\n    expect(argOf(spy, 0)).toBeCloseTo(1 / 6, 6)\n\n    expect(spy).toHaveBeenNthCalledWith(2, expect.any(Number))\n    expect(argOf(spy, 1)).toBeCloseTo(0.5, 6)\n\n    // Repeat pattern\n    step(500)\n    expect(spy).toHaveBeenCalledTimes(4)\n\n    expect(spy).toHaveBeenNthCalledWith(3, expect.any(Number))\n    expect(argOf(spy, 2)).toBeCloseTo(1 / 6, 6)\n\n    expect(spy).toHaveBeenNthCalledWith(4, expect.any(Number))\n    expect(argOf(spy, 3)).toBeCloseTo(0.5, 6)\n\n    ticker.remove()\n  })\n})\n\ndescribe('runtime transitions via focus/pageshow (debugMode=true)', () => {\n  it('blur -> capped(6fps) / focus -> uncapped: after focus, raw delta behavior resumes', async () => {\n    const Ticker = await loadTickerWithDebug(true)\n    jest.spyOn(document, 'hasFocus').mockReturnValue(true)\n\n    const spy = jest.fn()\n    const ticker = new Ticker(spy)\n\n    // Enter capped mode and get one fixed-step call\n    window.dispatchEvent(new Event('blur'))\n    step(170)\n    expect(spy).toHaveBeenCalledTimes(1)\n    expect(spy).toHaveBeenLastCalledWith(expect.any(Number))\n    expect(lastArg(spy)).toBeCloseTo(1 / 6, 6)\n\n    // Back to uncapped\n    window.dispatchEvent(new Event('focus'))\n\n    spy.mockClear()\n    step(16)\n    step(33)\n    expect(spy).toHaveBeenCalledTimes(2)\n\n    expect(spy).toHaveBeenNthCalledWith(1, expect.any(Number))\n    expect(argOf(spy, 0)).toBeCloseTo(0.016, 6)\n\n    expect(spy).toHaveBeenNthCalledWith(2, expect.any(Number))\n    expect(argOf(spy, 1)).toBeCloseTo(0.033, 6)\n\n    ticker.remove()\n  })\n\n  it('pageshow(persisted=true) sets fpsCap to uncapped again', async () => {\n    const Ticker = await loadTickerWithDebug(true)\n    jest.spyOn(document, 'hasFocus').mockReturnValue(true)\n\n    const spy = jest.fn()\n    const ticker = new Ticker(spy)\n\n    window.dispatchEvent(new Event('blur'))\n    step(200) // > 1/6s => fixed-step call\n    expect(spy).toHaveBeenCalledTimes(1)\n    expect(spy).toHaveBeenLastCalledWith(expect.any(Number))\n    expect(lastArg(spy)).toBeCloseTo(1 / 6, 6)\n\n    // Create a pageshow event with persisted=true (jsdom lacks PageTransitionEvent)\n    const evt = new Event('pageshow') as Event & { persisted?: boolean }\n    Object.defineProperty(evt, 'persisted', { value: true })\n    window.dispatchEvent(evt)\n\n    spy.mockClear()\n    step(25)\n    step(40)\n    expect(spy).toHaveBeenCalledTimes(2)\n\n    expect(spy).toHaveBeenNthCalledWith(1, expect.any(Number))\n    expect(argOf(spy, 0)).toBeCloseTo(0.025, 6)\n\n    expect(spy).toHaveBeenNthCalledWith(2, expect.any(Number))\n    expect(argOf(spy, 1)).toBeCloseTo(0.040, 6)\n\n    ticker.remove()\n  })\n})\n\ndescribe('remove()', () => {\n  it('cancels next RAF and stops future ticks; also cleans up listeners', async () => {\n    const Ticker = await loadTickerWithDebug(true)\n\n    // Ensure the ticker starts in uncapped mode so the first small step triggers a tick.\n    jest.spyOn(document, 'hasFocus').mockReturnValue(true)\n\n    const spy = jest.fn()\n    const cancelSpy = jest.spyOn(window, 'cancelAnimationFrame')\n\n    const ticker = new Ticker(spy)\n\n    step(16) // ~0.016s -> should tick in uncapped mode\n    expect(spy).toHaveBeenCalledTimes(1)\n\n    ticker.remove()\n    expect(cancelSpy).toHaveBeenCalled()\n\n    spy.mockClear()\n    advance(200, 16)\n    expect(spy).not.toHaveBeenCalled()\n\n    // Listeners are cleaned up (dispatching events does nothing and does not throw)\n    expect(() => window.dispatchEvent(new Event('blur'))).not.toThrow()\n    expect(() => window.dispatchEvent(new Event('focus'))).not.toThrow()\n  })\n})\n\ndescribe('long-running sanity (ragged frames, capped=6fps)', () => {\n  it('produces a reasonable number of calls; includes fixedStep calls', async () => {\n    const Ticker = await loadTickerWithDebug(true)\n    jest.spyOn(document, 'hasFocus').mockReturnValue(true)\n\n    const spy = jest.fn()\n    const ticker = new Ticker(spy)\n\n    window.dispatchEvent(new Event('blur')) // 6fps -> fixedStep ≈ 0.1667\n\n    // Total ~1000ms with some long frames to trigger the split branch\n    const frames = [33, 33, 35, 201, 51, 61, 41, 201, 201, 251]\n    for (const ms of frames) step(ms)\n\n    const calls = spy.mock.calls.length\n    // With lag resets/rounding, tolerate a loose range\n    expect(calls).toBeGreaterThanOrEqual(5)\n    expect(calls).toBeLessThanOrEqual(9)\n\n    // At least one call should be exactly the fixed step (~1/6)\n    const hasFixedStep = spy.mock.calls.some(([dt]) => Math.abs((dt as number) - 1 / 6) < 1e-6)\n    expect(hasFixedStep).toBe(true)\n\n    ticker.remove()\n  })\n})\n"]}

package/lib/types/asset/audio.d.ts

@@ -1,4 +1,4 @@
-declare const audioContext: AudioContext;
+export declare const audioContext: AudioContext;
 declare class MusicPlayer {
     #private;
     constructor();
@@ -14,8 +14,9 @@ declare class SfxPlayer {
     get volume(): number;
     set volume(volume: number);
     play(src: string): void;
+    playRandom(...srcs: string[]): void;
 }
-declare const musicPlayer: MusicPlayer;
-declare const sfxPlayer: SfxPlayer;
-export { audioContext, musicPlayer, sfxPlayer };
+export declare const musicPlayer: MusicPlayer;
+export declare const sfxPlayer: SfxPlayer;
+export {};
 //# sourceMappingURL=audio.d.ts.map

package/lib/types/asset/audio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../src/asset/audio.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,YAAY,cAAoE,CAAC;AAuGvF,cAAM,WAAW;;;IAmBf,IAAI,MAAM,IAIS,MAAM,CAFxB;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAIxB;IAED,IAAI,CAAC,GAAG,EAAE,MAAM;IAMhB,KAAK;IAIL,IAAI;CAIL;AAED,cAAM,SAAS;;;IAQb,IAAI,MAAM,IAIS,MAAM,CAFxB;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAGxB;IAED,IAAI,CAAC,GAAG,EAAE,MAAM;CAGjB;AAED,QAAA,MAAM,WAAW,aAAoB,CAAC;AACtC,QAAA,MAAM,SAAS,WAAkB,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../src/asset/audio.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,cAAoE,CAAA;AAgJ7F,cAAM,WAAW;;;IAmBf,IAAI,MAAM,IAIS,MAAM,CAFxB;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAIxB;IAED,IAAI,CAAC,GAAG,EAAE,MAAM;IAMhB,KAAK;IAIL,IAAI;CAIL;AAED,cAAM,SAAS;;;IAQb,IAAI,MAAM,IAIS,MAAM,CAFxB;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAGxB;IAED,IAAI,CAAC,GAAG,EAAE,MAAM;IAIhB,UAAU,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE;CAG7B;AAED,eAAO,MAAM,WAAW,aAAoB,CAAA;AAC5C,eAAO,MAAM,SAAS,WAAkB,CAAA"}

package/lib/types/asset/loaders/audio.d.ts

@@ -1,6 +1,6 @@
 import { Loader } from './loader';
 declare class AudioLoader extends Loader<AudioBuffer> {
-    protected _load(src: string): Promise<AudioBuffer | undefined>;
+    protected doLoad(src: string): Promise<AudioBuffer | undefined>;
 }
 export declare const audioLoader: AudioLoader;
 export {};

package/lib/types/asset/loaders/audio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../../src/asset/loaders/audio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,cAAM,WAAY,SAAQ,MAAM,CAAC,WAAW,CAAC;cAClB,KAAK,CAAC,GAAG,EAAE,MAAM;CAgC3C;AAED,eAAO,MAAM,WAAW,aAAoB,CAAC"}
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../../src/asset/loaders/audio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,cAAM,WAAY,SAAQ,MAAM,CAAC,WAAW,CAAC;cAClB,MAAM,CAAC,GAAG,EAAE,MAAM;CAgC5C;AAED,eAAO,MAAM,WAAW,aAAoB,CAAA"}

package/lib/types/asset/loaders/binary.d.ts

@@ -1,6 +1,6 @@
 import { Loader } from './loader';
 declare class BinaryLoader extends Loader<Uint8Array> {
-    protected _load(src: string): Promise<Uint8Array<ArrayBuffer> | undefined>;
+    protected doLoad(src: string): Promise<Uint8Array<ArrayBuffer> | undefined>;
 }
 export declare const binaryLoader: BinaryLoader;
 export {};

package/lib/types/asset/loaders/binary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../../../src/asset/loaders/binary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,cAAM,YAAa,SAAQ,MAAM,CAAC,UAAU,CAAC;cAClB,KAAK,CAAC,GAAG,EAAE,MAAM;CA0B3C;AAED,eAAO,MAAM,YAAY,cAAqB,CAAC"}
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../../../src/asset/loaders/binary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,cAAM,YAAa,SAAQ,MAAM,CAAC,UAAU,CAAC;cAClB,MAAM,CAAC,GAAG,EAAE,MAAM;CA0B5C;AAED,eAAO,MAAM,YAAY,cAAqB,CAAA"}

package/lib/types/asset/loaders/bitmap-font.d.ts

@@ -0,0 +1,16 @@
+import { BitmapFont, Char } from '../../types/bitmap-font';
+import { Loader } from './loader';
+declare class BitmapFontLoader extends Loader<BitmapFont> {
+    #private;
+    protected doLoad(fnt: string, src: string): Promise<{
+        src: string;
+        chars: Record<number, Char>;
+        texture: import("pixi.js").Texture<import("pixi.js").TextureSource<any>>;
+        size: number;
+        lineHeight: number;
+    } | undefined>;
+    protected cleanup(fnt: string): void;
+}
+export declare const bitmapFontLoader: BitmapFontLoader;
+export {};
+//# sourceMappingURL=bitmap-font.d.ts.map

package/lib/types/asset/loaders/bitmap-font.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmap-font.d.ts","sourceRoot":"","sources":["../../../../src/asset/loaders/bitmap-font.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAGjC,cAAM,gBAAiB,SAAQ,MAAM,CAAC,UAAU,CAAC;;cAGtB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;;;;;;;cAuErC,OAAO,CAAC,GAAG,EAAE,MAAM;CAIvC;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAA"}

package/lib/types/asset/loaders/font.d.ts

@@ -1,6 +1,6 @@
 import { Loader } from './loader';
 declare class FontFamilyLoader extends Loader<boolean> {
-    protected _load(fontName: string): Promise<true | undefined>;
+    protected doLoad(fontName: string): Promise<true | undefined>;
 }
 export declare const fontFamilyLoader: FontFamilyLoader;
 export {};

package/lib/types/asset/loaders/font.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"font.d.ts","sourceRoot":"","sources":["../../../../src/asset/loaders/font.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,cAAM,gBAAiB,SAAQ,MAAM,CAAC,OAAO,CAAC;cACnB,KAAK,CAAC,QAAQ,EAAE,MAAM;CAqBhD;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}
+{"version":3,"file":"font.d.ts","sourceRoot":"","sources":["../../../../src/asset/loaders/font.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,cAAM,gBAAiB,SAAQ,MAAM,CAAC,OAAO,CAAC;cACnB,MAAM,CAAC,QAAQ,EAAE,MAAM;CAqBjD;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAA"}

package/lib/types/asset/loaders/loader.d.ts

@@ -1,13 +1,13 @@
-declare abstract class Loader<T> {
+export declare abstract class Loader<T> {
     #private;
-    protected loadedAssets: Map<string, T>;
+    protected cachedAssets: Map<string, T>;
     protected loadingPromises: Map<string, Promise<T | undefined>>;
     protected hasActiveRef(id: string): boolean;
-    protected abstract _load(id: string, ...args: any[]): Promise<T | undefined>;
-    protected _dispose(id: string, asset: T): void;
-    checkLoaded(id: string): boolean;
+    protected abstract doLoad(id: string, ...args: any[]): Promise<T | undefined>;
+    protected cleanup(id: string, asset: T): void;
+    checkCached(id: string): boolean;
+    getCached(id: string): T | undefined;
     load(id: string, ...args: any[]): Promise<T | undefined>;
     release(id: string): void;
 }
-export { Loader };
 //# sourceMappingURL=loader.d.ts.map