@kurot/core 1.0.12

package/dist/kurot/player/ScreenAdapter.js

@@ -0,0 +1,127 @@
+import { StageScaleMode } from '../display/enums/StageScaleMode.js';
+import { Capabilities } from '../system/Capabilities.js';
+/**
+ * Manages the relationship between the browser viewport, the canvas element,
+ * and the Stage logical size. Handles resize events and applies the configured
+ * StageScaleMode.
+ *
+ * Equivalent to Egret's `sys.Screen` + `DefaultScreenAdapter`.
+ */
+export class ScreenAdapter {
+    // ── Instance fields ───────────────────────────────────────────────────────
+    _player;
+    _canvas;
+    _touchHandler;
+    _contentWidth;
+    _contentHeight;
+    // ── Constructor ───────────────────────────────────────────────────────────
+    constructor(player, canvas, touchHandler, contentWidth, contentHeight) {
+        this._player = player;
+        this._canvas = canvas;
+        this._touchHandler = touchHandler;
+        this._contentWidth = contentWidth;
+        this._contentHeight = contentHeight;
+        window.addEventListener('resize', this.onResize);
+        this._player.stage.setScreenAdapter(this);
+        this.updateScreenSize();
+    }
+    // ── Public methods ────────────────────────────────────────────────────────
+    setContentSize(width, height) {
+        this._contentWidth = width;
+        this._contentHeight = height;
+        this.updateScreenSize();
+    }
+    updateScreenSize() {
+        const stage = this._player.stage;
+        const container = this._canvas.parentElement;
+        const screenWidth = container?.clientWidth ?? window.innerWidth;
+        const screenHeight = container?.clientHeight ?? window.innerHeight;
+        const size = this.calculateStageSize(stage.scaleMode, screenWidth, screenHeight, this._contentWidth, this._contentHeight);
+        this._canvas.width = size.displayWidth;
+        this._canvas.height = size.displayHeight;
+        this._canvas.style.width = size.displayWidth + 'px';
+        this._canvas.style.height = size.displayHeight + 'px';
+        this._player.updateStageSize(size.stageWidth, size.stageHeight);
+        // Sync canvas bounding size into Capabilities for game code to read.
+        Capabilities.boundingClientWidth = size.displayWidth;
+        Capabilities.boundingClientHeight = size.displayHeight;
+        // The WebGL renderer maps stage coordinates 1:1 to canvas buffer pixels
+        // (projectionVector = canvasWidth/2, -canvasHeight/2).  To convert a
+        // CSS-pixel offset within the canvas to a stage coordinate we need:
+        //   stageCoord = cssPixel * (canvasBufferWidth / clientWidth)
+        //
+        // IMPORTANT: After the call to updateStageSize() above, the WebGL buffer
+        // resize may have changed canvas.width from displayWidth to stageWidth.
+        // So we must read canvas.width *now*, not reuse size.displayWidth.
+        const innerW = this._canvas.clientWidth || size.displayWidth;
+        const innerH = this._canvas.clientHeight || size.displayHeight;
+        const scaleX = this._canvas.width / innerW;
+        const scaleY = this._canvas.height / innerH;
+        this._touchHandler.updateScale(scaleX, scaleY);
+    }
+    dispose() {
+        window.removeEventListener('resize', this.onResize);
+    }
+    // ── Private methods ───────────────────────────────────────────────────────
+    onResize = () => {
+        this.updateScreenSize();
+    };
+    calculateStageSize(scaleMode, screenWidth, screenHeight, contentWidth, contentHeight) {
+        let displayWidth = screenWidth;
+        let displayHeight = screenHeight;
+        let stageWidth = contentWidth;
+        let stageHeight = contentHeight;
+        const scaleX = screenWidth / stageWidth || 0;
+        const scaleY = screenHeight / stageHeight || 0;
+        switch (scaleMode) {
+            case StageScaleMode.EXACT_FIT:
+                break;
+            case StageScaleMode.FIXED_HEIGHT:
+                stageWidth = Math.round(screenWidth / scaleY);
+                break;
+            case StageScaleMode.FIXED_WIDTH:
+                stageHeight = Math.round(screenHeight / scaleX);
+                break;
+            case StageScaleMode.NO_BORDER:
+                if (scaleX > scaleY)
+                    displayHeight = Math.round(stageHeight * scaleX);
+                else
+                    displayWidth = Math.round(stageWidth * scaleY);
+                break;
+            case StageScaleMode.SHOW_ALL:
+                if (scaleX > scaleY)
+                    displayWidth = Math.round(stageWidth * scaleY);
+                else
+                    displayHeight = Math.round(stageHeight * scaleX);
+                break;
+            case StageScaleMode.FIXED_NARROW:
+                if (scaleX > scaleY)
+                    stageWidth = Math.round(screenWidth / scaleY);
+                else
+                    stageHeight = Math.round(screenHeight / scaleX);
+                break;
+            case StageScaleMode.FIXED_WIDE:
+                if (scaleX > scaleY)
+                    stageHeight = Math.round(screenHeight / scaleX);
+                else
+                    stageWidth = Math.round(screenWidth / scaleY);
+                break;
+            case StageScaleMode.NO_SCALE:
+            default:
+                stageWidth = screenWidth;
+                stageHeight = screenHeight;
+                break;
+        }
+        // Ensure even dimensions to avoid sub-pixel rendering issues
+        if (stageWidth % 2 !== 0)
+            stageWidth++;
+        if (stageHeight % 2 !== 0)
+            stageHeight++;
+        if (displayWidth % 2 !== 0)
+            displayWidth++;
+        if (displayHeight % 2 !== 0)
+            displayHeight++;
+        return { stageWidth, stageHeight, displayWidth, displayHeight };
+    }
+}
+//# sourceMappingURL=ScreenAdapter.js.map

