@xyd-js/opencli-completion 0.0.0-build-b7bd05c-20260701151111

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) LiveSession Sp.z.o.o
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/README.md

@@ -0,0 +1,34 @@
+# @xyd-js/opencli-completion
+
+Generate shell completion scripts from an [OpenCLI](https://opencli.org) document. The "tree"
+the generators walk **is an OpenCLI doc** — so any CLI that can describe itself as OpenCLI gets
+real shell completions for free.
+
+```ts
+import { zsh, fish, completion } from '@xyd-js/opencli-completion';
+
+zsh(opencliSpec);            // → a `#compdef` zsh script
+fish(opencliSpec);           // → a fish completion script
+completion(opencliSpec, sh); // → dispatch by shell ('zsh' | 'fish')
+```
+
+## Mapping
+
+| OpenCLI | Completion |
+|---|---|
+| `info.title` | the command name (`#compdef <name>`, `complete -c <name>`) |
+| `commands[]` (recursive) | completable subcommands |
+| a command's `options[]` | completable flags (`--name` + `aliases` → `-x` / `--xy`) |
+| an option with `arguments[]` | a value-taking flag (`-r` in fish, `:value:` in zsh) |
+| root `options` with `recursive: true` | global flags, offered on every command |
+
+Adapted from the static fish/zsh generation approach (no runtime completion daemon); the OpenCLI
+document is the single source of truth.
+
+## Limitations
+
+- The zsh generator completes the root and one level of subcommands (fish recurses deeper); deeply
+  nested command trees aren't fully expanded yet.
+- Positional `arguments` and `acceptedValues` (enum) aren't turned into value completions yet — only
+  subcommands and flags complete. Flags that take a value are marked (`-r` / `:value:`) but their
+  values aren't enumerated.

package/dist/index.cjs

@@ -0,0 +1,182 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// index.ts
+var index_exports = {};
+__export(index_exports, {
+  completion: () => completion,
+  fish: () => fish,
+  opencliToTree: () => opencliToTree,
+  zsh: () => zsh
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/flags.ts
+function splitFlags(flags) {
+  const short = [];
+  const long = [];
+  const old = [];
+  for (const f of flags) {
+    if (f.startsWith("--")) long.push(f.slice(2));
+    else if (f.startsWith("-") && f.length === 2) short.push(f.slice(1));
+    else if (f.startsWith("-")) old.push(f.slice(1));
+  }
+  return { short, long, old };
+}
+
+// src/tree.ts
+function opencliToTree(spec) {
+  var _a, _b;
+  const name = ((_a = spec.info) == null ? void 0 : _a.title) || "cli";
+  const rootOptions = (spec.options || []).filter((o) => !o.hidden);
+  const globalOptions = rootOptions.filter((o) => o.recursive);
+  const commandNode = (cmd) => ({
+    name: cmd.name,
+    description: cmd.description,
+    options: [
+      ...(cmd.options || []).filter((o) => !o.hidden).map(optionToCompletion),
+      ...globalOptions.map(optionToCompletion)
+    ],
+    commands: toNodeMap(cmd.commands, commandNode)
+  });
+  return {
+    name,
+    description: (_b = spec.info) == null ? void 0 : _b.description,
+    options: rootOptions.map(optionToCompletion),
+    commands: toNodeMap(spec.commands, commandNode)
+  };
+}
+function toNodeMap(commands, node) {
+  return Object.fromEntries((commands || []).filter((c) => !c.hidden).map((c) => [c.name, node(c)]));
+}
+function optionToCompletion(opt) {
+  var _a;
+  const flags = [`--${opt.name}`, ...(opt.aliases || []).map((a) => a.length === 1 ? `-${a}` : `--${a}`)];
+  return { flags, takesValue: (((_a = opt.arguments) == null ? void 0 : _a.length) ?? 0) > 0, description: opt.description };
+}
+
+// src/fish.ts
+var escFish = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+function fish(spec) {
+  const tree = opencliToTree(spec);
+  const cmd = tree.name;
+  const lines = [`# fish completions for ${cmd} (generated - do not edit)`];
+  const walk = (node, path) => {
+    const cond = path.length === 0 ? "__fish_use_subcommand" : path.map((p) => `__fish_seen_subcommand_from ${p}`).join("; and ");
+    const subs = Object.values(node.commands);
+    for (const sub of subs) {
+      const d = sub.description ? ` -d '${escFish(sub.description)}'` : "";
+      lines.push(`complete -c ${cmd} -n "${cond}" -f -a "${sub.name}"${d}`);
+    }
+    for (const opt of node.options) {
+      const { short, long, old } = splitFlags(opt.flags);
+      const parts = [...short.map((s) => `-s ${s}`), ...long.map((l) => `-l ${l}`), ...old.map((o) => `-o ${o}`)].join(" ");
+      const r = opt.takesValue ? " -r" : "";
+      const d = opt.description ? ` -d '${escFish(opt.description)}'` : "";
+      lines.push(`complete -c ${cmd} -n "${cond}" ${parts}${r}${d}`);
+    }
+    for (const sub of subs) walk(sub, [...path, sub.name]);
+  };
+  walk(tree, []);
+  return `${lines.join("\n")}
+`;
+}
+
+// src/zsh.ts
+var escZshSpec = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "'\\''").replace(/[:[\]{}]/g, (c) => `\\${c}`);
+var escZshDescribe = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "'\\''").replace(/:/g, "\\:");
+function optToSpec(opt) {
+  const { short, long } = splitFlags(opt.flags);
+  const desc = opt.description ? `[${escZshSpec(opt.description)}]` : "";
+  const value = opt.takesValue ? ":value:" : "";
+  const all = [...short.map((s) => `-${s}`), ...long.map((l) => `--${l}`)];
+  if (all.length >= 2) {
+    return `'(${all.join(" ")})'{${all.join(",")}}'${desc}${value}'`;
+  }
+  return `'${all[0]}${desc}${value}'`;
+}
+function zsh(spec) {
+  const tree = opencliToTree(spec);
+  const cmd = tree.name;
+  const subs = Object.values(tree.commands);
+  const hasSubs = subs.length > 0;
+  const out = [`#compdef ${cmd}`, "", `_${cmd}() {`];
+  out.push("  local context state state_descr line");
+  out.push("  typeset -A opt_args");
+  out.push("");
+  const rootSpecs = tree.options.map(optToSpec);
+  if (hasSubs) {
+    rootSpecs.push("'1: :->command'");
+    rootSpecs.push("'*::arg:->args'");
+  }
+  out.push("  _arguments -C \\");
+  out.push(`${rootSpecs.map((s) => `    ${s}`).join(" \\\n")} && return 0`);
+  if (hasSubs) {
+    out.push("");
+    out.push("  case $state in");
+    out.push("    command)");
+    out.push("      local -a commands");
+    out.push("      commands=(");
+    for (const sub of subs) {
+      out.push(`        '${sub.name}:${escZshDescribe(sub.description || "")}'`);
+    }
+    out.push("      )");
+    out.push(`      _describe -t commands '${cmd} command' commands`);
+    out.push("      ;;");
+    out.push("    args)");
+    out.push("      case $line[1] in");
+    for (const sub of subs) {
+      out.push(`        ${sub.name})`);
+      const specs = sub.options.map(optToSpec);
+      if (specs.length) {
+        out.push("          _arguments \\");
+        out.push(specs.map((s) => `            ${s}`).join(" \\\n"));
+      } else {
+        out.push("          _message 'no more arguments'");
+      }
+      out.push("          ;;");
+    }
+    out.push("      esac");
+    out.push("      ;;");
+    out.push("  esac");
+  }
+  out.push("}");
+  out.push("");
+  out.push(`_${cmd} "$@"`);
+  return `${out.join("\n")}
+`;
+}
+
+// src/index.ts
+function completion(spec, shell) {
+  switch (shell) {
+    case "fish":
+      return fish(spec);
+    default:
+      return zsh(spec);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  completion,
+  fish,
+  opencliToTree,
+  zsh
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../index.ts","../src/flags.ts","../src/tree.ts","../src/fish.ts","../src/zsh.ts","../src/index.ts"],"sourcesContent":["export * from './src';\n","/** Split flag spellings into short (`-x`), long (`--xy`) and old-style (`-xy`). */\nexport function splitFlags(flags: string[]): { short: string[]; long: string[]; old: string[] } {\n  const short: string[] = [];\n  const long: string[] = [];\n  const old: string[] = [];\n  for (const f of flags) {\n    if (f.startsWith('--')) long.push(f.slice(2));\n    else if (f.startsWith('-') && f.length === 2) short.push(f.slice(1));\n    else if (f.startsWith('-')) old.push(f.slice(1));\n  }\n  return { short, long, old };\n}\n","import type { Command, OpencliSpecJson, Option } from '@xyd-js/opencli';\n\nimport type { CompletionNode, CompletionOption } from './types';\n\n/**\n * Adapt an OpenCLI document into the command tree the shell generators walk.\n * Root-level `recursive` options (a CLI's global flags) are made available on\n * every command, so they complete in any subcommand context too.\n */\nexport function opencliToTree(spec: OpencliSpecJson): CompletionNode {\n  const name = spec.info?.title || 'cli';\n  const rootOptions = (spec.options || []).filter((o) => !o.hidden);\n  const globalOptions = rootOptions.filter((o) => o.recursive);\n\n  const commandNode = (cmd: Command): CompletionNode => ({\n    name: cmd.name,\n    description: cmd.description,\n    options: [\n      ...(cmd.options || []).filter((o) => !o.hidden).map(optionToCompletion),\n      ...globalOptions.map(optionToCompletion),\n    ],\n    commands: toNodeMap(cmd.commands, commandNode),\n  });\n\n  return {\n    name,\n    description: spec.info?.description,\n    options: rootOptions.map(optionToCompletion),\n    commands: toNodeMap(spec.commands, commandNode),\n  };\n}\n\nfunction toNodeMap(commands: Command[] | undefined, node: (c: Command) => CompletionNode): Record<string, CompletionNode> {\n  return Object.fromEntries((commands || []).filter((c) => !c.hidden).map((c) => [c.name, node(c)]));\n}\n\nfunction optionToCompletion(opt: Option): CompletionOption {\n  // OpenCLI option `name` is the canonical long form; aliases may be short or long.\n  const flags = [`--${opt.name}`, ...(opt.aliases || []).map((a) => (a.length === 1 ? `-${a}` : `--${a}`))];\n  return { flags, takesValue: (opt.arguments?.length ?? 0) > 0, description: opt.description };\n}\n","import type { OpencliSpecJson } from '@xyd-js/opencli';\n\nimport { splitFlags } from './flags';\nimport { opencliToTree } from './tree';\nimport type { CompletionNode } from './types';\n\nconst escFish = (s: string) => s.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"\\\\'\");\n\n/** Generate a fish completion script from an OpenCLI document. */\nexport function fish(spec: OpencliSpecJson): string {\n  const tree = opencliToTree(spec);\n  const cmd = tree.name;\n  const lines = [`# fish completions for ${cmd} (generated - do not edit)`];\n\n  const walk = (node: CompletionNode, path: string[]) => {\n    const cond =\n      path.length === 0\n        ? '__fish_use_subcommand'\n        : path.map((p) => `__fish_seen_subcommand_from ${p}`).join('; and ');\n\n    const subs = Object.values(node.commands);\n    for (const sub of subs) {\n      const d = sub.description ? ` -d '${escFish(sub.description)}'` : '';\n      lines.push(`complete -c ${cmd} -n \"${cond}\" -f -a \"${sub.name}\"${d}`);\n    }\n    for (const opt of node.options) {\n      const { short, long, old } = splitFlags(opt.flags);\n      const parts = [...short.map((s) => `-s ${s}`), ...long.map((l) => `-l ${l}`), ...old.map((o) => `-o ${o}`)].join(' ');\n      const r = opt.takesValue ? ' -r' : '';\n      const d = opt.description ? ` -d '${escFish(opt.description)}'` : '';\n      lines.push(`complete -c ${cmd} -n \"${cond}\" ${parts}${r}${d}`);\n    }\n    for (const sub of subs) walk(sub, [...path, sub.name]);\n  };\n\n  walk(tree, []);\n  return `${lines.join('\\n')}\\n`;\n}\n","import type { OpencliSpecJson } from '@xyd-js/opencli';\n\nimport { splitFlags } from './flags';\nimport { opencliToTree } from './tree';\nimport type { CompletionOption } from './types';\n\n// Inside an `_arguments` spec's `[...]` description: escape backslash, single\n// quote, and the chars that are syntactically special there (`:` `[` `]` `{` `}`).\nconst escZshSpec = (s: string) =>\n  s\n    .replace(/\\\\/g, '\\\\\\\\')\n    .replace(/'/g, \"'\\\\''\")\n    .replace(/[:[\\]{}]/g, (c) => `\\\\${c}`);\n\n// Inside a `_describe` `'value:desc'` row only the `:` separator (plus quote /\n// backslash) is special — brackets/braces are literal.\nconst escZshDescribe = (s: string) => s.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"'\\\\''\").replace(/:/g, '\\\\:');\n\nfunction optToSpec(opt: CompletionOption): string {\n  const { short, long } = splitFlags(opt.flags);\n  const desc = opt.description ? `[${escZshSpec(opt.description)}]` : '';\n  const value = opt.takesValue ? ':value:' : '';\n  const all = [...short.map((s) => `-${s}`), ...long.map((l) => `--${l}`)];\n  if (all.length >= 2) {\n    return `'(${all.join(' ')})'{${all.join(',')}}'${desc}${value}'`;\n  }\n  return `'${all[0]}${desc}${value}'`;\n}\n\n/** Generate a zsh completion script (`#compdef`) from an OpenCLI document. */\nexport function zsh(spec: OpencliSpecJson): string {\n  const tree = opencliToTree(spec);\n  const cmd = tree.name;\n  const subs = Object.values(tree.commands);\n  const hasSubs = subs.length > 0;\n  const out = [`#compdef ${cmd}`, '', `_${cmd}() {`];\n\n  out.push('  local context state state_descr line');\n  out.push('  typeset -A opt_args');\n  out.push('');\n\n  const rootSpecs = tree.options.map(optToSpec);\n  if (hasSubs) {\n    rootSpecs.push(\"'1: :->command'\");\n    rootSpecs.push(\"'*::arg:->args'\");\n  }\n  out.push('  _arguments -C \\\\');\n  out.push(`${rootSpecs.map((s) => `    ${s}`).join(' \\\\\\n')} && return 0`);\n\n  if (hasSubs) {\n    out.push('');\n    out.push('  case $state in');\n    out.push('    command)');\n    out.push('      local -a commands');\n    out.push('      commands=(');\n    for (const sub of subs) {\n      out.push(`        '${sub.name}:${escZshDescribe(sub.description || '')}'`);\n    }\n    out.push('      )');\n    out.push(`      _describe -t commands '${cmd} command' commands`);\n    out.push('      ;;');\n    out.push('    args)');\n    out.push('      case $line[1] in');\n    for (const sub of subs) {\n      out.push(`        ${sub.name})`);\n      const specs = sub.options.map(optToSpec);\n      if (specs.length) {\n        out.push('          _arguments \\\\');\n        out.push(specs.map((s) => `            ${s}`).join(' \\\\\\n'));\n      } else {\n        out.push(\"          _message 'no more arguments'\");\n      }\n      out.push('          ;;');\n    }\n    out.push('      esac');\n    out.push('      ;;');\n    out.push('  esac');\n  }\n\n  out.push('}');\n  out.push('');\n  out.push(`_${cmd} \"$@\"`);\n  return `${out.join('\\n')}\\n`;\n}\n","import type { OpencliSpecJson } from '@xyd-js/opencli';\n\nimport { fish } from './fish';\nimport type { Shell } from './types';\nimport { zsh } from './zsh';\n\nexport { fish } from './fish';\nexport { zsh } from './zsh';\nexport { opencliToTree } from './tree';\nexport type { Shell, CompletionNode, CompletionOption } from './types';\n\n/** Generate a completion script for the given shell from an OpenCLI document. */\nexport function completion(spec: OpencliSpecJson, shell: Shell): string {\n  switch (shell) {\n    case 'fish':\n      return fish(spec);\n    default:\n      return zsh(spec);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,37 @@
+import { OpencliSpecJson } from '@xyd-js/opencli';
+
+type Shell = 'zsh' | 'fish';
+/** A flag/option, normalized for completion generation. */
+interface CompletionOption {
+    /** Flag spellings, e.g. `['-h', '--help']`. */
+    flags: string[];
+    /** Whether the flag consumes a value (`--port <n>`) vs. a switch. */
+    takesValue: boolean;
+    description?: string;
+}
+/** A command node (the CLI root or a subcommand) the generators walk. */
+interface CompletionNode {
+    name: string;
+    description?: string;
+    options: CompletionOption[];
+    /** Subcommands keyed by name. */
+    commands: Record<string, CompletionNode>;
+}
+
+/** Generate a fish completion script from an OpenCLI document. */
+declare function fish(spec: OpencliSpecJson): string;
+
+/** Generate a zsh completion script (`#compdef`) from an OpenCLI document. */
+declare function zsh(spec: OpencliSpecJson): string;
+
+/**
+ * Adapt an OpenCLI document into the command tree the shell generators walk.
+ * Root-level `recursive` options (a CLI's global flags) are made available on
+ * every command, so they complete in any subcommand context too.
+ */
+declare function opencliToTree(spec: OpencliSpecJson): CompletionNode;
+
+/** Generate a completion script for the given shell from an OpenCLI document. */
+declare function completion(spec: OpencliSpecJson, shell: Shell): string;
+
+export { type CompletionNode, type CompletionOption, type Shell, completion, fish, opencliToTree, zsh };

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import { OpencliSpecJson } from '@xyd-js/opencli';
+
+type Shell = 'zsh' | 'fish';
+/** A flag/option, normalized for completion generation. */
+interface CompletionOption {
+    /** Flag spellings, e.g. `['-h', '--help']`. */
+    flags: string[];
+    /** Whether the flag consumes a value (`--port <n>`) vs. a switch. */
+    takesValue: boolean;
+    description?: string;
+}
+/** A command node (the CLI root or a subcommand) the generators walk. */
+interface CompletionNode {
+    name: string;
+    description?: string;
+    options: CompletionOption[];
+    /** Subcommands keyed by name. */
+    commands: Record<string, CompletionNode>;
+}
+
+/** Generate a fish completion script from an OpenCLI document. */
+declare function fish(spec: OpencliSpecJson): string;
+
+/** Generate a zsh completion script (`#compdef`) from an OpenCLI document. */
+declare function zsh(spec: OpencliSpecJson): string;
+
+/**
+ * Adapt an OpenCLI document into the command tree the shell generators walk.
+ * Root-level `recursive` options (a CLI's global flags) are made available on
+ * every command, so they complete in any subcommand context too.
+ */
+declare function opencliToTree(spec: OpencliSpecJson): CompletionNode;
+
+/** Generate a completion script for the given shell from an OpenCLI document. */
+declare function completion(spec: OpencliSpecJson, shell: Shell): string;
+
+export { type CompletionNode, type CompletionOption, type Shell, completion, fish, opencliToTree, zsh };

package/dist/index.js

@@ -0,0 +1,152 @@
+// src/flags.ts
+function splitFlags(flags) {
+  const short = [];
+  const long = [];
+  const old = [];
+  for (const f of flags) {
+    if (f.startsWith("--")) long.push(f.slice(2));
+    else if (f.startsWith("-") && f.length === 2) short.push(f.slice(1));
+    else if (f.startsWith("-")) old.push(f.slice(1));
+  }
+  return { short, long, old };
+}
+
+// src/tree.ts
+function opencliToTree(spec) {
+  var _a, _b;
+  const name = ((_a = spec.info) == null ? void 0 : _a.title) || "cli";
+  const rootOptions = (spec.options || []).filter((o) => !o.hidden);
+  const globalOptions = rootOptions.filter((o) => o.recursive);
+  const commandNode = (cmd) => ({
+    name: cmd.name,
+    description: cmd.description,
+    options: [
+      ...(cmd.options || []).filter((o) => !o.hidden).map(optionToCompletion),
+      ...globalOptions.map(optionToCompletion)
+    ],
+    commands: toNodeMap(cmd.commands, commandNode)
+  });
+  return {
+    name,
+    description: (_b = spec.info) == null ? void 0 : _b.description,
+    options: rootOptions.map(optionToCompletion),
+    commands: toNodeMap(spec.commands, commandNode)
+  };
+}
+function toNodeMap(commands, node) {
+  return Object.fromEntries((commands || []).filter((c) => !c.hidden).map((c) => [c.name, node(c)]));
+}
+function optionToCompletion(opt) {
+  var _a;
+  const flags = [`--${opt.name}`, ...(opt.aliases || []).map((a) => a.length === 1 ? `-${a}` : `--${a}`)];
+  return { flags, takesValue: (((_a = opt.arguments) == null ? void 0 : _a.length) ?? 0) > 0, description: opt.description };
+}
+
+// src/fish.ts
+var escFish = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+function fish(spec) {
+  const tree = opencliToTree(spec);
+  const cmd = tree.name;
+  const lines = [`# fish completions for ${cmd} (generated - do not edit)`];
+  const walk = (node, path) => {
+    const cond = path.length === 0 ? "__fish_use_subcommand" : path.map((p) => `__fish_seen_subcommand_from ${p}`).join("; and ");
+    const subs = Object.values(node.commands);
+    for (const sub of subs) {
+      const d = sub.description ? ` -d '${escFish(sub.description)}'` : "";
+      lines.push(`complete -c ${cmd} -n "${cond}" -f -a "${sub.name}"${d}`);
+    }
+    for (const opt of node.options) {
+      const { short, long, old } = splitFlags(opt.flags);
+      const parts = [...short.map((s) => `-s ${s}`), ...long.map((l) => `-l ${l}`), ...old.map((o) => `-o ${o}`)].join(" ");
+      const r = opt.takesValue ? " -r" : "";
+      const d = opt.description ? ` -d '${escFish(opt.description)}'` : "";
+      lines.push(`complete -c ${cmd} -n "${cond}" ${parts}${r}${d}`);
+    }
+    for (const sub of subs) walk(sub, [...path, sub.name]);
+  };
+  walk(tree, []);
+  return `${lines.join("\n")}
+`;
+}
+
+// src/zsh.ts
+var escZshSpec = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "'\\''").replace(/[:[\]{}]/g, (c) => `\\${c}`);
+var escZshDescribe = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "'\\''").replace(/:/g, "\\:");
+function optToSpec(opt) {
+  const { short, long } = splitFlags(opt.flags);
+  const desc = opt.description ? `[${escZshSpec(opt.description)}]` : "";
+  const value = opt.takesValue ? ":value:" : "";
+  const all = [...short.map((s) => `-${s}`), ...long.map((l) => `--${l}`)];
+  if (all.length >= 2) {
+    return `'(${all.join(" ")})'{${all.join(",")}}'${desc}${value}'`;
+  }
+  return `'${all[0]}${desc}${value}'`;
+}
+function zsh(spec) {
+  const tree = opencliToTree(spec);
+  const cmd = tree.name;
+  const subs = Object.values(tree.commands);
+  const hasSubs = subs.length > 0;
+  const out = [`#compdef ${cmd}`, "", `_${cmd}() {`];
+  out.push("  local context state state_descr line");
+  out.push("  typeset -A opt_args");
+  out.push("");
+  const rootSpecs = tree.options.map(optToSpec);
+  if (hasSubs) {
+    rootSpecs.push("'1: :->command'");
+    rootSpecs.push("'*::arg:->args'");
+  }
+  out.push("  _arguments -C \\");
+  out.push(`${rootSpecs.map((s) => `    ${s}`).join(" \\\n")} && return 0`);
+  if (hasSubs) {
+    out.push("");
+    out.push("  case $state in");
+    out.push("    command)");
+    out.push("      local -a commands");
+    out.push("      commands=(");
+    for (const sub of subs) {
+      out.push(`        '${sub.name}:${escZshDescribe(sub.description || "")}'`);
+    }
+    out.push("      )");
+    out.push(`      _describe -t commands '${cmd} command' commands`);
+    out.push("      ;;");
+    out.push("    args)");
+    out.push("      case $line[1] in");
+    for (const sub of subs) {
+      out.push(`        ${sub.name})`);
+      const specs = sub.options.map(optToSpec);
+      if (specs.length) {
+        out.push("          _arguments \\");
+        out.push(specs.map((s) => `            ${s}`).join(" \\\n"));
+      } else {
+        out.push("          _message 'no more arguments'");
+      }
+      out.push("          ;;");
+    }
+    out.push("      esac");
+    out.push("      ;;");
+    out.push("  esac");
+  }
+  out.push("}");
+  out.push("");
+  out.push(`_${cmd} "$@"`);
+  return `${out.join("\n")}
+`;
+}
+
+// src/index.ts
+function completion(spec, shell) {
+  switch (shell) {
+    case "fish":
+      return fish(spec);
+    default:
+      return zsh(spec);
+  }
+}
+export {
+  completion,
+  fish,
+  opencliToTree,
+  zsh
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/flags.ts","../src/tree.ts","../src/fish.ts","../src/zsh.ts","../src/index.ts"],"sourcesContent":["/** Split flag spellings into short (`-x`), long (`--xy`) and old-style (`-xy`). */\nexport function splitFlags(flags: string[]): { short: string[]; long: string[]; old: string[] } {\n  const short: string[] = [];\n  const long: string[] = [];\n  const old: string[] = [];\n  for (const f of flags) {\n    if (f.startsWith('--')) long.push(f.slice(2));\n    else if (f.startsWith('-') && f.length === 2) short.push(f.slice(1));\n    else if (f.startsWith('-')) old.push(f.slice(1));\n  }\n  return { short, long, old };\n}\n","import type { Command, OpencliSpecJson, Option } from '@xyd-js/opencli';\n\nimport type { CompletionNode, CompletionOption } from './types';\n\n/**\n * Adapt an OpenCLI document into the command tree the shell generators walk.\n * Root-level `recursive` options (a CLI's global flags) are made available on\n * every command, so they complete in any subcommand context too.\n */\nexport function opencliToTree(spec: OpencliSpecJson): CompletionNode {\n  const name = spec.info?.title || 'cli';\n  const rootOptions = (spec.options || []).filter((o) => !o.hidden);\n  const globalOptions = rootOptions.filter((o) => o.recursive);\n\n  const commandNode = (cmd: Command): CompletionNode => ({\n    name: cmd.name,\n    description: cmd.description,\n    options: [\n      ...(cmd.options || []).filter((o) => !o.hidden).map(optionToCompletion),\n      ...globalOptions.map(optionToCompletion),\n    ],\n    commands: toNodeMap(cmd.commands, commandNode),\n  });\n\n  return {\n    name,\n    description: spec.info?.description,\n    options: rootOptions.map(optionToCompletion),\n    commands: toNodeMap(spec.commands, commandNode),\n  };\n}\n\nfunction toNodeMap(commands: Command[] | undefined, node: (c: Command) => CompletionNode): Record<string, CompletionNode> {\n  return Object.fromEntries((commands || []).filter((c) => !c.hidden).map((c) => [c.name, node(c)]));\n}\n\nfunction optionToCompletion(opt: Option): CompletionOption {\n  // OpenCLI option `name` is the canonical long form; aliases may be short or long.\n  const flags = [`--${opt.name}`, ...(opt.aliases || []).map((a) => (a.length === 1 ? `-${a}` : `--${a}`))];\n  return { flags, takesValue: (opt.arguments?.length ?? 0) > 0, description: opt.description };\n}\n","import type { OpencliSpecJson } from '@xyd-js/opencli';\n\nimport { splitFlags } from './flags';\nimport { opencliToTree } from './tree';\nimport type { CompletionNode } from './types';\n\nconst escFish = (s: string) => s.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"\\\\'\");\n\n/** Generate a fish completion script from an OpenCLI document. */\nexport function fish(spec: OpencliSpecJson): string {\n  const tree = opencliToTree(spec);\n  const cmd = tree.name;\n  const lines = [`# fish completions for ${cmd} (generated - do not edit)`];\n\n  const walk = (node: CompletionNode, path: string[]) => {\n    const cond =\n      path.length === 0\n        ? '__fish_use_subcommand'\n        : path.map((p) => `__fish_seen_subcommand_from ${p}`).join('; and ');\n\n    const subs = Object.values(node.commands);\n    for (const sub of subs) {\n      const d = sub.description ? ` -d '${escFish(sub.description)}'` : '';\n      lines.push(`complete -c ${cmd} -n \"${cond}\" -f -a \"${sub.name}\"${d}`);\n    }\n    for (const opt of node.options) {\n      const { short, long, old } = splitFlags(opt.flags);\n      const parts = [...short.map((s) => `-s ${s}`), ...long.map((l) => `-l ${l}`), ...old.map((o) => `-o ${o}`)].join(' ');\n      const r = opt.takesValue ? ' -r' : '';\n      const d = opt.description ? ` -d '${escFish(opt.description)}'` : '';\n      lines.push(`complete -c ${cmd} -n \"${cond}\" ${parts}${r}${d}`);\n    }\n    for (const sub of subs) walk(sub, [...path, sub.name]);\n  };\n\n  walk(tree, []);\n  return `${lines.join('\\n')}\\n`;\n}\n","import type { OpencliSpecJson } from '@xyd-js/opencli';\n\nimport { splitFlags } from './flags';\nimport { opencliToTree } from './tree';\nimport type { CompletionOption } from './types';\n\n// Inside an `_arguments` spec's `[...]` description: escape backslash, single\n// quote, and the chars that are syntactically special there (`:` `[` `]` `{` `}`).\nconst escZshSpec = (s: string) =>\n  s\n    .replace(/\\\\/g, '\\\\\\\\')\n    .replace(/'/g, \"'\\\\''\")\n    .replace(/[:[\\]{}]/g, (c) => `\\\\${c}`);\n\n// Inside a `_describe` `'value:desc'` row only the `:` separator (plus quote /\n// backslash) is special — brackets/braces are literal.\nconst escZshDescribe = (s: string) => s.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"'\\\\''\").replace(/:/g, '\\\\:');\n\nfunction optToSpec(opt: CompletionOption): string {\n  const { short, long } = splitFlags(opt.flags);\n  const desc = opt.description ? `[${escZshSpec(opt.description)}]` : '';\n  const value = opt.takesValue ? ':value:' : '';\n  const all = [...short.map((s) => `-${s}`), ...long.map((l) => `--${l}`)];\n  if (all.length >= 2) {\n    return `'(${all.join(' ')})'{${all.join(',')}}'${desc}${value}'`;\n  }\n  return `'${all[0]}${desc}${value}'`;\n}\n\n/** Generate a zsh completion script (`#compdef`) from an OpenCLI document. */\nexport function zsh(spec: OpencliSpecJson): string {\n  const tree = opencliToTree(spec);\n  const cmd = tree.name;\n  const subs = Object.values(tree.commands);\n  const hasSubs = subs.length > 0;\n  const out = [`#compdef ${cmd}`, '', `_${cmd}() {`];\n\n  out.push('  local context state state_descr line');\n  out.push('  typeset -A opt_args');\n  out.push('');\n\n  const rootSpecs = tree.options.map(optToSpec);\n  if (hasSubs) {\n    rootSpecs.push(\"'1: :->command'\");\n    rootSpecs.push(\"'*::arg:->args'\");\n  }\n  out.push('  _arguments -C \\\\');\n  out.push(`${rootSpecs.map((s) => `    ${s}`).join(' \\\\\\n')} && return 0`);\n\n  if (hasSubs) {\n    out.push('');\n    out.push('  case $state in');\n    out.push('    command)');\n    out.push('      local -a commands');\n    out.push('      commands=(');\n    for (const sub of subs) {\n      out.push(`        '${sub.name}:${escZshDescribe(sub.description || '')}'`);\n    }\n    out.push('      )');\n    out.push(`      _describe -t commands '${cmd} command' commands`);\n    out.push('      ;;');\n    out.push('    args)');\n    out.push('      case $line[1] in');\n    for (const sub of subs) {\n      out.push(`        ${sub.name})`);\n      const specs = sub.options.map(optToSpec);\n      if (specs.length) {\n        out.push('          _arguments \\\\');\n        out.push(specs.map((s) => `            ${s}`).join(' \\\\\\n'));\n      } else {\n        out.push(\"          _message 'no more arguments'\");\n      }\n      out.push('          ;;');\n    }\n    out.push('      esac');\n    out.push('      ;;');\n    out.push('  esac');\n  }\n\n  out.push('}');\n  out.push('');\n  out.push(`_${cmd} \"$@\"`);\n  return `${out.join('\\n')}\\n`;\n}\n","import type { OpencliSpecJson } from '@xyd-js/opencli';\n\nimport { fish } from './fish';\nimport type { Shell } from './types';\nimport { zsh } from './zsh';\n\nexport { fish } from './fish';\nexport { zsh } from './zsh';\nexport { opencliToTree } from './tree';\nexport type { Shell, CompletionNode, CompletionOption } from './types';\n\n/** Generate a completion script for the given shell from an OpenCLI document. */\nexport function completion(spec: OpencliSpecJson, shell: Shell): string {\n  switch (shell) {\n    case 'fish':\n      return fish(spec);\n    default:\n      return zsh(spec);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@xyd-js/opencli-completion",
+  "version": "0.0.0-build-b7bd05c-20260701151111",
+  "description": "Generate shell completion scripts (zsh, fish) from an OpenCLI document",
+  "main": "./dist/index.js",
+  "type": "module",
+  "files": [
+    "dist",
+    "package.json"
+  ],
+  "dependencies": {
+    "@xyd-js/opencli": "0.0.0-build-b7bd05c-20260701151111"
+  },
+  "devDependencies": {
+    "@types/node": "^20.9.0",
+    "rimraf": "^3.0.2",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.2",
+    "vitest": "^2.1.1"
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "prebuild": "pnpm clean",
+    "build": "tsup",
+    "test": "vitest",
+    "ci:test": "vitest run",
+    "format": "bunx biome check --write src"
+  }
+}