@oh-just-another/renderer-canvas 0.58.1 → 0.60.0

package/dist/canvas-target.js

@@ -1,4 +1,5 @@
-import { isDrawableImageSource, warnSkippedImage } from "./image-source.js";
+import { resolveBundledFamily } from "@oh-just-another/fonts";
+import { intrinsicImageSize, isDrawableImageSource, warnSkippedImage } from "./image-source.js";
 /**
  * Wraps a `CanvasRenderingContext2D` (or compatible OffscreenCanvas context)
  * as a backend-agnostic `RenderTarget`. Coordinates passed to the target are
@@ -64,10 +65,12 @@ export class Canvas2DTarget {
         this.ctx.setLineDash(dash ? [...dash] : []);
     }
     setFont(fontFamily, fontSize, options) {
-        // CSS font shorthand order: `<style> <weight> <size> <family>`.
+        // CSS font shorthand order: `<style> <weight> <size> <family>`. Draw with
+        // the bundled face that backs the requested family (matching the WebGL2
+        // MSDF path), falling back to the original stack until it has loaded.
         const style = options?.style === "italic" ? "italic " : "";
         const weight = options?.weight === "bold" ? "bold " : "";
-        this.ctx.font = `${style}${weight}${fontSize}px ${fontFamily}`;
+        this.ctx.font = `${style}${weight}${fontSize}px "${resolveBundledFamily(fontFamily)}", ${fontFamily}`;
     }
     setTextAlign(align) {
         this.ctx.textAlign = align === "center" ? "center" : align;
@@ -147,10 +150,10 @@ export class Canvas2DTarget {
         return { width: m.width };
     }
     // --- Images ---
-    drawImage(image, dx, dy, dw, dh, _dynamic) {
+    drawImage(image, dx, dy, dw, dh, _dynamic, crop) {
         // `_dynamic` ignored — Canvas2D reads the source element live on
         // every drawImage, so animated GIF / video frames are picked up
-        // automatically as long as the host re-renders (AnimationTick).
+        // automatically as long as the host re-renders.
         void _dynamic;
         // Guard against non-drawable handles. A restored scene carries
         // either a string `src` (dead blob: URL) OR a `metadata.image`
@@ -162,6 +165,16 @@ export class Canvas2DTarget {
             warnSkippedImage(image);
             return;
         }
+        // Cropped draw: map the normalised source rect to pixels and use the
+        // 9-argument form. Falls back to the whole image when the intrinsic
+        // size is unknown (crop can't be resolved).
+        if (crop && (crop.x !== 0 || crop.y !== 0 || crop.width !== 1 || crop.height !== 1)) {
+            const size = intrinsicImageSize(image);
+            if (size) {
+                this.ctx.drawImage(image, crop.x * size.width, crop.y * size.height, crop.width * size.width, crop.height * size.height, dx, dy, dw, dh);
+                return;
+            }
+        }
         this.ctx.drawImage(image, dx, dy, dw, dh);
     }
     // --- Surface control ---

package/dist/canvas-target.js.map

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

package/dist/constants.d.ts

@@ -34,6 +34,27 @@ export declare const LARGE_SCENE_WORKER_THRESHOLD = 50000;
  * text renders through an atlas, without an OffscreenCanvas round-trip.
  */
 export declare const WEBGL2_TEXT_BITMAP_CACHE_CAP = 256;
+/**
+ * LRU cap on the offscreen image cache shared by `RecordingTarget`
+ * (main thread, identity → id) and the render worker (id → ImageBitmap).
+ *
+ * The offscreen backend re-renders every frame so animated GIF / video
+ * frames are picked up; without this cache each frame re-posts (clones)
+ * every drawn `ImageBitmap` across the worker boundary. With it, a bitmap
+ * is shipped once under a stable id and later referenced by id alone —
+ * the GIF adapter returns the same cached bitmap for a frame held across
+ * several rAF ticks, so the per-tick redraw costs one tiny command.
+ *
+ * Both sides keep an LRU of identical capacity, so they evict the same
+ * id in lockstep (the command stream drives both in the same order);
+ * the worker also closes the evicted bitmap clone to release memory.
+ *
+ * 64 — a scene rarely has more than 10-20 distinct images in flight at
+ * once; a 3-6x margin covers a short GIF loop's frames without thrashing.
+ * On overflow the coldest image is dropped; its next draw re-ships the
+ * bitmap (one extra clone) and re-inserts.
+ */
+export declare const OFFSCREEN_IMAGE_CACHE_CAP = 64;
 /**
  * LRU cap on `WebGL2Target.textures` — image-source to WebGLTexture
  * cache used by `drawImage`. Each entry holds a GPU texture
@@ -49,4 +70,64 @@ export declare const WEBGL2_TEXT_BITMAP_CACHE_CAP = 256;
  * cost).
  */
 export declare const WEBGL2_IMAGE_TEXTURE_CACHE_CAP = 64;
