@oh-just-another/renderer-core 0.57.0

package/dist/grid-renderer.js

@@ -0,0 +1,173 @@
+import { getScreenToWorld, getWorldToScreen } from "@oh-just-another/scene";
+import { matrix } from "@oh-just-another/math";
+import { GRID_DOT_FADE_FROM_PX, GRID_DOT_FADE_FULL_PX, GRID_DOT_FILL, GRID_DOT_RADIUS_PX, GRID_LEVEL_RUNGS, GRID_LEVEL_SUBDIV, GRID_LINE_COLOR, GRID_LINE_FADE_FROM_PX, GRID_LINE_FADE_FULL_PX, GRID_LINE_WIDTH_PX, GRID_MIN_SCREEN_SPACING_PX, } from "./constants.js";
+/**
+ * Compute the dynamic, self-similar grid ladder for a given zoom. The
+ * rungs are anchored to the current zoom — the finest rung is the
+ * smallest `gridSize · SUBDIV^k` (k ∈ ℤ, possibly negative → finer than
+ * `gridSize`) whose on-screen spacing is at least `fadeFromPx` — so as
+ * the zoom changes the whole ladder slides and a new rung always fades
+ * in. Each rung's opacity ramps from `fadeFromPx` (0) to `fadeFullPx`
+ * (1) of on-screen spacing. Pure / allocation-light; exported for tests.
+ */
+export const computeGridRungs = (gridSize, zoom, fadeFromPx, fadeFullPx, subdiv = GRID_LEVEL_SUBDIV, rungs = GRID_LEVEL_RUNGS) => {
+    const out = [];
+    if (gridSize <= 0 || zoom <= 0)
+        return out;
+    // Screen spacing of the base (k = 0) lattice, then the smallest k whose
+    // spacing clears the fade-in floor.
+    const baseScreen = gridSize * zoom;
+    const kMin = Math.ceil(Math.log(fadeFromPx / baseScreen) / Math.log(subdiv));
+    for (let i = 0; i < rungs; i++) {
+        const k = kMin + i;
+        const step = gridSize * subdiv ** k;
+        const screenSpacing = step * zoom;
+        const opacity = Math.max(0, Math.min(1, (screenSpacing - fadeFromPx) / (fadeFullPx - fadeFromPx)));
+        if (opacity <= 0)
+            continue;
+        out.push({ step, opacity });
+    }
+    return out;
+};
+/**
+ * Self-similar background grid. By default it paints a DYNAMIC ladder
+ * (see {@link computeGridRungs}): a handful of zoom-anchored rungs, each
+ * `GRID_LEVEL_SUBDIV`× the previous, so new lines / dots fade in at every
+ * zoom — there's no fixed finest rung to bottom out on. Pass
+ * `options.levels` for the fixed-ladder behaviour.
+ *
+ * Designed for a dedicated background layer (`target.clear()` ed before
+ * painting unless `skipClear` is set). The fill / stroke colour is one
+ * constant — opacity carries the level distinction.
+ */
+export const renderGrid = (scene, target, options = {}) => {
+    if (!options.skipClear)
+        target.clear();
+    const gridSize = scene.viewport.gridSize;
+    if (!gridSize || gridSize <= 0)
+        return;
+    const style = scene.viewport.gridStyle ?? "lines";
+    const isDots = style === "dots";
+    // Lines and dots default to different colours. Explicit options.color
+    // still wins so hosts can fully re-skin either style.
+    const color = options.color ?? (isDots ? GRID_DOT_FILL : GRID_LINE_COLOR);
+    const zoom = scene.viewport.zoom;
+    const { width, height } = target.size;
+    if (width <= 0 || height <= 0)
+        return;
+    // Project the screen rect into world coords (axis-aligned AABB).
+    const viewportWorld = computeViewportWorldRect(scene, width, height);
+    if (!viewportWorld)
+        return;
+    const draw = (step) => {
+        if (isDots)
+            drawDotLevel(target, viewportWorld, step, color, zoom);
+        else
+            drawLineLevel(target, viewportWorld, step, color, zoom);
+    };
+    target.save();
+    target.setTransform(getWorldToScreen(scene.viewport));
+    target.setDashArray(null);
+    if (options.levels) {
+        // Fixed-ladder path: opacity keyed off absolute zoom.
+        for (const level of options.levels) {
+            const opacity = levelOpacity(zoom, level);
+            if (opacity <= 0)
+                continue;
+            const step = level.step * gridSize;
+            if (step * zoom < GRID_MIN_SCREEN_SPACING_PX)
+                continue;
+            target.setOpacity(opacity);
+            draw(step);
+        }
+    }
+    else {
+        // Default dynamic (infinite) ladder.
+        const fadeFrom = isDots ? GRID_DOT_FADE_FROM_PX : GRID_LINE_FADE_FROM_PX;
+        const fadeFull = isDots ? GRID_DOT_FADE_FULL_PX : GRID_LINE_FADE_FULL_PX;
+        for (const rung of computeGridRungs(gridSize, zoom, fadeFrom, fadeFull)) {
+            target.setOpacity(rung.opacity);
+            draw(rung.step);
+        }
+    }
+    target.setOpacity(1);
+    target.restore();
+};
+// --- Level rendering --------------------------------------------------------
+const drawLineLevel = (target, viewport, step, color, zoom) => {
+    const { minX, maxX, minY, maxY } = snappedExtents(viewport, step);
+    const lineWidth = GRID_LINE_WIDTH_PX / zoom;
+    target.setStroke(color);
+    target.setStrokeWidth(lineWidth);
+    target.beginPath();
+    for (let x = minX; x <= maxX; x += step) {
+        target.moveTo(x, minY);
+        target.lineTo(x, maxY);
+    }
+    for (let y = minY; y <= maxY; y += step) {
+        target.moveTo(minX, y);
+        target.lineTo(maxX, y);
+    }
+    target.stroke();
+};
+const drawDotLevel = (target, viewport, step, color, zoom) => {
+    const { minX, maxX, minY, maxY } = snappedExtents(viewport, step);
+    target.setStroke(null);
+    target.setFill(color);
+    const r = GRID_DOT_RADIUS_PX / zoom;
+    const d = r * 2;
+    for (let x = minX; x <= maxX; x += step) {
+        for (let y = minY; y <= maxY; y += step) {
+            target.beginPath();
+            target.rect(x - r, y - r, d, d);
+            target.fill();
+        }
+    }
+};
+// --- Helpers ----------------------------------------------------------------
+const snappedExtents = (viewport, step) => ({
+    minX: Math.floor(viewport.x / step) * step - step,
+    maxX: Math.ceil((viewport.x + viewport.width) / step) * step + step,
+    minY: Math.floor(viewport.y / step) * step - step,
+    maxY: Math.ceil((viewport.y + viewport.height) / step) * step + step,
+});
+/**
+ * Linear-fade opacity for one rung.
+ *   z ≥ mid → 1
+ *   min ≤ z < mid → (z − min) / (mid − min)
+ *   z < min → 0
+ */
+const levelOpacity = (z, level) => {
+    if (z >= level.mid)
+        return 1;
+    if (z <= level.min)
+        return 0;
+    return (z - level.min) / (level.mid - level.min);
+};
+const computeViewportWorldRect = (scene, width, height) => {
+    const s2w = getScreenToWorld(scene.viewport);
+    const corners = [
+        matrix.applyToPoint(s2w, { x: 0, y: 0 }),
+        matrix.applyToPoint(s2w, { x: width, y: 0 }),
+        matrix.applyToPoint(s2w, { x: width, y: height }),
+        matrix.applyToPoint(s2w, { x: 0, y: height }),
+    ];
+    let minX = Infinity;
+    let maxX = -Infinity;
+    let minY = Infinity;
+    let maxY = -Infinity;
+    for (const p of corners) {
+        if (p.x < minX)
+            minX = p.x;
+        if (p.x > maxX)
+            maxX = p.x;
+        if (p.y < minY)
+            minY = p.y;
+        if (p.y > maxY)
+            maxY = p.y;
+    }
+    if (!Number.isFinite(minX))
+        return null;
+    return { x: minX, y: minY, width: maxX - minX, height: maxY - minY };
+};
+//# sourceMappingURL=grid-renderer.js.map

