@blakron/core 0.4.0 → 0.4.2

package/dist/blakron/player/webgl/pipes/MaskPipe.d.ts

@@ -0,0 +1,58 @@
+import type { DisplayObject } from '../../../display/DisplayObject.js';
+import type { WebGLRenderBuffer } from '../WebGLRenderBuffer.js';
+import type { Instruction } from '../InstructionSet.js';
+import type { InstructionSet } from '../InstructionSet.js';
+import type { RenderPipe } from '../../RenderPipe.js';
+export interface MaskPushInstruction extends Instruction {
+    readonly renderPipeId: 'maskPush';
+    renderable: DisplayObject;
+    offsetX: number;
+    offsetY: number;
+    isScrollRect?: boolean;
+}
+export interface MaskPopInstruction extends Instruction {
+    readonly renderPipeId: 'maskPop';
+    renderable: DisplayObject;
+    push: MaskPushInstruction;
+}
+/**
+ * Handles mask / clip / scrollRect rendering for WebGL.
+ *
+ * Mirrors the old WebGLRenderer._drawWithClip() and _drawWithScrollRect()
+ * logic as a push/pop instruction pair.
+ */
+export declare class MaskPipe implements RenderPipe<DisplayObject> {
+    static readonly PUSH_ID = "maskPush";
+    static readonly POP_ID = "maskPop";
+    private static readonly _pushPool;
+    private static readonly _popPool;
+    addToInstructionSet(_renderable: DisplayObject, _set: InstructionSet): void;
+    updateRenderable(_renderable: DisplayObject): void;
+    static makePush(renderable: DisplayObject, offsetX: number, offsetY: number): MaskPushInstruction;
+    static makePop(renderable: DisplayObject, push: MaskPushInstruction): MaskPopInstruction;
+    static releasePush(inst: MaskPushInstruction): void;
+    static releasePop(inst: MaskPopInstruction): void;
+    /**
+     * Handles scrollRect / maskRect via scissor or stencil.
+     * Returns true if a scissor was used (caller must call executePopScissor).
+     */
+    executeScrollRectPush(inst: MaskPushInstruction, buffer: WebGLRenderBuffer): boolean;
+    executeScrollRectPop(buffer: WebGLRenderBuffer, usedScissor: boolean): void;
+    /**
+     * Handles DisplayObject mask (stencil-based compositing).
+     *
+     * Allocates an offscreen buffer and activates it via pushBuffer so that
+     * all subsequent leaf instructions (the masked subtree) draw into it.
+     * The mask object itself is rendered separately in executeClipPop because
+     * it is not part of the main InstructionSet.
+     *
+     * Returns the offscreen buffer, or undefined if the object has zero bounds.
+     */
+    executeClipPush(inst: MaskPushInstruction, buffer: WebGLRenderBuffer, renderer: {
+        _drawDisplayObject(obj: DisplayObject, buf: WebGLRenderBuffer, ox: number, oy: number): number;
+    }): WebGLRenderBuffer | undefined;
+    executeClipPop(inst: MaskPopInstruction, buffer: WebGLRenderBuffer, displayBuffer: WebGLRenderBuffer | undefined, renderer: {
+        _drawDisplayObject(obj: DisplayObject, buf: WebGLRenderBuffer, ox: number, oy: number): number;
+    }): void;
+}
+//# sourceMappingURL=MaskPipe.d.ts.map

package/dist/blakron/player/webgl/pipes/MaskPipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaskPipe.d.ts","sourceRoot":"","sources":["../../../../../src/blakron/player/webgl/pipes/MaskPipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAEvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAKtD,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACvD,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC;IAClC,UAAU,EAAE,aAAa,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACtD,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC,UAAU,EAAE,aAAa,CAAC;IAC1B,IAAI,EAAE,mBAAmB,CAAC;CAC1B;AAID;;;;;GAKG;AACH,qBAAa,QAAS,YAAW,UAAU,CAAC,aAAa,CAAC;IAEzD,gBAAuB,OAAO,cAAc;IAC5C,gBAAuB,MAAM,aAAa;IAC1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAA6B;IAC9D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IAIrD,mBAAmB,CAAC,WAAW,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAI3E,gBAAgB,CAAC,WAAW,EAAE,aAAa,GAAG,IAAI;WAI3C,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,mBAAmB;WAY1F,OAAO,CAAC,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,mBAAmB,GAAG,kBAAkB;WAUjF,WAAW,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI;WAI5C,UAAU,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI;IAMxD;;;OAGG;IACI,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO;IAiCpF,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI;IAQlF;;;;;;;;;OASG;IACI,eAAe,CACrB,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE;QAAE,kBAAkB,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAC1G,iBAAiB,GAAG,SAAS;IAgCzB,cAAc,CACpB,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,iBAAiB,EACzB,aAAa,EAAE,iBAAiB,GAAG,SAAS,EAC5C,QAAQ,EAAE;QAAE,kBAAkB,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAC1G,IAAI;CAsGP"}

