@blakron/core 0.2.4 → 0.3.1

package/dist/blakron/player/TouchHandler.js

@@ -0,0 +1,149 @@
+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);
+        this._canvas.removeEventListener('mousemove', this.onMouseMove);
+        this._canvas.removeEventListener('mouseup', this.onMouseUp);
+    }
+    // ── 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);
+        this._canvas.addEventListener('mousemove', this.onMouseMove);
+        this._canvas.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/blakron/player/TouchHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TouchHandler.js","sourceRoot":"","sources":["../../../src/blakron/player/TouchHandler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IACxB,6EAA6E;IAErE,MAAM,CAAQ;IACd,OAAO,CAAoB;IAC3B,WAAW,CAAS;IACpB,gBAAgB,GAAG,CAAC,CAAC;IACrB,gBAAgB,GAA+B,IAAI,GAAG,EAAE,CAAC;IACzD,WAAW,GAAG,CAAC,CAAC,CAAC;IACjB,WAAW,GAAG,CAAC,CAAC,CAAC;IACjB,OAAO,GAAG,CAAC,CAAC;IACZ,OAAO,GAAG,CAAC,CAAC;IAEpB,6EAA6E;IAE7E,YAAmB,KAAY,EAAE,MAAyB;QACzD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,UAAU,EAAE,CAAC;IACnB,CAAC;IAED,6EAA6E;IAE7E;;;OAGG;IACI,WAAW,CAAC,MAAc,EAAE,MAAc;QAChD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACvB,CAAC;IAEM,gBAAgB,CAAC,KAAa;QACpC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC1B,CAAC;IAEM,OAAO;QACb,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,YAAY,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACvE,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,WAAW,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACrE,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QACnE,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,aAAa,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QACtE,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAChE,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAChE,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;IAED,6EAA6E;IAEtE,YAAY,CAAC,CAAS,EAAE,CAAS,EAAE,YAAoB;QAC7D,IAAI,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QACtD,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QAErB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAChD,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACzB,CAAC;QACD,UAAU,CAAC,kBAAkB,CAAC,MAAM,EAAE,UAAU,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;IACrG,CAAC;IAEM,WAAW,CAAC,CAAS,EAAE,CAAS,EAAE,YAAoB;QAC5D,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,YAAY,CAAC;YAAE,OAAO;QACrD,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC;YAAE,OAAO;QAC7D,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QAErB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACrC,UAAU,CAAC,kBAAkB,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;IACpG,CAAC;IAEM,UAAU,CAAC,CAAS,EAAE,CAAS,EAAE,YAAoB;QAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1D,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC3C,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAExB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACrC,UAAU,CAAC,kBAAkB,CAAC,MAAM,EAAE,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;QAEnG,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;YAC1B,UAAU,CAAC,kBAAkB,CAAC,MAAM,EAAE,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;QACpG,CAAC;aAAM,CAAC;YACP,UAAU,CAAC,kBAAkB,CAC5B,SAAS,EACT,UAAU,CAAC,qBAAqB,EAChC,IAAI,EACJ,IAAI,EACJ,CAAC,EACD,CAAC,EACD,YAAY,EACZ,KAAK,CACL,CAAC;QACH,CAAC;IACF,CAAC;IAED,6EAA6E;IAErE,UAAU,CAAC,MAAc,EAAE,MAAc;QAChD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC;IAC3D,CAAC;IAEO,cAAc,CAAC,OAAe,EAAE,OAAe;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC;QAClD,oEAAoE;QACpE,kEAAkE;QAClE,0DAA0D;QAC1D,OAAO;YACN,CAAC,EAAE,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,OAAO;YACjE,CAAC,EAAE,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,OAAO;SAC/D,CAAC;IACH,CAAC;IAEO,UAAU;QACjB,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,YAAY,EAAE,IAAI,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACxF,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACtF,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAChE,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,aAAa,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QACnE,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;IAEO,iBAAiB,GAAG,CAAC,CAAwB,EAAQ,EAAE;QAC9D,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;YAClC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACnE,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3C,CAAC;IACF,CAAC,CAAC;IAEM,gBAAgB,GAAG,CAAC,CAAwB,EAAQ,EAAE;QAC7D,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;YAClC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACnE,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;IACF,CAAC,CAAC;IAEM,eAAe,GAAG,CAAC,CAAwB,EAAQ,EAAE;QAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;YAClC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACnE,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QACzC,CAAC;IACF,CAAC,CAAC;IAEM,WAAW,GAAG,CAAC,CAAa,EAAQ,EAAE;QAC7C,oEAAoE;QACpE,mEAAmE;QACnE,uEAAuE;QACvE,8DAA8D;QAC9D,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QAC3D,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC;IAEM,WAAW,GAAG,CAAC,CAAa,EAAQ,EAAE;QAC7C,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QAC3D,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3B,CAAC,CAAC;IAEM,SAAS,GAAG,CAAC,CAAa,EAAQ,EAAE;QAC3C,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QAC3D,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1B,CAAC,CAAC;CACF"}

