@hypercli/ui 0.1.1

package/dist/primitives/stack.js

@@ -0,0 +1,21 @@
+/**
+ * stack Primitive
+ *
+ * Joins lines vertically with configurable spacing and an optional
+ * prefix prepended to each line.
+ */
+/**
+ * Joins lines vertically with optional spacing and a per-line prefix.
+ *
+ * @param lines - The lines to stack vertically.
+ * @param options - Stacking configuration.
+ * @returns The joined multi-line string.
+ */
+export function stack(lines, options) {
+    const spacing = options?.spacing ?? 0;
+    const prefix = options?.prefix;
+    const processed = prefix ? lines.map((l) => prefix + l) : lines;
+    const separator = `\n${"\n".repeat(spacing)}`;
+    return processed.join(separator);
+}
+//# sourceMappingURL=stack.js.map

package/dist/primitives/stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.js","sourceRoot":"","sources":["../../src/primitives/stack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CAAC,KAAe,EAAE,OAAsB;IAC5D,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;IAE/B,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAEhE,MAAM,SAAS,GAAG,KAAK,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9C,OAAO,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/dist/primitives/styledText.d.ts

@@ -0,0 +1,36 @@
+/**
+ * styledText Primitive
+ *
+ * Applies semantic color tokens and typography attributes to text,
+ * respecting terminal capabilities (isDumb, noColor).
+ */
+import type { ColorTokens } from "../tokens/index.ts";
+/** Options for styling text with semantic color tokens and typography attributes. */
+export type StyledTextOptions = {
+    /** Foreground color token name. */
+    color?: keyof ColorTokens;
+    /** Background color token name. */
+    bg?: keyof ColorTokens;
+    /** Render text in bold weight. */
+    bold?: boolean;
+    /** Render text with reduced intensity. */
+    dim?: boolean;
+    /** Render text in italic style. */
+    italic?: boolean;
+    /** Render text with an underline. */
+    underline?: boolean;
+    /** Render text with a strikethrough line. */
+    strikethrough?: boolean;
+    /** Swap foreground and background colors. */
+    inverse?: boolean;
+};
+/**
+ * Applies semantic styling to text, respecting terminal capabilities.
+ * Dumb terminals receive no styling; noColor terminals keep typography but strip color.
+ *
+ * @param text - The text content to style.
+ * @param style - Styling options including color tokens and typography attributes.
+ * @returns The styled text string with ANSI escape codes applied.
+ */
+export declare function styledText(text: string, style: StyledTextOptions): string;
+//# sourceMappingURL=styledText.d.ts.map

package/dist/primitives/styledText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styledText.d.ts","sourceRoot":"","sources":["../../src/primitives/styledText.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,qFAAqF;AACrF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,WAAW,CAAC;IAC1B,mCAAmC;IACnC,EAAE,CAAC,EAAE,MAAM,WAAW,CAAC;IACvB,kCAAkC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,mCAAmC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM,CA4BzE"}

package/dist/primitives/styledText.js

@@ -0,0 +1,42 @@
+/**
+ * styledText Primitive
+ *
+ * Applies semantic color tokens and typography attributes to text,
+ * respecting terminal capabilities (isDumb, noColor).
+ */
+import { applyStyle } from "../render/index.js";
+import { getContext } from "./context.js";
+/**
+ * Applies semantic styling to text, respecting terminal capabilities.
+ * Dumb terminals receive no styling; noColor terminals keep typography but strip color.
+ *
+ * @param text - The text content to style.
+ * @param style - Styling options including color tokens and typography attributes.
+ * @returns The styled text string with ANSI escape codes applied.
+ */
+export function styledText(text, style) {
+    const ctx = getContext();
+    // Dumb terminals get no styling at all
+    if (ctx.capabilities.isDumb) {
+        return text;
+    }
+    const spec = {
+        bold: style.bold,
+        dim: style.dim,
+        italic: style.italic,
+        underline: style.underline,
+        strikethrough: style.strikethrough,
+        inverse: style.inverse,
+    };
+    // noColor: keep typography attributes but strip color
+    if (!ctx.capabilities.noColor) {
+        if (style.color) {
+            spec.color = ctx.tokens.color[style.color];
+        }
+        if (style.bg) {
+            spec.bg = ctx.tokens.color[style.bg];
+        }
+    }
+    return applyStyle(text, spec);
+}
+//# sourceMappingURL=styledText.js.map