package/dist/blakron/player/webgl/pipes/MaskPipe.js

@@ -0,0 +1,190 @@
+import { Matrix } from '../../../geom/Matrix.js';
+import { WebGLRenderBuffer as WGLBuf } from '../WebGLRenderBuffer.js';
+// ── Pipe ──────────────────────────────────────────────────────────────────────
+/**
+ * Handles mask / clip / scrollRect rendering for WebGL.
+ *
+ * Mirrors the old WebGLRenderer._drawWithClip() and _drawWithScrollRect()
+ * logic as a push/pop instruction pair.
+ */
+export class MaskPipe {
+    // ── Static fields ─────────────────────────────────────────────────────────
+    static PUSH_ID = 'maskPush';
+    static POP_ID = 'maskPop';
+    static _pushPool = [];
+    static _popPool = [];
+    // ── RenderPipe impl ───────────────────────────────────────────────────────
+    addToInstructionSet(_renderable, _set) {
+        // Added by the renderer traversal, not here.
+    }
+    updateRenderable(_renderable) { }
+    // ── Factory helpers ───────────────────────────────────────────────────────
+    static makePush(renderable, offsetX, offsetY) {
+        const inst = MaskPipe._pushPool.pop();
+        if (inst) {
+            inst.renderable = renderable;
+            inst.offsetX = offsetX;
+            inst.offsetY = offsetY;
+            inst.isScrollRect = undefined;
+            return inst;
+        }
+        return { renderPipeId: 'maskPush', renderable, offsetX, offsetY };
+    }
+    static makePop(renderable, push) {
+        const inst = MaskPipe._popPool.pop();
+        if (inst) {
+            inst.renderable = renderable;
+            inst.push = push;
+            return inst;
+        }
+        return { renderPipeId: 'maskPop', renderable, push };
+    }
+    static releasePush(inst) {
+        MaskPipe._pushPool.push(inst);
+    }
+    static releasePop(inst) {
+        MaskPipe._popPool.push(inst);
+    }
+    // ── Execute ───────────────────────────────────────────────────────────────
+    /**
+     * Handles scrollRect / maskRect via scissor or stencil.
+     * Returns true if a scissor was used (caller must call executePopScissor).
+     */
+    executeScrollRectPush(inst, buffer) {
+        const { renderable } = inst;
+        const rect = renderable.internalScrollRect ?? renderable.internalMaskRect;
+        if (!rect || rect.isEmpty()) {
+            return false;
+        }
+        const m = buffer.globalMatrix;
+        if (buffer.hasScissor || m.b !== 0 || m.c !== 0) {
+            // Stencil path: offsetX/Y are already baked into m.tx/ty via _applyTransform,
+            // so pass rect coords directly (no extra offset needed).
+            buffer.context.pushMask(rect.x, rect.y, rect.width, rect.height);
+            return false; // stencil path
+        }
+        const a = m.a, d = m.d, tx = m.tx, ty = m.ty;
+        // The scissor rectangle is the viewport's screen-space position and size.
+        // rect.x/y is the content scroll offset (already applied to child offsets
+        // in _buildScrollRect via ox -= rect.x / oy -= rect.y), NOT a screen offset.
+        // So we scissor at (0,0,rect.width,rect.height) in local space.
+        const xMax = rect.width, yMax = rect.height;
+        const minX = Math.min(tx, a * xMax + tx);
+        const maxX = Math.max(tx, a * xMax + tx);
+        const minY = Math.min(ty, d * yMax + ty);
+        const maxY = Math.max(ty, d * yMax + ty);
+        buffer.context.enableScissor(minX, -maxY + buffer.height, maxX - minX, maxY - minY);
+        return true; // scissor path
+    }
+    executeScrollRectPop(buffer, usedScissor) {
+        if (usedScissor) {
+            buffer.context.disableScissor();
+        }
+        else {
+            buffer.context.popMask();
+        }
+    }
+    /**
+     * Handles DisplayObject mask (stencil-based compositing).
+     *
+     * Allocates an offscreen buffer and activates it via pushBuffer so that
+     * all subsequent leaf instructions (the masked subtree) draw into it.
+     * The mask object itself is rendered separately in executeClipPop because
+     * it is not part of the main InstructionSet.
+     *
+     * Returns the offscreen buffer, or undefined if the object has zero bounds.
+     */
+    executeClipPush(inst, buffer, renderer) {
+        const { renderable } = inst;
+        const scrollRect = renderable.internalScrollRect ?? renderable.internalMaskRect;
+        // Simple case: no mask object, no children — stencil/scissor only.
+        if (!renderable.internalMask && (!renderable.children || renderable.children.length === 0)) {
+            if (scrollRect) {
+                buffer.context.pushMask(scrollRect.x + inst.offsetX, scrollRect.y + inst.offsetY, scrollRect.width, scrollRect.height);
+            }
+            return undefined;
+        }
+        const bounds = renderable.getOriginalBounds();
+        if (bounds.width <= 0 || bounds.height <= 0) {
+            return undefined;
+        }
+        const bw = bounds.width;
+        const bh = bounds.height;
+        // Allocate and activate the offscreen buffer.
+        // All subsequent draw calls (the masked subtree instructions) will land here.
+        const displayBuffer = WGLBuf.create(buffer.context, bw, bh);
+        displayBuffer.context.pushBuffer(displayBuffer);
+        return displayBuffer;
+    }
+    executeClipPop(inst, buffer, displayBuffer, renderer) {
+        const { renderable, push } = inst;
+        const { offsetX, offsetY } = push;
+        const scrollRect = renderable.internalScrollRect ?? renderable.internalMaskRect;
+        const hasBlend = renderable.internalBlendMode !== 0;
+        const blendOp = hasBlend
+            ? ({ 0: 'source-over', 1: 'lighter', 2: 'destination-out' }[renderable.internalBlendMode] ?? 'source-over')
+            : 'source-over';
+        if (!displayBuffer) {
+            // Simple stencil path — just pop the mask.
+            if (scrollRect) {
+                buffer.context.popMask();
+            }
+            return;
+        }
+        const bounds = renderable.getOriginalBounds();
+        const bx = bounds.x;
+        const by = bounds.y;
+        const bw = bounds.width;
+        const bh = bounds.height;
+        // Apply the mask object (if any) to the displayBuffer via destination-in.
+        const mask = renderable.internalMask;
+        if (mask) {
+            const maskBuffer = WGLBuf.create(buffer.context, bw, bh);
+            maskBuffer.context.pushBuffer(maskBuffer);
+            const maskMatrix = Matrix.create();
+            maskMatrix.copyFrom(mask.getConcatenatedMatrix());
+            mask.getConcatenatedMatrixAt(renderable, maskMatrix);
+            maskMatrix.translate(-bx, -by);
+            maskBuffer.setTransform(maskMatrix.a, maskMatrix.b, maskMatrix.c, maskMatrix.d, maskMatrix.tx, maskMatrix.ty);
+            Matrix.release(maskMatrix);
+            // Render the mask shape directly — it is not in the InstructionSet.
+            renderer._drawDisplayObject(mask, maskBuffer, 0, 0);
+            maskBuffer.context.popBuffer();
+            displayBuffer.context.setGlobalCompositeOperation('destination-in');
+            const mw = maskBuffer.rootRenderTarget.width;
+            const mh = maskBuffer.rootRenderTarget.height;
+            if (maskBuffer.rootRenderTarget.texture) {
+                displayBuffer.setTransform(1, 0, 0, -1, 0, maskBuffer.height);
+                displayBuffer.context.drawTexture(maskBuffer.rootRenderTarget.texture, 0, 0, mw, mh, 0, 0, mw, mh, mw, mh);
+                displayBuffer.setTransform(1, 0, 0, 1, 0, 0);
+            }
+            displayBuffer.context.setGlobalCompositeOperation('source-over');
+            WGLBuf.release(maskBuffer);
+        }
+        // Deactivate the offscreen buffer, restoring the main buffer as active.
+        displayBuffer.context.popBuffer();
+        const prevBlend = buffer.context.currentBlendMode;
+        if (hasBlend)
+            buffer.context.setGlobalCompositeOperation(blendOp);
+        if (scrollRect) {
+            buffer.context.pushMask(scrollRect.x + offsetX, scrollRect.y + offsetY, scrollRect.width, scrollRect.height);
+        }
+        const savedMatrix = Matrix.create();
+        savedMatrix.copyFrom(buffer.globalMatrix);
+        // offsetX/Y already in globalMatrix via _applyTransform; only add bounds flip.
+        buffer.globalMatrix.append(1, 0, 0, -1, bx, by + displayBuffer.height);
+        const dw = displayBuffer.rootRenderTarget.width;
+        const dh = displayBuffer.rootRenderTarget.height;
+        if (displayBuffer.rootRenderTarget.texture) {
+            buffer.context.drawTexture(displayBuffer.rootRenderTarget.texture, 0, 0, dw, dh, 0, 0, dw, dh, dw, dh);
+        }
+        buffer.globalMatrix.copyFrom(savedMatrix);
+        Matrix.release(savedMatrix);
+        if (scrollRect)
+            buffer.context.popMask();
+        if (hasBlend)
+            buffer.context.setGlobalCompositeOperation(prevBlend);
+        WGLBuf.release(displayBuffer);
+    }
+}
+//# sourceMappingURL=MaskPipe.js.map

