@oh-just-another/scene 0.58.0 → 0.60.0

package/dist/style.d.ts

@@ -13,9 +13,9 @@ export type LineJoin = "miter" | "round" | "bevel";
 export type StrokeAlign = "center" | "inside" | "outside";
 /**
  * Corner-rounding spec for shapes that support it (rectangle, container,
- * box arrow, …). Borrowed from standard's adaptive model:
+ * box arrow, …):
  *   `sharp`  — no rounding (sharp corners). Equivalent to omitting the
- *              field; kept for explicit serialisation.
+ *              field; lets the value be set explicitly.
  *   `round`  — rounded corners. Without `value`, falls back to the
  *              adaptive radius (fixed 32 px for big shapes, scales to
  *              25 % of the smaller side for shapes < 128 px so they

package/dist/text-runs.d.ts

@@ -0,0 +1,44 @@
+import type { TextStyle } from "./style.js";
+import type { TextElement } from "./shape.js";
+/**
+ * A styled segment of a text block. `text` is the raw substring; `style`
+ * is a PARTIAL overlay merged over the owning {@link TextElement}'s base
+ * `style` (element style wins for fields the run omits). Omitting `style`
+ * means "inherit the element style verbatim".
+ *
+ * Runs are an ADDITIVE overlay: the element's flat `text` stays the source
+ * of truth and MUST equal `runs.map(r => r.text).join("")`. A `TextElement`
+ * with no `runs` (or an empty array) renders exactly as before this feature
+ * existed — one uniform style — so plain-text scenes are untouched.
+ */
+export interface TextRun {
+    readonly text: string;
+    readonly style?: Partial<TextStyle>;
+}
+/** Concatenated raw text of a run list (the flat-text source of truth). */
+export declare const runsToText: (runs: readonly TextRun[]) => string;
+/**
+ * Drop empty-text runs and coalesce adjacent runs with identical styling.
+ * Returns a compact, canonical run list. An all-empty input yields `[]`.
+ */
+export declare const normalizeRuns: (runs: readonly TextRun[]) => TextRun[];
+/**
+ * The runs that fall inside the character range `[from, to)` of a text block,
+ * clipped at the range edges. Used by the renderer to split each visual line
+ * into per-style segments. Styles are preserved verbatim (still partial
+ * overlays over the element style).
+ */
+export declare const sliceRuns: (el: Pick<TextElement, "text" | "runs">, from: number, to: number) => TextRun[];
+/**
+ * Pure operation: apply a partial {@link TextStyle} overlay to the character
+ * range `[from, to)` of a text element, returning a NEW element. The flat
+ * `text` is never touched (invariant preserved). Existing runs are split at
+ * the range boundaries and the patch is merged into the overlapping portion;
+ * adjacent runs with equal styling are coalesced.
+ *
+ * When the result collapses to a single unstyled run spanning the whole text,
+ * `runs` is dropped entirely so the element reverts to a plain text block
+ * (keeps scenes minimal and round-trips cleanly). An empty range is a no-op.
+ */
+export declare const applyStyleToRange: (el: TextElement, from: number, to: number, patch: Partial<TextStyle>) => TextElement;
+//# sourceMappingURL=text-runs.d.ts.map

package/dist/text-runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-runs.d.ts","sourceRoot":"","sources":["../src/text-runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CACrC;AAED,2EAA2E;AAC3E,eAAO,MAAM,UAAU,GAAI,MAAM,SAAS,OAAO,EAAE,KAAG,MAA0C,CAAC;AAgBjG;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,SAAS,OAAO,EAAE,KAAG,OAAO,EAe/D,CAAC;AASF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GACpB,IAAI,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,EACtC,MAAM,MAAM,EACZ,IAAI,MAAM,KACT,OAAO,EAkBT,CAAC;AAcF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,GAC5B,IAAI,WAAW,EACf,MAAM,MAAM,EACZ,IAAI,MAAM,EACV,OAAO,OAAO,CAAC,SAAS,CAAC,KACxB,WAiDF,CAAC"}

package/dist/text-runs.js

