@oh-just-another/renderer-core 0.57.0

package/dist/render-target.d.ts.map

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

package/dist/render-target.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=render-target.js.map

package/dist/render-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-target.js","sourceRoot":"","sources":["../src/render-target.ts"],"names":[],"mappings":""}

package/dist/scene-renderer.d.ts

@@ -0,0 +1,126 @@
+import { type Scene, type ElementBase, type SpatialGrid } from "@oh-just-another/scene";
+import type { Bounds, LayerId, ElementId } from "@oh-just-another/types";
+import type { RenderTarget } from "./render-target.js";
+import { ElementCache } from "./shape-cache.js";
+import type { LayerCompositeCache } from "./layer-cache-composite.js";
+/**
+ * Zoom-based level-of-detail thresholds. Each threshold turns on a
+ * cheaper render path when the scene zoom drops below it:
+ *
+ * - **placeholder** → draw a flat fill at the shape's world AABB and
+ *   skip the registered renderer entirely. Highest savings, biggest
+ *   visual fidelity loss; reserve for very-zoomed-out overviews.
+ * - **hideText** → skip text shapes (their wrap+measure cost is high).
+ *
+ * Thresholds compare against `scene.viewport.zoom` (1.0 = 1:1 pixels).
+ * Omit a threshold to disable that level.
+ */
+export interface LodOptions {
+    readonly placeholder?: number;
+    readonly hideText?: number;
+}
+export interface RenderSceneOptions {
+    /** Skip clearing the target before drawing. Default: false. */
+    readonly skipClear?: boolean;
+    /** Called for shapes whose `type` has no registered renderer. Default: ignore. */
+    readonly onUnknownElement?: (shape: ElementBase) => void;
+    /**
+     * World-space viewport bounds. When provided, shapes whose AABB does
+     * not intersect this rectangle are skipped (viewport culling). Pass
+     * a slightly inflated rect to avoid pop-in during pan.
+     */
+    readonly viewport?: Bounds;
+    /**
+     * Persistent bounds cache. When omitted a fresh per-render cache is
+     * created — fine for hot paths because lookups inside one frame still
+     * amortize. Pass a long-lived cache from `Editor` to share work across
+     * frames, hit-test, and overlay.
+     */
+    readonly boundsCache?: ElementCache<Bounds>;
+    /**
+     * Pre-built spatial index. When provided together with `viewport`, the
+     * renderer picks candidate shapes from the index and skips full layer
+     * scans — pays off around ~10k shapes.
+     */
+    readonly spatialIndex?: SpatialGrid;
+    /**
+     * Zoom thresholds for cheaper render paths. See {@link LodOptions}.
+     */
+    readonly lod?: LodOptions;
+    /**
+     * Placeholder fill colour. Defaults to `#bbb`. Pick something close
+     * to the average shape colour so the transition is unobtrusive.
+     */
+    readonly placeholderFill?: string;
+    /**
+     * Optional dirty rectangle in **world** coords. When set:
+     *   • the renderer clears only the corresponding screen region;
+     *   • shapes whose world AABB doesn't intersect the dirty rect are
+     *     skipped entirely.
+     * Combined with shape-identity tracking by the host this drops most
+     * of the per-frame work for "single shape moves on otherwise static
+     * scene".
+     */
+    readonly dirtyWorld?: Bounds;
+    /**
+     * Shapes to render with reduced alpha (modern-style group isolation).
+     * For each shape whose `id` appears in this set, the renderer sets
+     * `globalAlpha = dimOpacity` for the per-shape draw pass before
+     * dispatching to the registered renderer.
+     *
+     * Caveat: shapes whose own `style.opacity` is explicitly set will
+     * have their renderer call `setOpacity` again and override the
+     * dim — the dim affects only the common case where shapes don't
+     * carry an explicit opacity. Acceptable for the isolation UX
+     * because outsiders are usually plain opaque shapes.
+     */
+    readonly dimElements?: ReadonlySet<ElementId>;
+    /**
+     * Alpha to use for `dimElements`. Default 1 (no-op). Hosts using the
+     * isolation feature should pass their `ISOLATION_DIM_OPACITY`
+     * constant.
+     */
+    readonly dimOpacity?: number;
+    /**
+     * Element ids that should NOT render this pass. Used by hosts that
+     * implement per-shape / group hide propagation: the editor walks
+     * the parent chain to compute which shapes are effectively hidden
+     * and forwards the set here. Hidden shapes are also skipped in
+     * hit-test on the editor side, so they read as "absent" entirely.
+     */
+    readonly hideElements?: ReadonlySet<ElementId>;
+    /**
+     * Per-layer composite bitmap cache. When supplied along with
+     * `compositeLayerBitmap`, unchanged layers (i.e. not present in
+     * `dirtyLayerIds`) are drawn from a single cached `drawImage` call
+     * instead of walking every shape.
+     *
+     * Pass `dirtyLayerIds` so the renderer knows which layers to
+     * re-rasterise. Without it the cache is treated as cold every
+     * frame (defensive — better stale work than a stale visual).
+     */
+    readonly layerCompositeCache?: LayerCompositeCache;
+    readonly dirtyLayerIds?: ReadonlySet<LayerId>;
+    /**
+     * Host-side layer rasteriser. Receives the layer id, the active
+     * zoom bucket, and the scene; returns the bitmap to cache or
+     * `null` to opt out. The kernel doesn't ship one — `Offscreen
+     * Canvas` import lives in `@renderer-canvas`.
+     */
+    readonly compositeLayerBitmap?: (layerId: LayerId, zoomBucket: number, scene: Scene) => unknown;
+}
+/**
+ * Renders the `main` z-stack of a scene onto a single target.
+ *
+ * Order of operations:
+ *   1. Optionally clear the surface.
+ *   2. Apply the scene's world-to-screen transform.
+ *   3. For each visible layer (bottom → top): for each shape (bottom → top):
+ *      save state, push the shape's local TRS, invoke its registered renderer.
+ *
+ * This function does not draw edges, selection handles, or grids — those
+ * either live on different layers (`background` / `overlay`) or are added by
+ * higher-level packages.
+ */
+export declare const renderScene: (scene: Scene, target: RenderTarget, options?: RenderSceneOptions) => void;
+//# sourceMappingURL=scene-renderer.d.ts.map