package/dist/kurot/player/ScreenAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScreenAdapter.js","sourceRoot":"","sources":["../../../src/kurot/player/ScreenAdapter.ts"],"names":[],"mappings":"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"}

package/dist/kurot/player/SystemTicker.d.ts

@@ -0,0 +1,63 @@
+export declare const START_TIME: number;
+/** @internal Flag: should broadcast Event.RENDER next frame. */
+export declare let invalidateRenderFlag: boolean;
+export declare function setInvalidateRenderFlag(value: boolean): void;
+/** @internal Flag: should re-render immediately after current event processing. */
+export declare let requestRenderingFlag: boolean;
+export declare function setRequestRenderingFlag(value: boolean): void;
+type TickCallback = (timeStamp: number) => boolean;
+/** Render callback — called by SystemTicker each frame to render a player. */
+export interface Renderable {
+    render(triggerByFrame: boolean, costTicker: number): void;
+}
+/**
+ * The core frame loop, equivalent to Egret's `sys.SystemTicker`.
+ * Drives `requestAnimationFrame`, manages frame rate, broadcasts ENTER_FRAME / RENDER,
+ * and invokes registered tick callbacks and player renderers.
+ */
+export declare class SystemTicker {
+    private _players;
+    private _ticks;
+    private _frameRate;
+    private _frameDeltaTime;
+    private _frameInterval;
+    private _lastCount;
+    private _lastTimeStamp;
+    private _costEnterFrame;
+    private _isPaused;
+    private _rafId;
+    private _running;
+    private _callLaterList;
+    constructor();
+    get frameRate(): number;
+    setFrameRate(value: number): boolean;
+    addPlayer(player: Renderable): void;
+    removePlayer(player: Renderable): void;
+    startTick(callback: TickCallback, thisObject: unknown): void;
+    stopTick(callback: TickCallback, thisObject: unknown): void;
+    callLater(fn: (...args: unknown[]) => void, ...args: unknown[]): void;
+    start(): void;
+    stop(): void;
+    pause(): void;
+    resume(): void;
+    /** Force a single update (useful for testing). */
+    update(forceUpdate?: boolean): void;
+    private onFrame;
+    private tick;
+    private render;
+    private broadcastEnterFrame;
+    private broadcastRender;
+    private flushCallLaters;
+    private getTickIndex;
+}
+/** Singleton ticker instance. */
+export declare const ticker: SystemTicker;
+/** Returns milliseconds since engine start. */
+export declare function getTimer(): number;
+/**
+ * Sets up visibility change listeners to dispatch ACTIVATE/DEACTIVATE
+ * events on the stage when the page is hidden/shown.
+ */
+export declare function setupLifecycle(stage: import('../display/Stage.js').Stage): () => void;
+export {};
+//# sourceMappingURL=SystemTicker.d.ts.map