package/dist/blakron/player/webgl/pipes/MaskPipe.js.map

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

package/dist/blakron/player/webgl/pipes/MeshPipe.d.ts

@@ -0,0 +1,22 @@
+import type { Mesh } from '../../../display/Mesh.js';
+import type { WebGLRenderBuffer } from '../WebGLRenderBuffer.js';
+import type { Instruction } from '../InstructionSet.js';
+import type { InstructionSet } from '../InstructionSet.js';
+import type { RenderPipe } from '../../RenderPipe.js';
+export interface MeshInstruction extends Instruction {
+    readonly renderPipeId: 'mesh';
+    renderable: Mesh;
+    offsetX: number;
+    offsetY: number;
+}
+export declare class MeshPipe implements RenderPipe<Mesh> {
+    static readonly PIPE_ID = "mesh";
+    private static readonly _pool;
+    private static _alloc;
+    static release(inst: MeshInstruction): void;
+    addToInstructionSet(mesh: Mesh, set: InstructionSet): void;
+    updateRenderable(_mesh: Mesh): void;
+    destroyRenderable(_mesh: Mesh): void;
+    execute(inst: MeshInstruction, buffer: WebGLRenderBuffer): void;
+}
+//# sourceMappingURL=MeshPipe.d.ts.map

package/dist/blakron/player/webgl/pipes/MeshPipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MeshPipe.d.ts","sourceRoot":"","sources":["../../../../../src/blakron/player/webgl/pipes/MeshPipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAItD,MAAM,WAAW,eAAgB,SAAQ,WAAW;IACnD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,IAAI,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AAID,qBAAa,QAAS,YAAW,UAAU,CAAC,IAAI,CAAC;IAChD,gBAAuB,OAAO,UAAU;IAExC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAEtD,OAAO,CAAC,MAAM,CAAC,MAAM;WAaP,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAM3C,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI;IAO1D,gBAAgB,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAInC,iBAAiB,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAMpC,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;CAoCtE"}

