@deepseek-harness-tui/dsh-tui 0.5.0

package/lib/types/ink/squash-text-nodes.d.ts

@@ -0,0 +1,30 @@
+import type { DOMElement } from './dom.js';
+import type { TextStyles } from './styles.js';
+/**
+ * A segment of text with its associated styles.
+ * Used for structured rendering without ANSI string transforms.
+ */
+export type StyledSegment = {
+    text: string;
+    styles: TextStyles;
+    hyperlink?: string;
+};
+/**
+ * Squash text nodes into styled segments, propagating styles down through the tree.
+ * This allows structured styling without relying on ANSI string transforms.
+ * @param node - the subtree root whose text nodes are collected.
+ * @param inheritedStyles - styles inherited from ancestors, merged with the node's own.
+ * @param inheritedHyperlink - the hyperlink inherited from ancestor ink-link elements.
+ * @param out - the array segments are appended to; defaults to a fresh array.
+ * @returns `out` containing one segment per non-empty text node.
+ */
+export declare function squashTextNodesToSegments(node: DOMElement, inheritedStyles?: TextStyles, inheritedHyperlink?: string, out?: StyledSegment[]): StyledSegment[];
+/**
+ * Squash text nodes into a plain string (without styles).
+ * Used for text measurement in layout calculations.
+ * @param node - the subtree root whose text nodes are concatenated.
+ * @returns the concatenated text content of every text node in the subtree.
+ */
+declare function squashTextNodes(node: DOMElement): string;
+export default squashTextNodes;
+//# sourceMappingURL=squash-text-nodes.d.ts.map

package/lib/types/ink/squash-text-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"squash-text-nodes.d.ts","sourceRoot":"","sources":["../../../src/ink/squash-text-nodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,UAAU,EAChB,eAAe,GAAE,UAAe,EAChC,kBAAkB,CAAC,EAAE,MAAM,EAC3B,GAAG,GAAE,aAAa,EAAO,GACxB,aAAa,EAAE,CAwCjB;AAED;;;;;GAKG;AACH,iBAAS,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAqBjD;AAED,eAAe,eAAe,CAAA"}

package/lib/types/ink/squash-text-nodes.js

@@ -0,0 +1,63 @@
+/**
+ * Squash text nodes into styled segments, propagating styles down through the tree.
+ * This allows structured styling without relying on ANSI string transforms.
+ * @param node - the subtree root whose text nodes are collected.
+ * @param inheritedStyles - styles inherited from ancestors, merged with the node's own.
+ * @param inheritedHyperlink - the hyperlink inherited from ancestor ink-link elements.
+ * @param out - the array segments are appended to; defaults to a fresh array.
+ * @returns `out` containing one segment per non-empty text node.
+ */
+export function squashTextNodesToSegments(node, inheritedStyles = {}, inheritedHyperlink, out = []) {
+    const mergedStyles = node.textStyles
+        ? { ...inheritedStyles, ...node.textStyles }
+        : inheritedStyles;
+    for (const childNode of node.childNodes) {
+        if (childNode === undefined) {
+            continue;
+        }
+        if (childNode.nodeName === '#text') {
+            if (childNode.nodeValue.length > 0) {
+                out.push({
+                    text: childNode.nodeValue,
+                    styles: mergedStyles,
+                    hyperlink: inheritedHyperlink,
+                });
+            }
+        }
+        else if (childNode.nodeName === 'ink-text' ||
+            childNode.nodeName === 'ink-virtual-text') {
+            squashTextNodesToSegments(childNode, mergedStyles, inheritedHyperlink, out);
+        }
+        else if (childNode.nodeName === 'ink-link') {
+            const href = childNode.attributes['href'];
+            squashTextNodesToSegments(childNode, mergedStyles, href || inheritedHyperlink, out);
+        }
+    }
+    return out;
+}
+/**
+ * Squash text nodes into a plain string (without styles).
+ * Used for text measurement in layout calculations.
+ * @param node - the subtree root whose text nodes are concatenated.
+ * @returns the concatenated text content of every text node in the subtree.
+ */
+function squashTextNodes(node) {
+    let text = '';
+    for (const childNode of node.childNodes) {
+        if (childNode === undefined) {
+            continue;
+        }
+        if (childNode.nodeName === '#text') {
+            text += childNode.nodeValue;
+        }
+        else if (childNode.nodeName === 'ink-text' ||
+            childNode.nodeName === 'ink-virtual-text') {
+            text += squashTextNodes(childNode);
+        }
+        else if (childNode.nodeName === 'ink-link') {
+            text += squashTextNodes(childNode);
+        }
+    }
+    return text;
+}
+export default squashTextNodes;