package/dist/grid-renderer.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+export type { RenderTarget, LineCap, LineJoin, TextAlign, TextBaseline, FillRule, FontStyleOptions, DrawPoint, } from "./render-target.js";
+export type { ElementRenderer } from "./shape-renderer.js";
+export type { LayerName } from "./layers.js";
+export type { RenderSceneOptions, LodOptions } from "./scene-renderer.js";
+export type { RenderLinksOptions } from "./edge-renderer.js";
+export type { RenderGridOptions, GridLevel, GridRung } from "./grid-renderer.js";
+export { registerElementRenderer, getElementRenderer, hasElementRenderer } from "./shape-renderer.js";
+export { LAYER_ORDER } from "./layers.js";
+export { renderScene } from "./scene-renderer.js";
+export { renderLinks, strokeRoundedPolyline } from "./edge-renderer.js";
+export { renderGrid, computeGridRungs } from "./grid-renderer.js";
+export { installBuiltinRenderers } from "./built-in-renderers.js";
+export type { WrapOptions, WrappedLine } from "./text-layout.js";
+export { wrapText } from "./text-layout.js";
+export type { LaidOutLine, EditableTextLayout, MeasureText, LayoutTextOptions, CaretGeometry, SelectionRect, } from "./text-editing.js";
+export { layoutText, caretGeometry, pointToCaretIndex, selectionRects, DEFAULT_LINE_HEIGHT_FACTOR, } from "./text-editing.js";
+export { ElementCache, sharedBoundsCache, cachedWorldBounds } from "./shape-cache.js";
+export type { ElementBitmapCache } from "./shape-cache-bitmap.js";
+export { InMemoryElementBitmapCache, zoomBucket } from "./shape-cache-bitmap.js";
+export type { LinkBitmapCache } from "./edge-cache-bitmap.js";
+export { InMemoryLinkBitmapCache } from "./edge-cache-bitmap.js";
+export type { LayerCompositeCache } from "./layer-cache-composite.js";
+export { InMemoryLayerCompositeCache } from "./layer-cache-composite.js";
+export type { AnimatedSourceAdapter } from "./animation-adapter.js";
+export { registerAnimationAdapter, unregisterAnimationAdapter, getAnimationAdapter, listAnimationKinds, resolveImageSource, setAnimationClock, resetAnimationClock, onAnimationContentReady, notifyAnimationContentReady, } from "./animation-adapter.js";
+export type { TextShaper, ShaperFont, ShapedGlyph } from "./text-shaper.js";
+export { setActiveTextShaper, getActiveTextShaper } from "./text-shaper.js";
+export type { Rasterizer } from "./rasterizer.js";
+export { setActiveRasterizer, getActiveRasterizer } from "./rasterizer.js";
+export { jsRasterizer } from "./js-rasterizer.js";
+export type { WorkerRenderMessage, WorkerRenderResponse, } from "./worker-render.js";
+export { WORKER_AUTO_THRESHOLD } from "./worker-render.js";
+export type { TileKey, TileCache, TileCacheEntry } from "./tile-renderer.js";
+export { TILE_SIZE, MAX_TILE_CACHE_BYTES, LOD_THRESHOLD, InMemoryTileCache, } from "./tile-renderer.js";
+export { LinkBoundsCache, computeLinkWorldBounds, sharedLinkBoundsCache, } from "./edge-cache.js";
+export { DEFAULT_LOD, DEFAULT_PLACEHOLDER_FILL, VIEWPORT_CULL_PADDING_RATIO, LINK_CORNER_RADIUS, GRID_LINE_COLOR, GRID_DOT_FILL, GRID_LINE_WIDTH_PX, GRID_DOT_RADIUS_PX, GRID_MIN_SCREEN_SPACING_PX, GRID_LEVEL_SUBDIV, GRID_LEVEL_RUNGS, GRID_LINE_FADE_FROM_PX, GRID_LINE_FADE_FULL_PX, GRID_DOT_FADE_FROM_PX, GRID_DOT_FADE_FULL_PX, } from "./constants.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,24 @@
+export { registerElementRenderer, getElementRenderer, hasElementRenderer } from "./shape-renderer.js";
+export { LAYER_ORDER } from "./layers.js";
+export { renderScene } from "./scene-renderer.js";
+export { renderLinks, strokeRoundedPolyline } from "./edge-renderer.js";
+export { renderGrid, computeGridRungs } from "./grid-renderer.js";
+// Backend-agnostic shape renderers for the built-in `BuiltinElement` types.
+// `installBuiltinRenderers()` registers them via `registerElementRenderer` and
+// is safe to call multiple times.
+export { installBuiltinRenderers } from "./built-in-renderers.js";
+export { wrapText } from "./text-layout.js";
+export { layoutText, caretGeometry, pointToCaretIndex, selectionRects, DEFAULT_LINE_HEIGHT_FACTOR, } from "./text-editing.js";
+export { ElementCache, sharedBoundsCache, cachedWorldBounds } from "./shape-cache.js";
+export { InMemoryElementBitmapCache, zoomBucket } from "./shape-cache-bitmap.js";
+export { InMemoryLinkBitmapCache } from "./edge-cache-bitmap.js";
+export { InMemoryLayerCompositeCache } from "./layer-cache-composite.js";
+export { registerAnimationAdapter, unregisterAnimationAdapter, getAnimationAdapter, listAnimationKinds, resolveImageSource, setAnimationClock, resetAnimationClock, onAnimationContentReady, notifyAnimationContentReady, } from "./animation-adapter.js";
+export { setActiveTextShaper, getActiveTextShaper } from "./text-shaper.js";
+export { setActiveRasterizer, getActiveRasterizer } from "./rasterizer.js";
+export { jsRasterizer } from "./js-rasterizer.js";
+export { WORKER_AUTO_THRESHOLD } from "./worker-render.js";
+export { TILE_SIZE, MAX_TILE_CACHE_BYTES, LOD_THRESHOLD, InMemoryTileCache, } from "./tile-renderer.js";
+export { LinkBoundsCache, computeLinkWorldBounds, sharedLinkBoundsCache, } from "./edge-cache.js";
+export { DEFAULT_LOD, DEFAULT_PLACEHOLDER_FILL, VIEWPORT_CULL_PADDING_RATIO, LINK_CORNER_RADIUS, GRID_LINE_COLOR, GRID_DOT_FILL, GRID_LINE_WIDTH_PX, GRID_DOT_RADIUS_PX, GRID_MIN_SCREEN_SPACING_PX, GRID_LEVEL_SUBDIV, GRID_LEVEL_RUNGS, GRID_LINE_FADE_FROM_PX, GRID_LINE_FADE_FULL_PX, GRID_DOT_FADE_FROM_PX, GRID_DOT_FADE_FULL_PX, } from "./constants.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACtG,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAElE,4EAA4E;AAC5E,+EAA+E;AAC/E,kCAAkC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAS5C,OAAO,EACL,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEtF,OAAO,EAAE,0BAA0B,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAIzE,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5E,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKlD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,aAAa,EACb,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,WAAW,EACX,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC"}

