toolcraft 0.0.154 → 0.0.156

package/composition.json

@@ -113,7 +113,7 @@
     },
     {
       "name": "toolcraft",
-      "version": "0.0.154",
+      "version": "0.0.156",
       "license": "MIT"
     },
     {
@@ -123,7 +123,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.154",
+      "version": "0.0.156",
       "license": "MIT"
     },
     {

package/dist/composition.json

@@ -113,7 +113,7 @@
     },
     {
       "name": "toolcraft",
-      "version": "0.0.154",
+      "version": "0.0.156",
       "license": "MIT"
     },
     {
@@ -123,7 +123,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.154",
+      "version": "0.0.156",
       "license": "MIT"
     },
     {

package/node_modules/tiny-stdio-mcp-server/dist/composition.json

@@ -8,7 +8,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.154",
+      "version": "0.0.156",
       "license": "MIT"
     }
   ]

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

@@ -13,7 +13,8 @@ export type ActionRuntimeHandles = {
         content: string;
     }) => void;
     toast: (msg: string, tone?: Tone) => void;
-    confirm: (prompt: string) => Promise<boolean>;
+    confirm: ActionContext<unknown>["confirm"];
+    promptText: ActionContext<unknown>["promptText"];
     exit: (after?: () => void | Promise<void>) => void;
 };
 export declare function resolveAction<R>(state: ExplorerState, keyEvent: ExplorerKeypressEvent): Action<R> | null;

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

