@blakron/core 0.4.3 → 0.5.0

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;IAuDzG;;;OAGG;IACI,UAAU,CAChB,IAAI,EAAE,oBAAoB,EAC1B,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,iBAAiB,GAAG,SAAS,GACtC,IAAI;CA6CP"}

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

@@ -0,0 +1,169 @@
+import { ColorMatrixFilter } from '../../filters/ColorMatrixFilter.js';
+import { WebGLRenderBuffer as WGLBuf } from '../webgl/WebGLRenderBuffer.js';
+// ── Pipe ──────────────────────────────────────────────────────────────────────
+const BLEND_MODES = {
+    0: 'source-over',
+    1: 'lighter',
+    2: 'destination-out',
+};
+/**
+ * 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 class FilterPipe {
+    // ── Static fields ─────────────────────────────────────────────────────────
+    static PUSH_ID = 'filterPush';
+    static POP_ID = 'filterPop';
+    static _pushPool = [];
+    static _popPool = [];
+    // ── RenderPipe impl ───────────────────────────────────────────────────────
+    addToInstructionSet(_renderable, _set) {
+        // FilterPipe instructions are added by the renderer's traversal logic,
+        // not by this method — see WebGLRenderer._buildInstructions().
+    }
+    updateRenderable(_renderable) { }
+    // ── Factory helpers used by the renderer ─────────────────────────────────
+    static makePush(renderable, filters, offsetX, offsetY) {
+        const inst = FilterPipe._pushPool.pop();
+        if (inst) {
+            inst.renderable = renderable;
+            inst.filters = filters;
+            inst.offsetX = offsetX;
+            inst.offsetY = offsetY;
+            inst.savedBlendMode = 'source-over';
+            return inst;
+        }
+        return { renderPipeId: 'filterPush', renderable, filters, offsetX, offsetY, savedBlendMode: 'source-over' };
+    }
+    static makePop(renderable, push) {
+        const inst = FilterPipe._popPool.pop();
+        if (inst) {
+            inst.renderable = renderable;
+            inst.push = push;
+            return inst;
+        }
+        return { renderPipeId: 'filterPop', renderable, push };
+    }
+    static releasePush(inst) {
+        FilterPipe._pushPool.push(inst);
+    }
+    static releasePop(inst) {
+        FilterPipe._popPool.push(inst);
+    }
+    // ── Execute ───────────────────────────────────────────────────────────────
+    /**
+     * 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, buffer) {
+        const filters = inst.filters;
+        if (!filters.length)
+            return undefined;
+        const bounds = inst.renderable.getOriginalBounds();
+        if (bounds.width <= 0 || bounds.height <= 0)
+            return undefined;
+        // Inline ColorMatrix optimisation: no offscreen buffer needed.
+        // Flush any pending commands first, then re-activate the current buffer
+        // so the GL FBO + viewport/projection are in a known-good state before
+        // the leaf draw commands are queued.  Without this, the colorTransform
+        // draw may execute against a stale FBO left by a previous filter pass.
+        if (!inst.renderable.internalMask && filters.length === 1 && filters[0] instanceof ColorMatrixFilter) {
+            const hasBlend = inst.renderable.internalBlendMode !== 0;
+            if (hasBlend) {
+                inst.savedBlendMode = buffer.context.currentBlendMode;
+                buffer.context.setGlobalCompositeOperation(BLEND_MODES[inst.renderable.internalBlendMode] ?? 'source-over');
+            }
+            // Flush pending batched commands so the GL state is clean, then
+            // re-push the current buffer to guarantee an ACT_BUFFER command
+            // precedes the upcoming leaf draw in the next flush.
+            buffer.context.flush();
+            buffer.context.pushBuffer(buffer);
+            buffer.context.activeFilter = filters[0];
+            return undefined; // signal: inline mode, no offscreen
+        }
+        // Offscreen path: redirect all subsequent draw calls into this buffer.
+        // Expand the buffer by the union of all filters' padding so blur/glow
+        // has room to bleed outside the content bounds.
+        let padL = 0, padR = 0, padT = 0, padB = 0;
+        for (const f of filters) {
+            const p = f.getPadding();
+            if (p.left > padL)
+                padL = p.left;
+            if (p.right > padR)
+                padR = p.right;
+            if (p.top > padT)
+                padT = p.top;
+            if (p.bottom > padB)
+                padB = p.bottom;
+        }
+        const offW = Math.ceil(bounds.width + padL + padR);
+        const offH = Math.ceil(bounds.height + padT + padB);
+        const offscreen = WGLBuf.create(buffer.context, offW, offH);
+        // Store padding offsets so the renderer can adjust the offscreen origin.
+        offscreen.filterPadX = padL;
+        offscreen.filterPadY = padT;
+        // pushBuffer activates the offscreen FBO so WebGL draws land there.
+        offscreen.context.pushBuffer(offscreen);
+        return offscreen;
+    }
+    /**
+     * Called by the renderer when it encounters a filterPop instruction.
+     * Deactivates the offscreen buffer and composites it back onto the main buffer.
+     */
+    executePop(inst, buffer, offscreen) {
+        const { renderable, push } = inst;
+        const filters = push.filters;
+        const hasBlend = renderable.internalBlendMode !== 0;
+        const blendOp = BLEND_MODES[renderable.internalBlendMode] ?? 'source-over';
+        // Inline ColorMatrix path — clear the filter flag and pop the buffer
+        // that was pushed in executePush to balance the stack.
+        if (!offscreen) {
+            buffer.context.flush();
+            buffer.context.popBuffer();
+            buffer.context.activeFilter = undefined;
+            if (hasBlend)
+                buffer.context.setGlobalCompositeOperation(push.savedBlendMode);
+            return;
+        }
+        // Deactivate the offscreen buffer, restoring the main buffer as active.
+        offscreen.context.popBuffer();
+        const bounds = renderable.getOriginalBounds();
+        const bx = bounds.x;
+        const by = bounds.y;
+        // Save the current blend mode before applying the filter's blend mode,
+        // so we can restore it after compositing.
+        const prevBlend = buffer.context.currentBlendMode;
+        if (hasBlend)
+            buffer.context.setGlobalCompositeOperation(blendOp);
+        // Position the offscreen result.
+        // The offscreen texture's top-left is (padL, padT) above/left of
+        // the content bounds origin, so we offset by (bx - padL, by - padT).
+        const padX = offscreen.filterPadX;
+        const padY = offscreen.filterPadY;
+        buffer.offsetX = bx - padX;
+        buffer.offsetY = by - padY;
+        buffer.saveTransform();
+        buffer.useOffset();
+        buffer.context.compositeFilterResult(filters, offscreen);
+        buffer.restoreTransform();
+        if (hasBlend)
+            buffer.context.setGlobalCompositeOperation(prevBlend);
+        WGLBuf.release(offscreen);
+    }
+}
+//# sourceMappingURL=FilterPipe.js.map

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

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

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

