@chengchenccc/tui 0.1.1-rc.1

package/dist/vendor/mermaid-ascii/xychart/colors.js

@@ -0,0 +1,145 @@
+// ============================================================================
+// XY Chart — shared color palette
+//
+// Generates monochromatic shades from the theme accent color.
+// Series 0 = accent (or blue fallback). Series 1+ are darker/lighter
+// shades of the same hue with subtle hue drift to stay in the same
+// color family (like navy ↔ cyan from blue).
+//
+// Used by both the SVG and ASCII renderers.
+// ============================================================================
+/** Default accent for charts when the theme doesn't provide one. */
+export const CHART_ACCENT_FALLBACK = '#3b82f6'; // blue-500
+// ---------------------------------------------------------------------------
+// HSL ↔ Hex conversion
+// ---------------------------------------------------------------------------
+function hexToHsl(hex) {
+    const h = hex.replace('#', '');
+    const ri = parseInt(h.substring(0, 2), 16) / 255;
+    const gi = parseInt(h.substring(2, 4), 16) / 255;
+    const bi = parseInt(h.substring(4, 6), 16) / 255;
+    const max = Math.max(ri, gi, bi);
+    const min = Math.min(ri, gi, bi);
+    const l = (max + min) / 2;
+    if (max === min)
+        return [0, 0, l * 100];
+    const d = max - min;
+    const s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+    let hue;
+    if (max === ri)
+        hue = ((gi - bi) / d + (gi < bi ? 6 : 0)) / 6;
+    else if (max === gi)
+        hue = ((bi - ri) / d + 2) / 6;
+    else
+        hue = ((ri - gi) / d + 4) / 6;
+    return [hue * 360, s * 100, l * 100];
+}
+function hslToHex(h, s, l) {
+    const si = s / 100;
+    const li = l / 100;
+    const c = (1 - Math.abs(2 * li - 1)) * si;
+    const x = c * (1 - Math.abs(((h / 60) % 2) - 1));
+    const m = li - c / 2;
+    let r, g, b;
+    if (h < 60) {
+        r = c;
+        g = x;
+        b = 0;
+    }
+    else if (h < 120) {
+        r = x;
+        g = c;
+        b = 0;
+    }
+    else if (h < 180) {
+        r = 0;
+        g = c;
+        b = x;
+    }
+    else if (h < 240) {
+        r = 0;
+        g = x;
+        b = c;
+    }
+    else if (h < 300) {
+        r = x;
+        g = 0;
+        b = c;
+    }
+    else {
+        r = c;
+        g = 0;
+        b = x;
+    }
+    const toHex = (v) => Math.round((v + m) * 255).toString(16).padStart(2, '0');
+    return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+}
+// ---------------------------------------------------------------------------
+// Hex ↔ RGB conversion
+// ---------------------------------------------------------------------------
+function hexToRgb(hex) {
+    const h = hex.replace('#', '');
+    return [
+        parseInt(h.substring(0, 2), 16),
+        parseInt(h.substring(2, 4), 16),
+        parseInt(h.substring(4, 6), 16),
+    ];
+}
+function rgbToHex(r, g, b) {
+    const toHex = (v) => Math.round(Math.max(0, Math.min(255, v))).toString(16).padStart(2, '0');
+    return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/** Check whether a string is a valid 6-digit hex color (e.g. "#3b82f6"). */
+export function isValidHex(color) {
+    return /^#[0-9a-fA-F]{6}$/.test(color);
+}
+/**
+ * Detect whether a background color is dark (lightness < 50%).
+ */
+export function isDarkBackground(bgHex) {
+    return hexToHsl(bgHex)[2] < 50;
+}
+/**
+ * Mix two hex colors in RGB space.
+ * `ratio` controls how much of `fgHex` shows: 0 = pure bg, 1 = pure fg.
+ * Equivalent to alpha-compositing fg over bg at the given opacity.
+ */
+export function mixHexColors(bgHex, fgHex, ratio) {
+    const [br, bg, bb] = hexToRgb(bgHex);
+    const [fr, fg, fb] = hexToRgb(fgHex);
+    const inv = 1 - ratio;
+    return rgbToHex(br * inv + fr * ratio, bg * inv + fg * ratio, bb * inv + fb * ratio);
+}
+/**
+ * Get the hex color for a series index.
+ * Index 0 returns the accent color as-is.
+ * Index 1+ alternate between darker and lighter shades of the same hue
+ * with subtle hue drift (±8-12° per tier) to stay in the same family.
+ *
+ * When `bgColor` is provided, shade direction adapts to the background:
+ *   - Light bg: odd = darker, even = lighter (default)
+ *   - Dark bg:  odd = lighter, even = darker (so shades stay visible)
+ */
+export function getSeriesColor(index, accentColor, bgColor) {
+    if (index === 0)
+        return accentColor;
+    // Fall back to defaults when inputs aren't valid hex (e.g. CSS variable refs like "var(--accent)")
+    const safeAccent = isValidHex(accentColor) ? accentColor : CHART_ACCENT_FALLBACK;
+    const safeBg = bgColor && isValidHex(bgColor) ? bgColor : undefined;
+    const [h, s] = hexToHsl(safeAccent);
+    const chartS = Math.max(55, Math.min(85, s));
+    const tier = Math.ceil(index / 2);
+    const oddIndex = index % 2 === 1;
+    // On dark backgrounds, flip: odd = lighter, even = darker
+    const dark = safeBg && isDarkBackground(safeBg) ? !oddIndex : oddIndex;
+    const l = dark
+        ? Math.max(25, 48 - tier * 13)
+        : Math.min(78, 55 + tier * 11);
+    // Subtle hue drift: darker shades shift slightly negative, lighter shift positive
+    const hShift = (dark ? -8 : 12) * tier;
+    const newH = ((h + hShift) % 360 + 360) % 360;
+    return hslToHex(newH, chartS, l);
+}

package/dist/vendor/mermaid-ascii/xychart/parser.d.ts

@@ -0,0 +1,7 @@
+import type { XYChart } from './types.ts';
+/**
+ * Parse a Mermaid xychart-beta diagram from preprocessed lines.
+ * Lines should already be trimmed and comment-stripped.
+ */
+export declare function parseXYChart(lines: string[]): XYChart;
+//# sourceMappingURL=parser.d.ts.map

package/dist/vendor/mermaid-ascii/xychart/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/vendor/mermaid-ascii/xychart/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAyB,MAAM,YAAY,CAAA;AAmBhE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAuFrD"}

package/dist/vendor/mermaid-ascii/xychart/parser.js

@@ -0,0 +1,105 @@
+// ============================================================================
+// XY Chart parser
+//
+// Parses Mermaid xychart-beta syntax into a typed XYChart structure.
+//
+// Supported directives:
+//   xychart-beta [horizontal]
+//   title "Chart Title"
+//   x-axis [label1, label2, ...]          — categorical
+//   x-axis min --> max                     — numeric range
+//   x-axis "Axis Title" [label1, ...]      — with title
+//   x-axis "Axis Title" min --> max        — with title
+//   y-axis (same patterns)
+//   bar [val1, val2, ...]
+//   line [val1, val2, ...]
+// ============================================================================
+/**
+ * Parse a Mermaid xychart-beta diagram from preprocessed lines.
+ * Lines should already be trimmed and comment-stripped.
+ */
+export function parseXYChart(lines) {
+    const xAxis = {};
+    const yAxis = {};
+    const series = [];
+    let title;
+    let horizontal = false;
+    for (const line of lines) {
+        // Header line — detect horizontal
+        if (/^xychart(-beta)?\b/i.test(line)) {
+            if (/\bhorizontal\b/i.test(line))
+                horizontal = true;
+            continue;
+        }
+        // Title
+        const titleMatch = line.match(/^title\s+"([^"]+)"/);
+        if (titleMatch) {
+            title = titleMatch[1];
+            continue;
+        }
+        // x-axis with categories: x-axis "Title" [a, b, c] or x-axis [a, b, c]
+        const xCatMatch = line.match(/^x-axis\s+(?:"([^"]*)"\s*)?\[([^\]]+)\]/);
+        if (xCatMatch) {
+            if (xCatMatch[1])
+                xAxis.title = xCatMatch[1];
+            xAxis.categories = xCatMatch[2].split(',').map(s => s.trim());
+            continue;
+        }
+        // x-axis with range: x-axis "Title" min --> max or x-axis min --> max
+        const xRangeMatch = line.match(/^x-axis\s+(?:"([^"]*)"\s+)?(-?\d+(?:\.\d+)?)\s*-->\s*(-?\d+(?:\.\d+)?)/);
+        if (xRangeMatch) {
+            if (xRangeMatch[1])
+                xAxis.title = xRangeMatch[1];
+            xAxis.range = { min: parseFloat(xRangeMatch[2]), max: parseFloat(xRangeMatch[3]) };
+            continue;
+        }
+        // y-axis with range: y-axis "Title" min --> max or y-axis min --> max
+        const yRangeMatch = line.match(/^y-axis\s+(?:"([^"]*)"\s+)?(-?\d+(?:\.\d+)?)\s*-->\s*(-?\d+(?:\.\d+)?)/);
+        if (yRangeMatch) {
+            if (yRangeMatch[1])
+                yAxis.title = yRangeMatch[1];
+            yAxis.range = { min: parseFloat(yRangeMatch[2]), max: parseFloat(yRangeMatch[3]) };
+            continue;
+        }
+        // y-axis with just title (no range)
+        const yTitleOnly = line.match(/^y-axis\s+"([^"]+)"\s*$/);
+        if (yTitleOnly) {
+            yAxis.title = yTitleOnly[1];
+            continue;
+        }
+        // bar [...]
+        const barMatch = line.match(/^bar\s+\[([^\]]+)\]/);
+        if (barMatch) {
+            series.push({ type: 'bar', data: parseNumericArray(barMatch[1]) });
+            continue;
+        }
+        // line [...]
+        const lineMatch = line.match(/^line\s+\[([^\]]+)\]/);
+        if (lineMatch) {
+            series.push({ type: 'line', data: parseNumericArray(lineMatch[1]) });
+            continue;
+        }
+    }
+    // Auto-derive y-axis range from data if not specified
+    if (!yAxis.range && series.length > 0) {
+        const allValues = series.flatMap(s => s.data);
+        let min = Math.min(...allValues);
+        let max = Math.max(...allValues);
+        const span = max - min || 1;
+        // Add 10% padding
+        min = min - span * 0.1;
+        max = max + span * 0.1;
+        // Floor to 0 if all values are positive and min is close to 0
+        if (min > 0 && min < span * 0.5)
+            min = 0;
+        yAxis.range = { min, max };
+    }
+    // Fallback y-axis range
+    if (!yAxis.range) {
+        yAxis.range = { min: 0, max: 100 };
+    }
+    return { title, horizontal, xAxis, yAxis, series };
+}
+function parseNumericArray(str) {
+    return str.split(',').map(s => parseFloat(s.trim()));
+}