package/dist/blakron/player/createPlayer.d.ts

@@ -0,0 +1,35 @@
+import { Stage } from '../display/Stage.js';
+import { DisplayObject } from '../display/DisplayObject.js';
+import { Player } from './Player.js';
+import { TouchHandler } from './TouchHandler.js';
+import { ScreenAdapter } from './ScreenAdapter.js';
+import type { BlakronOptions } from './BlakronOptions.js';
+export interface BlakronApp {
+    player: Player;
+    stage: Stage;
+    touchHandler: TouchHandler;
+    screenAdapter: ScreenAdapter;
+    start(root?: DisplayObject): void;
+    stop(): void;
+}
+/**
+ * Creates and initializes a Blakron player from the given options.
+ * This is the main entry point for starting a Blakron application.
+ *
+ * ```ts
+ * import { createPlayer, Sprite } from '@blakron/core';
+ *
+ * const app = createPlayer({
+ *   canvas: document.getElementById('gameCanvas') as HTMLCanvasElement,
+ *   contentWidth: 640,
+ *   contentHeight: 1136,
+ *   scaleMode: 'showAll',
+ *   frameRate: 60,
+ * });
+ *
+ * const root = new Sprite();
+ * app.start(root);
+ * ```
+ */
+export declare function createPlayer(options: BlakronOptions): BlakronApp;
+//# sourceMappingURL=createPlayer.d.ts.map

package/dist/blakron/player/createPlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPlayer.d.ts","sourceRoot":"","sources":["../../../src/blakron/player/createPlayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAClC,IAAI,IAAI,IAAI,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,CAuDhE"}

package/dist/blakron/player/createPlayer.js