package/dist/primitives/styledText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styledText.js","sourceRoot":"","sources":["../../src/primitives/styledText.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAsB1C;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAwB;IAChE,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IAEzB,uCAAuC;IACvC,IAAI,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,IAAI,GAAc;QACvB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,OAAO,EAAE,KAAK,CAAC,OAAO;KACtB,CAAC;IAEF,sDAAsD;IACtD,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YACjB,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;YACd,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC;IACF,CAAC;IAED,OAAO,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/primitives/symbol.d.ts

@@ -0,0 +1,15 @@
+/**
+ * symbol Primitive
+ *
+ * Returns the resolved symbol glyph (unicode or ascii) for a given
+ * semantic symbol name.
+ */
+import type { SymbolTokens } from "../tokens/index.ts";
+/**
+ * Returns the resolved glyph for a semantic symbol name.
+ *
+ * @param name - The symbol token name to resolve (e.g. `'tick'`, `'cross'`).
+ * @returns The resolved glyph string (unicode or ascii depending on capabilities).
+ */
+export declare function symbol(name: keyof SymbolTokens): string;
+//# sourceMappingURL=symbol.d.ts.map

package/dist/primitives/symbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol.d.ts","sourceRoot":"","sources":["../../src/primitives/symbol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,YAAY,GAAG,MAAM,CAGvD"}

package/dist/primitives/symbol.js

@@ -0,0 +1,18 @@
+/**
+ * symbol Primitive
+ *
+ * Returns the resolved symbol glyph (unicode or ascii) for a given
+ * semantic symbol name.
+ */
+import { getContext } from "./context.js";
+/**
+ * Returns the resolved glyph for a semantic symbol name.
+ *
+ * @param name - The symbol token name to resolve (e.g. `'tick'`, `'cross'`).
+ * @returns The resolved glyph string (unicode or ascii depending on capabilities).
+ */
+export function symbol(name) {
+    const ctx = getContext();
+    return ctx.tokens.symbol[name];
+}
+//# sourceMappingURL=symbol.js.map

package/dist/primitives/symbol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol.js","sourceRoot":"","sources":["../../src/primitives/symbol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,IAAwB;IAC9C,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC"}

package/dist/primitives/truncate.d.ts

@@ -0,0 +1,23 @@
+/**
+ * truncate Primitive
+ *
+ * Truncates a string to a maximum visual width, with support for
+ * end, start, and middle truncation positions. ANSI-aware.
+ */
+/** Options for truncating text. */
+export type TruncateOptions = {
+    /** Where to truncate: `'end'` (default), `'start'`, or `'middle'`. */
+    position?: "end" | "middle" | "start";
+    /** Ellipsis string inserted at the truncation point. Defaults to the resolved symbol token. */
+    ellipsis?: string;
+};
+/**
+ * Truncates text to fit within a maximum visual width, inserting an ellipsis at the cut point.
+ *
+ * @param text - The text to truncate.
+ * @param maxWidth - Maximum visual width in columns.
+ * @param options - Truncation configuration.
+ * @returns The truncated text string, or the original if it already fits.
+ */
+export declare function truncate(text: string, maxWidth: number, options?: TruncateOptions): string;
+//# sourceMappingURL=truncate.d.ts.map

package/dist/primitives/truncate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../src/primitives/truncate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,mCAAmC;AACnC,MAAM,MAAM,eAAe,GAAG;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM,CA2E1F"}

package/dist/primitives/truncate.js