package/dist/js-rasterizer.d.ts

@@ -0,0 +1,8 @@
+import type { Rasterizer } from "./rasterizer.js";
+/**
+ * Reference JS implementation of the `Rasterizer` interface. Path
+ * flattening delegates to the `@math/bezier` adaptive flattener;
+ * stroke-to-fill builds a mitre-joined offset polygon.
+ */
+export declare const jsRasterizer: Rasterizer;
+//# sourceMappingURL=js-rasterizer.d.ts.map

package/dist/js-rasterizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-rasterizer.d.ts","sourceRoot":"","sources":["../src/js-rasterizer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAOlD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,UA8E1B,CAAC"}

package/dist/js-rasterizer.js

@@ -0,0 +1,86 @@
+import { bezier } from "@oh-just-another/math";
+const req = (v) => {
+    if (v === undefined)
+        throw new Error("packages/renderer-core: index out of range");
+    return v;
+};
+/**
+ * Reference JS implementation of the `Rasterizer` interface. Path
+ * flattening delegates to the `@math/bezier` adaptive flattener;
+ * stroke-to-fill builds a mitre-joined offset polygon.
+ */
+export const jsRasterizer = {
+    flatten(commands, tolerance) {
+        // Smaller tolerance → more samples. Pick a sample count proportional
+        // to the rough chord length divided by tolerance, bounded so
+        // degenerate inputs don't explode.
+        const sampleCount = (chordLen) => Math.min(128, Math.max(8, Math.ceil(chordLen / Math.max(0.1, tolerance))));
+        const out = [];
+        let pen = { x: 0, y: 0 };
+        for (const cmd of commands) {
+            switch (cmd.kind) {
+                case "M":
+                    pen = cmd.to;
+                    out.push(pen);
+                    break;
+                case "L":
+                    pen = cmd.to;
+                    out.push(pen);
+                    break;
+                case "Q": {
+                    const chord = Math.hypot(cmd.to.x - pen.x, cmd.to.y - pen.y);
+                    const samples = bezier.flattenQuadratic(pen, cmd.control, cmd.to, sampleCount(chord));
+                    for (let i = 1; i < samples.length; i++)
+                        out.push(req(samples[i]));
+                    pen = cmd.to;
+                    break;
+                }
+                case "C": {
+                    const chord = Math.hypot(cmd.to.x - pen.x, cmd.to.y - pen.y);
+                    const samples = bezier.flattenCubic(pen, cmd.control1, cmd.control2, cmd.to, sampleCount(chord));
+                    for (let i = 1; i < samples.length; i++)
+                        out.push(req(samples[i]));
+                    pen = cmd.to;
+                    break;
+                }
+                case "Z":
+                    // Close — connect back to the first point if it exists.
+                    if (out.length > 0) {
+                        const first = req(out[0]);
+                        out.push(first);
+                        pen = first;
+                    }
+                    break;
+            }
+        }
+        return out;
+    },
+    strokeToFill(polyline, width, options) {
+        if (polyline.length < 2)
+            return polyline;
+        const half = width / 2;
+        const cap = options?.cap ?? "butt";
+        void options?.join; // mitre-only in this reference implementation
+        const left = [];
+        const right = [];
+        for (let i = 0; i < polyline.length; i++) {
+            const prev = req(polyline[Math.max(0, i - 1)]);
+            const next = req(polyline[Math.min(polyline.length - 1, i + 1)]);
+            const cur = req(polyline[i]);
+            const dx = next.x - prev.x;
+            const dy = next.y - prev.y;
+            const len = Math.hypot(dx, dy) || 1;
+            const nx = -dy / len;
+            const ny = dx / len;
+            left.push({ x: cur.x + nx * half, y: cur.y + ny * half });
+            right.push({ x: cur.x - nx * half, y: cur.y - ny * half });
+        }
+        // Round / square caps would extend the line ends here; butt =
+        // just the side offsets.
+        if (cap === "round" || cap === "square") {
+            // No-op: non-butt endcaps need extra verts; not generated here.
+        }
+        return [...left, ...right.reverse(), req(left[0])];
+    },
+};
+//# sourceMappingURL=js-rasterizer.js.map