package/dist/kurot/player/SystemTicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemTicker.d.ts","sourceRoot":"","sources":["../../../src/kurot/player/SystemTicker.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,EAAE,MAAmB,CAAC;AAE7C,gEAAgE;AAChE,eAAO,IAAI,oBAAoB,SAAQ,CAAC;AACxC,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE5D;AAED,mFAAmF;AACnF,eAAO,IAAI,oBAAoB,SAAQ,CAAC;AACxC,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE5D;AAED,KAAK,YAAY,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;AAOnD,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IAC1B,MAAM,CAAC,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1D;AAED;;;;GAIG;AACH,qBAAa,YAAY;IAGxB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAS;IAGzB,OAAO,CAAC,cAAc,CAAoE;;IAW1F,IAAW,SAAS,IAAI,MAAM,CAE7B;IAEM,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAWpC,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAInC,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAKtC,SAAS,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IAK5D,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IAK3D,SAAS,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIrE,KAAK,IAAI,IAAI;IAOb,IAAI,IAAI,IAAI;IAQZ,KAAK,IAAI,IAAI;IAGb,MAAM,IAAI,IAAI;IAIrB,kDAAkD;IAC3C,MAAM,CAAC,WAAW,UAAQ,GAAG,IAAI;IAMxC,OAAO,CAAC,OAAO,CAIb;IAEF,OAAO,CAAC,IAAI;IAuCZ,OAAO,CAAC,MAAM;IAmBd,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,YAAY;CAMpB;AAED,iCAAiC;AACjC,eAAO,MAAM,MAAM,EAAE,YAAiC,CAAC;AAEvD,+CAA+C;AAC/C,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,qBAAqB,EAAE,KAAK,GAAG,MAAM,IAAI,CAYrF"}

package/dist/kurot/player/SystemTicker.js