@@ -0,0 +1,74 @@
+import { Stage } from '../display/Stage.js';
+import { StageScaleMode } from '../display/enums/StageScaleMode.js';
+import { OrientationMode } from '../display/enums/OrientationMode.js';
+import { RenderTexture } from '../display/texture/RenderTexture.js';
+import { Matrix } from '../geom/Matrix.js';
+import { Player } from './Player.js';
+import { TouchHandler } from './TouchHandler.js';
+import { ScreenAdapter } from './ScreenAdapter.js';
+import { setupLifecycle } from './SystemTicker.js';
+import { CanvasRenderer } from './CanvasRenderer.js';
+import { RenderBuffer } from './RenderBuffer.js';
+import { Capabilities } from '../system/Capabilities.js';
+/**
+ * Creates and initializes a Blakron player from the given options.
+ * This is the main entry point for starting a Blakron application.
+ *
+ * ```ts
+ * import { createPlayer, Sprite } from '@blakron/core';
+ *
+ * const app = createPlayer({
+ *   canvas: document.getElementById('gameCanvas') as HTMLCanvasElement,
+ *   contentWidth: 640,
+ *   contentHeight: 1136,
+ *   scaleMode: 'showAll',
+ *   frameRate: 60,
+ * });
+ *
+ * const root = new Sprite();
+ * app.start(root);
+ * ```
+ */
+export function createPlayer(options) {
+    // Detect runtime environment once per session.
+    Capabilities._init();
+    // Wire up RenderTexture renderer once on first call
+    if (!RenderTexture.renderer) {
+        const _renderer = new CanvasRenderer();
+        RenderTexture.renderer = (displayObject, width, height, offsetX, offsetY) => {
+            const buffer = new RenderBuffer(width, height);
+            const m = new Matrix();
+            m.translate(offsetX, offsetY);
+            _renderer.render(displayObject, buffer, m);
+            return buffer.surface;
+        };
+    }
+    const { canvas, frameRate = 60, scaleMode = StageScaleMode.SHOW_ALL, contentWidth = canvas.width || 640, contentHeight = canvas.height || 1136, orientation = OrientationMode.AUTO, maxTouches = 99, background, } = options;
+    if (background) {
+        canvas.style.backgroundColor = background;
+    }
+    const stage = new Stage();
+    stage.scaleMode = scaleMode;
+    stage.orientation = orientation;
+    stage.maxTouches = maxTouches;
+    stage.frameRate = frameRate;
+    const player = new Player(canvas, stage);
+    const touchHandler = new TouchHandler(stage, canvas);
+    const screenAdapter = new ScreenAdapter(player, canvas, touchHandler, contentWidth, contentHeight);
+    setupLifecycle(stage);
+    return {
+        player,
+        stage,
+        touchHandler,
+        screenAdapter,
+        start(root) {
+            player.start(root);
+        },
+        stop() {
+            player.stop();
+            touchHandler.dispose();
+            screenAdapter.dispose();
+        },
+    };
+}
+//# sourceMappingURL=createPlayer.js.map

package/dist/blakron/player/createPlayer.js.map

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

package/dist/blakron/player/index.d.ts

@@ -0,0 +1,13 @@
+export { Player } from './Player.js';
+export { createPlayer, type BlakronApp } from './createPlayer.js';
+export type { BlakronOptions } from './BlakronOptions.js';
+export { SystemTicker, ticker, getTimer, setupLifecycle, START_TIME, invalidateRenderFlag, setInvalidateRenderFlag, requestRenderingFlag, setRequestRenderingFlag, type Renderable, } from './SystemTicker.js';
+export { InstructionSet, type Instruction } from './InstructionSet.js';
+export type { RenderPipe } from './RenderPipe.js';
+export { RenderBuffer, hitTestBuffer } from './RenderBuffer.js';
+export { CanvasRenderer } from './CanvasRenderer.js';
+export { DisplayList } from './DisplayList.js';
+export { TouchHandler } from './TouchHandler.js';
+export { ScreenAdapter, type StageDisplaySize } from './ScreenAdapter.js';
+export { WebGLRenderer, WebGLRenderContext, WebGLRenderBuffer, WebGLRenderTarget, WebGLVertexArrayObject, WebGLDrawCmdManager, WebGLProgram, ShaderLib, checkWebGLSupport, MultiTextureBatcher, } from './webgl/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/blakron/player/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/blakron/player/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EACN,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,cAAc,EACd,UAAU,EACV,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,UAAU,GACf,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,EACN,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,mBAAmB,GACnB,MAAM,kBAAkB,CAAC"}

package/dist/blakron/player/index.js

