render-tag 0.1.7 → 0.1.9

package/lib/path/glyph-layout.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Pure layout: walks styled segments and lays each grapheme along a path.
+ * No canvas rendering happens here — that's the caller's job. Reusable
+ * for hit-testing, debugging, alternate renderers (SVG, GPU).
+ *
+ * Joining-script support: graphemes from Arabic, Hebrew, Indic, Thai, Khmer,
+ * Myanmar and related scripts within a single segment are grouped into one
+ * "shaped run" placement. The browser's fillText/measureText then shapes the
+ * run as a unit (cursive joining, reordering, conjuncts) — something
+ * per-grapheme drawing cannot do.
+ */
+import type { ResolvedStyle, StyledNode } from '../types.js';
+import type { PathLike } from './svg-path.js';
+export interface Segment {
+    text: string;
+    style: ResolvedStyle;
+    /** True when this segment should be laid out right-to-left. */
+    rtl: boolean;
+}
+export interface GlyphPlacement {
+    /**
+     * Renderable text unit — usually a single grapheme cluster, but joining
+     * scripts (Arabic, Indic, Thai, Khmer, Myanmar, …) emit multi-grapheme runs
+     * here so the browser can shape them correctly during fillText.
+     */
+    char: string;
+    /** Origin of the glyph on the path (translate target before fillText). */
+    x: number;
+    y: number;
+    /** Tangent angle at the glyph origin, in radians. */
+    rotation: number;
+    /** Advance width of the glyph or shaped run. */
+    width: number;
+    /** Resolved style to apply when drawing this glyph. */
+    style: ResolvedStyle;
+    /** Font ascent above the baseline (px) — used for visual extent. */
+    ascent: number;
+    /** Font descent below the baseline (px). */
+    descent: number;
+    /** Distance from the start of the text along the path (px). */
+    pathOffset: number;
+    /** True when this placement is a shaped run, not a single grapheme. */
+    shaped: boolean;
+}
+export type AlignMode = 'left' | 'center' | 'right' | 'justify';
+/**
+ * Where the path runs relative to the rendered text.
+ *  - `alphabetic` (default) — path = text baseline; descenders drop below.
+ *  - `middle` — path runs through the vertical center of the text.
+ *  - `top` — path runs along the top of the text.
+ *  - `bottom` — path runs along the bottom (including descenders).
+ *  - `hanging` / `ideographic` — approximations of the matching CSS values.
+ */
+export type TextBaseline = 'alphabetic' | 'middle' | 'top' | 'bottom' | 'hanging' | 'ideographic';
+export interface LayoutInput {
+    segments: Segment[];
+    path: PathLike;
+    ctx: CanvasRenderingContext2D;
+    align: AlignMode;
+    textBaseline: TextBaseline;
+}
+export interface LayoutOutput {
+    glyphs: GlyphPlacement[];
+    /** Sum of glyph widths + letterSpacing (the natural width of the rendered text). */
+    textWidth: number;
+    pathLength: number;
+    /**
+     * Max line height across all segments. Resolved CSS line-height in px when
+     * set; otherwise the segment's font size. Useful as the ribbon thickness
+     * when drawing a background polygon around curved text.
+     */
+    lineHeight: number;
+    /**
+     * Visible bounding box of the rendered text in the layout's coordinate
+     * system. Computed as the union of each glyph's cell, where the cell is
+     * width × per-glyph line-height (CSS line-height in px when set, else
+     * font size) and rotated by the glyph's tangent. lineHeight is
+     * distributed above/below the baseline by the font's ascent/descent
+     * ratio. Per-glyph (not max-across) so mixed-size curve text doesn't
+     * inflate.
+     *
+     * Consumers (e.g. Polotno) use this to keep an element's width/height in
+     * sync with the rendered model. The library does not consume `bounds`
+     * itself — it's purely exposed for callers.
+     */
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** The textBaseline mode used for this layout (echoes the input). */
+    textBaseline: TextBaseline;
+}
+/**
+ * Returns the local-y of the alphabetic baseline given a textBaseline
+ * choice and a glyph's ascent/descent. All baseline-relative computations
+ * (decoration positions, background polygons, bounds cells) ADD this offset
+ * to their local-y so the path line through (0,0) corresponds to the
+ * requested baseline anchor.
+ */
+export declare function baselineLocalY(tb: TextBaseline, ascent: number, descent: number): number;
+/**
+ * Flatten a styled tree into a flat sequence of styled text segments.
+ * Walks in document order; concatenates text under nested inline elements.
+ * Each `#text` node contributes one segment with its resolved style.
+ */
+export declare function flattenSegments(root: StyledNode): Segment[];
+/**
+ * Lay out graphemes along a path. Pure: does not call ctx.fillText.
+ *
+ * Algorithm:
+ *  1. Per segment, split into graphemes and shaped runs, measure each.
+ *  2. Compute total natural width.
+ *  3. Pick a starting offset along the path based on `align`.
+ *  4. For each placement: get p0 / p1 from the path, rotation = atan2(p1-p0).
+ *     If a placement would overshoot, only allow it within kerning slack.
+ */
+export declare function layoutGlyphsOnPath(input: LayoutInput): LayoutOutput;
+//# sourceMappingURL=glyph-layout.d.ts.map