@@ -13,7 +13,8 @@ export function resolveAction(state, keyEvent) {
 }
 export function buildActionContext(state, _action, source, runtimeHandles, rowsOverride) {
     const detailActive = source === "both" && state.focused === "detail";
-    const row = rowsOverride?.[0] ?? (detailActive ? currentDetailRow(state) : currentRow(state)) ?? { id: "", title: "" };
+    const row = rowsOverride?.[0] ??
+        (detailActive ? currentDetailRow(state) : currentRow(state)) ?? { id: "", title: "" };
     const panes = runtimePanes(state);
     return {
         row,
@@ -26,6 +27,7 @@ export function buildActionContext(state, _action, source, runtimeHandles, rowsO
         openModal: runtimeHandles.openModal,
         toast: runtimeHandles.toast,
         confirm: runtimeHandles.confirm,
+        promptText: runtimeHandles.promptText,
         exit: runtimeHandles.exit,
         activePane: state.focused === "detail" ? panes[1] : panes[0],
         inactivePane: state.focused === "detail" ? panes[0] : panes[1]
@@ -39,21 +41,47 @@ function currentDetailItem(state) {
 }
 function currentDetailRow(state) {
     const item = currentDetailItem(state);
-    return item === undefined ? undefined : { id: item.id, title: item.title ?? item.id, subtitle: item.subtitle, badge: item.badge };
+    return item === undefined
+        ? undefined
+        : { id: item.id, title: item.title ?? item.id, subtitle: item.subtitle, badge: item.badge };
 }
 function selectedRows(state, fallback) {
     if (!state.multiSelect || state.selected.size === 0) {
         return fallback.id === "" ? [] : [fallback];
     }
     const source = state.focused === "detail"
-        ? (state.detail.items ?? []).map(item => ({ id: item.id, title: item.title ?? item.id, subtitle: item.subtitle, badge: item.badge }))
+        ? (state.detail.items ?? []).map((item) => ({
+            id: item.id,
+            title: item.title ?? item.id,
+            subtitle: item.subtitle,
+            badge: item.badge
+        }))
         : state.rows;
     return source.filter((row) => state.selected.has(row.id));
 }
 function runtimePanes(state) {
     const definitions = state.paneDefinitions;
     return [
-        { id: definitions[0]?.id ?? "list", title: definitions[0]?.title ?? state.title, rows: state.rows, cursor: state.cursor, selected: state.selected, filter: state.filter },
-        { id: definitions[1]?.id ?? "detail", title: definitions[1]?.title ?? "Preview", rows: (state.detail.items ?? []).map(item => ({ id: item.id, title: item.title ?? item.id, subtitle: item.subtitle, badge: item.badge })), cursor: state.detail.cursor, selected: state.selected, filter: "" }
+        {
+            id: definitions[0]?.id ?? "list",
+            title: definitions[0]?.title ?? state.title,
+            rows: state.rows,
+            cursor: state.cursor,
+            selected: state.selected,
+            filter: state.filter
+        },
+        {
+            id: definitions[1]?.id ?? "detail",
+            title: definitions[1]?.title ?? "Preview",
+            rows: (state.detail.items ?? []).map((item) => ({
+                id: item.id,
+                title: item.title ?? item.id,
+                subtitle: item.subtitle,
+                badge: item.badge
+            })),
+            cursor: state.detail.cursor,
+            selected: state.selected,
+            filter: ""
+        }
     ];
 }

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

@@ -65,7 +65,12 @@ export type ExplorerEvent = {
 };
 export type ConfirmModal = {
     kind: "confirm";
-    action: Action<unknown>;
-    rows: Row[];
+    title: string;
+    message: string;
+    confirmLabel: string;
+    cancelLabel: string;
+    destructive: boolean;
+    action?: Action<unknown>;
+    rows?: Row[];
     resolver: (ok: boolean) => void;
 };

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

@@ -4,5 +4,5 @@ export { createInitialState, normalizeExplorerConfig } from "./state.js";
 export { resolveBindings } from "./keymap.js";
 export type { Effect, ExplorerEvent } from "./events.js";
 export type { BindingTarget, ExplorerBindingDefaults, ExplorerBuiltinCommand, ResolvedBindings } from "./keymap.js";
-export type { Action, ActionContext, Detail, DetailCtx, DetailItem, Dirty, ExplorerConfig, PaneConfig, ListPaneConfig, DetailPaneConfig, PaneRuntimeState, ExplorerLayoutMode, ExplorerSize, ExplorerState, ReorderContext, Row, Tone } from "./state.js";
+export type { Action, ActionContext, ConfirmPromptOptions, Detail, DetailCtx, DetailItem, Dirty, ExplorerConfig, PaneConfig, ListPaneConfig, DetailPaneConfig, PaneRuntimeState, ExplorerLayoutMode, ExplorerSize, ExplorerState, ReorderContext, Row, Tone } from "./state.js";
 export declare function singleDetail<R>(fn: (row: Row, ctx: DetailCtx) => string | Promise<string>): Detail<R>;

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) {
@@ -157,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") {
@@ -240,17 +256,25 @@ function rowsLoaded(state, rows) {
     const matchPositions = createMatchPositions(matches);
     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));
+        : 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, rowsLoading: false, filtered, matchPositions, cursor, selected, detail, modal };
+    const nextView = {
+        ...state,
+        rows,
+        rowsLoading: false,
+        filtered,
+        matchPositions,
+        cursor,
+        selected,
+        detail,
+        modal
+    };
     const next = {
         ...nextView,
         actionState: recomputeActionState(nextView),
@@ -348,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)) {
@@ -363,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);
@@ -439,13 +464,24 @@ function updateDetailFilter(state, filter) {
     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 },
+        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);
+    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";
@@ -498,7 +534,7 @@ function confirmKey(state, runtimeHandles) {
     if (state.modal?.kind === "confirm") {
         return modalDismissed(state, true, runtimeHandles);
     }
-    const hasActions = [...state.actionState.values()].some(entry => entry.available && entry.running !== true);
+    const hasActions = [...state.actionState.values()].some((entry) => entry.available && entry.running !== true);
     return hasActions
         ? setModal(state, { kind: "palette", query: "", cursor: 0 })
         : dispatchPrimary(state, runtimeHandles);
@@ -508,7 +544,9 @@ function toggleSelect(state) {
         return mark(state, 0);
     }
     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 };
+    const row = detailItem === undefined
+        ? currentRow(state)
+        : { id: detailItem.id, title: detailItem.title ?? detailItem.id };
     if (row === undefined) {
         return mark(state, 0);
     }
@@ -748,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
@@ -865,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.js