@@ -0,0 +1,16 @@
+// ── Core ──────────────────────────────────────────────────────────────────────
+export { Player } from './Player.js';
+export { createPlayer } from './createPlayer.js';
+// ── Ticker ────────────────────────────────────────────────────────────────────
+export { SystemTicker, ticker, getTimer, setupLifecycle, START_TIME, invalidateRenderFlag, setInvalidateRenderFlag, requestRenderingFlag, setRequestRenderingFlag, } from './SystemTicker.js';
+// ── Rendering ─────────────────────────────────────────────────────────────────
+export { InstructionSet } from './InstructionSet.js';
+export { RenderBuffer, hitTestBuffer } from './RenderBuffer.js';
+export { CanvasRenderer } from './CanvasRenderer.js';
+export { DisplayList } from './DisplayList.js';
+// ── Input & Layout ────────────────────────────────────────────────────────────
+export { TouchHandler } from './TouchHandler.js';
+export { ScreenAdapter } from './ScreenAdapter.js';
+// ── WebGL ─────────────────────────────────────────────────────────────────────
+export { WebGLRenderer, WebGLRenderContext, WebGLRenderBuffer, WebGLRenderTarget, WebGLVertexArrayObject, WebGLDrawCmdManager, WebGLProgram, ShaderLib, checkWebGLSupport, MultiTextureBatcher, } from './webgl/index.js';
+//# sourceMappingURL=index.js.map

package/dist/blakron/player/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/blakron/player/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAmB,MAAM,mBAAmB,CAAC;AAGlE,iFAAiF;AACjF,OAAO,EACN,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,cAAc,EACd,UAAU,EACV,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,GAEvB,MAAM,mBAAmB,CAAC;AAE3B,iFAAiF;AACjF,OAAO,EAAE,cAAc,EAAoB,MAAM,qBAAqB,CAAC;AAEvE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAyB,MAAM,oBAAoB,CAAC;AAE1E,iFAAiF;AACjF,OAAO,EACN,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,mBAAmB,GACnB,MAAM,kBAAkB,CAAC"}

package/dist/blakron/player/pipes/BitmapPipe.d.ts

@@ -0,0 +1,35 @@
+import type { Bitmap } from '../../display/Bitmap.js';
+import type { WebGLRenderBuffer } from '../webgl/WebGLRenderBuffer.js';
+import type { Instruction } from '../InstructionSet.js';
+import type { InstructionSet } from '../InstructionSet.js';
+import type { RenderPipe } from '../RenderPipe.js';
+export interface BitmapInstruction extends Instruction {
+    readonly renderPipeId: 'bitmap';
+    renderable: Bitmap;
+    /** Snapshot of the buffer state at build time — updated each frame. */
+    offsetX: number;
+    offsetY: number;
+}
+/**
+ * Handles WebGL rendering of Bitmap display objects.
+ *
+ * addToInstructionSet  — called once when the scene structure changes.
+ * updateRenderable     — called every frame when only data changed.
+ * execute              — issues the actual WebGL draw call.
+ */
+export declare class BitmapPipe implements RenderPipe<Bitmap> {
+    static readonly PIPE_ID = "bitmap";
+    private static readonly _pool;
+    private static _alloc;
+    static release(inst: BitmapInstruction): void;
+    addToInstructionSet(bitmap: Bitmap, set: InstructionSet): void;
+    updateRenderable(_bitmap: Bitmap): void;
+    destroyRenderable(_bitmap: Bitmap): void;
+    /**
+     * Issue the draw call for a BitmapInstruction.
+     * Called by WebGLRenderer._executeInstructions().
+     */
+    execute(inst: BitmapInstruction, buffer: WebGLRenderBuffer): void;
+    private _drawScale9;
+}
+//# sourceMappingURL=BitmapPipe.d.ts.map

package/dist/blakron/player/pipes/BitmapPipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BitmapPipe.d.ts","sourceRoot":"","sources":["../../../../src/blakron/player/pipes/BitmapPipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACrD,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AAID;;;;;;GAMG;AACH,qBAAa,UAAW,YAAW,UAAU,CAAC,MAAM,CAAC;IACpD,gBAAuB,OAAO,YAAY;IAG1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAA2B;IAExD,OAAO,CAAC,MAAM,CAAC,MAAM;WAaP,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAM7C,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI;IAM9D,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKvC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO/C;;;OAGG;IACI,OAAO,CAAC,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAqCxE,OAAO,CAAC,WAAW;CAsFnB"}

package/dist/blakron/player/pipes/BitmapPipe.js