@@ -0,0 +1,209 @@
+import { Event } from '../events/Event.js';
+import { DisplayObject } from '../display/DisplayObject.js';
+export const START_TIME = Date.now();
+/** @internal Flag: should broadcast Event.RENDER next frame. */
+export let invalidateRenderFlag = false;
+export function setInvalidateRenderFlag(value) {
+    invalidateRenderFlag = value;
+}
+/** @internal Flag: should re-render immediately after current event processing. */
+export let requestRenderingFlag = false;
+export function setRequestRenderingFlag(value) {
+    requestRenderingFlag = value;
+}
+/**
+ * The core frame loop, equivalent to Egret's `sys.SystemTicker`.
+ * Drives `requestAnimationFrame`, manages frame rate, broadcasts ENTER_FRAME / RENDER,
+ * and invokes registered tick callbacks and player renderers.
+ */
+export class SystemTicker {
+    // ── Instance fields ───────────────────────────────────────────────────────
+    _players = [];
+    _ticks = [];
+    _frameRate = 30;
+    _frameDeltaTime;
+    _frameInterval;
+    _lastCount;
+    _lastTimeStamp = 0;
+    _costEnterFrame = 0;
+    _isPaused = false;
+    _rafId = 0;
+    _running = false;
+    // Deferred calls (equivalent to egret.callLater)
+    _callLaterList = [];
+    // ── Constructor ───────────────────────────────────────────────────────────
+    constructor() {
+        this._frameDeltaTime = 1000 / this._frameRate;
+        this._lastCount = this._frameInterval = Math.round(60000 / this._frameRate);
+    }
+    // ── Getters / Setters ─────────────────────────────────────────────────────
+    get frameRate() {
+        return this._frameRate;
+    }
+    setFrameRate(value) {
+        if (value <= 0 || this._frameRate === value)
+            return false;
+        this._frameRate = value;
+        const capped = Math.min(value, 60);
+        this._frameDeltaTime = 1000 / capped;
+        this._lastCount = this._frameInterval = Math.round(60000 / capped);
+        return true;
+    }
+    // ── Public methods ────────────────────────────────────────────────────────
+    addPlayer(player) {
+        if (!this._players.includes(player))
+            this._players.push(player);
+    }
+    removePlayer(player) {
+        const i = this._players.indexOf(player);
+        if (i !== -1)
+            this._players.splice(i, 1);
+    }
+    startTick(callback, thisObject) {
+        if (this.getTickIndex(callback, thisObject) !== -1)
+            return;
+        this._ticks.push({ callback, thisObject });
+    }
+    stopTick(callback, thisObject) {
+        const i = this.getTickIndex(callback, thisObject);
+        if (i !== -1)
+            this._ticks.splice(i, 1);
+    }
+    callLater(fn, ...args) {
+        this._callLaterList.push({ fn, args });
+    }
+    start() {
+        if (this._running)
+            return;
+        this._running = true;
+        this._lastTimeStamp = getTimer();
+        this._rafId = requestAnimationFrame(this.onFrame);
+    }
+    stop() {
+        this._running = false;
+        if (this._rafId) {
+            cancelAnimationFrame(this._rafId);
+            this._rafId = 0;
+        }
+    }
+    pause() {
+        this._isPaused = true;
+    }
+    resume() {
+        this._isPaused = false;
+    }
+    /** Force a single update (useful for testing). */
+    update(forceUpdate = false) {
+        this.tick(forceUpdate);
+    }
+    // ── Private methods ───────────────────────────────────────────────────────
+    onFrame = () => {
+        if (!this._running)
+            return;
+        this.tick(false);
+        this._rafId = requestAnimationFrame(this.onFrame);
+    };
+    tick(forceUpdate) {
+        const t1 = Date.now();
+        const timeStamp = getTimer();
+        if (this._isPaused) {
+            this._lastTimeStamp = timeStamp;
+            return;
+        }
+        // Execute tick callbacks
+        let needRender = requestRenderingFlag;
+        const ticks = [...this._ticks];
+        for (const entry of ticks) {
+            if (entry.callback.call(entry.thisObject, timeStamp))
+                needRender = true;
+        }
+        const t2 = Date.now();
+        const deltaTime = timeStamp - this._lastTimeStamp;
+        this._lastTimeStamp = timeStamp;
+        // Frame rate throttling
+        if (deltaTime >= this._frameDeltaTime || forceUpdate) {
+            this._lastCount = this._frameInterval;
+        }
+        else {
+            this._lastCount -= 1000;
+            if (this._lastCount > 0) {
+                if (needRender)
+                    this.render(false, this._costEnterFrame + t2 - t1);
+                return;
+            }
+            this._lastCount += this._frameInterval;
+        }
+        this.render(true, this._costEnterFrame + t2 - t1);
+        const t3 = Date.now();
+        this.broadcastEnterFrame();
+        this._costEnterFrame = Date.now() - t3;
+    }
+    render(triggerByFrame, costTicker) {
+        if (this._players.length === 0)
+            return;
+        // Execute deferred calls
+        this.flushCallLaters();
+        // Broadcast RENDER event if requested
+        if (invalidateRenderFlag) {
+            this.broadcastRender();
+            invalidateRenderFlag = false;
+        }
+        for (const player of this._players) {
+            player.render(triggerByFrame, costTicker);
+        }
+        requestRenderingFlag = false;
+    }
+    broadcastEnterFrame() {
+        const list = [...DisplayObject.$enterFrameCallBackList];
+        for (const obj of list) {
+            obj.dispatchEventWith(Event.ENTER_FRAME);
+        }
+    }
+    broadcastRender() {
+        const list = [...DisplayObject.$renderCallBackList];
+        for (const obj of list) {
+            obj.dispatchEventWith(Event.RENDER);
+        }
+    }
+    flushCallLaters() {
+        if (this._callLaterList.length === 0)
+            return;
+        const list = this._callLaterList;
+        this._callLaterList = [];
+        for (const entry of list) {
+            entry.fn(...entry.args);
+        }
+    }
+    getTickIndex(callback, thisObject) {
+        for (let i = this._ticks.length - 1; i >= 0; i--) {
+            if (this._ticks[i].callback === callback && this._ticks[i].thisObject === thisObject)
+                return i;
+        }
+        return -1;
+    }
+}
+/** Singleton ticker instance. */
+export const ticker = new SystemTicker();
+/** Returns milliseconds since engine start. */
+export function getTimer() {
+    return Date.now() - START_TIME;
+}
+/**
+ * Sets up visibility change listeners to dispatch ACTIVATE/DEACTIVATE
+ * events on the stage when the page is hidden/shown.
+ */
+export function setupLifecycle(stage) {
+    const onVisibilityChange = () => {
+        if (document.hidden) {
+            ticker.pause();
+            stage.dispatchEventWith(Event.DEACTIVATE);
+        }
+        else {
+            ticker.resume();
+            stage.dispatchEventWith(Event.ACTIVATE);
+        }
+    };
+    document.addEventListener('visibilitychange', onVisibilityChange);
+    return () => document.removeEventListener('visibilitychange', onVisibilityChange);
+}
+//# sourceMappingURL=SystemTicker.js.map