package/dist/js-rasterizer.js.map

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

package/dist/layer-cache-composite.d.ts

@@ -0,0 +1,39 @@
+import type { LayerId } from "@oh-just-another/types";
+/**
+ * Per-layer composite cache. Caches the rasterised `LayerId @ zoomBucket`
+ * composite so renderScene can replay unchanged layers via a single
+ * `drawImage` instead of walking every shape on every frame.
+ *
+ * Invalidation: the editor's patch pipeline knows which layers had any
+ * shape/edge change this frame; it passes that set down to renderScene
+ * which calls `invalidateLayer(id)` for each. The
+ * `LayerCompositeCache.get` then misses for those layers and the
+ * renderer falls back to the per-shape walk + optionally caches the
+ * result via the host's `compositeLayerBitmap` callback.
+ *
+ * `Map<LayerId @ zoomBucket → bitmap>` shape mirrors the per-shape /
+ * per-edge caches; LRU by insertion order with a count cap.
+ */
+export interface LayerCompositeCache<V = unknown> {
+    get(layerId: LayerId, zoomBucket: number): V | undefined;
+    set(layerId: LayerId, zoomBucket: number, value: V): void;
+    invalidateLayer(layerId: LayerId): void;
+    clear(): void;
+    readonly size: number;
+}
+export declare class InMemoryLayerCompositeCache<V> implements LayerCompositeCache<V> {
+    private readonly entries;
+    private readonly cap;
+    constructor(cap?: number);
+    get size(): number;
+    get(layerId: LayerId, zoomBucket: number): V | undefined;
+    set(layerId: LayerId, zoomBucket: number, value: V): void;
+    /**
+     * Drop every cached bucket for a layer (across all zoom buckets).
+     * A single shape mutation invalidates the whole layer composite;
+     * partial-invalidation would need region tracking inside the bitmap.
+     */
+    invalidateLayer(layerId: LayerId): void;
+    clear(): void;
+}
+//# sourceMappingURL=layer-cache-composite.d.ts.map

