linecraft 0.2.0 → 0.2.2

package/LICENSE

@@ -19,4 +19,3 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
-

package/README.md

@@ -41,6 +41,30 @@ r.set(
 r.destroy(true);
 ```
 
+## Performance
+
+Linecraft is built for high-performance terminal rendering from Node.js. The renderer includes several optimizations to minimize terminal updates and CPU usage:
+
+### Frame Diffing
+Only updates lines that actually changed. Unchanged lines are skipped entirely, reducing terminal writes by up to 90% for static content.
+
+### Render Throttling
+Uses high-resolution timing (`process.hrtime.bigint()`) to limit frame rate (default: 30 FPS). Prevents excessive rendering during rapid updates while maintaining smooth animations.
+
+### Batched ANSI Operations
+All ANSI escape sequences are batched into a single `stdout.write()` call per frame, minimizing syscalls and improving throughput.
+
+### Efficient Cursor Movement
+Optimized ANSI cursor positioning that only moves when necessary. The renderer tracks viewport state to avoid redundant cursor movements.
+
+### Viewport Management
+Only renders visible lines within the terminal viewport. Content that extends beyond the viewport is efficiently managed without unnecessary rendering.
+
+### Auto-Wrap Disabled
+Disables terminal auto-wrap to prevent unwanted line breaks, ensuring precise control over terminal output layout.
+
+These optimizations make Linecraft suitable for real-time terminal UIs, progress displays, and animated components without overwhelming the terminal or consuming excessive CPU.
+
 ## Core API
 
 ### Region
@@ -103,7 +127,7 @@ r.set(Styled({
 
 Wrap content in a bordered box with an optional title.
 
-![Section Example](docs/examples/section.gif)
+![Section Example](https://raw.githubusercontent.com/matthew-dean/linecraft/main/docs/examples/section.gif)
 
 ```typescript
 import { Section } from 'linecraft';
@@ -128,7 +152,7 @@ r.set(Section(
 
 Display code errors and warnings with line numbers, context, and clickable file paths.
 
-![CodeDebug Example](docs/examples/code-debug.gif)
+![CodeDebug Example](https://raw.githubusercontent.com/matthew-dean/linecraft/main/docs/examples/code-debug.gif)
 
 ```typescript
 import { CodeDebug } from 'linecraft';
@@ -161,7 +185,7 @@ r.set(CodeDebug({
 
 Animated spinners for loading states. Includes built-in styles or use custom frames.
 
-![Spinner Example](docs/examples/spinner.gif)
+![Spinner Example](https://raw.githubusercontent.com/matthew-dean/linecraft/main/docs/examples/spinner.gif)
 
 ```typescript
 import { Spinner } from 'linecraft';
@@ -194,7 +218,7 @@ Spinners automatically stop when components are replaced or the region is destro
 
 Progress bars with customizable colors and styling.
 
-![ProgressBar Example](docs/examples/progressbar.gif)
+![ProgressBar Example](https://raw.githubusercontent.com/matthew-dean/linecraft/main/docs/examples/progressbar.gif)
 
 ```typescript
 import { progressBar } from 'linecraft';
@@ -219,7 +243,7 @@ r.set(progressBar({
 
 Create segmented displays (like oh-my-zsh style prompts).
 
-![Segments Example](docs/examples/segments.gif)
+![Segments Example](https://raw.githubusercontent.com/matthew-dean/linecraft/main/docs/examples/segments.gif)
 
 ```typescript
 import { Segments } from 'linecraft';
@@ -242,7 +266,7 @@ r.set(Segments({
 
 Create responsive grid layouts. Children automatically wrap to new rows when they exceed the number of explicit columns.
 
-![Grid Example](docs/examples/grid.gif)
+![Grid Example](https://raw.githubusercontent.com/matthew-dean/linecraft/main/docs/examples/grid.gif)
 
 ```typescript
 import { Grid } from 'linecraft';
@@ -285,7 +309,7 @@ r.set(Grid({
 
 Fill available space with a character. Typically used within grids.
 
-![Fill Example](docs/examples/fill.gif)
+![Fill Example](https://raw.githubusercontent.com/matthew-dean/linecraft/main/docs/examples/fill.gif)
 
 ```typescript
 import { fill } from 'linecraft';
@@ -357,4 +381,6 @@ Contributions welcome! Please open an issue or PR.
 
 ## License
 
-MIT
+This project is licensed under the **MIT License**.
+
+See the full license text in [`LICENSE`](./LICENSE).

package/lib/component.d.ts

@@ -0,0 +1,34 @@
+import type { TerminalRegion } from './region';
+/**
+ * RenderContext provides information needed for rendering
+ */
+export interface RenderContext {
+    availableWidth: number;
+    region: TerminalRegion;
+    columnIndex: number;
+    rowIndex: number;
+    onUpdate?: () => void;
+    onCleanup?: (callback: () => void) => void;
+}
+/**
+ * Component type: can be a function or an object with a render method
+ */
+export type Component = ((ctx: RenderContext) => string | string[] | null) | {
+    render: (ctx: RenderContext) => string | string[] | null;
+};
+/**
+ * Helper to call a component (handles both function and object forms)
+ */
+export declare function callComponent(component: Component, ctx: RenderContext): string | string[] | null;
+/**
+ * Create a child RenderContext from a parent, with optional overrides
+ * This ensures all properties from the parent are passed through, including onUpdate
+ */
+export declare function createChildContext(parent: RenderContext, overrides: Partial<RenderContext>): RenderContext;
+/**
+ * Render children components and return flattened lines
+ * Handles null returns, array flattening, and rowIndex tracking automatically
+ * Inspired by React's children rendering pattern
+ */
+export declare function renderChildren(children: Component[], ctx: RenderContext): string[];
+//# sourceMappingURL=component.d.ts.map

package/lib/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,CAAC,CAAC,GAAG,EAAE,aAAa,KAAK,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,GAClD;IAAE,MAAM,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAA;CAAE,CAAC;AAEjE;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAKhG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,GAChC,aAAa,CAKf;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,SAAS,EAAE,EACrB,GAAG,EAAE,aAAa,GACjB,MAAM,EAAE,CAgBV"}

package/lib/component.js

@@ -0,0 +1,42 @@
+/**
+ * Helper to call a component (handles both function and object forms)
+ */
+export function callComponent(component, ctx) {
+    if (typeof component === 'function') {
+        return component(ctx);
+    }
+    return component.render(ctx);
+}
+/**
+ * Create a child RenderContext from a parent, with optional overrides
+ * This ensures all properties from the parent are passed through, including onUpdate
+ */
+export function createChildContext(parent, overrides) {
+    return {
+        ...parent,
+        ...overrides,
+    };
+}
+/**
+ * Render children components and return flattened lines
+ * Handles null returns, array flattening, and rowIndex tracking automatically
+ * Inspired by React's children rendering pattern
+ */
+export function renderChildren(children, ctx) {
+    const lines = [];
+    for (const child of children) {
+        const result = callComponent(child, createChildContext(ctx, {
+            rowIndex: lines.length,
+        }));
+        if (result === null)
+            continue;
+        if (Array.isArray(result)) {
+            lines.push(...result);
+        }
+        else {
+            lines.push(result);
+        }
+    }
+    return lines;
+}
+//# sourceMappingURL=component.js.map

package/lib/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAqBA;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAoB,EAAE,GAAkB;IACpE,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAqB,EACrB,SAAiC;IAEjC,OAAO;QACL,GAAG,MAAM;QACT,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAqB,EACrB,GAAkB;IAElB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,kBAAkB,CAAC,GAAG,EAAE;YAC1D,QAAQ,EAAE,KAAK,CAAC,MAAM;SACvB,CAAC,CAAC,CAAC;QAEJ,IAAI,MAAM,KAAK,IAAI;YAAE,SAAS;QAE9B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/components/code-debug.d.ts

@@ -0,0 +1,35 @@
+import type { Component } from '../component';
+export type CodeDebugType = 'error' | 'warning' | 'info';
+export interface CodeDebugOptions {
+    /** Line number where error starts (1-based) */
+    startLine: number;
+    /** Column number where error starts (1-based) */
+    startColumn: number;
+    /** Line number where error ends (1-based, optional) */
+    endLine?: number;
+    /** Column number where error ends (1-based, optional) */
+    endColumn?: number;
+    /** Source code line before the error line (optional) */
+    lineBefore?: string | null;
+    /** Source code line with the error */
+    errorLine: string;
+    /** Source code line after the error line (optional) */
+    lineAfter?: string | null;
+    /** Error or warning message */
+    message: string;
+    /** Short file path to display */
+    filePath: string;
+    /** Full resolved file path for clickable link */
+    fullPath: string;
+    /** Base directory for relative paths (optional) */
+    baseDir?: string;
+    /** Type of error: error, warning, or info */
+    type?: CodeDebugType;
+    /** Maximum column to show before forcing ellipsis (to make room for message) */
+    maxColumn?: number;
+}
+/**
+ * CodeDebug component - displays code errors/warnings with context
+ */
+export declare function CodeDebug(options: CodeDebugOptions): Component;
+//# sourceMappingURL=code-debug.d.ts.map

package/lib/components/code-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-debug.d.ts","sourceRoot":"","sources":["../../src/components/code-debug.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,cAAc,CAAC;AAS7D,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiID;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA+O9D"}

package/lib/components/code-debug.js

@@ -0,0 +1,294 @@
+// Code debug component for displaying code errors/warnings with context
+import { callComponent } from '../component';
+import { applyStyle } from '../utils/colors';
+import { wrapText, stripAnsi, truncateToWidth } from '../utils/text';
+import { fileLink } from '../utils/file-link';
+import { Section } from './section';
+import { getColoredLineNumberColor } from '../utils/terminal-theme';
+function calculateVisibleRange(code, availableWidth, targetStartCol, targetEndCol, maxColumn) {
+    const plainCode = stripAnsi(code);
+    const codeLength = plainCode.length;
+    // If code fits, show everything
+    if (codeLength <= availableWidth) {
+        return {
+            startCol: 1,
+            endCol: codeLength,
+            hasEllipsisStart: false,
+            hasEllipsisEnd: false,
+        };
+    }
+    // If maxColumn is set, we need to ensure we don't show beyond it
+    const effectiveMaxCol = maxColumn ? Math.min(maxColumn, codeLength) : codeLength;
+    // Calculate how much space we need for the target columns
+    const targetWidth = targetEndCol
+        ? targetEndCol - targetStartCol + 1
+        : 1; // Just the arrow
+    // If target doesn't fit, we'll need to truncate
+    if (targetWidth > availableWidth - 6) { // -6 for ellipsis on both sides if needed
+        // Target is too wide, just show middle with ellipsis
+        const midPoint = Math.floor((availableWidth - 6) / 2);
+        const startCol = Math.max(1, targetStartCol - midPoint);
+        const endCol = Math.min(effectiveMaxCol, startCol + availableWidth - 6);
+        return {
+            startCol,
+            endCol,
+            hasEllipsisStart: startCol > 1,
+            hasEllipsisEnd: endCol < codeLength,
+        };
+    }
+    // Try to center the target in the available space
+    const padding = Math.floor((availableWidth - targetWidth) / 2);
+    let startCol = Math.max(1, targetStartCol - padding);
+    let endCol = Math.min(effectiveMaxCol, startCol + availableWidth - 1);
+    // Adjust if we hit boundaries
+    if (endCol - startCol + 1 > availableWidth) {
+        endCol = startCol + availableWidth - 1;
+    }
+    if (endCol > effectiveMaxCol) {
+        endCol = effectiveMaxCol;
+        startCol = Math.max(1, endCol - availableWidth + 1);
+    }
+    if (startCol < 1) {
+        startCol = 1;
+        endCol = Math.min(effectiveMaxCol, availableWidth);
+    }
+    // Check if we need ellipsis
+    const hasEllipsisStart = startCol > 1;
+    const hasEllipsisEnd = endCol < codeLength;
+    return {
+        startCol,
+        endCol,
+        hasEllipsisStart,
+        hasEllipsisEnd,
+    };
+}
+/**
+ * Truncate code line to show specific column range with ellipsis
+ */
+function truncateCodeLine(code, visibleRange, availableWidth) {
+    const { startCol, endCol, hasEllipsisStart, hasEllipsisEnd } = visibleRange;
+    const plainCode = stripAnsi(code);
+    if (!hasEllipsisStart && !hasEllipsisEnd) {
+        // No truncation needed, but ensure it fits
+        return truncateToWidth(code, availableWidth);
+    }
+    // Extract the visible portion (1-based columns in plain text)
+    const visiblePlain = plainCode.substring(startCol - 1, endCol);
+    // Calculate available width for code (minus ellipsis)
+    const ellipsisWidth = (hasEllipsisStart ? 3 : 0) + (hasEllipsisEnd ? 3 : 0);
+    const codeWidth = availableWidth - ellipsisWidth;
+    // Truncate the visible portion if it's still too wide
+    let truncatedPlain = visiblePlain;
+    if (stripAnsi(visiblePlain).length > codeWidth) {
+        truncatedPlain = truncateToWidth(visiblePlain, codeWidth);
+    }
+    if (hasEllipsisStart && hasEllipsisEnd) {
+        // Truncate both ends - show middle portion
+        const midPoint = Math.floor(codeWidth / 2);
+        const startPart = truncateToWidth(truncatedPlain, midPoint);
+        const endPart = truncateToWidth(truncatedPlain.substring(stripAnsi(truncatedPlain).length - (codeWidth - midPoint)), codeWidth - midPoint);
+        return `...${startPart}...${endPart}...`;
+    }
+    else if (hasEllipsisStart) {
+        return `...${truncatedPlain}`;
+    }
+    else {
+        return `${truncatedPlain}...`;
+    }
+}
+/**
+ * CodeDebug component - displays code errors/warnings with context
+ */
+export function CodeDebug(options) {
+    return (ctx) => {
+        const { startLine, startColumn, endLine, endColumn, lineBefore, errorLine, lineAfter, message, filePath, fullPath, baseDir, type = 'error', maxColumn, } = options;
+        const availableWidth = ctx.availableWidth;
+        // Color scheme based on type
+        const colors = {
+            error: { primary: 'red', secondary: 'brightRed', message: 'brightRed' },
+            warning: { primary: 'yellow', secondary: 'brightYellow', message: 'brightYellow' },
+            info: { primary: 'cyan', secondary: 'brightCyan', message: 'brightCyan' },
+        };
+        const colorScheme = colors[type];
+        // Get appropriate line number color based on terminal theme
+        const lineNumberColor = getColoredLineNumberColor(); // For line numbers (colored)
+        // Calculate available width for code (reserve space for line numbers, separator, and spaces)
+        // Calculate the maximum width needed for any line number that will be displayed
+        const lineNumbersToCheck = [startLine];
+        if (lineBefore !== null && lineBefore !== undefined) {
+            lineNumbersToCheck.push(startLine - 1);
+        }
+        if (lineAfter !== null && lineAfter !== undefined) {
+            lineNumbersToCheck.push(startLine + 1);
+        }
+        const lineNumWidth = Math.max(...lineNumbersToCheck.map(n => String(n).length));
+        const codeAreaWidth = availableWidth - lineNumWidth - 2; // -2 for "  " (2 spaces)
+        // Calculate visible range for error line
+        const targetEndCol = endColumn ?? startColumn;
+        const plainErrorLine = stripAnsi(errorLine);
+        const effectiveMaxCol = maxColumn ? Math.min(maxColumn, plainErrorLine.length) : plainErrorLine.length;
+        const visibleRange = calculateVisibleRange(errorLine, codeAreaWidth, startColumn, targetEndCol, effectiveMaxCol);
+        // Truncate error line
+        const truncatedErrorLine = truncateCodeLine(errorLine, visibleRange, codeAreaWidth);
+        // Calculate arrow/underline position relative to the truncated error line display
+        // Map original column positions to display positions
+        const truncatedPlain = stripAnsi(truncatedErrorLine);
+        // Helper to map original column to display position
+        const mapColumnToDisplay = (originalCol) => {
+            if (visibleRange.hasEllipsisStart && visibleRange.hasEllipsisEnd) {
+                // Format: "...start...end..."
+                // Visible range is in the middle
+                if (originalCol < visibleRange.startCol) {
+                    return 1; // Before visible, point to start
+                }
+                else if (originalCol > visibleRange.endCol) {
+                    return truncatedPlain.length; // After visible, point to end
+                }
+                else {
+                    // In visible range: position = 4 (for "...") + (col - startCol + 1)
+                    return 4 + (originalCol - visibleRange.startCol);
+                }
+            }
+            else if (visibleRange.hasEllipsisStart) {
+                // Format: "...code"
+                if (originalCol < visibleRange.startCol) {
+                    return 1;
+                }
+                else {
+                    return 4 + (originalCol - visibleRange.startCol);
+                }
+            }
+            else if (visibleRange.hasEllipsisEnd) {
+                // Format: "code..."
+                if (originalCol > visibleRange.endCol) {
+                    return truncatedPlain.length;
+                }
+                else {
+                    return originalCol;
+                }
+            }
+            else {
+                // No ellipsis, direct mapping
+                return originalCol;
+            }
+        };
+        const arrowCol = mapColumnToDisplay(startColumn);
+        let underlineStartCol = arrowCol;
+        let underlineEndCol = arrowCol;
+        if (endColumn) {
+            underlineStartCol = mapColumnToDisplay(startColumn);
+            underlineEndCol = mapColumnToDisplay(endColumn);
+            // Ensure valid range
+            if (underlineEndCol < underlineStartCol) {
+                underlineEndCol = underlineStartCol;
+            }
+        }
+        // Build the code block lines (will be wrapped in Section)
+        const codeLines = [];
+        // Title line: "Error in {filename}" or type-specific title
+        const pathText = baseDir && filePath.startsWith(baseDir)
+            ? filePath.substring(baseDir.length + 1)
+            : filePath;
+        const errorTypeTitle = type === 'error' ? 'Error' : type === 'warning' ? 'Warning' : 'Info';
+        const titleLine = applyStyle(`${errorTypeTitle} in ${pathText}`, { color: colorScheme.secondary, bold: true });
+        codeLines.push(titleLine);
+        // Line before (if exists)
+        if (lineBefore !== null && lineBefore !== undefined) {
+            const beforeLineNum = String(startLine - 1);
+            const beforeLineNumPadded = beforeLineNum.padStart(lineNumWidth);
+            const truncatedBefore = truncateToWidth(lineBefore, codeAreaWidth);
+            codeLines.push(applyStyle(`${beforeLineNumPadded}  `, { color: lineNumberColor }) +
+                truncatedBefore);
+        }
+        // Error line
+        const errorLineNum = String(startLine);
+        const errorLineNumPadded = errorLineNum.padStart(lineNumWidth);
+        let errorLineDisplay = applyStyle(`${errorLineNumPadded}  `, { color: lineNumberColor }) +
+            truncatedErrorLine;
+        codeLines.push(errorLineDisplay);
+        // Arrow/underline line
+        let indicatorLine = ' '.repeat(lineNumWidth) + '  ';
+        indicatorLine += ' '.repeat(Math.max(0, arrowCol - 1));
+        // Calculate where the connecting line should come down from (middle of underline or arrow position)
+        const connectCol = endColumn && underlineEndCol > underlineStartCol
+            ? Math.floor((underlineStartCol + underlineEndCol) / 2) // Middle of underline
+            : arrowCol; // Position of arrow
+        if (endColumn && underlineEndCol > underlineStartCol) {
+            // Underline with curved edges facing up and T-bar in the middle: ╰──┬──╯
+            const underlineLength = underlineEndCol - underlineStartCol;
+            const connectPosInUnderline = connectCol - underlineStartCol; // Position within the underline
+            if (underlineLength >= 3) {
+                // Build underline with T-bar: left curve, dashes, T-bar, dashes, right curve
+                const leftPart = '─'.repeat(Math.max(0, connectPosInUnderline - 1));
+                const rightPart = '─'.repeat(Math.max(0, underlineLength - connectPosInUnderline - 1));
+                indicatorLine += applyStyle('┖' + leftPart + '┬' + rightPart + '┚', { color: colorScheme.primary });
+            }
+            else if (underlineLength === 2) {
+                // Too short for T-bar, just use T in middle
+                indicatorLine += applyStyle('┖┬┚', { color: colorScheme.primary });
+            }
+            else {
+                // Single character, just use T
+                indicatorLine += applyStyle('╿', { color: colorScheme.primary });
+            }
+        }
+        else {
+            // Single point - use ┬ (T pointing up) which has horizontal bar pointing to code, vertical line going down
+            indicatorLine += applyStyle('╿', { color: colorScheme.primary });
+        }
+        codeLines.push(indicatorLine);
+        // Horizontal line to message (directly from T-bar or ┴, no extra vertical line)
+        const horizontalLine = ' '.repeat(lineNumWidth) + '  ';
+        const horizontalSpaces = ' '.repeat(Math.max(0, connectCol - 1));
+        const horizontalBar = applyStyle('└', { color: colorScheme.primary });
+        const horizontalDash = applyStyle('─ ', { color: colorScheme.primary });
+        const messageStart = horizontalLine + horizontalSpaces + horizontalBar + horizontalDash;
+        // Message lines
+        const messageWidth = availableWidth - stripAnsi(messageStart).length;
+        const messageLines = wrapText(message, messageWidth);
+        // First message line with connecting line
+        if (messageLines.length > 0) {
+            codeLines.push(messageStart +
+                applyStyle(messageLines[0], { color: colorScheme.message }));
+            // Remaining message lines (indented to start of first line)
+            const messageIndent = ' '.repeat(stripAnsi(messageStart).length);
+            for (let i = 1; i < messageLines.length; i++) {
+                codeLines.push(messageIndent + applyStyle(messageLines[i], { color: colorScheme.message }));
+            }
+        }
+        // Line after (if exists) - comes after the message
+        if (lineAfter !== null && lineAfter !== undefined) {
+            // Add empty line after message (within section)
+            codeLines.push('');
+            const afterLineNum = String(startLine + 1);
+            const afterLineNumPadded = afterLineNum.padStart(lineNumWidth);
+            const truncatedAfter = truncateToWidth(lineAfter, codeAreaWidth);
+            codeLines.push(applyStyle(`${afterLineNumPadded}  `, { color: lineNumberColor }) +
+                truncatedAfter);
+            // Add another empty line after line after (within section)
+            codeLines.push('');
+        }
+        // Wrap in Section with left border only, no padding
+        const filePathDisplay = (() => {
+            const pathText = baseDir && filePath.startsWith(baseDir)
+                ? filePath.substring(baseDir.length + 1)
+                : filePath;
+            const pathWithLink = fileLink(fullPath, pathText);
+            const lineNumText = `:${startLine}${endLine && endLine !== startLine ? `:${endLine}` : ''}`;
+            return pathWithLink + lineNumText;
+        })();
+        // Use Section to wrap the code block with left border
+        const sectionComponent = Section({
+            title: filePathDisplay,
+            titleColor: colorScheme.secondary,
+            left: true,
+            right: false,
+            top: false,
+            bottom: false,
+            padding: 0,
+            borderColor: colorScheme.primary,
+        }, (ctx) => codeLines);
+        return callComponent(sectionComponent, ctx);
+    };
+}
+//# sourceMappingURL=code-debug.js.map

package/lib/components/code-debug.js.map

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

package/lib/components/fill.d.ts

@@ -0,0 +1,15 @@
+import type { Component } from '../component';
+import type { Color, FillChar } from '../types';
+export interface FillOptions {
+    backgroundColor?: Color;
+}
+/**
+ * Fill component - fills the available width with a repeated character
+ *
+ * Usage:
+ *   fill('─')                                    // Simple character
+ *   fill({ char: '─', color: 'red' })           // Character with color
+ *   fill('─', { backgroundColor: 'blue' })      // Character with additional options
+ */
+export declare function fill(fillChar?: FillChar, options?: FillOptions): Component;
+//# sourceMappingURL=fill.d.ts.map

package/lib/components/fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../src/components/fill.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGhD,MAAM,WAAW,WAAW;IAC1B,eAAe,CAAC,EAAE,KAAK,CAAC;CACzB;AAYD;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAClB,QAAQ,GAAE,QAAc,EACxB,OAAO,GAAE,WAAgB,GACxB,SAAS,CAmBX"}

package/lib/components/fill.js

@@ -0,0 +1,37 @@
+// Fill component - fills available width with a character
+import { applyStyle } from '../utils/colors';
+/**
+ * Normalize FillChar to { char, color } format
+ */
+function normalizeFillChar(fillChar) {
+    if (typeof fillChar === 'string') {
+        return { char: fillChar };
+    }
+    return fillChar;
+}
+/**
+ * Fill component - fills the available width with a repeated character
+ *
+ * Usage:
+ *   fill('─')                                    // Simple character
+ *   fill({ char: '─', color: 'red' })           // Character with color
+ *   fill('─', { backgroundColor: 'blue' })      // Character with additional options
+ */
+export function fill(fillChar = ' ', options = {}) {
+    return (ctx) => {
+        const { char, color } = normalizeFillChar(fillChar);
+        const availableWidth = ctx.availableWidth;
+        // During auto column measurement, availableWidth might be Infinity
+        // Fill components have no intrinsic width - they fill available space
+        // So during measurement, return empty string (0 width contribution)
+        if (!Number.isFinite(availableWidth) || availableWidth <= 0) {
+            return '';
+        }
+        const fillText = char.repeat(availableWidth);
+        return applyStyle(fillText, {
+            color,
+            backgroundColor: options.backgroundColor,
+        });
+    };
+}
+//# sourceMappingURL=fill.js.map

package/lib/components/fill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.js","sourceRoot":"","sources":["../../src/components/fill.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAI1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAM7C;;GAEG;AACH,SAAS,iBAAiB,CAAC,QAAkB;IAC3C,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,IAAI,CAClB,WAAqB,GAAG,EACxB,UAAuB,EAAE;IAEzB,OAAO,CAAC,GAAkB,EAAE,EAAE;QAC5B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,cAAc,GAAG,GAAG,CAAC,cAAc,CAAC;QAE1C,mEAAmE;QACnE,sEAAsE;QACtE,oEAAoE;QACpE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;YAC5D,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAE7C,OAAO,UAAU,CAAC,QAAQ,EAAE;YAC1B,KAAK;YACL,eAAe,EAAE,OAAO,CAAC,eAAe;SACzC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/lib/components/index.d.ts

@@ -1,3 +1,3 @@
-export { Spinner } from './spinner';
-export { showPrompt } from './prompt';
+export { Prompt, type PromptOptions } from './prompt';
+export { Section, type SectionOptions } from './section';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/lib/components/index.js

@@ -1,5 +1,5 @@
 // Component helpers and utilities
 // Re-export component classes and functions
-export { Spinner } from './spinner';
-export { showPrompt } from './prompt';
+export { Prompt } from './prompt';
+export { Section } from './section';
 //# sourceMappingURL=index.js.map

package/lib/components/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC,4CAA4C;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC,4CAA4C;AAC5C,OAAO,EAAE,MAAM,EAAsB,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,OAAO,EAAuB,MAAM,WAAW,CAAC"}

package/lib/components/progress-bar-grid.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../layout/grid';
+import type { Component } from '../component';
 import type { Color } from '../types';
 export interface ProgressBarOptions {
     current: number;