@jx-grxf/patchpilot 0.4.0 → 1.2.0

package/dist/tui/experimental/attachments.js

@@ -0,0 +1,244 @@
+const extensionKinds = {
+    ".png": "image",
+    ".jpg": "image",
+    ".jpeg": "image",
+    ".gif": "image",
+    ".webp": "image",
+    ".heic": "image",
+    ".heif": "image",
+    ".pdf": "pdf",
+    ".docx": "docx",
+    ".doc": "docx",
+    ".svg": "text",
+    ".md": "text",
+    ".txt": "text",
+    ".rtf": "text",
+    ".json": "text",
+    ".jsonl": "text",
+    ".csv": "text",
+    ".yaml": "text",
+    ".yml": "text",
+    ".toml": "text",
+    ".xml": "text",
+    ".html": "text",
+    ".htm": "text",
+    ".css": "text",
+    ".scss": "text",
+    ".js": "text",
+    ".jsx": "text",
+    ".ts": "text",
+    ".tsx": "text",
+    ".mjs": "text",
+    ".mts": "text",
+    ".cjs": "text",
+    ".ini": "text",
+    ".tsv": "text",
+    ".py": "text",
+    ".java": "text",
+    ".kt": "text",
+    ".go": "text",
+    ".rs": "text",
+    ".php": "text",
+    ".rb": "text",
+    ".swift": "text",
+    ".c": "text",
+    ".cc": "text",
+    ".cpp": "text",
+    ".h": "text",
+    ".hpp": "text",
+    ".sh": "text",
+    ".zsh": "text",
+    ".bash": "text",
+    ".sql": "text",
+    ".log": "text",
+    ".diff": "text",
+    ".patch": "text",
+};
+/** Classify a path by extension; null if it is not an attachable document. */
+export function attachmentKindForPath(path) {
+    const match = /\.[A-Za-z0-9]+$/.exec(path.trim());
+    if (!match) {
+        return null;
+    }
+    return extensionKinds[match[0].toLowerCase()] ?? null;
+}
+/** Remove a single layer of surrounding single/double quotes. */
+export function stripQuotes(value) {
+    if (value.length >= 2 && ((value[0] === '"' && value.at(-1) === '"') || (value[0] === "'" && value.at(-1) === "'"))) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+/** Does this value look like a Windows path (drive-letter or UNC)? */
+function looksLikeWindowsPath(value) {
+    return /^[A-Za-z]:[\\/]/.test(value) || value.startsWith("\\\\");
+}
+/**
+ * Strip POSIX shell-escape backslashes (e.g. `\ ` for a space) without
+ * destroying Windows path separators. A backslash only acts as an escape when
+ * it precedes whitespace or a quote; a backslash before any other character is
+ * treated as a literal Windows path separator and kept.
+ */
+function stripShellEscapes(value) {
+    return value.replace(/\\([\s'"])/g, "$1");
+}
+function stripFileUrlPrefix(value) {
+    // file:///C:/path -> C:/path ; file:///home/x -> /home/x ; file://host/share -> //host/share
+    const withoutScheme = value.replace(/^file:\/\//i, "");
+    if (/^\/[A-Za-z]:[\\/]/.test(withoutScheme)) {
+        return withoutScheme.slice(1);
+    }
+    return withoutScheme;
+}
+export function normalizeAttachmentPath(value) {
+    const unquoted = stripQuotes(value.trim());
+    if (/^file:\/\//i.test(unquoted)) {
+        try {
+            return stripFileUrlPrefix(decodeURIComponent(unquoted));
+        }
+        catch {
+            return stripFileUrlPrefix(unquoted);
+        }
+    }
+    return stripShellEscapes(unquoted);
+}
+function looksLikeAttachablePath(value, options) {
+    const trimmed = normalizeAttachmentPath(value);
+    if (!trimmed || attachmentKindForPath(trimmed) === null) {
+        return false;
+    }
+    const pathLike = trimmed.startsWith("/") ||
+        trimmed.startsWith("~") ||
+        trimmed.startsWith("./") ||
+        trimmed.startsWith(".\\") ||
+        trimmed.includes("/") ||
+        looksLikeWindowsPath(trimmed) ||
+        trimmed.includes("\\");
+    const raw = value.trim();
+    const wasQuoted = raw !== stripQuotes(raw);
+    const hadEscapedSpace = /\\\s/.test(raw);
+    const hasInnerSpace = /\s/.test(stripQuotes(raw));
+    return pathLike && (options.allowSpaces || wasQuoted || hadEscapedSpace || !hasInnerSpace);
+}
+/**
+ * Heuristic: does this pasted/typed value look like a single filesystem path
+ * to an attachable document? Accepts absolute, home-relative, and quoted
+ * paths; rejects free-form prose.
+ */
+export function looksLikeAttachmentPath(value) {
+    return looksLikeAttachablePath(value, { allowSpaces: false });
+}
+export function attachmentTypeForPath(path) {
+    const match = /\.[A-Za-z0-9]+$/.exec(normalizeAttachmentPath(path));
+    if (!match) {
+        return "FILE";
+    }
+    const extension = match[0].slice(1).toUpperCase();
+    return extension === "JPEG" ? "JPG" : extension;
+}
+/** Human label for an attachment chip, e.g. "[PNG #2]". */
+export function attachmentLabel(kind, index, path) {
+    const type = path ? attachmentTypeForPath(path) : kind.toUpperCase();
+    return `[${type} #${index}]`;
+}
+export function extractAttachmentPaths(value) {
+    const sanitized = sanitizePastedText(value);
+    const lines = sanitized
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean);
+    if (lines.length > 1 && lines.every((line) => looksLikeAttachablePath(line, { allowSpaces: true }))) {
+        return lines.map(normalizeAttachmentPath);
+    }
+    const tokens = splitShellLikePaths(sanitized);
+    if (tokens.length > 0 && tokens.every((token) => looksLikeAttachablePath(token, { allowSpaces: false }))) {
+        return tokens.map(normalizeAttachmentPath);
+    }
+    return null;
+}
+function splitShellLikePaths(value) {
+    const tokens = [];
+    let current = "";
+    let quote = null;
+    let escaping = false;
+    // A backslash only acts as a POSIX shell escape when it precedes whitespace
+    // or a quote. Otherwise (e.g. inside a Windows path) it is a literal char.
+    const chars = [...value.trim()];
+    for (let index = 0; index < chars.length; index += 1) {
+        const char = chars[index];
+        if (escaping) {
+            current += `\\${char}`;
+            escaping = false;
+            continue;
+        }
+        if (char === "\\") {
+            const next = chars[index + 1];
+            if (next === undefined || /\s/.test(next) || next === "'" || next === '"') {
+                escaping = true;
+                continue;
+            }
+            current += char;
+            continue;
+        }
+        if ((char === "\"" || char === "'") && !quote) {
+            quote = char;
+            current += char;
+            continue;
+        }
+        if (quote === char) {
+            quote = null;
+            current += char;
+            continue;
+        }
+        if (!quote && /\s/.test(char)) {
+            if (current) {
+                tokens.push(current);
+                current = "";
+            }
+            continue;
+        }
+        current += char;
+    }
+    if (escaping) {
+        current += "\\";
+    }
+    if (current) {
+        tokens.push(current);
+    }
+    return tokens;
+}
+const kindSymbols = {
+    image: "▣",
+    pdf: "▤",
+    docx: "▥",
+    text: "▦",
+    file: "▧",
+};
+export function attachmentSymbol(kind) {
+    return kindSymbols[kind];
+}
+export function formatSessionArtifactContext(artifacts, limit = 12) {
+    const visibleArtifacts = artifacts.slice(-limit);
+    if (visibleArtifacts.length === 0) {
+        return "";
+    }
+    return [
+        "Known session attachments and artifacts (most recent last).",
+        "If the user asks about a prior uploaded file or artifact, use these paths and inspect the document before answering; provider chat state may not retain file inputs across PatchPilot runs.",
+        ...visibleArtifacts.map((artifact) => {
+            const type = attachmentTypeForPath(artifact.path);
+            return `- ${artifact.label} origin=${artifact.origin} type=${type} path=${JSON.stringify(artifact.path)}`;
+        })
+    ].join("\n");
+}
+// Control characters except tab (\t) and newline (\n) — built via escapes so
+// no raw control bytes live in this source file.
+const controlCharsPattern = new RegExp("[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]", "g");
+/**
+ * Normalise pasted text: drop carriage returns and stray control characters
+ * (keeping tabs/newlines) so a multi-line paste does not corrupt the editor.
+ */
+export function sanitizePastedText(value) {
+    return value.replace(/\r\n?/g, "\n").replace(controlCharsPattern, "");
+}
+//# sourceMappingURL=attachments.js.map

package/dist/tui/experimental/attachments.js.map

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

package/dist/tui/experimental/composer.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Cursor-aware view model for the experimental composer. The composer keeps a
+ * cursor position so the user can navigate inside the draft with the arrow
+ * keys, not just append at the end.
+ */
+export type ComposerView = {
+    rows: string[];
+    cursorRow: number;
+    cursorCol: number;
+    hiddenAbove: number;
+    totalRows: number;
+};
+export type ComposerEditResult = {
+    input: string;
+    cursor: number;
+};
+export declare function insertComposerText(input: string, cursor: number, text: string): ComposerEditResult;
+export declare function deleteComposerText(input: string, cursor: number, direction: "backward" | "forward"): ComposerEditResult;
+/**
+ * Build the visible composer view for a given draft, cursor index and width.
+ * The window of `editorRows` rows always includes the cursor row, so moving
+ * the cursor up into earlier text scrolls the editor to follow it.
+ */
+export declare function composerView(input: string, cursor: number, width: number, editorRows: number): ComposerView;

package/dist/tui/experimental/composer.js

@@ -0,0 +1,84 @@
+export function insertComposerText(input, cursor, text) {
+    const safeCursor = clampCursor(input, cursor);
+    return {
+        input: `${input.slice(0, safeCursor)}${text}${input.slice(safeCursor)}`,
+        cursor: safeCursor + text.length,
+    };
+}
+export function deleteComposerText(input, cursor, direction) {
+    const safeCursor = clampCursor(input, cursor);
+    if (direction === "backward") {
+        if (safeCursor === 0) {
+            return { input, cursor: safeCursor };
+        }
+        return {
+            input: `${input.slice(0, safeCursor - 1)}${input.slice(safeCursor)}`,
+            cursor: safeCursor - 1,
+        };
+    }
+    if (safeCursor >= input.length) {
+        return { input, cursor: safeCursor };
+    }
+    return {
+        input: `${input.slice(0, safeCursor)}${input.slice(safeCursor + 1)}`,
+        cursor: safeCursor,
+    };
+}
+/** Wrap a draft into rows, preserving explicit newlines, hard-chunking long lines. */
+function wrapRows(input, width) {
+    const safeWidth = Math.max(1, width);
+    const rows = [];
+    const paragraphs = input.length > 0 ? input.split("\n") : [""];
+    for (const paragraph of paragraphs) {
+        if (paragraph.length === 0) {
+            rows.push("");
+            continue;
+        }
+        for (let index = 0; index < paragraph.length; index += safeWidth) {
+            rows.push(paragraph.slice(index, index + safeWidth));
+        }
+    }
+    return rows.length > 0 ? rows : [""];
+}
+/**
+ * Build the visible composer view for a given draft, cursor index and width.
+ * The window of `editorRows` rows always includes the cursor row, so moving
+ * the cursor up into earlier text scrolls the editor to follow it.
+ */
+export function composerView(input, cursor, width, editorRows) {
+    const safeWidth = Math.max(1, width);
+    const visibleRows = Math.max(1, editorRows);
+    const clampedCursor = clampCursor(input, cursor);
+    const allRows = wrapRows(input, safeWidth);
+    // Locate the cursor by walking the paragraphs the same way wrapRows does.
+    const paragraphs = input.length > 0 ? input.split("\n") : [""];
+    let rowBase = 0;
+    let consumed = 0;
+    let cursorRow = 0;
+    let cursorCol = 0;
+    for (const paragraph of paragraphs) {
+        const rowsInParagraph = paragraph.length === 0 ? 1 : Math.ceil(paragraph.length / safeWidth);
+        if (clampedCursor >= consumed && clampedCursor <= consumed + paragraph.length) {
+            const offset = clampedCursor - consumed;
+            const rowWithin = Math.min(rowsInParagraph - 1, Math.floor(offset / safeWidth));
+            cursorRow = rowBase + rowWithin;
+            cursorCol = offset - rowWithin * safeWidth;
+        }
+        rowBase += rowsInParagraph;
+        consumed += paragraph.length + 1; // +1 for the newline
+    }
+    const maxStart = Math.max(0, allRows.length - visibleRows);
+    const start = Math.max(0, Math.min(cursorRow - visibleRows + 1, maxStart, cursorRow));
+    const windowed = allRows.slice(start, start + visibleRows);
+    return {
+        rows: windowed,
+        cursorRow: cursorRow - start,
+        cursorCol,
+        hiddenAbove: start,
+        totalRows: allRows.length,
+    };
+}
+function clampCursor(input, cursor) {
+    return Math.max(0, Math.min(Math.trunc(cursor), input.length));
+}
+//# sourceMappingURL=composer.js.map

package/dist/tui/experimental/composer.js.map

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

package/dist/tui/experimental/geminiPricing.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Public Gemini API token pricing (USD per 1M tokens), used to show how much
+ * a gemini-wrapper session *would* have cost on the paid API — i.e. what the
+ * free Gemini Web route saved. Prices verified May 2026 from
+ * ai.google.dev/gemini-api/docs/pricing.
+ */
+export type TokenPrice = {
+    inputPerMillion: number;
+    outputPerMillion: number;
+};
+/** Resolve the public API price for a Gemini model id. */
+export declare function geminiPriceFor(model: string): TokenPrice;
+/** Estimate the paid-API cost (USD) of the given token counts for a model. */
+export declare function estimateGeminiCost(promptTokens: number, responseTokens: number, model: string): number;
+/** Format a saved-cost figure for the header counter. */
+export declare function formatSavedCost(usd: number): string;

package/dist/tui/experimental/geminiPricing.js

@@ -0,0 +1,39 @@
+const pricingTable = [
+    // Gemini 3.x Pro tier.
+    { pattern: /(gemini-?3|3\.\d).*pro|gemini-?3-pro/i, price: { inputPerMillion: 2, outputPerMillion: 12 } },
+    // Gemini 2.5 Pro.
+    { pattern: /2[._-]?5.*pro|gemini-pro|^pro$/i, price: { inputPerMillion: 1.25, outputPerMillion: 10 } },
+    // Flash-Lite.
+    { pattern: /flash[-_ ]?lite/i, price: { inputPerMillion: 0.1, outputPerMillion: 0.4 } },
+    // Gemini 2.5 / 2.0 Flash.
+    { pattern: /flash/i, price: { inputPerMillion: 0.3, outputPerMillion: 2.5 } },
+];
+// "auto" and unknown models: assume the Flash tier (the common default route).
+const fallbackPrice = { inputPerMillion: 0.3, outputPerMillion: 2.5 };
+/** Resolve the public API price for a Gemini model id. */
+export function geminiPriceFor(model) {
+    for (const entry of pricingTable) {
+        if (entry.pattern.test(model)) {
+            return entry.price;
+        }
+    }
+    return fallbackPrice;
+}
+/** Estimate the paid-API cost (USD) of the given token counts for a model. */
+export function estimateGeminiCost(promptTokens, responseTokens, model) {
+    const price = geminiPriceFor(model);
+    const safePrompt = Math.max(0, promptTokens || 0);
+    const safeResponse = Math.max(0, responseTokens || 0);
+    return (safePrompt / 1_000_000) * price.inputPerMillion + (safeResponse / 1_000_000) * price.outputPerMillion;
+}
+/** Format a saved-cost figure for the header counter. */
+export function formatSavedCost(usd) {
+    if (!Number.isFinite(usd) || usd <= 0) {
+        return "$0.00";
+    }
+    if (usd < 0.01) {
+        return "<$0.01";
+    }
+    return `$${usd.toFixed(2)}`;
+}
+//# sourceMappingURL=geminiPricing.js.map

package/dist/tui/experimental/geminiPricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geminiPricing.js","sourceRoot":"","sources":["../../../src/tui/experimental/geminiPricing.ts"],"names":[],"mappings":"AAWA,MAAM,YAAY,GAAkD;IAClE,uBAAuB;IACvB,EAAE,OAAO,EAAE,uCAAuC,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE,EAAE;IACzG,kBAAkB;IAClB,EAAE,OAAO,EAAE,iCAAiC,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,EAAE;IACtG,cAAc;IACd,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,EAAE;IACvF,0BAA0B;IAC1B,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,EAAE;CAC9E,CAAC;AAEF,+EAA+E;AAC/E,MAAM,aAAa,GAAe,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC;AAElF,0DAA0D;AAC1D,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB,CAAC,YAAoB,EAAE,cAAsB,EAAE,KAAa;IAC5F,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,IAAI,CAAC,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,IAAI,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,GAAG,KAAK,CAAC,eAAe,GAAG,CAAC,YAAY,GAAG,SAAS,CAAC,GAAG,KAAK,CAAC,gBAAgB,CAAC;AAChH,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACtC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,GAAG,GAAG,IAAI,EAAE,CAAC;QACf,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9B,CAAC"}

package/dist/tui/experimental/layout.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Layout math for the experimental fullscreen shell. Kept as pure functions so
+ * the 80x24 / 120x40 / 207x47 acceptance cases can be covered without
+ * rendering Ink.
+ */
+export type ExperimentalLayout = {
+    rootHeight: number;
+    rootWidth: number;
+    headerHeight: number;
+    bodyHeight: number;
+    transcriptHeight: number;
+    transcriptWidth: number;
+    composerHeight: number;
+    approvalHeight: number;
+    paletteHeight: number;
+    todoDockHeight: number;
+    artifactsHeight: number;
+    footerHeight: number;
+};
+/** Height of the todo dock panel for a given number of todos (0 = hidden). */
+export declare function todoDockHeightFor(todoCount: number): number;
+export declare function computeExperimentalLayout(options: {
+    rows: number;
+    columns: number;
+    composerInput: string;
+    paletteItemCount: number;
+    approvalActive: boolean;
+    todoCount?: number;
+    hasArtifacts?: boolean;
+}): ExperimentalLayout;
+export type RowWindow = {
+    start: number;
+    end: number;
+    anchored: "top" | "bottom";
+    clampedOffset: number;
+    hasOverflow: boolean;
+};
+/**
+ * Window a list of rows into a viewport.
+ *
+ * - When the content fits, it is anchored to the TOP (short outputs start at
+ *   the top, no artificial blank lines — the caller pads with flexGrow).
+ * - When it overflows, it is anchored to the BOTTOM and `scrollOffset` walks
+ *   the window upward.
+ */
+export declare function windowRows(totalRows: number, viewportHeight: number, scrollOffset: number): RowWindow;

package/dist/tui/experimental/layout.js

@@ -0,0 +1,112 @@
+import { computeComposerLayout } from "../layout.js";
+const MIN_ROWS = 24;
+const MIN_COLUMNS = 80;
+const HEADER_HEIGHT = 4;
+const FOOTER_HEIGHT = 1;
+const APPROVAL_HEIGHT = 8;
+const MIN_TRANSCRIPT_HEIGHT = 3;
+const MAX_PALETTE_ROWS = 8;
+const MAX_TODO_DOCK_ROWS = 6;
+/** Height of the todo dock panel for a given number of todos (0 = hidden). */
+export function todoDockHeightFor(todoCount) {
+    const count = Math.max(0, Math.floor(todoCount));
+    if (count === 0) {
+        return 0;
+    }
+    // header row + up to MAX_TODO_DOCK_ROWS items + rounded border (2).
+    return Math.min(count, MAX_TODO_DOCK_ROWS) + 1 + 2;
+}
+// Minimum height the todo dock may be folded down to: border (2) + header +
+// one visible item. Below this it is dropped entirely.
+const MIN_TODO_DOCK_HEIGHT = 4;
+export function computeExperimentalLayout(options) {
+    const rootHeight = Math.max(MIN_ROWS, Math.floor(options.rows) || MIN_ROWS);
+    const rootWidth = Math.max(MIN_COLUMNS, Math.floor(options.columns) || MIN_COLUMNS);
+    // Inner content width: 1 cell of horizontal padding on each side.
+    const contentWidth = Math.max(40, rootWidth - 2);
+    // Transcript and composer sit inside a rounded border (2 columns).
+    const transcriptWidth = Math.max(32, contentWidth - 2);
+    const composerEditor = computeComposerLayout({
+        input: options.composerInput,
+        width: transcriptWidth,
+        promptWidth: 2,
+        minHeight: 3,
+        maxHeight: 7,
+    });
+    // composer editor rows + status row + rounded border.
+    const composerHeight = composerEditor.height + 2;
+    const approvalHeight = options.approvalActive ? APPROVAL_HEIGHT : 0;
+    // Priority allocator: header, the blocking prompt, the composer and the
+    // footer are critical safety surfaces — they get their full height first and
+    // are never clipped. Whatever is left is shared between the transcript and
+    // the secondary panels (palette, todos, artifacts), which fold before any
+    // critical UI is touched.
+    const critical = HEADER_HEIGHT + FOOTER_HEIGHT + composerHeight + approvalHeight;
+    const paletteRows = Math.min(MAX_PALETTE_ROWS, Math.max(0, options.paletteItemCount));
+    // palette: header row + items + preview block (3) + border.
+    const paletteDesired = paletteRows > 0 ? paletteRows + 6 : 0;
+    const todoDesired = todoDockHeightFor(options.todoCount ?? 0);
+    // Artifacts bar: rounded border (2) + one chip row.
+    const artifactsDesired = options.hasArtifacts ? 3 : 0;
+    // Budget for the secondary panels, after reserving the transcript minimum.
+    let budget = Math.max(0, rootHeight - critical - MIN_TRANSCRIPT_HEIGHT);
+    // Palette is highest priority while open — the user is actively navigating
+    // it — so it gets its full height or nothing.
+    const paletteHeight = paletteDesired > 0 && budget >= paletteDesired ? paletteDesired : 0;
+    budget -= paletteHeight;
+    // Todos may fold: full height if it fits, otherwise shrunk to whatever space
+    // is left down to MIN_TODO_DOCK_HEIGHT, else dropped.
+    let todoDockHeight = 0;
+    if (todoDesired > 0) {
+        if (budget >= todoDesired) {
+            todoDockHeight = todoDesired;
+        }
+        else if (budget >= MIN_TODO_DOCK_HEIGHT) {
+            todoDockHeight = budget;
+        }
+    }
+    budget -= todoDockHeight;
+    // Artifacts bar is lowest priority — shown only if it still fits whole.
+    const artifactsHeight = artifactsDesired > 0 && budget >= artifactsDesired ? artifactsDesired : 0;
+    const secondary = paletteHeight + todoDockHeight + artifactsHeight;
+    // The transcript flexes into the remainder. It keeps its minimum whenever the
+    // critical UI fits; on extreme terminals it yields below the minimum so the
+    // composer and prompts always stay fully visible.
+    const transcriptHeight = Math.max(1, rootHeight - critical - secondary);
+    const bodyHeight = rootHeight - HEADER_HEIGHT;
+    return {
+        rootHeight,
+        rootWidth,
+        headerHeight: HEADER_HEIGHT,
+        bodyHeight,
+        transcriptHeight,
+        transcriptWidth,
+        composerHeight,
+        approvalHeight,
+        paletteHeight,
+        todoDockHeight,
+        artifactsHeight,
+        footerHeight: FOOTER_HEIGHT,
+    };
+}
+/**
+ * Window a list of rows into a viewport.
+ *
+ * - When the content fits, it is anchored to the TOP (short outputs start at
+ *   the top, no artificial blank lines — the caller pads with flexGrow).
+ * - When it overflows, it is anchored to the BOTTOM and `scrollOffset` walks
+ *   the window upward.
+ */
+export function windowRows(totalRows, viewportHeight, scrollOffset) {
+    const total = Math.max(0, Math.floor(totalRows));
+    const viewport = Math.max(1, Math.floor(viewportHeight));
+    if (total <= viewport) {
+        return { start: 0, end: total, anchored: "top", clampedOffset: 0, hasOverflow: false };
+    }
+    const maxOffset = total - viewport;
+    const clampedOffset = Math.max(0, Math.min(Math.floor(scrollOffset), maxOffset));
+    const end = total - clampedOffset;
+    const start = Math.max(0, end - viewport);
+    return { start, end, anchored: "bottom", clampedOffset, hasOverflow: true };
+}
+//# sourceMappingURL=layout.js.map

package/dist/tui/experimental/layout.js.map

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

package/dist/tui/experimental/theme.d.ts

@@ -0,0 +1,35 @@
+import type { InkColor } from "../format.js";
+import type { TranscriptBlockKind } from "../types.js";
+/**
+ * Shared visual language for the experimental shell: consistent symbols and
+ * colors so tools, approvals, and run state read at a glance.
+ */
+export declare const symbols: {
+    readonly user: "›";
+    readonly assistant: "◆";
+    readonly tool: "⚡";
+    readonly diff: "±";
+    readonly approval: "⚠";
+    readonly update: "⬆";
+    readonly reauth: "↻";
+    readonly info: "ℹ";
+    readonly error: "✗";
+    readonly final: "✓";
+    readonly status: "•";
+    readonly arrow: "→";
+    readonly bullet: "·";
+    readonly pin: "📌";
+    readonly todoDone: "✓";
+    readonly todoActive: "▸";
+    readonly todoPending: "○";
+    readonly caret: "▏";
+    readonly barFilled: "█";
+    readonly barEmpty: "░";
+};
+export type ToneColor = InkColor;
+/** Marker glyph for a transcript block kind. */
+export declare function blockSymbol(kind: TranscriptBlockKind): string;
+/** Accent color for a transcript block kind. */
+export declare function blockColor(kind: TranscriptBlockKind, danger: boolean): InkColor;
+/** Border / accent color that reflects the current work state. */
+export declare function workStateColor(workState: string): InkColor;