@@ -0,0 +1,130 @@
+// ── Pipe ──────────────────────────────────────────────────────────────────────
+/**
+ * Handles WebGL rendering of Bitmap display objects.
+ *
+ * addToInstructionSet  — called once when the scene structure changes.
+ * updateRenderable     — called every frame when only data changed.
+ * execute              — issues the actual WebGL draw call.
+ */
+export class BitmapPipe {
+    static PIPE_ID = 'bitmap';
+    // Pool of reusable instruction objects to avoid per-frame allocation.
+    static _pool = [];
+    static _alloc(bitmap, offsetX, offsetY) {
+        const inst = BitmapPipe._pool.pop() ?? {
+            renderPipeId: 'bitmap',
+            renderable: bitmap,
+            offsetX,
+            offsetY,
+        };
+        inst.renderable = bitmap;
+        inst.offsetX = offsetX;
+        inst.offsetY = offsetY;
+        return inst;
+    }
+    static release(inst) {
+        BitmapPipe._pool.push(inst);
+    }
+    // ── RenderPipe impl ───────────────────────────────────────────────────────
+    addToInstructionSet(bitmap, set) {
+        // offsetX/Y are patched at execute time from the buffer state;
+        // store 0 as placeholder — the renderer sets them before calling execute.
+        set.add(BitmapPipe._alloc(bitmap, 0, 0));
+    }
+    updateRenderable(_bitmap) {
+        // Bitmap data is read directly from the DisplayObject at execute time,
+        // so no pre-upload step is needed here.
+    }
+    destroyRenderable(_bitmap) {
+        // BitmapData GPU textures are managed by WebGLRenderContext.getWebGLTexture()
+        // and released when BitmapData itself is destroyed — nothing to do here.
+    }
+    // ── Execute ───────────────────────────────────────────────────────────────
+    /**
+     * Issue the draw call for a BitmapInstruction.
+     * Called by WebGLRenderer._executeInstructions().
+     */
+    execute(inst, buffer) {
+        const bitmap = inst.renderable;
+        const bd = bitmap.bitmapData;
+        if (!bd?.source)
+            return;
+        const destW = !isNaN(bitmap.width) ? bitmap.width : bitmap.textureWidth;
+        const destH = !isNaN(bitmap.height) ? bitmap.height : bitmap.textureHeight;
+        if (destW <= 0 || destH <= 0)
+            return;
+        buffer.offsetX = 0;
+        buffer.offsetY = 0;
+        const grid = bitmap.scale9Grid;
+        if (grid) {
+            this._drawScale9(bitmap, bd, grid, destW, destH, buffer);
+        }
+        else {
+            buffer.context.drawImage(bd, bitmap.bitmapX, bitmap.bitmapY, bitmap.bitmapWidth, bitmap.bitmapHeight, bitmap.bitmapOffsetX, bitmap.bitmapOffsetY, destW, destH, bitmap.sourceWidth, bitmap.sourceHeight, bitmap.texture?.rotated ?? false, bitmap.smoothing);
+        }
+        buffer.offsetX = 0;
+        buffer.offsetY = 0;
+    }
+    _drawScale9(bitmap, bd, grid, destW, destH, buffer) {
+        const bx = bitmap.bitmapX;
+        const by = bitmap.bitmapY;
+        const bw = bitmap.bitmapWidth;
+        const bh = bitmap.bitmapHeight;
+        const ox = bitmap.bitmapOffsetX;
+        const oy = bitmap.bitmapOffsetY;
+        const sw = bitmap.sourceWidth;
+        const sh = bitmap.sourceHeight;
+        const rotated = bitmap.texture?.rotated ?? false;
+        const smoothing = bitmap.smoothing;
+        const srcW0 = grid.x - ox;
+        const srcH0 = grid.y - oy;
+        const srcW1 = grid.width;
+        const srcH1 = grid.height;
+        const srcW2 = bw - srcW0 - srcW1;
+        const srcH2 = bh - srcH0 - srcH1;
+        const tgtW0 = srcW0;
+        const tgtH0 = srcH0;
+        const tgtW2 = srcW2;
+        const tgtH2 = srcH2;
+        if (tgtW0 + tgtW2 > destW || tgtH0 + tgtH2 > destH) {
+            buffer.context.drawImage(bd, bx, by, bw, bh, ox, oy, destW, destH, sw, sh, rotated, smoothing);
+            return;
+        }
+        const tgtW1 = destW - tgtW0 - tgtW2;
+        const tgtH1 = destH - tgtH0 - tgtH2;
+        const srcX0 = bx;
+        const srcX1 = srcX0 + srcW0;
+        const srcX2 = srcX1 + srcW1;
+        const srcY0 = by;
+        const srcY1 = srcY0 + srcH0;
+        const srcY2 = srcY1 + srcH1;
+        const tgtX0 = ox;
+        const tgtX1 = tgtX0 + tgtW0;
+        const tgtX2 = tgtX0 + destW - tgtW2;
+        const tgtY0 = oy;
+        const tgtY1 = tgtY0 + tgtH0;
+        const tgtY2 = tgtY0 + destH - tgtH2;
+        const ctx = buffer.context;
+        const draw = (sx, sy, sW, sH, dx, dy, dW, dH) => {
+            if (sW <= 0 || sH <= 0 || dW <= 0 || dH <= 0)
+                return;
+            ctx.drawImage(bd, sx, sy, sW, sH, dx, dy, dW, dH, sw, sh, rotated, smoothing);
+        };
+        if (srcH0 > 0) {
+            draw(srcX0, srcY0, srcW0, srcH0, tgtX0, tgtY0, tgtW0, tgtH0);
+            draw(srcX1, srcY0, srcW1, srcH0, tgtX1, tgtY0, tgtW1, tgtH0);
+            draw(srcX2, srcY0, srcW2, srcH0, tgtX2, tgtY0, tgtW2, tgtH0);
+        }
+        if (srcH1 > 0) {
+            draw(srcX0, srcY1, srcW0, srcH1, tgtX0, tgtY1, tgtW0, tgtH1);
+            draw(srcX1, srcY1, srcW1, srcH1, tgtX1, tgtY1, tgtW1, tgtH1);
+            draw(srcX2, srcY1, srcW2, srcH1, tgtX2, tgtY1, tgtW2, tgtH1);
+        }
+        if (srcH2 > 0) {
+            draw(srcX0, srcY2, srcW0, srcH2, tgtX0, tgtY2, tgtW0, tgtH2);
+            draw(srcX1, srcY2, srcW1, srcH2, tgtX1, tgtY2, tgtW1, tgtH2);
+            draw(srcX2, srcY2, srcW2, srcH2, tgtX2, tgtY2, tgtW2, tgtH2);
+        }
+    }
+}
+//# sourceMappingURL=BitmapPipe.js.map