@@ -0,0 +1,139 @@
+/** Concatenated raw text of a run list (the flat-text source of truth). */
+export const runsToText = (runs) => runs.map((r) => r.text).join("");
+/**
+ * Stable-ish key for a run style, used only to coalesce adjacent runs that
+ * carry identical styling. Sorts top-level keys so key order doesn't defeat
+ * the compare. A false "different" verdict only costs an extra (correct) run,
+ * never wrong rendering, so a shallow canonicalisation is sufficient.
+ */
+const styleKey = (style) => {
+    if (!style)
+        return "";
+    const entries = Object.entries(style)
+        .filter(([, v]) => v !== undefined)
+        .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    return JSON.stringify(entries);
+};
+/**
+ * Drop empty-text runs and coalesce adjacent runs with identical styling.
+ * Returns a compact, canonical run list. An all-empty input yields `[]`.
+ */
+export const normalizeRuns = (runs) => {
+    const out = [];
+    for (const run of runs) {
+        if (run.text === "")
+            continue;
+        const last = out[out.length - 1];
+        if (last !== undefined && styleKey(last.style) === styleKey(run.style)) {
+            out[out.length - 1] = {
+                text: last.text + run.text,
+                ...(last.style !== undefined ? { style: last.style } : {}),
+            };
+        }
+        else {
+            out.push(run);
+        }
+    }
+    return out;
+};
+/** The run list to start from: explicit `runs`, else one run spanning `text`. */
+const baseRuns = (el) => {
+    const runs = el.runs;
+    if (runs !== undefined && runs.length > 0)
+        return normalizeRuns(runs);
+    return el.text === "" ? [] : [{ text: el.text }];
+};
+/**
+ * The runs that fall inside the character range `[from, to)` of a text block,
+ * clipped at the range edges. Used by the renderer to split each visual line
+ * into per-style segments. Styles are preserved verbatim (still partial
+ * overlays over the element style).
+ */
+export const sliceRuns = (el, from, to) => {
+    const lo = Math.min(from, to);
+    const hi = Math.max(from, to);
+    const out = [];
+    let pos = 0;
+    for (const run of baseRuns(el)) {
+        const rStart = pos;
+        const rEnd = pos + run.text.length;
+        pos = rEnd;
+        const s = Math.max(rStart, lo);
+        const e = Math.min(rEnd, hi);
+        if (s >= e)
+            continue;
+        out.push({
+            text: run.text.slice(s - rStart, e - rStart),
+            ...(run.style !== undefined ? { style: run.style } : {}),
+        });
+    }
+    return out;
+};
+/** Shallow-merge `patch` over `base`, pruning keys explicitly set to undefined. */
+const mergeStyle = (base, patch) => {
+    const merged = { ...(base ?? {}), ...patch };
+    const entries = Object.entries(merged).filter(([, v]) => v !== undefined);
+    if (entries.length === 0)
+        return undefined;
+    const cleaned = Object.fromEntries(entries);
+    return cleaned;
+};
+/**
+ * Pure operation: apply a partial {@link TextStyle} overlay to the character
+ * range `[from, to)` of a text element, returning a NEW element. The flat
+ * `text` is never touched (invariant preserved). Existing runs are split at
+ * the range boundaries and the patch is merged into the overlapping portion;
+ * adjacent runs with equal styling are coalesced.
+ *
+ * When the result collapses to a single unstyled run spanning the whole text,
+ * `runs` is dropped entirely so the element reverts to a plain text block
+ * (keeps scenes minimal and round-trips cleanly). An empty range is a no-op.
+ */
+export const applyStyleToRange = (el, from, to, patch) => {
+    const lo = Math.max(0, Math.min(from, to));
+    const hi = Math.min(el.text.length, Math.max(from, to));
+    if (lo >= hi)
+        return el;
+    const out = [];
+    let pos = 0;
+    for (const run of baseRuns(el)) {
+        const rStart = pos;
+        const rEnd = pos + run.text.length;
+        pos = rEnd;
+        const midStart = Math.max(rStart, lo);
+        const midEnd = Math.min(rEnd, hi);
+        if (midStart >= midEnd) {
+            out.push(run);
+            continue;
+        }
+        if (rStart < midStart) {
+            out.push({
+                text: run.text.slice(0, midStart - rStart),
+                ...(run.style !== undefined ? { style: run.style } : {}),
+            });
+        }
+        const merged = mergeStyle(run.style, patch);
+        out.push({
+            text: run.text.slice(midStart - rStart, midEnd - rStart),
+            ...(merged !== undefined ? { style: merged } : {}),
+        });
+        if (midEnd < rEnd) {
+            out.push({
+                text: run.text.slice(midEnd - rStart),
+                ...(run.style !== undefined ? { style: run.style } : {}),
+            });
+        }
+    }
+    const normalized = normalizeRuns(out);
+    const only = normalized[0];
+    if (normalized.length === 1 &&
+        only !== undefined &&
+        (only.style === undefined || Object.keys(only.style).length === 0)) {
+        // Reverted to a single uniform style → shed the overlay entirely.
+        const { runs: _drop, ...rest } = el;
+        void _drop;
+        return rest;
+    }
+    return { ...el, runs: normalized };
+};
+//# sourceMappingURL=text-runs.js.map

package/dist/text-runs.js.map

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

package/dist/viewport.d.ts