+/**
+ * Cap applied to `window.devicePixelRatio` when sizing canvas bitmaps
+ * (`setupHiDpi`, `createLayeredSurface`). Mobile / hi-end displays report
+ * DPR 3–4; rendering the full ratio quadruples-to-sixteenfolds the pixel
+ * fill cost per layer for visual gains that are imperceptible in a
+ * diagram editor (thin strokes, flat fills). Capping at 2 keeps bitmap
+ * memory and raster time bounded — text and hairlines render very
+ * slightly softer on DPR-3 devices. Range: 1–4; hosts needing exact
+ * native sharpness can raise it via `CreateLayeredSurfaceOptions.maxDpr`
+ * or by passing an explicit `dpr` to `setupHiDpi`.
+ */
+export declare const MAX_DEVICE_PIXEL_RATIO = 2;
+/**
+ * LRU cap on the Loop-Blinn triangulation cache in `webgl2-curve.ts`.
+ * Keyed by curve control-point content (renderers emit paths in
+ * element-local coordinates, so identical geometry — e.g. every
+ * same-size rounded rect — shares one entry, and pan / zoom / drag
+ * never invalidate it: the transform is applied in the vertex shader).
+ *
+ * Each entry stores the packed positions + uvs plus the key floats —
+ * a rounded rect (4 triangles) is ≈ 500 bytes, so the cap bounds the
+ * cache at a few MB worst-case. On overflow the least-recently-drawn
+ * geometry is evicted and re-triangulated on next draw (cheap, no GPU
+ * resources involved). Range: 512–16384.
+ */
+export declare const WEBGL2_CURVE_TRIANGULATION_CACHE_CAP = 4096;
+/**
+ * Lower bound on the polygon approximation of an ellipse. Keeps small
+ * ellipses from collapsing to a coarse hexagon at far zoom. Range: 12–48.
+ */
+export declare const ELLIPSE_MIN_SEGMENTS = 24;
+/**
+ * Upper bound on the polygon approximation of an ellipse. Caps GPU work
+ * for huge ellipses where extra segments yield invisible pixel-error
+ * improvement. Range: 256–1024.
+ */
+export declare const ELLIPSE_MAX_SEGMENTS = 512;
+/**
+ * Initial per-target capacity, in instances, of the sharp-rect instance
+ * batcher (`webgl2-rect-batch.ts` `RectBatch`). One frame's worth of
+ * same-run rect fills packs into this without a grow; capacity doubles
+ * on demand and never shrinks. 256 covers typical grid / background
+ * scenes at ~10 KB (40 bytes/instance). Range: 64–4096.
+ */
+export declare const INITIAL_RECT_BATCH_INSTANCES = 256;
+/**
+ * LRU cap on the per-atlas MSDF run-width memo (`webgl2-msdf-text.ts`).
+ * The em-width of a text run (Σ advance/unitsPerEm) is immutable once its
+ * glyphs are cached, so it is memoized keyed by `(fontId, text)`: a
+ * repeat `measureText`, or a `measureText` after the same string was
+ * drawn, returns in O(1) instead of re-walking the codepoints. Caret
+ * positioning and selection geometry call `measureText` on the same
+ * label many times per frame, so the hit rate is high.
+ *
+ * Each entry is a single number keyed by the run string — cheap. 1024
+ * covers a large editing session's distinct labels with margin; on
+ * overflow the least-recently-measured run is evicted and re-walked on
+ * next measure (cheap, no GPU resources). Range: 256–8192.
+ */
+export declare const WEBGL2_MSDF_RUN_WIDTH_CACHE_CAP = 1024;
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,8BAA8B,KAAK,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oCAAoC,OAAO,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,+BAA+B,OAAO,CAAC"}

package/dist/constants.js

@@ -34,6 +34,27 @@ export const LARGE_SCENE_WORKER_THRESHOLD = 50_000;
  * text renders through an atlas, without an OffscreenCanvas round-trip.
  */
 export const WEBGL2_TEXT_BITMAP_CACHE_CAP = 256;