package/lib/types/ink/stringWidth.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Get the display width of a string as it would appear in a terminal.
+ *
+ * Uses Bun.stringWidth when available; otherwise falls back to the JS
+ * implementation above, which strips ANSI codes and handles emoji, wide
+ * characters, and zero-width combining marks.
+ * @param str - the string to measure.
+ * @returns the number of terminal cells the string occupies.
+ */
+export declare const stringWidth: (str: string) => number;
+//# sourceMappingURL=stringWidth.d.ts.map

package/lib/types/ink/stringWidth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringWidth.d.ts","sourceRoot":"","sources":["../../../src/ink/stringWidth.ts"],"names":[],"mappings":"AA2NA;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAElB,CAAA"}

package/lib/types/ink/stringWidth.js

@@ -0,0 +1,209 @@
+import emojiRegex from 'emoji-regex';
+import { eastAsianWidth } from 'get-east-asian-width';
+import stripAnsi from 'strip-ansi';
+import { getGraphemeSegmenter } from '../utils/intl.js';
+const EMOJI_REGEX = emojiRegex();
+/**
+ * Fallback JavaScript implementation of stringWidth when Bun.stringWidth is not available.
+ *
+ * Get the display width of a string as it would appear in a terminal.
+ *
+ * This is a more accurate alternative to the string-width package that correctly handles
+ * characters like ⚠ (U+26A0) which string-width incorrectly reports as width 2.
+ *
+ * The implementation uses eastAsianWidth directly with ambiguousAsWide: false,
+ * which correctly treats ambiguous-width characters as narrow (width 1) as
+ * recommended by the Unicode standard for Western contexts.
+ */
+function stringWidthJavaScript(str) {
+    if (typeof str !== 'string' || str.length === 0) {
+        return 0;
+    }
+    // Fast path: pure ASCII string (no ANSI codes, no wide chars)
+    let isPureAscii = true;
+    for (let i = 0; i < str.length; i++) {
+        const code = str.charCodeAt(i);
+        // Check for non-ASCII or ANSI escape (0x1b)
+        if (code >= 127 || code === 0x1b) {
+            isPureAscii = false;
+            break;
+        }
+    }
+    if (isPureAscii) {
+        // Count printable characters (exclude control chars)
+        let width = 0;
+        for (let i = 0; i < str.length; i++) {
+            const code = str.charCodeAt(i);
+            if (code > 0x1f) {
+                width++;
+            }
+        }
+        return width;
+    }
+    // Strip ANSI if escape character is present
+    if (str.includes('\x1b')) {
+        str = stripAnsi(str);
+        if (str.length === 0) {
+            return 0;
+        }
+    }
+    // Fast path: simple Unicode (no emoji, variation selectors, or joiners)
+    if (!needsSegmentation(str)) {
+        let width = 0;
+        for (const char of str) {
+            const codePoint = char.codePointAt(0);
+            if (!isZeroWidth(codePoint)) {
+                width += eastAsianWidth(codePoint, { ambiguousAsWide: false });
+            }
+        }
+        return width;
+    }
+    let width = 0;
+    for (const { segment: grapheme } of getGraphemeSegmenter().segment(str)) {
+        // Check for emoji first (most emoji sequences are width 2)
+        EMOJI_REGEX.lastIndex = 0;
+        if (EMOJI_REGEX.test(grapheme)) {
+            width += getEmojiWidth(grapheme);
+            continue;
+        }
+        // Calculate width for non-emoji graphemes
+        // For grapheme clusters (like Devanagari conjuncts with virama+ZWJ), only count
+        // the first non-zero-width character's width since the cluster renders as one glyph
+        for (const char of grapheme) {
+            const codePoint = char.codePointAt(0);
+            if (!isZeroWidth(codePoint)) {
+                width += eastAsianWidth(codePoint, { ambiguousAsWide: false });
+                break;
+            }
+        }
+    }
+    return width;
+}
+function needsSegmentation(str) {
+    for (const char of str) {
+        const cp = char.codePointAt(0);
+        // Emoji ranges
+        if (cp >= 0x1f300 && cp <= 0x1faff)
+            return true;
+        if (cp >= 0x2600 && cp <= 0x27bf)
+            return true;
+        if (cp >= 0x1f1e6 && cp <= 0x1f1ff)
+            return true;
+        // Variation selectors, ZWJ
+        if (cp >= 0xfe00 && cp <= 0xfe0f)
+            return true;
+        if (cp === 0x200d)
+            return true;
+    }
+    return false;
+}
+function getEmojiWidth(grapheme) {
+    // Regional indicators: single = 1, pair = 2
+    const first = grapheme.codePointAt(0);
+    if (first >= 0x1f1e6 && first <= 0x1f1ff) {
+        let count = 0;
+        for (const _ of grapheme)
+            count++;
+        return count === 1 ? 1 : 2;
+    }
+    // Incomplete keycap: digit/symbol + VS16 without U+20E3
+    if (grapheme.length === 2) {
+        const second = grapheme.codePointAt(1);
+        if (second === 0xfe0f &&
+            ((first >= 0x30 && first <= 0x39) || first === 0x23 || first === 0x2a)) {
+            return 1;
+        }
+    }
+    return 2;
+}
+function isZeroWidth(codePoint) {
+    // Fast path for common printable range
+    if (codePoint >= 0x20 && codePoint < 0x7f)
+        return false;
+    if (codePoint >= 0xa0 && codePoint < 0x0300)
+        return codePoint === 0x00ad;
+    // Control characters
+    if (codePoint <= 0x1f || (codePoint >= 0x7f && codePoint <= 0x9f))
+        return true;
+    // Zero-width and invisible characters
+    if ((codePoint >= 0x200b && codePoint <= 0x200d) || // ZW space/joiner
+        codePoint === 0xfeff || // BOM
+        (codePoint >= 0x2060 && codePoint <= 0x2064) // Word joiner etc.
+    ) {
+        return true;
+    }
+    // Variation selectors
+    if ((codePoint >= 0xfe00 && codePoint <= 0xfe0f) ||
+        (codePoint >= 0xe0100 && codePoint <= 0xe01ef)) {
+        return true;
+    }
+    // Combining diacritical marks
+    if ((codePoint >= 0x0300 && codePoint <= 0x036f) ||
+        (codePoint >= 0x1ab0 && codePoint <= 0x1aff) ||
+        (codePoint >= 0x1dc0 && codePoint <= 0x1dff) ||
+        (codePoint >= 0x20d0 && codePoint <= 0x20ff) ||
+        (codePoint >= 0xfe20 && codePoint <= 0xfe2f)) {
+        return true;
+    }
+    // Indic script combining marks (covers Devanagari through Malayalam)
+    if (codePoint >= 0x0900 && codePoint <= 0x0d4f) {
+        // Signs and vowel marks at start of each script block
+        const offset = codePoint & 0x7f;
+        if (offset <= 0x03)
+            return true; // Signs at block start
+        if (offset >= 0x3a && offset <= 0x4f)
+            return true; // Vowel signs, virama
+        if (offset >= 0x51 && offset <= 0x57)
+            return true; // Stress signs
+        if (offset >= 0x62 && offset <= 0x63)
+            return true; // Vowel signs
+    }
+    // Thai/Lao combining marks
+    // Note: U+0E32 (SARA AA), U+0E33 (SARA AM), U+0EB2, U+0EB3 are spacing vowels (width 1), not combining marks
+    if (codePoint === 0x0e31 || // Thai MAI HAN-AKAT
+        (codePoint >= 0x0e34 && codePoint <= 0x0e3a) || // Thai vowel signs (skip U+0E32, U+0E33)
+        (codePoint >= 0x0e47 && codePoint <= 0x0e4e) || // Thai vowel signs and marks
+        codePoint === 0x0eb1 || // Lao MAI KAN
+        (codePoint >= 0x0eb4 && codePoint <= 0x0ebc) || // Lao vowel signs (skip U+0EB2, U+0EB3)
+        (codePoint >= 0x0ec8 && codePoint <= 0x0ecd) // Lao tone marks
+    ) {
+        return true;
+    }
+    // Arabic formatting
+    if ((codePoint >= 0x0600 && codePoint <= 0x0605) ||
+        codePoint === 0x06dd ||
+        codePoint === 0x070f ||
+        codePoint === 0x08e2) {
+        return true;
+    }
+    // Surrogates, tag characters
+    if (codePoint >= 0xd800 && codePoint <= 0xdfff)
+        return true;
+    if (codePoint >= 0xe0000 && codePoint <= 0xe007f)
+        return true;
+    return false;
+}
+// Note: complex-script graphemes like Devanagari क्ष (ka+virama+ZWJ+ssa) render
+// as a single ligature glyph but occupy 2 terminal cells (wcwidth sums the base
+// consonants). Bun.stringWidth=2 matches terminal cell allocation, which is what
+// we need for cursor positioning — the JS fallback's grapheme-cluster width of 1
+// would desync Ink's layout from the terminal.
+//
+// Bun.stringWidth is resolved once at module scope rather than checked on every
+// call — typeof guards deopt property access and this is a hot path (~100k calls/frame).
+const bunStringWidth = typeof Bun !== 'undefined' && typeof Bun.stringWidth === 'function'
+    ? Bun.stringWidth
+    : null;
+const BUN_STRING_WIDTH_OPTS = { ambiguousIsNarrow: true };
+/**
+ * Get the display width of a string as it would appear in a terminal.
+ *
+ * Uses Bun.stringWidth when available; otherwise falls back to the JS
+ * implementation above, which strips ANSI codes and handles emoji, wide
+ * characters, and zero-width combining marks.
+ * @param str - the string to measure.
+ * @returns the number of terminal cells the string occupies.
+ */
+export const stringWidth = bunStringWidth
+    ? str => bunStringWidth(str, BUN_STRING_WIDTH_OPTS)
+    : stringWidthJavaScript;

