toolcraft-openapi 0.0.64 → 0.0.66

package/node_modules/toolcraft-design/dist/components/inspector-card.d.ts

@@ -0,0 +1,21 @@
+import type { ThemePalette } from "../tokens/colors.js";
+export interface InspectorField {
+    label: string;
+    value: string;
+}
+export interface InspectorSection {
+    title?: string;
+    fields: InspectorField[];
+}
+export interface RenderInspectorCardOptions {
+    theme: ThemePalette;
+    title: string;
+    subtitle?: string;
+    badges?: string[];
+    preview?: string;
+    previewTitle?: string;
+    sections?: InspectorSection[];
+    width?: number;
+    maxPreviewLines?: number;
+}
+export declare function renderInspectorCard(options: RenderInspectorCardOptions): string;

package/node_modules/toolcraft-design/dist/components/inspector-card.js

@@ -0,0 +1,42 @@
+import { renderDetailCard } from "./detail-card.js";
+export function renderInspectorCard(options) {
+    const preview = truncatePreview(options.preview, options.maxPreviewLines ?? 8);
+    const sections = (options.sections ?? [])
+        .filter((section) => section.fields.length > 0)
+        .map((section) => ({
+        title: section.title,
+        rows: section.fields.map((field) => ({ label: field.label, value: field.value }))
+    }));
+    return renderDetailCard({
+        theme: options.theme,
+        title: options.title,
+        subtitle: options.subtitle,
+        badges: options.badges,
+        prose: preview === undefined
+            ? undefined
+            : [{
+                    title: options.previewTitle ?? "Preview",
+                    value: preview
+                }],
+        sections,
+        width: options.width
+    });
+}
+function truncatePreview(value, maxLines) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const lines = splitLines(value).map((line) => line.trimEnd());
+    const firstContent = lines.findIndex((line) => line.trim().length > 0);
+    const contentLines = firstContent === -1 ? [] : lines.slice(firstContent);
+    if (contentLines.length === 0) {
+        return undefined;
+    }
+    if (contentLines.length <= maxLines) {
+        return contentLines.join("\n");
+    }
+    return [...contentLines.slice(0, maxLines), `... ${contentLines.length - maxLines} more line(s)`].join("\n");
+}
+function splitLines(content) {
+    return content.split("\n").map((line) => line.endsWith("\r") ? line.slice(0, -1) : line);
+}

package/node_modules/toolcraft-design/dist/components/resource-browser.d.ts

@@ -0,0 +1,21 @@
+import type { ThemePalette } from "../tokens/colors.js";
+export interface ResourceBrowserItem {
+    label: string;
+    meta?: string[];
+    preview?: string;
+    badge?: string;
+}
+export interface ResourceBrowserGroup {
+    title: string;
+    description?: string;
+    emptyHint?: string;
+    items: ResourceBrowserItem[];
+}
+export interface RenderResourceBrowserOptions {
+    theme: ThemePalette;
+    title: string;
+    subtitle?: string;
+    groups: ResourceBrowserGroup[];
+    footer?: string;
+}
+export declare function renderResourceBrowser(options: RenderResourceBrowserOptions): string;

package/node_modules/toolcraft-design/dist/components/resource-browser.js

