@kamilio/wire 0.1.9 → 0.1.11

package/node_modules/toolcraft/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;
@@ -30,12 +37,16 @@ export interface DetailCtx {
     height: number;
     signal: AbortSignal;
     row: Row;
+    /** Re-run detail.items for the focused row and repaint the preview pane. */
+    reloadDetail?: () => void;
 }
 export interface Action<R> {
     id: string;
     label: string | (() => string);
     key?: string | string[];
+    accelerator?: string;
     predicate?: (ctx: ActionContext<R>) => boolean;
+    visible?: (row: Row) => boolean;
     handler: (ctx: ActionContext<R>) => void | Promise<void>;
     destructive?: boolean;
     primary?: boolean;
@@ -47,20 +58,60 @@ export interface ActionContext<R> {
     item?: DetailItem;
     filter: string;
     refresh: () => Promise<void>;
+    /** Re-run detail.items for the focused row and repaint the preview pane. */
+    reloadDetail: () => 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>;
+    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;
+}
+export interface ListPaneConfig {
+    id: string;
+    kind: "list";
+    title: string;
+    rows: () => Promise<Row[]>;
+    emptyHint?: string;
+    multiSelect?: boolean;
+}
+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;
+export interface PaneRuntimeState {
+    id: string;
+    title: string;
+    rows: Row[];
+    cursor: number;
+    selected: Set<string>;
+    filter: string;
 }
 export interface ReorderContext {
+    movedId: string;
     refresh: () => Promise<void>;
     toast: (msg: string, tone?: Tone) => void;
 }
 export interface ExplorerConfig<R> {
     title: string;
-    rows: () => Promise<Row[]>;
-    refresh?: () => Promise<void>;
-    detail: Detail<R>;
+    panes?: PaneConfig[];
+    rows?: () => Promise<Row[]>;
+    refresh?: () => void | Promise<void>;
+    detail?: Detail<R>;
     actions: Action<R>[];
     reorder?: {
         onReorder: (orderedIds: string[], ctx?: ReorderContext) => void | Promise<void>;
@@ -69,7 +120,16 @@ export interface ExplorerConfig<R> {
     keybindOverrides?: Record<string, string | string[]>;
     emptyHint?: string;
     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[]>;
+    detail: Detail<R>;
+};
+export declare function normalizeExplorerConfig<R>(config: ExplorerConfig<R>): NormalizedExplorerConfig<R>;
 export declare const REGION_HEADER: number;
 export declare const REGION_LIST: number;
 export declare const REGION_DETAIL: number;
@@ -87,6 +147,7 @@ export interface ExplorerState {
     title: string;
     emptyHint: string;
     rows: Row[];
+    rowsLoading: boolean;
     filtered: number[];
     matchPositions: Map<number, number[]>;
     cursor: number;
@@ -96,6 +157,8 @@ export interface ExplorerState {
     detail: {
         rowId: string | null;
         items: DetailItem[] | null;
+        allItems?: DetailItem[] | null;
+        filter?: string;
         cursor: number;
         scroll: number;
         token: number;
@@ -107,13 +170,30 @@ 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;
         cursor: number;
+    } | {
+        kind: "content";
+        title: string;
+        content: string;
+        scroll: number;
     };
     toast: {
         message: string;
@@ -125,13 +205,20 @@ export interface ExplorerState {
     layout: ExplorerLayoutMode;
     bindings: ResolvedBindings;
     actionState: Map<string, ActionStateEntry>;
+    suspended: boolean;
+    paneDefinitions: Array<{
+        id: string;
+        title: string;
+        kind: "list" | "detail";
+        titleForRow?: (row: Row | undefined) => string;
+    }>;
 }
 export interface ActionStateEntry {
     available: boolean;
     label: string;
     running?: boolean;
     action?: Action<unknown>;
-    source?: "row" | "detail";
+    source?: "row" | "detail" | "both";
 }
 export declare function createInitialState<R>(config: ExplorerConfig<R>, size: ExplorerSize): ExplorerState;
-export declare function resolveExplorerLayoutMode(cols: number): ExplorerLayoutMode;
+export declare function resolveExplorerLayoutMode(cols: number, rows?: number): ExplorerLayoutMode;

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

@@ -1,39 +1,76 @@
 import { resolveBindings } from "./keymap.js";
+export function normalizeExplorerConfig(config) {
+    if (config.panes === undefined) {
+        if (config.rows === undefined || config.detail === undefined)
+            throw new Error("Explorer requires panes");
+        return config;
+    }
+    if (config.panes.length < 1 || config.panes.length > 3)
+        throw new Error("Explorer requires 1 to 3 panes");
+    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 detail = companion?.kind === "detail"
+        ? {
+            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 () => [] };
+    return {
+        ...config,
+        rows: list.rows,
+        detail,
+        multiSelect: list.multiSelect ?? config.multiSelect,
+        emptyHint: list.emptyHint ?? config.emptyHint
+    };
+}
 export const REGION_HEADER = 1 << 0;
 export const REGION_LIST = 1 << 1;
 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 = {
         cols: normalizeSize(size.cols),
         rows: normalizeSize(size.rows)
     };
-    const multiSelect = config.multiSelect ?? true;
+    const multiSelect = normalizedConfig.multiSelect ?? true;
+    const initialRows = normalizedConfig.initialRows ?? [];
+    const initialFilter = normalizedConfig.initialFilter ?? "";
+    // Defer filtering to first rowsLoaded when empty; seed list immediately when provided.
     return {
-        title: config.title,
-        emptyHint: config.emptyHint ?? "No detail",
-        rows: [],
-        filtered: [],
+        title: normalizedConfig.title,
+        emptyHint: normalizedConfig.emptyHint ?? "No detail",
+        rows: initialRows,
+        rowsLoading: true,
+        filtered: initialRows.map((_, index) => index),
         matchPositions: new Map(),
         cursor: 0,
-        filter: config.initialFilter ?? "",
+        filter: initialFilter,
         filterFocused: false,
         focused: "list",
         detail: {
-            rowId: null,
+            rowId: initialRows[0]?.id ?? null,
             items: null,
+            allItems: null,
+            filter: "",
             cursor: 0,
             scroll: 0,
-            token: 0,
-            loading: false
+            token: initialRows.length > 0 ? 1 : 0,
+            loading: initialRows.length > 0
         },
         selected: new Set(),
         multiSelect,
@@ -41,17 +78,35 @@ export function createInitialState(config, size) {
         toast: null,
         dirty: REGION_ALL,
         size: normalizedSize,
-        layout: resolveExplorerLayoutMode(normalizedSize.cols),
-        bindings: resolveBindings(config),
-        actionState: createInitialActionState(config)
+        layout: resolveExplorerLayoutMode(normalizedSize.cols, normalizedSize.rows),
+        bindings: resolveBindings(normalizedConfig),
+        actionState: createInitialActionState(normalizedConfig),
+        suspended: false,
+        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" }
+        ]
     };
 }
 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)) {
-                throw new Error(`Duplicate explorer action id: ${action.id}`);
+                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);
+                state.set(action.id, { ...existing, source: "both" });
+                continue;
             }
             state.set(action.id, {
                 available: true,
@@ -63,8 +118,8 @@ function createInitialActionState(config) {
     }
     return state;
 }
-export function resolveExplorerLayoutMode(cols) {
-    if (cols < 40) {
+export function resolveExplorerLayoutMode(cols, rows = 24) {
+    if (cols < 60 || rows < 8) {
         return "too-narrow";
     }
     if (cols < 80) {

package/node_modules/toolcraft/node_modules/toolcraft-design/dist/help-formatter.d.ts

@@ -1,2 +1,2 @@
-export { helpFormatter } from "./components/help-formatter.js";
-export type { CommandInfo, FormatColumnsOptions, OptionInfo } from "./components/help-formatter.js";
+export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList, styleHelpToken, joinHelpTokens, renderHelpTokens } from "./components/help-formatter.js";
+export type { CommandInfo, FormatColumnsOptions, OptionInfo, HelpToken, HelpTokenRole } from "./components/help-formatter.js";

package/node_modules/toolcraft/node_modules/toolcraft-design/dist/help-formatter.js

@@ -1 +1 @@
-export { helpFormatter } from "./components/help-formatter.js";
+export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList, styleHelpToken, joinHelpTokens, renderHelpTokens } from "./components/help-formatter.js";

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

@@ -12,13 +12,15 @@ export type { Color } from "./components/color.js";
 export { symbols } from "./components/symbols.js";
 export { createLogger, logger } from "./components/logger.js";
 export type { LoggerOutput } from "./components/logger.js";
-export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList } from "./components/help-formatter.js";
+export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList, styleHelpToken, joinHelpTokens, renderHelpTokens } from "./components/help-formatter.js";
 export * as helpFormatterPlain from "./components/help-formatter-plain.js";
-export type { CommandInfo, OptionInfo, FormatColumnsOptions } from "./components/help-formatter.js";
+export type { CommandInfo, OptionInfo, FormatColumnsOptions, HelpToken, HelpTokenRole } from "./components/help-formatter.js";
 export { formatCommandNotFound } from "./components/command-errors.js";
 export { formatCommandNotFoundPanel } from "./components/command-errors.js";
-export { renderTable } from "./components/table.js";
+export { loggerTableWidth, 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";
@@ -27,16 +29,16 @@ export { renderInspectorCard } from "./components/inspector-card.js";
 export type { InspectorField, InspectorSection, RenderInspectorCardOptions } from "./components/inspector-card.js";
 export { renderResourceBrowser } from "./components/resource-browser.js";
 export type { RenderResourceBrowserOptions, ResourceBrowserGroup, ResourceBrowserItem } from "./components/resource-browser.js";
-export { getTemplatePartialNames, renderTemplate, resolveTemplatePartials } from "./components/template.js";
+export { TemplateParseError, getTemplatePartialNames, renderTemplate, resolveTemplatePartials } from "./components/template.js";
 export type { RenderTemplateOptions, TemplateEscape } from "./components/template.js";
 export { openExternal } from "./components/browser.js";
 export * as acp from "./acp/index.js";
 export * as dashboard from "./dashboard/index.js";
-export { createDashboard, shouldUseInteractiveDashboard } from "./dashboard/index.js";
+export { createDashboard, createDashboardLineBuffer, createStreamingDashboardLineBuffer, shouldUseInteractiveDashboard } from "./dashboard/index.js";
 export type { Dashboard, DashboardOptions } from "./dashboard/index.js";
 export * as explorer from "./explorer/index.js";
-export { runExplorer, runTwoPaneExplorer, singleDetail } from "./explorer/index.js";
-export type { Row, DetailItem, Detail, DetailCtx, Action, ActionContext, TwoPaneAction, TwoPaneActionContext, TwoPaneDefinition, TwoPaneExplorerConfig, TwoPanePaneState, TwoPaneRow, ExplorerConfig, ReorderContext, Tone } from "./explorer/index.js";
+export { runExplorer, singleDetail, normalizeExplorerConfig } 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";
@@ -44,11 +46,22 @@ export { promptTheme } from "./prompts/theme.js";
 export * as staticRender from "./static/index.js";
 export { SPINNER_FRAMES, renderSpinnerFrame, renderSpinnerStopped, renderMenu } from "./static/index.js";
 export type { SpinnerFrameOptions, SpinnerStoppedOptions, MenuOption, RenderMenuOptions } from "./static/index.js";
-export { parse, render, renderHtml, renderMarkdown, renderMarkdownHtml } from "./terminal-markdown/index.js";
-export type { CodeToken, CodeTokenKind, HtmlRenderOptions, MdNode, RenderOptions } from "./terminal-markdown/index.js";
+export { parse, render, renderHtml, renderMarkdown, renderMarkdownHtml, renderPlaintext, renderMarkdownPlaintext } from "./terminal-markdown/index.js";
+export type { CodeToken, CodeTokenKind, HtmlRenderOptions, MdNode, PlaintextRenderOptions, RenderOptions } from "./terminal-markdown/index.js";
 export { getTheme, resolveThemeName, resetThemeCache } from "./internal/theme-detect.js";
 export type { ThemeEnv } from "./internal/theme-detect.js";
 export { configureTheme, getThemeConfig, resetTheme } from "./internal/theme-state.js";
 export { stripAnsi } from "./internal/strip-ansi.js";
 export { resolveOutputFormat, resetOutputFormatCache, withOutputFormat } from "./internal/output-format.js";
 export type { OutputFormat } from "./internal/output-format.js";
+export { createTerminalDriver } from "./terminal/driver.js";
+export type { TerminalDriver, TerminalInputEvent, Size as TerminalSize } from "./terminal/driver.js";
+export { Screen } from "./screen/screen.js";
+export type { Cell as ScreenCell, ScreenSize, ScreenSurface } from "./screen/screen.js";
+export { packStyle, styleToSgrDelta } from "./screen/style.js";
+export type { PackedStyle } from "./screen/style.js";
+export { createRenderPerformanceMonitor, formatRenderPerformance } from "./render-performance.js";
+export type { RenderPerformanceSnapshot, RenderPercentiles } from "./render-performance.js";
+export { createViewport, selectViewportTail } from "./viewport.js";
+export { createNotices, createCommandRegistry, createOverlayManager, createEventGroups, createTaskTree, renderTaskRows, renderEventGroupRows, renderProgressGroup, createMetric, renderNotice } from "./primitives.js";
+export type { DesignCommand, GroupEvent, EventGroupRow, TaskNode, ProgressItem, InlineNotice } from "./primitives.js";

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

@@ -10,25 +10,26 @@ export { text } from "./components/text.js";
 export { color } from "./components/color.js";
 export { symbols } from "./components/symbols.js";
 export { createLogger, logger } from "./components/logger.js";
-export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList } from "./components/help-formatter.js";
+export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList, styleHelpToken, joinHelpTokens, renderHelpTokens } from "./components/help-formatter.js";
 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 { loggerTableWidth, 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";
 export { renderResourceBrowser } from "./components/resource-browser.js";
-export { getTemplatePartialNames, renderTemplate, resolveTemplatePartials } from "./components/template.js";
+export { TemplateParseError, getTemplatePartialNames, renderTemplate, resolveTemplatePartials } from "./components/template.js";
 export { openExternal } from "./components/browser.js";
 // ACP rendering
 export * as acp from "./acp/index.js";
 // Dashboard
 export * as dashboard from "./dashboard/index.js";
-export { createDashboard, shouldUseInteractiveDashboard } from "./dashboard/index.js";
+export { createDashboard, createDashboardLineBuffer, createStreamingDashboardLineBuffer, shouldUseInteractiveDashboard } from "./dashboard/index.js";
 // Explorer
 export * as explorer from "./explorer/index.js";
-export { runExplorer, runTwoPaneExplorer, singleDetail } from "./explorer/index.js";
+export { runExplorer, singleDetail, normalizeExplorerConfig } from "./explorer/index.js";
 // Prompts
 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";
@@ -37,9 +38,17 @@ export { promptTheme } from "./prompts/theme.js";
 export * as staticRender from "./static/index.js";
 export { SPINNER_FRAMES, renderSpinnerFrame, renderSpinnerStopped, renderMenu } from "./static/index.js";
 // Terminal markdown
-export { parse, render, renderHtml, renderMarkdown, renderMarkdownHtml } from "./terminal-markdown/index.js";
+export { parse, render, renderHtml, renderMarkdown, renderMarkdownHtml, renderPlaintext, renderMarkdownPlaintext } from "./terminal-markdown/index.js";
 // Internal utilities (for advanced use)
 export { getTheme, resolveThemeName, resetThemeCache } from "./internal/theme-detect.js";
 export { configureTheme, getThemeConfig, resetTheme } from "./internal/theme-state.js";
 export { stripAnsi } from "./internal/strip-ansi.js";
 export { resolveOutputFormat, resetOutputFormatCache, withOutputFormat } from "./internal/output-format.js";
+// Terminal and screen primitives
+export { createTerminalDriver } from "./terminal/driver.js";
+export { Screen } from "./screen/screen.js";
+export { packStyle, styleToSgrDelta } from "./screen/style.js";
+// Bounded render diagnostics
+export { createRenderPerformanceMonitor, formatRenderPerformance } from "./render-performance.js";
+export { createViewport, selectViewportTail } from "./viewport.js";
+export { createNotices, createCommandRegistry, createOverlayManager, createEventGroups, createTaskTree, renderTaskRows, renderEventGroupRows, renderProgressGroup, createMetric, renderNotice } from "./primitives.js";

package/node_modules/toolcraft/node_modules/toolcraft-design/dist/inline-notice.d.ts

@@ -0,0 +1,14 @@
+export interface InlineNotice {
+    level: "info" | "success" | "warning" | "error";
+    text: string;
+}
+export declare function renderNotice(notice: InlineNotice, width: number): string;
+/** Notices expire during reads, so an idle terminal needs no repaint timer. */
+export declare function createNotices({ capacity, now }: {
+    capacity: number;
+    now?: () => number;
+}): {
+    put(id: string, notice: InlineNotice, durationMs?: number): void;
+    dismiss(id: string): void;
+    list(): InlineNotice[];
+};

package/node_modules/toolcraft/node_modules/toolcraft-design/dist/inline-notice.js

@@ -0,0 +1,28 @@
+import { plainTerminalText } from "./dashboard/ansi.js";
+import { limitOutputPreview } from "./dashboard/output-preview.js";
+import { fitToWidth } from "./explorer/render/text.js";
+export function renderNotice(notice, width) {
+    const marker = { info: "●", success: "✓", warning: "▲", error: "■" }[notice.level];
+    return fitToWidth(`${marker} ${plainTerminalText(notice.text)}`, width);
+}
+/** Notices expire during reads, so an idle terminal needs no repaint timer. */
+export function createNotices({ capacity, now = () => performance.now() }) {
+    if (!Number.isInteger(capacity) || capacity < 1)
+        throw new RangeError("positive capacity required");
+    const notices = new Map();
+    return {
+        put(id, notice, durationMs = Infinity) {
+            notices.set(id, { notice: { ...notice, text: limitOutputPreview(notice.text) }, expires: now() + Math.max(0, durationMs) });
+            if (notices.size > capacity)
+                notices.delete(notices.keys().next().value);
+        },
+        dismiss(id) { notices.delete(id); },
+        list() {
+            const time = now();
+            for (const [id, entry] of notices)
+                if (entry.expires <= time)
+                    notices.delete(id);
+            return Array.from(notices.values(), entry => ({ ...entry.notice }));
+        }
+    };
+}

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

@@ -0,0 +1,8 @@
+export declare function createMetric({ capacity, unit }: {
+    capacity: number;
+    unit: string;
+}): {
+    push(value: number | null): void;
+    samples(): (number | null)[];
+    render(width: number): string;
+};

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

@@ -0,0 +1,21 @@
+import { fitToWidth } from "./explorer/render/text.js";
+export function createMetric({ capacity, unit }) {
+    if (!Number.isInteger(capacity) || capacity < 1)
+        throw new RangeError("positive capacity required");
+    const values = Array(capacity).fill(null);
+    let count = 0;
+    let cursor = 0;
+    return {
+        push(value) { values[cursor] = value !== null && Number.isFinite(value) ? value : null; cursor = (cursor + 1) % capacity; count = Math.min(count + 1, capacity); },
+        samples() { return Array.from({ length: count }, (_, i) => values[(cursor - count + i + capacity) % capacity]); },
+        render(width) {
+            const samples = Array.from({ length: Math.min(count, Math.max(0, width)) }, (_, i) => values[(cursor - Math.min(count, Math.max(0, width)) + i + capacity) % capacity]);
+            const known = samples.filter((value) => value !== null);
+            const min = Math.min(...known);
+            const max = Math.max(...known);
+            const spark = samples.map(value => value === null ? "·" : "▁▂▃▄▅▆▇█"[max === min ? 3 : Math.round((value - min) / (max - min) * 7)]).join("");
+            const latest = count ? values[(cursor - 1 + capacity) % capacity] : null;
+            return fitToWidth(`${latest ?? "—"} ${unit} ${spark}`, width);
+        }
+    };
+}

package/node_modules/toolcraft/node_modules/toolcraft-design/dist/overlay-manager.d.ts

@@ -0,0 +1,6 @@
+export declare function createOverlayManager(initialFocus: string): {
+    open(focus: string): AbortSignal;
+    close(): boolean;
+    focus(): string;
+    dispose(): void;
+};

package/node_modules/toolcraft/node_modules/toolcraft-design/dist/overlay-manager.js

@@ -0,0 +1,10 @@
+export function createOverlayManager(initialFocus) {
+    const stack = [];
+    return {
+        open(focus) { const controller = new AbortController(); stack.push({ focus, controller }); return controller.signal; },
+        close() { const overlay = stack.pop(); overlay?.controller.abort(); return overlay !== undefined; },
+        focus() { return stack.at(-1)?.focus ?? initialFocus; },
+        dispose() { while (stack.length)
+            stack.pop().controller.abort(); }
+    };
+}

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

@@ -0,0 +1,12 @@
+export { createCommandRegistry } from "./command-registry.js";
+export type { DesignCommand } from "./command-registry.js";
+export { createOverlayManager } from "./overlay-manager.js";
+export { createEventGroups, renderEventGroupRows } from "./event-groups.js";
+export type { GroupEvent, EventGroupRow } from "./event-groups.js";
+export { createTaskTree, renderTaskRows } from "./task-tree.js";
+export type { TaskNode } from "./task-tree.js";
+export { renderProgressGroup } from "./progress-group.js";
+export type { ProgressItem } from "./progress-group.js";
+export { createMetric } from "./metric.js";
+export { renderNotice, createNotices } from "./inline-notice.js";
+export type { InlineNotice } from "./inline-notice.js";

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

@@ -0,0 +1,7 @@
+export { createCommandRegistry } from "./command-registry.js";
+export { createOverlayManager } from "./overlay-manager.js";
+export { createEventGroups, renderEventGroupRows } from "./event-groups.js";
+export { createTaskTree, renderTaskRows } from "./task-tree.js";
+export { renderProgressGroup } from "./progress-group.js";
+export { createMetric } from "./metric.js";
+export { renderNotice, createNotices } from "./inline-notice.js";

package/node_modules/toolcraft/node_modules/toolcraft-design/dist/progress-group.d.ts

@@ -0,0 +1,7 @@
+export interface ProgressItem {
+    label: string;
+    completed?: number;
+    total?: number;
+    status?: "running" | "success" | "error";
+}
+export declare function renderProgressGroup(items: readonly ProgressItem[], width: number): string[];

package/node_modules/toolcraft/node_modules/toolcraft-design/dist/progress-group.js

@@ -0,0 +1,10 @@
+import { plainTerminalText } from "./dashboard/ansi.js";
+import { fitToWidth } from "./explorer/render/text.js";
+export function renderProgressGroup(items, width) {
+    return items.map(item => {
+        const known = item.total !== undefined && item.total > 0 && Number.isFinite(item.total) && item.completed !== undefined && Number.isFinite(item.completed);
+        const progress = known ? `${Math.round(Math.max(0, Math.min(1, item.completed / item.total)) * 100)}%` : "…";
+        const marker = item.status === "success" ? "✓" : item.status === "error" ? "■" : "●";
+        return fitToWidth(`${marker} ${plainTerminalText(item.label)} ${progress}`, width);
+    });
+}

package/node_modules/toolcraft/node_modules/toolcraft-design/dist/prompts/interactive/core.d.ts

@@ -1,6 +1,11 @@
 import { EventEmitter } from "node:events";
 import { CANCEL } from "./cancel-symbol.js";
 export type PromptStateName = "initial" | "active" | "submit" | "cancel" | "error";
+/**
+ * Builds the non-TTY rejection message, naming the documented `--yes` flag for the
+ * command being run and keeping `POE_NO_PROMPT=1` as the secondary CI alternative.
+ */
+export declare function nonTtyPromptMessage(argv?: string[]): string;
 export interface PromptState<Value> {
     state: PromptStateName;
     value: Value | undefined;
@@ -19,6 +24,8 @@ export interface PromptOptions<Value> {
 }
 type InputStream = NodeJS.ReadableStream & {
     isTTY?: boolean;
+    destroyed?: boolean;
+    readableEnded?: boolean;
     setRawMode?: (enabled: boolean) => void;
     unpipe?: () => void;
 };
@@ -36,17 +43,17 @@ export declare class Prompt<Value> extends EventEmitter {
     private readonly trackValue;
     private previousFrame;
     private readlineInterface?;
-    private abortListener?;
     private closed;
     constructor(opts: PromptOptions<Value>, trackValue?: boolean);
     get cursor(): number;
     prompt(): Promise<Value | typeof CANCEL>;
     protected promptNonTty(): Promise<Value | typeof CANCEL>;
-    protected readNonTtyLine(): Promise<string>;
+    protected readNonTtyLine(): Promise<string | typeof CANCEL>;
     protected setValue(value: Value | undefined): void;
     protected setError(message: string): void;
     protected setUserInput(value: string): void;
     protected clearUserInput(): void;
+    private readonly onCancel;
     private readonly onKeypress;
     private updateTrackedInput;
     protected readonly render: () => void;