@@ -1,12 +1,10 @@
 import type { Transform, Vec2 } from "@oh-just-another/types";
 /**
- * Visual style of the background grid (when `gridSize > 0`).
- *   `"lines"` — classic ruled grid (default; matches a standard grid).
- *   `"dots"`  — a dot at every grid intersection. Looks calmer for
- *              free-form diagramming (standard style).
+ * How the background grid is painted.
+ *   `"lines"` — ruled grid lines (default).
+ *   `"dots"`  — a dot at every grid intersection.
  *
- * Snap behaviour is identical between styles — only the paint
- * differs.
+ * Snap behaviour is identical between styles; only the paint differs.
  */
 export type GridStyle = "lines" | "dots";
 /**
@@ -26,37 +24,25 @@ export interface Viewport {
         readonly height: number;
     };
     /**
-     * Grid size in world units. When `undefined` / `0` the background
-     * grid is hidden. Renderers that paint a background grid use this
-     * value. Snap-to-grid uses it when present and falls back to
-     * {@link DEFAULT_GRID_SPACING} when the grid is hidden but snapping
-     * is still on (see {@link resolveSnapSpacing}).
-     */
-    readonly gridSize?: number;
-    /**
-     * How the grid is painted. Default `"lines"` for backwards-compat;
-     * snap math doesn't read this field. Renderers fall back to lines
-     * when the field is missing.
+     * Whether the background grid is drawn for this scene. Spacing is fixed
+     * at {@link DEFAULT_GRID_SPACING}; this flag controls only visibility.
      */
+    readonly gridEnabled: boolean;
+    /** How the grid is painted. Renderers fall back to lines when unset. */
     readonly gridStyle?: GridStyle;
     /**
-     * Extra programmatic opt-out for snapping. `undefined` is treated as ON
-     * (see {@link isSnapToGridEnabled}). Snapping additionally requires a
-     * *displayed* grid: it is active only while a grid is shown
-     * (`gridVisible && gridSize > 0`) — snapping to an invisible grid is
-     * confusing — so this flag only matters when a grid is on.
+     * Programmatic snap opt-out. `undefined` is treated as ON
+     * (see {@link isSnapToGridEnabled}). Snapping also requires the grid to be
+     * enabled — snapping to a hidden grid is confusing — so this flag only
+     * matters while `gridEnabled` is true.
      */
     readonly snapToGrid?: boolean;
 }
+/** World-unit spacing snap-to-grid rounds to (the fixed grid spacing). */
+export declare const resolveSnapSpacing: () => number;
 /**
- * Resolve the world-unit spacing snap-to-grid should round to. Uses the
- * visible `gridSize` when set, otherwise the {@link DEFAULT_GRID_SPACING}
- * fallback — so snapping keeps working when the grid is hidden.
- */
-export declare const resolveSnapSpacing: (viewport: Viewport) => number;
-/**
- * Whether snap-to-grid is enabled for this viewport. `undefined`
- * (legacy / fresh documents) counts as ON — the product default.
+ * Whether snap-to-grid is enabled for this viewport. `undefined` counts as
+ * ON — the product default.
  */
 export declare const isSnapToGridEnabled: (viewport: Viewport) => boolean;
 export declare const DEFAULT_VIEWPORT: Viewport;

