gsd-pi 2.34.0 → 2.35.0-dev.30eec3f

package/packages/pi-tui/dist/overlay-layout.js

@@ -0,0 +1,288 @@
+/**
+ * Overlay layout resolution, compositing, and rendering utilities.
+ *
+ * Extracted from tui.ts — these are pure functions that compute overlay
+ * positions and composite overlay content onto base terminal lines.
+ */
+import { extractSegments, sliceByColumn, sliceWithWidth, visibleWidth } from "./utils.js";
+import { isImageLine } from "./terminal-image.js";
+import { CURSOR_MARKER } from "./tui.js";
+// ─── Size parsing ───────────────────────────────────────────────────────────
+/** Parse a SizeValue into absolute value given a reference size */
+export function parseSizeValue(value, referenceSize) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === "number")
+        return value;
+    // Parse percentage string like "50%"
+    const match = value.match(/^(\d+(?:\.\d+)?)%$/);
+    if (match) {
+        return Math.floor((referenceSize * parseFloat(match[1])) / 100);
+    }
+    return undefined;
+}
+// ─── Anchor resolution ──────────────────────────────────────────────────────
+export function resolveAnchorRow(anchor, height, availHeight, marginTop) {
+    switch (anchor) {
+        case "top-left":
+        case "top-center":
+        case "top-right":
+            return marginTop;
+        case "bottom-left":
+        case "bottom-center":
+        case "bottom-right":
+            return marginTop + availHeight - height;
+        case "left-center":
+        case "center":
+        case "right-center":
+            return marginTop + Math.floor((availHeight - height) / 2);
+    }
+}
+export function resolveAnchorCol(anchor, width, availWidth, marginLeft) {
+    switch (anchor) {
+        case "top-left":
+        case "left-center":
+        case "bottom-left":
+            return marginLeft;
+        case "top-right":
+        case "right-center":
+        case "bottom-right":
+            return marginLeft + availWidth - width;
+        case "top-center":
+        case "center":
+        case "bottom-center":
+            return marginLeft + Math.floor((availWidth - width) / 2);
+    }
+}
+/**
+ * Resolve overlay layout from options.
+ * Returns { width, row, col, maxHeight } for rendering.
+ */
+export function resolveOverlayLayout(options, overlayHeight, termWidth, termHeight) {
+    const opt = options ?? {};
+    // Parse margin (clamp to non-negative)
+    const margin = typeof opt.margin === "number"
+        ? { top: opt.margin, right: opt.margin, bottom: opt.margin, left: opt.margin }
+        : (opt.margin ?? {});
+    const marginTop = Math.max(0, margin.top ?? 0);
+    const marginRight = Math.max(0, margin.right ?? 0);
+    const marginBottom = Math.max(0, margin.bottom ?? 0);
+    const marginLeft = Math.max(0, margin.left ?? 0);
+    // Available space after margins
+    const availWidth = Math.max(1, termWidth - marginLeft - marginRight);
+    const availHeight = Math.max(1, termHeight - marginTop - marginBottom);
+    // === Resolve width ===
+    let width = parseSizeValue(opt.width, termWidth) ?? Math.min(80, availWidth);
+    // Apply minWidth
+    if (opt.minWidth !== undefined) {
+        width = Math.max(width, opt.minWidth);
+    }
+    // Clamp to available space
+    width = Math.max(1, Math.min(width, availWidth));
+    // === Resolve maxHeight ===
+    let maxHeight = parseSizeValue(opt.maxHeight, termHeight);
+    // Clamp to available space
+    if (maxHeight !== undefined) {
+        maxHeight = Math.max(1, Math.min(maxHeight, availHeight));
+    }
+    // Effective overlay height (may be clamped by maxHeight)
+    const effectiveHeight = maxHeight !== undefined ? Math.min(overlayHeight, maxHeight) : overlayHeight;
+    // === Resolve position ===
+    let row;
+    let col;
+    if (opt.row !== undefined) {
+        if (typeof opt.row === "string") {
+            // Percentage: 0% = top, 100% = bottom (overlay stays within bounds)
+            const match = opt.row.match(/^(\d+(?:\.\d+)?)%$/);
+            if (match) {
+                const maxRow = Math.max(0, availHeight - effectiveHeight);
+                const percent = parseFloat(match[1]) / 100;
+                row = marginTop + Math.floor(maxRow * percent);
+            }
+            else {
+                // Invalid format, fall back to center
+                row = resolveAnchorRow("center", effectiveHeight, availHeight, marginTop);
+            }
+        }
+        else {
+            // Absolute row position
+            row = opt.row;
+        }
+    }
+    else {
+        // Anchor-based (default: center)
+        const anchor = opt.anchor ?? "center";
+        row = resolveAnchorRow(anchor, effectiveHeight, availHeight, marginTop);
+    }
+    if (opt.col !== undefined) {
+        if (typeof opt.col === "string") {
+            // Percentage: 0% = left, 100% = right (overlay stays within bounds)
+            const match = opt.col.match(/^(\d+(?:\.\d+)?)%$/);
+            if (match) {
+                const maxCol = Math.max(0, availWidth - width);
+                const percent = parseFloat(match[1]) / 100;
+                col = marginLeft + Math.floor(maxCol * percent);
+            }
+            else {
+                // Invalid format, fall back to center
+                col = resolveAnchorCol("center", width, availWidth, marginLeft);
+            }
+        }
+        else {
+            // Absolute column position
+            col = opt.col;
+        }
+    }
+    else {
+        // Anchor-based (default: center)
+        const anchor = opt.anchor ?? "center";
+        col = resolveAnchorCol(anchor, width, availWidth, marginLeft);
+    }
+    // Apply offsets
+    if (opt.offsetY !== undefined)
+        row += opt.offsetY;
+    if (opt.offsetX !== undefined)
+        col += opt.offsetX;
+    // Clamp to terminal bounds (respecting margins)
+    row = Math.max(marginTop, Math.min(row, termHeight - marginBottom - effectiveHeight));
+    col = Math.max(marginLeft, Math.min(col, termWidth - marginRight - width));
+    return { width, row, col, maxHeight };
+}
+// ─── Line compositing ───────────────────────────────────────────────────────
+const SEGMENT_RESET = "\x1b[0m\x1b]8;;\x07";
+/** Append reset sequences to each non-image line. */
+export function applyLineResets(lines) {
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (!isImageLine(line)) {
+            lines[i] = line + SEGMENT_RESET;
+        }
+    }
+    return lines;
+}
+/** Splice overlay content into a base line at a specific column. Single-pass optimized. */
+export function compositeLineAt(baseLine, overlayLine, startCol, overlayWidth, totalWidth) {
+    if (isImageLine(baseLine))
+        return baseLine;
+    // Single pass through baseLine extracts both before and after segments
+    const afterStart = startCol + overlayWidth;
+    const base = extractSegments(baseLine, startCol, afterStart, totalWidth - afterStart, true);
+    // Extract overlay with width tracking (strict=true to exclude wide chars at boundary)
+    const overlay = sliceWithWidth(overlayLine, 0, overlayWidth, true);
+    // Pad segments to target widths
+    const beforePad = Math.max(0, startCol - base.beforeWidth);
+    const overlayPad = Math.max(0, overlayWidth - overlay.width);
+    const actualBeforeWidth = Math.max(startCol, base.beforeWidth);
+    const actualOverlayWidth = Math.max(overlayWidth, overlay.width);
+    const afterTarget = Math.max(0, totalWidth - actualBeforeWidth - actualOverlayWidth);
+    const afterPad = Math.max(0, afterTarget - base.afterWidth);
+    // Compose result
+    const r = SEGMENT_RESET;
+    const result = base.before +
+        " ".repeat(beforePad) +
+        r +
+        overlay.text +
+        " ".repeat(overlayPad) +
+        r +
+        base.after +
+        " ".repeat(afterPad);
+    // CRITICAL: Always verify and truncate to terminal width.
+    // This is the final safeguard against width overflow which would crash the TUI.
+    // Width tracking can drift from actual visible width due to:
+    // - Complex ANSI/OSC sequences (hyperlinks, colors)
+    // - Wide characters at segment boundaries
+    // - Edge cases in segment extraction
+    const resultWidth = visibleWidth(result);
+    if (resultWidth <= totalWidth) {
+        return result;
+    }
+    // Truncate with strict=true to ensure we don't exceed totalWidth
+    return sliceByColumn(result, 0, totalWidth, true);
+}
+/** Check if an overlay entry is currently visible */
+export function isOverlayVisible(entry, termWidth, termHeight) {
+    if (entry.hidden)
+        return false;
+    if (entry.options?.visible) {
+        return entry.options.visible(termWidth, termHeight);
+    }
+    return true;
+}
+/**
+ * Composite all visible overlays into content lines.
+ * Sorted by focusOrder (higher = on top).
+ */
+export function compositeOverlays(lines, overlayStack, termWidth, termHeight, maxLinesRendered) {
+    if (overlayStack.length === 0)
+        return lines;
+    const result = [...lines];
+    // Pre-render all visible overlays and calculate positions
+    const rendered = [];
+    let minLinesNeeded = result.length;
+    const visibleEntries = overlayStack.filter((e) => isOverlayVisible(e, termWidth, termHeight));
+    visibleEntries.sort((a, b) => a.focusOrder - b.focusOrder);
+    for (const entry of visibleEntries) {
+        const { component, options } = entry;
+        // Get layout with height=0 first to determine width and maxHeight
+        // (width and maxHeight don't depend on overlay height)
+        const { width, maxHeight } = resolveOverlayLayout(options, 0, termWidth, termHeight);
+        // Render component at calculated width
+        let overlayLines = component.render(width);
+        // Apply maxHeight if specified
+        if (maxHeight !== undefined && overlayLines.length > maxHeight) {
+            overlayLines = overlayLines.slice(0, maxHeight);
+        }
+        // Get final row/col with actual overlay height
+        const { row, col } = resolveOverlayLayout(options, overlayLines.length, termWidth, termHeight);
+        rendered.push({ overlayLines, row, col, w: width });
+        minLinesNeeded = Math.max(minLinesNeeded, row + overlayLines.length);
+    }
+    // Ensure result covers the terminal working area to keep overlay positioning stable across resizes.
+    // maxLinesRendered can exceed current content length after a shrink; pad to keep viewportStart consistent.
+    const workingHeight = Math.max(maxLinesRendered, minLinesNeeded);
+    // Extend result with empty lines if content is too short for overlay placement or working area
+    while (result.length < workingHeight) {
+        result.push("");
+    }
+    const viewportStart = Math.max(0, workingHeight - termHeight);
+    // Composite each overlay
+    for (const { overlayLines, row, col, w } of rendered) {
+        for (let i = 0; i < overlayLines.length; i++) {
+            const idx = viewportStart + row + i;
+            if (idx >= 0 && idx < result.length) {
+                // Defensive: truncate overlay line to declared width before compositing
+                // (components should already respect width, but this ensures it)
+                const truncatedOverlayLine = visibleWidth(overlayLines[i]) > w ? sliceByColumn(overlayLines[i], 0, w, true) : overlayLines[i];
+                result[idx] = compositeLineAt(result[idx], truncatedOverlayLine, col, w, termWidth);
+            }
+        }
+    }
+    return result;
+}
+// ─── Cursor extraction ──────────────────────────────────────────────────────
+/**
+ * Find and extract cursor position from rendered lines.
+ * Searches for CURSOR_MARKER, calculates its position, and strips it from the output.
+ * Only scans the bottom terminal height lines (visible viewport).
+ * @param lines - Rendered lines to search (mutated to strip marker)
+ * @param height - Terminal height (visible viewport size)
+ * @returns Cursor position { row, col } or null if no marker found
+ */
+export function extractCursorPosition(lines, height) {
+    // Only scan the bottom `height` lines (visible viewport)
+    const viewportTop = Math.max(0, lines.length - height);
+    for (let row = lines.length - 1; row >= viewportTop; row--) {
+        const line = lines[row];
+        const markerIndex = line.indexOf(CURSOR_MARKER);
+        if (markerIndex !== -1) {
+            // Calculate visual column (width of text before marker)
+            const beforeMarker = line.slice(0, markerIndex);
+            const col = visibleWidth(beforeMarker);
+            // Strip marker from the line
+            lines[row] = line.slice(0, markerIndex) + line.slice(markerIndex + CURSOR_MARKER.length);
+            return { row, col };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=overlay-layout.js.map

package/packages/pi-tui/dist/overlay-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-layout.js","sourceRoot":"","sources":["../src/overlay-layout.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Overlay layout resolution, compositing, and rendering utilities.\n *\n * Extracted from tui.ts — these are pure functions that compute overlay\n * positions and composite overlay content onto base terminal lines.\n */\n\nimport type { OverlayAnchor, OverlayOptions, SizeValue } from \"./tui.js\";\nimport { extractSegments, sliceByColumn, sliceWithWidth, truncateToWidth, visibleWidth } from \"./utils.js\";\nimport { isImageLine } from \"./terminal-image.js\";\nimport { CURSOR_MARKER } from \"./tui.js\";\n\n// ─── Size parsing ───────────────────────────────────────────────────────────\n\n/** Parse a SizeValue into absolute value given a reference size */\nexport function parseSizeValue(value: SizeValue | undefined, referenceSize: number): number | undefined {\n\tif (value === undefined) return undefined;\n\tif (typeof value === \"number\") return value;\n\t// Parse percentage string like \"50%\"\n\tconst match = value.match(/^(\\d+(?:\\.\\d+)?)%$/);\n\tif (match) {\n\t\treturn Math.floor((referenceSize * parseFloat(match[1])) / 100);\n\t}\n\treturn undefined;\n}\n\n// ─── Anchor resolution ──────────────────────────────────────────────────────\n\nexport function resolveAnchorRow(\n\tanchor: OverlayAnchor,\n\theight: number,\n\tavailHeight: number,\n\tmarginTop: number,\n): number {\n\tswitch (anchor) {\n\t\tcase \"top-left\":\n\t\tcase \"top-center\":\n\t\tcase \"top-right\":\n\t\t\treturn marginTop;\n\t\tcase \"bottom-left\":\n\t\tcase \"bottom-center\":\n\t\tcase \"bottom-right\":\n\t\t\treturn marginTop + availHeight - height;\n\t\tcase \"left-center\":\n\t\tcase \"center\":\n\t\tcase \"right-center\":\n\t\t\treturn marginTop + Math.floor((availHeight - height) / 2);\n\t}\n}\n\nexport function resolveAnchorCol(\n\tanchor: OverlayAnchor,\n\twidth: number,\n\tavailWidth: number,\n\tmarginLeft: number,\n): number {\n\tswitch (anchor) {\n\t\tcase \"top-left\":\n\t\tcase \"left-center\":\n\t\tcase \"bottom-left\":\n\t\t\treturn marginLeft;\n\t\tcase \"top-right\":\n\t\tcase \"right-center\":\n\t\tcase \"bottom-right\":\n\t\t\treturn marginLeft + availWidth - width;\n\t\tcase \"top-center\":\n\t\tcase \"center\":\n\t\tcase \"bottom-center\":\n\t\t\treturn marginLeft + Math.floor((availWidth - width) / 2);\n\t}\n}\n\n// ─── Overlay layout resolution ──────────────────────────────────────────────\n\nexport interface OverlayLayout {\n\twidth: number;\n\trow: number;\n\tcol: number;\n\tmaxHeight: number | undefined;\n}\n\n/**\n * Resolve overlay layout from options.\n * Returns { width, row, col, maxHeight } for rendering.\n */\nexport function resolveOverlayLayout(\n\toptions: OverlayOptions | undefined,\n\toverlayHeight: number,\n\ttermWidth: number,\n\ttermHeight: number,\n): OverlayLayout {\n\tconst opt = options ?? {};\n\n\t// Parse margin (clamp to non-negative)\n\tconst margin =\n\t\ttypeof opt.margin === \"number\"\n\t\t\t? { top: opt.margin, right: opt.margin, bottom: opt.margin, left: opt.margin }\n\t\t\t: (opt.margin ?? {});\n\tconst marginTop = Math.max(0, margin.top ?? 0);\n\tconst marginRight = Math.max(0, margin.right ?? 0);\n\tconst marginBottom = Math.max(0, margin.bottom ?? 0);\n\tconst marginLeft = Math.max(0, margin.left ?? 0);\n\n\t// Available space after margins\n\tconst availWidth = Math.max(1, termWidth - marginLeft - marginRight);\n\tconst availHeight = Math.max(1, termHeight - marginTop - marginBottom);\n\n\t// === Resolve width ===\n\tlet width = parseSizeValue(opt.width, termWidth) ?? Math.min(80, availWidth);\n\t// Apply minWidth\n\tif (opt.minWidth !== undefined) {\n\t\twidth = Math.max(width, opt.minWidth);\n\t}\n\t// Clamp to available space\n\twidth = Math.max(1, Math.min(width, availWidth));\n\n\t// === Resolve maxHeight ===\n\tlet maxHeight = parseSizeValue(opt.maxHeight, termHeight);\n\t// Clamp to available space\n\tif (maxHeight !== undefined) {\n\t\tmaxHeight = Math.max(1, Math.min(maxHeight, availHeight));\n\t}\n\n\t// Effective overlay height (may be clamped by maxHeight)\n\tconst effectiveHeight = maxHeight !== undefined ? Math.min(overlayHeight, maxHeight) : overlayHeight;\n\n\t// === Resolve position ===\n\tlet row: number;\n\tlet col: number;\n\n\tif (opt.row !== undefined) {\n\t\tif (typeof opt.row === \"string\") {\n\t\t\t// Percentage: 0% = top, 100% = bottom (overlay stays within bounds)\n\t\t\tconst match = opt.row.match(/^(\\d+(?:\\.\\d+)?)%$/);\n\t\t\tif (match) {\n\t\t\t\tconst maxRow = Math.max(0, availHeight - effectiveHeight);\n\t\t\t\tconst percent = parseFloat(match[1]) / 100;\n\t\t\t\trow = marginTop + Math.floor(maxRow * percent);\n\t\t\t} else {\n\t\t\t\t// Invalid format, fall back to center\n\t\t\t\trow = resolveAnchorRow(\"center\", effectiveHeight, availHeight, marginTop);\n\t\t\t}\n\t\t} else {\n\t\t\t// Absolute row position\n\t\t\trow = opt.row;\n\t\t}\n\t} else {\n\t\t// Anchor-based (default: center)\n\t\tconst anchor = opt.anchor ?? \"center\";\n\t\trow = resolveAnchorRow(anchor, effectiveHeight, availHeight, marginTop);\n\t}\n\n\tif (opt.col !== undefined) {\n\t\tif (typeof opt.col === \"string\") {\n\t\t\t// Percentage: 0% = left, 100% = right (overlay stays within bounds)\n\t\t\tconst match = opt.col.match(/^(\\d+(?:\\.\\d+)?)%$/);\n\t\t\tif (match) {\n\t\t\t\tconst maxCol = Math.max(0, availWidth - width);\n\t\t\t\tconst percent = parseFloat(match[1]) / 100;\n\t\t\t\tcol = marginLeft + Math.floor(maxCol * percent);\n\t\t\t} else {\n\t\t\t\t// Invalid format, fall back to center\n\t\t\t\tcol = resolveAnchorCol(\"center\", width, availWidth, marginLeft);\n\t\t\t}\n\t\t} else {\n\t\t\t// Absolute column position\n\t\t\tcol = opt.col;\n\t\t}\n\t} else {\n\t\t// Anchor-based (default: center)\n\t\tconst anchor = opt.anchor ?? \"center\";\n\t\tcol = resolveAnchorCol(anchor, width, availWidth, marginLeft);\n\t}\n\n\t// Apply offsets\n\tif (opt.offsetY !== undefined) row += opt.offsetY;\n\tif (opt.offsetX !== undefined) col += opt.offsetX;\n\n\t// Clamp to terminal bounds (respecting margins)\n\trow = Math.max(marginTop, Math.min(row, termHeight - marginBottom - effectiveHeight));\n\tcol = Math.max(marginLeft, Math.min(col, termWidth - marginRight - width));\n\n\treturn { width, row, col, maxHeight };\n}\n\n// ─── Line compositing ───────────────────────────────────────────────────────\n\nconst SEGMENT_RESET = \"\\x1b[0m\\x1b]8;;\\x07\";\n\n/** Append reset sequences to each non-image line. */\nexport function applyLineResets(lines: string[]): string[] {\n\tfor (let i = 0; i < lines.length; i++) {\n\t\tconst line = lines[i];\n\t\tif (!isImageLine(line)) {\n\t\t\tlines[i] = line + SEGMENT_RESET;\n\t\t}\n\t}\n\treturn lines;\n}\n\n/** Splice overlay content into a base line at a specific column. Single-pass optimized. */\nexport function compositeLineAt(\n\tbaseLine: string,\n\toverlayLine: string,\n\tstartCol: number,\n\toverlayWidth: number,\n\ttotalWidth: number,\n): string {\n\tif (isImageLine(baseLine)) return baseLine;\n\n\t// Single pass through baseLine extracts both before and after segments\n\tconst afterStart = startCol + overlayWidth;\n\tconst base = extractSegments(baseLine, startCol, afterStart, totalWidth - afterStart, true);\n\n\t// Extract overlay with width tracking (strict=true to exclude wide chars at boundary)\n\tconst overlay = sliceWithWidth(overlayLine, 0, overlayWidth, true);\n\n\t// Pad segments to target widths\n\tconst beforePad = Math.max(0, startCol - base.beforeWidth);\n\tconst overlayPad = Math.max(0, overlayWidth - overlay.width);\n\tconst actualBeforeWidth = Math.max(startCol, base.beforeWidth);\n\tconst actualOverlayWidth = Math.max(overlayWidth, overlay.width);\n\tconst afterTarget = Math.max(0, totalWidth - actualBeforeWidth - actualOverlayWidth);\n\tconst afterPad = Math.max(0, afterTarget - base.afterWidth);\n\n\t// Compose result\n\tconst r = SEGMENT_RESET;\n\tconst result =\n\t\tbase.before +\n\t\t\" \".repeat(beforePad) +\n\t\tr +\n\t\toverlay.text +\n\t\t\" \".repeat(overlayPad) +\n\t\tr +\n\t\tbase.after +\n\t\t\" \".repeat(afterPad);\n\n\t// CRITICAL: Always verify and truncate to terminal width.\n\t// This is the final safeguard against width overflow which would crash the TUI.\n\t// Width tracking can drift from actual visible width due to:\n\t// - Complex ANSI/OSC sequences (hyperlinks, colors)\n\t// - Wide characters at segment boundaries\n\t// - Edge cases in segment extraction\n\tconst resultWidth = visibleWidth(result);\n\tif (resultWidth <= totalWidth) {\n\t\treturn result;\n\t}\n\t// Truncate with strict=true to ensure we don't exceed totalWidth\n\treturn sliceByColumn(result, 0, totalWidth, true);\n}\n\n// ─── Overlay compositing ────────────────────────────────────────────────────\n\nexport interface OverlayEntry {\n\tcomponent: { render(width: number): string[]; invalidate?(): void };\n\toptions?: OverlayOptions;\n\thidden: boolean;\n\tfocusOrder: number;\n}\n\n/** Check if an overlay entry is currently visible */\nexport function isOverlayVisible(\n\tentry: OverlayEntry,\n\ttermWidth: number,\n\ttermHeight: number,\n): boolean {\n\tif (entry.hidden) return false;\n\tif (entry.options?.visible) {\n\t\treturn entry.options.visible(termWidth, termHeight);\n\t}\n\treturn true;\n}\n\n/**\n * Composite all visible overlays into content lines.\n * Sorted by focusOrder (higher = on top).\n */\nexport function compositeOverlays(\n\tlines: string[],\n\toverlayStack: OverlayEntry[],\n\ttermWidth: number,\n\ttermHeight: number,\n\tmaxLinesRendered: number,\n): string[] {\n\tif (overlayStack.length === 0) return lines;\n\tconst result = [...lines];\n\n\t// Pre-render all visible overlays and calculate positions\n\tconst rendered: { overlayLines: string[]; row: number; col: number; w: number }[] = [];\n\tlet minLinesNeeded = result.length;\n\n\tconst visibleEntries = overlayStack.filter((e) => isOverlayVisible(e, termWidth, termHeight));\n\tvisibleEntries.sort((a, b) => a.focusOrder - b.focusOrder);\n\tfor (const entry of visibleEntries) {\n\t\tconst { component, options } = entry;\n\n\t\t// Get layout with height=0 first to determine width and maxHeight\n\t\t// (width and maxHeight don't depend on overlay height)\n\t\tconst { width, maxHeight } = resolveOverlayLayout(options, 0, termWidth, termHeight);\n\n\t\t// Render component at calculated width\n\t\tlet overlayLines = component.render(width);\n\n\t\t// Apply maxHeight if specified\n\t\tif (maxHeight !== undefined && overlayLines.length > maxHeight) {\n\t\t\toverlayLines = overlayLines.slice(0, maxHeight);\n\t\t}\n\n\t\t// Get final row/col with actual overlay height\n\t\tconst { row, col } = resolveOverlayLayout(options, overlayLines.length, termWidth, termHeight);\n\n\t\trendered.push({ overlayLines, row, col, w: width });\n\t\tminLinesNeeded = Math.max(minLinesNeeded, row + overlayLines.length);\n\t}\n\n\t// Ensure result covers the terminal working area to keep overlay positioning stable across resizes.\n\t// maxLinesRendered can exceed current content length after a shrink; pad to keep viewportStart consistent.\n\tconst workingHeight = Math.max(maxLinesRendered, minLinesNeeded);\n\n\t// Extend result with empty lines if content is too short for overlay placement or working area\n\twhile (result.length < workingHeight) {\n\t\tresult.push(\"\");\n\t}\n\n\tconst viewportStart = Math.max(0, workingHeight - termHeight);\n\n\t// Composite each overlay\n\tfor (const { overlayLines, row, col, w } of rendered) {\n\t\tfor (let i = 0; i < overlayLines.length; i++) {\n\t\t\tconst idx = viewportStart + row + i;\n\t\t\tif (idx >= 0 && idx < result.length) {\n\t\t\t\t// Defensive: truncate overlay line to declared width before compositing\n\t\t\t\t// (components should already respect width, but this ensures it)\n\t\t\t\tconst truncatedOverlayLine =\n\t\t\t\t\tvisibleWidth(overlayLines[i]) > w ? sliceByColumn(overlayLines[i], 0, w, true) : overlayLines[i];\n\t\t\t\tresult[idx] = compositeLineAt(result[idx], truncatedOverlayLine, col, w, termWidth);\n\t\t\t}\n\t\t}\n\t}\n\n\treturn result;\n}\n\n// ─── Cursor extraction ──────────────────────────────────────────────────────\n\n/**\n * Find and extract cursor position from rendered lines.\n * Searches for CURSOR_MARKER, calculates its position, and strips it from the output.\n * Only scans the bottom terminal height lines (visible viewport).\n * @param lines - Rendered lines to search (mutated to strip marker)\n * @param height - Terminal height (visible viewport size)\n * @returns Cursor position { row, col } or null if no marker found\n */\nexport function extractCursorPosition(lines: string[], height: number): { row: number; col: number } | null {\n\t// Only scan the bottom `height` lines (visible viewport)\n\tconst viewportTop = Math.max(0, lines.length - height);\n\tfor (let row = lines.length - 1; row >= viewportTop; row--) {\n\t\tconst line = lines[row];\n\t\tconst markerIndex = line.indexOf(CURSOR_MARKER);\n\t\tif (markerIndex !== -1) {\n\t\t\t// Calculate visual column (width of text before marker)\n\t\t\tconst beforeMarker = line.slice(0, markerIndex);\n\t\t\tconst col = visibleWidth(beforeMarker);\n\n\t\t\t// Strip marker from the line\n\t\t\tlines[row] = line.slice(0, markerIndex) + line.slice(markerIndex + CURSOR_MARKER.length);\n\n\t\t\treturn { row, col };\n\t\t}\n\t}\n\treturn null;\n}\n"]}

package/packages/pi-tui/dist/tui.d.ts

@@ -187,28 +187,6 @@ export declare class TUI extends Container {
     requestRender(force?: boolean): void;
     private handleInput;
     private parseCellSizeResponse;
-    /**
-     * Resolve overlay layout from options.
-     * Returns { width, row, col, maxHeight } for rendering.
-     */
-    private resolveOverlayLayout;
-    private resolveAnchorRow;
-    private resolveAnchorCol;
-    /** Composite all overlays into content lines (sorted by focusOrder, higher = on top). */
-    private compositeOverlays;
-    private static readonly SEGMENT_RESET;
-    private applyLineResets;
-    /** Splice overlay content into a base line at a specific column. Single-pass optimized. */
-    private compositeLineAt;
-    /**
-     * Find and extract cursor position from rendered lines.
-     * Searches for CURSOR_MARKER, calculates its position, and strips it from the output.
-     * Only scans the bottom terminal height lines (visible viewport).
-     * @param lines - Rendered lines to search
-     * @param height - Terminal height (visible viewport size)
-     * @returns Cursor position { row, col } or null if no marker found
-     */
-    private extractCursorPosition;
     private doRender;
     /**
      * Position the hardware cursor for IME candidate window.

package/packages/pi-tui/dist/tui.d.ts.map

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