terminal-pilot 0.0.50 → 0.0.52

package/node_modules/toolcraft-design/dist/explorer/reducer.js

@@ -9,6 +9,7 @@ const DEFAULT_ACTION_HANDLES = {
     openModal: () => undefined,
     toast: () => undefined,
     confirm: async () => false,
+    promptText: async () => null,
     exit: () => undefined
 };
 export function step(state, event, runtimeHandles = DEFAULT_ACTION_HANDLES) {
@@ -53,6 +54,10 @@ function stepKey(state, key, runtimeHandles) {
         return stepFilterKey(state, key, target, runtimeHandles);
     }
     if (target?.type === "action") {
+        if (state.actionState.get(target.id)?.running === true) {
+            runtimeHandles.toast("Action already running", "info");
+            return mark(state, 0);
+        }
         if (state.actionState.get(target.id)?.source === "detail" && state.focused !== "detail") {
             return mark(state, 0);
         }
@@ -85,6 +90,14 @@ function stepKey(state, key, runtimeHandles) {
                 return isDetailBlobFocused(state)
                     ? detailScroll(state, detailBodyHeight(state))
                     : moveCursor(state, pageSize(state));
+            case "halfPageUp":
+                return isDetailBlobFocused(state)
+                    ? detailScroll(state, -Math.max(1, Math.floor(detailBodyHeight(state) / 2)))
+                    : moveCursor(state, -Math.max(1, Math.floor(pageSize(state) / 2)));
+            case "halfPageDown":
+                return isDetailBlobFocused(state)
+                    ? detailScroll(state, Math.max(1, Math.floor(detailBodyHeight(state) / 2)))
+                    : moveCursor(state, Math.max(1, Math.floor(pageSize(state) / 2)));
             case "focusNext":
                 return focusNext(state);
             case "escape":
@@ -112,12 +125,16 @@ function stepKey(state, key, runtimeHandles) {
         }
     }
     if (isBackspace(key)) {
+        if (isSecondListFocused(state))
+            return updateDetailFilter(state, (state.detail.filter ?? "").slice(0, -1));
         return updateFilter(state, state.filter.slice(0, -1));
     }
     if (!state.multiSelect && isSelectionSpace(key)) {
         return mark(state, 0);
     }
     if (isPrintable(key)) {
+        if (isSecondListFocused(state))
+            return updateDetailFilter(state, `${state.detail.filter ?? ""}${key.ch}`);
         return updateFilter(state, `${state.filter}${key.ch}`);
     }
     return mark(state, 0);
@@ -141,8 +158,23 @@ function stepFilterKey(state, key, target, runtimeHandles) {
     return mark(state, 0);
 }
 function stepModalKey(state, key, target, runtimeHandles) {
+    if (state.modal?.kind === "input") {
+        if (target?.type === "builtin" && (target.id === "escape" || target.id === "quit")) {
+            return modalDismissed(state, null, runtimeHandles);
+        }
+        if (target?.type === "builtin" && target.id === "confirm") {
+            return modalDismissed(state, state.modal.value, runtimeHandles);
+        }
+        if (isBackspace(key)) {
+            return setModal(state, { ...state.modal, value: state.modal.value.slice(0, -1) });
+        }
+        if (isPrintable(key)) {
+            return setModal(state, { ...state.modal, value: `${state.modal.value}${key.ch}` });
+        }
+        return mark(state, 0);
+    }
     if (state.modal?.kind === "confirm") {
-        if (target?.type === "builtin" && target.id === "escape") {
+        if (target?.type === "builtin" && (target.id === "escape" || target.id === "quit")) {
             return modalDismissed(state, false, runtimeHandles);
         }
         if (target?.type === "builtin" && target.id === "confirm") {
@@ -201,7 +233,7 @@ function stepModalKey(state, key, target, runtimeHandles) {
 }
 function resize(state, cols, rows) {
     const size = { cols: normalizeSize(cols), rows: normalizeSize(rows) };
-    const layout = resolveExplorerLayoutMode(size.cols);
+    const layout = resolveExplorerLayoutMode(size.cols, size.rows);
     if (state.size.cols === size.cols && state.size.rows === size.rows && state.layout === layout) {
         return mark(state, 0);
     }
@@ -211,6 +243,7 @@ function resize(state, cols, rows) {
     };
 }
 function rowsLoaded(state, rows) {
+    const previousRowId = currentRow(state)?.id;
     const rowIds = new Set();
     for (const row of rows) {
         if (rowIds.has(row.id)) {
@@ -221,14 +254,27 @@ function rowsLoaded(state, rows) {
     const matches = filterRows(state.filter, rows);
     const filtered = matches.map((match) => match.index);
     const matchPositions = createMatchPositions(matches);
-    const cursor = clamp(state.cursor, 0, Math.max(0, filtered.length - 1));
+    const identityCursor = previousRowId === undefined
+        ? -1
+        : filtered.findIndex((index) => rows[index]?.id === previousRowId);
+    const cursor = identityCursor >= 0 ? identityCursor : clamp(state.cursor, 0, Math.max(0, filtered.length - 1));
     const selected = state.multiSelect ? pruneSelection(state.selected, rows) : new Set();
     const detail = resetDetailForCursor(state, rows, filtered, cursor);
     const modal = modalStillValid(state.modal, rows);
     if (state.modal?.kind === "confirm" && modal === null) {
         state.modal.resolver(false);
     }
-    const nextView = { ...state, rows, filtered, matchPositions, cursor, selected, detail, modal };
+    const nextView = {
+        ...state,
+        rows,
+        rowsLoading: false,
+        filtered,
+        matchPositions,
+        cursor,
+        selected,
+        detail,
+        modal
+    };
     const next = {
         ...nextView,
         actionState: recomputeActionState(nextView),
@@ -253,10 +299,12 @@ function detailLoaded(state, rowId, token, items) {
     if (state.detail.rowId !== rowId || state.detail.token !== token) {
         return mark(state, 0);
     }
+    const visibleItems = filterDetailItems(items, state.detail.filter ?? "");
     const detail = {
         ...state.detail,
-        items,
-        cursor: clamp(state.detail.cursor, 0, Math.max(0, items.length - 1)),
+        items: visibleItems,
+        allItems: items,
+        cursor: clamp(state.detail.cursor, 0, Math.max(0, visibleItems.length - 1)),
         scroll: 0,
         loading: false
     };
@@ -324,10 +372,13 @@ function modalDismissed(state, result, runtimeHandles) {
     if (modal?.kind === "confirm") {
         modal.resolver(result === true);
     }
-    if (modal?.kind !== "confirm" || result !== true) {
+    if (modal?.kind === "input") {
+        modal.resolver(typeof result === "string" ? result : null);
+    }
+    if (modal?.kind !== "confirm" || result !== true || modal.action === undefined) {
         return { state: closed, effects: NO_EFFECTS };
     }
-    return dispatchAction(closed, modal.action, true, runtimeHandles, modal.rows);
+    return dispatchAction(closed, modal.action, true, runtimeHandles, modal.rows ?? []);
 }
 function moveCursor(state, delta) {
     if (state.focused === "detail" && hasDetailCursor(state)) {
@@ -339,9 +390,7 @@ function moveCursor(state, delta) {
     return setCursor(state, state.cursor + delta);
 }
 function isDetailBlobFocused(state) {
-    return (state.focused === "detail" &&
-        !hasDetailCursor(state) &&
-        (state.detail.items?.length ?? 0) > 0);
+    return (state.focused === "detail" && !hasDetailCursor(state) && (state.detail.items?.length ?? 0) > 0);
 }
 function moveDetailCursor(state, delta) {
     const max = Math.max(0, (state.detail.items?.length ?? 0) - 1);
@@ -410,6 +459,33 @@ function updateFilter(state, filter) {
     const effect = detailEffect(next);
     return { state: next, effects: effect === undefined ? NO_EFFECTS : [effect] };
 }
+function updateDetailFilter(state, filter) {
+    const allItems = state.detail.allItems ?? state.detail.items ?? [];
+    const items = filterDetailItems(allItems, filter);
+    const detail = { ...state.detail, filter, items, cursor: 0, scroll: 0 };
+    return {
+        state: {
+            ...state,
+            detail,
+            actionState: recomputeActionState({ ...state, detail }),
+            dirty: REGION_HEADER | REGION_DETAIL | REGION_FOOTER
+        },
+        effects: NO_EFFECTS
+    };
+}
+function filterDetailItems(items, query) {
+    const rows = items.map((item) => ({
+        id: item.id,
+        title: item.title ?? item.id,
+        subtitle: item.subtitle
+    }));
+    return filterRows(query, rows)
+        .map((match) => items[match.index])
+        .filter((item) => item !== undefined);
+}
+function isSecondListFocused(state) {
+    return state.focused === "detail" && state.paneDefinitions[1]?.kind === "list";
+}
 function focusFilter(state) {
     if (state.filterFocused) {
         return mark(state, 0);
@@ -432,6 +508,9 @@ function focusNext(state) {
     };
 }
 function escape(state, runtimeHandles) {
+    if (isSecondListFocused(state) && (state.detail.filter ?? "").length > 0) {
+        return updateDetailFilter(state, "");
+    }
     if (state.filterFocused || state.filter.length > 0) {
         const cleared = updateFilter({ ...state, filterFocused: false }, "");
         return {
@@ -455,13 +534,19 @@ function confirmKey(state, runtimeHandles) {
     if (state.modal?.kind === "confirm") {
         return modalDismissed(state, true, runtimeHandles);
     }
-    return dispatchPrimary(state, runtimeHandles);
+    const hasActions = [...state.actionState.values()].some((entry) => entry.available && entry.running !== true);
+    return hasActions
+        ? setModal(state, { kind: "palette", query: "", cursor: 0 })
+        : dispatchPrimary(state, runtimeHandles);
 }
 function toggleSelect(state) {
     if (!state.multiSelect) {
         return mark(state, 0);
     }
-    const row = currentRow(state);
+    const detailItem = state.focused === "detail" ? state.detail.items?.[state.detail.cursor] : undefined;
+    const row = detailItem === undefined
+        ? currentRow(state)
+        : { id: detailItem.id, title: detailItem.title ?? detailItem.id };
     if (row === undefined) {
         return mark(state, 0);
     }
@@ -701,10 +786,21 @@ function dispatchAction(state, action, confirmed, runtimeHandles, modalRows) {
         return mark(state, 0);
     }
     if (action.destructive === true && !confirmed) {
+        const actionLabel = typeof action.label === "function" ? action.label() : action.label;
         return {
             state: {
                 ...state,
-                modal: { kind: "confirm", action, rows, resolver: () => undefined },
+                modal: {
+                    kind: "confirm",
+                    title: action.destructive ? "Confirm destructive action" : "Confirm action",
+                    message: `${actionLabel} ${rows.length === 1 ? rows[0].title : `${rows.length} items`}?`,
+                    confirmLabel: actionLabel,
+                    cancelLabel: "Cancel",
+                    destructive: action.destructive === true,
+                    action,
+                    rows,
+                    resolver: () => undefined
+                },
                 dirty: REGION_MODAL | REGION_FOOTER
             },
             effects: NO_EFFECTS
@@ -736,7 +832,9 @@ function recomputeActionState(view) {
             continue;
         }
         const ctx = buildActionContext(view, action, entry.source ?? actionSource(view, action), DEFAULT_ACTION_HANDLES);
-        const available = action.predicate === undefined ? entry.available : action.predicate(ctx);
+        const row = currentRow(view);
+        const visible = action.visible === undefined || (row !== undefined && action.visible(row));
+        const available = visible && (action.predicate === undefined ? entry.available : action.predicate(ctx));
         const label = typeof action.label === "function" ? action.label() : action.label;
         next.set(id, { ...entry, available, label });
     }
@@ -756,7 +854,7 @@ function resetDetailForCursor(state, rows, filtered, cursor) {
     }
     return {
         rowId: row.id,
-        items: null,
+        items: state.detail.items,
         cursor: 0,
         scroll: 0,
         token: state.detail.token + 1,
@@ -816,6 +914,8 @@ function modalStillValid(modal, rows) {
     if (modal?.kind !== "confirm") {
         return modal;
     }
+    if (modal.rows === undefined)
+        return modal;
     const ids = new Set(rows.map((row) => row.id));
     return modal.rows.every((row) => ids.has(row.id)) ? modal : null;
 }

package/node_modules/toolcraft-design/dist/explorer/render/detail.d.ts

@@ -1,4 +1,4 @@
-import { ScreenBuffer } from "../../dashboard/buffer.js";
+import type { ScreenSurface as ScreenBuffer } from "../../screen/screen.js";
 import type { ExplorerLayout } from "../layout.js";
 import type { ExplorerState } from "../state.js";
 export declare function renderDetail(state: ExplorerState, screen: ScreenBuffer, layout: ExplorerLayout): void;

package/node_modules/toolcraft-design/dist/explorer/render/detail.js

@@ -1,8 +1,9 @@
-import { stripAnsi } from "../../internal/strip-ansi.js";
+import { ansiToCells } from "../../screen/ansi-text.js";
 import { renderMarkdown } from "../../terminal-markdown/index.js";
 import { getExplorerStyles } from "../theme.js";
 import { drawPaneFrame, paneBodyRect } from "./pane.js";
 import { fitToWidth } from "./text.js";
+const markdownCache = new Map();
 export function renderDetail(state, screen, layout) {
     const rect = layout.detail;
     const styles = getExplorerStyles();
@@ -11,12 +12,14 @@ export function renderDetail(state, screen, layout) {
         return;
     }
     const row = state.rows.find((r) => r.id === state.detail.rowId) ?? null;
+    const pane = state.paneDefinitions[1];
+    const title = pane?.titleForRow?.(row ?? undefined) ?? pane?.title ?? "Preview";
     if (layout.mode === "narrow-vertical") {
-        drawPaneFrame(screen, rect, "Preview", state.focused === "detail" ? styles.borderFocused : styles.border);
+        drawPaneFrame(screen, rect, title, state.focused === "detail" ? styles.borderFocused : styles.border, { focused: state.focused === "detail", indicator: scrollIndicator(state) });
         renderDetailBody(state, screen, paneBodyRect(rect), row);
         return;
     }
-    drawPaneFrame(screen, rect, "Preview", state.focused === "detail" ? styles.borderFocused : styles.border);
+    drawPaneFrame(screen, rect, title, state.focused === "detail" ? styles.borderFocused : styles.border, { focused: state.focused === "detail", indicator: scrollIndicator(state) });
     renderDetailBody(state, screen, paneBodyRect(rect), row);
 }
 function renderDetailBody(state, screen, rect, row) {
@@ -47,7 +50,8 @@ function renderListMode(state, screen, rect, items, row) {
         const item = items[index];
         const cursor = index === state.detail.cursor;
         const title = item.title ?? item.id;
-        const prefix = cursor ? "▌ " : "  ";
+        const selected = state.multiSelect && state.selected.has(item.id);
+        const prefix = `${selected ? "*" : " "}${cursor ? "▌" : " "} `;
         const badge = item.badge ? ` ${item.badge.text}` : "";
         writeLine(screen, rect, y, `${prefix}${title}${badge}`, cursor ? styles.borderFocused : styles.accent);
         y += 1;
@@ -68,11 +72,23 @@ function renderListMode(state, screen, rect, items, row) {
     }
 }
 function renderBlob(screen, rect, text, scroll) {
-    const allLines = text.split("\n");
+    const allLines = [[]];
+    for (const cell of ansiToCells(text)) {
+        if (cell.ch === "\n")
+            allLines.push([]);
+        else
+            allLines.at(-1).push(cell);
+    }
     const start = clamp(scroll, 0, Math.max(0, allLines.length - rect.height));
     const lines = allLines.slice(start);
     for (let row = 0; row < rect.height; row += 1) {
-        writeLine(screen, rect, row, lines[row] ?? "");
+        let x = rect.x;
+        for (const cell of lines[row] ?? []) {
+            if (x + cell.width > rect.x + rect.width)
+                break;
+            screen.put(x, rect.y + row, cell.ch, cell.style);
+            x += cell.width;
+        }
     }
 }
 function renderItemMarkdown(item, rect, row) {
@@ -80,7 +96,14 @@ function renderItemMarkdown(item, rect, row) {
     if (content.trim().length === 0) {
         return "";
     }
-    return stripAnsi(renderMarkdown(content, { width: Math.max(1, rect.width) }).trimEnd());
+    const width = Math.max(1, rect.width);
+    const key = `${contentHash(content)}:${width}`;
+    const cached = markdownCache.get(key);
+    if (cached !== undefined)
+        return cached;
+    const rendered = renderMarkdown(content, { width }).trimEnd();
+    markdownCache.set(key, rendered);
+    return rendered;
 }
 function renderItem(item, rect, row) {
     if (item.renderedContent !== undefined) {
@@ -108,3 +131,18 @@ function writeLine(screen, rect, row, text, style = {}) {
 function clamp(value, min, max) {
     return Math.min(max, Math.max(min, value));
 }
+function scrollIndicator(state) {
+    if (state.detail.loading)
+        return "⠋";
+    const content = state.detail.items?.[state.detail.cursor]?.renderedContent ?? "";
+    const total = Math.max(1, content.split("\n").length);
+    return `${Math.min(100, Math.round((state.detail.scroll / Math.max(1, total - 1)) * 100))}%`;
+}
+function contentHash(content) {
+    let hash = 2166136261;
+    for (let index = 0; index < content.length; index += 1) {
+        hash ^= content.charCodeAt(index);
+        hash = Math.imul(hash, 16777619);
+    }
+    return hash >>> 0;
+}

package/node_modules/toolcraft-design/dist/explorer/render/footer.d.ts

@@ -1,4 +1,4 @@
-import { ScreenBuffer } from "../../dashboard/buffer.js";
+import type { ScreenSurface as ScreenBuffer } from "../../screen/screen.js";
 import type { ExplorerLayout } from "../layout.js";
 import type { ExplorerState } from "../state.js";
 export declare function renderFooter(state: ExplorerState, screen: ScreenBuffer, layout: ExplorerLayout): void;

package/node_modules/toolcraft-design/dist/explorer/render/footer.js

@@ -36,11 +36,23 @@ function putFooterText(screen, x, y, endX, text, style = {}) {
     return cellWidth(fitted, x);
 }
 function footerHints(state) {
+    if (state.modal?.kind === "input") {
+        return [
+            { key: "Enter", label: "submit", running: false },
+            { key: "Esc", label: "cancel", running: false }
+        ];
+    }
+    if (state.modal?.kind === "confirm") {
+        return [
+            { key: "Y/Enter", label: state.modal.confirmLabel, running: false },
+            { key: "N/Esc", label: state.modal.cancelLabel, running: false }
+        ];
+    }
     const hints = [];
     if (state.focused === "detail") {
         hints.push({ key: "Tab", label: "focus", running: false });
-        hints.push({ key: "Enter", label: "sub", running: false });
     }
+    hints.push({ key: "Enter", label: "actions", running: false });
     for (const [id, entry] of state.actionState) {
         if (!entry.available || entry.action?.showInFooter === false) {
             continue;
@@ -51,12 +63,13 @@ function footerHints(state) {
             : entry.label;
         hints.push({ key, label, running: entry.running === true });
     }
-    hints.push({ key: "?", label: "help", running: false });
     hints.push({ key: "Ctrl+P", label: "palette", running: false });
     if (hasShiftReorderBindings(state)) {
         hints.push({ key: "⇧↑↓", label: "reorder (within state)", running: false, bracketed: false });
     }
-    hints.push({ key: "q", label: "quit", running: false });
+    hints.push({ key: "Esc", label: "clear/quit", running: false });
+    if (state.selected.size > 0)
+        hints.push({ key: `${state.selected.size}`, label: "selected", running: false, bracketed: false });
     return hints;
 }
 function hasShiftReorderBindings(state) {
@@ -65,6 +78,8 @@ function hasShiftReorderBindings(state) {
     return up.includes("Shift+up") && down.includes("Shift+down");
 }
 function actionKey(entry, fallback) {
+    if (entry.action?.accelerator !== undefined)
+        return `Ctrl+${entry.action.accelerator.toUpperCase()}`;
     const key = entry.action?.key;
     if (Array.isArray(key)) {
         return key[0] ?? fallback;

package/node_modules/toolcraft-design/dist/explorer/render/header.d.ts

@@ -1,4 +1,4 @@
-import { ScreenBuffer } from "../../dashboard/buffer.js";
+import type { ScreenSurface as ScreenBuffer } from "../../screen/screen.js";
 import type { ExplorerLayout } from "../layout.js";
 import type { ExplorerState } from "../state.js";
 export declare function renderHeader(state: ExplorerState, screen: ScreenBuffer, layout: ExplorerLayout): void;

package/node_modules/toolcraft-design/dist/explorer/render/header.js

@@ -14,8 +14,12 @@ export function renderHeader(state, screen, layout) {
     drawTopBorder(screen, state.title, rect.width, styles.border);
     if (rect.height > 1) {
         const prompt = `${state.title.toLocaleLowerCase()}>`;
-        const filter = state.filter.length > 0 ? ` ${state.filter}` : "";
-        const count = `${state.filtered.length}/${state.rows.length}`;
+        const secondList = state.focused === "detail" && state.paneDefinitions[1]?.kind === "list";
+        const activeFilter = secondList ? (state.detail.filter ?? "") : state.filter;
+        const filter = activeFilter.length > 0 ? ` ${activeFilter}` : "";
+        const count = secondList
+            ? `${state.detail.items?.length ?? 0}/${state.detail.allItems?.length ?? state.detail.items?.length ?? 0}`
+            : `${state.filtered.length}/${state.rows.length}`;
         const selected = state.multiSelect && state.selected.size > 0 ? `  (${state.selected.size} selected)` : "";
         const spinner = state.detail.loading ? "  *" : "";
         const right = `${count}${selected}${spinner}`;

package/node_modules/toolcraft-design/dist/explorer/render/index.d.ts

@@ -1,4 +1,4 @@
-import { ScreenBuffer } from "../../dashboard/buffer.js";
+import type { ScreenSurface as ScreenBuffer } from "../../screen/screen.js";
 import { type ExplorerState } from "../state.js";
 export declare function renderExplorer(state: ExplorerState, screen: ScreenBuffer): void;
 export { renderDetail } from "./detail.js";

package/node_modules/toolcraft-design/dist/explorer/render/index.js

@@ -18,7 +18,8 @@ export function renderExplorer(state, screen) {
     const layout = computeExplorerLayout({
         cols: state.size.cols,
         rows: state.size.rows,
-        detailHidden: state.layout === "narrow-list-only" || state.layout === "too-narrow"
+        detailHidden: state.layout === "narrow-list-only" || state.layout === "too-narrow",
+        focused: state.focused
     });
     const dirty = state.dirty === 0 ? REGION_ALL : state.dirty;
     for (const [region, render] of REGION_RENDERERS) {

package/node_modules/toolcraft-design/dist/explorer/render/list.d.ts

@@ -1,4 +1,18 @@
-import { ScreenBuffer } from "../../dashboard/buffer.js";
+import type { ScreenSurface as ScreenBuffer } from "../../screen/screen.js";
 import type { ExplorerLayout } from "../layout.js";
-import type { ExplorerState } from "../state.js";
+import type { ExplorerState, Row } from "../state.js";
 export declare function renderList(state: ExplorerState, screen: ScreenBuffer, layout: ExplorerLayout): void;
+export type DisplayLine = {
+    kind: "group";
+    label: string;
+} | {
+    kind: "row";
+    rowIndex: number;
+    row: Row;
+    cursor: boolean;
+} | {
+    kind: "subtitle";
+    row: Row;
+    text: string;
+};
+export declare function visibleStart(lines: DisplayLine[], height: number, scrolloff?: number): number;

package/node_modules/toolcraft-design/dist/explorer/render/list.js

@@ -1,7 +1,6 @@
 import { getExplorerStyles } from "../theme.js";
 import { drawPaneFrame, paneBodyRect } from "./pane.js";
 import { cellWidth, centerCells, fitToWidth, splitGraphemeCells, stripAnsi } from "./text.js";
-const listLineCache = new WeakMap();
 export function renderList(state, screen, layout) {
     const styles = getExplorerStyles();
     const rect = layout.list;
@@ -13,19 +12,14 @@ export function renderList(state, screen, layout) {
         writeLine(screen, rect, 0, "Terminal too narrow", styles.muted);
         return;
     }
-    drawPaneFrame(screen, rect, state.title, state.focused === "list" ? styles.borderFocused : styles.border);
+    drawPaneFrame(screen, rect, state.paneDefinitions[0]?.title ?? state.title, state.focused === "list" ? styles.borderFocused : styles.border, { focused: state.focused === "list", indicator: state.rowsLoading ? "⠋" : `${state.filtered.length}/${state.rows.length}` });
     const bodyRect = paneBodyRect(rect);
     if (bodyRect.width <= 0 || bodyRect.height <= 0) {
         return;
     }
-    const rectKey = `${bodyRect.x}:${bodyRect.y}:${bodyRect.width}:${bodyRect.height}`;
-    const cached = listLineCache.get(screen);
-    const cache = cached?.rectKey === rectKey ? cached.lines : new Map();
-    listLineCache.set(screen, { rectKey, lines: cache });
     if (state.filtered.length === 0) {
-        const hint = state.emptyHint;
+        const hint = state.rowsLoading ? "Loading…" : state.emptyHint;
         writeLine(screen, bodyRect, Math.floor(bodyRect.height / 2), centerCells(hint, bodyRect.width, bodyRect.x), styles.muted);
-        cache.clear();
         return;
     }
     const lines = buildDisplayLines(state);
@@ -34,20 +28,12 @@ export function renderList(state, screen, layout) {
     for (let lineIndex = start; lineIndex < lines.length && y < bodyRect.height; lineIndex += 1) {
         const line = lines[lineIndex];
         if (line.kind === "group") {
-            const hash = `group:${line.label}`;
-            if (cache.get(y) !== hash) {
-                writeLine(screen, bodyRect, y, formatGroupHeader(line.label, bodyRect), styles.muted);
-                cache.set(y, hash);
-            }
+            writeLine(screen, bodyRect, y, formatGroupHeader(line.label, bodyRect), styles.muted);
             y += 1;
             continue;
         }
         if (line.kind === "subtitle") {
-            const subtitleHash = `subtitle:${line.row.id}:${line.text}`;
-            if (cache.get(y) !== subtitleHash) {
-                writeLine(screen, bodyRect, y, `  ${line.text}`, styles.muted);
-                cache.set(y, subtitleHash);
-            }
+            writeLine(screen, bodyRect, y, `  ${line.text}`, styles.muted);
             y += 1;
             continue;
         }
@@ -59,16 +45,12 @@ export function renderList(state, screen, layout) {
         const selected = state.multiSelect && state.selected.has(row.id);
         const cursor = rowIndex === state.filtered[state.cursor];
         const positions = state.matchPositions.get(rowIndex) ?? [];
-        const hash = lineHash(row, selected, cursor, positions);
-        if (cache.get(y) !== hash) {
-            renderRow(screen, bodyRect, y, row, {
-                selected,
-                cursor,
-                focused: state.focused === "list",
-                positions
-            });
-            cache.set(y, hash);
-        }
+        renderRow(screen, bodyRect, y, row, {
+            selected,
+            cursor,
+            focused: state.focused === "list",
+            positions
+        });
         y += 1;
     }
 }
@@ -91,7 +73,7 @@ function buildDisplayLines(state) {
     }
     return lines;
 }
-function visibleStart(lines, height) {
+export function visibleStart(lines, height, scrolloff = 3) {
     if (height <= 0) {
         return 0;
     }
@@ -99,7 +81,7 @@ function visibleStart(lines, height) {
     if (cursorLine < 0) {
         return 0;
     }
-    return Math.max(0, Math.min(cursorLine, cursorLine - height + 1));
+    return Math.max(0, cursorLine - Math.max(0, height - 1 - scrolloff));
 }
 function formatGroupHeader(label, rect) {
     const text = ` ${label} `;
@@ -111,7 +93,7 @@ function formatGroupHeader(label, rect) {
 }
 function renderRow(screen, rect, rowY, row, opts) {
     const styles = getExplorerStyles();
-    const marker = opts.selected ? "┃" : " ";
+    const marker = opts.selected ? "*" : " ";
     const cursor = opts.cursor ? "●" : "◌";
     const focus = opts.cursor && opts.focused ? " ▌" : "";
     const prefix = `${marker} ${cursor} `;
@@ -149,9 +131,6 @@ function renderRow(screen, rect, rowY, row, opts) {
 function writeLine(screen, rect, row, text, style = {}) {
     screen.put(rect.x, rect.y + row, fitToWidth(text, rect.width, rect.x), style);
 }
-function lineHash(row, selected, cursor, positions) {
-    return `${row.id}:${selected ? 1 : 0}:${cursor ? 1 : 0}:${positions.join(",")}`;
-}
 function hasMatchPosition(start, end, positions) {
     for (let position = start; position < end; position += 1) {
         if (positions.has(position)) {

package/node_modules/toolcraft-design/dist/explorer/render/modal.d.ts

@@ -1,3 +1,3 @@
-import { ScreenBuffer } from "../../dashboard/buffer.js";
+import type { ScreenSurface as ScreenBuffer } from "../../screen/screen.js";
 import type { ExplorerState } from "../state.js";
 export declare function renderModal(state: ExplorerState, screen: ScreenBuffer): void;

package/node_modules/toolcraft-design/dist/explorer/render/modal.js

@@ -29,16 +29,16 @@ function modalLines(state) {
     }
     if (state.modal?.kind === "confirm") {
         return [
-            state.modal.action.destructive ? "Destructive action" : "Confirm action",
-            `${labelFor(state.modal.action)} ${state.modal.rows.length} row(s)?`,
-            "Enter confirms · Esc cancels"
+            state.modal.message,
+            `  [ ${state.modal.confirmLabel} ]    ${state.modal.cancelLabel}`
         ];
     }
+    if (state.modal?.kind === "input") {
+        const value = state.modal.value.length > 0 ? state.modal.value : (state.modal.placeholder ?? "");
+        return [state.modal.label, `  ${value}▌`];
+    }
     if (state.modal?.kind === "palette") {
-        return [
-            `Query: ${state.modal.query}`,
-            ...paletteLines(state)
-        ];
+        return [`Query: ${state.modal.query}`, ...paletteLines(state)];
     }
     if (state.modal?.kind === "content") {
         return state.modal.content.split("\n").slice(state.modal.scroll);
@@ -50,7 +50,10 @@ function title(state) {
         return "Keybindings";
     }
     if (state.modal?.kind === "confirm") {
-        return "Confirm";
+        return state.modal.title;
+    }
+    if (state.modal?.kind === "input") {
+        return state.modal.title;
     }
     if (state.modal?.kind === "content") {
         return state.modal.title;
@@ -95,6 +98,3 @@ function paletteLines(state) {
     }
     return lines.length === 0 ? ["  No actions"] : lines;
 }
-function labelFor(action) {
-    return typeof action.label === "function" ? action.label() : action.label;
-}