toolcraft-openapi 0.0.11 → 0.0.13

package/node_modules/@poe-code/design-system/dist/components/help-formatter-plain.d.ts

@@ -0,0 +1,4 @@
+import type { CommandInfo, FormatColumnsOptions, OptionInfo } from "./help-formatter.js";
+export declare function formatColumns(opts: FormatColumnsOptions): string;
+export declare function formatCommandList(commands: CommandInfo[]): string;
+export declare function formatOptionList(options: OptionInfo[]): string;

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

@@ -0,0 +1,132 @@
+function stripAnsi(value) {
+    let output = "";
+    for (let index = 0; index < value.length; index += 1) {
+        if (value[index] === "\u001b") {
+            if (value[index + 1] === "[") {
+                index += 2;
+                while (index < value.length) {
+                    const code = value.charCodeAt(index);
+                    if (code >= 0x40 && code <= 0x7e) {
+                        break;
+                    }
+                    index += 1;
+                }
+            }
+            continue;
+        }
+        output += value[index];
+    }
+    return output;
+}
+function toAscii(value) {
+    let output = "";
+    const stripped = stripAnsi(value);
+    for (let index = 0; index < stripped.length; index += 1) {
+        const code = stripped.charCodeAt(index);
+        output += code <= 0x7f ? stripped[index] : "?";
+    }
+    return output;
+}
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+function padEndVisible(value, width) {
+    return value + " ".repeat(Math.max(0, width - value.length));
+}
+function isWhitespace(char) {
+    return char === " " || char === "\n" || char === "\t" || char === "\r";
+}
+function splitWords(value) {
+    const words = [];
+    let word = "";
+    for (const char of value) {
+        if (isWhitespace(char)) {
+            if (word) {
+                words.push(word);
+                word = "";
+            }
+            continue;
+        }
+        word += char;
+    }
+    if (word) {
+        words.push(word);
+    }
+    return words;
+}
+function wrapWords(value, width) {
+    const words = splitWords(value);
+    if (words.length === 0) {
+        return [""];
+    }
+    const lines = [];
+    let line = "";
+    for (const word of words) {
+        if (!line) {
+            line = word;
+            continue;
+        }
+        if (line.length + 1 + word.length <= width) {
+            line += ` ${word}`;
+            continue;
+        }
+        lines.push(line);
+        line = word;
+    }
+    lines.push(line);
+    return lines;
+}
+export function formatColumns(opts) {
+    const rows = opts.rows.map((row) => ({
+        left: toAscii(row.left),
+        right: toAscii(row.right)
+    }));
+    if (rows.length === 0) {
+        return "";
+    }
+    const totalWidth = opts.totalWidth ?? process.stdout.columns ?? 100;
+    const minLeftWidth = opts.minLeftWidth ?? 12;
+    const maxLeftWidth = opts.maxLeftWidth ?? 32;
+    const gap = opts.gap ?? 3;
+    const indent = opts.indent ?? 2;
+    const maxLeftContentWidth = Math.max(...rows.map((row) => row.left.length));
+    const leftWidth = clamp(maxLeftContentWidth + gap, minLeftWidth, maxLeftWidth);
+    const rightWidth = Math.max(20, totalWidth - leftWidth - indent);
+    const firstIndent = " ".repeat(indent);
+    const continuationIndent = " ".repeat(indent + leftWidth);
+    return rows
+        .flatMap((row) => {
+        if (row.right.length === 0) {
+            return [`${firstIndent}${row.left}`];
+        }
+        const rightLines = wrapWords(row.right, rightWidth);
+        if (row.left.length > leftWidth) {
+            return [
+                `${firstIndent}${row.left}`,
+                ...rightLines.map((line) => `${continuationIndent}${line}`)
+            ];
+        }
+        const firstLine = `${firstIndent}${padEndVisible(row.left, leftWidth)}${rightLines[0]}`;
+        const continuationLines = rightLines
+            .slice(1)
+            .map((line) => `${continuationIndent}${line}`);
+        return [firstLine, ...continuationLines];
+    })
+        .join("\n");
+}
+export function formatCommandList(commands) {
+    return formatColumns({
+        rows: commands.map((cmd) => ({
+            left: cmd.name,
+            right: cmd.description
+        }))
+    });
+}
+export function formatOptionList(options) {
+    return formatColumns({
+        rows: options.map((opt) => ({
+            left: opt.flags,
+            right: opt.description
+        }))
+    });
+}

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