@@ -0,0 +1,98 @@
+import { resolveOutputFormat } from "../internal/output-format.js";
+import { stripAnsi } from "../internal/strip-ansi.js";
+export function renderResourceBrowser(options) {
+    switch (resolveOutputFormat()) {
+        case "markdown":
+            return renderMarkdown(options);
+        case "json":
+            return renderJson(options);
+        default:
+            return renderTerminal(options);
+    }
+}
+function renderTerminal(options) {
+    const blocks = [renderTitle(options)];
+    for (const group of options.groups) {
+        blocks.push(renderTerminalGroup(options.theme, group));
+    }
+    if (options.footer !== undefined) {
+        blocks.push(options.theme.muted(options.footer));
+    }
+    return blocks.join("\n\n");
+}
+function renderTitle(options) {
+    return [
+        options.theme.header(options.title),
+        options.subtitle === undefined ? undefined : options.theme.muted(options.subtitle)
+    ].filter((value) => value !== undefined).join("  ");
+}
+function renderTerminalGroup(theme, group) {
+    const lines = [
+        `${theme.header(group.title)}  ${theme.muted(String(group.items.length))}`,
+        ...(group.description === undefined ? [] : [theme.muted(group.description)])
+    ];
+    if (group.items.length === 0) {
+        lines.push(theme.muted(group.emptyHint ?? "No items"));
+        return lines.join("\n");
+    }
+    for (const [index, item] of group.items.entries()) {
+        lines.push(...renderTerminalItem(theme, item));
+        if (index < group.items.length - 1) {
+            lines.push("");
+        }
+    }
+    return lines.join("\n");
+}
+function renderTerminalItem(theme, item) {
+    return [
+        `${theme.accent(">")} ${theme.header(item.label)}${item.badge === undefined ? "" : `  ${theme.info(item.badge)}`}`,
+        ...(item.meta === undefined || item.meta.length === 0 ? [] : [`  ${theme.muted(item.meta.join(" · "))}`]),
+        ...(item.preview === undefined || item.preview.length === 0 ? [] : [`  ${theme.muted(item.preview)}`])
+    ];
+}
+function renderMarkdown(options) {
+    const blocks = [`# ${stripAnsi(options.title)}`];
+    if (options.subtitle !== undefined) {
+        blocks.push(stripAnsi(options.subtitle));
+    }
+    for (const group of options.groups) {
+        const lines = [`## ${stripAnsi(group.title)} (${group.items.length})`];
+        if (group.description !== undefined) {
+            lines.push(stripAnsi(group.description));
+        }
+        if (group.items.length === 0) {
+            lines.push(stripAnsi(group.emptyHint ?? "No items"));
+        }
+        else {
+            lines.push(...group.items.map((item) => renderMarkdownItem(item)));
+        }
+        blocks.push(lines.join("\n\n"));
+    }
+    if (options.footer !== undefined) {
+        blocks.push(stripAnsi(options.footer));
+    }
+    return blocks.join("\n\n");
+}
+function renderMarkdownItem(item) {
+    const meta = item.meta === undefined || item.meta.length === 0 ? "" : ` — ${item.meta.map(stripAnsi).join(" · ")}`;
+    const preview = item.preview === undefined || item.preview.length === 0 ? "" : `: ${stripAnsi(item.preview)}`;
+    return `- **${stripAnsi(item.label)}**${meta}${preview}`;
+}
+function renderJson(options) {
+    return JSON.stringify({
+        title: stripAnsi(options.title),
+        ...(options.subtitle === undefined ? {} : { subtitle: stripAnsi(options.subtitle) }),
+        groups: options.groups.map((group) => ({
+            title: stripAnsi(group.title),
+            ...(group.description === undefined ? {} : { description: stripAnsi(group.description) }),
+            ...(group.emptyHint === undefined ? {} : { emptyHint: stripAnsi(group.emptyHint) }),
+            items: group.items.map((item) => ({
+                label: stripAnsi(item.label),
+                ...(item.meta === undefined ? {} : { meta: item.meta.map(stripAnsi) }),
+                ...(item.preview === undefined ? {} : { preview: stripAnsi(item.preview) }),
+                ...(item.badge === undefined ? {} : { badge: stripAnsi(item.badge) })
+            }))
+        })),
+        ...(options.footer === undefined ? {} : { footer: stripAnsi(options.footer) })
+    }, null, 2);
+}

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

@@ -1,8 +1,10 @@
 import type { Detail, DetailCtx, Row } from "./state.js";
 export { runExplorer } from "./runtime.js";
+export { runTwoPaneExplorer, renderTwoPaneExplorer, TwoPaneExplorerRuntime } from "./two-pane.js";
 export { createInitialState } 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, ExplorerLayoutMode, ExplorerSize, ExplorerState, ReorderContext, Row, Tone } from "./state.js";