package/dist/layer-cache-composite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer-cache-composite.d.ts","sourceRoot":"","sources":["../src/layer-cache-composite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACzD,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAC1D,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxC,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAID,qBAAa,2BAA2B,CAAC,CAAC,CAAE,YAAW,mBAAmB,CAAC,CAAC,CAAC;IAC3E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,GAAG,SAAK;IAIpB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IASxD,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAUzD;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAOvC,KAAK,IAAI,IAAI;CAGd"}

package/dist/layer-cache-composite.js

@@ -0,0 +1,47 @@
+const keyFor = (layerId, zoomBucket) => `${layerId}@${zoomBucket}`;
+export class InMemoryLayerCompositeCache {
+    entries = new Map();
+    cap;
+    constructor(cap = 32) {
+        this.cap = cap;
+    }
+    get size() {
+        return this.entries.size;
+    }
+    get(layerId, zoomBucket) {
+        const key = keyFor(layerId, zoomBucket);
+        const v = this.entries.get(key);
+        if (v === undefined)
+            return undefined;
+        this.entries.delete(key);
+        this.entries.set(key, v);
+        return v;
+    }
+    set(layerId, zoomBucket, value) {
+        const key = keyFor(layerId, zoomBucket);
+        if (this.entries.has(key))
+            this.entries.delete(key);
+        this.entries.set(key, value);
+        if (this.entries.size > this.cap) {
+            const oldest = this.entries.keys().next().value;
+            if (oldest !== undefined)
+                this.entries.delete(oldest);
+        }
+    }
+    /**
+     * Drop every cached bucket for a layer (across all zoom buckets).
+     * A single shape mutation invalidates the whole layer composite;
+     * partial-invalidation would need region tracking inside the bitmap.
+     */
+    invalidateLayer(layerId) {
+        const prefix = `${layerId}@`;
+        for (const key of [...this.entries.keys()]) {
+            if (key.startsWith(prefix))
+                this.entries.delete(key);
+        }
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+//# sourceMappingURL=layer-cache-composite.js.map

package/dist/layer-cache-composite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer-cache-composite.js","sourceRoot":"","sources":["../src/layer-cache-composite.ts"],"names":[],"mappings":"AA0BA,MAAM,MAAM,GAAG,CAAC,OAAgB,EAAE,UAAkB,EAAU,EAAE,CAAC,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;AAE5F,MAAM,OAAO,2BAA2B;IACrB,OAAO,GAAG,IAAI,GAAG,EAAa,CAAC;IAC/B,GAAG,CAAS;IAE7B,YAAY,GAAG,GAAG,EAAE;QAClB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,OAAgB,EAAE,UAAkB;QACtC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACtC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACzB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,GAAG,CAAC,OAAgB,EAAE,UAAkB,EAAE,KAAQ;QAChD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7B,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAChD,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,OAAgB;QAC9B,MAAM,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC3C,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/layers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Logical layers the renderer composites in this order (bottom to top).
+ *
+ * `background` is for static content that changes rarely — grid, watermarks,
+ * imported images. `main` carries every shape/edge in the scene. `overlay` is
+ * for transient UI — selection handles, drag previews, snap guides.
+ *
+ * Backends that support multiple draw surfaces (e.g. `renderer-canvas` with
+ * stacked `<canvas>` elements) map each `LayerName` to its own surface so the
+ * frequently-changing overlay does not invalidate the static main.
+ */
+export type LayerName = "background" | "main" | "overlay";
+export declare const LAYER_ORDER: readonly LayerName[];
+//# sourceMappingURL=layers.d.ts.map

package/dist/layers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../src/layers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1D,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAAsC,CAAC"}

package/dist/layers.js

@@ -0,0 +1,2 @@
+export const LAYER_ORDER = ["background", "main", "overlay"];
+//# sourceMappingURL=layers.js.map

package/dist/layers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.js","sourceRoot":"","sources":["../src/layers.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,WAAW,GAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC"}

package/dist/rasterizer.d.ts

@@ -0,0 +1,27 @@
+import type { Vec2 } from "@oh-just-another/types";
+import type { PathCommand } from "@oh-just-another/scene";
+export declare const setActiveRasterizer: (r: Rasterizer | null) => void;
+export declare const getActiveRasterizer: () => Rasterizer | null;
+/**
+ * 2D rasterisation helpers. Lets a host swap the pure-TS bezier flatten /
+ * stroke-to-fill / gradient ops for a WASM implementation when batch
+ * processing dominates (handwriting demos, dense edge meshes). Default uses
+ * the JS path in `@oh-just-another/math/bezier`.
+ */
+export interface Rasterizer {
+    /**
+     * Flatten a path's bezier segments into a polyline at the given
+     * tolerance (max distance between approximation and curve in
+     * world pixels). Output points are in world coords.
+     */
+    flatten(commands: readonly PathCommand[], tolerance: number): readonly Vec2[];
+    /**
+     * Convert a stroked polyline into the outline of the stroke
+     * (so a backend without native stroke can fill it as a polygon).
+     */
+    strokeToFill(polyline: readonly Vec2[], width: number, options?: {
+        readonly cap?: "butt" | "round" | "square";
+        readonly join?: "miter" | "round" | "bevel";
+    }): readonly Vec2[];
+}
+//# sourceMappingURL=rasterizer.d.ts.map

package/dist/rasterizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rasterizer.d.ts","sourceRoot":"","sources":["../src/rasterizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAS1D,eAAO,MAAM,mBAAmB,GAC9B,GAAG,UAAU,GAAG,IAAI,KACnB,IAEF,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAAO,UAAU,GAAG,IAClC,CAAC;AAGnB;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,IAAI,EAAE,CAAC;IAE9E;;;OAGG;IACH,YAAY,CACV,QAAQ,EAAE,SAAS,IAAI,EAAE,EACzB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;KAC7C,GACA,SAAS,IAAI,EAAE,CAAC;CACpB"}

package/dist/rasterizer.js

@@ -0,0 +1,10 @@
+// Process-global active rasterizer. Mirrors `setActiveTextShaper` —
+// Editor installs once on mount; backend code (WebGL2Target's curve
+// flattening) reads at draw time. `null` falls back to the backend's
+// built-in JS sampler.
+let activeRasterizer = null;
+export const setActiveRasterizer = (r) => {
+    activeRasterizer = r;
+};
+export const getActiveRasterizer = () => activeRasterizer;
+//# sourceMappingURL=rasterizer.js.map

package/dist/rasterizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rasterizer.js","sourceRoot":"","sources":["../src/rasterizer.ts"],"names":[],"mappings":"AAGA,oEAAoE;AACpE,oEAAoE;AACpE,qEAAqE;AACrE,uBAAuB;AAEvB,IAAI,gBAAgB,GAAsB,IAAI,CAAC;AAE/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,CAAoB,EACd,EAAE;IACR,gBAAgB,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAsB,EAAE,CACzD,gBAAgB,CAAC"}

package/dist/render-target.d.ts

@@ -0,0 +1,94 @@
+import type { Bounds, Color, Transform, Vec2 } from "@oh-just-another/types";
+export type LineCap = "butt" | "round" | "square";
+export type LineJoin = "miter" | "round" | "bevel";
+export type TextAlign = "left" | "center" | "right";
+export type TextBaseline = "top" | "middle" | "bottom";
+export type FillRule = "nonzero" | "evenodd";
+/**
+ * Optional bold / italic for {@link RenderTarget.setFont}. Omitted →
+ * normal weight & upright. Backends realise these differently: Canvas2D
+ * folds them into the `ctx.font` shorthand; WebGL2 selects the matching
+ * MSDF atlas font (faux-shear / weight where a variant is unavailable).
+ */
+export interface FontStyleOptions {
+    readonly weight?: "normal" | "bold";
+    readonly style?: "normal" | "italic";
+}
+/**
+ * Backend-agnostic drawing surface. Both `renderer-canvas` (Canvas2D) and
+ * `renderer-svg` (SVG string-builder) implement this interface. Keeping the
+ * surface low-level lets shape renderers stay backend-agnostic without losing
+ * fidelity — the methods map 1:1 to native Canvas2D primitives.
+ */
+export interface RenderTarget {
+    setFill(color: Color | null): void;
+    setStroke(color: Color | null): void;
+    setStrokeWidth(width: number): void;
+    setOpacity(alpha: number): void;
+    setLineCap(cap: LineCap): void;
+    setLineJoin(join: LineJoin): void;
+    setDashArray(dash: readonly number[] | null): void;
+    setFont(fontFamily: string, fontSize: number, options?: FontStyleOptions): void;
+    setTextAlign(align: TextAlign): void;
+    setTextBaseline(baseline: TextBaseline): void;
+    save(): void;
+    restore(): void;
+    translate(dx: number, dy: number): void;
+    rotate(radians: number): void;
+    scale(sx: number, sy: number): void;
+    setTransform(t: Transform): void;
+    resetTransform(): void;
+    beginPath(): void;
+    closePath(): void;
+    moveTo(x: number, y: number): void;
+    lineTo(x: number, y: number): void;
+    quadraticCurveTo(cx: number, cy: number, x: number, y: number): void;
+    bezierCurveTo(c1x: number, c1y: number, c2x: number, c2y: number, x: number, y: number): void;
+    rect(x: number, y: number, width: number, height: number): void;
+    ellipse(cx: number, cy: number, rx: number, ry: number): void;
+    fill(rule?: FillRule): void;
+    stroke(): void;
+    fillText(text: string, x: number, y: number, maxWidth?: number): void;
+    measureText(text: string): {
+        width: number;
+    };
+    /**
+     * Draw an image. The accepted `image` type depends on the backend:
+     * Canvas2D expects a `CanvasImageSource`; SVG accepts a URL string;
+     * Node-side targets can accept any backend-specific image handle.
+     * The kernel does not load images — it just hands the source through.
+     *
+     * `dynamic` signals an animated source (GIF `<img>`, `<video>`)
+     * whose pixels change between frames. Backends that cache an
+     * uploaded copy (WebGL2 textures) MUST re-upload the current frame
+     * when `dynamic` is true; backends that read the source live every
+     * draw (Canvas2D) ignore it. Default `false` — static image.
+     */
+    drawImage(image: unknown, dx: number, dy: number, dw: number, dh: number, dynamic?: boolean): void;
+    /** Erase a region. Without bounds, erases everything. */
+    clear(bounds?: Bounds): void;
+    /** Current intrinsic surface size in CSS pixels (pre-DPR). */
+    readonly size: {
+        readonly width: number;
+        readonly height: number;
+    };
+    /**
+     * Mark a screen-space rectangle as dirty for the *current* frame.
+     * Optional hook — backends that don't need per-pass dirty tracking
+     * can implement it as a no-op. Renderers call this after a draw
+     * operation that paints outside the shape's intrinsic bbox (anti-
+     * aliased stroke fuzz, drop shadows, oversized arrowheads) so the
+     * host's next `clear()` can cover the actual painted area, not
+     * just the geometric bbox.
+     *
+     * The bounds are in *screen pixels* (post-projection), matching
+     * `clear(bounds)`.
+     */
+    markDirty?(bounds: Bounds): void;
+}
+/**
+ * Convenience type for code that produces low-level draw calls without doing
+ * any transform math itself.
+ */
+export type DrawPoint = Vec2;
+//# sourceMappingURL=render-target.d.ts.map