@@ -0,0 +1,36 @@
+import type { Graphics } from '../../display/Graphics.js';
+import type { DisplayObject } from '../../display/DisplayObject.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';
+import type { CanvasRenderer } from '../CanvasRenderer.js';
+export interface GraphicsInstruction extends Instruction {
+    readonly renderPipeId: 'graphics';
+    renderable: DisplayObject;
+    /** The Graphics object attached to the renderable. */
+    graphics: Graphics;
+    offsetX: number;
+    offsetY: number;
+}
+/**
+ * Handles WebGL rendering of Shape / Sprite graphics.
+ *
+ * Rasterizes the Graphics commands to an offscreen Canvas, uploads as a
+ * WebGL texture, and caches it. The cache is invalidated when
+ * `graphics.canvasCacheDirty` is true (set by Graphics.dirty()).
+ */
+export declare class GraphicsPipe implements RenderPipe<DisplayObject> {
+    static readonly PIPE_ID = "graphics";
+    private static readonly _pool;
+    private readonly _canvasRenderer;
+    private readonly _cache;
+    constructor(canvasRenderer: CanvasRenderer);
+    private static _alloc;
+    static release(inst: GraphicsInstruction): void;
+    addToInstructionSet(renderable: DisplayObject, set: InstructionSet): void;
+    updateRenderable(_renderable: DisplayObject): void;
+    destroyRenderable(renderable: DisplayObject): void;
+    execute(inst: GraphicsInstruction, buffer: WebGLRenderBuffer): void;
+}
+//# sourceMappingURL=GraphicsPipe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GraphicsPipe.d.ts","sourceRoot":"","sources":["../../../../src/blakron/player/pipes/GraphicsPipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE,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;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQ3D,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACvD,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC;IAClC,UAAU,EAAE,aAAa,CAAC;IAC1B,sDAAsD;IACtD,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AAgBD;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,UAAU,CAAC,aAAa,CAAC;IAE7D,gBAAuB,OAAO,cAAc;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAA6B;IAG1D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;gBAG9C,cAAc,EAAE,cAAc;IAIjD,OAAO,CAAC,MAAM,CAAC,MAAM;WAeP,OAAO,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI;IAM/C,mBAAmB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI;IAQzE,gBAAgB,CAAC,WAAW,EAAE,aAAa,GAAG,IAAI;IAKlD,iBAAiB,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI;IAOlD,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;CAiF1E"}

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