package/dist/blakron/player/webgl/pipes/MeshPipe.js

@@ -0,0 +1,50 @@
+// ── Pipe ──────────────────────────────────────────────────────────────────────
+export class MeshPipe {
+    static PIPE_ID = 'mesh';
+    static _pool = [];
+    static _alloc(mesh, ox, oy) {
+        const inst = MeshPipe._pool.pop() ?? {
+            renderPipeId: 'mesh',
+            renderable: mesh,
+            offsetX: ox,
+            offsetY: oy,
+        };
+        inst.renderable = mesh;
+        inst.offsetX = ox;
+        inst.offsetY = oy;
+        return inst;
+    }
+    static release(inst) {
+        MeshPipe._pool.push(inst);
+    }
+    // ── RenderPipe impl ───────────────────────────────────────────────────────
+    addToInstructionSet(mesh, set) {
+        if (!mesh.bitmapData?.source || mesh.vertices.length === 0 || mesh.indices.length === 0) {
+            return;
+        }
+        set.add(MeshPipe._alloc(mesh, 0, 0));
+    }
+    updateRenderable(_mesh) {
+        // Mesh data is read directly at execute time.
+    }
+    destroyRenderable(_mesh) {
+        // GPU textures managed by BitmapData lifecycle.
+    }
+    // ── Execute ───────────────────────────────────────────────────────────────
+    execute(inst, buffer) {
+        const mesh = inst.renderable;
+        const bd = mesh.bitmapData;
+        if (!bd?.source || mesh.vertices.length === 0 || mesh.indices.length === 0) {
+            return;
+        }
+        const destW = !isNaN(mesh.width) ? mesh.width : mesh.textureWidth;
+        const destH = !isNaN(mesh.height) ? mesh.height : mesh.textureHeight;
+        // offsetX/Y are already baked into globalMatrix via _applyTransform.
+        buffer.offsetX = 0;
+        buffer.offsetY = 0;
+        buffer.context.drawMesh(bd, mesh.bitmapX, mesh.bitmapY, mesh.bitmapWidth, mesh.bitmapHeight, mesh.bitmapOffsetX, mesh.bitmapOffsetY, destW, destH, mesh.sourceWidth, mesh.sourceHeight, mesh.uvs, mesh.vertices, mesh.indices, mesh.texture?.rotated ?? false, mesh.smoothing);
+        buffer.offsetX = 0;
+        buffer.offsetY = 0;
+    }
+}
+//# sourceMappingURL=MeshPipe.js.map