package/dist/viewport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../src/viewport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAI9D;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,QAAQ,KAAG,MAC+B,CAAC;AAExF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,UAAU,QAAQ,KAAG,OAAsC,CAAC;AAEhG,eAAO,MAAM,gBAAgB,EAAE,QAU7B,CAAC;AAEH,gCAAgC;AAChC,eAAO,MAAM,gBAAgB,GAAI,UAAU,QAAQ,KAAG,SAMrD,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,GAAI,UAAU,QAAQ,KAAG,SACV,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,UAAU,QAAQ,EAAE,aAAa,IAAI,KAAG,QAM5D,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,UAAU,QAAQ,EAAE,QAAQ,MAAM,EAAE,aAAa,IAAI,KAAG,QAW9E,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,UAAU,QAAQ,EAAE,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,QAGzE,CAAC"}
+{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../src/viewport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAI9D;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,QAAO,MAA8B,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,UAAU,QAAQ,KAAG,OAAsC,CAAC;AAEhG,eAAO,MAAM,gBAAgB,EAAE,QAO7B,CAAC;AAEH,gCAAgC;AAChC,eAAO,MAAM,gBAAgB,GAAI,UAAU,QAAQ,KAAG,SAMrD,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,GAAI,UAAU,QAAQ,KAAG,SACV,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,UAAU,QAAQ,EAAE,aAAa,IAAI,KAAG,QAM5D,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,UAAU,QAAQ,EAAE,QAAQ,MAAM,EAAE,aAAa,IAAI,KAAG,QAW9E,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,UAAU,QAAQ,EAAE,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,QAGzE,CAAC"}

package/dist/viewport.js

@@ -1,14 +1,10 @@
 import { matrix } from "@oh-just-another/math";
 import { DEFAULT_GRID_SPACING } from "./constants.js";
+/** World-unit spacing snap-to-grid rounds to (the fixed grid spacing). */
+export const resolveSnapSpacing = () => DEFAULT_GRID_SPACING;
 /**
- * Resolve the world-unit spacing snap-to-grid should round to. Uses the
- * visible `gridSize` when set, otherwise the {@link DEFAULT_GRID_SPACING}
- * fallback — so snapping keeps working when the grid is hidden.
- */
-export const resolveSnapSpacing = (viewport) => viewport.gridSize && viewport.gridSize > 0 ? viewport.gridSize : DEFAULT_GRID_SPACING;
-/**
- * Whether snap-to-grid is enabled for this viewport. `undefined`
- * (legacy / fresh documents) counts as ON — the product default.
+ * Whether snap-to-grid is enabled for this viewport. `undefined` counts as
+ * ON — the product default.
  */
 export const isSnapToGridEnabled = (viewport) => viewport.snapToGrid ?? true;
 export const DEFAULT_VIEWPORT = Object.freeze({
@@ -16,11 +12,8 @@ export const DEFAULT_VIEWPORT = Object.freeze({
     zoom: 1,
     rotation: 0,
     size: { width: 0, height: 0 },
-    // Grid is ON by default — a positive `gridSize` is what `renderGrid` paints
-    // AND what snap-to-grid keys off (snap is active only while a grid is shown).
-    // Tune the default spacing in `constants.ts` (`DEFAULT_GRID_SPACING`); pass a
-    // scene with `gridSize: 0` (or omit it) for a gridless, snap-free canvas.
-    gridSize: DEFAULT_GRID_SPACING,
+    // Grid off by default; hosts enable it per scene via `gridEnabled`.
+    gridEnabled: false,
 });
 /** World → screen transform. */
 export const getWorldToScreen = (viewport) => {

package/dist/viewport.js.map

@@ -1 +1 @@
-{"version":3,"file":"viewport.js","sourceRoot":"","sources":["../src/viewport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"viewport.js","sourceRoot":"","sources":["../src/viewport.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAwCtD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAW,EAAE,CAAC,oBAAoB,CAAC;AAErE;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,QAAkB,EAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,IAAI,IAAI,CAAC;AAEhG,MAAM,CAAC,MAAM,gBAAgB,GAAa,MAAM,CAAC,MAAM,CAAC;IACtD,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACnB,IAAI,EAAE,CAAC;IACP,QAAQ,EAAE,CAAC;IACX,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;IAC7B,oEAAoE;IACpE,WAAW,EAAE,KAAK;CACnB,CAAC,CAAC;AAEH,gCAAgC;AAChC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAkB,EAAa,EAAE;IAChE,2DAA2D;IAC3D,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,gEAAgE;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAkB,EAAa,EAAE,CAChE,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,QAAkB,EAAE,WAAiB,EAAY,EAAE,CAAC,CAAC;IACzE,GAAG,QAAQ;IACX,GAAG,EAAE;QACH,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI;QACjD,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI;KAClD;CACF,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,QAAkB,EAAE,MAAc,EAAE,WAAiB,EAAY,EAAE;IACxF,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,GAAG,MAAM,CAAC;IACvC,gEAAgE;IAChE,OAAO;QACL,GAAG,QAAQ;QACX,IAAI,EAAE,OAAO;QACb,GAAG,EAAE;YACH,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM;YAC5D,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM;SAC7D;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,QAAkB,EAAE,KAAa,EAAE,MAAc,EAAY,EAAE,CAAC,CAAC;IACtF,GAAG,QAAQ;IACX,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;CACxB,CAAC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oh-just-another/scene",
-  "version": "0.58.0",
-  "description": "scene package",
+  "version": "0.60.0",
+  "description": "Immutable diagram scene model: elements, links, layers, patch-based operations, and a fast spatial index.",
   "license": "MIT",
   "author": "Rustam Garifulin <rustam@n69.in>",
   "repository": {
@@ -39,15 +39,16 @@
     "access": "public"
   },
   "dependencies": {
-    "fractional-keys": "^0.1.1",
+    "fractional-keys": "0.1.1",
     "@oh-just-another/types": "0.57.0",
-    "@oh-just-another/math": "0.57.0"
+    "@oh-just-another/math": "0.58.0"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
+    "bench": "vitest bench --run",
     "lint": "eslint src tests",
     "clean": "rm -rf dist *.tsbuildinfo"
   }