render-tag 0.1.8 → 0.1.9

package/lib/path/glyph-layout.js

@@ -2,9 +2,32 @@
  * 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 } from '../layout.js';
+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.
@@ -24,27 +47,131 @@ export function flattenSegments(root) {
     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 measure each via ctx.measureText.
- *     RTL segments have their grapheme order reversed before walking the path
- *     (so a left-to-right path walk produces correct visual order).
+ *  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 grapheme:
- *       p0 = path.getPointAtLength(offset)
- *       p1 = path.getPointAtLength(offset + width)
- *       rotation = atan2(p1.y - p0.y, p1.x - p0.x)
- *     A trailing kerning slack (sum-of-glyph-widths > whole-string width)
- *     can push the last glyph 1–2px past pathLength; clamp the end point
- *     to pathLength in that narrow case to avoid dropping the last glyph.
- *  5. If a glyph would extend past the path entirely, stop emitting.
+ *  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 } = input;
-    // 1. Pre-measure all graphemes, segment-by-segment.
+    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.
@@ -54,37 +181,17 @@ export function layoutGlyphsOnPath(input) {
     for (const seg of segments) {
         if (!seg.text)
             continue;
-        const graphemes = stringToArray(seg.text);
-        if (graphemes.length === 0)
-            continue;
-        if (seg.rtl)
-            graphemes.reverse();
-        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`;
-        // Track ribbon thickness: CSS line-height in px when set, else font size.
         const lh = seg.style.lineHeight > 0 ? seg.style.lineHeight : seg.style.fontSize;
         if (lh > maxLineHeight)
             maxLineHeight = lh;
-        // Per-glyph width via measureText (browsers honor letterSpacing here).
-        for (const g of graphemes) {
-            const m = ctx.measureText(g);
-            preGlyphs.push({
-                char: g,
-                width: m.width,
-                style: seg.style,
-                // Only ASCII space (U+0020) is justify-eligible. \n/\t/  and
-                // other Unicode whitespace must NOT expand — that would break
-                // no-break-space contract and treat <br>-synthesized newlines as
-                // expansible spaces.
-                isSpace: g === ' ',
-            });
-        }
+        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 glyph widths + letterSpacing per glyph).
+    // 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);
@@ -114,8 +221,16 @@ export function layoutGlyphsOnPath(input) {
         }
     }
     // 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);
@@ -126,7 +241,7 @@ export function layoutGlyphsOnPath(input) {
         let p1;
         if (endLen > pathLength) {
             // Clamp to pathLength only if the overshoot is within the kerning slack —
-            // matches konva's behavior to keep the last glyph from getting dropped.
+            // keeps the last glyph from getting dropped to a sub-px rounding miss.
             if (endLen - pathLength <= kerningSlack + 0.5) {
                 p1 = path.getPointAtLength(pathLength);
             }
@@ -141,15 +256,82 @@ export function layoutGlyphsOnPath(input) {
             break;
         const rotation = Math.atan2(p1.y - p0.y, p1.x - p0.x);
         glyphs.push({
-            char: g.char,
+            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 { glyphs, textWidth, pathLength, lineHeight: maxLineHeight };
+    return { x: minX, y: minY, width: maxX - minX, height: maxY - minY };
 }
 //# sourceMappingURL=glyph-layout.js.map

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

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

package/lib/path/index.d.ts

@@ -13,20 +13,25 @@
  *     align: 'center',
  *   });
  *
- * For finer control, mirror the main API's split:
+ * For finer control:
  *   const result = layoutTextOnPath({ html, path, align });
  *   drawTextOnPathLayout({ layout: result, ctx });
- * Use the split when you want to inspect / hit-test glyphs before drawing,
- * or render the same layout onto multiple targets.
  *
- * Out of scope for the first cut: text-shadow, gradient/background-clip text,
- * text-decoration (underline/line-through), per-glyph kerning callbacks.
- * Mixed-script BiDi shaping is not supported (matches the konva limit) — pure
- * RTL strings render correctly via CSS `direction: rtl` or the `dir` attribute.
+ * 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 } from './glyph-layout.js';
-export type { PathLike, GlyphPlacement, AlignMode };
+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;
@@ -34,6 +39,13 @@ export interface LayoutTextOnPathConfig {
     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.
@@ -41,23 +53,39 @@ export interface LayoutTextOnPathConfig {
     ctx?: CanvasRenderingContext2D;
 }
 export interface TextOnPathLayout {
-    /** Per-glyph placement records (origin point, rotation, style). */
+    /** 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 (CSS line-height in px when set,
-     * else the segment's font size). Use as the thickness for a background
-     * ribbon polygon around curved text.
+     * 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. The transform is saved/restored per glyph. */
+    /** Destination 2D context. Saved+restored around the whole batch. */
     ctx: CanvasRenderingContext2D;
 }
 export interface DrawTextOnPathConfig {
@@ -69,6 +97,8 @@ export interface DrawTextOnPathConfig {
     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;
 /**
@@ -84,13 +114,18 @@ export type DrawTextOnPathResult = TextOnPathLayout;
 export declare function layoutTextOnPath(config: LayoutTextOnPathConfig): TextOnPathLayout;
 /**
  * Draw a pre-computed layout onto a canvas context.
- * Each glyph is rendered with its own style; ctx state is saved/restored
- * around the whole batch so the caller's state is preserved.
+ *
+ * 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.
- * Equivalent to `drawTextOnPathLayout({ layout: layoutTextOnPath(...), ctx })`.
  */
 export declare function drawTextOnPath(config: DrawTextOnPathConfig): DrawTextOnPathResult;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/path/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;AAEpD,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;;;OAGG;IACH,GAAG,CAAC,EAAE,wBAAwB,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,sCAAsC;IACtC,MAAM,EAAE,gBAAgB,CAAC;IACzB,yEAAyE;IACzE,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;CACnB;AAED,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAEpD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,gBAAgB,CAmBjF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,0BAA0B,GAAG,IAAI,CAQ7E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAWjF"}
+{"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"}