package/dist/blakron/player/webgl/pipes/MeshPipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MeshPipe.js","sourceRoot":"","sources":["../../../../../src/blakron/player/webgl/pipes/MeshPipe.ts"],"names":[],"mappings":"AAgBA,iFAAiF;AAEjF,MAAM,OAAO,QAAQ;IACb,MAAM,CAAU,OAAO,GAAG,MAAM,CAAC;IAEhC,MAAM,CAAU,KAAK,GAAsB,EAAE,CAAC;IAE9C,MAAM,CAAC,MAAM,CAAC,IAAU,EAAE,EAAU,EAAE,EAAU;QACvD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI;YACpC,YAAY,EAAE,MAAM;YACpB,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,EAAE;SACX,CAAC;QACF,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACb,CAAC;IAEM,MAAM,CAAC,OAAO,CAAC,IAAqB;QAC1C,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,6EAA6E;IAEtE,mBAAmB,CAAC,IAAU,EAAE,GAAmB;QACzD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzF,OAAO;QACR,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IAEM,gBAAgB,CAAC,KAAW;QAClC,8CAA8C;IAC/C,CAAC;IAEM,iBAAiB,CAAC,KAAW;QACnC,gDAAgD;IACjD,CAAC;IAED,6EAA6E;IAEtE,OAAO,CAAC,IAAqB,EAAE,MAAyB;QAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC;QAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QAC3B,IAAI,CAAC,EAAE,EAAE,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5E,OAAO;QACR,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;QAClE,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;QAErE,qEAAqE;QACrE,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;QACnB,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;QAEnB,MAAM,CAAC,OAAO,CAAC,QAAQ,CACtB,EAAE,EACF,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,aAAa,EAClB,KAAK,EACL,KAAK,EACL,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,GAAG,EACR,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,OAAO,EAAE,OAAO,IAAI,KAAK,EAC9B,IAAI,CAAC,SAAS,CACd,CAAC;QAEF,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;QACnB,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;IACpB,CAAC"}

package/dist/blakron/player/webgl/pipes/TextPipe.d.ts

