toolcraft 0.0.23 → 0.0.24

package/node_modules/@poe-code/config-mutations/dist/types.d.ts

@@ -9,10 +9,12 @@ export interface FileSystem {
     readFile(path: string, encoding: "utf8"): Promise<string>;
     writeFile(path: string, content: string, options?: {
         encoding: "utf8";
+        flag?: string;
     }): Promise<void>;
     mkdir(path: string, options?: {
         recursive: boolean;
     }): Promise<void>;
+    rename(oldPath: string, newPath: string): Promise<void>;
     unlink(path: string): Promise<void>;
     rm?(path: string, options?: {
         recursive?: boolean;
@@ -21,6 +23,9 @@ export interface FileSystem {
     stat(path: string): Promise<{
         mode?: number;
     }>;
+    lstat(path: string): Promise<{
+        isSymbolicLink(): boolean;
+    }>;
     readdir(path: string): Promise<string[]>;
     chmod?(path: string, mode: number): Promise<void>;
 }
@@ -112,6 +117,11 @@ export interface ChmodMutation extends BaseMutation {
 export interface BackupMutation extends BaseMutation {
     kind: "backup";
     target: ValueResolver<string>;
+    once?: boolean;
+}
+export interface RestoreBackupMutation extends BaseMutation {
+    kind: "restoreBackup";
+    target: ValueResolver<string>;
 }
 export interface TemplateWriteMutation extends BaseMutation {
     kind: "templateWrite";
@@ -131,9 +141,9 @@ export interface TemplateMergeJsonMutation extends BaseMutation {
     templateId: string;
     context?: ValueResolver<ConfigObject>;
 }
-export type Mutation = ConfigMergeMutation | ConfigPruneMutation | ConfigTransformMutation | EnsureDirectoryMutation | RemoveDirectoryMutation | RemoveFileMutation | ChmodMutation | BackupMutation | TemplateWriteMutation | TemplateMergeTomlMutation | TemplateMergeJsonMutation;
+export type Mutation = ConfigMergeMutation | ConfigPruneMutation | ConfigTransformMutation | EnsureDirectoryMutation | RemoveDirectoryMutation | RemoveFileMutation | ChmodMutation | BackupMutation | RestoreBackupMutation | TemplateWriteMutation | TemplateMergeTomlMutation | TemplateMergeJsonMutation;
 export type MutationEffect = "none" | "mkdir" | "write" | "delete" | "chmod" | "copy";
-export type MutationDetail = "create" | "update" | "delete" | "noop" | "backup";
+export type MutationDetail = "create" | "update" | "delete" | "noop" | "backup" | "restore";
 export interface MutationOutcome {
     changed: boolean;
     effect: MutationEffect;

package/node_modules/@poe-code/config-mutations/package.json

@@ -16,7 +16,7 @@
     }
   },
   "scripts": {
-    "build": "tsc"
+    "build": "node ../../scripts/guard-package-dist.mjs && tsc"
   },
   "files": [
     "dist"

package/node_modules/@poe-code/design-system/dist/acp/components.js

@@ -18,7 +18,9 @@ const KIND_COLORS = {
     other: (text) => color.dim(text)
 };
 function colorForKind(kind) {
-    return KIND_COLORS[kind] ?? ((text) => color.dim(text));
+    return Object.prototype.hasOwnProperty.call(KIND_COLORS, kind)
+        ? KIND_COLORS[kind]
+        : (text) => color.dim(text);
 }
 function writeLine(line) {
     getAcpWriter()(line);

package/node_modules/@poe-code/design-system/dist/components/browser.d.ts

@@ -1,6 +1,6 @@
 interface BrowserProcess {
     once(event: "error", listener: (error: Error) => void): this;
-    once(event: "spawn", listener: () => void): this;
+    once(event: "close", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
     unref(): void;
 }
 type SpawnBrowserProcess = (command: string, args: string[], options: {

package/node_modules/@poe-code/design-system/dist/components/browser.js

@@ -18,7 +18,12 @@ function launchBrowser(command, args, spawnProcess) {
     return new Promise((resolve, reject) => {
         const child = spawnProcess(command, args, { detached: true, stdio: "ignore" });
         child.once("error", reject);
-        child.once("spawn", () => {
+        child.once("close", (code, signal) => {
+            if (code !== 0) {
+                const reason = code === null ? `signal ${signal ?? "unknown"}` : `code ${code}`;
+                reject(new Error(`Browser launcher exited with ${reason}`));
+                return;
+            }
             child.unref();
             resolve();
         });

package/node_modules/@poe-code/design-system/dist/components/color.js

@@ -48,6 +48,10 @@ function hexChannel(value, offset) {
 }
 function normalizeHex(value) {
     const normalized = value.startsWith("#") ? value.slice(1) : value;
+    if ((normalized.length !== 3 && normalized.length !== 6) ||
+        Array.from(normalized).some((char) => !"0123456789abcdefABCDEF".includes(char))) {
+        throw new Error(`Invalid hexadecimal color: ${value}`);
+    }
     if (normalized.length === 3) {
         const red = normalized[0];
         const green = normalized[1];
@@ -58,14 +62,11 @@ function normalizeHex(value) {
             Number.parseInt(`${blue}${blue}`, 16)
         ];
     }
-    if (normalized.length === 6) {
-        return [
-            hexChannel(normalized, 0),
-            hexChannel(normalized, 2),
-            hexChannel(normalized, 4)
-        ];
-    }
-    return [0, 0, 0];
+    return [
+        hexChannel(normalized, 0),
+        hexChannel(normalized, 2),
+        hexChannel(normalized, 4)
+    ];
 }
 function rgbStyle(red, green, blue) {
     return {

package/node_modules/@poe-code/design-system/dist/components/command-errors.js

@@ -1,8 +1,9 @@
 import { typography } from "../tokens/typography.js";
 import { text } from "./text.js";
 export function formatCommandNotFound(input) {
-    const unknown = input.unknownCommand.length > 0
-        ? input.unknownCommand
+    const unknownInput = input.unknownCommand.replaceAll("\r\n", " ").replaceAll("\n", " ").replaceAll("\r", " ");
+    const unknown = unknownInput.length > 0
+        ? unknownInput
         : "<command>";
     return {
         label: `${typography.bold("Unknown command:")} ${text.command(unknown)}`,

package/node_modules/@poe-code/design-system/dist/components/detail-card.d.ts

@@ -0,0 +1,22 @@
+import type { ThemePalette } from "../tokens/colors.js";
+export interface DetailCardRow {
+    label: string;
+    value: string;
+}
+export interface DetailCardSection {
+    title?: string;
+    rows: DetailCardRow[];
+}
+export interface RenderDetailCardOptions {
+    theme: ThemePalette;
+    title: string;
+    subtitle?: string;
+    badges?: string[];
+    prose?: Array<{
+        title?: string;
+        value: string;
+    }>;
+    sections?: DetailCardSection[];
+    width?: number;
+}
+export declare function renderDetailCard(options: RenderDetailCardOptions): string;

package/node_modules/@poe-code/design-system/dist/components/detail-card.js

@@ -0,0 +1,69 @@
+import { widths } from "../tokens/widths.js";
+function wrap(value, width) {
+    const lines = [];
+    for (const paragraph of value.split("\n")) {
+        let line = "";
+        for (const rawWord of paragraph.split(" ")) {
+            const words = [];
+            let word = rawWord;
+            while (word.length > width) {
+                words.push(word.slice(0, width));
+                word = word.slice(width);
+            }
+            words.push(word);
+            for (const word of words) {
+                if (line.length === 0) {
+                    line = word;
+                    continue;
+                }
+                if (`${line} ${word}`.length <= width) {
+                    line = `${line} ${word}`;
+                    continue;
+                }
+                lines.push(line);
+                line = word;
+            }
+        }
+        lines.push(line);
+    }
+    return lines;
+}
+function renderRows(rows, theme, width) {
+    if (rows.length === 0)
+        return [];
+    const labelWidth = Math.max(...rows.map((row) => row.label.length));
+    const valueWidth = Math.max(20, width - labelWidth - 2);
+    const continuation = " ".repeat(labelWidth + 2);
+    return rows.flatMap((row) => {
+        const values = wrap(row.value, valueWidth);
+        return [
+            `${theme.muted(row.label.padEnd(labelWidth))}  ${values[0] ?? ""}`,
+            ...values.slice(1).map((value) => `${continuation}${value}`),
+        ];
+    });
+}
+export function renderDetailCard(options) {
+    const width = options.width ?? widths.maxLine;
+    const identity = [
+        options.theme.header(options.title),
+        options.subtitle ? options.theme.muted(options.subtitle) : undefined,
+    ].filter((value) => value !== undefined).join("  ");
+    const hero = options.badges?.length
+        ? `${identity}\n${options.theme.muted(options.badges.map((badge) => badge[0] + badge.slice(1).toLowerCase()).join(" · "))}`
+        : identity;
+    const blocks = [hero];
+    for (const prose of options.prose ?? []) {
+        blocks.push(prose.title
+            ? [options.theme.header(prose.title), wrap(prose.value, width).join("\n")].join("\n")
+            : wrap(prose.value, width).join("\n"));
+    }
+    for (const section of options.sections ?? []) {
+        if (section.rows.length === 0)
+            continue;
+        const rows = renderRows(section.rows, options.theme, width);
+        blocks.push(section.title
+            ? [options.theme.header(section.title), ...rows].join("\n")
+            : rows.join("\n"));
+    }
+    return blocks.join("\n\n");
+}

package/node_modules/@poe-code/design-system/dist/components/help-formatter.js

@@ -1,16 +1,80 @@
 import { text } from "./text.js";
-function stripAnsi(value) {
-    let output = "";
-    for (let index = 0; index < value.length; index += 1)
-        if (value[index] === "\u001b" && value[index + 1] === "[")
-            while (index < value.length && value[index] !== "m")
-                index += 1;
-        else
-            output += value[index];
-    return output;
+const graphemeSegmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+function normalizeInline(value) {
+    return value.replaceAll("\r\n", " ").replaceAll("\n", " ").replaceAll("\r", " ");
+}
+function readControlSequence(value, index) {
+    if (value[index] !== "\u001b") {
+        return undefined;
+    }
+    if (value[index + 1] === "[") {
+        let nextIndex = index + 2;
+        while (nextIndex < value.length) {
+            const code = value.charCodeAt(nextIndex);
+            nextIndex += 1;
+            if (code >= 0x40 && code <= 0x7e) {
+                return nextIndex;
+            }
+        }
+        return value.length;
+    }
+    if (value[index + 1] === "]") {
+        let nextIndex = index + 2;
+        while (nextIndex < value.length) {
+            if (value[nextIndex] === "\u0007") {
+                return nextIndex + 1;
+            }
+            if (value[nextIndex] === "\u001b" && value[nextIndex + 1] === "\\") {
+                return nextIndex + 2;
+            }
+            nextIndex += 1;
+        }
+        return value.length;
+    }
+    return index + 1;
+}
+function isWideCodePoint(codePoint) {
+    return ((codePoint >= 0x1100 && codePoint <= 0x115f) ||
+        codePoint === 0x2329 ||
+        codePoint === 0x232a ||
+        (codePoint >= 0x2e80 && codePoint <= 0xa4cf && codePoint !== 0x303f) ||
+        (codePoint >= 0xac00 && codePoint <= 0xd7a3) ||
+        (codePoint >= 0xf900 && codePoint <= 0xfaff) ||
+        (codePoint >= 0xfe10 && codePoint <= 0xfe19) ||
+        (codePoint >= 0xfe30 && codePoint <= 0xfe6f) ||
+        (codePoint >= 0xff00 && codePoint <= 0xff60) ||
+        (codePoint >= 0xffe0 && codePoint <= 0xffe6) ||
+        (codePoint >= 0x2600 && codePoint <= 0x27bf) ||
+        (codePoint >= 0x1f300 && codePoint <= 0x1faff) ||
+        (codePoint >= 0x20000 && codePoint <= 0x3fffd));
+}
+function clusterWidth(cluster) {
+    const codePoints = Array.from(cluster).map((char) => char.codePointAt(0) ?? 0);
+    if (codePoints.some((codePoint) => codePoint === 0x200d || (codePoint >= 0xfe00 && codePoint <= 0xfe0f))) {
+        return 2;
+    }
+    return codePoints.reduce((width, codePoint) => {
+        if (codePoint === 0 || codePoint < 0x20 || (codePoint >= 0x7f && codePoint < 0xa0)) {
+            return width;
+        }
+        return width + (isWideCodePoint(codePoint) ? 2 : 1);
+    }, 0);
 }
 function visibleWidth(value) {
-    return stripAnsi(value).length;
+    let width = 0;
+    let index = 0;
+    while (index < value.length) {
+        const nextIndex = readControlSequence(value, index);
+        if (nextIndex !== undefined) {
+            index = nextIndex;
+            continue;
+        }
+        const segment = graphemeSegmenter.segment(value.slice(index))[Symbol.iterator]().next().value;
+        const cluster = segment?.segment ?? "";
+        width += clusterWidth(cluster);
+        index += cluster.length || 1;
+    }
+    return width;
 }
 function clamp(value, min, max) {
     return Math.min(Math.max(value, min), max);
@@ -61,8 +125,16 @@ function wrapWords(value, width) {
     lines.push(line);
     return lines;
 }
+function validateLayoutValue(value, name) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error(`${name} must be a finite non-negative number.`);
+    }
+}
 export function formatColumns(opts) {
-    const { rows } = opts;
+    const rows = opts.rows.map((row) => ({
+        left: normalizeInline(row.left),
+        right: row.right
+    }));
     if (rows.length === 0) {
         return "";
     }
@@ -71,6 +143,11 @@ export function formatColumns(opts) {
     const maxLeftWidth = opts.maxLeftWidth ?? 32;
     const gap = opts.gap ?? 3;
     const indent = opts.indent ?? 2;
+    validateLayoutValue(totalWidth, "totalWidth");
+    validateLayoutValue(minLeftWidth, "minLeftWidth");
+    validateLayoutValue(maxLeftWidth, "maxLeftWidth");
+    validateLayoutValue(gap, "gap");
+    validateLayoutValue(indent, "indent");
     const maxLeftContentWidth = Math.max(...rows.map((row) => visibleWidth(row.left)));
     const leftWidth = clamp(maxLeftContentWidth + gap, minLeftWidth, maxLeftWidth);
     const rightWidth = Math.max(20, totalWidth - leftWidth - indent);

package/node_modules/@poe-code/design-system/dist/components/index.d.ts

@@ -10,5 +10,5 @@ export { formatCommandNotFound } from "./command-errors.js";
 export { formatCommandNotFoundPanel } from "./command-errors.js";
 export { renderTable } from "./table.js";
 export type { TableColumn, RenderTableOptions } from "./table.js";
-export { renderTemplate } from "./template.js";
+export { getTemplatePartialNames, renderTemplate, resolveTemplatePartials } from "./template.js";
 export type { RenderTemplateOptions, TemplateEscape } from "./template.js";

package/node_modules/@poe-code/design-system/dist/components/index.js

@@ -6,4 +6,4 @@ export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption,
 export { formatCommandNotFound } from "./command-errors.js";
 export { formatCommandNotFoundPanel } from "./command-errors.js";
 export { renderTable } from "./table.js";
-export { renderTemplate } from "./template.js";
+export { getTemplatePartialNames, renderTemplate, resolveTemplatePartials } from "./template.js";

package/node_modules/@poe-code/design-system/dist/components/table.d.ts

@@ -9,5 +9,7 @@ export interface RenderTableOptions {
     theme: ThemePalette;
     columns: TableColumn[];
     rows: Record<string, string>[];
+    variant?: "table" | "detail";
+    maxWidth?: number;
 }
 export declare function renderTable(options: RenderTableOptions): string;

package/node_modules/@poe-code/design-system/dist/components/table.js

@@ -1,8 +1,19 @@
+import { widths } from "../tokens/widths.js";
 import { resolveOutputFormat } from "../internal/output-format.js";
 import { stripAnsi } from "../internal/strip-ansi.js";
 const reset = "\x1b[0m";
 const ellipsis = "…";
 const graphemeSegmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+function getCell(row, name) {
+    return Object.prototype.hasOwnProperty.call(row, name) ? row[name] ?? "" : "";
+}
+function renderMarkdownCell(value) {
+    return stripAnsi(value)
+        .replaceAll("\r\n", " ")
+        .replaceAll("\n", " ")
+        .replaceAll("\r", " ")
+        .replaceAll("|", "\\|");
+}
 function isAnsiSequence(value, index) {
     return value[index] === "\u001b" && value[index + 1] === "[";
 }
@@ -135,6 +146,9 @@ function getAlignment(column) {
     return alignment === "right" || alignment === "center" ? alignment : "left";
 }
 function getColumnWidth(column) {
+    if (!Number.isFinite(column.maxLen) || column.maxLen <= 0) {
+        throw new Error("maxLen must be a positive finite number.");
+    }
     const configuredMin = column.minLen;
     const minWidth = Math.max(1, configuredMin ?? 1);
     return Math.max(minWidth, column.maxLen);
@@ -165,9 +179,72 @@ function renderTerminalRow(values, columns, theme) {
     });
     return `${vertical}${cells.join(vertical)}${vertical}`;
 }
+function wrapDetailValue(value, width) {
+    const lines = [];
+    for (const paragraph of value.split("\n")) {
+        let line = "";
+        for (const rawWord of paragraph.split(" ")) {
+            const words = [];
+            let word = rawWord;
+            while (displayWidth(word) > width) {
+                let chunk = "";
+                let index = 0;
+                while (index < word.length) {
+                    const cluster = readPrintableCluster(word, index);
+                    if (displayWidth(`${chunk}${cluster}`) > width) {
+                        break;
+                    }
+                    chunk += cluster;
+                    index += cluster.length;
+                }
+                words.push(chunk);
+                word = word.slice(chunk.length);
+            }
+            words.push(word);
+            for (const word of words) {
+                if (line.length === 0) {
+                    line = word;
+                    continue;
+                }
+                if (displayWidth(`${line} ${word}`) <= width) {
+                    line = `${line} ${word}`;
+                    continue;
+                }
+                lines.push(line);
+                line = word;
+            }
+        }
+        lines.push(line);
+    }
+    return lines.length > 0 ? lines : [""];
+}
 function renderTableTerminal(options) {
     const { theme, columns, rows } = options;
     const computedColumns = computeColumns(columns);
+    if (options.variant === "detail") {
+        const labelColumn = computedColumns[0];
+        const valueColumn = computedColumns[1];
+        if (!labelColumn || !valueColumn) {
+            return "";
+        }
+        const detailLabelWidth = widths.helpColumn + 12;
+        const labelWidth = Math.min(labelColumn.width, detailLabelWidth);
+        const valueWidth = Math.max(20, (options.maxWidth ?? widths.maxLine) - labelWidth - 2);
+        const continuation = " ".repeat(labelWidth + 2);
+        return rows
+            .flatMap((row) => {
+            const label = truncateToWidth(getCell(row, labelColumn.name), labelWidth);
+            const values = wrapDetailValue(getCell(row, valueColumn.name), valueWidth);
+            if (values.length === 1 && values[0] === "") {
+                return [theme.header(label)];
+            }
+            return [
+                `${theme.muted(padCell(label, labelWidth, "left"))}  ${values[0] ?? ""}`,
+                ...values.slice(1).map((value) => `${continuation}${value}`)
+            ];
+        })
+            .join("\n");
+    }
     const separatorOptions = options;
     const includeRowSeparators = separatorOptions.rowSeparator === true || separatorOptions.rowSeparators === true;
     const top = renderBorder(computedColumns, theme, { left: "┌", mid: "┬", right: "┐" });
@@ -179,13 +256,13 @@ function renderTableTerminal(options) {
         if (includeRowSeparators && index > 0) {
             renderedRows.push(headerBottom);
         }
-        renderedRows.push(renderTerminalRow(computedColumns.map((column) => row[column.name] ?? ""), computedColumns, theme));
+        renderedRows.push(renderTerminalRow(computedColumns.map((column) => getCell(row, column.name)), computedColumns, theme));
     }
     return [top, header, headerBottom, ...renderedRows, bottom].join("\n");
 }
 function renderTableMarkdown(options) {
     const { columns, rows } = options;
-    const header = `| ${columns.map((c) => c.title).join(" | ")} |`;
+    const header = `| ${columns.map((c) => renderMarkdownCell(c.title)).join(" | ")} |`;
     const separator = `| ${columns
         .map((c) => {
         const alignment = getAlignment(c);
@@ -198,15 +275,15 @@ function renderTableMarkdown(options) {
         return ":---";
     })
         .join(" | ")} |`;
-    const dataRows = rows.map((row) => `| ${columns.map((c) => stripAnsi(row[c.name] ?? "").replace(/\|/g, "\\|")).join(" | ")} |`);
+    const dataRows = rows.map((row) => `| ${columns.map((c) => renderMarkdownCell(getCell(row, c.name))).join(" | ")} |`);
     return [header, separator, ...dataRows].join("\n");
 }
 function renderTableJson(options) {
     const { columns, rows } = options;
     const cleaned = rows.map((row) => {
-        const obj = {};
+        const obj = Object.create(null);
         for (const col of columns) {
-            obj[col.name] = stripAnsi(row[col.name] ?? "");
+            obj[col.name] = stripAnsi(getCell(row, col.name));
         }
         return obj;
     });

package/node_modules/@poe-code/design-system/dist/components/template.d.ts

@@ -1,6 +1,10 @@
 export type TemplateEscape = "html" | "none";
 export interface RenderTemplateOptions {
     escape?: TemplateEscape;
+    partials?: Record<string, string>;
+    validate?: boolean;
     yield?: string;
 }
 export declare function renderTemplate(template: string, view: Record<string, unknown>, options?: RenderTemplateOptions): string;
+export declare function getTemplatePartialNames(template: string): string[];
+export declare function resolveTemplatePartials(template: string, partials: Record<string, string>): string;