package/dist/kurot/player/SystemTicker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemTicker.js","sourceRoot":"","sources":["../../../src/kurot/player/SystemTicker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,CAAC,MAAM,UAAU,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;AAE7C,gEAAgE;AAChE,MAAM,CAAC,IAAI,oBAAoB,GAAG,KAAK,CAAC;AACxC,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACrD,oBAAoB,GAAG,KAAK,CAAC;AAC9B,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,IAAI,oBAAoB,GAAG,KAAK,CAAC;AACxC,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACrD,oBAAoB,GAAG,KAAK,CAAC;AAC9B,CAAC;AAcD;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACxB,6EAA6E;IAErE,QAAQ,GAAiB,EAAE,CAAC;IAC5B,MAAM,GAAgB,EAAE,CAAC;IACzB,UAAU,GAAG,EAAE,CAAC;IAChB,eAAe,CAAS;IACxB,cAAc,CAAS;IACvB,UAAU,CAAS;IACnB,cAAc,GAAG,CAAC,CAAC;IACnB,eAAe,GAAG,CAAC,CAAC;IACpB,SAAS,GAAG,KAAK,CAAC;IAClB,MAAM,GAAG,CAAC,CAAC;IACX,QAAQ,GAAG,KAAK,CAAC;IAEzB,iDAAiD;IACzC,cAAc,GAAiE,EAAE,CAAC;IAE1F,6EAA6E;IAE7E;QACC,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC;QAC9C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7E,CAAC;IAED,6EAA6E;IAE7E,IAAW,SAAS;QACnB,OAAO,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAEM,YAAY,CAAC,KAAa;QAChC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;QAC1D,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,MAAM,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC;IACb,CAAC;IAED,6EAA6E;IAEtE,SAAS,CAAC,MAAkB;QAClC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjE,CAAC;IAEM,YAAY,CAAC,MAAkB;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,CAAC;YAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;IAEM,SAAS,CAAC,QAAsB,EAAE,UAAmB;QAC3D,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;YAAE,OAAO;QAC3D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5C,CAAC;IAEM,QAAQ,CAAC,QAAsB,EAAE,UAAmB;QAC1D,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,CAAC,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IAEM,SAAS,CAAC,EAAgC,EAAE,GAAG,IAAe;QACpE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAEM,KAAK;QACX,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,cAAc,GAAG,QAAQ,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAEM,IAAI;QACV,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QACjB,CAAC;IACF,CAAC;IAEM,KAAK;QACX,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACvB,CAAC;IACM,MAAM;QACZ,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACxB,CAAC;IAED,kDAAkD;IAC3C,MAAM,CAAC,WAAW,GAAG,KAAK;QAChC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,CAAC;IAED,6EAA6E;IAErE,OAAO,GAAG,GAAS,EAAE;QAC5B,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC3B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC,CAAC;IAEM,IAAI,CAAC,WAAoB;QAChC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,QAAQ,EAAE,CAAC;QAE7B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;YAChC,OAAO;QACR,CAAC;QAED,yBAAyB;QACzB,IAAI,UAAU,GAAG,oBAAoB,CAAC;QACtC,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,SAAS,CAAC;gBAAE,UAAU,GAAG,IAAI,CAAC;QACzE,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC;QAClD,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAEhC,wBAAwB;QACxB,IAAI,SAAS,IAAI,IAAI,CAAC,eAAe,IAAI,WAAW,EAAE,CAAC;YACtD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC;QACvC,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC;YACxB,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;gBACzB,IAAI,UAAU;oBAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;gBACnE,OAAO;YACR,CAAC;YACD,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,cAAc,CAAC;QACxC,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAElD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IACxC,CAAC;IAEO,MAAM,CAAC,cAAuB,EAAE,UAAkB;QACzD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEvC,yBAAyB;QACzB,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,sCAAsC;QACtC,IAAI,oBAAoB,EAAE,CAAC;YAC1B,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,oBAAoB,GAAG,KAAK,CAAC;QAC9B,CAAC;QAED,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;QAC3C,CAAC;QAED,oBAAoB,GAAG,KAAK,CAAC;IAC9B,CAAC;IAEO,mBAAmB;QAC1B,MAAM,IAAI,GAAG,CAAC,GAAG,aAAa,CAAC,uBAAuB,CAAC,CAAC;QACxD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACxB,GAAG,CAAC,iBAAiB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC1C,CAAC;IACF,CAAC;IAEO,eAAe;QACtB,MAAM,IAAI,GAAG,CAAC,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC;QACpD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACxB,GAAG,CAAC,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;IACF,CAAC;IAEO,eAAe;QACtB,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC;QACjC,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;YAC1B,KAAK,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACF,CAAC;IAEO,YAAY,CAAC,QAAsB,EAAE,UAAmB;QAC/D,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAClD,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU;gBAAE,OAAO,CAAC,CAAC;QAChG,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;IACX,CAAC;CACD;AAED,iCAAiC;AACjC,MAAM,CAAC,MAAM,MAAM,GAAiB,IAAI,YAAY,EAAE,CAAC;AAEvD,+CAA+C;AAC/C,MAAM,UAAU,QAAQ;IACvB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0C;IACxE,MAAM,kBAAkB,GAAG,GAAS,EAAE;QACrC,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrB,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACP,MAAM,CAAC,MAAM,EAAE,CAAC;YAChB,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC;IACF,CAAC,CAAC;IACF,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;IAClE,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;AACnF,CAAC"}

