@oh-just-another/scene 0.59.0 → 0.60.0

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oh-just-another/scene",
-  "version": "0.59.0",
+  "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>",