@@ -0,0 +1,99 @@
+/**
+ * truncate Primitive
+ *
+ * Truncates a string to a maximum visual width, with support for
+ * end, start, and middle truncation positions. ANSI-aware.
+ */
+import { ansiTruncate, stringWidth, stripAnsi } from "../render/index.js";
+import { getContext } from "./context.js";
+/**
+ * Truncates text to fit within a maximum visual width, inserting an ellipsis at the cut point.
+ *
+ * @param text - The text to truncate.
+ * @param maxWidth - Maximum visual width in columns.
+ * @param options - Truncation configuration.
+ * @returns The truncated text string, or the original if it already fits.
+ */
+export function truncate(text, maxWidth, options) {
+    const ctx = getContext();
+    const position = options?.position ?? "end";
+    const ellipsis = options?.ellipsis ?? ctx.tokens.symbol.ellipsis;
+    const currentWidth = stringWidth(text);
+    if (currentWidth <= maxWidth)
+        return text;
+    const ellipsisWidth = stringWidth(ellipsis);
+    if (position === "end") {
+        return ansiTruncate(text, maxWidth, ellipsis);
+    }
+    if (position === "start") {
+        // Keep the end of the string, prepend ellipsis
+        const targetWidth = maxWidth - ellipsisWidth;
+        if (targetWidth <= 0) {
+            return ellipsisWidth <= maxWidth ? ellipsis : "";
+        }
+        // For start truncation, work on plain text for simplicity
+        // (ANSI in the middle of a start-truncated string is edge-case)
+        const plain = stripAnsi(text);
+        // Walk backwards to find the cut point
+        let width = 0;
+        let cutIndex = plain.length;
+        for (let i = plain.length - 1; i >= 0; i--) {
+            const code = plain.codePointAt(i);
+            // Skip low surrogates
+            if (code >= 0xdc00 && code <= 0xdfff)
+                continue;
+            const charW = code > 0xffff ? 2 : code >= 0x1100 && isFullWidth(code) ? 2 : 1;
+            if (width + charW > targetWidth)
+                break;
+            width += charW;
+            cutIndex = i;
+        }
+        return ellipsis + plain.slice(cutIndex);
+    }
+    // Middle truncation: keep first half + ellipsis + last half
+    const targetWidth = maxWidth - ellipsisWidth;
+    if (targetWidth <= 0) {
+        return ellipsisWidth <= maxWidth ? ellipsis : "";
+    }
+    const plain = stripAnsi(text);
+    const firstHalfWidth = Math.ceil(targetWidth / 2);
+    const lastHalfWidth = Math.floor(targetWidth / 2);
+    // Find first half end
+    let width = 0;
+    let firstEnd = 0;
+    for (let i = 0; i < plain.length; i++) {
+        const code = plain.codePointAt(i);
+        if (code >= 0xdc00 && code <= 0xdfff)
+            continue;
+        const charW = code > 0xffff ? 2 : code >= 0x1100 && isFullWidth(code) ? 2 : 1;
+        if (width + charW > firstHalfWidth)
+            break;
+        width += charW;
+        firstEnd = i + (code > 0xffff ? 2 : 1);
+    }
+    // Find last half start (walk backwards)
+    width = 0;
+    let lastStart = plain.length;
+    for (let i = plain.length - 1; i >= 0; i--) {
+        const code = plain.codePointAt(i);
+        if (code >= 0xdc00 && code <= 0xdfff)
+            continue;
+        const charW = code > 0xffff ? 2 : code >= 0x1100 && isFullWidth(code) ? 2 : 1;
+        if (width + charW > lastHalfWidth)
+            break;
+        width += charW;
+        lastStart = i;
+    }
+    return plain.slice(0, firstEnd) + ellipsis + plain.slice(lastStart);
+}
+/** Checks whether a Unicode code point is a full-width character. */
+function isFullWidth(code) {
+    return ((code >= 0x1100 && code <= 0x115f) ||
+        (code >= 0x2e80 && code <= 0xa4cf) ||
+        (code >= 0xac00 && code <= 0xd7a3) ||
+        (code >= 0xf900 && code <= 0xfaff) ||
+        (code >= 0xfe10 && code <= 0xfe6f) ||
+        (code >= 0xff01 && code <= 0xff60) ||
+        (code >= 0xffe0 && code <= 0xffe6));
+}
+//# sourceMappingURL=truncate.js.map

package/dist/primitives/truncate.js.map

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

package/dist/primitives/wrap.d.ts

@@ -0,0 +1,23 @@
+/**
+ * wrap Primitive
+ *
+ * Word-wraps text to a maximum width, defaulting to the resolved
+ * layout.maxWidth token.
+ */
+/** Options for word-wrapping text. */
+export type WrapOptions = {
+    /** Break words that exceed the max width instead of only breaking at spaces. Defaults to `false`. */
+    hard?: boolean;
+    /** Trim trailing whitespace from each wrapped line. Defaults to `false`. */
+    trim?: boolean;
+};
+/**
+ * Word-wraps text to a maximum column width.
+ *
+ * @param text - The text to wrap.
+ * @param maxWidth - Maximum line width in columns. Defaults to the `layout.maxWidth` token.
+ * @param options - Wrapping configuration.
+ * @returns The wrapped text string.
+ */
+export declare function wrap(text: string, maxWidth?: number, options?: WrapOptions): string;
+//# sourceMappingURL=wrap.d.ts.map

