@qontoctl/cli 0.0.0 → 0.1.0

package/dist/completions/bash.js

@@ -0,0 +1,170 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * Generates a bash completion script for the given Commander program.
+ */
+export function generateBashCompletion(program) {
+    const name = program.name();
+    const lines = [];
+    lines.push(`# bash completion for ${name}`);
+    lines.push("");
+    lines.push(`_${name}() {`);
+    lines.push("  COMPREPLY=()");
+    lines.push('  local cur="${COMP_WORDS[COMP_CWORD]}"');
+    lines.push('  local prev="${COMP_WORDS[COMP_CWORD-1]}"');
+    lines.push("");
+    // Complete option values based on previous word
+    const optionChoices = collectOptionChoices(program);
+    if (optionChoices.length > 0) {
+        lines.push('  case "$prev" in');
+        for (const { flags, choices } of optionChoices) {
+            lines.push(`    ${flags.join("|")})`);
+            lines.push(`      COMPREPLY=($(compgen -W "${choices.join(" ")}" -- "$cur"))`);
+            lines.push("      return");
+            lines.push("      ;;");
+        }
+        lines.push("  esac");
+        lines.push("");
+    }
+    // Determine command context by scanning COMP_WORDS
+    const valueTakingFlags = collectValueTakingFlags(program);
+    lines.push('  local cmd="" subcmd=""');
+    lines.push("  local skip_next=false");
+    lines.push("  for ((i=1; i < COMP_CWORD; i++)); do");
+    lines.push("    if $skip_next; then");
+    lines.push("      skip_next=false");
+    lines.push("      continue");
+    lines.push("    fi");
+    lines.push('    case "${COMP_WORDS[i]}" in');
+    if (valueTakingFlags.length > 0) {
+        lines.push(`      ${valueTakingFlags.join("|")})`);
+        lines.push("        skip_next=true");
+        lines.push("        ;;");
+    }
+    lines.push("      -*)");
+    lines.push("        ;;");
+    lines.push("      *)");
+    lines.push('        if [[ -z "$cmd" ]]; then');
+    lines.push('          cmd="${COMP_WORDS[i]}"');
+    lines.push('        elif [[ -z "$subcmd" ]]; then');
+    lines.push('          subcmd="${COMP_WORDS[i]}"');
+    lines.push("        fi");
+    lines.push("        ;;");
+    lines.push("    esac");
+    lines.push("  done");
+    lines.push("");
+    // Root-level completions
+    const rootCmds = program.commands.map((c) => c.name());
+    const rootFlags = collectFlags(program, true);
+    lines.push('  if [[ -z "$cmd" ]]; then');
+    lines.push('    if [[ "$cur" == -* ]]; then');
+    lines.push(`      COMPREPLY=($(compgen -W "${rootFlags.join(" ")}" -- "$cur"))`);
+    lines.push("    else");
+    lines.push(`      COMPREPLY=($(compgen -W "${rootCmds.join(" ")}" -- "$cur"))`);
+    lines.push("    fi");
+    lines.push("    return");
+    lines.push("  fi");
+    lines.push("");
+    // Per-subcommand completions
+    if (program.commands.length > 0) {
+        lines.push('  case "$cmd" in');
+        for (const cmd of program.commands) {
+            const subCmds = cmd.commands.map((c) => c.name());
+            const cmdFlags = collectFlags(cmd, false);
+            lines.push(`    ${cmd.name()})`);
+            if (subCmds.length > 0) {
+                lines.push('      if [[ -z "$subcmd" ]]; then');
+                if (cmdFlags.length > 0) {
+                    lines.push('        if [[ "$cur" == -* ]]; then');
+                    lines.push("          COMPREPLY=" + `($(compgen -W "${cmdFlags.join(" ")}" -- "$cur"))`);
+                    lines.push("        else");
+                    lines.push("          COMPREPLY=" + `($(compgen -W "${subCmds.join(" ")}" -- "$cur"))`);
+                    lines.push("        fi");
+                }
+                else {
+                    lines.push("        COMPREPLY=" + `($(compgen -W "${subCmds.join(" ")}" -- "$cur"))`);
+                }
+                lines.push("      fi");
+            }
+            else if (cmdFlags.length > 0) {
+                lines.push('      if [[ "$cur" == -* ]]; then');
+                lines.push("        COMPREPLY=" + `($(compgen -W "${cmdFlags.join(" ")}" -- "$cur"))`);
+                lines.push("      fi");
+            }
+            lines.push("      ;;");
+        }
+        lines.push("  esac");
+    }
+    lines.push("}");
+    lines.push("");
+    lines.push(`complete -o default -F _${name} ${name}`);
+    lines.push("");
+    return lines.join("\n");
+}
+function collectFlags(command, includeVersion) {
+    const flags = [];
+    for (const opt of command.options) {
+        if (opt.hidden)
+            continue;
+        if (opt.long)
+            flags.push(opt.long);
+        if (opt.short)
+            flags.push(opt.short);
+    }
+    if (!flags.includes("--help")) {
+        flags.push("--help");
+        flags.push("-h");
+    }
+    if (includeVersion && !flags.includes("--version")) {
+        flags.push("--version");
+        flags.push("-V");
+    }
+    return flags;
+}
+function collectValueTakingFlags(root) {
+    const flags = [];
+    const seen = new Set();
+    function walk(cmd) {
+        for (const opt of cmd.options) {
+            if (opt.required || opt.optional) {
+                for (const flag of [opt.long, opt.short]) {
+                    if (flag && !seen.has(flag)) {
+                        flags.push(flag);
+                        seen.add(flag);
+                    }
+                }
+            }
+        }
+        for (const sub of cmd.commands) {
+            walk(sub);
+        }
+    }
+    walk(root);
+    return flags;
+}
+function collectOptionChoices(root) {
+    const result = [];
+    const seen = new Set();
+    function walk(cmd) {
+        for (const opt of cmd.options) {
+            if (opt.argChoices && opt.argChoices.length > 0) {
+                const key = opt.long ?? opt.short ?? "";
+                if (!seen.has(key)) {
+                    const flags = [];
+                    if (opt.long)
+                        flags.push(opt.long);
+                    if (opt.short)
+                        flags.push(opt.short);
+                    result.push({ flags, choices: [...opt.argChoices] });
+                    seen.add(key);
+                }
+            }
+        }
+        for (const sub of cmd.commands) {
+            walk(sub);
+        }
+    }
+    walk(root);
+    return result;
+}
+//# sourceMappingURL=bash.js.map