package/dist/vendor/mermaid-ascii/xychart/types.d.ts

@@ -0,0 +1,146 @@
+/** Parsed XY chart — logical structure from mermaid text */
+export interface XYChart {
+    /** Optional chart title */
+    title?: string;
+    /** Chart orientation: vertical (default) or horizontal */
+    horizontal: boolean;
+    /** X-axis configuration */
+    xAxis: XYAxis;
+    /** Y-axis configuration */
+    yAxis: XYAxis;
+    /** Data series (bar and/or line) */
+    series: XYChartSeries[];
+}
+/** Axis configuration — categorical (labels) or numeric (range) */
+export interface XYAxis {
+    /** Optional axis title/label */
+    title?: string;
+    /** Categorical labels (e.g., ["jan", "feb", "mar"]) — mutually exclusive with range */
+    categories?: string[];
+    /** Numeric range — mutually exclusive with categories */
+    range?: {
+        min: number;
+        max: number;
+    };
+}
+/** A single data series (bar or line) */
+export interface XYChartSeries {
+    /** Series type */
+    type: 'bar' | 'line';
+    /** Data values — one per category, or evenly spaced across numeric range */
+    data: number[];
+}
+export interface PositionedXYChart {
+    width: number;
+    height: number;
+    /** Whether this is a horizontal (rotated) chart */
+    horizontal?: boolean;
+    /** Title text and position (if present) */
+    title?: PositionedTitle;
+    /** Positioned x-axis with tick marks and labels */
+    xAxis: PositionedAxis;
+    /** Positioned y-axis with tick marks and labels */
+    yAxis: PositionedAxis;
+    /** The plot area bounds (inside axes) */
+    plotArea: PlotArea;
+    /** Positioned bar groups */
+    bars: PositionedBar[];
+    /** Positioned line polylines */
+    lines: PositionedLine[];
+    /** Horizontal grid lines for readability */
+    gridLines: GridLine[];
+    /** Legend items (shown when multiple series) */
+    legend: LegendItem[];
+}
+export interface LegendItem {
+    /** Display label */
+    label: string;
+    /** Position of the swatch/icon */
+    x: number;
+    y: number;
+    /** Series type determines swatch shape (rect for bar, line+dot for line) */
+    type: 'bar' | 'line';
+    /** Series index within its type (for layout grouping) */
+    seriesIndex: number;
+    /** Global color index across all series (for unified color assignment) */
+    colorIndex: number;
+}
+export interface PositionedTitle {
+    text: string;
+    x: number;
+    y: number;
+}
+export interface PositionedAxis {
+    /** Optional axis title text and position */
+    title?: {
+        text: string;
+        x: number;
+        y: number;
+        rotate?: number;
+    };
+    /** Tick positions along the axis */
+    ticks: AxisTick[];
+    /** Axis line: start and end coordinates */
+    line: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+}
+export interface AxisTick {
+    /** Label text for this tick */
+    label: string;
+    /** Position of the tick mark on the axis */
+    x: number;
+    y: number;
+    /** End of the tick mark (short perpendicular line) */
+    tx: number;
+    ty: number;
+    /** Label anchor position */
+    labelX: number;
+    labelY: number;
+    /** Text anchor for label */
+    textAnchor: 'start' | 'middle' | 'end';
+}
+export interface PlotArea {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface PositionedBar {
+    /** Bar rectangle in SVG coordinates */
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** Original data value */
+    value: number;
+    /** Category label for this bar (e.g. "Jan") */
+    label?: string;
+    /** Series index within bar type (for layout grouping) */
+    seriesIndex: number;
+    /** Global color index across all series */
+    colorIndex: number;
+}
+export interface PositionedLine {
+    /** Polyline points */
+    points: Array<{
+        x: number;
+        y: number;
+        value: number;
+        label?: string;
+    }>;
+    /** Series index within line type (for layout grouping) */
+    seriesIndex: number;
+    /** Global color index across all series */
+    colorIndex: number;
+}
+export interface GridLine {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/vendor/mermaid-ascii/xychart/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/vendor/mermaid-ascii/xychart/types.ts"],"names":[],"mappings":"AAQA,4DAA4D;AAC5D,MAAM,WAAW,OAAO;IACtB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,UAAU,EAAE,OAAO,CAAA;IACnB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,oCAAoC;IACpC,MAAM,EAAE,aAAa,EAAE,CAAA;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,MAAM;IACrB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,yDAAyD;IACzD,KAAK,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CACrC;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,IAAI,EAAE,KAAK,GAAG,MAAM,CAAA;IACpB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAMD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB,mDAAmD;IACnD,KAAK,EAAE,cAAc,CAAA;IACrB,mDAAmD;IACnD,KAAK,EAAE,cAAc,CAAA;IACrB,yCAAyC;IACzC,QAAQ,EAAE,QAAQ,CAAA;IAClB,4BAA4B;IAC5B,IAAI,EAAE,aAAa,EAAE,CAAA;IACrB,gCAAgC;IAChC,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,4CAA4C;IAC5C,SAAS,EAAE,QAAQ,EAAE,CAAA;IACrB,gDAAgD;IAChD,MAAM,EAAE,UAAU,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,kCAAkC;IAClC,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,4EAA4E;IAC5E,IAAI,EAAE,KAAK,GAAG,MAAM,CAAA;IACpB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAA;IACnB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/D,oCAAoC;IACpC,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,2CAA2C;IAC3C,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CACzD;AAED,MAAM,WAAW,QAAQ;IACvB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,4CAA4C;IAC5C,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,UAAU,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAA;CACvC;AAED,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAA;IACnB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,MAAM,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACtE,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAA;IACnB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;CACX"}

package/dist/vendor/mermaid-ascii/xychart/types.js

@@ -0,0 +1,8 @@
+// ============================================================================
+// XY Chart types
+//
+// Models the parsed and positioned representations of a Mermaid xychart-beta
+// diagram. Supports bar charts, line charts, and combinations with categorical
+// or numeric x-axes.
+// ============================================================================
+export {};

package/dist/virtual-terminal.d.ts

@@ -0,0 +1,80 @@
+import type { IBufferLine } from "@xterm/headless";
+import type { Terminal } from "./terminal.ts";
+/**
+ * Virtual terminal for testing using xterm.js for accurate terminal emulation
+ */
+export declare class VirtualTerminal implements Terminal {
+    private xterm;
+    private inputHandler?;
+    private resizeHandler?;
+    private _columns;
+    private _rows;
+    constructor(columns?: number, rows?: number);
+    start(onInput: (data: string) => void, onResize: () => void): void;
+    drainInput(_maxMs?: number, _idleMs?: number): Promise<void>;
+    stop(): void;
+    write(data: string): void;
+    get columns(): number;
+    get rows(): number;
+    get kittyProtocolActive(): boolean;
+    moveBy(lines: number): void;
+    hideCursor(): void;
+    showCursor(): void;
+    clearLine(): void;
+    clearFromCursor(): void;
+    clearScreen(): void;
+    setTitle(title: string): void;
+    setProgress(_active: boolean): void;
+    /**
+     * Simulate keyboard input
+     */
+    sendInput(data: string): void;
+    /**
+     * Resize the terminal
+     */
+    resize(columns: number, rows: number): void;
+    /**
+     * Wait for all pending writes to complete. Viewport and scroll buffer will be updated.
+     */
+    flush(): Promise<void>;
+    /**
+     * Flush and get viewport - convenience method for tests
+     */
+    flushAndGetViewport(): Promise<string[]>;
+    /**
+     * Get the visible viewport (what's currently on screen)
+     * Note: You should use getViewportAfterWrite() for testing after writing data
+     */
+    getViewport(): string[];
+    /**
+     * Get the entire scroll buffer
+     */
+    /**
+     * Like getViewport() but re-emits per-cell SGR styling (fg/bg/bold/dim/…)
+     * so snapshot tooling can see colors and backgrounds, not just text.
+     */
+    getViewportAnsi(): string[];
+    /** Scrollback + viewport with per-cell SGR re-emitted. */
+    getScrollBufferAnsi(): string[];
+    getScrollBuffer(): string[];
+    /**
+     * Clear the terminal viewport
+     */
+    clear(): void;
+    /**
+     * Reset the terminal completely
+     */
+    reset(): void;
+    /**
+     * Get cursor position
+     */
+    getCursorPosition(): {
+        x: number;
+        y: number;
+    };
+    /** Wait for TUI's throttled render pipeline to settle. */
+    waitForRender(): Promise<void>;
+}
+/** One buffer row with SGR codes re-emitted between attribute runs. */
+export declare function lineToAnsi(line: IBufferLine): string;
+//# sourceMappingURL=virtual-terminal.d.ts.map

package/dist/virtual-terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-terminal.d.ts","sourceRoot":"","sources":["../src/virtual-terminal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,WAAW,EAAiC,MAAM,iBAAiB,CAAC;AAE/F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAK9C;;GAEG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,YAAY,CAAC,CAAyB;IAC9C,OAAO,CAAC,aAAa,CAAC,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;gBAEV,OAAO,SAAK,EAAE,IAAI,SAAK;IAcnC,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAO5D,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE,IAAI,IAAI,IAAI;IAOZ,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIzB,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,mBAAmB,IAAI,OAAO,CAGjC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAW3B,UAAU,IAAI,IAAI;IAIlB,UAAU,IAAI,IAAI;IAIlB,SAAS,IAAI,IAAI;IAIjB,eAAe,IAAI,IAAI;IAIvB,WAAW,IAAI,IAAI;IAInB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK7B,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAInC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM7B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAS3C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAK9C;;;OAGG;IACH,WAAW,IAAI,MAAM,EAAE;IAiBvB;;OAEG;IACH;;;OAGG;IACH,eAAe,IAAI,MAAM,EAAE;IAa3B,0DAA0D;IAC1D,mBAAmB,IAAI,MAAM,EAAE;IAU/B,eAAe,IAAI,MAAM,EAAE;IAiB3B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,iBAAiB,IAAI;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IAQ7C,0DAA0D;IACpD,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAKrC;AAoCD,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAyBpD"}