@@ -6,12 +6,25 @@ export interface OptionInfo {
     flags: string;
     description: string;
 }
+export interface FormatColumnsOptions {
+    rows: Array<{
+        left: string;
+        right: string;
+    }>;
+    totalWidth?: number;
+    minLeftWidth?: number;
+    maxLeftWidth?: number;
+    gap?: number;
+    indent?: number;
+}
+export declare function formatColumns(opts: FormatColumnsOptions): string;
 export declare function formatCommand(name: string, description: string): string;
 export declare function formatUsage(command: string, args?: string): string;
 export declare function formatOption(flags: string, description: string): string;
 export declare function formatCommandList(commands: CommandInfo[]): string;
 export declare function formatOptionList(options: OptionInfo[]): string;
 export declare const helpFormatter: {
+    readonly formatColumns: typeof formatColumns;
     readonly formatCommand: typeof formatCommand;
     readonly formatUsage: typeof formatUsage;
     readonly formatOption: typeof formatOption;

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

@@ -1,24 +1,133 @@
 import { text } from "./text.js";
-import { widths } from "../tokens/widths.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;
+}
+function visibleWidth(value) {
+    return stripAnsi(value).length;
+}
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+function padEndVisible(value, width) {
+    return value + " ".repeat(Math.max(0, width - visibleWidth(value)));
+}
+function isWhitespace(char) {
+    return char === " " || char === "\n" || char === "\t" || char === "\r";
+}
+function splitWords(value) {
+    const words = [];
+    let word = "";
+    for (const char of value) {
+        if (isWhitespace(char)) {
+            if (word) {
+                words.push(word);
+                word = "";
+            }
+            continue;
+        }
+        word += char;
+    }
+    if (word) {
+        words.push(word);
+    }
+    return words;
+}
+function wrapWords(value, width) {
+    const words = splitWords(value);
+    if (words.length === 0) {
+        return [""];
+    }
+    const lines = [];
+    let line = "";
+    for (const word of words) {
+        if (!line) {
+            line = word;
+            continue;
+        }
+        if (visibleWidth(line) + 1 + visibleWidth(word) <= width) {
+            line += ` ${word}`;
+            continue;
+        }
+        lines.push(line);
+        line = word;
+    }
+    lines.push(line);
+    return lines;
+}
+export function formatColumns(opts) {
+    const { rows } = opts;
+    if (rows.length === 0) {
+        return "";
+    }
+    const totalWidth = opts.totalWidth ?? process.stdout.columns ?? 100;
+    const minLeftWidth = opts.minLeftWidth ?? 12;
+    const maxLeftWidth = opts.maxLeftWidth ?? 32;
+    const gap = opts.gap ?? 3;
+    const indent = opts.indent ?? 2;
+    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);
+    const firstIndent = " ".repeat(indent);
+    const continuationIndent = " ".repeat(indent + leftWidth);
+    return rows
+        .flatMap((row) => {
+        if (row.right.length === 0) {
+            return [`${firstIndent}${row.left}`];
+        }
+        const rightLines = wrapWords(row.right, rightWidth);
+        if (visibleWidth(row.left) > leftWidth) {
+            return [
+                `${firstIndent}${row.left}`,
+                ...rightLines.map((line) => `${continuationIndent}${line}`)
+            ];
+        }
+        const firstLine = `${firstIndent}${padEndVisible(row.left, leftWidth)}${rightLines[0]}`;
+        const continuationLines = rightLines
+            .slice(1)
+            .map((line) => `${continuationIndent}${line}`);
+        return [firstLine, ...continuationLines];
+    })
+        .join("\n");
+}
 export function formatCommand(name, description) {
-    const paddedName = name.padEnd(widths.helpColumn);
-    return `  ${text.command(paddedName)}  ${description}`;
+    return formatColumns({
+        rows: [{ left: text.command(name), right: description }]
+    });
 }
 export function formatUsage(command, args) {
     const argsStr = args ? ` ${text.argument(args)}` : "";
     return `${text.usageCommand(command)}${argsStr}`;
 }
 export function formatOption(flags, description) {
-    const paddedFlags = flags.padEnd(widths.helpColumn);
-    return `  ${text.option(paddedFlags)}  ${description}`;
+    return formatColumns({
+        rows: [{ left: text.option(flags), right: description }]
+    });
 }
 export function formatCommandList(commands) {
-    return commands.map((cmd) => formatCommand(cmd.name, cmd.description)).join("\n");
+    return formatColumns({
+        rows: commands.map((cmd) => ({
+            left: text.command(cmd.name),
+            right: cmd.description
+        }))
+    });
 }
 export function formatOptionList(options) {
-    return options.map((opt) => formatOption(opt.flags, opt.description)).join("\n");
+    return formatColumns({
+        rows: options.map((opt) => ({
+            left: text.option(opt.flags),
+            right: opt.description
+        }))
+    });
 }
 export const helpFormatter = {
+    formatColumns,
     formatCommand,
     formatUsage,
     formatOption,

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

@@ -2,8 +2,8 @@ export { text } from "./text.js";
 export { symbols } from "./symbols.js";
 export { createLogger, logger } from "./logger.js";
 export type { LoggerOutput } from "./logger.js";
-export { helpFormatter, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList } from "./help-formatter.js";
-export type { CommandInfo, OptionInfo } from "./help-formatter.js";
+export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList } from "./help-formatter.js";
+export type { CommandInfo, OptionInfo, FormatColumnsOptions } from "./help-formatter.js";
 export { formatCommandNotFound } from "./command-errors.js";
 export { formatCommandNotFoundPanel } from "./command-errors.js";
 export { renderTable } from "./table.js";

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

