toolcraft-openapi 0.0.22 → 0.0.24

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;