@oh-just-another/renderer-canvas 0.59.0 → 0.61.0

package/dist/render-worker.js

@@ -2,7 +2,7 @@
 import { LruCache, installBuiltinRenderers, renderScene } from "@oh-just-another/renderer-core";
 import { registerBundledFonts } from "@oh-just-another/fonts";
 import { Canvas2DTarget } from "./canvas-target.js";
-import { replayCommands } from "./recording-target.js";
+import { replayPackedFrame } from "./replay-codec.js";
 import { OFFSCREEN_IMAGE_CACHE_CAP } from "./constants.js";
 const state = {
     canvas: null,
@@ -77,17 +77,29 @@ const snapshot = (scene) => {
     post({ type: "frame-done", bitmap }, [bitmap]);
 };
 /**
- * Replay a serialised RecordingTarget command stream onto the owned
+ * Replay a packed RecordingTarget command stream onto the owned
  * OffscreenCanvas. Used by the LayeredSurface "offscreen" backend: the
- * main thread captures every RenderTarget call into a buffer and ships
- * it here per frame; the worker replays.
+ * main thread captures every RenderTarget call into a buffer, packs it
+ * via `packReplayFrame`, and ships it here per frame (numeric stream in
+ * the transfer list, bitmaps cloned alongside); the worker replays.
  */
-const replay = (commands) => {
+const replay = (msg) => {
     if (!state.target) {
         post({ type: "error", message: "Worker not initialised" });
         return;
     }
-    replayCommands(state.target, commands, state.images);
+    // Register this frame's bitmaps BEFORE replaying so the stream's
+    // drawImage id references resolve. These are worker-owned clones —
+    // the LRU's evict hook closes them.
+    for (const { id, bitmap } of msg.bitmaps) {
+        // A re-defined id (re-captured video frame) replaces the stored clone;
+        // close the old one — LruCache.set does not fire onEvict on overwrite.
+        const prev = state.images.get(id);
+        if (prev && prev !== bitmap)
+            prev.close();
+        state.images.set(id, bitmap);
+    }
+    replayPackedFrame(state.target, msg.buffer, msg.strings, state.images);
 };
 self.addEventListener("message", (ev) => {
     const msg = ev.data;
@@ -105,7 +117,7 @@ self.addEventListener("message", (ev) => {
                 snapshot(msg.scene);
                 break;
             case "replay":
-                replay(msg.commands);
+                replay(msg);
                 break;
             case "frame":
                 // Patch-stream frames are not implemented; the protocol is

package/dist/render-worker.js.map

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

package/dist/replay-codec.d.ts

@@ -0,0 +1,56 @@
+import { LruCache, type RenderTarget } from "@oh-just-another/renderer-core";
+import type { RenderCommand } from "./recording-target.js";
+/** One `defineImage` payload carried alongside the numeric stream. */
+export interface PackedFrameBitmap {
+    readonly id: number;
+    readonly bitmap: ImageBitmap;
+}
+/**
+ * Result of {@link packReplayFrame}: `buffer` is the transferable numeric
+ * stream, `strings` the per-frame deduplicated string table it indexes
+ * into, `bitmaps` the `defineImage` payloads (worker registers them BEFORE
+ * replaying the stream).
+ */
+export interface PackedReplayFrame {
+    readonly buffer: ArrayBuffer;
+    readonly strings: readonly string[];
+    readonly bitmaps: readonly PackedFrameBitmap[];
+}
+/**
+ * postMessage shape the offscreen surface posts per changed layer and the
+ * render worker consumes. `buffer` goes in the transfer list; `strings`
+ * are cloned (cheap — deduplicated); `bitmaps` are CLONED, never
+ * transferred — see {@link packReplayFrame}.
+ */
+export interface PackedReplayMessage {
+    readonly type: "replay";
+    readonly buffer: ArrayBuffer;
+    readonly strings: readonly string[];
+    readonly bitmaps: readonly PackedFrameBitmap[];
+}
+/**
+ * Flatten a flushed {@link RenderCommand} buffer into a transferable packed
+ * frame: one Float64 word per opcode / argument, strings deduplicated into
+ * a side table, enums and presence flags as small ints.
+ *
+ * `defineImage` commands emit nothing into the numeric stream; their
+ * `{ id, bitmap }` payloads are collected into `bitmaps` instead. The
+ * caller must post them WITHOUT a transfer-list entry so `postMessage`
+ * clones the pixels: the recorder's intern LRU still owns the source
+ * bitmap and will keep drawing it on later frames (GIF / video), so
+ * transferring (detaching) it would break the main thread's copy.
+ */
+export declare const packReplayFrame: (commands: readonly RenderCommand[]) => PackedReplayFrame;
+/**
+ * Decode a packed frame and dispatch each command straight onto `target`
+ * in one pass — no intermediate {@link RenderCommand} objects.
+ *
+ * `images` is the worker's persistent id → bitmap LRU (mirrors the
+ * recorder's same-capacity intern LRU): the caller must have registered
+ * the frame's side bitmaps into it BEFORE calling. Semantics match
+ * {@link replayCommands}: `resize` is a no-op (the worker owns the canvas
+ * size via its own `resize` message) and a `drawImage` whose id misses the
+ * cache is skipped rather than thrown.
+ */
+export declare const replayPackedFrame: (target: RenderTarget, buffer: ArrayBuffer, strings: readonly string[], images?: LruCache<number, ImageBitmap>) => void;
+//# sourceMappingURL=replay-codec.d.ts.map

package/dist/replay-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-codec.d.ts","sourceRoot":"","sources":["../src/replay-codec.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EAIR,KAAK,YAAY,EAGlB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AA0G3D,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAChD;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAChD;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,SAAS,aAAa,EAAE,KAAG,iBAgOpE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,YAAY,EACpB,QAAQ,WAAW,EACnB,SAAS,SAAS,MAAM,EAAE,EAC1B,SAAQ,QAAQ,CAAC,MAAM,EAAE,WAAW,CAA2C,KAC9E,IAuLF,CAAC"}

package/dist/replay-codec.js

@@ -0,0 +1,543 @@
+import { LruCache, } from "@oh-just-another/renderer-core";
+import { OFFSCREEN_IMAGE_CACHE_CAP } from "./constants.js";
+/**
+ * Packed-frame codec for the offscreen backend's per-frame worker hop.
+ *
+ * `structuredClone`-ing an array of {@link RenderCommand} objects costs
+ * ~1.6 ms for a ~4.5k-command frame (see `tests/offscreen-transfer.bench.ts`)
+ * — every object, key, and string is walked and copied. This codec flattens
+ * the stream into one transferable `ArrayBuffer` of Float64 words (opcode +
+ * args per command) plus a per-frame deduplicated string table, so
+ * `postMessage` transfers the numeric bulk for free and only clones a small
+ * string array. `ImageBitmap` payloads (`defineImage`) travel in a side
+ * array — see {@link packReplayFrame}.
+ */
+/**
+ * Opcodes for the packed numeric stream — one per {@link RenderCommand}
+ * variant except `defineImage`, which travels in the side bitmap array and
+ * emits nothing here. Wire format only: values are arbitrary but must stay
+ * in sync between {@link packReplayFrame} and {@link replayPackedFrame}
+ * (same-package protocol; both sides always ship together).
+ */
+const OP_SET_FILL = 0;
+const OP_SET_STROKE = 1;
+const OP_SET_STROKE_WIDTH = 2;
+const OP_SET_OPACITY = 3;
+const OP_SET_LINE_CAP = 4;
+const OP_SET_LINE_JOIN = 5;
+const OP_SET_DASH_ARRAY = 6;
+const OP_SET_FONT = 7;
+const OP_SET_TEXT_ALIGN = 8;
+const OP_SET_TEXT_BASELINE = 9;
+const OP_SAVE = 10;
+const OP_RESTORE = 11;
+const OP_TRANSLATE = 12;
+const OP_ROTATE = 13;
+const OP_SCALE = 14;
+const OP_SET_TRANSFORM = 15;
+const OP_RESET_TRANSFORM = 16;
+const OP_BEGIN_PATH = 17;
+const OP_CLOSE_PATH = 18;
+const OP_MOVE_TO = 19;
+const OP_LINE_TO = 20;
+const OP_QUADRATIC_CURVE_TO = 21;
+const OP_BEZIER_CURVE_TO = 22;
+const OP_RECT = 23;
+const OP_ELLIPSE = 24;
+const OP_FILL = 25;
+const OP_STROKE = 26;
+const OP_FILL_TEXT = 27;
+const OP_CLEAR = 28;
+const OP_MARK_DIRTY = 29;
+const OP_RESIZE = 30;
+const OP_DRAW_IMAGE = 31;
+/**
+ * String-table index sentinel for a `null` color (`setFill` / `setStroke`
+ * accept `Color | null`). Real indices are >= 0.
+ */
+const NULL_STRING_INDEX = -1;
+/** `setDashArray(null)` marker written in place of the dash length. */
+const NULL_DASH_LENGTH = -1;
+/**
+ * Enum wire codes. Encode side uses the `*_CODE` records, decode side the
+ * positional arrays — index === code. Order is wire format; append only.
+ */
+const LINE_CAPS = ["butt", "round", "square"];
+const LINE_CAP_CODE = { butt: 0, round: 1, square: 2 };
+const LINE_JOINS = ["miter", "round", "bevel"];
+const LINE_JOIN_CODE = { miter: 0, round: 1, bevel: 2 };
+const TEXT_ALIGNS = ["left", "center", "right"];
+const TEXT_ALIGN_CODE = { left: 0, center: 1, right: 2 };
+const TEXT_BASELINES = ["top", "middle", "bottom"];
+const TEXT_BASELINE_CODE = { top: 0, middle: 1, bottom: 2 };
+/**
+ * `fill(rule?)` wire codes: 0 = no rule argument, 1 = "nonzero",
+ * 2 = "evenodd".
+ */
+const FILL_RULE_CODE = { nonzero: 1, evenodd: 2 };
+/**
+ * `setFont` options wire codes. 0 = key absent from the options object;
+ * 1 / 2 = the two allowed values. A separate leading flag word (0 / 1)
+ * distinguishes "no options argument at all" from an empty options object.
+ */
+const FONT_WEIGHT_CODE = { normal: 1, bold: 2 };
+const FONT_STYLE_CODE = { normal: 1, italic: 2 };
+/** Optional-argument presence flags (`fillText` maxWidth, `clear` bounds). */
+const ABSENT = 0;
+const PRESENT = 1;
+/**
+ * Initial capacity (in Float64 words) of the packed stream, as a multiple
+ * of the command count. Most commands fit in opcode + ≤6 args; the writer
+ * doubles on overflow, so this only tunes how often the first frames
+ * reallocate.
+ */
+const PACK_WORDS_PER_COMMAND = 4;
+/** Floor for the writer's initial capacity so tiny frames don't thrash. */
+const PACK_MIN_CAPACITY = 64;
+/**
+ * Flatten a flushed {@link RenderCommand} buffer into a transferable packed
+ * frame: one Float64 word per opcode / argument, strings deduplicated into
+ * a side table, enums and presence flags as small ints.
+ *
+ * `defineImage` commands emit nothing into the numeric stream; their
+ * `{ id, bitmap }` payloads are collected into `bitmaps` instead. The
+ * caller must post them WITHOUT a transfer-list entry so `postMessage`
+ * clones the pixels: the recorder's intern LRU still owns the source
+ * bitmap and will keep drawing it on later frames (GIF / video), so
+ * transferring (detaching) it would break the main thread's copy.
+ */
+export const packReplayFrame = (commands) => {
+    let words = new Float64Array(Math.max(PACK_MIN_CAPACITY, commands.length * PACK_WORDS_PER_COMMAND));
+    let used = 0;
+    const push = (v) => {
+        if (used === words.length) {
+            const grown = new Float64Array(words.length * 2);
+            grown.set(words);
+            words = grown;
+        }
+        words[used++] = v;
+    };
+    const strings = [];
+    const stringIndex = new Map();
+    /** Dedup a string through the per-frame table, returning its index. */
+    const intern = (s) => {
+        let idx = stringIndex.get(s);
+        if (idx === undefined) {
+            idx = strings.length;
+            strings.push(s);
+            stringIndex.set(s, idx);
+        }
+        return idx;
+    };
+    const bitmaps = [];
+    for (const cmd of commands) {
+        switch (cmd.k) {
+            case "setFill":
+                push(OP_SET_FILL);
+                push(cmd.color === null ? NULL_STRING_INDEX : intern(cmd.color));
+                break;
+            case "setStroke":
+                push(OP_SET_STROKE);
+                push(cmd.color === null ? NULL_STRING_INDEX : intern(cmd.color));
+                break;
+            case "setStrokeWidth":
+                push(OP_SET_STROKE_WIDTH);
+                push(cmd.w);
+                break;
+            case "setOpacity":
+                push(OP_SET_OPACITY);
+                push(cmd.a);
+                break;
+            case "setLineCap":
+                push(OP_SET_LINE_CAP);
+                push(LINE_CAP_CODE[cmd.cap]);
+                break;
+            case "setLineJoin":
+                push(OP_SET_LINE_JOIN);
+                push(LINE_JOIN_CODE[cmd.join]);
+                break;
+            case "setDashArray":
+                push(OP_SET_DASH_ARRAY);
+                if (cmd.dash === null) {
+                    push(NULL_DASH_LENGTH);
+                }
+                else {
+                    push(cmd.dash.length);
+                    for (const d of cmd.dash)
+                        push(d);
+                }
+                break;
+            case "setFont":
+                push(OP_SET_FONT);
+                push(intern(cmd.family));
+                push(cmd.size);
+                if (cmd.options === undefined) {
+                    push(ABSENT);
+                }
+                else {
+                    push(PRESENT);
+                    push(cmd.options.weight === undefined ? 0 : FONT_WEIGHT_CODE[cmd.options.weight]);
+                    push(cmd.options.style === undefined ? 0 : FONT_STYLE_CODE[cmd.options.style]);
+                }
+                break;
+            case "setTextAlign":
+                push(OP_SET_TEXT_ALIGN);
+                push(TEXT_ALIGN_CODE[cmd.align]);
+                break;
+            case "setTextBaseline":
+                push(OP_SET_TEXT_BASELINE);
+                push(TEXT_BASELINE_CODE[cmd.baseline]);
+                break;
+            case "save":
+                push(OP_SAVE);
+                break;
+            case "restore":
+                push(OP_RESTORE);
+                break;
+            case "translate":
+                push(OP_TRANSLATE);
+                push(cmd.x);
+                push(cmd.y);
+                break;
+            case "rotate":
+                push(OP_ROTATE);
+                push(cmd.r);
+                break;
+            case "scale":
+                push(OP_SCALE);
+                push(cmd.sx);
+                push(cmd.sy);
+                break;
+            case "setTransform":
+                push(OP_SET_TRANSFORM);
+                push(cmd.t.a);
+                push(cmd.t.b);
+                push(cmd.t.c);
+                push(cmd.t.d);
+                push(cmd.t.e);
+                push(cmd.t.f);
+                break;
+            case "resetTransform":
+                push(OP_RESET_TRANSFORM);
+                break;
+            case "beginPath":
+                push(OP_BEGIN_PATH);
+                break;
+            case "closePath":
+                push(OP_CLOSE_PATH);
+                break;
+            case "moveTo":
+                push(OP_MOVE_TO);
+                push(cmd.x);
+                push(cmd.y);
+                break;
+            case "lineTo":
+                push(OP_LINE_TO);
+                push(cmd.x);
+                push(cmd.y);
+                break;
+            case "quadraticCurveTo":
+                push(OP_QUADRATIC_CURVE_TO);
+                push(cmd.cx);
+                push(cmd.cy);
+                push(cmd.x);
+                push(cmd.y);
+                break;
+            case "bezierCurveTo":
+                push(OP_BEZIER_CURVE_TO);
+                push(cmd.c1x);
+                push(cmd.c1y);
+                push(cmd.c2x);
+                push(cmd.c2y);
+                push(cmd.x);
+                push(cmd.y);
+                break;
+            case "rect":
+                push(OP_RECT);
+                push(cmd.x);
+                push(cmd.y);
+                push(cmd.w);
+                push(cmd.h);
+                break;
+            case "ellipse":
+                push(OP_ELLIPSE);
+                push(cmd.cx);
+                push(cmd.cy);
+                push(cmd.rx);
+                push(cmd.ry);
+                break;
+            case "fill":
+                push(OP_FILL);
+                push(cmd.rule === undefined ? ABSENT : FILL_RULE_CODE[cmd.rule]);
+                break;
+            case "stroke":
+                push(OP_STROKE);
+                break;
+            case "fillText":
+                push(OP_FILL_TEXT);
+                push(intern(cmd.text));
+                push(cmd.x);
+                push(cmd.y);
+                if (cmd.maxWidth === undefined) {
+                    push(ABSENT);
+                }
+                else {
+                    push(PRESENT);
+                    push(cmd.maxWidth);
+                }
+                break;
+            case "clear":
+                push(OP_CLEAR);
+                if (cmd.bounds === undefined) {
+                    push(ABSENT);
+                }
+                else {
+                    push(PRESENT);
+                    push(cmd.bounds.x);
+                    push(cmd.bounds.y);
+                    push(cmd.bounds.width);
+                    push(cmd.bounds.height);
+                }
+                break;
+            case "markDirty":
+                push(OP_MARK_DIRTY);
+                push(cmd.bounds.x);
+                push(cmd.bounds.y);
+                push(cmd.bounds.width);
+                push(cmd.bounds.height);
+                break;
+            case "resize":
+                push(OP_RESIZE);
+                push(cmd.w);
+                push(cmd.h);
+                break;
+            case "defineImage":
+                // Not packed: the bitmap travels beside the numeric stream. The
+                // worker registers all side bitmaps before replaying, so the
+                // stream's `drawImage` id references always resolve.
+                bitmaps.push({ id: cmd.id, bitmap: cmd.bitmap });
+                break;
+            case "drawImage":
+                push(OP_DRAW_IMAGE);
+                push(cmd.id);
+                push(cmd.dx);
+                push(cmd.dy);
+                push(cmd.dw);
+                push(cmd.dh);
+                break;
+        }
+    }
+    // Exact-size copy so the transferred buffer carries no slack capacity.
+    return { buffer: words.slice(0, used).buffer, strings, bitmaps };
+};
+/**
+ * Decode a packed frame and dispatch each command straight onto `target`
+ * in one pass — no intermediate {@link RenderCommand} objects.
+ *
+ * `images` is the worker's persistent id → bitmap LRU (mirrors the
+ * recorder's same-capacity intern LRU): the caller must have registered
+ * the frame's side bitmaps into it BEFORE calling. Semantics match
+ * {@link replayCommands}: `resize` is a no-op (the worker owns the canvas
+ * size via its own `resize` message) and a `drawImage` whose id misses the
+ * cache is skipped rather than thrown.
+ */
+export const replayPackedFrame = (target, buffer, strings, images = new LruCache(OFFSCREEN_IMAGE_CACHE_CAP)) => {
+    const words = new Float64Array(buffer);
+    let i = 0;
+    const next = () => {
+        const v = words[i++];
+        if (v === undefined)
+            throw new Error("replayPackedFrame: truncated stream");
+        return v;
+    };
+    const str = (idx) => {
+        const s = strings[idx];
+        if (s === undefined)
+            throw new Error(`replayPackedFrame: bad string index ${String(idx)}`);
+        return s;
+    };
+    const at = (table, code) => {
+        const v = table[code];
+        if (v === undefined)
+            throw new Error(`replayPackedFrame: bad enum code ${String(code)}`);
+        return v;
+    };
+    while (i < words.length) {
+        const op = next();
+        switch (op) {
+            case OP_SET_FILL: {
+                const idx = next();
+                target.setFill(idx === NULL_STRING_INDEX ? null : str(idx));
+                break;
+            }
+            case OP_SET_STROKE: {
+                const idx = next();
+                target.setStroke(idx === NULL_STRING_INDEX ? null : str(idx));
+                break;
+            }
+            case OP_SET_STROKE_WIDTH:
+                target.setStrokeWidth(next());
+                break;
+            case OP_SET_OPACITY:
+                target.setOpacity(next());
+                break;
+            case OP_SET_LINE_CAP:
+                target.setLineCap(at(LINE_CAPS, next()));
+                break;
+            case OP_SET_LINE_JOIN:
+                target.setLineJoin(at(LINE_JOINS, next()));
+                break;
+            case OP_SET_DASH_ARRAY: {
+                const n = next();
+                if (n === NULL_DASH_LENGTH) {
+                    target.setDashArray(null);
+                }
+                else {
+                    const dash = [];
+                    for (let d = 0; d < n; d++)
+                        dash.push(next());
+                    target.setDashArray(dash);
+                }
+                break;
+            }
+            case OP_SET_FONT: {
+                const family = str(next());
+                const size = next();
+                if (next() === ABSENT) {
+                    target.setFont(family, size);
+                    break;
+                }
+                const weight = next();
+                const style = next();
+                const options = {};
+                if (weight === FONT_WEIGHT_CODE.normal)
+                    options.weight = "normal";
+                else if (weight === FONT_WEIGHT_CODE.bold)
+                    options.weight = "bold";
+                if (style === FONT_STYLE_CODE.normal)
+                    options.style = "normal";
+                else if (style === FONT_STYLE_CODE.italic)
+                    options.style = "italic";
+                target.setFont(family, size, options);
+                break;
+            }
+            case OP_SET_TEXT_ALIGN:
+                target.setTextAlign(at(TEXT_ALIGNS, next()));
+                break;
+            case OP_SET_TEXT_BASELINE:
+                target.setTextBaseline(at(TEXT_BASELINES, next()));
+                break;
+            case OP_SAVE:
+                target.save();
+                break;
+            case OP_RESTORE:
+                target.restore();
+                break;
+            case OP_TRANSLATE:
+                target.translate(next(), next());
+                break;
+            case OP_ROTATE:
+                target.rotate(next());
+                break;
+            case OP_SCALE:
+                target.scale(next(), next());
+                break;
+            case OP_SET_TRANSFORM:
+                target.setTransform({
+                    a: next(),
+                    b: next(),
+                    c: next(),
+                    d: next(),
+                    e: next(),
+                    f: next(),
+                });
+                break;
+            case OP_RESET_TRANSFORM:
+                target.resetTransform();
+                break;
+            case OP_BEGIN_PATH:
+                target.beginPath();
+                break;
+            case OP_CLOSE_PATH:
+                target.closePath();
+                break;
+            case OP_MOVE_TO:
+                target.moveTo(next(), next());
+                break;
+            case OP_LINE_TO:
+                target.lineTo(next(), next());
+                break;
+            case OP_QUADRATIC_CURVE_TO:
+                target.quadraticCurveTo(next(), next(), next(), next());
+                break;
+            case OP_BEZIER_CURVE_TO:
+                target.bezierCurveTo(next(), next(), next(), next(), next(), next());
+                break;
+            case OP_RECT:
+                target.rect(next(), next(), next(), next());
+                break;
+            case OP_ELLIPSE:
+                target.ellipse(next(), next(), next(), next());
+                break;
+            case OP_FILL: {
+                const code = next();
+                if (code === FILL_RULE_CODE.nonzero)
+                    target.fill("nonzero");
+                else if (code === FILL_RULE_CODE.evenodd)
+                    target.fill("evenodd");
+                else
+                    target.fill();
+                break;
+            }
+            case OP_STROKE:
+                target.stroke();
+                break;
+            case OP_FILL_TEXT: {
+                const text = str(next());
+                const x = next();
+                const y = next();
+                if (next() === PRESENT)
+                    target.fillText(text, x, y, next());
+                else
+                    target.fillText(text, x, y);
+                break;
+            }
+            case OP_CLEAR:
+                if (next() === PRESENT) {
+                    const bounds = { x: next(), y: next(), width: next(), height: next() };
+                    target.clear(bounds);
+                }
+                else {
+                    target.clear();
+                }
+                break;
+            case OP_MARK_DIRTY:
+                target.markDirty?.({ x: next(), y: next(), width: next(), height: next() });
+                break;
+            case OP_RESIZE:
+                // No-op for replay — the worker owns the canvas size and resizes
+                // via its own `resize` message, not via the command stream. Still
+                // consume the args to stay in sync with the stream.
+                next();
+                next();
+                break;
+            case OP_DRAW_IMAGE: {
+                // `get` bumps recency so the worker LRU evicts in lockstep with
+                // the recorder's. A miss means an out-of-sync stream — skip
+                // rather than throw (matches the non-drawable skip on record).
+                const id = next();
+                const dx = next();
+                const dy = next();
+                const dw = next();
+                const dh = next();
+                const bitmap = images.get(id);
+                if (bitmap)
+                    target.drawImage(bitmap, dx, dy, dw, dh);
+                break;
+            }
+            default:
+                throw new Error(`replayPackedFrame: unknown opcode ${String(op)}`);
+        }
+    }
+};
+//# sourceMappingURL=replay-codec.js.map