@@ -12,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, state.paneDefinitions[1]?.title ?? "Preview", state.focused === "detail" ? styles.borderFocused : styles.border, { focused: state.focused === "detail", indicator: scrollIndicator(state) });
+        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, state.paneDefinitions[1]?.title ?? "Preview", state.focused === "detail" ? styles.borderFocused : styles.border, { focused: state.focused === "detail", indicator: scrollIndicator(state) });
+    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) {

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

@@ -36,6 +36,18 @@ 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 });

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;
-}

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

@@ -5,13 +5,13 @@ import { createDetailJobs } from "./jobs.js";
 import { computeExplorerLayout } from "./layout.js";
 import { renderExplorer } from "./render/index.js";
 import { step } from "./reducer.js";
-import { createInitialState, REGION_ALL, REGION_MODAL, REGION_TOAST, normalizeExplorerConfig } from "./state.js";
+import { createInitialState, REGION_ALL, REGION_FOOTER, REGION_MODAL, REGION_TOAST, normalizeExplorerConfig } from "./state.js";
 const TOAST_MS = 2500;
 export async function runExplorer(config) {
     if (process.stdout.isTTY !== true) {
         throw new Error("explorer requires a TTY");
     }
-    const driver = createTerminalDriver();
+    const driver = createTerminalDriver({ mouse: config.mouse });
     const runtime = new ExplorerRuntime(config, driver);
     return runtime.run();
 }
@@ -59,6 +59,7 @@ class ExplorerRuntime {
                 this.showToast(msg, tone);
             },
             confirm: async (prompt) => this.confirm(prompt),
+            promptText: async (options) => this.promptText(options),
             exit: (after) => {
                 this.exit(null, after);
             }