package/dist/completions/bash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.js","sourceRoot":"","sources":["../../src/completions/bash.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAIpC;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,gDAAgD;IAChD,MAAM,aAAa,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChC,KAAK,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,aAAa,EAAE,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,kCAAkC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC/E,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,mDAAmD;IACnD,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAC7C,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,SAAS,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3B,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,yBAAyB;IACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAE9C,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,kCAAkC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACjF,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,kCAAkC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAChF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,6BAA6B;IAC7B,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAClD,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAE1C,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACjC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;gBAChD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxB,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;oBAClD,KAAK,CAAC,IAAI,CAAC,sBAAsB,GAAG,kBAAkB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;oBACzF,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;oBAC3B,KAAK,CAAC,IAAI,CAAC,sBAAsB,GAAG,kBAAkB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;oBACxF,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC3B,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,IAAI,CAAC,oBAAoB,GAAG,kBAAkB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;gBACxF,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACzB,CAAC;iBAAM,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;gBAChD,KAAK,CAAC,IAAI,CAAC,oBAAoB,GAAG,kBAAkB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;gBACvF,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACzB,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,YAAY,CAAC,OAAgB,EAAE,cAAuB;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,GAAG,CAAC,MAAM;YAAE,SAAS;QACzB,IAAI,GAAG,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,GAAG,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,cAAc,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAa;IAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,SAAS,IAAI,CAAC,GAAY;QACxB,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAC9B,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;gBACjC,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC5B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBACjB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBACjB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,CAAC;IACX,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAa;IACzC,MAAM,MAAM,GAAkD,EAAE,CAAC;IACjE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,SAAS,IAAI,CAAC,GAAY;QACxB,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAC9B,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChD,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;gBACxC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBACnB,MAAM,KAAK,GAAa,EAAE,CAAC;oBAC3B,IAAI,GAAG,CAAC,IAAI;wBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBACnC,IAAI,GAAG,CAAC,KAAK;wBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;oBACrC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;oBACrD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,CAAC;IACX,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/completions/fish.d.ts