package/lib/types/ink/styles.d.ts

@@ -0,0 +1,324 @@
+import { type LayoutNode } from './layout/node.js';
+import type { BorderStyle, BorderTextOptions } from './render-border.js';
+/** Template-literal type for rgb(r,g,b) color strings. */
+export type RGBColor = `rgb(${number},${number},${number})`;
+/** Template-literal type for hex color strings like `#ff8800`. */
+export type HexColor = `#${string}`;
+/** Template-literal type for 256-color strings like `ansi256(174)`. */
+export type Ansi256Color = `ansi256(${number})`;
+/** Named ANSI color strings, optionally bright variants. */
+export type AnsiColor = 'ansi:black' | 'ansi:red' | 'ansi:green' | 'ansi:yellow' | 'ansi:blue' | 'ansi:magenta' | 'ansi:cyan' | 'ansi:white' | 'ansi:blackBright' | 'ansi:redBright' | 'ansi:greenBright' | 'ansi:yellowBright' | 'ansi:blueBright' | 'ansi:magentaBright' | 'ansi:cyanBright' | 'ansi:whiteBright';
+/** Raw color value - not a theme key */
+export type Color = RGBColor | HexColor | Ansi256Color | AnsiColor;
+/**
+ * Structured text styling properties.
+ * Used to style text without relying on ANSI string transforms.
+ * Colors are raw values - theme resolution happens at the component layer.
+ */
+export type TextStyles = {
+    readonly color?: Color;
+    readonly backgroundColor?: Color;
+    readonly dim?: boolean;
+    readonly bold?: boolean;
+    readonly italic?: boolean;
+    readonly underline?: boolean;
+    readonly strikethrough?: boolean;
+    readonly inverse?: boolean;
+};
+/**
+ * Layout and text styles applied to an element: text wrapping, positioning,
+ * margins, padding, flex properties, dimensions, borders, gaps, and overflow.
+ * All properties are optional; unset ones keep their defaults.
+ */
+export type Styles = {
+    readonly textWrap?: 'wrap' | 'wrap-trim' | 'end' | 'middle' | 'truncate-end' | 'truncate' | 'truncate-middle' | 'truncate-start';
+    readonly position?: 'absolute' | 'relative';
+    readonly top?: number | `${number}%`;
+    readonly bottom?: number | `${number}%`;
+    readonly left?: number | `${number}%`;
+    readonly right?: number | `${number}%`;
+    /**
+     * Size of the gap between an element's columns.
+     */
+    readonly columnGap?: number;
+    /**
+     * Size of the gap between element's rows.
+     */
+    readonly rowGap?: number;
+    /**
+     * Size of the gap between an element's columns and rows. Shorthand for `columnGap` and `rowGap`.
+     */
+    readonly gap?: number;
+    /**
+     * Margin on all sides. Equivalent to setting `marginTop`, `marginBottom`, `marginLeft` and `marginRight`.
+     */
+    readonly margin?: number;
+    /**
+     * Horizontal margin. Equivalent to setting `marginLeft` and `marginRight`.
+     */
+    readonly marginX?: number;
+    /**
+     * Vertical margin. Equivalent to setting `marginTop` and `marginBottom`.
+     */
+    readonly marginY?: number;
+    /**
+     * Top margin.
+     */
+    readonly marginTop?: number;
+    /**
+     * Bottom margin.
+     */
+    readonly marginBottom?: number;
+    /**
+     * Left margin.
+     */
+    readonly marginLeft?: number;
+    /**
+     * Right margin.
+     */
+    readonly marginRight?: number;
+    /**
+     * Padding on all sides. Equivalent to setting `paddingTop`, `paddingBottom`, `paddingLeft` and `paddingRight`.
+     */
+    readonly padding?: number;
+    /**
+     * Horizontal padding. Equivalent to setting `paddingLeft` and `paddingRight`.
+     */
+    readonly paddingX?: number;
+    /**
+     * Vertical padding. Equivalent to setting `paddingTop` and `paddingBottom`.
+     */
+    readonly paddingY?: number;
+    /**
+     * Top padding.
+     */
+    readonly paddingTop?: number;
+    /**
+     * Bottom padding.
+     */
+    readonly paddingBottom?: number;
+    /**
+     * Left padding.
+     */
+    readonly paddingLeft?: number;
+    /**
+     * Right padding.
+     */
+    readonly paddingRight?: number;
+    /**
+     * This property defines the ability for a flex item to grow if necessary.
+     * See [flex-grow](https://css-tricks.com/almanac/properties/f/flex-grow/).
+     */
+    readonly flexGrow?: number;
+    /**
+     * It specifies the “flex shrink factor”, which determines how much the flex item will shrink relative to the rest of the flex items in the flex container when there isn’t enough space on the row.
+     * See [flex-shrink](https://css-tricks.com/almanac/properties/f/flex-shrink/).
+     */
+    readonly flexShrink?: number;
+    /**
+     * It establishes the main-axis, thus defining the direction flex items are placed in the flex container.
+     * See [flex-direction](https://css-tricks.com/almanac/properties/f/flex-direction/).
+     */
+    readonly flexDirection?: 'row' | 'column' | 'row-reverse' | 'column-reverse';
+    /**
+     * It specifies the initial size of the flex item, before any available space is distributed according to the flex factors.
+     * See [flex-basis](https://css-tricks.com/almanac/properties/f/flex-basis/).
+     */
+    readonly flexBasis?: number | string;
+    /**
+     * It defines whether the flex items are forced in a single line or can be flowed into multiple lines. If set to multiple lines, it also defines the cross-axis which determines the direction new lines are stacked in.
+     * See [flex-wrap](https://css-tricks.com/almanac/properties/f/flex-wrap/).
+     */
+    readonly flexWrap?: 'nowrap' | 'wrap' | 'wrap-reverse';
+    /**
+     * The align-items property defines the default behavior for how items are laid out along the cross axis (perpendicular to the main axis).
+     * See [align-items](https://css-tricks.com/almanac/properties/a/align-items/).
+     */
+    readonly alignItems?: 'flex-start' | 'center' | 'flex-end' | 'stretch';
+    /**
+     * It makes possible to override the align-items value for specific flex items.
+     * See [align-self](https://css-tricks.com/almanac/properties/a/align-self/).
+     */
+    readonly alignSelf?: 'flex-start' | 'center' | 'flex-end' | 'auto';
+    /**
+     * It defines the alignment along the main axis.
+     * See [justify-content](https://css-tricks.com/almanac/properties/j/justify-content/).
+     */
+    readonly justifyContent?: 'flex-start' | 'flex-end' | 'space-between' | 'space-around' | 'space-evenly' | 'center';
+    /**
+     * Width of the element in spaces.
+     * You can also set it in percent, which will calculate the width based on the width of parent element.
+     */
+    readonly width?: number | string;
+    /**
+     * Height of the element in lines (rows).
+     * You can also set it in percent, which will calculate the height based on the height of parent element.
+     */
+    readonly height?: number | string;
+    /**
+     * Sets a minimum width of the element.
+     */
+    readonly minWidth?: number | string;
+    /**
+     * Sets a minimum height of the element.
+     */
+    readonly minHeight?: number | string;
+    /**
+     * Sets a maximum width of the element.
+     */
+    readonly maxWidth?: number | string;
+    /**
+     * Sets a maximum height of the element.
+     */
+    readonly maxHeight?: number | string;
+    /**
+     * Set this property to `none` to hide the element.
+     */
+    readonly display?: 'flex' | 'none';
+    /**
+     * Add a border with a specified style.
+     * If `borderStyle` is `undefined` (which it is by default), no border will be added.
+     */
+    readonly borderStyle?: BorderStyle;
+    /**
+     * Determines whether top border is visible.
+     *
+     * @default true
+     */
+    readonly borderTop?: boolean;
+    /**
+     * Determines whether bottom border is visible.
+     *
+     * @default true
+     */
+    readonly borderBottom?: boolean;
+    /**
+     * Determines whether left border is visible.
+     *
+     * @default true
+     */
+    readonly borderLeft?: boolean;
+    /**
+     * Determines whether right border is visible.
+     *
+     * @default true
+     */
+    readonly borderRight?: boolean;
+    /**
+     * Change border color.
+     * Shorthand for setting `borderTopColor`, `borderRightColor`, `borderBottomColor` and `borderLeftColor`.
+     */
+    readonly borderColor?: Color;
+    /**
+     * Change top border color.
+     * Accepts raw color values (rgb, hex, ansi).
+     */
+    readonly borderTopColor?: Color;
+    /**
+     * Change bottom border color.
+     * Accepts raw color values (rgb, hex, ansi).
+     */
+    readonly borderBottomColor?: Color;
+    /**
+     * Change left border color.
+     * Accepts raw color values (rgb, hex, ansi).
+     */
+    readonly borderLeftColor?: Color;
+    /**
+     * Change right border color.
+     * Accepts raw color values (rgb, hex, ansi).
+     */
+    readonly borderRightColor?: Color;
+    /**
+     * Dim the border color.
+     * Shorthand for setting `borderTopDimColor`, `borderBottomDimColor`, `borderLeftDimColor` and `borderRightDimColor`.
+     *
+     * @default false
+     */
+    readonly borderDimColor?: boolean;
+    /**
+     * Dim the top border color.
+     *
+     * @default false
+     */
+    readonly borderTopDimColor?: boolean;
+    /**
+     * Dim the bottom border color.
+     *
+     * @default false
+     */
+    readonly borderBottomDimColor?: boolean;
+    /**
+     * Dim the left border color.
+     *
+     * @default false
+     */
+    readonly borderLeftDimColor?: boolean;
+    /**
+     * Dim the right border color.
+     *
+     * @default false
+     */
+    readonly borderRightDimColor?: boolean;
+    /**
+     * Add text within the border. Only applies to top or bottom borders.
+     */
+    readonly borderText?: BorderTextOptions;
+    /**
+     * Background color for the box. Fills the interior with background-colored
+     * spaces and is inherited by child text nodes as their default background.
+     */
+    readonly backgroundColor?: Color;
+    /**
+     * Fill the box's interior (padding included) with spaces before
+     * rendering children, so nothing behind it shows through. Like
+     * `backgroundColor` but without emitting any SGR — the terminal's
+     * default background is used. Useful for absolute-positioned overlays
+     * where Box padding/gaps would otherwise be transparent.
+     */
+    readonly opaque?: boolean;
+    /**
+     * Behavior for an element's overflow in both directions.
+     * 'scroll' constrains the container's size (children do not expand it)
+     * and enables scrollTop-based virtualized scrolling at render time.
+     *
+     * @default 'visible'
+     */
+    readonly overflow?: 'visible' | 'hidden' | 'scroll';
+    /**
+     * Behavior for an element's overflow in horizontal direction.
+     *
+     * @default 'visible'
+     */
+    readonly overflowX?: 'visible' | 'hidden' | 'scroll';
+    /**
+     * Behavior for an element's overflow in vertical direction.
+     *
+     * @default 'visible'
+     */
+    readonly overflowY?: 'visible' | 'hidden' | 'scroll';
+    /**
+     * Exclude this box's cells from text selection in fullscreen mode.
+     * Cells inside this region are skipped by both the selection highlight
+     * and the copied text — useful for fencing off gutters (line numbers,
+     * diff sigils) so click-drag over a diff yields clean copyable code.
+     * Only affects alt-screen text selection; no-op otherwise.
+     *
+     * `'from-left-edge'` extends the exclusion from column 0 to the box's
+     * right edge for every row it occupies — this covers any upstream
+     * indentation (tool message prefix, tree lines) so a multi-row drag
+     * doesn't pick up leading whitespace from middle rows.
+     */
+    readonly noSelect?: boolean | 'from-left-edge';
+};
+/**
+ * Apply a style diff to a layout node, delegating each property group to its
+ * Yoga setter. The node's styles must already be applied elsewhere; `style`
+ * may be a diff containing only changed properties.
+ * @param node - the layout node to style.
+ * @param style - the styles to apply; defaults to an empty object.
+ * @param resolvedStyle - the node's full current styles, used to resolve border side values.
+ */
+declare const styles: (node: LayoutNode, style?: Styles, resolvedStyle?: Styles) => void;
+export default styles;
+//# sourceMappingURL=styles.d.ts.map

package/lib/types/ink/styles.d.ts.map

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