@hypercli/ui 0.1.1

package/dist/render/ansi-utils.js

@@ -0,0 +1,405 @@
+/**
+ * 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.
+ */
+import { stripAnsi } from "./strip.js";
+import { charWidth, stringWidth } from "./width.js";
+function parseSegments(str) {
+    const segments = [];
+    let i = 0;
+    while (i < str.length) {
+        // ANSI escape sequence
+        if (str.charCodeAt(i) === 0x1b && str[i + 1] === "[") {
+            let j = i + 2;
+            while (j < str.length) {
+                const ch = str.charCodeAt(j);
+                if ((ch >= 0x41 && ch <= 0x5a) || (ch >= 0x61 && ch <= 0x7a)) {
+                    segments.push({ type: "ansi", value: str.slice(i, j + 1) });
+                    i = j + 1;
+                    break;
+                }
+                j++;
+            }
+            if (j >= str.length) {
+                // Unterminated sequence, treat as text
+                segments.push({ type: "char", value: str.slice(i), width: 1 });
+                break;
+            }
+            continue;
+        }
+        // Regular character (handle surrogate pairs)
+        const code = str.codePointAt(i);
+        const charLen = code > 0xffff ? 2 : 1;
+        const ch = str.slice(i, i + charLen);
+        segments.push({ type: "char", value: ch, width: charWidth(code) });
+        i += charLen;
+    }
+    return segments;
+}
+/**
+ * Track which ANSI SGR styles are currently "open" by accumulating
+ * all SGR sequences encountered. Returns the concatenation of all
+ * active style sequences (for re-opening after a break).
+ */
+function collectOpenStyles(segments, upTo) {
+    // We track style state by replaying all SGR sequences up to the given index.
+    // A full reset (\x1b[0m or \x1b[m) clears everything.
+    const activeSequences = [];
+    for (let i = 0; i < upTo && i < segments.length; i++) {
+        const seg = segments[i];
+        if (seg.type === "ansi") {
+            const params = seg.value.slice(2, -1);
+            if (params === "" || params === "0") {
+                // Full reset
+                activeSequences.length = 0;
+            }
+            else {
+                activeSequences.push(seg.value);
+            }
+        }
+    }
+    return activeSequences.join("");
+}
+/**
+ * Check if any styles are active (non-reset SGR sequences have been applied).
+ */
+function hasActiveStyles(openStyles) {
+    return openStyles.length > 0;
+}
+/**
+ * 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 function ansiTruncate(str, maxWidth, ellipsis = "") {
+    const currentWidth = stringWidth(str);
+    if (currentWidth <= maxWidth)
+        return str;
+    const ellipsisWidth = stringWidth(ellipsis);
+    const targetWidth = maxWidth - ellipsisWidth;
+    if (targetWidth <= 0) {
+        // Ellipsis alone exceeds maxWidth; just return truncated ellipsis or empty
+        if (ellipsisWidth <= maxWidth)
+            return ellipsis;
+        return "";
+    }
+    const segments = parseSegments(str);
+    let width = 0;
+    let result = "";
+    let lastAnsiIndex = -1;
+    for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        if (seg.type === "ansi") {
+            result += seg.value;
+            lastAnsiIndex = i;
+            continue;
+        }
+        if (width + seg.width > targetWidth) {
+            // Close open styles, append ellipsis
+            const openStyles = collectOpenStyles(segments, i);
+            if (hasActiveStyles(openStyles)) {
+                result += "\x1b[0m";
+            }
+            result += ellipsis;
+            if (hasActiveStyles(openStyles)) {
+                result += openStyles;
+            }
+            // Find and append any remaining closing sequences
+            // Actually, we want to close styles after the ellipsis too
+            if (hasActiveStyles(openStyles)) {
+                result += "\x1b[0m";
+            }
+            return result;
+        }
+        result += seg.value;
+        width += seg.width;
+    }
+    return str;
+}
+/**
+ * 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 function ansiPad(str, width, align = "left") {
+    const currentWidth = stringWidth(str);
+    if (currentWidth >= width)
+        return str;
+    const padding = width - currentWidth;
+    switch (align) {
+        case "right":
+            return " ".repeat(padding) + str;
+        case "center": {
+            const left = Math.floor(padding / 2);
+            const right = padding - left;
+            return " ".repeat(left) + str + " ".repeat(right);
+        }
+        default:
+            return str + " ".repeat(padding);
+    }
+}
+/**
+ * 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 function ansiSlice(str, start, end) {
+    const segments = parseSegments(str);
+    const totalWidth = stringWidth(str);
+    const effectiveEnd = end !== undefined ? Math.min(end, totalWidth) : totalWidth;
+    if (start >= effectiveEnd)
+        return "";
+    let col = 0;
+    let result = "";
+    let inRange = false;
+    let preStyles = ""; // Styles active before the start position
+    for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        if (seg.type === "ansi") {
+            if (!inRange) {
+                // Track styles before our range
+                const params = seg.value.slice(2, -1);
+                if (params === "" || params === "0") {
+                    preStyles = "";
+                }
+                else {
+                    preStyles += seg.value;
+                }
+            }
+            else {
+                // Inside range, include the ANSI sequence
+                result += seg.value;
+            }
+            continue;
+        }
+        const nextCol = col + seg.width;
+        if (!inRange && nextCol > start) {
+            // Entering range — apply accumulated styles
+            inRange = true;
+            if (preStyles) {
+                result += preStyles;
+            }
+        }
+        if (inRange && col < effectiveEnd) {
+            if (nextCol <= effectiveEnd) {
+                result += seg.value;
+            }
+            // If this char would exceed end, skip it
+        }
+        col = nextCol;
+        if (col >= effectiveEnd && inRange) {
+            break;
+        }
+    }
+    // Close any open styles
+    if (preStyles || result.includes("\x1b[")) {
+        // Check if there are active styles by looking for non-reset SGR sequences
+        const allSegments = parseSegments(result);
+        const styles = [];
+        for (const s of allSegments) {
+            if (s.type === "ansi") {
+                const params = s.value.slice(2, -1);
+                if (params === "" || params === "0") {
+                    styles.length = 0;
+                }
+                else {
+                    styles.push(s.value);
+                }
+            }
+        }
+        // Also account for preStyles
+        if (preStyles) {
+            // preStyles were already injected into result, so they're already counted
+        }
+        if (styles.length > 0) {
+            result += "\x1b[0m";
+        }
+    }
+    return result;
+}
+/**
+ * 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 function ansiWrap(str, maxWidth, hard = false) {
+    // Process line-by-line (preserve existing newlines)
+    const inputLines = str.split("\n");
+    const outputLines = [];
+    for (const line of inputLines) {
+        if (stringWidth(line) <= maxWidth) {
+            outputLines.push(line);
+            continue;
+        }
+        if (hard) {
+            // Hard wrap: break at exact width
+            const wrapped = hardWrapLine(line, maxWidth);
+            outputLines.push(...wrapped);
+        }
+        else {
+            // Soft wrap: break at word boundaries
+            const wrapped = softWrapLine(line, maxWidth);
+            outputLines.push(...wrapped);
+        }
+    }
+    return outputLines.join("\n");
+}
+function hardWrapLine(line, maxWidth) {
+    const segments = parseSegments(line);
+    const lines = [];
+    let current = "";
+    let col = 0;
+    let activeStyles = [];
+    for (const seg of segments) {
+        if (seg.type === "ansi") {
+            current += seg.value;
+            const params = seg.value.slice(2, -1);
+            if (params === "" || params === "0") {
+                activeStyles = [];
+            }
+            else {
+                activeStyles.push(seg.value);
+            }
+            continue;
+        }
+        if (col + seg.width > maxWidth && col > 0) {
+            // Break here
+            if (activeStyles.length > 0) {
+                current += "\x1b[0m";
+            }
+            lines.push(current);
+            current = activeStyles.join("") + seg.value;
+            col = seg.width;
+        }
+        else {
+            current += seg.value;
+            col += seg.width;
+        }
+    }
+    if (current) {
+        lines.push(current);
+    }
+    return lines;
+}
+function softWrapLine(line, maxWidth) {
+    const segments = parseSegments(line);
+    const lines = [];
+    const words = [];
+    let currentWord = [];
+    let currentWordWidth = 0;
+    let pendingSpaces = [];
+    let pendingSpacesWidth = 0;
+    for (const seg of segments) {
+        if (seg.type === "ansi") {
+            currentWord.push(seg);
+            continue;
+        }
+        if (seg.value === " " || seg.value === "\t") {
+            if (currentWordWidth > 0) {
+                words.push({
+                    segments: [...pendingSpaces, ...currentWord],
+                    width: pendingSpacesWidth + currentWordWidth,
+                });
+                currentWord = [];
+                currentWordWidth = 0;
+                pendingSpaces = [];
+                pendingSpacesWidth = 0;
+            }
+            pendingSpaces.push(seg);
+            pendingSpacesWidth += seg.width;
+        }
+        else {
+            currentWord.push(seg);
+            currentWordWidth += seg.width;
+        }
+    }
+    // Final word
+    if (currentWordWidth > 0 || currentWord.length > 0) {
+        words.push({
+            segments: [...pendingSpaces, ...currentWord],
+            width: pendingSpacesWidth + currentWordWidth,
+        });
+    }
+    let currentLine = "";
+    let col = 0;
+    let activeStyles = [];
+    for (const word of words) {
+        // Calculate the visible width of just this word (excluding leading spaces if it starts a new line)
+        const wordVisibleWidth = word.width;
+        if (col > 0 && col + wordVisibleWidth > maxWidth) {
+            // Break: close styles, start new line
+            if (activeStyles.length > 0) {
+                currentLine += "\x1b[0m";
+            }
+            lines.push(currentLine);
+            // Start new line with active styles, skip leading spaces
+            currentLine = activeStyles.join("");
+            col = 0;
+            // Add word segments, skipping leading spaces
+            let skipSpaces = true;
+            for (const seg of word.segments) {
+                if (seg.type === "ansi") {
+                    currentLine += seg.value;
+                    const params = seg.value.slice(2, -1);
+                    if (params === "" || params === "0") {
+                        activeStyles = [];
+                    }
+                    else {
+                        activeStyles.push(seg.value);
+                    }
+                    continue;
+                }
+                if (skipSpaces && (seg.value === " " || seg.value === "\t")) {
+                    continue;
+                }
+                skipSpaces = false;
+                currentLine += seg.value;
+                col += seg.width;
+            }
+        }
+        else {
+            // Append word to current line
+            for (const seg of word.segments) {
+                if (seg.type === "ansi") {
+                    currentLine += seg.value;
+                    const params = seg.value.slice(2, -1);
+                    if (params === "" || params === "0") {
+                        activeStyles = [];
+                    }
+                    else {
+                        activeStyles.push(seg.value);
+                    }
+                }
+                else {
+                    currentLine += seg.value;
+                    col += seg.width;
+                }
+            }
+        }
+    }
+    if (currentLine || lines.length === 0) {
+        lines.push(currentLine);
+    }
+    return lines;
+}
+//# sourceMappingURL=ansi-utils.js.map

package/dist/render/ansi-utils.js.map

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

package/dist/render/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Rendering Engine
+ *
+ * ANSI SGR code generation, string width calculation, escape sequence
+ * stripping, and ANSI-aware string manipulation utilities.
+ */
+export { type StyleSpec, sgrOpen, sgrClose, applyStyle } from "./sgr.ts";
+export { stripAnsi, stripColor } from "./strip.ts";
+export { charWidth, stringWidth } from "./width.ts";
+export { ansiTruncate, ansiPad, ansiSlice, ansiWrap } from "./ansi-utils.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/render/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/render/index.js