package/dist/primitives/wrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../src/primitives/wrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,sCAAsC;AACtC,MAAM,MAAM,WAAW,GAAG;IACzB,qGAAqG;IACrG,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4EAA4E;IAC5E,IAAI,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CAenF"}

package/dist/primitives/wrap.js

@@ -0,0 +1,30 @@
+/**
+ * wrap Primitive
+ *
+ * Word-wraps text to a maximum width, defaulting to the resolved
+ * layout.maxWidth token.
+ */
+import { ansiWrap } from "../render/index.js";
+import { getContext } from "./context.js";
+/**
+ * Word-wraps text to a maximum column width.
+ *
+ * @param text - The text to wrap.
+ * @param maxWidth - Maximum line width in columns. Defaults to the `layout.maxWidth` token.
+ * @param options - Wrapping configuration.
+ * @returns The wrapped text string.
+ */
+export function wrap(text, maxWidth, options) {
+    const ctx = getContext();
+    const width = maxWidth ?? ctx.tokens.layout.maxWidth;
+    const hard = options?.hard ?? false;
+    let result = ansiWrap(text, width, hard);
+    if (options?.trim) {
+        result = result
+            .split("\n")
+            .map((l) => l.trimEnd())
+            .join("\n");
+    }
+    return result;
+}
+//# sourceMappingURL=wrap.js.map

package/dist/primitives/wrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap.js","sourceRoot":"","sources":["../../src/primitives/wrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAU1C;;;;;;;GAOG;AACH,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,QAAiB,EAAE,OAAqB;IAC1E,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,QAAQ,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;IACrD,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,KAAK,CAAC;IAEpC,IAAI,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAEzC,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;QACnB,MAAM,GAAG,MAAM;aACb,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;aACvB,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/render/ansi-utils.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ANSI-Aware String Operations
+ *
+ * String manipulation functions that understand ANSI escape sequences,
+ * ensuring styles are properly preserved, carried, and closed across
+ * truncation, padding, slicing, and wrapping operations.
+ */
+/**
+ * Truncates a string to `maxWidth` visual columns, appending an ellipsis if truncated.
+ * Preserves ANSI styling and properly closes any open styles at the truncation point.
+ *
+ * @param str - The string to truncate.
+ * @param maxWidth - Maximum visual width in terminal columns.
+ * @param ellipsis - Ellipsis string appended at the truncation point. Defaults to `''`.
+ * @returns The truncated string, or the original if it fits within `maxWidth`.
+ */
+export declare function ansiTruncate(str: string, maxWidth: number, ellipsis?: string): string;
+/**
+ * Pads a string to an exact visual width using spaces.
+ *
+ * @param str - The string to pad.
+ * @param width - Target visual width in terminal columns.
+ * @param align - Alignment: `'left'` (default), `'right'`, or `'center'`.
+ * @returns The padded string.
+ */
+export declare function ansiPad(str: string, width: number, align?: "left" | "right" | "center"): string;
+/**
+ * Slices a string by visual column positions, preserving active ANSI styles.
+ *
+ * Returns the substring from visual column `start` to `end` (exclusive),
+ * with any active styles from before the slice re-applied at the beginning
+ * and a reset appended at the end if styles were active.
+ *
+ * @param str - The string to slice.
+ * @param start - Start visual column (inclusive).
+ * @param end - End visual column (exclusive). Defaults to end of string.
+ * @returns The sliced substring with ANSI styles preserved.
+ */
+export declare function ansiSlice(str: string, start: number, end?: number): string;
+/**
+ * Word-wraps a string to `maxWidth` visual columns, preserving ANSI styles across line breaks.
+ *
+ * @param str - The string to wrap.
+ * @param maxWidth - Maximum visual width per line in terminal columns.
+ * @param hard - When `true`, breaks mid-word if a single word exceeds `maxWidth`. Defaults to `false`.
+ * @returns The wrapped string with `\n` inserted at break points.
+ */
+export declare function ansiWrap(str: string, maxWidth: number, hard?: boolean): string;
+//# sourceMappingURL=ansi-utils.d.ts.map

package/dist/render/ansi-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi-utils.d.ts","sourceRoot":"","sources":["../../src/render/ansi-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgFH;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,MAAM,CAkDjF;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CACtB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAM,GAAG,OAAO,GAAG,QAAiB,GACzC,MAAM,CAiBR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAgF1E;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,UAAQ,GAAG,MAAM,CAuB5E"}