+/**
+ * LRU cap on the offscreen image cache shared by `RecordingTarget`
+ * (main thread, identity → id) and the render worker (id → ImageBitmap).
+ *
+ * The offscreen backend re-renders every frame so animated GIF / video
+ * frames are picked up; without this cache each frame re-posts (clones)
+ * every drawn `ImageBitmap` across the worker boundary. With it, a bitmap
+ * is shipped once under a stable id and later referenced by id alone —
+ * the GIF adapter returns the same cached bitmap for a frame held across
+ * several rAF ticks, so the per-tick redraw costs one tiny command.
+ *
+ * Both sides keep an LRU of identical capacity, so they evict the same
+ * id in lockstep (the command stream drives both in the same order);
+ * the worker also closes the evicted bitmap clone to release memory.
+ *
+ * 64 — a scene rarely has more than 10-20 distinct images in flight at
+ * once; a 3-6x margin covers a short GIF loop's frames without thrashing.
+ * On overflow the coldest image is dropped; its next draw re-ships the
+ * bitmap (one extra clone) and re-inserts.
+ */
+export const OFFSCREEN_IMAGE_CACHE_CAP = 64;
 /**
  * LRU cap on `WebGL2Target.textures` — image-source to WebGLTexture
  * cache used by `drawImage`. Each entry holds a GPU texture
@@ -49,4 +70,64 @@ export const WEBGL2_TEXT_BITMAP_CACHE_CAP = 256;
  * cost).
  */
 export const WEBGL2_IMAGE_TEXTURE_CACHE_CAP = 64;
+/**
+ * Cap applied to `window.devicePixelRatio` when sizing canvas bitmaps
+ * (`setupHiDpi`, `createLayeredSurface`). Mobile / hi-end displays report
+ * DPR 3–4; rendering the full ratio quadruples-to-sixteenfolds the pixel
+ * fill cost per layer for visual gains that are imperceptible in a
+ * diagram editor (thin strokes, flat fills). Capping at 2 keeps bitmap
+ * memory and raster time bounded — text and hairlines render very
+ * slightly softer on DPR-3 devices. Range: 1–4; hosts needing exact
+ * native sharpness can raise it via `CreateLayeredSurfaceOptions.maxDpr`
+ * or by passing an explicit `dpr` to `setupHiDpi`.
+ */
+export const MAX_DEVICE_PIXEL_RATIO = 2;
+/**
+ * LRU cap on the Loop-Blinn triangulation cache in `webgl2-curve.ts`.
+ * Keyed by curve control-point content (renderers emit paths in
+ * element-local coordinates, so identical geometry — e.g. every
+ * same-size rounded rect — shares one entry, and pan / zoom / drag
+ * never invalidate it: the transform is applied in the vertex shader).
+ *
+ * Each entry stores the packed positions + uvs plus the key floats —
+ * a rounded rect (4 triangles) is ≈ 500 bytes, so the cap bounds the
+ * cache at a few MB worst-case. On overflow the least-recently-drawn
+ * geometry is evicted and re-triangulated on next draw (cheap, no GPU
+ * resources involved). Range: 512–16384.
+ */
+export const WEBGL2_CURVE_TRIANGULATION_CACHE_CAP = 4096;
+/**
+ * Lower bound on the polygon approximation of an ellipse. Keeps small
+ * ellipses from collapsing to a coarse hexagon at far zoom. Range: 12–48.
+ */
+export const ELLIPSE_MIN_SEGMENTS = 24;
+/**
+ * Upper bound on the polygon approximation of an ellipse. Caps GPU work
+ * for huge ellipses where extra segments yield invisible pixel-error
+ * improvement. Range: 256–1024.
+ */
+export const ELLIPSE_MAX_SEGMENTS = 512;
+/**
+ * Initial per-target capacity, in instances, of the sharp-rect instance
+ * batcher (`webgl2-rect-batch.ts` `RectBatch`). One frame's worth of
+ * same-run rect fills packs into this without a grow; capacity doubles
+ * on demand and never shrinks. 256 covers typical grid / background
+ * scenes at ~10 KB (40 bytes/instance). Range: 64–4096.
+ */
+export const INITIAL_RECT_BATCH_INSTANCES = 256;
+/**
+ * LRU cap on the per-atlas MSDF run-width memo (`webgl2-msdf-text.ts`).
+ * The em-width of a text run (Σ advance/unitsPerEm) is immutable once its
+ * glyphs are cached, so it is memoized keyed by `(fontId, text)`: a
+ * repeat `measureText`, or a `measureText` after the same string was
+ * drawn, returns in O(1) instead of re-walking the codepoints. Caret
+ * positioning and selection geometry call `measureText` on the same
+ * label many times per frame, so the hit rate is high.
+ *
+ * Each entry is a single number keyed by the run string — cheap. 1024
+ * covers a large editing session's distinct labels with margin; on
+ * overflow the least-recently-measured run is evicted and re-walked on
+ * next measure (cheap, no GPU resources). Range: 256–8192.
+ */
+export const WEBGL2_MSDF_RUN_WIDTH_CACHE_CAP = 1024;
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAExC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,IAAI,CAAC;AAEzD;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,CAAC"}

package/dist/hi-dpi.d.ts