@@ -1,7 +1,7 @@
 export { text } from "./text.js";
 export { symbols } from "./symbols.js";
 export { createLogger, logger } from "./logger.js";
-export { helpFormatter, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList } from "./help-formatter.js";
+export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList } from "./help-formatter.js";
 export { formatCommandNotFound } from "./command-errors.js";
 export { formatCommandNotFoundPanel } from "./command-errors.js";
 export { renderTable } from "./table.js";

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

@@ -2,6 +2,7 @@ export declare const text: {
     readonly intro: (content: string) => string;
     readonly heading: (content: string) => string;
     readonly section: (content: string) => string;
+    readonly sectionHeader: (content: string) => string;
     readonly command: (content: string) => string;
     readonly argument: (content: string) => string;
     readonly option: (content: string) => string;

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

@@ -27,6 +27,14 @@ export const text = {
             return `**${content}**`;
         return typography.bold(content);
     },
+    sectionHeader(content) {
+        const format = resolveOutputFormat();
+        if (format === "json")
+            return content;
+        if (format === "markdown")
+            return `## ${content}`;
+        return typography.bold(content.toUpperCase());
+    },
     command(content) {
         const format = resolveOutputFormat();
         if (format === "json")

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

@@ -8,8 +8,9 @@ export { text } from "./components/text.js";
 export { symbols } from "./components/symbols.js";
 export { createLogger, logger } from "./components/logger.js";
 export type { LoggerOutput } from "./components/logger.js";
-export { helpFormatter, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList } from "./components/help-formatter.js";
-export type { CommandInfo, OptionInfo } from "./components/help-formatter.js";
+export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList } 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 { formatCommandNotFound } from "./components/command-errors.js";
 export { formatCommandNotFoundPanel } from "./components/command-errors.js";
 export { renderTable } from "./components/table.js";

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

@@ -8,7 +8,8 @@ export { widths } from "./tokens/widths.js";
 export { text } from "./components/text.js";
 export { symbols } from "./components/symbols.js";
 export { createLogger, logger } from "./components/logger.js";
-export { helpFormatter, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList } from "./components/help-formatter.js";
+export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList } 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";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft-openapi",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -30,7 +30,7 @@
     "auth-store": "^0.0.1",
     "chalk": "^5.6.2",
     "console-table-printer": "^2.15.0",
-    "toolcraft": "^0.0.11",
+    "toolcraft": "^0.0.13",
     "yaml": "^2.8.2"
   },
   "engines": {