package/dist/scene-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-renderer.d.ts","sourceRoot":"","sources":["../src/scene-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,KAAK,EACV,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAqB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGtE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,kFAAkF;IAClF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACzD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC;IACpC;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IAC9C;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IAC/C;;;;;;;;;OASG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IACnD,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAC9B,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,KAAK,KACT,OAAO,CAAC;CACd;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GACtB,OAAO,KAAK,EACZ,QAAQ,YAAY,EACpB,UAAS,kBAAuB,KAC/B,IAkIF,CAAC"}

package/dist/scene-renderer.js

@@ -0,0 +1,149 @@
+import { getLayersInOrder, getElementsInLayer, getWorldToScreen, } from "@oh-just-another/scene";
+import { bounds as B, matrix } from "@oh-just-another/math";
+import { getElementRenderer } from "./shape-renderer.js";
+import { cachedWorldBounds, ElementCache } from "./shape-cache.js";
+import { DEFAULT_PLACEHOLDER_FILL } from "./constants.js";
+import { zoomBucket as bucketFor } from "./shape-cache-bitmap.js";
+/**
+ * Renders the `main` z-stack of a scene onto a single target.
+ *
+ * Order of operations:
+ *   1. Optionally clear the surface.
+ *   2. Apply the scene's world-to-screen transform.
+ *   3. For each visible layer (bottom → top): for each shape (bottom → top):
+ *      save state, push the shape's local TRS, invoke its registered renderer.
+ *
+ * This function does not draw edges, selection handles, or grids — those
+ * either live on different layers (`background` / `overlay`) or are added by
+ * higher-level packages.
+ */
+export const renderScene = (scene, target, options = {}) => {
+    const w2s = getWorldToScreen(scene.viewport);
+    const dirtyWorld = options.dirtyWorld;
+    if (!options.skipClear) {
+        if (dirtyWorld) {
+            // Project the dirty rect to screen pixels, inflate by a few
+            // pixels to cover anti-aliased stroke fuzz.
+            const corners = [
+                matrix.applyToPoint(w2s, { x: dirtyWorld.x, y: dirtyWorld.y }),
+                matrix.applyToPoint(w2s, {
+                    x: dirtyWorld.x + dirtyWorld.width,
+                    y: dirtyWorld.y + dirtyWorld.height,
+                }),
+            ];
+            const screen = B.expand(B.fromPoints(corners), 2);
+            target.clear(screen);
+        }
+        else {
+            target.clear();
+        }
+    }
+    target.save();
+    target.setTransform(w2s);
+    const boundsCache = options.boundsCache ?? new ElementCache();
+    const viewport = options.viewport;
+    // Spatial-index candidate set: when present, restricts the per-layer
+    // walk to shapes the index considers possibly-visible. Without it the
+    // per-shape AABB check on a cached bounds is still cheap (~50ns), so
+    // the index is only worth the build cost for very large scenes.
+    let candidates = null;
+    if (viewport && options.spatialIndex) {
+        candidates = options.spatialIndex.query(viewport);
+    }
+    const zoom = scene.viewport.zoom;
+    const lod = options.lod;
+    const usePlaceholder = lod?.placeholder !== undefined && zoom < lod.placeholder;
+    const dropText = lod?.hideText !== undefined && zoom < lod.hideText;
+    const placeholderFill = options.placeholderFill ?? DEFAULT_PLACEHOLDER_FILL;
+    const layerCache = options.layerCompositeCache;
+    const dirtyLayers = options.dirtyLayerIds;
+    const compositeLayerBitmap = options.compositeLayerBitmap;
+    const zoomBucket = bucketFor(zoom);
+    const layerBoundsFor = (layerId) => {
+        let acc = null;
+        for (const shape of getElementsInLayer(scene, layerId)) {
+            const bb = cachedWorldBounds(boundsCache, shape);
+            acc = acc ? B.union(acc, bb) : bb;
+        }
+        return acc;
+    };
+    for (const layer of getLayersInOrder(scene)) {
+        if (!layer.visible)
+            continue;
+        // Per-layer composite cache fast path. Only fires when the
+        // host plugged a cache + a layer rasteriser; the kernel
+        // doesn't ship a default rasteriser because OffscreenCanvas
+        // creation lives in renderer-canvas. Drop dirty layers + ones
+        // touched by a dirty rect from the cache so the bitmap isn't
+        // re-used after a mutation.
+        if (layerCache && compositeLayerBitmap) {
+            if (dirtyLayers?.has(layer.id))
+                layerCache.invalidateLayer(layer.id);
+            let bitmap = layerCache.get(layer.id, zoomBucket);
+            if (bitmap === undefined) {
+                const fresh = compositeLayerBitmap(layer.id, zoomBucket, scene);
+                if (fresh !== null) {
+                    layerCache.set(layer.id, zoomBucket, fresh);
+                    bitmap = fresh;
+                }
+            }
+            if (bitmap !== undefined) {
+                const bb = layerBoundsFor(layer.id);
+                if (bb)
+                    target.drawImage(bitmap, bb.x, bb.y, bb.width, bb.height);
+                continue;
+            }
+        }
+        for (const shape of getElementsInLayer(scene, layer.id)) {
+            if (options.hideElements?.has(shape.id))
+                continue;
+            if (candidates && !candidates.has(shape.id))
+                continue;
+            if (viewport) {
+                const bb = cachedWorldBounds(boundsCache, shape);
+                if (!B.intersects(bb, viewport))
+                    continue;
+            }
+            if (dirtyWorld) {
+                const bb = cachedWorldBounds(boundsCache, shape);
+                if (!B.intersects(bb, dirtyWorld))
+                    continue;
+            }
+            if (dropText && shape.type === "text")
+                continue;
+            if (usePlaceholder) {
+                // Draw the AABB directly in world coords — skip the renderer
+                // entirely. The shape's TRS is folded into the cached bounds.
+                const bb = cachedWorldBounds(boundsCache, shape);
+                target.setFill(placeholderFill);
+                target.setStrokeWidth(0);
+                target.beginPath();
+                target.rect(bb.x, bb.y, bb.width, bb.height);
+                target.fill();
+                continue;
+            }
+            const renderer = getElementRenderer(shape.type);
+            if (!renderer) {
+                options.onUnknownElement?.(shape);
+                continue;
+            }
+            target.save();
+            // Isolation dim — set BEFORE the renderer runs so any
+            // shape-style-specific setOpacity inside the renderer can
+            // override (see RenderSceneOptions.dimElements).
+            if (options.dimElements?.has(shape.id) && options.dimOpacity !== undefined) {
+                target.setOpacity(options.dimOpacity);
+            }
+            target.translate(shape.position.x, shape.position.y);
+            if (shape.rotation !== 0)
+                target.rotate(shape.rotation);
+            if (shape.scale.x !== 1 || shape.scale.y !== 1) {
+                target.scale(shape.scale.x, shape.scale.y);
+            }
+            renderer(shape, target, { zoom });
+            target.restore();
+        }
+    }
+    target.restore();
+};
+//# sourceMappingURL=scene-renderer.js.map

