terminal-pilot 0.0.42 → 0.0.44

package/node_modules/toolcraft-design/dist/dashboard/terminal.js

@@ -118,19 +118,18 @@ export function createTerminalDriver(opts) {
         if (destroyed) {
             return () => { };
         }
-        const listener = (str, key) => {
-            const event = toKeypressEvent(str, key);
-            if (event !== undefined) {
+        const listener = (chunk) => {
+            for (const event of parseKeypressChunk(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk))) {
                 handler(event);
             }
         };
         keypressListeners.add(listener);
-        stdin.on("keypress", listener);
+        stdin.on("data", listener);
         return () => {
             if (!keypressListeners.delete(listener)) {
                 return;
             }
-            stdin.off("keypress", listener);
+            stdin.off("data", listener);
         };
     }
     function destroy() {
@@ -138,7 +137,7 @@ export function createTerminalDriver(opts) {
             return;
         }
         for (const listener of keypressListeners) {
-            stdin.off("keypress", listener);
+            stdin.off("data", listener);
         }
         keypressListeners.clear();
         for (const listener of resizeListeners) {
@@ -173,6 +172,9 @@ export function parseKeypress(data) {
     if (data.length === 0) {
         return undefined;
     }
+    if (data.length === 1 && data[0] === 0x1b) {
+        return { name: "escape", ctrl: false, meta: false, shift: false };
+    }
     const stream = new PassThrough();
     const stdin = stream;
     let event;
@@ -184,6 +186,46 @@ export function parseKeypress(data) {
     stream.destroy();
     return event;
 }
+function parseKeypressChunk(data) {
+    const events = [];
+    const input = data.toString("utf8");
+    let index = 0;
+    while (index < input.length) {
+        const sequence = nextKeySequence(input, index);
+        if (sequence.length === 0) {
+            break;
+        }
+        const event = parseKeypress(Buffer.from(sequence));
+        if (event !== undefined) {
+            events.push(event);
+        }
+        index += sequence.length;
+    }
+    return events;
+}
+function nextKeySequence(input, index) {
+    const character = input[index];
+    if (character === undefined) {
+        return "";
+    }
+    if (character !== "\u001b") {
+        return character;
+    }
+    const next = input[index + 1];
+    if (next === undefined) {
+        return character;
+    }
+    if (next !== "[") {
+        return input.slice(index, index + 2);
+    }
+    for (let cursor = index + 2; cursor < input.length; cursor += 1) {
+        const code = input.charCodeAt(cursor);
+        if ((code >= 0x40 && code <= 0x7e) || input[cursor] === "~") {
+            return input.slice(index, cursor + 1);
+        }
+    }
+    return input.slice(index);
+}
 function toKeypressEvent(str, key) {
     const controlCharacter = controlCharacterToKeypress(key?.sequence);
     if (controlCharacter !== undefined) {

package/node_modules/toolcraft-design/dist/explorer/actions.d.ts

@@ -7,6 +7,10 @@ type ExplorerKeypressEvent = Extract<ExplorerEvent, {
 export type ActionRuntimeHandles = {
     refresh: () => Promise<void>;
     suspendAnd: <T>(fn: () => Promise<T>) => Promise<T>;
+    openModal: (content: {
+        title: string;
+        content: string;
+    }) => void;
     toast: (msg: string, tone?: Tone) => void;
     confirm: (prompt: string) => Promise<boolean>;
     exit: (after?: () => void | Promise<void>) => void;

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

@@ -20,6 +20,7 @@ export function buildActionContext(state, _action, source, runtimeHandles, rowsO
         filter: state.filter,
         refresh: runtimeHandles.refresh,
         suspendAnd: runtimeHandles.suspendAnd,
+        openModal: runtimeHandles.openModal,
         toast: runtimeHandles.toast,
         confirm: runtimeHandles.confirm,
         exit: runtimeHandles.exit

package/node_modules/toolcraft-design/dist/explorer/events.d.ts

@@ -55,6 +55,10 @@ export type ExplorerEvent = {
     type: "suspendResumed";
     value: unknown;
     emit: ExplorerEvent;
+} | {
+    type: "modalOpened";
+    title: string;
+    content: string;
 } | {
     type: "modalDismissed";
     result: unknown;

package/node_modules/toolcraft-design/dist/explorer/jobs.d.ts

@@ -1,6 +1,7 @@
 import type { ExplorerEvent } from "./events.js";
 import type { DetailCtx, DetailItem } from "./state.js";
 export declare const LOADING_INDICATOR_MS = 150;
+export declare const DETAIL_DEBOUNCE_MS = 100;
 export declare function createDetailJobs(emit: (event: ExplorerEvent) => void): {
     schedule: (rowId: string, items: (ctx: DetailCtx) => Promise<DetailItem[]>, ctx: DetailCtx) => Promise<void>;
     abort: () => void;

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

@@ -1,6 +1,8 @@
 export const LOADING_INDICATOR_MS = 150;
+export const DETAIL_DEBOUNCE_MS = 100;
 export function createDetailJobs(emit) {
     let token = 0;
+    let lastScheduleAt = 0;
     let current = null;
     const abortedTokens = new Set();
     return {
@@ -9,6 +11,9 @@ export function createDetailJobs(emit) {
                 current.controller.abort();
                 clearTimeout(current.loadingTimer);
             }
+            const scheduledAt = Date.now();
+            const debounce = scheduledAt - lastScheduleAt < DETAIL_DEBOUNCE_MS;
+            lastScheduleAt = scheduledAt;
             const nextToken = ++token;
             const controller = new AbortController();
             let finished = false;
@@ -19,6 +24,12 @@ export function createDetailJobs(emit) {
             }, LOADING_INDICATOR_MS);
             current = { controller, loadingTimer, token: nextToken };
             try {
+                if (debounce) {
+                    await waitUnlessAborted(DETAIL_DEBOUNCE_MS, controller.signal);
+                    if (controller.signal.aborted || nextToken !== token) {
+                        return;
+                    }
+                }
                 const loadedItems = await items({ ...ctx, signal: controller.signal });
                 finished = true;
                 if (!abortedTokens.has(nextToken)) {
@@ -51,6 +62,23 @@ export function createDetailJobs(emit) {
         }
     };
 }
+function waitUnlessAborted(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted) {
+            resolve();
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            resolve();
+        };
+        const timer = setTimeout(() => {
+            signal.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+}
 function toError(error) {
     if (error instanceof Error) {
         return error;

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

@@ -7,8 +7,8 @@ const builtinBindings = {
     cursorDown: ["down", "j"],
     top: ["home", "gg"],
     bottom: ["end", "G"],
-    pageUp: ["Ctrl+u"],
-    pageDown: ["Ctrl+d"],
+    pageUp: ["pageup", "Ctrl+u"],
+    pageDown: ["pagedown", "Ctrl+d"],
     focusNext: ["tab"],
     escape: ["escape"],
     confirm: ["return", "enter"],

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

@@ -5,6 +5,7 @@ const NO_EFFECTS = [];
 const DEFAULT_ACTION_HANDLES = {
     refresh: async () => undefined,
     suspendAnd: async (fn) => fn(),
+    openModal: () => undefined,
     toast: () => undefined,
     confirm: async () => false,
     exit: () => undefined
@@ -31,6 +32,13 @@ export function step(state, event, runtimeHandles = DEFAULT_ACTION_HANDLES) {
             return expireToast(state);
         case "suspendResumed":
             return suspendResumed(state, event.emit, runtimeHandles);
+        case "modalOpened":
+            return setModal(state, {
+                kind: "content",
+                title: event.title,
+                content: event.content,
+                scroll: 0
+            });
         case "modalDismissed":
             return modalDismissed(state, event.result, runtimeHandles);
     }
@@ -69,9 +77,13 @@ function stepKey(state, key, runtimeHandles) {
             case "bottom":
                 return setCursor(state, state.filtered.length - 1);
             case "pageUp":
-                return moveCursor(state, -pageSize(state));
+                return isDetailBlobFocused(state)
+                    ? detailScroll(state, -detailBodyHeight(state))
+                    : moveCursor(state, -pageSize(state));
             case "pageDown":
-                return moveCursor(state, pageSize(state));
+                return isDetailBlobFocused(state)
+                    ? detailScroll(state, detailBodyHeight(state))
+                    : moveCursor(state, pageSize(state));
             case "focusNext":
                 return focusNext(state);
             case "escape":
@@ -164,6 +176,26 @@ function stepModalKey(state, key, target, runtimeHandles) {
         }
         return paletteInput(state, key);
     }
+    if (state.modal?.kind === "content") {
+        if (target?.type === "builtin") {
+            switch (target.id) {
+                case "escape":
+                case "confirm":
+                    return modalDismissed(state, false, runtimeHandles);
+                case "cursorDown":
+                case "detailScrollDown":
+                    return scrollContentModal(state, 1);
+                case "cursorUp":
+                case "detailScrollUp":
+                    return scrollContentModal(state, -1);
+                case "pageDown":
+                    return scrollContentModal(state, modalBodyHeight(state));
+                case "pageUp":
+                    return scrollContentModal(state, -modalBodyHeight(state));
+            }
+        }
+        return mark(state, 0);
+    }
     return mark(state, 0);
 }
 function resize(state, cols, rows) {
@@ -287,7 +319,7 @@ function suspendResumed(state, emit, runtimeHandles) {
 }
 function modalDismissed(state, result, runtimeHandles) {
     const modal = state.modal;
-    const closed = { ...state, modal: null, dirty: REGION_MODAL | REGION_FOOTER };
+    const closed = { ...state, modal: null, dirty: REGION_ALL };
     if (modal?.kind === "confirm") {
         modal.resolver(result === true);
     }
@@ -300,8 +332,16 @@ function moveCursor(state, delta) {
     if (state.focused === "detail" && hasDetailCursor(state)) {
         return moveDetailCursor(state, delta);
     }
+    if (isDetailBlobFocused(state)) {
+        return detailScroll(state, delta);
+    }
     return setCursor(state, state.cursor + delta);
 }
+function isDetailBlobFocused(state) {
+    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);
     const cursor = clamp(state.detail.cursor + delta, 0, max);
@@ -466,9 +506,6 @@ function selectionChanged(state, selected) {
     return { state: next, effects: NO_EFFECTS };
 }
 function detailScroll(state, delta) {
-    if (state.focused !== "detail") {
-        return mark(state, 0);
-    }
     const scroll = clamp(state.detail.scroll + delta, 0, maxDetailScroll(state));
     if (scroll === state.detail.scroll) {
         return mark(state, 0);
@@ -478,6 +515,29 @@ function detailScroll(state, delta) {
         effects: NO_EFFECTS
     };
 }
+function scrollContentModal(state, delta) {
+    if (state.modal?.kind !== "content") {
+        return mark(state, 0);
+    }
+    const scroll = clamp(state.modal.scroll + delta, 0, maxContentModalScroll(state));
+    if (scroll === state.modal.scroll) {
+        return mark(state, 0);
+    }
+    return setModal(state, { ...state.modal, scroll });
+}
+function maxContentModalScroll(state) {
+    if (state.modal?.kind !== "content") {
+        return 0;
+    }
+    return Math.max(0, state.modal.content.split("\n").length - modalBodyHeight(state));
+}
+function modalBodyHeight(state) {
+    const screenHeight = normalizeSize(state.size.rows);
+    if (screenHeight <= 2) {
+        return 0;
+    }
+    return Math.max(0, screenHeight - 4);
+}
 function clampDetailScroll(state) {
     const scroll = clamp(state.detail.scroll, 0, maxDetailScroll(state));
     if (scroll === state.detail.scroll) {

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

@@ -26,7 +26,7 @@ function renderDetailBody(state, screen, rect, row) {
         return;
     }
     if (items === null) {
-        writeLine(screen, rect, 0, state.detail.loading ? "Loading detail..." : state.emptyHint, styles.muted);
+        writeLine(screen, rect, 0, row === null ? state.emptyHint : "Loading detail...", styles.muted);
         return;
     }
     if (items.length === 0) {

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

@@ -13,7 +13,7 @@ export function renderList(state, screen, layout) {
         writeLine(screen, rect, 0, "Terminal too narrow", styles.muted);
         return;
     }
-    drawPaneFrame(screen, rect, "Plans", state.focused === "list" ? styles.borderFocused : styles.border);
+    drawPaneFrame(screen, rect, state.title, state.focused === "list" ? styles.borderFocused : styles.border);
     const bodyRect = paneBodyRect(rect);
     if (bodyRect.width <= 0 || bodyRect.height <= 0) {
         return;
@@ -28,28 +28,34 @@ export function renderList(state, screen, layout) {
         cache.clear();
         return;
     }
-    let lastGroup;
+    const lines = buildDisplayLines(state);
+    const start = visibleStart(lines, bodyRect.height);
     let y = 0;
-    for (const rowIndex of state.filtered) {
-        if (y >= bodyRect.height) {
-            break;
-        }
-        const row = state.rows[rowIndex];
-        if (!row) {
-            continue;
-        }
-        if (row.group && row.group !== lastGroup && y < bodyRect.height) {
-            const hash = `group:${row.group}`;
+    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(row.group, bodyRect), styles.muted);
+                writeLine(screen, bodyRect, y, formatGroupHeader(line.label, bodyRect), styles.muted);
                 cache.set(y, hash);
             }
             y += 1;
-            lastGroup = row.group;
+            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);
+            }
+            y += 1;
+            continue;
         }
+        const rowIndex = line.rowIndex;
         if (y >= bodyRect.height) {
             break;
         }
+        const row = line.row;
         const selected = state.multiSelect && state.selected.has(row.id);
         const cursor = rowIndex === state.filtered[state.cursor];
         const positions = state.matchPositions.get(rowIndex) ?? [];
@@ -64,15 +70,36 @@ export function renderList(state, screen, layout) {
             cache.set(y, hash);
         }
         y += 1;
-        if (row.subtitle && y < bodyRect.height) {
-            const subtitleHash = `${hash}:subtitle:${row.subtitle}`;
-            if (cache.get(y) !== subtitleHash) {
-                writeLine(screen, bodyRect, y, `  ${row.subtitle}`, styles.muted);
-                cache.set(y, subtitleHash);
-            }
-            y += 1;
+    }
+}
+function buildDisplayLines(state) {
+    const lines = [];
+    let lastGroup;
+    for (const rowIndex of state.filtered) {
+        const row = state.rows[rowIndex];
+        if (!row) {
+            continue;
+        }
+        if (row.group && row.group !== lastGroup) {
+            lines.push({ kind: "group", label: row.group });
+            lastGroup = row.group;
         }
+        lines.push({ kind: "row", rowIndex, row, cursor: rowIndex === state.filtered[state.cursor] });
+        if (row.subtitle) {
+            lines.push({ kind: "subtitle", row, text: row.subtitle });
+        }
+    }
+    return lines;
+}
+function visibleStart(lines, height) {
+    if (height <= 0) {
+        return 0;
+    }
+    const cursorLine = lines.findIndex((line) => line.kind === "row" && line.cursor);
+    if (cursorLine < 0) {
+        return 0;
     }
+    return Math.max(0, Math.min(cursorLine, cursorLine - height + 1));
 }
 function formatGroupHeader(label, rect) {
     const text = ` ${label} `;

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

@@ -1,10 +1,11 @@
+import { stripAnsi } from "../../internal/strip-ansi.js";
 import { getExplorerStyles } from "../theme.js";
 import { fitToWidth, padEndCells } from "./text.js";
 export function renderModal(state, screen) {
     if (state.modal === null || screen.width <= 0 || screen.height <= 0) {
         return;
     }
-    const width = Math.min(screen.width - 2, Math.max(34, Math.floor(screen.width * 0.62)));
+    const width = Math.min(screen.width - 2, Math.max(34, Math.floor(screen.width * modalWidthRatio(state))));
     const height = Math.min(screen.height - 2, modalHeight(state));
     const x = Math.max(0, Math.floor((screen.width - width) / 2));
     const y = Math.max(0, Math.floor((screen.height - height) / 2));
@@ -12,7 +13,7 @@ export function renderModal(state, screen) {
     drawBox(screen, x, y, width, height, title(state), styles.borderFocused);
     const lines = modalLines(state);
     for (let row = 0; row < Math.min(lines.length, height - 2); row += 1) {
-        screen.put(x + 2, y + 1 + row, fitToWidth(lines[row], width - 4, x + 2), row === 1 ? styles.accent : {});
+        screen.put(x + 2, y + 1 + row, fitToWidth(stripAnsi(lines[row]), width - 4, x + 2), row === 1 ? styles.accent : {});
     }
 }
 function modalLines(state) {
@@ -39,6 +40,9 @@ function modalLines(state) {
             ...paletteLines(state)
         ];
     }
+    if (state.modal?.kind === "content") {
+        return state.modal.content.split("\n").slice(state.modal.scroll);
+    }
     return [];
 }
 function title(state) {
@@ -48,11 +52,20 @@ function title(state) {
     if (state.modal?.kind === "confirm") {
         return "Confirm";
     }
+    if (state.modal?.kind === "content") {
+        return state.modal.title;
+    }
     return "Command Palette";
 }
 function modalHeight(state) {
+    if (state.modal?.kind === "content") {
+        return Math.max(5, state.modal.content.split("\n").length + 2);
+    }
     return Math.max(5, modalLines(state).length + 2);
 }
+function modalWidthRatio(state) {
+    return state.modal?.kind === "content" ? 0.86 : 0.62;
+}
 function drawBox(screen, x, y, width, height, boxTitle, style) {
     screen.clearRect({ x, y, width, height });
     const innerWidth = Math.max(0, width - 2);

package/node_modules/toolcraft-design/dist/explorer/render/test-fixtures.js

@@ -6,7 +6,7 @@ import { renderExplorer } from "./index.js";
 export function renderStateSnapshot(state) {
     const screen = new ScreenBuffer(state.size.cols, state.size.rows);
     renderExplorer(state, screen);
-    return dumpScreen(screen);
+    return dumpScreen(screen).split("\n").map((line) => line.trimEnd()).join("\n");
 }
 export function dumpScreen(screen) {
     const lines = [];

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

@@ -45,6 +45,9 @@ class ExplorerRuntime {
                 await this.refreshRowsFromSource();
             },
             suspendAnd: async (fn) => this.suspendAnd(fn),
+            openModal: (content) => {
+                this.dispatch({ type: "modalOpened", title: content.title, content: content.content });
+            },
             toast: (msg, tone) => {
                 this.showToast(msg, tone);
             },

package/node_modules/toolcraft-design/dist/explorer/state.d.ts

@@ -48,6 +48,10 @@ export interface ActionContext<R> {
     filter: string;
     refresh: () => Promise<void>;
     suspendAnd: <T>(fn: () => Promise<T>) => Promise<T>;
+    openModal: (content: {
+        title: string;
+        content: string;
+    }) => void;
     toast: (msg: string, tone?: Tone) => void;
     confirm: (prompt: string) => Promise<boolean>;
     exit: (after?: () => void | Promise<void>) => void;
@@ -114,6 +118,11 @@ export interface ExplorerState {
         kind: "palette";
         query: string;
         cursor: number;
+    } | {
+        kind: "content";
+        title: string;
+        content: string;
+        scroll: number;
     };
     toast: {
         message: string;

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

@@ -19,6 +19,8 @@ export { formatCommandNotFound } from "./components/command-errors.js";
 export { formatCommandNotFoundPanel } from "./components/command-errors.js";
 export { renderTable } from "./components/table.js";
 export type { TableColumn, RenderTableOptions } from "./components/table.js";
+export { renderFileChanges } from "./components/file-changes.js";
+export type { FileChange, FileChangeDisplayMode, FileChangeKind, FileChangeOutputFormat, RenderFileChangesOptions } from "./components/file-changes.js";
 export { renderCatalog } from "./components/catalog.js";
 export type { CatalogGroup, CatalogItem, CatalogMetric, CatalogTone, RenderCatalogOptions } from "./components/catalog.js";
 export { renderDetailCard } from "./components/detail-card.js";

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

@@ -15,6 +15,7 @@ export * as helpFormatterPlain from "./components/help-formatter-plain.js";
 export { formatCommandNotFound } from "./components/command-errors.js";
 export { formatCommandNotFoundPanel } from "./components/command-errors.js";
 export { renderTable } from "./components/table.js";
+export { renderFileChanges } from "./components/file-changes.js";
 export { renderCatalog } from "./components/catalog.js";
 export { renderDetailCard } from "./components/detail-card.js";
 export { renderInspectorCard } from "./components/inspector-card.js";

package/node_modules/toolcraft-design/package.json

@@ -2,6 +2,7 @@
   "name": "toolcraft-design",
   "version": "0.0.2",
   "private": true,
+  "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,7 +18,8 @@
     "generate:design-docs:all": "tsx scripts/generate-docs.ts all"
   },
   "files": [
-    "dist"
+    "dist",
+    "LICENSE"
   ],
   "dependencies": {
     "fast-string-width": "^3.0.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terminal-pilot",
-  "version": "0.0.42",
+  "version": "0.0.44",
   "description": "Playwright-like SDK and CLI for automating interactive CLI apps through a real PTY",
   "type": "module",
   "main": "dist/index.js",