@@ -98,15 +99,30 @@ class ExplorerRuntime {
             this.trace("input", { event });
             if (event.type === "paste") {
                 for (const ch of event.text.replaceAll("\n", "").replaceAll("\r", "")) {
-                    this.dispatch({ type: "key", key: { ch, name: ch, ctrl: false, meta: false, shift: false } });
+                    this.dispatch({
+                        type: "key",
+                        key: { ch, name: ch, ctrl: false, meta: false, shift: false }
+                    });
                 }
                 return;
             }
             if (event.type === "wheel") {
-                this.dispatch({ type: "key", key: { name: event.direction, ctrl: false, meta: false, shift: false } });
+                this.dispatch({
+                    type: "key",
+                    key: { name: event.direction, ctrl: false, meta: false, shift: false }
+                });
                 return;
             }
-            this.dispatch({ type: "key", key: { name: event.name, ch: event.ch, ctrl: event.ctrl, meta: event.alt, shift: event.shift } });
+            this.dispatch({
+                type: "key",
+                key: {
+                    name: event.name,
+                    ch: event.ch,
+                    ctrl: event.ctrl,
+                    meta: event.alt,
+                    shift: event.shift
+                }
+            });
         });
     }
     pauseKeypress() {
@@ -279,21 +295,38 @@ class ExplorerRuntime {
     }
     confirm(prompt) {
         return new Promise((resolve) => {
-            const action = {
-                id: "__confirm__",
-                label: prompt,
-                handler: () => undefined
-            };
-            const row = this.currentRow();
+            const options = typeof prompt === "string"
+                ? { title: "Confirm", message: prompt }
+                : prompt;
             this.state = {
                 ...this.state,
                 modal: {
                     kind: "confirm",
-                    action,
-                    rows: row === undefined ? [] : [row],
+                    title: options.title,
+                    message: options.message,
+                    confirmLabel: options.confirmLabel ?? "Yes",
+                    cancelLabel: options.cancelLabel ?? "No",
+                    destructive: options.destructive ?? false,
                     resolver: resolve
                 },
-                dirty: REGION_MODAL
+                dirty: REGION_MODAL | REGION_FOOTER
+            };
+            this.scheduleRender();
+        });
+    }
+    promptText(options) {
+        return new Promise((resolve) => {
+            this.state = {
+                ...this.state,
+                modal: {
+                    kind: "input",
+                    title: options.title,
+                    label: options.label,
+                    value: options.initialValue ?? "",
+                    placeholder: options.placeholder,
+                    resolver: resolve
+                },
+                dirty: REGION_MODAL | REGION_FOOTER
             };
             this.scheduleRender();
         });
@@ -340,7 +373,11 @@ class ExplorerRuntime {
         renderExplorer({ ...this.state, dirty: REGION_ALL }, this.screen);
         const frame = this.screen.flush();
         this.driver.writeFrame(frame);
-        this.trace("frame", { bytes: Buffer.byteLength(frame), cols: this.state.size.cols, rows: this.state.size.rows });
+        this.trace("frame", {
+            bytes: Buffer.byteLength(frame),
+            cols: this.state.size.cols,
+            rows: this.state.size.rows
+        });
         this.state = { ...this.state, dirty: 0 };
     }
     track(promise) {

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

@@ -1,5 +1,12 @@
 import { type ResolvedBindings } from "./keymap.js";
 export type Tone = "success" | "warning" | "error" | "info" | "muted";
+export interface ConfirmPromptOptions {
+    title: string;
+    message: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    destructive?: boolean;
+}
 export interface Row {
     id: string;
     title: string;
@@ -59,7 +66,13 @@ export interface ActionContext<R> {
         content: string;
     }) => void;
     toast: (msg: string, tone?: Tone) => void;
-    confirm: (prompt: string) => Promise<boolean>;
+    confirm: (prompt: string | ConfirmPromptOptions) => Promise<boolean>;
+    promptText: (options: {
+        title: string;
+        label: string;
+        initialValue?: string;
+        placeholder?: string;
+    }) => Promise<string | null>;
     exit: (after?: () => void | Promise<void>) => void;
     activePane?: PaneRuntimeState;
     inactivePane?: PaneRuntimeState;
@@ -76,6 +89,7 @@ export interface DetailPaneConfig {
     id: string;
     kind: "detail";
     title: string;
+    titleForRow?: (row: Row | undefined) => string;
     render: (row: Row | undefined, ctx: DetailCtx) => string | Promise<string>;
 }
 export type PaneConfig = ListPaneConfig | DetailPaneConfig;
@@ -107,6 +121,8 @@ export interface ExplorerConfig<R> {
     initialFilter?: string;
     /** Synchronous first paint rows; still refreshed via `rows()` after start. */
     initialRows?: Row[];
+    /** Disable terminal mouse reporting when native text selection is more useful than wheel input. */
+    mouse?: boolean;
 }
 export type NormalizedExplorerConfig<R> = ExplorerConfig<R> & {
     rows: () => Promise<Row[]>;
@@ -153,9 +169,21 @@ export interface ExplorerState {
         kind: "help";
     } | {
         kind: "confirm";
-        action: Action<unknown>;
-        rows: Row[];
+        title: string;
+        message: string;
+        confirmLabel: string;
+        cancelLabel: string;
+        destructive: boolean;
         resolver: (ok: boolean) => void;
+        action?: Action<unknown>;
+        rows?: Row[];
+    } | {
+        kind: "input";
+        title: string;
+        label: string;
+        value: string;
+        placeholder?: string;
+        resolver: (value: string | null) => void;
     } | {
         kind: "palette";
         query: string;
@@ -181,6 +209,7 @@ export interface ExplorerState {
         id: string;
         title: string;
         kind: "list" | "detail";
+        titleForRow?: (row: Row | undefined) => string;
     }>;
 }
 export interface ActionStateEntry {

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

@@ -10,16 +10,21 @@ export function normalizeExplorerConfig(config) {
     const list = config.panes.find((pane) => pane.kind === "list");
     if (list === undefined)
         throw new Error("Explorer requires a list pane");
-    const companion = config.panes.find(pane => pane !== list);
+    const companion = config.panes.find((pane) => pane !== list);
     const detail = companion?.kind === "detail"
-        ? { items: async (row, ctx) => {
+        ? {
+            items: async (row, ctx) => {
                 const content = await companion.render(row, ctx);
                 if (ctx.signal.aborted)
                     return [];
                 return [{ id: row.id, render: () => content, renderedContent: content }];
-            } }
+            }
+        }
         : companion?.kind === "list"
-            ? { items: async () => (await companion.rows()).map(row => ({ ...row, render: () => "" })), actions: config.actions }
+            ? {
+                items: async () => (await companion.rows()).map((row) => ({ ...row, render: () => "" })),
+                actions: config.actions
+            }
             : { items: async () => [] };
     return {
         ...config,
@@ -35,12 +40,7 @@ export const REGION_DETAIL = 1 << 2;
 export const REGION_FOOTER = 1 << 3;
 export const REGION_MODAL = 1 << 4;
 export const REGION_TOAST = 1 << 5;
-export const REGION_ALL = REGION_HEADER |
-    REGION_LIST |
-    REGION_DETAIL |
-    REGION_FOOTER |
-    REGION_MODAL |
-    REGION_TOAST;
+export const REGION_ALL = REGION_HEADER | REGION_LIST | REGION_DETAIL | REGION_FOOTER | REGION_MODAL | REGION_TOAST;
 export function createInitialState(config, size) {
     const normalizedConfig = normalizeExplorerConfig(config);
     const normalizedSize = {
@@ -82,7 +82,12 @@ export function createInitialState(config, size) {
         bindings: resolveBindings(normalizedConfig),
         actionState: createInitialActionState(normalizedConfig),
         suspended: false,
-        paneDefinitions: normalizedConfig.panes?.map(({ id, title, kind }) => ({ id, title, kind })) ?? [
+        paneDefinitions: normalizedConfig.panes?.map(({ id, title, kind, ...pane }) => ({
+            id,
+            title,
+            kind,
+            ...(kind === "detail" && "titleForRow" in pane ? { titleForRow: pane.titleForRow } : {})
+        })) ?? [
             { id: "list", title: normalizedConfig.title, kind: "list" },
             { id: "detail", title: "Preview", kind: "detail" }
         ]
@@ -90,10 +95,13 @@ export function createInitialState(config, size) {
 }
 function createInitialActionState(config) {
     const state = new Map();
-    for (const [source, actions] of [["row", config.actions], ["detail", config.detail?.actions ?? []]]) {
+    for (const [source, actions] of [
+        ["row", config.actions],
+        ["detail", config.detail?.actions ?? []]
+    ]) {
         for (const action of actions) {
             if (state.has(action.id)) {
-                const isSharedListAction = config.panes?.some(pane => pane.kind === "list" && pane !== config.panes?.[0]) === true;
+                const isSharedListAction = config.panes?.some((pane) => pane.kind === "list" && pane !== config.panes?.[0]) === true;
                 if (!isSharedListAction)
                     throw new Error(`Duplicate explorer action id: ${action.id}`);
                 const existing = state.get(action.id);

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

@@ -38,7 +38,7 @@ export { createDashboard, shouldUseInteractiveDashboard } from "./dashboard/inde
 export type { Dashboard, DashboardOptions } from "./dashboard/index.js";
 export * as explorer from "./explorer/index.js";
 export { runExplorer, singleDetail, normalizeExplorerConfig } from "./explorer/index.js";
-export type { Row, DetailItem, Detail, DetailCtx, Action, ActionContext, ExplorerConfig, PaneConfig, ListPaneConfig, DetailPaneConfig, PaneRuntimeState, ReorderContext, Tone } from "./explorer/index.js";
+export type { Row, DetailItem, Detail, DetailCtx, Action, ActionContext, ConfirmPromptOptions, ExplorerConfig, PaneConfig, ListPaneConfig, DetailPaneConfig, PaneRuntimeState, ReorderContext, Tone } from "./explorer/index.js";
 export * as prompts from "./prompts/index.js";
 export { intro, introPlain, outro, note, select, multiselect, text as promptText, confirm, confirmOrCancel, password, spinner, withSpinner, isCancel, cancel, log, PromptCancelledError } from "./prompts/index.js";
 export type { SelectOptions, MultiselectOptions, TextOptions, ConfirmOptions, PasswordOptions, SpinnerOptions, WithSpinnerOptions } from "./prompts/index.js";

package/node_modules/toolcraft-design/dist/terminal/driver.d.ts

@@ -29,5 +29,6 @@ export declare function createTerminalDriver(options?: {
     input?: InputStream;
     output?: OutputStream;
     escTimeoutMs?: number;
+    mouse?: boolean;
 }): TerminalDriver;
 export type { TerminalInputEvent } from "./input.js";

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

@@ -10,7 +10,7 @@ export function createTerminalDriver(options = {}) {
             listener(event);
     };
     const parser = createInputParser({ escTimeoutMs: options.escTimeoutMs, onEvent: emit });
-    const writer = createFrameWriter(output);
+    const writer = createFrameWriter(output, { mouse: options.mouse });
     let started = false;
     const onData = (chunk) => {
         for (const event of parser.feed(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)))
@@ -46,11 +46,15 @@ export function createTerminalDriver(options = {}) {
         },
         onEvent(fn) {
             eventListeners.add(fn);
-            return () => { eventListeners.delete(fn); };
+            return () => {
+                eventListeners.delete(fn);
+            };
         },
         onResize(fn) {
             resizeListeners.add(fn);
-            return () => { resizeListeners.delete(fn); };
+            return () => {
+                resizeListeners.delete(fn);
+            };
         },
         getSize,
         writeFrame: writer.writeFrame

package/node_modules/toolcraft-design/dist/terminal/output.d.ts

@@ -5,4 +5,6 @@ export interface FrameWriter {
 }
 export declare function createFrameWriter(stream: {
     write(value: string): boolean;
+}, options?: {
+    mouse?: boolean;
 }): FrameWriter;

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

@@ -1,6 +1,8 @@
-const OPEN = "\u001b[?1049h\u001b[?25l\u001b[?2004h\u001b[?1000h\u001b[?1006h\u001b[?7l";
-const CLOSE = "\u001b[0m\u001b[?7h\u001b[?1006l\u001b[?1000l\u001b[?2004l\u001b[?25h\u001b[?1049l";
-export function createFrameWriter(stream) {
+const OPEN = "\u001b[?1049h\u001b[?25l\u001b[?2004h";
+const OPEN_MOUSE = "\u001b[?1000h\u001b[?1006h";
+const CLOSE_MOUSE = "\u001b[?1006l\u001b[?1000l";
+const CLOSE = "\u001b[?2004l\u001b[?25h\u001b[?1049l";
+export function createFrameWriter(stream, options = {}) {
     let opened = false;
     const interrupt = () => terminateWith("SIGINT");
     const terminate = () => terminateWith("SIGTERM");
@@ -16,7 +18,7 @@ export function createFrameWriter(stream) {
         if (opened)
             return;
         opened = true;
-        stream.write(OPEN);
+        stream.write(`${OPEN}${options.mouse === false ? CLOSE_MOUSE : OPEN_MOUSE}\u001b[?7l`);
         process.once("SIGINT", interrupt);
         process.once("SIGTERM", terminate);
         process.once("uncaughtException", fatal);
@@ -28,7 +30,7 @@ export function createFrameWriter(stream) {
         process.removeListener("SIGINT", interrupt);
         process.removeListener("SIGTERM", terminate);
         process.removeListener("uncaughtException", fatal);
-        stream.write(CLOSE);
+        stream.write(`\u001b[0m\u001b[?7h${options.mouse === false ? "" : CLOSE_MOUSE}${CLOSE}`);
     }
     return {
         open,

package/node_modules/toolcraft-schema/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft-schema",
-  "version": "0.0.154",
+  "version": "0.0.156",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft",
-  "version": "0.0.154",
+  "version": "0.0.156",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
@@ -158,7 +158,7 @@
     "yaml"
   ],
   "optionalDependencies": {
-    "toolcraft-schema": "0.0.154",
+    "toolcraft-schema": "0.0.156",
     "toolcraft-design": "*",
     "@poe-code/frontmatter": "*",
     "@poe-code/agent-mcp-config": "*",