@@ -1,8 +1,9 @@
 /**
  * Configures a `<canvas>` for hi-DPI rendering. Sets the bitmap size to
- * `width * dpr` × `height * dpr`, the CSS size to `width` × `height`, and the
- * context transform to `scale(dpr, dpr)` so subsequent draw calls operate in
- * CSS pixels. Returns the DPR used so callers can recompute on monitor changes.
+ * `width * dpr` × `height * dpr`, the CSS size to `width` × `height`, and
+ * (when `setupContext` is true) the 2D context transform to `scale(dpr, dpr)`
+ * so subsequent draw calls operate in CSS pixels. Returns the DPR used so
+ * callers can recompute on monitor changes.
  *
  * IDEMPOTENT: assigning `canvas.width` / `canvas.height` resets both
  * the bitmap AND the context transform — even when the new value equals
@@ -10,17 +11,24 @@
  * the same size on attach; without the guard each tick would wipe the
  * existing canvas content. We early-return when bitmap + CSS size +
  * DPR are already exactly right.
+ *
+ * `setupContext` (default `true`): when `false`, skips the `getContext("2d")`
+ * + `setTransform` step for canvases destined for a non-2D context (WebGL2,
+ * WebGPU). `HTMLCanvasElement` only ever yields one *kind* of context, so
+ * touching `2d` on a canvas headed for `webgl2` poisons the slot and every
+ * subsequent `getContext("webgl2")` returns null. Use `false` for the WebGL2
+ * main canvas in `WebGL2LayeredSurface`; its viewport is set inside
+ * `WebGL2Target` after the GL context is obtained.
+ *
+ * The default `dpr` is `window.devicePixelRatio` capped at
+ * `MAX_DEVICE_PIXEL_RATIO` (see constants.ts). An explicit `dpr` argument
+ * is honoured as-is — pass the raw ratio to opt out of the cap.
  */
-export declare const setupHiDpi: (canvas: HTMLCanvasElement, width: number, height: number, dpr?: number) => number;
+export declare const setupHiDpi: (canvas: HTMLCanvasElement, width: number, height: number, dpr?: number, setupContext?: boolean) => number;
 /**
- * Hi-DPI sizing for canvases that will host a non-2D context (WebGL2,
- * WebGPU). Same bitmap + CSS dimensions as `setupHiDpi`, but skips
- * the `getContext("2d")` call — `HTMLCanvasElement` only ever yields
- * one *kind* of context, so touching `2d` on a canvas destined for
- * `webgl2` poisons the slot and every subsequent `getContext("webgl2")`
- * returns null. Use this for the WebGL2 main canvas in
- * `WebGL2LayeredSurface`; the WebGL2 viewport is set inside
- * `WebGL2Target` after the GL context is obtained.
+ * The live `window.devicePixelRatio` clamped to `maxDpr` (SSR-safe:
+ * resolves to 1 when there is no `window`). Callers that re-read the DPR
+ * on resize (monitor changes) go through this instead of the raw ratio.
  */
-export declare const setupHiDpiNoContext: (canvas: HTMLCanvasElement, width: number, height: number, dpr?: number) => number;
+export declare const cappedDpr: (maxDpr?: number) => number;
 //# sourceMappingURL=hi-dpi.d.ts.map