+export type { TwoPaneAction, TwoPaneActionContext, TwoPaneDefinition, TwoPaneExplorerConfig, TwoPaneExplorerState, TwoPanePaneState, TwoPaneRow } from "./two-pane.js";
 export declare function singleDetail<R>(fn: (row: Row, ctx: DetailCtx) => string | Promise<string>): Detail<R>;

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

@@ -1,4 +1,5 @@
 export { runExplorer } from "./runtime.js";
+export { runTwoPaneExplorer, renderTwoPaneExplorer, TwoPaneExplorerRuntime } from "./two-pane.js";
 export { createInitialState } from "./state.js";
 export { resolveBindings } from "./keymap.js";
 export function singleDetail(fn) {

package/node_modules/toolcraft-design/dist/explorer/two-pane.d.ts

@@ -0,0 +1,94 @@
+import { ScreenBuffer } from "../dashboard/buffer.js";
+import { type TerminalDriver } from "../dashboard/terminal.js";
+import type { Tone } from "./state.js";
+export interface TwoPaneRow {
+    id: string;
+    title: string;
+    subtitle?: string;
+    badge?: {
+        text: string;
+        tone?: Tone;
+    };
+}
+export interface TwoPaneDefinition {
+    id: string;
+    title: string;
+    rows: () => Promise<TwoPaneRow[]>;
+    emptyHint?: string;
+}
+export interface TwoPaneActionContext<R> {
+    activePane: TwoPanePaneState;
+    inactivePane: TwoPanePaneState;
+    row: TwoPaneRow;
+    rows: TwoPaneRow[];
+    refresh: () => Promise<void>;
+    suspendAnd: <T>(fn: () => Promise<T>) => Promise<T>;
+    toast: (message: string, tone?: Tone) => void;
+    exit: (result?: R | null) => void;
+}
+export interface TwoPaneAction<R> {
+    id: string;
+    label: string;
+    key: string | string[];
+    handler: (ctx: TwoPaneActionContext<R>) => void | Promise<void>;
+}
+export interface TwoPaneExplorerConfig<R> {
+    title: string;
+    panes: [TwoPaneDefinition, TwoPaneDefinition];
+    actions: TwoPaneAction<R>[];
+    refresh?: () => void | Promise<void>;
+}
+export interface TwoPanePaneState {
+    id: string;
+    title: string;
+    rows: TwoPaneRow[];
+    cursor: number;
+    selected: Set<string>;
+    filter: string;
+    emptyHint: string;
+}
+export interface TwoPaneExplorerState {
+    title: string;
+    panes: [TwoPanePaneState, TwoPanePaneState];
+    activePaneIndex: 0 | 1;
+    filterFocused: boolean;
+    toast: {
+        message: string;
+        tone: Tone;
+    } | null;
+    size: {
+        cols: number;
+        rows: number;
+    };
+}
+export declare function runTwoPaneExplorer<R = void>(config: TwoPaneExplorerConfig<R>): Promise<R | null>;
+export declare class TwoPaneExplorerRuntime<R> {
+    private readonly config;
+    private readonly driver;
+    private state;
+    private unsubscribeKeypress;
+    private unsubscribeResize;
+    private toastTimer;
+    private stopped;
+    private rowsRequestToken;
+    private settle;
+    constructor(config: TwoPaneExplorerConfig<R>, driver: TerminalDriver);
+    run(): Promise<R | null>;
+    private startTerminal;
+    private loadRows;
+    private refresh;
+    private dispatchKey;
+    private dispatchFilterKey;
+    private moveCursor;
+    private setCursor;
+    private toggleSelection;
+    private runAction;
+    private suspendAnd;
+    private showToast;
+    private activePane;
+    private inactivePane;
+    private render;
+    private exit;
+    private fail;
+}
+export declare function renderTwoPaneExplorer<R>(state: TwoPaneExplorerState, actions: TwoPaneAction<R>[], screen: ScreenBuffer): void;