@@ -0,0 +1,11 @@
+/**
+ * Rendering Engine
+ *
+ * ANSI SGR code generation, string width calculation, escape sequence
+ * stripping, and ANSI-aware string manipulation utilities.
+ */
+export { sgrOpen, sgrClose, applyStyle } from "./sgr.js";
+export { stripAnsi, stripColor } from "./strip.js";
+export { charWidth, stringWidth } from "./width.js";
+export { ansiTruncate, ansiPad, ansiSlice, ansiWrap } from "./ansi-utils.js";
+//# sourceMappingURL=index.js.map

package/dist/render/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAkB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/render/sgr.d.ts

@@ -0,0 +1,60 @@
+/**
+ * SGR (Select Graphic Rendition) Code Generation
+ *
+ * Maps style specifications to ANSI escape sequences for terminal styling.
+ * Supports 16-color names, 256-color indices, and truecolor hex values.
+ */
+/**
+ * Specification of terminal text styling attributes.
+ *
+ * Colors accept ANSI 16 names (`"red"`, `"cyan"`), 256-color indices
+ * as numeric strings (`"196"`), or truecolor hex (`"#ff0000"`, `"#f00"`).
+ */
+export type StyleSpec = {
+    /** Foreground color. Accepts a named color, 256-color index string, or `#hex`. */
+    color?: string | null;
+    /** Background color. Accepts a named color, 256-color index string, or `#hex`. */
+    bg?: string | null;
+    /** Bold / increased intensity. */
+    bold?: boolean;
+    /** Dim / decreased intensity. */
+    dim?: boolean;
+    /** Italic text (terminal support varies). */
+    italic?: boolean;
+    /** Underlined text. */
+    underline?: boolean;
+    /** Strikethrough text (terminal support varies). */
+    strikethrough?: boolean;
+    /** Swap foreground and background colors. */
+    inverse?: boolean;
+};
+/**
+ * Generate the opening SGR escape sequence for a style spec.
+ *
+ * Combines all attribute and color codes into a single sequence (e.g. `\x1b[1;31;4m`).
+ *
+ * @param style - The style specification to encode.
+ * @returns The opening ANSI escape sequence, or an empty string if no styles are set.
+ */
+export declare function sgrOpen(style: StyleSpec): string;
+/**
+ * Generate the closing SGR escape sequence that resets only the attributes
+ * set in the given style spec.
+ *
+ * Uses targeted reset codes (e.g. `22` for bold/dim, `39` for fg) rather
+ * than a full `\x1b[0m` reset, so surrounding styles are not disturbed.
+ *
+ * @param style - The style specification whose attributes should be reset.
+ * @returns The closing ANSI escape sequence, or an empty string if no styles were set.
+ */
+export declare function sgrClose(style: StyleSpec): string;
+/**
+ * Apply a style to text by wrapping it with the appropriate opening
+ * and closing SGR escape sequences.
+ *
+ * @param text  - The text to style.
+ * @param style - The style specification to apply.
+ * @returns The text wrapped in ANSI escape sequences.
+ */
+export declare function applyStyle(text: string, style: StyleSpec): string;
+//# sourceMappingURL=sgr.d.ts.map

package/dist/render/sgr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sgr.d.ts","sourceRoot":"","sources":["../../src/render/sgr.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG;IACvB,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,kFAAkF;IAClF,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,kCAAkC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iCAAiC;IACjC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oDAAoD;IACpD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AA4GF;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAsBhD;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAsCjD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CAIjE"}