@glissade/backend-skia 0.74.0 → 0.75.0

package/dist/index.d.ts

@@ -75,10 +75,33 @@ declare function createMeasurer(opts?: {
 declare class SkiaBackend implements RenderBackend {
   private readonly canvas;
   private readonly raster;
+  /**
+   * OUTPUT raster scale for the `gs render --preview-res` two-tier draft (0.75).
+   * `undefined` = the DEFAULT full-res path: `render()` takes the EXACT current
+   * code path (no identity multiply, byte-for-byte the pre-0.75 goldens). When
+   * set, `render()` rasterizes the already-composited DisplayList into the SMALLER
+   * `width×height` canvas under an EFFECTIVE scale `sx=width/srcWidth`,
+   * `sy=height/srcHeight` — so the scaled canvas is exactly FILLED (no edge gap
+   * from the canonical `round()` dim). This is the OUTPUT-raster layer, ORTHOGONAL
+   * to and applied ON TOP OF any scene `.scale` transform already baked into the
+   * DisplayList (scene transform first, then output raster scale).
+   */
+  private readonly outputScale;
   /** Headless CPU Skia: all document filters, no GPU shader pass (§3.4/§3.7). */
   readonly caps: BackendCaps;
   constructor(width: number, height: number, opts?: {
     layerStore?: LayerStore;
+    /**
+     * §0.75 `gs render --preview-res`: render the composited DisplayList into
+     * this (already-scaled) `width×height` canvas at the EFFECTIVE output scale
+     * `width/srcWidth × height/srcHeight` — the canonical `srcWidth/srcHeight`
+     * are the scene's UNSCALED dims. Opt-in: omit it for the byte-identical
+     * full-res path. Only pass it for a real f<1 preview draft.
+     */
+    outputScale?: {
+      srcWidth: number;
+      srcHeight: number;
+    };
   });
   /** Attach the §3.5 disk layer-cache store (the CLI wires this once caps are known). */
   setLayerStore(store: LayerStore | undefined): void;

package/dist/index.js

@@ -139,6 +139,18 @@ function createMeasurer(opts = {}) {
 var SkiaBackend = class {
 	canvas;
 	raster;
+	/**
+	* OUTPUT raster scale for the `gs render --preview-res` two-tier draft (0.75).
+	* `undefined` = the DEFAULT full-res path: `render()` takes the EXACT current
+	* code path (no identity multiply, byte-for-byte the pre-0.75 goldens). When
+	* set, `render()` rasterizes the already-composited DisplayList into the SMALLER
+	* `width×height` canvas under an EFFECTIVE scale `sx=width/srcWidth`,
+	* `sy=height/srcHeight` — so the scaled canvas is exactly FILLED (no edge gap
+	* from the canonical `round()` dim). This is the OUTPUT-raster layer, ORTHOGONAL
+	* to and applied ON TOP OF any scene `.scale` transform already baked into the
+	* DisplayList (scene transform first, then output raster scale).
+	*/
+	outputScale;
 	/** Headless CPU Skia: all document filters, no GPU shader pass (§3.4/§3.7). */
 	caps = {
 		filters: ALL_FILTER_KINDS,
@@ -147,6 +159,10 @@ var SkiaBackend = class {
 	};
 	constructor(width, height, opts = {}) {
 		this.canvas = createCanvas(width, height);
+		this.outputScale = opts.outputScale !== void 0 ? {
+			sx: width / opts.outputScale.srcWidth,
+			sy: height / opts.outputScale.srcHeight
+		} : void 0;
 		this.raster = new Raster2D({
 			context: (c) => c.getContext("2d"),
 			createCanvas: (w, h) => createCanvas(w, h),
@@ -179,7 +195,30 @@ var SkiaBackend = class {
 		};
 	}
 	render(list) {
-		this.raster.render(this.canvas, list);
+		if (this.outputScale === void 0) {
+			this.raster.render(this.canvas, list);
+			return;
+		}
+		const { sx, sy } = this.outputScale;
+		const scaled = {
+			...list,
+			size: {
+				w: this.canvas.width,
+				h: this.canvas.height
+			},
+			commands: [{
+				op: "transform",
+				m: [
+					sx,
+					0,
+					0,
+					sy,
+					0,
+					0
+				]
+			}, ...list.commands]
+		};
+		this.raster.render(this.canvas, scaled);
 	}
 	/** Raw RGBA — the FFmpeg pipe path (§5.1d). Resolves synchronously (no GPU readback) but typed Promise to match the RenderBackend contract. */
 	readPixels() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/backend-skia",
-  "version": "0.74.0",
+  "version": "0.75.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.74.0",
-    "@glissade/scene": "0.74.0"
+    "@glissade/core": "0.75.0",
+    "@glissade/scene": "0.75.0"
   },
   "repository": {
     "type": "git",