package/dist/scene-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-renderer.js","sourceRoot":"","sources":["../src/scene-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,GAIjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,UAAU,IAAI,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAkHlE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,KAAY,EACZ,MAAoB,EACpB,UAA8B,EAAE,EAC1B,EAAE;IACR,MAAM,GAAG,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,IAAI,UAAU,EAAE,CAAC;YACf,4DAA4D;YAC5D,4CAA4C;YAC5C,MAAM,OAAO,GAAG;gBACd,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;gBAC9D,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE;oBACvB,CAAC,EAAE,UAAU,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK;oBAClC,CAAC,EAAE,UAAU,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM;iBACpC,CAAC;aACH,CAAC;YACF,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,EAAE,CAAC;IACd,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAEzB,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,YAAY,EAAU,CAAC;IACtE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,qEAAqE;IACrE,sEAAsE;IACtE,qEAAqE;IACrE,gEAAgE;IAChE,IAAI,UAAU,GAAkC,IAAI,CAAC;IACrD,IAAI,QAAQ,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACrC,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;IACjC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,MAAM,cAAc,GAAG,GAAG,EAAE,WAAW,KAAK,SAAS,IAAI,IAAI,GAAG,GAAG,CAAC,WAAW,CAAC;IAChF,MAAM,QAAQ,GAAG,GAAG,EAAE,QAAQ,KAAK,SAAS,IAAI,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC;IACpE,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,wBAAwB,CAAC;IAE5E,MAAM,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IAC1C,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAC1D,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,cAAc,GAAG,CAAC,OAAgB,EAAiB,EAAE;QACzD,IAAI,GAAG,GAAkB,IAAI,CAAC;QAC9B,KAAK,MAAM,KAAK,IAAI,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;YACvD,MAAM,EAAE,GAAG,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YACjD,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,CAAC,OAAO;YAAE,SAAS;QAE7B,2DAA2D;QAC3D,wDAAwD;QACxD,4DAA4D;QAC5D,8DAA8D;QAC9D,6DAA6D;QAC7D,4BAA4B;QAC5B,IAAI,UAAU,IAAI,oBAAoB,EAAE,CAAC;YACvC,IAAI,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAAE,UAAU,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACrE,IAAI,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;YAClD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;gBAChE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACnB,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;oBAC5C,MAAM,GAAG,KAAK,CAAC;gBACjB,CAAC;YACH,CAAC;YACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACpC,IAAI,EAAE;oBAAE,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;gBAClE,SAAS;YACX,CAAC;QACH,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACxD,IAAI,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAAE,SAAS;YAClD,IAAI,UAAU,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAAE,SAAS;YACtD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,EAAE,GAAG,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;gBACjD,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC;oBAAE,SAAS;YAC5C,CAAC;YACD,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,EAAE,GAAG,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;gBACjD,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC;oBAAE,SAAS;YAC9C,CAAC;YAED,IAAI,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;gBAAE,SAAS;YAEhD,IAAI,cAAc,EAAE,CAAC;gBACnB,6DAA6D;gBAC7D,8DAA8D;gBAC9D,MAAM,EAAE,GAAG,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;gBACjD,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;gBAChC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;gBACzB,MAAM,CAAC,SAAS,EAAE,CAAC;gBACnB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;gBAC7C,MAAM,CAAC,IAAI,EAAE,CAAC;gBACd,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,CAAC,gBAAgB,EAAE,CAAC,KAAK,CAAC,CAAC;gBAClC,SAAS;YACX,CAAC;YAED,MAAM,CAAC,IAAI,EAAE,CAAC;YACd,sDAAsD;YACtD,0DAA0D;YAC1D,iDAAiD;YACjD,IAAI,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC3E,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACxC,CAAC;YACD,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACrD,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC;gBAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACxD,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC7C,CAAC;YACD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAClC,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,OAAO,EAAE,CAAC;AACnB,CAAC,CAAC"}