package/lib/path/glyph-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glyph-layout.d.ts","sourceRoot":"","sources":["../../src/path/glyph-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,KAAK,EAAE,QAAQ,EAAS,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,CAAC;IACrB,+DAA+D;IAC/D,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,KAAK,EAAE,aAAa,CAAC;IACrB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GACpB,YAAY,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAC;AAE3E,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,EAAE,wBAAwB,CAAC;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;OAYG;IACH,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,qEAAqE;IACrE,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAChD,MAAM,CASR;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,EAAE,CAY3D;AAwID;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CA8GnE"}

package/lib/path/glyph-layout.js

@@ -0,0 +1,337 @@
+/**
+ * Pure layout: walks styled segments and lays each grapheme along a path.
+ * No canvas rendering happens here — that's the caller's job. Reusable
+ * for hit-testing, debugging, alternate renderers (SVG, GPU).
+ *
+ * Joining-script support: graphemes from Arabic, Hebrew, Indic, Thai, Khmer,
+ * Myanmar and related scripts within a single segment are grouped into one
+ * "shaped run" placement. The browser's fillText/measureText then shapes the
+ * run as a unit (cursive joining, reordering, conjuncts) — something
+ * per-grapheme drawing cannot do.
+ */
+import { applyFont, getFontMetrics } from '../layout.js';
+import { stringToArray } from './grapheme.js';
+/**
+ * Returns the local-y of the alphabetic baseline given a textBaseline
+ * choice and a glyph's ascent/descent. All baseline-relative computations
+ * (decoration positions, background polygons, bounds cells) ADD this offset
+ * to their local-y so the path line through (0,0) corresponds to the
+ * requested baseline anchor.
+ */
+export function baselineLocalY(tb, ascent, descent) {
+    switch (tb) {
+        case 'alphabetic': return 0;
+        case 'middle': return (ascent - descent) / 2;
+        case 'top': return ascent;
+        case 'bottom': return -descent;
+        case 'hanging': return ascent * 0.8;
+        case 'ideographic': return -descent * 0.5;
+    }
+}
+/**
+ * Flatten a styled tree into a flat sequence of styled text segments.
+ * Walks in document order; concatenates text under nested inline elements.
+ * Each `#text` node contributes one segment with its resolved style.
+ */
+export function flattenSegments(root) {
+    const out = [];
+    function walk(node, inheritedRtl) {
+        const rtl = node.style.direction === 'rtl' || inheritedRtl;
+        if (node.tagName === '#text' && node.textContent) {
+            out.push({ text: node.textContent, style: node.style, rtl });
+            return;
+        }
+        for (const child of node.children)
+            walk(child, rtl);
+    }
+    walk(root, false);
+    return out;
+}
+// Unicode ranges where graphemes need shape-aware rendering. The browser's
+// fillText handles these correctly only when given the whole run at once,
+// not one grapheme at a time:
+//  - Hebrew (no joining, but RTL+BiDi)
+//  - Arabic + presentation forms (cursive joining)
+//  - N'Ko, Mandaic, Syriac, Thaana (joining/RTL)
+//  - Devanagari, Bengali, Gurmukhi, Gujarati, Oriya, Tamil, Telugu, Kannada,
+//    Malayalam, Sinhala (Indic reordering + conjuncts)
+//  - Thai, Lao (combining marks + word break)
+//  - Tibetan (stacking)
+//  - Myanmar (reordering + stacking)
+//  - Khmer (reordering + subscript consonants)
+// IMPORTANT: written with `\u` escapes only. Mixing literal RTL characters
+// confuses the regex parser at parse time — e.g. the precomposed `יִ` is
+// actually two code points (U+05D9 + U+05B4) and a literal range starting
+// at the second code point engulfs CJK / Hangul / Hiragana / Katakana,
+// causing `needsShaping('中')` to return true.
+const SHAPING_RE = new RegExp('[' +
+    '\\u0590-\\u05FF' + // Hebrew
+    '\\u0600-\\u06FF' + // Arabic
+    '\\u0700-\\u074F' + // Syriac
+    '\\u0750-\\u077F' + // Arabic Supplement
+    '\\u0780-\\u07BF' + // Thaana
+    '\\u07C0-\\u07FF' + // NKo
+    '\\u0800-\\u083F' + // Samaritan
+    '\\u0840-\\u085F' + // Mandaic
+    '\\u0860-\\u086F' + // Syriac Supplement
+    '\\u08A0-\\u08FF' + // Arabic Extended-A
+    '\\u0900-\\u097F' + // Devanagari
+    '\\u0980-\\u09FF' + // Bengali
+    '\\u0A00-\\u0A7F' + // Gurmukhi
+    '\\u0A80-\\u0AFF' + // Gujarati
+    '\\u0B00-\\u0B7F' + // Oriya
+    '\\u0B80-\\u0BFF' + // Tamil
+    '\\u0C00-\\u0C7F' + // Telugu
+    '\\u0C80-\\u0CFF' + // Kannada
+    '\\u0D00-\\u0D7F' + // Malayalam
+    '\\u0D80-\\u0DFF' + // Sinhala
+    '\\u0E00-\\u0E7F' + // Thai
+    '\\u0E80-\\u0EFF' + // Lao
+    '\\u0F00-\\u0FFF' + // Tibetan
+    '\\u1000-\\u109F' + // Myanmar
+    '\\u1780-\\u17FF' + // Khmer
+    '\\u1800-\\u18AF' + // Mongolian
+    '\\uFB1D-\\uFB4F' + // Hebrew Presentation Forms
+    '\\uFB50-\\uFDFF' + // Arabic Presentation Forms-A
+    '\\uFE70-\\uFEFF' + // Arabic Presentation Forms-B
+    ']');
+function needsShaping(s) {
+    return SHAPING_RE.test(s);
+}
+/**
+ * Split a single styled segment into PreGlyphs.
+ *
+ * Non-joining graphemes (Latin, CJK, …) emit one PreGlyph per grapheme so the
+ * curve can drive per-glyph rotation. Joining-script graphemes are grouped
+ * into runs (split at whitespace + style boundaries) so the browser can shape
+ * them correctly when we later call fillText on the run as a whole.
+ *
+ * For RTL segments, the RUN ORDER is reversed (not the graphemes inside a
+ * shaped run) — that way Arabic words still shape correctly while flowing in
+ * visual right-to-left order along an LTR path walk.
+ */
+function preGlyphsForSegment(ctx, seg) {
+    const graphemes = stringToArray(seg.text);
+    if (graphemes.length === 0)
+        return [];
+    applyFont(ctx, seg.style);
+    // Always assign — when the current segment's letterSpacing is 0/unset,
+    // we still need to reset the previous segment's value.
+    ctx.letterSpacing = `${seg.style.letterSpacing || 0}px`;
+    const { ascent, descent } = getFontMetrics(ctx, seg.style);
+    // Group graphemes into (shaped run | single non-shaped grapheme).
+    // Boundaries: shape-status change, ASCII whitespace.
+    const runs = [];
+    let currentShapedRun = '';
+    for (const g of graphemes) {
+        const isSpace = g === ' ';
+        if (needsShaping(g) && !isSpace) {
+            currentShapedRun += g;
+        }
+        else {
+            if (currentShapedRun) {
+                runs.push({ text: currentShapedRun, shaped: true, isSpace: false });
+                currentShapedRun = '';
+            }
+            runs.push({ text: g, shaped: false, isSpace });
+        }
+    }
+    if (currentShapedRun) {
+        runs.push({ text: currentShapedRun, shaped: true, isSpace: false });
+    }
+    // RTL: reverse run order. Don't reverse graphemes inside a shaped run —
+    // the browser will lay them out right-to-left during fillText.
+    if (seg.rtl)
+        runs.reverse();
+    // Measure each run with the current ctx font/letterSpacing.
+    const out = [];
+    for (const r of runs) {
+        const width = ctx.measureText(r.text).width;
+        out.push({
+            text: r.text,
+            width,
+            style: seg.style,
+            isSpace: r.isSpace,
+            ascent,
+            descent,
+            shaped: r.shaped,
+        });
+    }
+    return out;
+}
+/**
+ * Lay out graphemes along a path. Pure: does not call ctx.fillText.
+ *
+ * Algorithm:
+ *  1. Per segment, split into graphemes and shaped runs, measure each.
+ *  2. Compute total natural width.
+ *  3. Pick a starting offset along the path based on `align`.
+ *  4. For each placement: get p0 / p1 from the path, rotation = atan2(p1-p0).
+ *     If a placement would overshoot, only allow it within kerning slack.
+ */
+export function layoutGlyphsOnPath(input) {
+    const { segments, path, ctx, align, textBaseline } = input;
+    // 1. Pre-measure all placements (one per grapheme or shaped run).
+    // Caller's ctx state is mutated here (font, fontKerning, letterSpacing).
+    // The outer drawTextOnPath/drawTextOnPathLayout calls ctx.save before this
+    // and ctx.restore after, so the leak doesn't reach the caller.
+    const preGlyphs = [];
+    let measuredWholeWidth = 0;
+    let maxLineHeight = 0;
+    for (const seg of segments) {
+        if (!seg.text)
+            continue;
+        const lh = seg.style.lineHeight > 0 ? seg.style.lineHeight : seg.style.fontSize;
+        if (lh > maxLineHeight)
+            maxLineHeight = lh;
+        const segGlyphs = preGlyphsForSegment(ctx, seg);
+        if (segGlyphs.length === 0)
+            continue;
+        preGlyphs.push(...segGlyphs);
+        // Whole-segment width — kerning makes this < sum of per-glyph widths.
+        measuredWholeWidth += ctx.measureText(seg.text).width;
+    }
+    // 2. Sum natural width (sum of placement widths + letterSpacing per item).
+    let textWidth = 0;
+    for (const g of preGlyphs) {
+        textWidth += g.width + (g.style.letterSpacing || 0);
+    }
+    // Trim the last letterSpacing — it shouldn't trail.
+    if (preGlyphs.length > 0) {
+        textWidth -= preGlyphs[preGlyphs.length - 1].style.letterSpacing || 0;
+    }
+    // Kerning slack: how much the per-glyph sum can exceed the measured
+    // whole-string width. When the path is sized to match the visual text,
+    // we use this to allow up to N px of overshoot at the path's tail end.
+    const kerningSlack = Math.max(0, textWidth - measuredWholeWidth);
+    // 3. Starting offset + per-space extra (justify).
+    const pathLength = path.length;
+    let startOffset = 0;
+    let extraPerSpace = 0;
+    if (align === 'center') {
+        startOffset = Math.max(0, (pathLength - textWidth) / 2);
+    }
+    else if (align === 'right') {
+        startOffset = Math.max(0, pathLength - textWidth);
+    }
+    else if (align === 'justify') {
+        const spaceCount = preGlyphs.filter(g => g.isSpace).length;
+        if (spaceCount > 0 && pathLength > textWidth) {
+            extraPerSpace = (pathLength - textWidth) / spaceCount;
+        }
+    }
+    // 4. Walk the path.
+    // We track two cumulative offsets:
+    //  - `offset` is the path arc-length (used for path.getPointAtLength), and
+    //    advances by `effectiveWidth` (incl. justify extraPerSpace).
+    //  - `naturalOffset` is the glyph's position in NATURAL text-space
+    //    [0, textWidth]. Used as `pathOffset` for gradient slicing — must NOT
+    //    include extraPerSpace, otherwise late justified glyphs map past the
+    //    gradient's last stop.
+    const glyphs = [];
+    let offset = startOffset;
+    let naturalOffset = 0;
+    for (let i = 0; i < preGlyphs.length; i++) {
+        const g = preGlyphs[i];
+        const effectiveWidth = g.width + (g.isSpace ? extraPerSpace : 0);
+        const p0 = path.getPointAtLength(offset);
+        if (!p0)
+            break;
+        let endLen = offset + effectiveWidth;
+        let p1;
+        if (endLen > pathLength) {
+            // Clamp to pathLength only if the overshoot is within the kerning slack —
+            // keeps the last glyph from getting dropped to a sub-px rounding miss.
+            if (endLen - pathLength <= kerningSlack + 0.5) {
+                p1 = path.getPointAtLength(pathLength);
+            }
+            else {
+                break;
+            }
+        }
+        else {
+            p1 = path.getPointAtLength(endLen);
+        }
+        if (!p1)
+            break;
+        const rotation = Math.atan2(p1.y - p0.y, p1.x - p0.x);
+        glyphs.push({
+            char: g.text,
+            x: p0.x,
+            y: p0.y,
+            rotation,
+            width: g.width,
+            style: g.style,
+            ascent: g.ascent,
+            descent: g.descent,
+            pathOffset: naturalOffset,
+            shaped: g.shaped,
+        });
+        offset = endLen + (g.style.letterSpacing || 0);
+        naturalOffset += g.width + (g.style.letterSpacing || 0);
+    }
+    const bounds = computeBounds(glyphs, textBaseline);
+    return {
+        glyphs,
+        textWidth,
+        pathLength,
+        lineHeight: maxLineHeight,
+        bounds,
+        textBaseline,
+    };
+}
+/**
+ * Bounding box of the rendered text: union of each glyph's
+ * `width × per-glyph line-height` cell, rotated by the glyph's tangent.
+ *
+ * The cell height is the per-glyph line-height (CSS line-height when set,
+ * else font-size — Polotno's chosen metric). It is distributed
+ * ASYMMETRICALLY above/below the baseline using the font's natural
+ * ascent/descent ratio, so cap-height + ascender area is covered and the
+ * cell doesn't waste pixels below an empty descender. For a typical font
+ * with ascent ~25 / descent ~7 / lineHeight 32, the cell extends ~25px
+ * above and ~7px below the baseline, matching the painted glyph extent.
+ *
+ * Empty layouts return `{ x: 0, y: 0, width: 0, height: 0 }`.
+ */
+function computeBounds(glyphs, textBaseline) {
+    if (glyphs.length === 0)
+        return { x: 0, y: 0, width: 0, height: 0 };
+    let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
+    for (const g of glyphs) {
+        const lh = g.style.lineHeight > 0 ? g.style.lineHeight : g.style.fontSize;
+        // Distribute the lineHeight above/below the baseline by the font's
+        // natural ascent/descent ratio (CSS line-box half-leading semantics).
+        const fontHeight = g.ascent + g.descent;
+        const ascentShare = fontHeight > 0 ? g.ascent / fontHeight : 0.75;
+        const topFromBaseline = lh * ascentShare; // above baseline
+        const bottomFromBaseline = lh * (1 - ascentShare); // below baseline
+        // Shift by the local-y of the baseline so the cell stays correct under
+        // any textBaseline (e.g. 'middle' places the cell vertically centred
+        // on the path; 'top' moves the entire cell down).
+        const baseY = baselineLocalY(textBaseline, g.ascent, g.descent);
+        const top = baseY - topFromBaseline;
+        const bottom = baseY + bottomFromBaseline;
+        const c = Math.cos(g.rotation);
+        const s = Math.sin(g.rotation);
+        // Local cell: x in [0, width], y in [top, bottom]. Rotate + translate.
+        const corners = [
+            { x: g.x + (-s) * top, y: g.y + c * top },
+            { x: g.x + c * g.width + (-s) * top, y: g.y + s * g.width + c * top },
+            { x: g.x + c * g.width + (-s) * bottom, y: g.y + s * g.width + c * bottom },
+            { x: g.x + (-s) * bottom, y: g.y + c * bottom },
+        ];
+        for (const p of corners) {
+            if (p.x < minX)
+                minX = p.x;
+            if (p.y < minY)
+                minY = p.y;
+            if (p.x > maxX)
+                maxX = p.x;
+            if (p.y > maxY)
+                maxY = p.y;
+        }
+    }
+    return { x: minX, y: minY, width: maxX - minX, height: maxY - minY };
+}
+//# sourceMappingURL=glyph-layout.js.map