package/dist/kurot/player/TouchHandler.d.ts

@@ -0,0 +1,39 @@
+import { Stage } from '../display/Stage.js';
+/**
+ * Manages touch/mouse input on a canvas element and dispatches TouchEvent
+ * to the appropriate DisplayObject in the display list.
+ *
+ * Equivalent to Egret's `sys.TouchHandler` + `WebTouchHandler`.
+ */
+export declare class TouchHandler {
+    private _stage;
+    private _canvas;
+    private _maxTouches;
+    private _useTouchesCount;
+    private _touchDownTarget;
+    private _lastTouchX;
+    private _lastTouchY;
+    private _scaleX;
+    private _scaleY;
+    constructor(stage: Stage, canvas: HTMLCanvasElement);
+    /**
+     * Updates the coordinate scale factors when the canvas size changes.
+     * Call this after resizing the canvas or changing the stage size.
+     */
+    updateScale(scaleX: number, scaleY: number): void;
+    updateMaxTouches(value: number): void;
+    dispose(): void;
+    onTouchBegin(x: number, y: number, touchPointID: number): void;
+    onTouchMove(x: number, y: number, touchPointID: number): void;
+    onTouchEnd(x: number, y: number, touchPointID: number): void;
+    private findTarget;
+    private getStageCoords;
+    private bindEvents;
+    private onTouchStartEvent;
+    private onTouchMoveEvent;
+    private onTouchEndEvent;
+    private onMouseDown;
+    private onMouseMove;
+    private onMouseUp;
+}
+//# sourceMappingURL=TouchHandler.d.ts.map