package/dist/shape-cache-bitmap.d.ts

@@ -0,0 +1,42 @@
+import type { ElementBase } from "@oh-just-another/scene";
+/**
+ * Per-shape rasterised cache. Keyed by the shape's identity reference —
+ * since scene mutations always replace the shape object (`apply(scene,
+ * patch)` produces fresh references), a cache hit is guaranteed to reflect
+ * the exact rendered output of the cached version. Pan / zoom invalidation
+ * is the host's job: keep zoom in a small "bucket" (e.g. round to 0.1) and
+ * include it in the key.
+ *
+ * LRU-by-insertion-order with a count cap. Hosts can replace with their own
+ * cache by implementing the same `get` / `set` / `delete` surface.
+ */
+export interface ElementBitmapCache<V = unknown> {
+    get(shape: ElementBase, zoomBucket: number): V | undefined;
+    set(shape: ElementBase, zoomBucket: number, value: V): void;
+    delete(shape: ElementBase, zoomBucket: number): void;
+    clear(): void;
+    readonly size: number;
+}
+/**
+ * In-memory LRU cache. Operates on shape identity (reference) —
+ * a stale shape reference for the same id is a miss because the
+ * cached entry's `shapeRef !== shape`. That is the invalidation
+ * mechanism — no version field needed.
+ */
+export declare class InMemoryElementBitmapCache<V> implements ElementBitmapCache<V> {
+    private readonly entries;
+    private readonly cap;
+    constructor(cap?: number);
+    get size(): number;
+    get(shape: ElementBase, zoomBucket: number): V | undefined;
+    set(shape: ElementBase, zoomBucket: number, value: V): void;
+    delete(shape: ElementBase, zoomBucket: number): void;
+    clear(): void;
+}
+/**
+ * Quantise a continuous zoom value to a bucket. Buckets within a
+ * power-of-two range share a cache entry so small zoom adjustments
+ * don't blow the cache. `bucket = 2 ^ round(log2(zoom))`.
+ */
+export declare const zoomBucket: (zoom: number) => number;
+//# sourceMappingURL=shape-cache-bitmap.d.ts.map