package/dist/hi-dpi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hi-dpi.d.ts","sourceRoot":"","sources":["../src/hi-dpi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,GACrB,QAAQ,iBAAiB,EACzB,OAAO,MAAM,EACb,QAAQ,MAAM,EACd,MAAK,MAAqC,KACzC,MAqBF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,iBAAiB,EACzB,OAAO,MAAM,EACb,QAAQ,MAAM,EACd,MAAK,MAAqC,KACzC,MAkBF,CAAC"}
+{"version":3,"file":"hi-dpi.d.ts","sourceRoot":"","sources":["../src/hi-dpi.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,UAAU,GACrB,QAAQ,iBAAiB,EACzB,OAAO,MAAM,EACb,QAAQ,MAAM,EACd,MAAK,MAAoB,EACzB,sBAAmB,KAClB,MAuBF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,SAAQ,MAA+B,KAAG,MACgB,CAAC"}

package/dist/hi-dpi.js

@@ -1,8 +1,10 @@
+import { MAX_DEVICE_PIXEL_RATIO } from "./constants.js";
 /**
  * Configures a `<canvas>` for hi-DPI rendering. Sets the bitmap size to
- * `width * dpr` × `height * dpr`, the CSS size to `width` × `height`, and the
- * context transform to `scale(dpr, dpr)` so subsequent draw calls operate in
- * CSS pixels. Returns the DPR used so callers can recompute on monitor changes.
+ * `width * dpr` × `height * dpr`, the CSS size to `width` × `height`, and
+ * (when `setupContext` is true) the 2D context transform to `scale(dpr, dpr)`
+ * so subsequent draw calls operate in CSS pixels. Returns the DPR used so
+ * callers can recompute on monitor changes.
  *
  * IDEMPOTENT: assigning `canvas.width` / `canvas.height` resets both
  * the bitmap AND the context transform — even when the new value equals
@@ -10,8 +12,20 @@
  * the same size on attach; without the guard each tick would wipe the
  * existing canvas content. We early-return when bitmap + CSS size +
  * DPR are already exactly right.
+ *
+ * `setupContext` (default `true`): when `false`, skips the `getContext("2d")`
+ * + `setTransform` step for canvases destined for a non-2D context (WebGL2,
+ * WebGPU). `HTMLCanvasElement` only ever yields one *kind* of context, so
+ * touching `2d` on a canvas headed for `webgl2` poisons the slot and every
+ * subsequent `getContext("webgl2")` returns null. Use `false` for the WebGL2
+ * main canvas in `WebGL2LayeredSurface`; its viewport is set inside
+ * `WebGL2Target` after the GL context is obtained.
+ *
+ * The default `dpr` is `window.devicePixelRatio` capped at
+ * `MAX_DEVICE_PIXEL_RATIO` (see constants.ts). An explicit `dpr` argument
+ * is honoured as-is — pass the raw ratio to opt out of the cap.
  */
-export const setupHiDpi = (canvas, width, height, dpr = window.devicePixelRatio || 1) => {
+export const setupHiDpi = (canvas, width, height, dpr = cappedDpr(), setupContext = true) => {
     const targetW = Math.round(width * dpr);
     const targetH = Math.round(height * dpr);
     const cssW = `${width}px`;
@@ -26,37 +40,18 @@ export const setupHiDpi = (canvas, width, height, dpr = window.devicePixelRatio
     canvas.height = targetH;
     canvas.style.width = cssW;
     canvas.style.height = cssH;
-    const ctx = canvas.getContext("2d");
-    if (!ctx)
-        throw new Error("Failed to obtain 2D context");
-    ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
+    if (setupContext) {
+        const ctx = canvas.getContext("2d");
+        if (!ctx)
+            throw new Error("Failed to obtain 2D context");
+        ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
+    }
     return dpr;
 };
 /**
- * Hi-DPI sizing for canvases that will host a non-2D context (WebGL2,
- * WebGPU). Same bitmap + CSS dimensions as `setupHiDpi`, but skips
- * the `getContext("2d")` call — `HTMLCanvasElement` only ever yields
- * one *kind* of context, so touching `2d` on a canvas destined for
- * `webgl2` poisons the slot and every subsequent `getContext("webgl2")`
- * returns null. Use this for the WebGL2 main canvas in
- * `WebGL2LayeredSurface`; the WebGL2 viewport is set inside
- * `WebGL2Target` after the GL context is obtained.
+ * The live `window.devicePixelRatio` clamped to `maxDpr` (SSR-safe:
+ * resolves to 1 when there is no `window`). Callers that re-read the DPR
+ * on resize (monitor changes) go through this instead of the raw ratio.
  */
-export const setupHiDpiNoContext = (canvas, width, height, dpr = window.devicePixelRatio || 1) => {
-    const targetW = Math.round(width * dpr);
-    const targetH = Math.round(height * dpr);
-    const cssW = `${width}px`;
-    const cssH = `${height}px`;
-    if (canvas.width === targetW &&
-        canvas.height === targetH &&
-        canvas.style.width === cssW &&
-        canvas.style.height === cssH) {
-        return dpr;
-    }
-    canvas.width = targetW;
-    canvas.height = targetH;
-    canvas.style.width = cssW;
-    canvas.style.height = cssH;
-    return dpr;
-};
+export const cappedDpr = (maxDpr = MAX_DEVICE_PIXEL_RATIO) => Math.min(typeof window !== "undefined" ? window.devicePixelRatio || 1 : 1, maxDpr);
 //# sourceMappingURL=hi-dpi.js.map

package/dist/hi-dpi.js.map

@@ -1 +1 @@
-{"version":3,"file":"hi-dpi.js","sourceRoot":"","sources":["../src/hi-dpi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,MAAyB,EACzB,KAAa,EACb,MAAc,EACd,MAAc,MAAM,CAAC,gBAAgB,IAAI,CAAC,EAClC,EAAE;IACV,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,GAAG,KAAK,IAAI,CAAC;IAC1B,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,CAAC;IAC3B,IACE,MAAM,CAAC,KAAK,KAAK,OAAO;QACxB,MAAM,CAAC,MAAM,KAAK,OAAO;QACzB,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI;QAC3B,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,EAC5B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC;IACvB,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;IACxB,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACzD,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACvC,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,MAAyB,EACzB,KAAa,EACb,MAAc,EACd,MAAc,MAAM,CAAC,gBAAgB,IAAI,CAAC,EAClC,EAAE;IACV,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,GAAG,KAAK,IAAI,CAAC;IAC1B,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,CAAC;IAC3B,IACE,MAAM,CAAC,KAAK,KAAK,OAAO;QACxB,MAAM,CAAC,MAAM,KAAK,OAAO;QACzB,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI;QAC3B,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,EAC5B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC;IACvB,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;IACxB,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,GAAG,CAAC;AACb,CAAC,CAAC"}
+{"version":3,"file":"hi-dpi.js","sourceRoot":"","sources":["../src/hi-dpi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,MAAyB,EACzB,KAAa,EACb,MAAc,EACd,MAAc,SAAS,EAAE,EACzB,YAAY,GAAG,IAAI,EACX,EAAE;IACV,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,GAAG,KAAK,IAAI,CAAC;IAC1B,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,CAAC;IAC3B,IACE,MAAM,CAAC,KAAK,KAAK,OAAO;QACxB,MAAM,CAAC,MAAM,KAAK,OAAO;QACzB,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI;QAC3B,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,EAC5B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC;IACvB,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;IACxB,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACzD,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAiB,sBAAsB,EAAU,EAAE,CAC3E,IAAI,CAAC,GAAG,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC"}

package/dist/image-source.d.ts

@@ -1,3 +1,14 @@
 export declare const isDrawableImageSource: (value: unknown) => value is CanvasImageSource;
+/**
+ * Intrinsic pixel size of a drawable image source, or `null` when it can't be
+ * determined. Handles the differing width/height accessors of the DOM image
+ * types (`naturalWidth` for `<img>`, `videoWidth` for `<video>`, plain
+ * `width`/`height` for bitmaps / canvases). Needed to turn a normalised crop
+ * (fractions) into a pixel source rectangle for `ctx.drawImage`.
+ */
+export declare const intrinsicImageSize: (source: CanvasImageSource) => {
+    readonly width: number;
+    readonly height: number;
+} | null;
 export declare const warnSkippedImage: (value: unknown) => void;
 //# sourceMappingURL=image-source.d.ts.map

package/dist/image-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-source.d.ts","sourceRoot":"","sources":["../src/image-source.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,iBAa/D,CAAC;AAUF,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,IAoBjD,CAAC"}
+{"version":3,"file":"image-source.d.ts","sourceRoot":"","sources":["../src/image-source.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,iBAa/D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,iBAAiB,KACxB;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAmBxD,CAAC;AAUF,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,IAoBjD,CAAC"}

package/dist/image-source.js

@@ -37,6 +37,26 @@ export const isDrawableImageSource = (value) => {
     }
     return false;
 };
+/**
+ * Intrinsic pixel size of a drawable image source, or `null` when it can't be
+ * determined. Handles the differing width/height accessors of the DOM image
+ * types (`naturalWidth` for `<img>`, `videoWidth` for `<video>`, plain
+ * `width`/`height` for bitmaps / canvases). Needed to turn a normalised crop
+ * (fractions) into a pixel source rectangle for `ctx.drawImage`.
+ */
+export const intrinsicImageSize = (source) => {
+    const s = source;
+    if (typeof s.naturalWidth === "number" && s.naturalWidth > 0) {
+        return { width: s.naturalWidth, height: s.naturalHeight ?? s.naturalWidth };
+    }
+    if (typeof s.videoWidth === "number" && s.videoWidth > 0) {
+        return { width: s.videoWidth, height: s.videoHeight ?? s.videoWidth };
+    }
+    if (typeof s.width === "number" && s.width > 0 && typeof s.height === "number") {
+        return { width: s.width, height: s.height };
+    }
+    return null;
+};
 /**
  * Warn (once per distinct kind) when an image draw is skipped because
  * the handle isn't drawable. Throttled by a module-level `Set` so a

package/dist/image-source.js.map

@@ -1 +1 @@
-{"version":3,"file":"image-source.js","sourceRoot":"","sources":["../src/image-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,mBAAmB,GAAG;IAC1B,kBAAkB;IAClB,mBAAmB;IACnB,kBAAkB;IAClB,aAAa;IACb,iBAAiB;IACjB,iBAAiB;IACjB,YAAY;CACJ,CAAC;AAEX,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAc,EAA8B,EAAE;IAClF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,UAAqC,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;QACrB,IACE,OAAO,IAAI,KAAK,UAAU;YAC1B,KAAK,YAAa,IAA0C,EAC5D,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE3C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAQ,EAAE;IACvD,IAAI,OAAO,OAAO,KAAK,WAAW;QAAE,OAAO;IAC3C,MAAM,IAAI,GACR,OAAO,KAAK,KAAK,QAAQ;QACvB,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;YACzB,CAAC,CAAC,eAAe;YACjB,CAAC,CAAC,YAAY;QAChB,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YACrC,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,cAAc,CAAC,CAAC,oCAAoC;IAC5D,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO;IACvC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAE3B,OAAO,CAAC,IAAI,CACV,yDAAyD,IAAI,KAAK;QAChE,oEAAoE;QACpE,oEAAoE;QACpE,qEAAqE;QACrE,2CAA2C,CAC9C,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"image-source.js","sourceRoot":"","sources":["../src/image-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,mBAAmB,GAAG;IAC1B,kBAAkB;IAClB,mBAAmB;IACnB,kBAAkB;IAClB,aAAa;IACb,iBAAiB;IACjB,iBAAiB;IACjB,YAAY;CACJ,CAAC;AAEX,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAc,EAA8B,EAAE;IAClF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,UAAqC,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;QACrB,IACE,OAAO,IAAI,KAAK,UAAU;YAC1B,KAAK,YAAa,IAA0C,EAC5D,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,MAAyB,EACmC,EAAE;IAC9D,MAAM,CAAC,GAAG,MAOT,CAAC;IACF,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QAC7D,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;IAC9E,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QACzD,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/E,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE3C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAQ,EAAE;IACvD,IAAI,OAAO,OAAO,KAAK,WAAW;QAAE,OAAO;IAC3C,MAAM,IAAI,GACR,OAAO,KAAK,KAAK,QAAQ;QACvB,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;YACzB,CAAC,CAAC,eAAe;YACjB,CAAC,CAAC,YAAY;QAChB,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YACrC,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,cAAc,CAAC,CAAC,oCAAoC;IAC5D,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO;IACvC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAE3B,OAAO,CAAC,IAAI,CACV,yDAAyD,IAAI,KAAK;QAChE,oEAAoE;QACpE,oEAAoE;QACpE,qEAAqE;QACrE,2CAA2C,CAC9C,CAAC;AACJ,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export { Canvas2DTarget } from "./canvas-target.js";
 export { Canvas2DTextShaper } from "./canvas-text-shaper.js";
-export { WebGL2Target } from "./webgl2-target.js";
+export { WebGL2Target, type WebGL2TargetOptions } from "./webgl2-target.js";
 export { renderViaTiles, type RenderViaTilesOptions } from "./tile-compositor.js";
-export { setupHiDpi } from "./hi-dpi.js";
+export { setupHiDpi, cappedDpr } from "./hi-dpi.js";
 export { LayeredCanvas, type LayeredCanvasOptions } from "./layered-canvas.js";
 export { supportsOffscreenCanvas, createOffscreenCanvas2DTarget, transferCanvasToWorker, } from "./offscreen.js";
 export { createRenderWorker } from "./worker-factory.js";
@@ -10,7 +10,7 @@ export { WorkerPool, LayerWorkerPool } from "@oh-just-another/renderer-workers";
 export { RecordingTarget, replayCommands, type RenderCommand } from "./recording-target.js";
 export { createLayeredSurface, createLayeredSurfaceWithFallback, type LayeredSurface, type RendererBackend, type CreateLayeredSurfaceOptions, } from "./layered-surface.js";
 export { isWebGPUAvailable, isWebGL2Available, pickAvailableBackend } from "./webgpu-detect.js";
-export { LARGE_SCENE_WORKER_THRESHOLD } from "./constants.js";
+export { LARGE_SCENE_WORKER_THRESHOLD, MAX_DEVICE_PIXEL_RATIO } from "./constants.js";
 export { installBuiltinRenderers, wrapText } from "@oh-just-another/renderer-core";
 export type { WrapOptions, WrappedLine } from "@oh-just-another/renderer-core";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAIzD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EACL,oBAAoB,EACpB,gCAAgC,EAChC,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,2BAA2B,GACjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAK9D,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AACnF,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EACL,oBAAoB,EACpB,gCAAgC,EAChC,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,2BAA2B,GACjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEtF,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AACnF,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -2,24 +2,18 @@ export { Canvas2DTarget } from "./canvas-target.js";
 export { Canvas2DTextShaper } from "./canvas-text-shaper.js";
 export { WebGL2Target } from "./webgl2-target.js";
 export { renderViaTiles } from "./tile-compositor.js";
-export { setupHiDpi } from "./hi-dpi.js";
+export { setupHiDpi, cappedDpr } from "./hi-dpi.js";
 export { LayeredCanvas } from "./layered-canvas.js";
 export { supportsOffscreenCanvas, createOffscreenCanvas2DTarget, transferCanvasToWorker, } from "./offscreen.js";
 export { createRenderWorker } from "./worker-factory.js";
-// WorkerPool / LayerWorkerPool live in @oh-just-another/renderer-workers
-// (backend-neutral primitives don't belong in the Canvas-specific package).
-// Re-export to keep existing imports working.
 export { WorkerPool, LayerWorkerPool } from "@oh-just-another/renderer-workers";
 export { RecordingTarget, replayCommands } from "./recording-target.js";
 export { createLayeredSurface, createLayeredSurfaceWithFallback, } from "./layered-surface.js";
 export { isWebGPUAvailable, isWebGL2Available, pickAvailableBackend } from "./webgpu-detect.js";
-export { LARGE_SCENE_WORKER_THRESHOLD } from "./constants.js";
-// `installBuiltinRenderers` and `wrapText` live in
-// `@oh-just-another/renderer-core` so the SVG / headless backends can share them.
-// These re-exports keep existing imports working.
+export { LARGE_SCENE_WORKER_THRESHOLD, MAX_DEVICE_PIXEL_RATIO } from "./constants.js";
 export { installBuiltinRenderers, wrapText } from "@oh-just-another/renderer-core";
-// `installBuiltinRenderers()` must be called once before `renderScene`
-// from `@oh-just-another/renderer-core` knows how to draw built-in shapes. It is
-// not auto-invoked so that this package stays `sideEffects: false` and tree-
-// shakeable. Hosts typically call it in their entry file.
+// `installBuiltinRenderers()` must be called once before built-in shapes
+// can be drawn. It is not auto-invoked so this package stays
+// `sideEffects: false` and tree-shakeable. Hosts typically call it in
+// their entry file.
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAA8B,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAA6B,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,yEAAyE;AACzE,4EAA4E;AAC5E,8CAA8C;AAC9C,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,cAAc,EAAsB,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EACL,oBAAoB,EACpB,gCAAgC,GAIjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAE9D,mDAAmD;AACnD,kFAAkF;AAClF,kDAAkD;AAClD,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAGnF,uEAAuE;AACvE,iFAAiF;AACjF,6EAA6E;AAC7E,0DAA0D"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAA4B,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAA8B,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,aAAa,EAA6B,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,cAAc,EAAsB,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EACL,oBAAoB,EACpB,gCAAgC,GAIjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEtF,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAGnF,yEAAyE;AACzE,6DAA6D;AAC7D,sEAAsE;AACtE,oBAAoB"}

package/dist/layered-canvas.d.ts

@@ -3,8 +3,13 @@ import { Canvas2DTarget } from "./canvas-target.js";
 export interface LayeredCanvasOptions {
     /** Subset of layers to create. Defaults to all three. */
     readonly layers?: readonly LayerName[];
-    /** Override `window.devicePixelRatio`. */
+    /** Override `window.devicePixelRatio`. Takes precedence over `maxDpr`. */
     readonly dpr?: number;
+    /**
+     * Cap applied to the live `window.devicePixelRatio` on create and every
+     * resize. Defaults to `MAX_DEVICE_PIXEL_RATIO`. Ignored when `dpr` is set.
+     */
+    readonly maxDpr?: number;
 }
 /**
  * Manages one stacked `<canvas>` per layer. The background canvas sits at the
@@ -22,6 +27,7 @@ export declare class LayeredCanvas {
     private width;
     private height;
     private dprOverride;
+    private readonly maxDpr;
     constructor(host: HTMLElement, width: number, height: number, options?: LayeredCanvasOptions);
     /** Get the target for a layer. Throws if the layer was not created. */
     get(name: LayerName): Canvas2DTarget;

package/dist/layered-canvas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layered-canvas.d.ts","sourceRoot":"","sources":["../src/layered-canvas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,0CAA0C;IAC1C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAChE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IACrE,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAqB;gBAGtC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB;IAkCpC,uEAAuE;IACvE,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,cAAc;IAMpC,yDAAyD;IACzD,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,iBAAiB;IAM7C;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAY3C,IAAI,IAAI,IAAI;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAE9D;IAED,8EAA8E;IAC9E,OAAO,IAAI,IAAI;CAKhB"}
+{"version":3,"file":"layered-canvas.d.ts","sourceRoot":"","sources":["../src/layered-canvas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIpD,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,0EAA0E;IAC1E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAChE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IACrE,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAG9B,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB;IAmCpC,uEAAuE;IACvE,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,cAAc;IAMpC,yDAAyD;IACzD,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,iBAAiB;IAM7C;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAY3C,IAAI,IAAI,IAAI;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAE9D;IAED,8EAA8E;IAC9E,OAAO,IAAI,IAAI;CAKhB"}