@@ -0,0 +1,52 @@
+import type { TextField } from '../../../text/TextField.js';
+import type { WebGLRenderBuffer } from '../WebGLRenderBuffer.js';
+import type { Instruction } from '../InstructionSet.js';
+import type { InstructionSet } from '../InstructionSet.js';
+import type { RenderPipe } from '../../RenderPipe.js';
+import type { CanvasRenderer } from '../../canvas/index.js';
+export interface TextInstruction extends Instruction {
+    readonly renderPipeId: 'text';
+    renderable: TextField;
+    offsetX: number;
+    offsetY: number;
+}
+/**
+ * Handles WebGL rendering of TextField display objects.
+ *
+ * **Architecture** (following Egret's `WebGLRenderer.renderText`):
+ *
+ * 1. Compute the text draw area (width × height).
+ * 2. Scale by the device pixel ratio (`canvasScaleX/Y`), clamped to
+ *    `maxTextureSize` so we never exceed the GPU's limit.
+ * 3. Rasterize the text onto an offscreen `<canvas>` via `CanvasRenderer`.
+ * 4. Upload the canvas as a WebGL texture (create once, update on change).
+ * 5. Draw the texture via `buffer.context.drawTexture()`, scaling back down
+ *    by `canvasScale` so the on-screen size is correct.
+ *
+ * The cache is invalidated when `tf.renderDirty` is true or when the
+ * dimensions / DPR change.
+ */
+export declare class TextPipe implements RenderPipe<TextField> {
+    static readonly PIPE_ID = "text";
+    private static readonly _pool;
+    private readonly _canvasRenderer;
+    private readonly _cache;
+    constructor(canvasRenderer: CanvasRenderer);
+    private static _alloc;
+    static release(inst: TextInstruction): void;
+    addToInstructionSet(tf: TextField, set: InstructionSet): void;
+    updateRenderable(_tf: TextField): void;
+    destroyRenderable(tf: TextField): void;
+    /**
+     * Render a TextField into the WebGL buffer.
+     * Follows Egret's `WebGLRenderer.renderText` pattern:
+     *
+     *   1. Compute logical width/height from the TextField.
+     *   2. Scale by canvasScale (DPR), clamped to maxTextureSize.
+     *   3. Rasterize to offscreen canvas (if dirty).
+     *   4. Upload as WebGL texture.
+     *   5. Draw with drawTexture, scaling back by canvasScale.
+     */
+    execute(inst: TextInstruction, buffer: WebGLRenderBuffer): void;
+}
+//# sourceMappingURL=TextPipe.d.ts.map

package/dist/blakron/player/webgl/pipes/TextPipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextPipe.d.ts","sourceRoot":"","sources":["../../../../../src/blakron/player/webgl/pipes/TextPipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D,MAAM,WAAW,eAAgB,SAAQ,WAAW;IACnD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,SAAS,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AAoBD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAS,YAAW,UAAU,CAAC,SAAS,CAAC;IAErD,gBAAuB,OAAO,UAAU;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAGtD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;gBAG3C,cAAc,EAAE,cAAc;IAIjD,OAAO,CAAC,MAAM,CAAC,MAAM;WAaP,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAM3C,mBAAmB,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI;IAI7D,gBAAgB,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAKtC,iBAAiB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI;IAM7C;;;;;;;;;OASG;IACI,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;CAmHtE"}

package/dist/blakron/player/webgl/pipes/TextPipe.js