package/dist/shape-cache-bitmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-cache-bitmap.d.ts","sourceRoot":"","sources":["../src/shape-cache-bitmap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAC3D,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAC5D,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAUD;;;;;GAKG;AACH,qBAAa,0BAA0B,CAAC,CAAC,CAAE,YAAW,kBAAkB,CAAC,CAAC,CAAC;IACzE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,GAAG,SAAM;IAIrB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAe1D,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAW3D,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAIpD,KAAK,IAAI,IAAI;CAGd;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,MAGzC,CAAC"}

package/dist/shape-cache-bitmap.js

@@ -0,0 +1,61 @@
+const keyFor = (shape, zoomBucket) => `${shape.id}@${zoomBucket}`;
+/**
+ * In-memory LRU cache. Operates on shape identity (reference) —
+ * a stale shape reference for the same id is a miss because the
+ * cached entry's `shapeRef !== shape`. That is the invalidation
+ * mechanism — no version field needed.
+ */
+export class InMemoryElementBitmapCache {
+    entries = new Map();
+    cap;
+    constructor(cap = 512) {
+        this.cap = cap;
+    }
+    get size() {
+        return this.entries.size;
+    }
+    get(shape, zoomBucket) {
+        const key = keyFor(shape, zoomBucket);
+        const e = this.entries.get(key);
+        if (!e)
+            return undefined;
+        if (e.shapeRef !== shape) {
+            // Reference changed → stale; evict so the slot is free.
+            this.entries.delete(key);
+            return undefined;
+        }
+        // Re-insert to mark as recently-used (Map preserves insert order).
+        this.entries.delete(key);
+        this.entries.set(key, e);
+        return e.value;
+    }
+    set(shape, zoomBucket, value) {
+        const key = keyFor(shape, zoomBucket);
+        if (this.entries.has(key))
+            this.entries.delete(key);
+        this.entries.set(key, { shapeRef: shape, value });
+        if (this.entries.size > this.cap) {
+            // Evict the oldest entry (first key in insertion order).
+            const oldest = this.entries.keys().next().value;
+            if (oldest !== undefined)
+                this.entries.delete(oldest);
+        }
+    }
+    delete(shape, zoomBucket) {
+        this.entries.delete(keyFor(shape, zoomBucket));
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+/**
+ * Quantise a continuous zoom value to a bucket. Buckets within a
+ * power-of-two range share a cache entry so small zoom adjustments
+ * don't blow the cache. `bucket = 2 ^ round(log2(zoom))`.
+ */
+export const zoomBucket = (zoom) => {
+    if (zoom <= 0)
+        return 1;
+    return 2 ** Math.round(Math.log2(zoom));
+};
+//# sourceMappingURL=shape-cache-bitmap.js.map

package/dist/shape-cache-bitmap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-cache-bitmap.js","sourceRoot":"","sources":["../src/shape-cache-bitmap.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,GAAG,CAAC,KAAkB,EAAE,UAAkB,EAAU,EAAE,CAChE,GAAG,KAAK,CAAC,EAAE,IAAI,UAAU,EAAE,CAAC;AAO9B;;;;;GAKG;AACH,MAAM,OAAO,0BAA0B;IACpB,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IACtC,GAAG,CAAS;IAE7B,YAAY,GAAG,GAAG,GAAG;QACnB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,KAAkB,EAAE,UAAkB;QACxC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QACzB,IAAI,CAAC,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YACzB,wDAAwD;YACxD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,mEAAmE;QACnE,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,KAAK,CAAC;IACjB,CAAC;IAED,GAAG,CAAC,KAAkB,EAAE,UAAkB,EAAE,KAAQ;QAClD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACtC,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,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAClD,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjC,yDAAyD;YACzD,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,MAAM,CAAC,KAAkB,EAAE,UAAkB;QAC3C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE;IACjD,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACxB,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1C,CAAC,CAAC"}

package/dist/shape-cache.d.ts

@@ -0,0 +1,40 @@
+import type { Bounds, ElementId } from "@oh-just-another/types";
+import { type Scene, type ElementBase } from "@oh-just-another/scene";
+/**
+ * Per-shape memo with object-identity invalidation. Cached value sticks
+ * until the underlying shape reference changes — and because every scene
+ * op (`updateElement` / `moveElement` / ...) returns a new shape object, the
+ * cache invalidates automatically without the caller threading versions
+ * through.
+ *
+ * Caches survive across frames; pair with `prune(scene)` after large
+ * deletions if memory matters. For ephemeral, single-render memos use
+ * a fresh `ElementCache` instance (cheap to construct).
+ */
+export declare class ElementCache<T> {
+    private readonly entries;
+    get(shape: ElementBase): T | undefined;
+    set(shape: ElementBase, value: T): T;
+    /**
+     * Lazy memo. Returns the cached value if `shape` is the same reference
+     * as the one we cached against; otherwise runs `compute`, stores the
+     * result, and returns it.
+     */
+    getOrCompute(shape: ElementBase, compute: (s: ElementBase) => T): T;
+    invalidate(id: ElementId): void;
+    clear(): void;
+    /** Drop entries whose shape is no longer in the scene. */
+    prune(scene: Scene): void;
+    get size(): number;
+}
+/**
+ * Shared module-level cache for world-space bounds. Used by `renderScene`
+ * for viewport culling and reusable from outside (hit-test, overlay) so
+ * a single computation amortizes across passes.
+ *
+ * `getElementWorldBounds` is pure — same shape ref → same bounds — so a
+ * by-identity cache is sound.
+ */
+export declare const sharedBoundsCache: ElementCache<Bounds>;
+export declare const cachedWorldBounds: (cache: ElementCache<Bounds>, shape: ElementBase) => Bounds;
+//# sourceMappingURL=shape-cache.d.ts.map

package/dist/shape-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-cache.d.ts","sourceRoot":"","sources":["../src/shape-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAyB,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE7F;;;;;;;;;;GAUG;AACH,qBAAa,YAAY,CAAC,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiE;IAEzF,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,CAAC,GAAG,SAAS;IAUtC,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC;IAKpC;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,CAAC,GAAG,CAAC;IAMnE,UAAU,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI;IAI/B,KAAK,IAAI,IAAI;IAIb,0DAA0D;IAC1D,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAMzB,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,YAAY,CAAC,MAAM,CAA8B,CAAC;AAElF,eAAO,MAAM,iBAAiB,GAAI,OAAO,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,WAAW,KAAG,MAClC,CAAC"}

package/dist/shape-cache.js

@@ -0,0 +1,67 @@
+import { getElementWorldBounds } from "@oh-just-another/scene";
+/**
+ * Per-shape memo with object-identity invalidation. Cached value sticks
+ * until the underlying shape reference changes — and because every scene
+ * op (`updateElement` / `moveElement` / ...) returns a new shape object, the
+ * cache invalidates automatically without the caller threading versions
+ * through.
+ *
+ * Caches survive across frames; pair with `prune(scene)` after large
+ * deletions if memory matters. For ephemeral, single-render memos use
+ * a fresh `ElementCache` instance (cheap to construct).
+ */
+export class ElementCache {
+    entries = new Map();
+    get(shape) {
+        const entry = this.entries.get(shape.id);
+        if (!entry)
+            return undefined;
+        if (entry.ref !== shape) {
+            this.entries.delete(shape.id);
+            return undefined;
+        }
+        return entry.value;
+    }
+    set(shape, value) {
+        this.entries.set(shape.id, { ref: shape, value });
+        return value;
+    }
+    /**
+     * Lazy memo. Returns the cached value if `shape` is the same reference
+     * as the one we cached against; otherwise runs `compute`, stores the
+     * result, and returns it.
+     */
+    getOrCompute(shape, compute) {
+        const cached = this.get(shape);
+        if (cached !== undefined)
+            return cached;
+        return this.set(shape, compute(shape));
+    }
+    invalidate(id) {
+        this.entries.delete(id);
+    }
+    clear() {
+        this.entries.clear();
+    }
+    /** Drop entries whose shape is no longer in the scene. */
+    prune(scene) {
+        for (const id of this.entries.keys()) {
+            if (!scene.elements.has(id))
+                this.entries.delete(id);
+        }
+    }
+    get size() {
+        return this.entries.size;
+    }
+}
+/**
+ * Shared module-level cache for world-space bounds. Used by `renderScene`
+ * for viewport culling and reusable from outside (hit-test, overlay) so
+ * a single computation amortizes across passes.
+ *
+ * `getElementWorldBounds` is pure — same shape ref → same bounds — so a
+ * by-identity cache is sound.
+ */
+export const sharedBoundsCache = new ElementCache();
+export const cachedWorldBounds = (cache, shape) => cache.getOrCompute(shape, getElementWorldBounds);
+//# sourceMappingURL=shape-cache.js.map

package/dist/shape-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-cache.js","sourceRoot":"","sources":["../src/shape-cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAgC,MAAM,wBAAwB,CAAC;AAE7F;;;;;;;;;;GAUG;AACH,MAAM,OAAO,YAAY;IACN,OAAO,GAAG,IAAI,GAAG,EAAsD,CAAC;IAEzF,GAAG,CAAC,KAAkB;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,GAAG,CAAC,KAAkB,EAAE,KAAQ;QAC9B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,KAAkB,EAAE,OAA8B;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACxC,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,UAAU,CAAC,EAAa;QACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,KAAY;QAChB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACrC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAyB,IAAI,YAAY,EAAU,CAAC;AAElF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAA2B,EAAE,KAAkB,EAAU,EAAE,CAC3F,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC"}

package/dist/shape-renderer.d.ts

@@ -0,0 +1,36 @@
+import type { ElementBase } from "@oh-just-another/scene";
+import type { RenderTarget } from "./render-target.js";
+/**
+ * Optional draw context passed to an {@link ElementRenderer}. Carries the
+ * current view `zoom` so a renderer can draw screen-constant features (e.g. a
+ * 1px hairline border that does NOT scale with zoom): a local stroke width of
+ * `1 / (zoom * shape.scale)` lands at one device pixel. Optional and additive —
+ * renderers that don't need it ignore the third argument, and callers that
+ * can't supply it (preview / export at 1:1) may omit it.
+ */
+export interface ElementRenderContext {
+    /** Current view scale (1.0 = 1:1). `world × zoom = screen px`. */
+    readonly zoom: number;
+}
+/**
+ * Draws a single shape onto `target`. The shape's `position` / `rotation` /
+ * `scale` have already been applied to the target — implementations draw in
+ * the shape's *local* coordinate space.
+ *
+ * Implementations should also apply style (fill / stroke / etc.) themselves;
+ * the renderer-core does not push styles globally because some shapes (e.g.
+ * `text`) extend the base `Style` with overlays.
+ */
+export type ElementRenderer<S extends ElementBase = ElementBase> = (shape: S, target: RenderTarget, ctx?: ElementRenderContext) => void;
+/**
+ * Register a renderer for a shape type. Plugins call this at module load.
+ * The kernel ships renderers for every built-in shape from `@oh-just-another/scene`
+ * — they are installed by `@oh-just-another/renderer-canvas` (and any other
+ * backend) on import.
+ */
+export declare const registerElementRenderer: <S extends ElementBase>(type: S["type"], renderer: ElementRenderer<S>) => void;
+/** Look up a registered renderer. Returns `undefined` for unknown types. */
+export declare const getElementRenderer: (type: string) => ElementRenderer | undefined;
+/** True if a renderer is registered for `type`. */
+export declare const hasElementRenderer: (type: string) => boolean;
+//# sourceMappingURL=shape-renderer.d.ts.map

package/dist/shape-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-renderer.d.ts","sourceRoot":"","sources":["../src/shape-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI,CACjE,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,YAAY,EACpB,GAAG,CAAC,EAAE,oBAAoB,KACvB,IAAI,CAAC;AAIV;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,WAAW,EAC3D,MAAM,CAAC,CAAC,MAAM,CAAC,EACf,UAAU,eAAe,CAAC,CAAC,CAAC,KAC3B,IAEF,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,eAAe,GAAG,SAA+B,CAAC;AAEpG,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,OAA6B,CAAC"}

package/dist/shape-renderer.js

@@ -0,0 +1,15 @@
+const registry = new Map();
+/**
+ * Register a renderer for a shape type. Plugins call this at module load.
+ * The kernel ships renderers for every built-in shape from `@oh-just-another/scene`
+ * — they are installed by `@oh-just-another/renderer-canvas` (and any other
+ * backend) on import.
+ */
+export const registerElementRenderer = (type, renderer) => {
+    registry.set(type, renderer);
+};
+/** Look up a registered renderer. Returns `undefined` for unknown types. */
+export const getElementRenderer = (type) => registry.get(type);
+/** True if a renderer is registered for `type`. */
+export const hasElementRenderer = (type) => registry.has(type);
+//# sourceMappingURL=shape-renderer.js.map

package/dist/shape-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-renderer.js","sourceRoot":"","sources":["../src/shape-renderer.ts"],"names":[],"mappings":"AA+BA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,IAAe,EACf,QAA4B,EACtB,EAAE;IACR,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,QAA2B,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAA+B,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAEpG,mDAAmD;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC"}