package/dist/blakron/player/pipes/BitmapPipe.js.map

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

package/dist/blakron/player/pipes/FilterPipe.d.ts

@@ -0,0 +1,68 @@
+import type { DisplayObject } from '../../display/DisplayObject.js';
+import type { Filter } from '../../filters/Filter.js';
+import type { WebGLRenderBuffer } from '../webgl/WebGLRenderBuffer.js';
+import type { Instruction } from '../InstructionSet.js';
+import type { InstructionSet } from '../InstructionSet.js';
+import type { RenderPipe } from '../RenderPipe.js';
+/** Marks the start of a filtered subtree. */
+export interface FilterPushInstruction extends Instruction {
+    readonly renderPipeId: 'filterPush';
+    renderable: DisplayObject;
+    filters: Filter[];
+    offsetX: number;
+    offsetY: number;
+    /**
+     * The blend mode that was active before this filter changed it.
+     * Set during executePush() so executePop() can restore it.
+     */
+    savedBlendMode: string;
+}
+/** Marks the end of a filtered subtree — composites the offscreen result. */
+export interface FilterPopInstruction extends Instruction {
+    readonly renderPipeId: 'filterPop';
+    renderable: DisplayObject;
+    /** Back-reference to the matching push instruction. */
+    push: FilterPushInstruction;
+}
+/**
+ * Handles filter rendering for WebGL.
+ *
+ * The renderer calls pushFilter() before traversing the filtered subtree and
+ * popFilter() after. The pop instruction composites the offscreen buffer back
+ * onto the main buffer with the filter applied.
+ *
+ * This mirrors the old WebGLRenderer._drawWithFilter() logic but expressed as
+ * a pair of instructions so the traversal and execution phases are separated.
+ */
+export declare class FilterPipe implements RenderPipe<DisplayObject> {
+    static readonly PUSH_ID = "filterPush";
+    static readonly POP_ID = "filterPop";
+    private static readonly _pushPool;
+    private static readonly _popPool;
+    addToInstructionSet(_renderable: DisplayObject, _set: InstructionSet): void;
+    updateRenderable(_renderable: DisplayObject): void;
+    static makePush(renderable: DisplayObject, filters: Filter[], offsetX: number, offsetY: number): FilterPushInstruction;
+    static makePop(renderable: DisplayObject, push: FilterPushInstruction): FilterPopInstruction;
+    static releasePush(inst: FilterPushInstruction): void;
+    static releasePop(inst: FilterPopInstruction): void;
+    /**
+     * Called by the renderer when it encounters a filterPush instruction.
+     *
+     * Two paths:
+     * - ColorMatrix inline: sets activeFilter on the main buffer, returns undefined.
+     *   Subsequent leaf instructions draw directly to the main buffer with the
+     *   filter applied per-draw-call.
+     * - All other filters: allocates an offscreen buffer and activates it via
+     *   pushBuffer so that ALL subsequent draw calls (until filterPop) land in
+     *   the offscreen buffer, not the main buffer.
+     *
+     * Returns the offscreen buffer (or undefined for inline path).
+     */
+    executePush(inst: FilterPushInstruction, buffer: WebGLRenderBuffer): WebGLRenderBuffer | undefined;
+    /**
+     * Called by the renderer when it encounters a filterPop instruction.
+     * Deactivates the offscreen buffer and composites it back onto the main buffer.
+     */
+    executePop(inst: FilterPopInstruction, buffer: WebGLRenderBuffer, offscreen: WebGLRenderBuffer | undefined): void;
+}
+//# sourceMappingURL=FilterPipe.d.ts.map

