@glissade/backend-skia 0.11.0 → 0.12.0-pre.0

package/dist/index.d.ts

@@ -27,6 +27,15 @@ declare class SkiaBackend implements RenderBackend {
   render(list: DisplayList): void;
   /** Raw RGBA — the FFmpeg pipe path (§5.1d). Resolves synchronously (no GPU readback) but typed Promise to match the RenderBackend contract. */
   readPixels(): Promise<Uint8ClampedArray>;
+  /**
+   * §3.5 disk-cache HIT path: blit stored straight-RGBA into the canvas so the
+   * IDENTICAL `encodePng()` / `readPixels()` downstream runs over it. A
+   * `render(dl)→encodePng()` and a `putPixels(readPixels(dl))→encodePng()` are
+   * byte-identical (the putImageData round-trip preserves bytes), which is what
+   * makes a frame-cache hit byte-equal to a cold render. The buffer length must
+   * be `width*height*4`.
+   */
+  putPixels(rgba: Uint8ClampedArray): void;
   /** Deterministic PNG bytes for golden frames and `gs render` output. */
   encodePng(): Buffer;
   dispose(): void;

package/dist/index.js

@@ -66,6 +66,23 @@ var SkiaBackend = class {
 		const ctx = this.canvas.getContext("2d");
 		return Promise.resolve(ctx.getImageData(0, 0, this.canvas.width, this.canvas.height).data);
 	}
+	/**
+	* §3.5 disk-cache HIT path: blit stored straight-RGBA into the canvas so the
+	* IDENTICAL `encodePng()` / `readPixels()` downstream runs over it. A
+	* `render(dl)→encodePng()` and a `putPixels(readPixels(dl))→encodePng()` are
+	* byte-identical (the putImageData round-trip preserves bytes), which is what
+	* makes a frame-cache hit byte-equal to a cold render. The buffer length must
+	* be `width*height*4`.
+	*/
+	putPixels(rgba) {
+		const w = this.canvas.width;
+		const h = this.canvas.height;
+		if (rgba.length !== w * h * 4) throw new Error(`putPixels: expected ${w * h * 4} RGBA bytes for ${w}x${h}, got ${rgba.length}`);
+		const ctx = this.canvas.getContext("2d");
+		const img = ctx.createImageData(w, h);
+		img.data.set(rgba);
+		ctx.putImageData(img, 0, 0);
+	}
 	/** Deterministic PNG bytes for golden frames and `gs render` output. */
 	encodePng() {
 		return this.canvas.toBuffer("image/png");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/backend-skia",
-  "version": "0.11.0",
+  "version": "0.12.0-pre.0",
   "description": "glissade headless render backend: DisplayList -> @napi-rs/canvas (Skia). Node-only; the CI-grade deterministic path.",
   "license": "Apache-2.0",
   "engines": {
@@ -19,8 +19,8 @@
   ],
   "dependencies": {
     "@napi-rs/canvas": "^0.1.65",
-    "@glissade/core": "0.11.0",
-    "@glissade/scene": "0.11.0"
+    "@glissade/core": "0.12.0-pre.0",
+    "@glissade/scene": "0.12.0-pre.0"
   },
   "repository": {
     "type": "git",