@@ -0,0 +1,163 @@
+import { TextFieldType } from '../../../text/enums/TextFieldType.js';
+import { RenderBuffer } from '../../canvas/index.js';
+// ── Pipe ──────────────────────────────────────────────────────────────────────
+/**
+ * Handles WebGL rendering of TextField display objects.
+ *
+ * **Architecture** (following Egret's `WebGLRenderer.renderText`):
+ *
+ * 1. Compute the text draw area (width × height).
+ * 2. Scale by the device pixel ratio (`canvasScaleX/Y`), clamped to
+ *    `maxTextureSize` so we never exceed the GPU's limit.
+ * 3. Rasterize the text onto an offscreen `<canvas>` via `CanvasRenderer`.
+ * 4. Upload the canvas as a WebGL texture (create once, update on change).
+ * 5. Draw the texture via `buffer.context.drawTexture()`, scaling back down
+ *    by `canvasScale` so the on-screen size is correct.
+ *
+ * The cache is invalidated when `tf.renderDirty` is true or when the
+ * dimensions / DPR change.
+ */
+export class TextPipe {
+    // ── Static fields ─────────────────────────────────────────────────────────
+    static PIPE_ID = 'text';
+    static _pool = [];
+    // ── Instance fields ───────────────────────────────────────────────────────
+    _canvasRenderer;
+    _cache = new WeakMap();
+    // ── Constructor ───────────────────────────────────────────────────────────
+    constructor(canvasRenderer) {
+        this._canvasRenderer = canvasRenderer;
+    }
+    static _alloc(tf, ox, oy) {
+        const inst = TextPipe._pool.pop() ?? {
+            renderPipeId: 'text',
+            renderable: tf,
+            offsetX: ox,
+            offsetY: oy,
+        };
+        inst.renderable = tf;
+        inst.offsetX = ox;
+        inst.offsetY = oy;
+        return inst;
+    }
+    static release(inst) {
+        TextPipe._pool.push(inst);
+    }
+    // ── RenderPipe impl ───────────────────────────────────────────────────────
+    addToInstructionSet(tf, set) {
+        set.add(TextPipe._alloc(tf, 0, 0));
+    }
+    updateRenderable(_tf) {
+        // Cache invalidation is driven by tf.renderDirty,
+        // which is checked at execute time — nothing to pre-upload here.
+    }
+    destroyRenderable(tf) {
+        this._cache.delete(tf);
+    }
+    // ── Execute ───────────────────────────────────────────────────────────────
+    /**
+     * Render a TextField into the WebGL buffer.
+     * Follows Egret's `WebGLRenderer.renderText` pattern:
+     *
+     *   1. Compute logical width/height from the TextField.
+     *   2. Scale by canvasScale (DPR), clamped to maxTextureSize.
+     *   3. Rasterize to offscreen canvas (if dirty).
+     *   4. Upload as WebGL texture.
+     *   5. Draw with drawTexture, scaling back by canvasScale.
+     */
+    execute(inst, buffer) {
+        const tf = inst.renderable;
+        tf.getLinesArr(); // ensure lines are computed
+        // ── INPUT mode while focused: HTML input element owns the display ────
+        // Don't render the canvas texture — the native <input>/<textarea>
+        // is overlaid on top and already shows the text. Rendering here too
+        // would produce a double-text artefact.
+        if (tf.type === TextFieldType.INPUT && tf.isTyping) {
+            return;
+        }
+        // ── 1. Compute logical dimensions ────────────────────────────────────
+        const logicalW = Math.ceil(!isNaN(tf.explicitWidth) ? tf.explicitWidth : tf.textWidth);
+        const logicalH = Math.ceil(!isNaN(tf.explicitHeight) ? tf.explicitHeight : tf.textHeight);
+        if (logicalW <= 0 || logicalH <= 0) {
+            return;
+        }
+        buffer.offsetX = 0;
+        buffer.offsetY = 0;
+        // ── 2. Canvas scale factor (DPR handling) ────────────────────────────
+        // Follow Egret: scale the offscreen canvas by DPR so text looks crisp
+        // on HiDPI screens, but clamp to maxTextureSize to avoid GPU limits.
+        let canvasScaleX = /* devicePixelRatio || */ 1;
+        let canvasScaleY = /* devicePixelRatio || */ 1;
+        const maxTexSize = buffer.context.maxTextureSize;
+        if (logicalW * canvasScaleX > maxTexSize) {
+            canvasScaleX *= maxTexSize / (logicalW * canvasScaleX);
+        }
+        if (logicalH * canvasScaleY > maxTexSize) {
+            canvasScaleY *= maxTexSize / (logicalH * canvasScaleY);
+        }
+        // Scaled pixel dimensions for the offscreen canvas.
+        const pixelW = Math.ceil(logicalW * canvasScaleX);
+        const pixelH = Math.ceil(logicalH * canvasScaleY);
+        // ── 3. Cache lookup / rebuild ────────────────────────────────────────
+        let cache = this._cache.get(tf);
+        let scaleChanged = false;
+        if (cache) {
+            // Check if canvasScale changed (e.g. window moved between displays).
+            scaleChanged = cache.canvasScaleX !== canvasScaleX || cache.canvasScaleY !== canvasScaleY;
+            if (scaleChanged) {
+                cache.canvasScaleX = canvasScaleX;
+                cache.canvasScaleY = canvasScaleY;
+            }
+        }
+        else {
+            cache = {
+                renderBuffer: new RenderBuffer(pixelW, pixelH),
+                texture: undefined,
+                textureWidth: 0,
+                textureHeight: 0,
+                canvasScaleX,
+                canvasScaleY,
+            };
+            this._cache.set(tf, cache);
+        }
+        // Dirty when: text content changed, dimensions changed, or DPR changed.
+        const needsRebuild = tf.renderDirty || cache.textureWidth !== pixelW || cache.textureHeight !== pixelH || scaleChanged;
+        if (needsRebuild) {
+            // Resize the offscreen canvas if needed.
+            if (cache.renderBuffer.width !== pixelW || cache.renderBuffer.height !== pixelH) {
+                cache.renderBuffer.resize(pixelW, pixelH);
+            }
+            // Clear the buffer first (note: clear() resets the transform to identity).
+            cache.renderBuffer.clear();
+            // Apply canvas scale transform so text renders at the higher resolution.
+            const ctx = cache.renderBuffer.context;
+            if (canvasScaleX !== 1 || canvasScaleY !== 1) {
+                ctx.setTransform(canvasScaleX, 0, 0, canvasScaleY, 0, 0);
+            }
+            // Rasterize the text onto the offscreen canvas.
+            this._canvasRenderer.renderTextFieldToContext(tf, ctx, 0, 0);
+            // Upload to WebGL texture.
+            const surface = cache.renderBuffer.surface;
+            if (!cache.texture) {
+                cache.texture = buffer.context.createTexture(surface);
+            }
+            else {
+                buffer.context.updateTexture(cache.texture, surface);
+            }
+            cache.textureWidth = pixelW;
+            cache.textureHeight = pixelH;
+        }
+        if (!cache.texture)
+            return;
+        // ── 4. Draw cached texture ───────────────────────────────────────────
+        // Following Egret: draw the full texture but scale the destination by
+        // 1/canvasScale so the on-screen size matches the logical dimensions.
+        buffer.context.drawTexture(cache.texture, 0, 0, cache.textureWidth, cache.textureHeight, // src rect (full texture)
+        0, 0, // dest position (offset already in globalMatrix via _applyTransform)
+        cache.textureWidth / canvasScaleX, // dest width (scaled back)
+        cache.textureHeight / canvasScaleY, // dest height (scaled back)
+        cache.textureWidth, // texture source width
+        cache.textureHeight);
+    }
+}
+//# sourceMappingURL=TextPipe.js.map

