@oh-just-another/renderer-core 0.57.0

package/dist/text-editing.d.ts

@@ -0,0 +1,81 @@
+import type { TextAlign } from "./render-target.js";
+/**
+ * Caret-aware text layout. Unlike {@link wrapText} (which collapses
+ * whitespace and is only good enough for *drawing*), this keeps every
+ * line as an exact substring of the source plus its `[start, end)`
+ * character offsets — so a caret index maps unambiguously to a line +
+ * column. Measurement is injected as a `measure(s) => width` callback
+ * so the same geometry can be computed against either backend's font
+ * metrics (Canvas2D `measureText` or WebGL2 MSDF advances).
+ *
+ * Convention for `\n`: a hard newline at source index `k` ends the
+ * current line at `end === k` (caret at `k` = end of line) and the next
+ * line starts at `start === k + 1` (caret at `k + 1` = start of next
+ * line). The `\n` itself never holds a caret.
+ */
+export interface LaidOutLine {
+    /** Exact source substring for this visual line (no whitespace collapsing). */
+    readonly text: string;
+    /** Source offset where the line begins (inclusive). */
+    readonly start: number;
+    /** Source offset where the line ends (exclusive; excludes a trailing `\n`). */
+    readonly end: number;
+    /** Measured width of `text` in CSS px. */
+    readonly width: number;
+}
+export interface EditableTextLayout {
+    readonly lines: readonly LaidOutLine[];
+    readonly lineHeight: number;
+    /** Width the lines are aligned within (maxWidth, or the widest line). */
+    readonly blockWidth: number;
+}
+export type MeasureText = (text: string) => number;
+export interface LayoutTextOptions {
+    readonly fontSize: number;
+    /** Wrap budget in CSS px. `undefined` → no wrap (split on `\n` only). */
+    readonly maxWidth?: number;
+    /** Line-height multiplier. Default 1.2 (matches the text renderer). */
+    readonly lineHeightFactor?: number;
+}
+/** Default multiplier from font size to line height (matches `drawText`). */
+export declare const DEFAULT_LINE_HEIGHT_FACTOR = 1.2;
+/**
+ * Lay out `text` into visual lines with exact source offsets. Always
+ * returns at least one (possibly empty) line.
+ */
+export declare const layoutText: (text: string, measure: MeasureText, options: LayoutTextOptions) => EditableTextLayout;
+export interface CaretGeometry {
+    /** Local x of the caret bar. */
+    readonly x: number;
+    /** Local y of the caret top (baseline-top line origin). */
+    readonly y: number;
+    /** Caret height (≈ font size). */
+    readonly height: number;
+    /** Index of the line the caret sits on. */
+    readonly line: number;
+}
+/**
+ * Local-space geometry of the caret for a given source `caret` offset.
+ * `align` must match the renderer's `textAlign`.
+ */
+export declare const caretGeometry: (layout: EditableTextLayout, caret: number, measure: MeasureText, fontSize: number, align: TextAlign) => CaretGeometry;
+/**
+ * Map a local-space point to the nearest source caret offset. Used for
+ * click-to-place-caret and drag-to-select.
+ */
+export declare const pointToCaretIndex: (layout: EditableTextLayout, point: {
+    readonly x: number;
+    readonly y: number;
+}, measure: MeasureText, align: TextAlign) => number;
+export interface SelectionRect {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * Local-space highlight rectangles covering the source range `[from, to)`
+ * (order-independent), one per visual line it spans.
+ */
+export declare const selectionRects: (layout: EditableTextLayout, from: number, to: number, measure: MeasureText, align: TextAlign) => readonly SelectionRect[];
+//# sourceMappingURL=text-editing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text-editing.d.ts","sourceRoot":"","sources":["../src/text-editing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAOpD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,6EAA6E;AAC7E,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAsE9C;;;GAGG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,MAAM,EACZ,SAAS,WAAW,EACpB,SAAS,iBAAiB,KACzB,kBAoBF,CAAC;AAuBF,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,kBAAkB,EAC1B,OAAO,MAAM,EACb,SAAS,WAAW,EACpB,UAAU,MAAM,EAChB,OAAO,SAAS,KACf,aAOF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,kBAAkB,EAC1B,OAAO;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACjD,SAAS,WAAW,EACpB,OAAO,SAAS,KACf,MAiBF,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,QAAQ,kBAAkB,EAC1B,MAAM,MAAM,EACZ,IAAI,MAAM,EACV,SAAS,WAAW,EACpB,OAAO,SAAS,KACf,SAAS,aAAa,EA6BxB,CAAC"}

package/dist/text-editing.js

@@ -0,0 +1,191 @@
+const req = (v) => {
+    if (v === undefined)
+        throw new Error("packages/renderer-core: index out of range");
+    return v;
+};
+/** Default multiplier from font size to line height (matches `drawText`). */
+export const DEFAULT_LINE_HEIGHT_FACTOR = 1.2;
+const wrapParagraph = (para, base, maxWidth, measure, out) => {
+    if (para === "") {
+        out.push({ text: "", start: base, end: base, width: 0 });
+        return;
+    }
+    // Word spans (non-whitespace runs) with offsets relative to `para`.
+    const words = [];
+    const re = /\S+/g;
+    let m;
+    while ((m = re.exec(para)) !== null)
+        words.push({ s: m.index, e: m.index + m[0].length });
+    if (words.length === 0) {
+        // Whitespace-only paragraph — keep it as one line so offsets survive.
+        out.push({ text: para, start: base, end: base + para.length, width: measure(para) });
+        return;
+    }
+    // `white-space: pre-wrap` + `overflow-wrap: break-word` (standard):
+    // preserve whitespace, wrap at word boundaries, and break a word that
+    // is itself wider than the line so narrowing the block always reflows
+    // (a single long word can't overflow forever). Lines are gapless
+    // slices of the source — inter-word whitespace at a soft break stays
+    // on the preceding line — so every character maps to exactly one line
+    // (clean caret offsets). First line starts at 0 (keeps leading
+    // whitespace); the last extends to the paragraph end (trailing ws).
+    let lineStart = 0;
+    const push = (start, end) => {
+        const text = para.slice(start, end);
+        out.push({ text, start: base + start, end: base + end, width: measure(text) });
+    };
+    let i = 0;
+    while (i < words.length) {
+        const w = req(words[i]);
+        if (measure(para.slice(lineStart, w.e)) <= maxWidth) {
+            i++; // word fits on the current line — keep it, try the next
+            continue;
+        }
+        if (w.s > lineStart) {
+            // Content precedes this word on the line → break before it. The
+            // whitespace up to its start stays on the current line (pre-wrap).
+            push(lineStart, w.s);
+            lineStart = w.s;
+            continue; // retry this word on the fresh line
+        }
+        // The word starts the line and alone overflows → break it by chars,
+        // keeping at least one char per line so we always make progress.
+        let e = w.s + 1;
+        while (e < w.e && measure(para.slice(lineStart, e + 1)) <= maxWidth)
+            e++;
+        if (e >= w.e) {
+            // Whole (remaining) word consumed — leave it on the current line
+            // and advance. Guards termination when the measurer is degenerate
+            // (e.g. a constant stub that never reports "fits").
+            i++;
+            continue;
+        }
+        push(lineStart, e);
+        lineStart = e;
+        w.s = e; // remainder of the word continues on the next line
+    }
+    // Last line keeps everything through the end of the paragraph.
+    push(lineStart, para.length);
+};
+/**
+ * Lay out `text` into visual lines with exact source offsets. Always
+ * returns at least one (possibly empty) line.
+ */
+export const layoutText = (text, measure, options) => {
+    const lineHeight = options.fontSize * (options.lineHeightFactor ?? DEFAULT_LINE_HEIGHT_FACTOR);
+    const lines = [];
+    let paraStart = 0;
+    for (let i = 0; i <= text.length; i++) {
+        if (i === text.length || text[i] === "\n") {
+            const para = text.slice(paraStart, i);
+            if (options.maxWidth === undefined) {
+                lines.push({ text: para, start: paraStart, end: i, width: measure(para) });
+            }
+            else {
+                wrapParagraph(para, paraStart, options.maxWidth, measure, lines);
+            }
+            paraStart = i + 1;
+        }
+    }
+    if (lines.length === 0)
+        lines.push({ text: "", start: 0, end: 0, width: 0 });
+    let widest = 0;
+    for (const l of lines)
+        widest = Math.max(widest, l.width);
+    const blockWidth = options.maxWidth ?? widest;
+    return { lines, lineHeight, blockWidth };
+};
+/** Left edge (local x) where a line's glyphs start, given the align. */
+const lineLeftX = (lineWidth, blockWidth, align) => {
+    if (align === "center")
+        return blockWidth / 2 - lineWidth / 2;
+    if (align === "right")
+        return blockWidth - lineWidth;
+    return 0;
+};
+/** Index of the line a caret offset falls on (handles boundaries). */
+const lineIndexForCaret = (layout, caret) => {
+    const { lines } = layout;
+    for (let i = 0; i < lines.length; i++) {
+        const l = req(lines[i]);
+        // Caret belongs to this line when it's within [start, end]; the
+        // upper bound is inclusive so end-of-line resolves here, while
+        // start-of-next-line (end + 1 for a hard `\n`) resolves to the
+        // next line on the following iteration.
+        if (caret <= l.end)
+            return i;
+    }
+    return lines.length - 1;
+};
+/**
+ * Local-space geometry of the caret for a given source `caret` offset.
+ * `align` must match the renderer's `textAlign`.
+ */
+export const caretGeometry = (layout, caret, measure, fontSize, align) => {
+    const i = lineIndexForCaret(layout, caret);
+    const line = req(layout.lines[i]);
+    const col = Math.max(0, Math.min(caret, line.end) - line.start);
+    const prefixWidth = col === 0 ? 0 : measure(line.text.slice(0, col));
+    const left = lineLeftX(line.width, layout.blockWidth, align);
+    return { x: left + prefixWidth, y: i * layout.lineHeight, height: fontSize, line: i };
+};
+/**
+ * Map a local-space point to the nearest source caret offset. Used for
+ * click-to-place-caret and drag-to-select.
+ */
+export const pointToCaretIndex = (layout, point, measure, align) => {
+    const { lines, lineHeight } = layout;
+    const i = Math.max(0, Math.min(lines.length - 1, Math.floor(point.y / lineHeight)));
+    const line = req(lines[i]);
+    const left = lineLeftX(line.width, layout.blockWidth, align);
+    // Walk columns, picking the boundary whose x is closest to point.x.
+    let best = 0;
+    let bestDist = Math.abs(left - point.x);
+    for (let col = 1; col <= line.text.length; col++) {
+        const x = left + measure(line.text.slice(0, col));
+        const d = Math.abs(x - point.x);
+        if (d < bestDist) {
+            bestDist = d;
+            best = col;
+        }
+    }
+    return line.start + best;
+};
+/**
+ * Local-space highlight rectangles covering the source range `[from, to)`
+ * (order-independent), one per visual line it spans.
+ */
+export const selectionRects = (layout, from, to, measure, align) => {
+    const lo = Math.min(from, to);
+    const hi = Math.max(from, to);
+    if (lo === hi)
+        return [];
+    const rects = [];
+    for (let i = 0; i < layout.lines.length; i++) {
+        const line = req(layout.lines[i]);
+        const a = Math.max(lo, line.start);
+        const b = Math.min(hi, line.end);
+        if (a > b)
+            continue;
+        if (a === b && !(lo <= line.start && hi > line.end)) {
+            // Empty intersection on this line, unless the selection spans the
+            // hard break past it (then show a thin trailing marker).
+            if (!(hi > line.end && lo <= line.end))
+                continue;
+        }
+        const left = lineLeftX(line.width, layout.blockWidth, align);
+        const xa = left + (a === line.start ? 0 : measure(line.text.slice(0, a - line.start)));
+        const xb = left + (b === line.start ? 0 : measure(line.text.slice(0, b - line.start)));
+        // A line whose break is inside the selection gets a small trailing
+        // sliver so multi-line selections read continuously.
+        const trailing = hi > line.end ? layout.lineHeight * 0.25 : 0;
+        rects.push({
+            x: xa,
+            y: i * layout.lineHeight,
+            width: Math.max(0, xb - xa) + trailing,
+            height: layout.lineHeight,
+        });
+    }
+    return rects;
+};
+//# sourceMappingURL=text-editing.js.map

package/dist/text-editing.js.map

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

package/dist/text-layout.d.ts

@@ -0,0 +1,44 @@
+import type { RenderTarget } from "./render-target.js";
+import type { TextShaper } from "./text-shaper.js";
+export interface WrapOptions {
+    /** Max width in CSS pixels. */
+    readonly maxWidth: number;
+    /** Font size in CSS pixels — used to derive line height. */
+    readonly fontSize: number;
+    /** Multiplier applied to font size to derive line height. Default: 1.2. */
+    readonly lineHeightFactor?: number;
+    /**
+     * Optional font family name — paired with `fontSize` to call
+     * `shaper.measure(text, { family, size })` when a `shaper` is
+     * supplied. Defaults to `"sans-serif"`. Has no effect when no
+     * shaper is in play (Canvas2D's `measureText` already knows the
+     * font via the host's prior `ctx.font = …` call).
+     */
+    readonly fontFamily?: string;
+    /**
+     * Optional `TextShaper` (WASM / harfbuzz / canvaskit) that
+     * replaces the default `target.measureText` path. When set,
+     * the wrap algorithm queries `shaper.measure(line, font)` per
+     * candidate line, so layouts stay deterministic across
+     * environments (server / headless / browser).
+     */
+    readonly shaper?: TextShaper;
+}
+export interface WrappedLine {
+    readonly text: string;
+    readonly width: number;
+}
+/**
+ * Greedy word-wrap by `target.measureText`. Words longer than `maxWidth` are
+ * placed on their own line and overflow horizontally — they are not broken.
+ * Whitespace runs are collapsed; newlines (`\n`) in the input force a break.
+ *
+ * The caller is responsible for having set the font on the target before this
+ * call. Returns an array of lines plus the effective `lineHeight` so callers
+ * can compute total layout height.
+ */
+export declare const wrapText: (text: string, target: RenderTarget, options: WrapOptions) => {
+    readonly lines: readonly WrappedLine[];
+    readonly lineHeight: number;
+};
+//# sourceMappingURL=text-layout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text-layout.d.ts","sourceRoot":"","sources":["../src/text-layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,GACnB,MAAM,MAAM,EACZ,QAAQ,YAAY,EACpB,SAAS,WAAW,KACnB;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAiDvE,CAAC"}

package/dist/text-layout.js

@@ -0,0 +1,57 @@
+/**
+ * Greedy word-wrap by `target.measureText`. Words longer than `maxWidth` are
+ * placed on their own line and overflow horizontally — they are not broken.
+ * Whitespace runs are collapsed; newlines (`\n`) in the input force a break.
+ *
+ * The caller is responsible for having set the font on the target before this
+ * call. Returns an array of lines plus the effective `lineHeight` so callers
+ * can compute total layout height.
+ */
+export const wrapText = (text, target, options) => {
+    const { maxWidth } = options;
+    const lineHeightFactor = options.lineHeightFactor ?? 1.2;
+    const out = [];
+    const fontFamily = options.fontFamily ?? "sans-serif";
+    const shaper = options.shaper;
+    const measure = shaper
+        ? (s) => shaper.measure(s, { family: fontFamily, size: options.fontSize }).width
+        : (s) => target.measureText(s).width;
+    for (const paragraph of text.split("\n")) {
+        if (paragraph === "") {
+            out.push({ text: "", width: 0 });
+            continue;
+        }
+        const words = paragraph.split(/\s+/).filter((w) => w.length > 0);
+        if (words.length === 0) {
+            out.push({ text: "", width: 0 });
+            continue;
+        }
+        const firstWord = words[0];
+        if (firstWord === undefined) {
+            out.push({ text: "", width: 0 });
+            continue;
+        }
+        let current = firstWord;
+        let currentWidth = measure(current);
+        for (let i = 1; i < words.length; i++) {
+            const word = words[i];
+            if (word === undefined)
+                continue;
+            const candidate = `${current} ${word}`;
+            const w = measure(candidate);
+            if (w <= maxWidth) {
+                current = candidate;
+                currentWidth = w;
+            }
+            else {
+                out.push({ text: current, width: currentWidth });
+                current = word;
+                currentWidth = measure(word);
+            }
+        }
+        out.push({ text: current, width: currentWidth });
+    }
+    const lineHeight = options.fontSize * lineHeightFactor;
+    return { lines: out, lineHeight };
+};
+//# sourceMappingURL=text-layout.js.map

package/dist/text-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-layout.js","sourceRoot":"","sources":["../src/text-layout.ts"],"names":[],"mappings":"AAiCA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,IAAY,EACZ,MAAoB,EACpB,OAAoB,EACqD,EAAE;IAC3E,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC7B,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,GAAG,CAAC;IAEzD,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,YAAY,CAAC;IACtD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,MAAM,OAAO,GAAG,MAAM;QACpB,CAAC,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK;QACxF,CAAC,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAE/C,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,IAAI,SAAS,KAAK,EAAE,EAAE,CAAC;YACrB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YACjC,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACjE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YACjC,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YACjC,SAAS;QACX,CAAC;QACD,IAAI,OAAO,GAAG,SAAS,CAAC;QACxB,IAAI,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAEpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,IAAI,KAAK,SAAS;gBAAE,SAAS;YACjC,MAAM,SAAS,GAAG,GAAG,OAAO,IAAI,IAAI,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;YAC7B,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;gBAClB,OAAO,GAAG,SAAS,CAAC;gBACpB,YAAY,GAAG,CAAC,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;gBACjD,OAAO,GAAG,IAAI,CAAC;gBACf,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,GAAG,gBAAgB,CAAC;IACvD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;AACpC,CAAC,CAAC"}

package/dist/text-shaper.d.ts

@@ -0,0 +1,53 @@
+import type { TextAlign, TextBaseline } from "./render-target.js";
+/**
+ * Text-shaping abstraction. Lets a host swap the default
+ * `canvas.measureText`-based path for a richer engine (HarfBuzz /
+ * ICU4X / harfbuzzjs / canvaskit) when consistent server-side ↔
+ * browser layout matters or when batching many measurements is the
+ * hot path.
+ *
+ * The kernel ships a `Canvas2DTextShaper` implementation that delegates to
+ * `ctx.measureText`. Hosts that need deterministic cross-environment layout
+ * can implement this interface and pass it via `EditorOptions.textShaper`.
+ */
+export interface TextShaper {
+    /**
+     * Measure a single line in the given font. Returns the advance
+     * width in CSS pixels. Hosts may also expose glyph runs for
+     * decoration positioning — the kernel only requires width today.
+     */
+    measure(text: string, font: ShaperFont): {
+        width: number;
+    };
+    /**
+     * Returns the glyph layout for richer renderers that want to draw the
+     * actual glyphs themselves. Not invoked by the built-in Canvas2D renderer.
+     */
+    shape?(text: string, font: ShaperFont): readonly ShapedGlyph[];
+}
+export interface ShaperFont {
+    readonly family: string;
+    readonly size: number;
+    readonly weight?: "normal" | "bold" | number;
+    readonly style?: "normal" | "italic";
+}
+export interface ShapedGlyph {
+    /** Glyph id in the resolved font (renderer-specific). */
+    readonly glyphId: number;
+    /** Advance width in CSS pixels. */
+    readonly advance: number;
+    /** X offset from the line origin. */
+    readonly x: number;
+    /** Y offset from the line baseline. */
+    readonly y: number;
+}
+export type { TextAlign, TextBaseline };
+/**
+ * Install a process-global text shaper. Subsequent `getActiveTextShaper()`
+ * calls (used by the built-in `drawText` renderer) return it; passing `null`
+ * reverts to the Canvas2D `target.measureText` path. Idempotent — last write
+ * wins.
+ */
+export declare const setActiveTextShaper: (shaper: TextShaper | null) => void;
+export declare const getActiveTextShaper: () => TextShaper | null;
+//# sourceMappingURL=text-shaper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text-shaper.d.ts","sourceRoot":"","sources":["../src/text-shaper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAE3D;;;OAGG;IACH,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,SAAS,WAAW,EAAE,CAAC;CAChE;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAGD,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAYxC;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,UAAU,GAAG,IAAI,KAAG,IAE/D,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAAO,UAAU,GAAG,IAAoB,CAAC"}

package/dist/text-shaper.js

@@ -0,0 +1,19 @@
+// Process-global active shaper. `wrapText` accepts an optional `shaper`
+// parameter, but the built-in `drawText` renderer in `built-in-renderers.ts`
+// is an `ElementRenderer<TextElement>` whose signature is `(shape, target)`
+// with no extra arg. Instead of threading a shaper through every
+// ElementRenderer, a module-level registry that `drawText` consults at call
+// time. Editor sets it via `setActiveTextShaper(options.textShaper)` on
+// construction.
+let activeShaper = null;
+/**
+ * Install a process-global text shaper. Subsequent `getActiveTextShaper()`
+ * calls (used by the built-in `drawText` renderer) return it; passing `null`
+ * reverts to the Canvas2D `target.measureText` path. Idempotent — last write
+ * wins.
+ */
+export const setActiveTextShaper = (shaper) => {
+    activeShaper = shaper;
+};
+export const getActiveTextShaper = () => activeShaper;
+//# sourceMappingURL=text-shaper.js.map

package/dist/text-shaper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-shaper.js","sourceRoot":"","sources":["../src/text-shaper.ts"],"names":[],"mappings":"AAiDA,wEAAwE;AACxE,6EAA6E;AAC7E,4EAA4E;AAC5E,iEAAiE;AACjE,4EAA4E;AAC5E,wEAAwE;AACxE,gBAAgB;AAEhB,IAAI,YAAY,GAAsB,IAAI,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAyB,EAAQ,EAAE;IACrE,YAAY,GAAG,MAAM,CAAC;AACxB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAsB,EAAE,CAAC,YAAY,CAAC"}

package/dist/tile-renderer.d.ts

@@ -0,0 +1,126 @@
+import type { Bounds, ElementId } from "@oh-just-another/types";
+/**
+ * Tile-based rendering scaffold. The scene is split into a fixed-size
+ * world-space grid; each tile is rasterised once into an
+ * OffscreenCanvas / ImageBitmap and re-composited on pan without
+ * re-rendering. Zoom changes invalidate the bucket.
+ *
+ * This file ships the constants and cache interface so backends can
+ * adopt the API.
+ */
+/** Side length of one tile in world units. */
+export declare const TILE_SIZE = 2048;
+/**
+ * Memory cap for cached tile bitmaps (bytes), adaptive per device.
+ *
+ * Formula: `min(256 MB, deviceMemoryGB × 64 MB)`.
+ *   • iPhone Safari (no deviceMemory; A15 = 6 cores)  → 2 GiB → 128 MB
+ *   • Android low-RAM (deviceMemory=2)                → 128 MB
+ *   • Android mid-range (deviceMemory=4)              → 256 MB
+ *   • Desktop (deviceMemory=8 / hardwareConcurrency=8+) → 256 MB (cap)
+ *   • Very low-end (deviceMemory=0.5)                  → 32 MB
+ *
+ * The adaptive cap caps the upper bound proportionally to device
+ * memory, leaving headroom for the rest of the JS heap.
+ *
+ * Evaluated once at module load — navigator state doesn't change during
+ * a session. Hosts that need a different cap can pass
+ * `new InMemoryTileCache(<custom bytes>)` directly.
+ */
+export declare const MAX_TILE_CACHE_BYTES: number;
+/**
+ * Below this zoom we drop to LOD: cache tiles render only AABBs
+ * (no stroke / text / detail) so 1 M+ shape scenes stay smooth.
+ */
+export declare const LOD_THRESHOLD = 0.25;
+export interface TileKey {
+    /** Tile column in world-space grid. */
+    readonly col: number;
+    /** Tile row in world-space grid. */
+    readonly row: number;
+    /** Zoom bucket (power of two). */
+    readonly zoom: number;
+}
+export interface TileCacheEntry<B = unknown> {
+    readonly key: TileKey;
+    readonly bitmap: B;
+    /** World bounds covered by this tile. */
+    readonly bounds: Bounds;
+    /** Bytes used by this bitmap (for LRU eviction accounting). */
+    readonly bytes: number;
+    /** Element ids currently visible in this tile (for invalidation). */
+    readonly elements: readonly ElementId[];
+}
+export interface TileCache<B = unknown> {
+    get(key: TileKey): TileCacheEntry<B> | undefined;
+    set(entry: TileCacheEntry<B>): void;
+    /**
+     * Drop any cached tile that contains the given shape id. Called
+     * by the editor when a shape's scene reference changes.
+     */
+    invalidateForElement(id: ElementId): void;
+    /**
+     * Drop any cached tile whose `bounds` intersect the given world
+     * rectangle. Used by the editor's patch hook when a shape is
+     * added (no previous id in the reverse index) or moved (the
+     * before/after AABB union covers both old and new tiles).
+     */
+    invalidateRect(rect: Bounds): void;
+    /**
+     * Convenience routing used by editor patch pipelines: dispatches
+     * to `invalidateForElement` (remove), `invalidateRect` (add), or
+     * both (move) based on which of `removedElementId` / `beforeBounds`
+     * / `afterBounds` are present.
+     */
+    invalidateForPatch(options: {
+        readonly removedElementId?: ElementId;
+        readonly beforeBounds?: Bounds;
+        readonly afterBounds?: Bounds;
+    }): void;
+    /** Total bytes currently held. */
+    readonly bytesUsed: number;
+    clear(): void;
+}
+/**
+ * Reference TileCache backed by a Map with LRU eviction by total
+ * bytes. Bitmap-agnostic — the eviction logic tracks the `bytes`
+ * field reported by the host; whatever stores ImageBitmap /
+ * OffscreenCanvas / SharedArrayBuffer is the host's call.
+ *
+ * Invalidation is shape-id-indexed: every `set` also updates a
+ * reverse index `Map<ElementId, Set<tileKey>>` so the editor's
+ * patch hook can call `invalidateForElement(id)` in O(touched tiles)
+ * instead of scanning every tile.
+ */
+export declare class InMemoryTileCache<B = unknown> implements TileCache<B> {
+    private readonly entries;
+    private readonly tilesByElement;
+    private bytes;
+    private readonly cap;
+    constructor(byteCap?: number);
+    get bytesUsed(): number;
+    get(key: TileKey): TileCacheEntry<B> | undefined;
+    set(entry: TileCacheEntry<B>): void;
+    invalidateForElement(elementId: ElementId): void;
+    invalidateRect(rect: Bounds): void;
+    clear(): void;
+    /**
+     * Convenience hook for the editor's patch pipeline. Looks at a
+     * scene Patch and invalidates touched tiles via the right
+     * cheap path:
+     *   • shape removed → invalidateForElement (id still in reverse index)
+     *   • shape added   → invalidateRect (no id yet — drop tiles that
+     *                     touch the new shape's bounds)
+     *   • shape moved   → both: removeForElement (old tiles) + rect
+     *                     (new bounds)
+     * Caller computes the bounds via `getElementWorldBounds(before|after)`
+     * since this package is pure and doesn't know about Element geometry.
+     */
+    invalidateForPatch(options: {
+        readonly removedElementId?: ElementId;
+        readonly beforeBounds?: Bounds;
+        readonly afterBounds?: Bounds;
+    }): void;
+    private evictIfOverCap;
+}
+//# sourceMappingURL=tile-renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tile-renderer.d.ts","sourceRoot":"","sources":["../src/tile-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;;;;;GAQG;AAEH,8CAA8C;AAC9C,eAAO,MAAM,SAAS,OAAO,CAAC;AAkC9B;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,QAGhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC,MAAM,WAAW,OAAO;IACtB,uCAAuC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACjD,GAAG,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACpC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAAC;IAC1C;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE;QAC1B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAC;QACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;KAC/B,GAAG,IAAI,CAAC;IACT,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,KAAK,IAAI,IAAI,CAAC;CACf;AAID;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,SAAS,CAAC,CAAC,CAAC;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAChE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqC;IACpE,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,OAAO,GAAE,MAA6B;IAIlD,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS;IAUhD,GAAG,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAoBnC,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAehD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAelC,KAAK,IAAI,IAAI;IAMb;;;;;;;;;;;OAWG;IACH,kBAAkB,CAChB,OAAO,EAAE;QACP,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAC;QACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;KAC/B,GACA,IAAI;IAMP,OAAO,CAAC,cAAc;CAUvB"}