package/lib/path/glyph-layout.js.map

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

package/lib/path/grapheme.d.ts

@@ -0,0 +1,2 @@
+export declare function stringToArray(s: string): string[];
+//# sourceMappingURL=grapheme.d.ts.map

package/lib/path/grapheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grapheme.d.ts","sourceRoot":"","sources":["../../src/path/grapheme.ts"],"names":[],"mappings":"AAwBA,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAUjD"}

package/lib/path/grapheme.js

@@ -0,0 +1,39 @@
+/**
+ * Split a string into user-perceived characters (grapheme clusters).
+ * Uses Intl.Segmenter when available (handles ZWJ emoji sequences, regional
+ * indicators, combining marks). Falls back to a surrogate-pair-aware split
+ * for older environments.
+ *
+ * Equivalent in spirit to konva's stringToArray helper.
+ */
+let _segmenter;
+function getSegmenter() {
+    if (_segmenter !== undefined)
+        return _segmenter;
+    if (typeof Intl !== 'undefined' && typeof Intl.Segmenter === 'function') {
+        try {
+            _segmenter = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
+        }
+        catch {
+            _segmenter = null;
+        }
+    }
+    else {
+        _segmenter = null;
+    }
+    return _segmenter;
+}
+export function stringToArray(s) {
+    if (!s)
+        return [];
+    const seg = getSegmenter();
+    if (seg) {
+        const out = [];
+        for (const piece of seg.segment(s))
+            out.push(piece.segment);
+        return out;
+    }
+    // Fallback: handle UTF-16 surrogate pairs but not full grapheme clusters.
+    return Array.from(s);
+}
+//# sourceMappingURL=grapheme.js.map