package/dist/blakron/player/webgl/pipes/TextPipe.js.map

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

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

@@ -0,0 +1,7 @@
+export { BitmapPipe, type BitmapInstruction } from './BitmapPipe.js';
+export { FilterPipe, type FilterPushInstruction, type FilterPopInstruction } from './FilterPipe.js';
+export { GraphicsPipe, type GraphicsInstruction } from './GraphicsPipe.js';
+export { MaskPipe, type MaskPushInstruction, type MaskPopInstruction } from './MaskPipe.js';
+export { MeshPipe, type MeshInstruction } from './MeshPipe.js';
+export { TextPipe, type TextInstruction } from './TextPipe.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/blakron/player/webgl/pipes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,KAAK,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/blakron/player/webgl/pipes/index.js

@@ -0,0 +1,7 @@
+export { BitmapPipe } from './BitmapPipe.js';
+export { FilterPipe } from './FilterPipe.js';
+export { GraphicsPipe } from './GraphicsPipe.js';
+export { MaskPipe } from './MaskPipe.js';
+export { MeshPipe } from './MeshPipe.js';
+export { TextPipe } from './TextPipe.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/blakron/player/webgl/pipes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA0B,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAyD,MAAM,iBAAiB,CAAC;AACpG,OAAO,EAAE,YAAY,EAA4B,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAqD,MAAM,eAAe,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAwB,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAwB,MAAM,eAAe,CAAC"}