@@ -0,0 +1,6 @@
+import type { Command } from "commander";
+/**
+ * Generates a fish completion script for the given Commander program.
+ */
+export declare function generateFishCompletion(program: Command): string;
+//# sourceMappingURL=fish.d.ts.map

package/dist/completions/fish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fish.d.ts","sourceRoot":"","sources":["../../src/completions/fish.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAqE/D"}

package/dist/completions/fish.js

@@ -0,0 +1,86 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * Generates a fish completion script for the given Commander program.
+ */
+export function generateFishCompletion(program) {
+    const name = program.name();
+    const lines = [];
+    lines.push(`# fish completion for ${name}`);
+    lines.push("");
+    // Disable file completions by default
+    lines.push(`complete -c ${name} -f`);
+    lines.push("");
+    // Global options
+    lines.push("# Global options");
+    for (const opt of program.options) {
+        if (opt.hidden)
+            continue;
+        lines.push(formatFishOption(name, opt));
+    }
+    // Always add --help and --version if not present
+    const hasHelp = program.options.some((o) => o.long === "--help");
+    if (!hasHelp) {
+        lines.push(`complete -c ${name} -s h -l help -d '${escapeFishString("display help")}'`);
+    }
+    const hasVersion = program.options.some((o) => o.long === "--version");
+    if (!hasVersion) {
+        lines.push(`complete -c ${name} -s V -l version -d '${escapeFishString("display version")}'`);
+    }
+    lines.push("");
+    // Top-level commands
+    if (program.commands.length > 0) {
+        lines.push("# Commands");
+        for (const cmd of program.commands) {
+            const desc = escapeFishString(cmd.description());
+            lines.push(`complete -c ${name}` + ` -n '__fish_use_subcommand'` + ` -a ${cmd.name()}` + ` -d '${desc}'`);
+        }
+        lines.push("");
+        // Subcommand-specific completions
+        for (const cmd of program.commands) {
+            const subCmds = cmd.commands;
+            const cmdOpts = cmd.options.filter((o) => !o.hidden);
+            if (subCmds.length === 0 && cmdOpts.length === 0) {
+                continue;
+            }
+            lines.push(`# ${cmd.name()} subcommands`);
+            for (const sub of subCmds) {
+                const desc = escapeFishString(sub.description());
+                lines.push(`complete -c ${name}` +
+                    ` -n '__fish_seen_subcommand_from ${cmd.name()}'` +
+                    ` -a ${sub.name()}` +
+                    ` -d '${desc}'`);
+            }
+            for (const opt of cmdOpts) {
+                lines.push(formatFishOption(name, opt, `__fish_seen_subcommand_from ${cmd.name()}`));
+            }
+            lines.push("");
+        }
+    }
+    return lines.join("\n");
+}
+function formatFishOption(name, opt, condition) {
+    const parts = [`complete -c ${name}`];
+    if (condition) {
+        parts.push(`-n '${condition}'`);
+    }
+    if (opt.short) {
+        parts.push(`-s ${opt.short.replace(/^-/, "")}`);
+    }
+    if (opt.long) {
+        parts.push(`-l ${opt.long.replace(/^--/, "")}`);
+    }
+    const desc = escapeFishString(opt.description);
+    parts.push(`-d '${desc}'`);
+    if (opt.required || opt.optional) {
+        parts.push("-r");
+        if (opt.argChoices && opt.argChoices.length > 0) {
+            parts.push(`-a '${opt.argChoices.join(" ")}'`);
+        }
+    }
+    return parts.join(" ");
+}
+function escapeFishString(str) {
+    return str.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
+//# sourceMappingURL=fish.js.map

package/dist/completions/fish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fish.js","sourceRoot":"","sources":["../../src/completions/fish.ts"],"names":[],"mappings":"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"}

package/dist/completions/index.d.ts

@@ -0,0 +1,7 @@
+import type { Command } from "commander";
+/**
+ * Registers the `completion` command with bash, zsh, and fish
+ * subcommands on the given Commander program.
+ */
+export declare function registerCompletionCommand(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/completions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/completions/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuBhE"}

package/dist/completions/index.js

@@ -0,0 +1,31 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { generateBashCompletion } from "./bash.js";
+import { generateFishCompletion } from "./fish.js";
+import { generateZshCompletion } from "./zsh.js";
+/**
+ * Registers the `completion` command with bash, zsh, and fish
+ * subcommands on the given Commander program.
+ */
+export function registerCompletionCommand(program) {
+    const completion = program.command("completion").description("generate shell completion scripts");
+    completion
+        .command("bash")
+        .description("generate bash completion script")
+        .action(() => {
+        process.stdout.write(generateBashCompletion(program));
+    });
+    completion
+        .command("zsh")
+        .description("generate zsh completion script")
+        .action(() => {
+        process.stdout.write(generateZshCompletion(program));
+    });
+    completion
+        .command("fish")
+        .description("generate fish completion script")
+        .action(() => {
+        process.stdout.write(generateFishCompletion(program));
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/completions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/completions/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAIpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEjD;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,mCAAmC,CAAC,CAAC;IAElG,UAAU;SACP,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,iCAAiC,CAAC;SAC9C,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEL,UAAU;SACP,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,gCAAgC,CAAC;SAC7C,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEL,UAAU;SACP,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,iCAAiC,CAAC;SAC9C,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/completions/zsh.d.ts

@@ -0,0 +1,6 @@
+import type { Command } from "commander";
+/**
+ * Generates a zsh completion script for the given Commander program.
+ */
+export declare function generateZshCompletion(program: Command): string;
+//# sourceMappingURL=zsh.d.ts.map

package/dist/completions/zsh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zsh.d.ts","sourceRoot":"","sources":["../../src/completions/zsh.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAkE9D"}

package/dist/completions/zsh.js

@@ -0,0 +1,124 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * Generates a zsh completion script for the given Commander program.
+ */
+export function generateZshCompletion(program) {
+    const name = program.name();
+    const lines = [];
+    lines.push(`#compdef ${name}`);
+    lines.push("");
+    lines.push(`_${name}() {`);
+    // Root-level arguments
+    const rootArgSpecs = buildArgumentSpecs(program, true);
+    lines.push("  _arguments -s -S \\");
+    for (let i = 0; i < rootArgSpecs.length; i++) {
+        const trailing = i < rootArgSpecs.length - 1 ? " \\" : "";
+        lines.push(`    ${rootArgSpecs[i] ?? ""}${trailing}`);
+    }
+    lines.push("");
+    // Subcommand dispatch
+    const subcommands = program.commands;
+    if (subcommands.length > 0) {
+        lines.push("  case $state in");
+        lines.push("    commands)");
+        lines.push("      local -a commands=(");
+        for (const cmd of subcommands) {
+            const desc = escapeZshDescription(cmd.description());
+            lines.push(`        '${cmd.name()}:${desc}'`);
+        }
+        lines.push("      )");
+        lines.push("      _describe 'command' commands");
+        lines.push("      ;;");
+        lines.push("    args)");
+        lines.push("      case $words[1] in");
+        for (const cmd of subcommands) {
+            const subSubs = cmd.commands;
+            const cmdOptSpecs = buildOptionSpecs(cmd, false);
+            lines.push(`        ${cmd.name()})`);
+            if (subSubs.length > 0) {
+                const allSpecs = [...cmdOptSpecs, `'1:subcommand:(${subSubs.map((s) => s.name()).join(" ")})'`];
+                lines.push("          _arguments -s -S \\");
+                for (let i = 0; i < allSpecs.length; i++) {
+                    const trailing = i < allSpecs.length - 1 ? " \\" : "";
+                    lines.push(`            ${allSpecs[i] ?? ""}${trailing}`);
+                }
+            }
+            else if (cmdOptSpecs.length > 0) {
+                lines.push("          _arguments -s -S \\");
+                for (let i = 0; i < cmdOptSpecs.length; i++) {
+                    const trailing = i < cmdOptSpecs.length - 1 ? " \\" : "";
+                    lines.push(`            ${cmdOptSpecs[i] ?? ""}${trailing}`);
+                }
+            }
+            lines.push("          ;;");
+        }
+        lines.push("      esac");
+        lines.push("      ;;");
+        lines.push("  esac");
+    }
+    lines.push("}");
+    lines.push("");
+    lines.push(`compdef _${name} ${name}`);
+    lines.push("");
+    return lines.join("\n");
+}
+function buildOptionSpecs(command, isRoot) {
+    const specs = [];
+    for (const opt of command.options) {
+        if (opt.hidden)
+            continue;
+        specs.push(formatZshOption(opt));
+    }
+    // Add --help
+    const hasHelp = command.options.some((o) => o.long === "--help");
+    if (!hasHelp) {
+        specs.push("'(- *)'{-h,--help}'[display help]'");
+    }
+    // Add --version for root only
+    if (isRoot) {
+        const hasVersion = command.options.some((o) => o.long === "--version");
+        if (!hasVersion) {
+            specs.push("'(- *)'{-V,--version}'[display version]'");
+        }
+    }
+    return specs;
+}
+function buildArgumentSpecs(command, isRoot) {
+    const specs = buildOptionSpecs(command, isRoot);
+    // Add subcommand argument if command has subcommands
+    if (command.commands.length > 0) {
+        specs.push("'1:command:->commands'");
+        specs.push("'*::arg:->args'");
+    }
+    return specs;
+}
+function formatZshOption(opt) {
+    const desc = escapeZshDescription(opt.description);
+    const takesValue = opt.required || opt.optional;
+    let valueSuffix = "";
+    if (takesValue) {
+        const argName = opt.long ? opt.long.replace(/^--/, "") : "value";
+        if (opt.argChoices && opt.argChoices.length > 0) {
+            valueSuffix = `:${argName}:(${opt.argChoices.join(" ")})`;
+        }
+        else {
+            valueSuffix = `:${argName}:`;
+        }
+    }
+    if (opt.short && opt.long) {
+        const exclusion = `(${opt.short} ${opt.long})`;
+        return `'${exclusion}'` + `{${opt.short},${opt.long}}` + `'[${desc}]${valueSuffix}'`;
+    }
+    const flag = opt.long ?? opt.short ?? "";
+    return `'${flag}[${desc}]${valueSuffix}'`;
+}
+function escapeZshDescription(desc) {
+    return desc
+        .replace(/\\/g, "\\\\")
+        .replace(/'/g, "'\\''")
+        .replace(/\[/g, "\\[")
+        .replace(/\]/g, "\\]")
+        .replace(/:/g, "\\:");
+}
+//# sourceMappingURL=zsh.js.map

package/dist/completions/zsh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zsh.js","sourceRoot":"","sources":["../../src/completions/zsh.ts"],"names":[],"mappings":"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"}

package/dist/error-handler.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Global CLI error handler that formats known error types into
+ * user-friendly messages written to stderr.
+ *
+ * Stack traces are only shown for unknown errors in debug mode.
+ */
+export declare function handleCliError(error: unknown, debug: boolean): void;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAuDnE"}

package/dist/error-handler.js

@@ -0,0 +1,59 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { ConfigError, AuthError, QontoApiError, QontoRateLimitError } from "@qontoctl/core";
+/**
+ * Global CLI error handler that formats known error types into
+ * user-friendly messages written to stderr.
+ *
+ * Stack traces are only shown for unknown errors in debug mode.
+ */
+export function handleCliError(error, debug) {
+    if (error instanceof ConfigError) {
+        process.stderr.write([
+            `Configuration error: ${error.message}`,
+            "",
+            "To configure credentials, create ~/.qontoctl.yaml:",
+            "",
+            "  api-key:",
+            "    organization-slug: <your-org-slug>",
+            "    secret-key: <your-secret-key>",
+            "",
+            "Or set environment variables:",
+            "  QONTOCTL_ORGANIZATION_SLUG=<your-org-slug>",
+            "  QONTOCTL_SECRET_KEY=<your-secret-key>",
+        ].join("\n") + "\n");
+        process.exitCode = 1;
+        return;
+    }
+    if (error instanceof AuthError) {
+        process.stderr.write([
+            `Authentication error: ${error.message}`,
+            "",
+            "Verify your API key credentials in ~/.qontoctl.yaml or environment variables.",
+        ].join("\n") + "\n");
+        process.exitCode = 1;
+        return;
+    }
+    if (error instanceof QontoApiError) {
+        const details = error.errors.map((e) => `  - ${e.code}: ${e.detail}`).join("\n");
+        process.stderr.write(`Qonto API error (HTTP ${error.status}):\n${details}\n`);
+        process.exitCode = 1;
+        return;
+    }
+    if (error instanceof QontoRateLimitError) {
+        const retryHint = error.retryAfter !== undefined ? ` Retry after ${error.retryAfter} seconds.` : "";
+        process.stderr.write(`Rate limit exceeded.${retryHint} Please wait before retrying.\n`);
+        process.exitCode = 1;
+        return;
+    }
+    // Unknown errors: show stack trace in debug mode, message only otherwise
+    if (debug && error instanceof Error && error.stack !== undefined) {
+        process.stderr.write(`${error.stack}\n`);
+    }
+    else {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`Error: ${message}\n`);
+    }
+    process.exitCode = 1;
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE5F;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,KAAc;IAC3D,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB;YACE,wBAAwB,KAAK,CAAC,OAAO,EAAE;YACvC,EAAE;YACF,oDAAoD;YACpD,EAAE;YACF,YAAY;YACZ,wCAAwC;YACxC,mCAAmC;YACnC,EAAE;YACF,+BAA+B;YAC/B,8CAA8C;YAC9C,yCAAyC;SAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CACpB,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;QAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB;YACE,yBAAyB,KAAK,CAAC,OAAO,EAAE;YACxC,EAAE;YACF,+EAA+E;SAChF,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CACpB,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,KAAK,CAAC,MAAM,OAAO,OAAO,IAAI,CAAC,CAAC;QAC9E,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,KAAK,CAAC,UAAU,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QACpG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,SAAS,iCAAiC,CAAC,CAAC;QACxF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,yEAAyE;IACzE,IAAI,KAAK,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/formatters/csv.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Format an array of records as CSV with a header row.
+ *
+ * Each record is a plain object. Column order is derived from the keys
+ * of the first record. Missing keys in subsequent records produce empty cells.
+ */
+export declare function formatCsv(rows: readonly Record<string, unknown>[]): string;
+//# sourceMappingURL=csv.d.ts.map

package/dist/formatters/csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../src/formatters/csv.ts"],"names":[],"mappings":"AAuBA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,CAe1E"}

package/dist/formatters/csv.js

@@ -0,0 +1,40 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+function escapeCsvField(value) {
+    if (value.includes(",") || value.includes('"') || value.includes("\n")) {
+        return `"${value.replace(/"/g, '""')}"`;
+    }
+    return value;
+}
+function toCsvValue(value) {
+    if (value === null || value === undefined) {
+        return "";
+    }
+    if (typeof value === "string") {
+        return escapeCsvField(value);
+    }
+    if (typeof value === "object") {
+        return escapeCsvField(JSON.stringify(value));
+    }
+    return escapeCsvField(String(value));
+}
+/**
+ * Format an array of records as CSV with a header row.
+ *
+ * Each record is a plain object. Column order is derived from the keys
+ * of the first record. Missing keys in subsequent records produce empty cells.
+ */
+export function formatCsv(rows) {
+    if (rows.length === 0) {
+        return "";
+    }
+    const first = rows[0];
+    if (first === undefined) {
+        return "";
+    }
+    const columns = Object.keys(first);
+    const header = columns.map(escapeCsvField).join(",");
+    const body = rows.map((row) => columns.map((col) => toCsvValue(row[col])).join(","));
+    return [header, ...body].join("\n");
+}
+//# sourceMappingURL=csv.js.map

package/dist/formatters/csv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../src/formatters/csv.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACvE,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;IAC1C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,cAAc,CAAC,MAAM,CAAC,KAAkC,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAwC;IAChE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEnC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAErF,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/formatters/index.d.ts

@@ -0,0 +1,14 @@
+import type { OutputFormat } from "../options.js";
+export { formatCsv } from "./csv.js";
+export { formatJson } from "./json.js";
+export { formatTable } from "./table.js";
+export { formatYaml } from "./yaml.js";
+/**
+ * Route output formatting to the appropriate renderer based on the
+ * selected output format.
+ *
+ * For `table` and `csv`, `data` must be an array of plain objects.
+ * For `json` and `yaml`, any serializable value is accepted.
+ */
+export declare function formatOutput(data: unknown, format: OutputFormat): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/formatters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/formatters/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAMlD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAWxE"}