package/lib/path/grapheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grapheme.js","sourceRoot":"","sources":["../../src/path/grapheme.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,IAAI,UAA6C,CAAC;AAElD,SAAS,YAAY;IACnB,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IAChD,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QACxE,IAAI,CAAC;YACH,UAAU,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;QAC1E,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAS;IACrC,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAClB,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5D,OAAO,GAAG,CAAC;IACb,CAAC;IACD,0EAA0E;IAC1E,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC"}

package/lib/path/index.d.ts

@@ -0,0 +1,131 @@
+/**
+ * render-tag/path — draw rich text along an SVG path on a 2D canvas.
+ *
+ * Reuses render-tag's HTML+CSS pipeline (parseHTML, resolveStylesFromCSS) and
+ * font primitives (applyFont) so styled spans, fonts, and colors come straight
+ * from the input HTML — no separate option surface.
+ *
+ *   import { drawTextOnPath } from 'render-tag/path';
+ *   drawTextOnPath({
+ *     html: '<b>Hello</b> <span style="color:red">world</span>',
+ *     path: 'M0,50 Q200,0 400,50',
+ *     ctx,
+ *     align: 'center',
+ *   });
+ *
+ * For finer control:
+ *   const result = layoutTextOnPath({ html, path, align });
+ *   drawTextOnPathLayout({ layout: result, ctx });
+ *
+ * Supported styles (matches the main renderer):
+ *   font-family / size / weight / style / kerning
+ *   color, -webkit-text-fill-color, -webkit-text-stroke (width + color), paint-order
+ *   background-color (span backgrounds drawn as curve-following polygons)
+ *   text-shadow (rotates with glyphs; multi-shadow supported)
+ *   text-decoration: underline / line-through / overline (solid/dotted/dashed/double/wavy)
+ *   text-decoration-color, text-decoration-style
+ *   background-clip:text + background-image:linear-gradient (gradient flows along the path)
+ *   letter-spacing, direction: rtl, dir="rtl"
+ *   Arabic / Hebrew / Indic / Thai / Khmer / Myanmar — shaped runs are
+ *   rendered as a unit so cursive joining and reordering work correctly.
+ */
+import { type PathLike } from './svg-path.js';
+import { type AlignMode, type GlyphPlacement, type TextBaseline } from './glyph-layout.js';
+export type { PathLike, GlyphPlacement, AlignMode, TextBaseline };
+export interface LayoutTextOnPathConfig {
+    /** Rich-text HTML (same dialect as render-tag's main API). */
+    html: string;
+    /** SVG path 'd' attribute string, or a PathLike implementation. */
+    path: string | PathLike;
+    /** Alignment of text along the path (default 'left'). */
+    align?: AlignMode;
+    /**
+     * Where the path runs relative to the rendered text. Default
+     * `'alphabetic'` (path = baseline, descenders drop below). Use `'middle'`
+     * for design-tool style "text centered on path" rendering. The choice
+     * also affects `bounds`.
+     */
+    textBaseline?: TextBaseline;
+    /**
+     * Optional measurement context. If omitted, an offscreen canvas is created.
+     * Pass one to share font measurement caches with other render-tag calls.
+     */
+    ctx?: CanvasRenderingContext2D;
+}
+export interface TextOnPathLayout {
+    /** Per-glyph (or per-shaped-run) placement records. */
+    glyphs: GlyphPlacement[];
+    /** Sum of per-glyph advances (the natural width of the rendered text). */
+    textWidth: number;
+    /** Total arc length of the path. */
+    pathLength: number;
+    /**
+     * Max line height across all segments. Useful as the thickness for a
+     * background ribbon polygon around curved text.
+     */
+    lineHeight: number;
+    /**
+     * Visible bounding box of the rendered text in the layout's coordinate
+     * system (same shape as `DOMRect`). Computed as the union of each glyph's
+     * `width × per-glyph line-height` cell, rotated by the glyph's tangent.
+     *
+     * Consumer-facing: render-tag does not consume `bounds` itself. Use it to
+     * keep a parent element's width/height in sync with the rendered curved
+     * text without re-walking the glyphs.
+     */
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** The textBaseline mode the layout was computed with. */
+    textBaseline: TextBaseline;
+}
+export interface DrawTextOnPathLayoutConfig {
+    /** Result from layoutTextOnPath(). */
+    layout: TextOnPathLayout;
+    /** Destination 2D context. Saved+restored around the whole batch. */
+    ctx: CanvasRenderingContext2D;
+}
+export interface DrawTextOnPathConfig {
+    /** Rich-text HTML (same dialect as render-tag's main API). */
+    html: string;
+    /** SVG path 'd' attribute string, or a PathLike implementation. */
+    path: string | PathLike;
+    /** Destination 2D context. */
+    ctx: CanvasRenderingContext2D;
+    /** Alignment of text along the path (default 'left'). */
+    align?: AlignMode;
+    /** Where the path runs relative to the text (default 'alphabetic'). */
+    textBaseline?: TextBaseline;
+}
+export type DrawTextOnPathResult = TextOnPathLayout;
+/**
+ * Compute glyph placements for rich text along a path, without drawing.
+ * Useful for inspection, hit-testing, or rendering the same layout multiple times.
+ * The HTML's CSS resolves against an infinite-width container, so wrapping
+ * does not happen — all text flows along the path as one logical line.
+ *
+ * The caller's ctx (when passed) has its `font`, `fontKerning`, and
+ * `letterSpacing` state saved+restored around the measurement work; nothing
+ * leaks to the caller.
+ */
+export declare function layoutTextOnPath(config: LayoutTextOnPathConfig): TextOnPathLayout;
+/**
+ * Draw a pre-computed layout onto a canvas context.
+ *
+ * Rendering passes (matching CSS painting order):
+ *   1. Span backgrounds (background-color, curve-following polygons)
+ *   2. Text shadows (per glyph, multi-shadow supported, rotates with glyph)
+ *   3. Glyph fill + stroke (paint-order aware; gradient text via slicing)
+ *   4. Text decoration (underline / line-through / overline)
+ *
+ * ctx state is saved+restored around the entire batch — nothing leaks.
+ */
+export declare function drawTextOnPathLayout(config: DrawTextOnPathLayoutConfig): void;
+/**
+ * Convenience: compute layout and draw in a single call.
+ */
+export declare function drawTextOnPath(config: DrawTextOnPathConfig): DrawTextOnPathResult;
+//# sourceMappingURL=index.d.ts.map

package/lib/path/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/path/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAWH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,yDAAyD;IACzD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,GAAG,CAAC,EAAE,wBAAwB,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,0DAA0D;IAC1D,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,WAAW,0BAA0B;IACzC,sCAAsC;IACtC,MAAM,EAAE,gBAAgB,CAAC;IACzB,qEAAqE;IACrE,GAAG,EAAE,wBAAwB,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,8BAA8B;IAC9B,GAAG,EAAE,wBAAwB,CAAC;IAC9B,yDAAyD;IACzD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,uEAAuE;IACvE,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAEpD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,gBAAgB,CAkBjF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,0BAA0B,GAAG,IAAI,CAa7E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAUjF"}