package/dist/kurot/player/TouchHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TouchHandler.d.ts","sourceRoot":"","sources":["../../../src/kurot/player/TouchHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAI5C;;;;;GAKG;AACH,qBAAa,YAAY;IAGxB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,gBAAgB,CAAyC;IACjE,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,OAAO,CAAK;gBAID,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB;IAS1D;;;OAGG;IACI,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAKjD,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIrC,OAAO,IAAI,IAAI;IAcf,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAa9D,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAU7D,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IA2BnE,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,iBAAiB,CAOvB;IAEF,OAAO,CAAC,gBAAgB,CAOtB;IAEF,OAAO,CAAC,eAAe,CAMrB;IAEF,OAAO,CAAC,WAAW,CAQjB;IAEF,OAAO,CAAC,WAAW,CAGjB;IAEF,OAAO,CAAC,SAAS,CAGf;CACF"}

package/dist/kurot/player/TouchHandler.js

@@ -0,0 +1,152 @@
+import { TouchEvent } from '../events/TouchEvent.js';
+/**
+ * Manages touch/mouse input on a canvas element and dispatches TouchEvent
+ * to the appropriate DisplayObject in the display list.
+ *
+ * Equivalent to Egret's `sys.TouchHandler` + `WebTouchHandler`.
+ */
+export class TouchHandler {
+    // ── Instance fields ───────────────────────────────────────────────────────
+    _stage;
+    _canvas;
+    _maxTouches;
+    _useTouchesCount = 0;
+    _touchDownTarget = new Map();
+    _lastTouchX = -1;
+    _lastTouchY = -1;
+    _scaleX = 1;
+    _scaleY = 1;
+    // ── Constructor ───────────────────────────────────────────────────────────
+    constructor(stage, canvas) {
+        this._stage = stage;
+        this._canvas = canvas;
+        this._maxTouches = stage.maxTouches;
+        this.bindEvents();
+    }
+    // ── Public methods ────────────────────────────────────────────────────────
+    /**
+     * Updates the coordinate scale factors when the canvas size changes.
+     * Call this after resizing the canvas or changing the stage size.
+     */
+    updateScale(scaleX, scaleY) {
+        this._scaleX = scaleX;
+        this._scaleY = scaleY;
+    }
+    updateMaxTouches(value) {
+        this._maxTouches = value;
+    }
+    dispose() {
+        this._canvas.removeEventListener('touchstart', this.onTouchStartEvent);
+        this._canvas.removeEventListener('touchmove', this.onTouchMoveEvent);
+        this._canvas.removeEventListener('touchend', this.onTouchEndEvent);
+        this._canvas.removeEventListener('touchcancel', this.onTouchEndEvent);
+        this._canvas.removeEventListener('mousedown', this.onMouseDown);
+        window.removeEventListener('mousemove', this.onMouseMove);
+        window.removeEventListener('mouseup', this.onMouseUp);
+        this._touchDownTarget.clear();
+        this._useTouchesCount = 0;
+    }
+    // ── Touch event handlers ──────────────────────────────────────────────────
+    onTouchBegin(x, y, touchPointID) {
+        if (this._useTouchesCount >= this._maxTouches)
+            return;
+        this._lastTouchX = x;
+        this._lastTouchY = y;
+        const target = this.findTarget(x, y);
+        if (!this._touchDownTarget.has(touchPointID)) {
+            this._touchDownTarget.set(touchPointID, target);
+            this._useTouchesCount++;
+        }
+        TouchEvent.dispatchTouchEvent(target, TouchEvent.TOUCH_BEGIN, true, true, x, y, touchPointID, true);
+    }
+    onTouchMove(x, y, touchPointID) {
+        if (!this._touchDownTarget.has(touchPointID))
+            return;
+        if (this._lastTouchX === x && this._lastTouchY === y)
+            return;
+        this._lastTouchX = x;
+        this._lastTouchY = y;
+        const target = this.findTarget(x, y);
+        TouchEvent.dispatchTouchEvent(target, TouchEvent.TOUCH_MOVE, true, true, x, y, touchPointID, true);
+    }
+    onTouchEnd(x, y, touchPointID) {
+        const oldTarget = this._touchDownTarget.get(touchPointID);
+        if (!oldTarget)
+            return;
+        this._touchDownTarget.delete(touchPointID);
+        this._useTouchesCount--;
+        const target = this.findTarget(x, y);
+        TouchEvent.dispatchTouchEvent(target, TouchEvent.TOUCH_END, true, true, x, y, touchPointID, false);
+        if (oldTarget === target) {
+            TouchEvent.dispatchTouchEvent(target, TouchEvent.TOUCH_TAP, true, true, x, y, touchPointID, false);
+        }
+        else {
+            TouchEvent.dispatchTouchEvent(oldTarget, TouchEvent.TOUCH_RELEASE_OUTSIDE, true, true, x, y, touchPointID, false);
+        }
+    }
+    // ── Private methods ───────────────────────────────────────────────────────
+    findTarget(stageX, stageY) {
+        return this._stage.$hitTest(stageX, stageY) ?? this._stage;
+    }
+    getStageCoords(clientX, clientY) {
+        const rect = this._canvas.getBoundingClientRect();
+        // Use clientLeft/clientTop to offset for CSS borders on the canvas.
+        // getBoundingClientRect() includes borders, but the stage content
+        // area starts at (clientLeft, clientTop) inside the rect.
+        return {
+            x: (clientX - rect.left - this._canvas.clientLeft) * this._scaleX,
+            y: (clientY - rect.top - this._canvas.clientTop) * this._scaleY,
+        };
+    }
+    bindEvents() {
+        this._canvas.addEventListener('touchstart', this.onTouchStartEvent, { passive: false });
+        this._canvas.addEventListener('touchmove', this.onTouchMoveEvent, { passive: false });
+        this._canvas.addEventListener('touchend', this.onTouchEndEvent);
+        this._canvas.addEventListener('touchcancel', this.onTouchEndEvent);
+        this._canvas.addEventListener('mousedown', this.onMouseDown);
+        // Keep tracking an active drag after the pointer leaves the canvas.
+        window.addEventListener('mousemove', this.onMouseMove);
+        window.addEventListener('mouseup', this.onMouseUp);
+    }
+    onTouchStartEvent = (e) => {
+        e.preventDefault();
+        for (let i = 0; i < e.changedTouches.length; i++) {
+            const touch = e.changedTouches[i];
+            const { x, y } = this.getStageCoords(touch.clientX, touch.clientY);
+            this.onTouchBegin(x, y, touch.identifier);
+        }
+    };
+    onTouchMoveEvent = (e) => {
+        e.preventDefault();
+        for (let i = 0; i < e.changedTouches.length; i++) {
+            const touch = e.changedTouches[i];
+            const { x, y } = this.getStageCoords(touch.clientX, touch.clientY);
+            this.onTouchMove(x, y, touch.identifier);
+        }
+    };
+    onTouchEndEvent = (e) => {
+        for (let i = 0; i < e.changedTouches.length; i++) {
+            const touch = e.changedTouches[i];
+            const { x, y } = this.getStageCoords(touch.clientX, touch.clientY);
+            this.onTouchEnd(x, y, touch.identifier);
+        }
+    };
+    onMouseDown = (e) => {
+        // Prevent the canvas from stealing focus away from any native input
+        // element that is about to be focused by the touch handler (e.g. a
+        // TextField in INPUT mode). Without this, the browser would move focus
+        // to the canvas on mousedown, immediately blurring the input.
+        e.preventDefault();
+        const { x, y } = this.getStageCoords(e.clientX, e.clientY);
+        this.onTouchBegin(x, y, 0);
+    };
+    onMouseMove = (e) => {
+        const { x, y } = this.getStageCoords(e.clientX, e.clientY);
+        this.onTouchMove(x, y, 0);
+    };
+    onMouseUp = (e) => {
+        const { x, y } = this.getStageCoords(e.clientX, e.clientY);
+        this.onTouchEnd(x, y, 0);
+    };
+}
+//# sourceMappingURL=TouchHandler.js.map

package/dist/kurot/player/TouchHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TouchHandler.js","sourceRoot":"","sources":["../../../src/kurot/player/TouchHandler.ts"],"names":[],"mappings":"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"}