@@ -0,0 +1,126 @@
+import { Rectangle } from '../../geom/Rectangle.js';
+import { RenderBuffer } from '../RenderBuffer.js';
+// Shared scratch rectangle — avoids per-execute allocation.
+const _scratchBounds = new Rectangle();
+// ── Pipe ──────────────────────────────────────────────────────────────────────
+/**
+ * Handles WebGL rendering of Shape / Sprite graphics.
+ *
+ * Rasterizes the Graphics commands to an offscreen Canvas, uploads as a
+ * WebGL texture, and caches it. The cache is invalidated when
+ * `graphics.canvasCacheDirty` is true (set by Graphics.dirty()).
+ */
+export class GraphicsPipe {
+    // ── Static fields ─────────────────────────────────────────────────────────
+    static PIPE_ID = 'graphics';
+    static _pool = [];
+    // ── Instance fields ───────────────────────────────────────────────────────
+    _canvasRenderer;
+    _cache = new WeakMap();
+    // ── Constructor ───────────────────────────────────────────────────────────
+    constructor(canvasRenderer) {
+        this._canvasRenderer = canvasRenderer;
+    }
+    static _alloc(renderable, graphics, ox, oy) {
+        const inst = GraphicsPipe._pool.pop() ?? {
+            renderPipeId: 'graphics',
+            renderable,
+            graphics,
+            offsetX: ox,
+            offsetY: oy,
+        };
+        inst.renderable = renderable;
+        inst.graphics = graphics;
+        inst.offsetX = ox;
+        inst.offsetY = oy;
+        return inst;
+    }
+    static release(inst) {
+        GraphicsPipe._pool.push(inst);
+    }
+    // ── RenderPipe impl ───────────────────────────────────────────────────────
+    addToInstructionSet(renderable, set) {
+        const graphics = renderable.graphics;
+        if (!graphics || graphics.commands.length === 0) {
+            return;
+        }
+        set.add(GraphicsPipe._alloc(renderable, graphics, 0, 0));
+    }
+    updateRenderable(_renderable) {
+        // Cache invalidation is driven by graphics.canvasCacheDirty,
+        // which is checked at execute time — nothing to pre-upload here.
+    }
+    destroyRenderable(renderable) {
+        const graphics = renderable.graphics;
+        if (graphics)
+            this._cache.delete(graphics);
+    }
+    // ── Execute ───────────────────────────────────────────────────────────────
+    execute(inst, buffer) {
+        const { graphics } = inst;
+        if (graphics.commands.length === 0) {
+            return;
+        }
+        const bounds = _scratchBounds;
+        bounds.setEmpty();
+        graphics.measureContentBounds(bounds);
+        const w = Math.ceil(bounds.width);
+        const h = Math.ceil(bounds.height);
+        if (w <= 0 || h <= 0) {
+            return;
+        }
+        const ox = inst.offsetX;
+        const oy = inst.offsetY;
+        buffer.offsetX = 0;
+        buffer.offsetY = 0;
+        // ── Cache lookup / rebuild ────────────────────────────────────────────
+        let cache = this._cache.get(graphics);
+        if (!cache) {
+            cache = {
+                renderBuffer: new RenderBuffer(w, h),
+                texture: undefined,
+                textureWidth: 0,
+                textureHeight: 0,
+                boundsX: bounds.x,
+                boundsY: bounds.y,
+            };
+            this._cache.set(graphics, cache);
+        }
+        const needsRebuild = graphics.canvasCacheDirty || cache.textureWidth !== w || cache.textureHeight !== h;
+        if (needsRebuild) {
+            if (cache.renderBuffer.width !== w || cache.renderBuffer.height !== h) {
+                cache.renderBuffer.resize(w, h);
+            }
+            cache.renderBuffer.clear();
+            // skipCache=true: we are the cache owner, bypass CanvasRenderer's own
+            // offscreen canvas layer to avoid a redundant intermediate rasterization.
+            this._canvasRenderer.renderGraphicsToContext(graphics, cache.renderBuffer.context, -bounds.x, -bounds.y, false, true);
+            const surface = cache.renderBuffer.surface;
+            if (!cache.texture) {
+                cache.texture = buffer.context.createTexture(surface);
+            }
+            else {
+                buffer.context.updateTexture(cache.texture, surface);
+            }
+            cache.textureWidth = w;
+            cache.textureHeight = h;
+            cache.boundsX = bounds.x;
+            cache.boundsY = bounds.y;
+            // Consume the dirty flag — Phase 1 set it, we've now rebuilt.
+            graphics.canvasCacheDirty = false;
+        }
+        if (!cache.texture) {
+            return;
+        }
+        // ── Draw cached texture ───────────────────────────────────────────────
+        // ox/oy are already baked into globalMatrix via _applyTransform.
+        // Only add bounds origin (content may start at non-zero local coords).
+        buffer.saveTransform();
+        if (cache.boundsX !== 0 || cache.boundsY !== 0) {
+            buffer.globalMatrix.append(1, 0, 0, 1, cache.boundsX, cache.boundsY);
+        }
+        buffer.context.drawTexture(cache.texture, 0, 0, w, h, 0, 0, w, h, w, h);
+        buffer.restoreTransform();
+    }
+}
+//# sourceMappingURL=GraphicsPipe.js.map

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

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

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

@@ -0,0 +1,58 @@
+import type { DisplayObject } from '../../display/DisplayObject.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 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/pipes/MaskPipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaskPipe.d.ts","sourceRoot":"","sources":["../../../../src/blakron/player/pipes/MaskPipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE,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,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"}