package/dist/blakron/player/pipes/FilterPipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterPipe.d.ts","sourceRoot":"","sources":["../../../../src/blakron/player/pipes/FilterPipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKnD,6CAA6C;AAC7C,MAAM,WAAW,qBAAsB,SAAQ,WAAW;IACzD,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,UAAU,EAAE,aAAa,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,6EAA6E;AAC7E,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACxD,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,UAAU,EAAE,aAAa,CAAC;IAC1B,uDAAuD;IACvD,IAAI,EAAE,qBAAqB,CAAC;CAC5B;AAUD;;;;;;;;;GASG;AACH,qBAAa,UAAW,YAAW,UAAU,CAAC,aAAa,CAAC;IAE3D,gBAAuB,OAAO,gBAAgB;IAC9C,gBAAuB,MAAM,eAAe;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAA+B;IAChE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IAIvD,mBAAmB,CAAC,WAAW,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAK3E,gBAAgB,CAAC,WAAW,EAAE,aAAa,GAAG,IAAI;WAI3C,QAAQ,CACrB,UAAU,EAAE,aAAa,EACzB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACb,qBAAqB;WAaV,OAAO,CAAC,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,qBAAqB,GAAG,oBAAoB;WAUrF,WAAW,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI;WAI9C,UAAU,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;IAM1D;;;;;;;;;;;;OAYG;IACI,WAAW,CAAC,IAAI,EAAE,qBAAqB,EAAE,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,SAAS;IA6CzG;;;OAGG;IACI,UAAU,CAChB,IAAI,EAAE,oBAAoB,EAC1B,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,iBAAiB,GAAG,SAAS,GACtC,IAAI;CAyCP"}