padrone 1.8.2 → 2.0.0

package/dist/codegen/parsers/bash.d.mts

@@ -0,0 +1,19 @@
+import { CommandMeta } from "../types.mjs";
+
+//#region src/codegen/parsers/bash.d.ts
+/**
+ * Parse bash completion scripts into CommandMeta.
+ *
+ * Bash completions typically use `complete -F <func> <command>` and define
+ * a function that sets COMPREPLY. Common patterns:
+ *
+ *   local commands="init build deploy"
+ *   local args="--verbose --output --format"
+ *   case "$prev" in --format) COMPREPLY=($(compgen -W "json yaml toml" ...)) ;;
+ *   COMPREPLY=($(compgen -W "$commands" ...))
+ *   COMPREPLY=($(compgen -W "$args" ...))
+ */
+declare function parseBashCompletions(text: string): CommandMeta;
+//#endregion
+export { parseBashCompletions };
+//# sourceMappingURL=bash.d.mts.map

package/dist/codegen/parsers/bash.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.mts","names":[],"sources":["../../../src/codegen/parsers/bash.ts"],"mappings":";;;;;AAcA;;;;AAA+D;;;;;;iBAA/C,oBAAA,CAAqB,IAAA,WAAe,WAAW"}

package/dist/codegen/parsers/bash.mjs

@@ -0,0 +1,112 @@
+//#region src/codegen/parsers/bash.ts
+/**
+* Parse bash completion scripts into CommandMeta.
+*
+* Bash completions typically use `complete -F <func> <command>` and define
+* a function that sets COMPREPLY. Common patterns:
+*
+*   local commands="init build deploy"
+*   local args="--verbose --output --format"
+*   case "$prev" in --format) COMPREPLY=($(compgen -W "json yaml toml" ...)) ;;
+*   COMPREPLY=($(compgen -W "$commands" ...))
+*   COMPREPLY=($(compgen -W "$args" ...))
+*/
+function parseBashCompletions(text) {
+	const result = {
+		name: "",
+		arguments: [],
+		subcommands: []
+	};
+	const completeMatch = text.match(/complete\s+(?:[^-]|-[^F])*-F\s+\S+\s+(\S+)/);
+	if (completeMatch) result.name = completeMatch[1];
+	if (!result.name) {
+		const markerMatch = text.match(/###-begin-(\S+)-completion-###/);
+		if (markerMatch) result.name = markerMatch[1];
+	}
+	const joined = text.replace(/\\\n\s*/g, " ");
+	const variables = extractVariables(joined);
+	const commandWords = variables.get("commands") ?? variables.get("cmds") ?? variables.get("subcommands");
+	if (commandWords) for (const name of splitWords(commandWords)) result.subcommands.push({ name });
+	const argWords = variables.get("args") ?? variables.get("opts") ?? variables.get("options") ?? variables.get("flags");
+	const optionNames = /* @__PURE__ */ new Set();
+	if (argWords) {
+		for (const word of splitWords(argWords)) if (word.startsWith("-")) optionNames.add(word);
+	}
+	const compgenRegex = /compgen\s+-W\s+["']([^"']+)["']/g;
+	let compgenMatch;
+	while ((compgenMatch = compgenRegex.exec(joined)) !== null) {
+		if (compgenMatch[1].startsWith("$")) continue;
+		for (const word of splitWords(compgenMatch[1])) if (word.startsWith("-")) optionNames.add(word);
+	}
+	const enumMap = parseCaseStatement(joined);
+	const seenArgs = /* @__PURE__ */ new Set();
+	for (const rawName of optionNames) {
+		if (rawName === "--help" || rawName === "-h" || rawName === "--version" || rawName === "-V") continue;
+		const name = rawName.replace(/^-+/, "").replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+		if (!name || seenArgs.has(name)) continue;
+		seenArgs.add(name);
+		const enumValues = enumMap.get(rawName);
+		const isShort = rawName.startsWith("-") && !rawName.startsWith("--") && rawName.length === 2;
+		const field = {
+			name,
+			type: enumValues ? "enum" : "string",
+			enumValues,
+			ambiguous: !enumValues
+		};
+		if (isShort) field.aliases = [rawName];
+		result.arguments.push(field);
+	}
+	if (result.arguments.length === 0) delete result.arguments;
+	if (result.subcommands.length === 0) delete result.subcommands;
+	return result;
+}
+/**
+* Extract variable assignments: `local VAR="value"`, `VAR="value"`, `local VAR='value'`
+*/
+function extractVariables(text) {
+	const vars = /* @__PURE__ */ new Map();
+	const regex = /(?:local\s+)?(\w+)=["']([^"']+)["']/g;
+	let match;
+	while ((match = regex.exec(text)) !== null) vars.set(match[1], match[2]);
+	return vars;
+}
+/**
+* Parse case statements to find option → enum value mappings.
+*
+* Matches patterns like:
+*   case "$prev" in
+*     --format) COMPREPLY=($(compgen -W "json yaml toml" ...)) ;;
+*     --env|--environment) COMPREPLY=($(compgen -W "dev staging prod" ...)) ;;
+*/
+function parseCaseStatement(text) {
+	const result = /* @__PURE__ */ new Map();
+	const caseRegex = /case\s+[^i]*\bin\b\s*([\s\S]*?)esac/g;
+	let caseMatch;
+	while ((caseMatch = caseRegex.exec(text)) !== null) {
+		const branches = caseMatch[1].split(";;");
+		for (const branch of branches) {
+			const patternMatch = branch.match(/^\s*([-\w|]+)\)/);
+			if (!patternMatch) continue;
+			const compgenMatch = branch.match(/compgen\s+-W\s+["']([^"']+)["']/);
+			if (!compgenMatch) continue;
+			const values = compgenMatch[1];
+			const words = splitWords(values).filter((w) => !w.startsWith("$"));
+			if (words.length === 0) continue;
+			for (const pattern of patternMatch[1].split("|")) {
+				const trimmed = pattern.trim();
+				if (trimmed.startsWith("-")) result.set(trimmed, words);
+			}
+		}
+	}
+	return result;
+}
+/**
+* Split a space-separated word list, filtering empty strings.
+*/
+function splitWords(text) {
+	return text.split(/\s+/).filter(Boolean);
+}
+//#endregion
+export { parseBashCompletions };
+
+//# sourceMappingURL=bash.mjs.map

package/dist/codegen/parsers/bash.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.mjs","names":[],"sources":["../../../src/codegen/parsers/bash.ts"],"sourcesContent":["import type { CommandMeta, FieldMeta } from '../types.ts';\n\n/**\n * Parse bash completion scripts into CommandMeta.\n *\n * Bash completions typically use `complete -F <func> <command>` and define\n * a function that sets COMPREPLY. Common patterns:\n *\n *   local commands=\"init build deploy\"\n *   local args=\"--verbose --output --format\"\n *   case \"$prev\" in --format) COMPREPLY=($(compgen -W \"json yaml toml\" ...)) ;;\n *   COMPREPLY=($(compgen -W \"$commands\" ...))\n *   COMPREPLY=($(compgen -W \"$args\" ...))\n */\nexport function parseBashCompletions(text: string): CommandMeta {\n  const result: CommandMeta = {\n    name: '',\n    arguments: [],\n    subcommands: [],\n  };\n\n  // Detect command name from `complete -F _func <command>` or `complete -o ... -F _func <command>`\n  const completeMatch = text.match(/complete\\s+(?:[^-]|-[^F])*-F\\s+\\S+\\s+(\\S+)/);\n  if (completeMatch) {\n    result.name = completeMatch[1]!;\n  }\n\n  // Fallback: detect from marker comments like ###-begin-<name>-completion-###\n  if (!result.name) {\n    const markerMatch = text.match(/###-begin-(\\S+)-completion-###/);\n    if (markerMatch) {\n      result.name = markerMatch[1]!;\n    }\n  }\n\n  // Join continuation lines for easier parsing\n  const joined = text.replace(/\\\\\\n\\s*/g, ' ');\n\n  // Collect variable values: local commands=\"...\" or local args=\"...\"\n  const variables = extractVariables(joined);\n\n  // Extract subcommand names from commands variable or compgen -W \"cmd1 cmd2\"\n  const commandWords = variables.get('commands') ?? variables.get('cmds') ?? variables.get('subcommands');\n  if (commandWords) {\n    for (const name of splitWords(commandWords)) {\n      result.subcommands!.push({ name });\n    }\n  }\n\n  // Extract option names from args/opts/options variable\n  const argWords = variables.get('args') ?? variables.get('opts') ?? variables.get('options') ?? variables.get('flags');\n  const optionNames = new Set<string>();\n\n  if (argWords) {\n    for (const word of splitWords(argWords)) {\n      if (word.startsWith('-')) {\n        optionNames.add(word);\n      }\n    }\n  }\n\n  // Also scan for compgen -W patterns not tied to a case statement\n  const compgenRegex = /compgen\\s+-W\\s+[\"']([^\"']+)[\"']/g;\n  let compgenMatch: RegExpExecArray | null;\n  while ((compgenMatch = compgenRegex.exec(joined)) !== null) {\n    // Skip variable references like $args, $commands\n    if (compgenMatch[1]!.startsWith('$')) continue;\n    for (const word of splitWords(compgenMatch[1]!)) {\n      if (word.startsWith('-')) {\n        optionNames.add(word);\n      }\n    }\n  }\n\n  // Parse case statement for option value completions (enum detection)\n  const enumMap = parseCaseStatement(joined);\n\n  // Build argument fields\n  const seenArgs = new Set<string>();\n\n  for (const rawName of optionNames) {\n    // Skip builtins\n    if (rawName === '--help' || rawName === '-h' || rawName === '--version' || rawName === '-V') continue;\n\n    const name = rawName.replace(/^-+/, '').replace(/-([a-z])/g, (_, c: string) => c.toUpperCase());\n    if (!name || seenArgs.has(name)) continue;\n    seenArgs.add(name);\n\n    // Check if this option has enum values from case statement\n    const enumValues = enumMap.get(rawName);\n\n    const isShort = rawName.startsWith('-') && !rawName.startsWith('--') && rawName.length === 2;\n    const field: FieldMeta = {\n      name,\n      type: enumValues ? 'enum' : 'string',\n      enumValues,\n      ambiguous: !enumValues,\n    };\n\n    // If there's a corresponding long-form, record alias\n    if (isShort) {\n      field.aliases = [rawName];\n    }\n\n    result.arguments!.push(field);\n  }\n\n  if (result.arguments!.length === 0) delete result.arguments;\n  if (result.subcommands!.length === 0) delete result.subcommands;\n\n  return result;\n}\n\n/**\n * Extract variable assignments: `local VAR=\"value\"`, `VAR=\"value\"`, `local VAR='value'`\n */\nfunction extractVariables(text: string): Map<string, string> {\n  const vars = new Map<string, string>();\n  const regex = /(?:local\\s+)?(\\w+)=[\"']([^\"']+)[\"']/g;\n  let match: RegExpExecArray | null;\n\n  while ((match = regex.exec(text)) !== null) {\n    vars.set(match[1]!, match[2]!);\n  }\n\n  return vars;\n}\n\n/**\n * Parse case statements to find option → enum value mappings.\n *\n * Matches patterns like:\n *   case \"$prev\" in\n *     --format) COMPREPLY=($(compgen -W \"json yaml toml\" ...)) ;;\n *     --env|--environment) COMPREPLY=($(compgen -W \"dev staging prod\" ...)) ;;\n */\nfunction parseCaseStatement(text: string): Map<string, string[]> {\n  const result = new Map<string, string[]>();\n\n  // Find case blocks on $prev or similar variables\n  const caseRegex = /case\\s+[^i]*\\bin\\b\\s*([\\s\\S]*?)esac/g;\n  let caseMatch: RegExpExecArray | null;\n\n  while ((caseMatch = caseRegex.exec(text)) !== null) {\n    const body = caseMatch[1]!;\n\n    // Split into branches by ;; delimiter\n    const branches = body.split(';;');\n    for (const branch of branches) {\n      // Match pattern: --opt1|--opt2) ... compgen -W \"values\" ...\n      const patternMatch = branch.match(/^\\s*([-\\w|]+)\\)/);\n      if (!patternMatch) continue;\n\n      // Find compgen -W \"values\" within this branch\n      const compgenMatch = branch.match(/compgen\\s+-W\\s+[\"']([^\"']+)[\"']/);\n      if (!compgenMatch) continue;\n\n      const values = compgenMatch[1]!;\n      const words = splitWords(values).filter((w) => !w.startsWith('$'));\n      if (words.length === 0) continue;\n\n      for (const pattern of patternMatch[1]!.split('|')) {\n        const trimmed = pattern.trim();\n        if (trimmed.startsWith('-')) {\n          result.set(trimmed, words);\n        }\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Split a space-separated word list, filtering empty strings.\n */\nfunction splitWords(text: string): string[] {\n  return text.split(/\\s+/).filter(Boolean);\n}\n"],"mappings":"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"}

package/dist/codegen/parsers/fish.d.mts

@@ -0,0 +1,13 @@
+import { CommandMeta } from "../types.mjs";
+
+//#region src/codegen/parsers/fish.d.ts
+/**
+ * Parse fish shell completion scripts into CommandMeta.
+ *
+ * Fish completions use the `complete` builtin:
+ *   complete -c <command> -s <short> -l <long> -d <description> -a <arguments> -r -f
+ */
+declare function parseFishCompletions(text: string): CommandMeta;
+//#endregion
+export { parseFishCompletions };
+//# sourceMappingURL=fish.d.mts.map

package/dist/codegen/parsers/fish.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fish.d.mts","names":[],"sources":["../../../src/codegen/parsers/fish.ts"],"mappings":";;;;;AAQA;;;;iBAAgB,oBAAA,CAAqB,IAAA,WAAe,WAAW"}

package/dist/codegen/parsers/fish.mjs

@@ -0,0 +1,108 @@
+//#region src/codegen/parsers/fish.ts
+/**
+* Parse fish shell completion scripts into CommandMeta.
+*
+* Fish completions use the `complete` builtin:
+*   complete -c <command> -s <short> -l <long> -d <description> -a <arguments> -r -f
+*/
+function parseFishCompletions(text) {
+	const lines = text.split("\n");
+	const result = {
+		name: "",
+		arguments: [],
+		subcommands: []
+	};
+	const subcommandMap = /* @__PURE__ */ new Map();
+	for (const line of lines) {
+		const trimmed = line.trim();
+		if (!trimmed || trimmed.startsWith("#")) continue;
+		if (!trimmed.match(/^complete\s+/)) continue;
+		const parts = parseCompleteLine(trimmed);
+		if (!parts) continue;
+		if (!result.name && parts.command) result.name = parts.command;
+		const subcommandCondition = parts.condition?.match(/__fish_seen_subcommand_from\s+(\S+)/);
+		if (subcommandCondition) {
+			const subName = subcommandCondition[1];
+			let sub = subcommandMap.get(subName);
+			if (!sub) {
+				sub = {
+					name: subName,
+					arguments: []
+				};
+				subcommandMap.set(subName, sub);
+			}
+			if (parts.longFlag || parts.shortFlag) {
+				const field = completionToField(parts);
+				if (field) sub.arguments.push(field);
+			}
+			continue;
+		}
+		if (parts.arguments && !parts.longFlag && !parts.shortFlag) {
+			const names = parts.arguments.split(/\s+/);
+			for (const name of names) {
+				if (!name || name.startsWith("(")) continue;
+				if (!subcommandMap.has(name)) subcommandMap.set(name, {
+					name,
+					description: parts.description,
+					arguments: []
+				});
+				else if (parts.description) subcommandMap.get(name).description = parts.description;
+			}
+			continue;
+		}
+		if (parts.longFlag || parts.shortFlag) {
+			const field = completionToField(parts);
+			if (field) result.arguments.push(field);
+		}
+	}
+	for (const sub of subcommandMap.values()) {
+		if (sub.arguments.length === 0) delete sub.arguments;
+		result.subcommands.push(sub);
+	}
+	if (result.arguments.length === 0) delete result.arguments;
+	if (result.subcommands.length === 0) delete result.subcommands;
+	return result;
+}
+function parseCompleteLine(line) {
+	const parts = {};
+	const cmdMatch = line.match(/-c\s+(\S+)/);
+	if (cmdMatch) parts.command = cmdMatch[1];
+	const shortMatch = line.match(/-s\s+(\S+)/);
+	if (shortMatch) parts.shortFlag = shortMatch[1];
+	const longMatch = line.match(/-l\s+(\S+)/);
+	if (longMatch) parts.longFlag = longMatch[1];
+	const descMatch = line.match(/-d\s+['"]([^'"]+)['"]/) || line.match(/-d\s+(\S+)/);
+	if (descMatch) parts.description = descMatch[1];
+	const argsMatch = line.match(/-a\s+['"]([^'"]+)['"]/) || line.match(/-a\s+(\S+)/);
+	if (argsMatch) parts.arguments = argsMatch[1];
+	const condMatch = line.match(/-n\s+['"]([^'"]+)['"]/) || line.match(/-n\s+(\S+)/);
+	if (condMatch) parts.condition = condMatch[1];
+	parts.requiresArg = /-r\b/.test(line);
+	parts.noFiles = /-f\b/.test(line);
+	return parts;
+}
+function completionToField(parts) {
+	const name = parts.longFlag ? parts.longFlag.replace(/-([a-z])/g, (_, c) => c.toUpperCase()) : parts.shortFlag || "";
+	if (!name) return null;
+	let type = parts.requiresArg ? "string" : "boolean";
+	let enumValues;
+	if (parts.arguments) {
+		const values = parts.arguments.split(/\s+/).filter((v) => !v.startsWith("("));
+		if (values.length > 0 && values.length <= 20) {
+			enumValues = values;
+			type = "enum";
+		}
+	}
+	const aliases = parts.shortFlag && parts.longFlag ? [`-${parts.shortFlag}`] : void 0;
+	return {
+		name,
+		type,
+		description: parts.description,
+		aliases,
+		enumValues
+	};
+}
+//#endregion
+export { parseFishCompletions };
+
+//# sourceMappingURL=fish.mjs.map

package/dist/codegen/parsers/fish.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fish.mjs","names":[],"sources":["../../../src/codegen/parsers/fish.ts"],"sourcesContent":["import type { CommandMeta, FieldMeta } from '../types.ts';\n\n/**\n * Parse fish shell completion scripts into CommandMeta.\n *\n * Fish completions use the `complete` builtin:\n *   complete -c <command> -s <short> -l <long> -d <description> -a <arguments> -r -f\n */\nexport function parseFishCompletions(text: string): CommandMeta {\n  const lines = text.split('\\n');\n  const result: CommandMeta = {\n    name: '',\n    arguments: [],\n    subcommands: [],\n  };\n\n  const subcommandMap = new Map<string, CommandMeta>();\n\n  for (const line of lines) {\n    const trimmed = line.trim();\n    if (!trimmed || trimmed.startsWith('#')) continue;\n\n    // Match: complete -c <command> [options]\n    const completeMatch = trimmed.match(/^complete\\s+/);\n    if (!completeMatch) continue;\n\n    const parts = parseCompleteLine(trimmed);\n    if (!parts) continue;\n\n    // Set root command name\n    if (!result.name && parts.command) {\n      result.name = parts.command;\n    }\n\n    // If this completion has a condition like \"__fish_seen_subcommand_from <sub>\"\n    // it belongs to a subcommand\n    const subcommandCondition = parts.condition?.match(/__fish_seen_subcommand_from\\s+(\\S+)/);\n    if (subcommandCondition) {\n      const subName = subcommandCondition[1]!;\n      let sub = subcommandMap.get(subName);\n      if (!sub) {\n        sub = { name: subName, arguments: [] };\n        subcommandMap.set(subName, sub);\n      }\n\n      if (parts.longFlag || parts.shortFlag) {\n        const field = completionToField(parts);\n        if (field) sub.arguments!.push(field);\n      }\n      continue;\n    }\n\n    // If this defines a subcommand (has -a with no flags)\n    if (parts.arguments && !parts.longFlag && !parts.shortFlag) {\n      // Arguments list could be subcommand names\n      const names = parts.arguments.split(/\\s+/);\n      for (const name of names) {\n        if (!name || name.startsWith('(')) continue;\n        if (!subcommandMap.has(name)) {\n          subcommandMap.set(name, {\n            name,\n            description: parts.description,\n            arguments: [],\n          });\n        } else if (parts.description) {\n          subcommandMap.get(name)!.description = parts.description;\n        }\n      }\n      continue;\n    }\n\n    // Global option\n    if (parts.longFlag || parts.shortFlag) {\n      const field = completionToField(parts);\n      if (field) result.arguments!.push(field);\n    }\n  }\n\n  // Add subcommands\n  for (const sub of subcommandMap.values()) {\n    if (sub.arguments!.length === 0) delete sub.arguments;\n    result.subcommands!.push(sub);\n  }\n\n  if (result.arguments!.length === 0) delete result.arguments;\n  if (result.subcommands!.length === 0) delete result.subcommands;\n\n  return result;\n}\n\ninterface CompleteParts {\n  command?: string;\n  shortFlag?: string;\n  longFlag?: string;\n  description?: string;\n  arguments?: string;\n  condition?: string;\n  requiresArg?: boolean;\n  noFiles?: boolean;\n}\n\nfunction parseCompleteLine(line: string): CompleteParts | null {\n  const parts: CompleteParts = {};\n\n  // Extract -c <command>\n  const cmdMatch = line.match(/-c\\s+(\\S+)/);\n  if (cmdMatch) parts.command = cmdMatch[1];\n\n  // Extract -s <short>\n  const shortMatch = line.match(/-s\\s+(\\S+)/);\n  if (shortMatch) parts.shortFlag = shortMatch[1];\n\n  // Extract -l <long>\n  const longMatch = line.match(/-l\\s+(\\S+)/);\n  if (longMatch) parts.longFlag = longMatch[1];\n\n  // Extract -d '<description>' or -d \"<description>\"\n  const descMatch = line.match(/-d\\s+['\"]([^'\"]+)['\"]/) || line.match(/-d\\s+(\\S+)/);\n  if (descMatch) parts.description = descMatch[1];\n\n  // Extract -a '<arguments>'\n  const argsMatch = line.match(/-a\\s+['\"]([^'\"]+)['\"]/) || line.match(/-a\\s+(\\S+)/);\n  if (argsMatch) parts.arguments = argsMatch[1];\n\n  // Extract -n '<condition>'\n  const condMatch = line.match(/-n\\s+['\"]([^'\"]+)['\"]/) || line.match(/-n\\s+(\\S+)/);\n  if (condMatch) parts.condition = condMatch[1];\n\n  // -r means requires argument\n  parts.requiresArg = /-r\\b/.test(line);\n  // -f means no file completion\n  parts.noFiles = /-f\\b/.test(line);\n\n  return parts;\n}\n\nfunction completionToField(parts: CompleteParts): FieldMeta | null {\n  const name = parts.longFlag ? parts.longFlag.replace(/-([a-z])/g, (_, c: string) => c.toUpperCase()) : parts.shortFlag || '';\n\n  if (!name) return null;\n\n  let type: FieldMeta['type'] = parts.requiresArg ? 'string' : 'boolean';\n  let enumValues: string[] | undefined;\n\n  // If -a provides specific values, treat as enum\n  if (parts.arguments) {\n    const values = parts.arguments.split(/\\s+/).filter((v) => !v.startsWith('('));\n    if (values.length > 0 && values.length <= 20) {\n      enumValues = values;\n      type = 'enum';\n    }\n  }\n\n  const aliases = parts.shortFlag && parts.longFlag ? [`-${parts.shortFlag}`] : undefined;\n\n  return {\n    name,\n    type,\n    description: parts.description,\n    aliases,\n    enumValues,\n  };\n}\n"],"mappings":"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"}

package/dist/codegen/parsers/help.d.mts

@@ -0,0 +1,15 @@
+import { CommandMeta } from "../types.mjs";
+
+//#region src/codegen/parsers/help.d.ts
+interface ParseHelpOptions {
+  /** Name to use for the root command if not detected from the help text */
+  name?: string;
+}
+/**
+ * Parse --help text output into CommandMeta.
+ * Handles common styles: GNU coreutils, Go cobra, Python argparse, Node commander/yargs, gh CLI.
+ */
+declare function parseHelpOutput(text: string, options?: ParseHelpOptions): CommandMeta;
+//#endregion
+export { parseHelpOutput };
+//# sourceMappingURL=help.d.mts.map

package/dist/codegen/parsers/help.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.mts","names":[],"sources":["../../../src/codegen/parsers/help.ts"],"mappings":";;;UAEU,gBAAA;;EAER,IAAI;AAAA;;;AAAA;AASN;iBAAgB,eAAA,CAAgB,IAAA,UAAc,OAAA,GAAU,gBAAA,GAAmB,WAAW"}

package/dist/codegen/parsers/help.mjs

@@ -0,0 +1,271 @@
+//#region src/codegen/parsers/help.ts
+/**
+* Parse --help text output into CommandMeta.
+* Handles common styles: GNU coreutils, Go cobra, Python argparse, Node commander/yargs, gh CLI.
+*/
+function parseHelpOutput(text, options) {
+	const lines = text.split("\n");
+	const result = {
+		name: options?.name || "",
+		arguments: [],
+		positionals: [],
+		subcommands: []
+	};
+	let section = "none";
+	const usageMatch = text.match(/^[Uu](?:SAGE|sage):?\s*(\S+)/m) || text.match(/^USAGE\n\s+(\S+)/m);
+	if (usageMatch && !result.name) result.name = usageMatch[1];
+	const descriptionLines = [];
+	for (const line of lines) {
+		const trimmed = line.trim();
+		if (!trimmed) {
+			if (descriptionLines.length > 0) break;
+			continue;
+		}
+		if (isSectionHeader(trimmed)) break;
+		if (descriptionLines.length === 0 || descriptionLines.length > 0) descriptionLines.push(trimmed);
+	}
+	if (descriptionLines.length > 0) result.description = descriptionLines.join(" ");
+	for (let i = 0; i < lines.length; i++) {
+		const line = lines[i];
+		const trimmed = line.trim();
+		if (!trimmed) continue;
+		const sectionType = detectSection(trimmed);
+		if (sectionType) {
+			section = sectionType;
+			continue;
+		}
+		switch (section) {
+			case "commands": {
+				const cmd = parseCommandLine(line);
+				if (cmd) result.subcommands.push(cmd);
+				break;
+			}
+			case "options": {
+				const field = parseOptionLine(line);
+				if (field) result.arguments.push(field);
+				break;
+			}
+			case "arguments":
+			case "positional": {
+				const field = parsePositionalLine(line);
+				if (field) result.positionals.push(field);
+				break;
+			}
+			case "aliases":
+				if (trimmed.match(/^\S+(?:\s+\S+)*$/)) {
+					const parts = trimmed.split(/\s+/);
+					if (parts.length >= 2) {
+						const alias = parts[parts.length - 1];
+						if (!result.aliases) result.aliases = [];
+						result.aliases.push(alias);
+					}
+				}
+				break;
+		}
+	}
+	if (result.arguments.length === 0) delete result.arguments;
+	if (result.positionals.length === 0) delete result.positionals;
+	if (result.subcommands.length === 0) delete result.subcommands;
+	if (result.aliases?.length === 0) delete result.aliases;
+	return result;
+}
+function isSectionHeader(line) {
+	return /^[A-Z][A-Za-z\s]*:?\s*$/i.test(line) || /^[A-Z][A-Z\s]+$/i.test(line);
+}
+function detectSection(line) {
+	const lower = line.toLowerCase().replace(/:$/, "").trim();
+	if (/^(?:available\s+)?(?:commands|subcommands)$/.test(lower)) return "commands";
+	if (/^(?:\w+\s+)*commands$/.test(lower) && !/alias/.test(lower)) return "commands";
+	if (/^(?:global\s+|inherited\s+)?(?:options|flags)$/.test(lower)) return "options";
+	if (/^(?:positional\s+)?(?:arguments|args|positionals)$/.test(lower)) return "positional";
+	if (/^alias(?:es)?(?:\s+commands)?$/.test(lower)) return "aliases";
+	if (lower === "usage") return "usage";
+	if (/^(?:help\s+topics|examples?|learn\s+more|json\s+fields|see\s+also|notes?)$/.test(lower)) return "skip";
+	return null;
+}
+function parseCommandLine(line) {
+	const colonMatch = line.match(/^\s{2,}([\w][\w-]*):?\s{2,}(.+)$/);
+	if (colonMatch) return {
+		name: colonMatch[1].replace(/:$/, ""),
+		description: colonMatch[2].trim()
+	};
+	const nameOnly = line.match(/^\s{2,}([\w][\w-]*):?\s*$/);
+	if (nameOnly) return { name: nameOnly[1].replace(/:$/, "") };
+	return null;
+}
+function parseOptionLine(line) {
+	const cobraMatch = line.match(/^\s{2,}(?:(-\w),\s+)?(-{1,2}[\w-]+)(?:\s+([^\s<>]+))?\s{2,}(.+)$/);
+	if (cobraMatch) {
+		const shortFlag = cobraMatch[1];
+		const longFlag = cobraMatch[2];
+		const typeHint = cobraMatch[3];
+		const description = cobraMatch[4]?.trim();
+		const name = normalizeOptionName(longFlag);
+		const aliases = shortFlag ? [normalizeAlias(shortFlag)] : void 0;
+		const { type, ambiguous } = resolveType(typeHint);
+		const { defaultValue, resolvedType } = extractDefault(description, type, ambiguous);
+		const { enumValues, resolvedType: finalType } = extractEnum(description, resolvedType);
+		return reconcileField({
+			name,
+			type: finalType,
+			description,
+			required: type === "boolean" ? void 0 : true,
+			aliases,
+			default: defaultValue,
+			enumValues,
+			ambiguous: ambiguous || void 0
+		});
+	}
+	const gnuMatch = line.match(/^\s{2,}(?:(-\w),?\s+)?(-{1,2}[\w-]+)(?:\s*[=\s]\s*(?:<([^>]+)>|\[([^\]]+)\]|(\w+)))?\s{2,}(.+)$/);
+	if (gnuMatch) {
+		const shortFlag = gnuMatch[1];
+		const longFlag = gnuMatch[2];
+		const valueName = gnuMatch[3] || gnuMatch[4] || gnuMatch[5];
+		const description = gnuMatch[6]?.trim();
+		const name = normalizeOptionName(longFlag);
+		const aliases = shortFlag ? [normalizeAlias(shortFlag)] : void 0;
+		const { type, ambiguous } = resolveType(valueName);
+		const { defaultValue, resolvedType } = extractDefault(description, type, ambiguous);
+		const { enumValues, resolvedType: finalType } = extractEnum(description, resolvedType);
+		const required = !gnuMatch[4];
+		return reconcileField({
+			name,
+			type: finalType,
+			description,
+			required: finalType === "boolean" ? void 0 : required,
+			aliases,
+			default: defaultValue,
+			enumValues,
+			ambiguous: ambiguous || void 0
+		});
+	}
+	const simple = line.match(/^\s{2,}(-{1,2}[\w-]+)\s{2,}(.+)$/);
+	if (simple) return {
+		name: normalizeOptionName(simple[1]),
+		type: "boolean",
+		description: simple[2].trim()
+	};
+	return null;
+}
+/**
+* Resolve a type hint string to a FieldMeta type.
+*/
+function resolveType(hint) {
+	if (!hint) return {
+		type: "boolean",
+		ambiguous: false
+	};
+	const lower = hint.toLowerCase();
+	if (/^(num|number|int|integer|port|count|float|duration)$/.test(lower)) return {
+		type: "number",
+		ambiguous: false
+	};
+	if (/^(str|string|text|name|path|file|dir|url|host|query|expression|template)$/.test(lower)) return {
+		type: "string",
+		ambiguous: false
+	};
+	if (/^(bool|boolean)$/.test(lower)) return {
+		type: "boolean",
+		ambiguous: false
+	};
+	if (/^(strings|fields)$/.test(lower)) return {
+		type: "array",
+		ambiguous: false
+	};
+	return {
+		type: "string",
+		ambiguous: true
+	};
+}
+/**
+* Extract default value from description text.
+*/
+function extractDefault(description, type, ambiguous) {
+	let resolvedType = type;
+	let defaultValue;
+	const defaultMatch = description?.match(/\(default[:\s]+([^)]+)\)/i) || description?.match(/\[default[:\s]+([^\]]+)\]/i);
+	if (defaultMatch) {
+		const raw = defaultMatch[1].trim();
+		if (raw === "true" || raw === "false") {
+			defaultValue = raw === "true";
+			resolvedType = "boolean";
+		} else if (/^\d+$/.test(raw)) {
+			defaultValue = parseInt(raw, 10);
+			if (resolvedType === "string" && !ambiguous) resolvedType = "number";
+		} else if (/^\d+\.\d+$/.test(raw)) {
+			defaultValue = parseFloat(raw);
+			if (resolvedType === "string" && !ambiguous) resolvedType = "number";
+		} else defaultValue = raw.replace(/^["']|["']$/g, "");
+	}
+	return {
+		defaultValue,
+		resolvedType
+	};
+}
+/**
+* Extract enum values from description text.
+*/
+function extractEnum(description, type) {
+	const choiceMatch = description?.match(/\((?:one of|choices?)[:\s]+([^)]+)\)/i);
+	if (choiceMatch) return {
+		enumValues: choiceMatch[1].split(/[,|]/).map((v) => v.trim().replace(/^["']|["']$/g, "")),
+		resolvedType: "enum"
+	};
+	const inlineMatch = description?.match(/\{(\w+(?:\|[\w-]+)+)\}/);
+	if (inlineMatch) return {
+		enumValues: inlineMatch[1].split("|"),
+		resolvedType: "enum"
+	};
+	return {
+		enumValues: void 0,
+		resolvedType: type
+	};
+}
+/**
+* Fix up a parsed field for edge cases:
+* - Enum default not in the listed values → add it
+* - Default value type doesn't match declared type → reset to type default + mark ambiguous
+*/
+function reconcileField(field) {
+	if (field.type === "enum" && field.enumValues && field.default !== void 0) {
+		const defStr = String(field.default);
+		if (!field.enumValues.includes(defStr)) field.enumValues = [...field.enumValues, defStr];
+	}
+	if (field.default !== void 0) {
+		if (field.type === "boolean" && typeof field.default !== "boolean") {
+			field.default = false;
+			field.ambiguous = true;
+		} else if (field.type === "number" && typeof field.default !== "number") {
+			field.default = 0;
+			field.ambiguous = true;
+		}
+	}
+	return field;
+}
+function parsePositionalLine(line) {
+	const match = line.match(/^\s{2,}<?(\w[\w-]*)>?\s{2,}(.+)$/);
+	if (!match) return null;
+	return {
+		name: match[1],
+		type: "string",
+		description: match[2].trim(),
+		positional: true,
+		ambiguous: true
+	};
+}
+/**
+* Strip leading dashes from a flag name, preserving kebab-case.
+*/
+function normalizeOptionName(flag) {
+	return flag.replace(/^-+/, "");
+}
+/**
+* Strip leading dash from a short alias flag (e.g. '-v' → 'v').
+*/
+function normalizeAlias(alias) {
+	return alias.replace(/^-/, "");
+}
+//#endregion
+export { parseHelpOutput };
+
+//# sourceMappingURL=help.mjs.map

package/dist/codegen/parsers/help.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.mjs","names":[],"sources":["../../../src/codegen/parsers/help.ts"],"sourcesContent":["import type { CommandMeta, FieldMeta } from '../types.ts';\n\ninterface ParseHelpOptions {\n  /** Name to use for the root command if not detected from the help text */\n  name?: string;\n}\n\ntype Section = 'none' | 'usage' | 'commands' | 'options' | 'arguments' | 'positional' | 'aliases' | 'skip';\n\n/**\n * Parse --help text output into CommandMeta.\n * Handles common styles: GNU coreutils, Go cobra, Python argparse, Node commander/yargs, gh CLI.\n */\nexport function parseHelpOutput(text: string, options?: ParseHelpOptions): CommandMeta {\n  const lines = text.split('\\n');\n  const result: CommandMeta = {\n    name: options?.name || '',\n    arguments: [],\n    positionals: [],\n    subcommands: [],\n  };\n\n  let section: Section = 'none';\n\n  // Try to extract name from USAGE line\n  // Matches: \"Usage: mycli\", \"USAGE\\n  gh <command>\", \"Usage:\\n  myapp deploy [flags]\"\n  const usageMatch = text.match(/^[Uu](?:SAGE|sage):?\\s*(\\S+)/m) || text.match(/^USAGE\\n\\s+(\\S+)/m);\n  if (usageMatch && !result.name) {\n    result.name = usageMatch[1]!;\n  }\n\n  // Extract description from lines before first section header\n  const descriptionLines: string[] = [];\n  for (const line of lines) {\n    const trimmed = line.trim();\n    if (!trimmed) {\n      if (descriptionLines.length > 0) break;\n      continue;\n    }\n    if (isSectionHeader(trimmed)) break;\n    if (descriptionLines.length === 0 || descriptionLines.length > 0) {\n      descriptionLines.push(trimmed);\n    }\n  }\n  if (descriptionLines.length > 0) {\n    result.description = descriptionLines.join(' ');\n  }\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i]!;\n    const trimmed = line.trim();\n\n    if (!trimmed) continue;\n\n    // Detect section headers\n    const sectionType = detectSection(trimmed);\n    if (sectionType) {\n      section = sectionType;\n      continue;\n    }\n\n    // Parse content based on current section\n    switch (section) {\n      case 'commands': {\n        const cmd = parseCommandLine(line);\n        if (cmd) {\n          result.subcommands!.push(cmd);\n        }\n        break;\n      }\n      case 'options': {\n        const field = parseOptionLine(line);\n        if (field) {\n          result.arguments!.push(field);\n        }\n        break;\n      }\n      case 'arguments':\n      case 'positional': {\n        const field = parsePositionalLine(line);\n        if (field) {\n          result.positionals!.push(field);\n        }\n        break;\n      }\n      case 'aliases': {\n        const aliasMatch = trimmed.match(/^\\S+(?:\\s+\\S+)*$/);\n        if (aliasMatch) {\n          // Extract alias from lines like \"gh pr ls\" — the last word is the alias name\n          const parts = trimmed.split(/\\s+/);\n          if (parts.length >= 2) {\n            const alias = parts[parts.length - 1]!;\n            if (!result.aliases) result.aliases = [];\n            result.aliases.push(alias);\n          }\n        }\n        break;\n      }\n      // 'skip', 'usage', 'none' — do nothing\n    }\n  }\n\n  // Clean up empty arrays\n  if (result.arguments!.length === 0) delete result.arguments;\n  if (result.positionals!.length === 0) delete result.positionals;\n  if (result.subcommands!.length === 0) delete result.subcommands;\n  if (result.aliases?.length === 0) delete result.aliases;\n\n  return result;\n}\n\nfunction isSectionHeader(line: string): boolean {\n  // \"USAGE\", \"FLAGS\", \"CORE COMMANDS\", \"Options:\", \"Available Commands:\"\n  return /^[A-Z][A-Za-z\\s]*:?\\s*$/i.test(line) || /^[A-Z][A-Z\\s]+$/i.test(line);\n}\n\nfunction detectSection(line: string): Section | null {\n  const lower = line.toLowerCase().replace(/:$/, '').trim();\n\n  // Commands: \"commands\", \"available commands\", \"subcommands\",\n  // and gh-style: \"core commands\", \"general commands\", \"additional commands\", etc.\n  // Match anything ending in \"commands\" or \"subcommands\", but NOT \"alias commands\"\n  if (/^(?:available\\s+)?(?:commands|subcommands)$/.test(lower)) return 'commands';\n  if (/^(?:\\w+\\s+)*commands$/.test(lower) && !/alias/.test(lower)) return 'commands';\n\n  // Options/Flags: \"options\", \"flags\", \"global options\", \"inherited flags\"\n  if (/^(?:global\\s+|inherited\\s+)?(?:options|flags)$/.test(lower)) return 'options';\n\n  // Positional arguments\n  if (/^(?:positional\\s+)?(?:arguments|args|positionals)$/.test(lower)) return 'positional';\n\n  // Aliases section\n  if (/^alias(?:es)?(?:\\s+commands)?$/.test(lower)) return 'aliases';\n\n  // Usage section\n  if (lower === 'usage') return 'usage';\n\n  // Sections to skip entirely\n  if (/^(?:help\\s+topics|examples?|learn\\s+more|json\\s+fields|see\\s+also|notes?)$/.test(lower)) return 'skip';\n\n  return null;\n}\n\nfunction parseCommandLine(line: string): CommandMeta | null {\n  // Pattern: \"  command-name:    Description text\" (gh-style with colon)\n  const colonMatch = line.match(/^\\s{2,}([\\w][\\w-]*):?\\s{2,}(.+)$/);\n  if (colonMatch) {\n    const name = colonMatch[1]!.replace(/:$/, '');\n    return {\n      name,\n      description: colonMatch[2]!.trim(),\n    };\n  }\n\n  // Pattern: \"  command-name\"  (no description)\n  const nameOnly = line.match(/^\\s{2,}([\\w][\\w-]*):?\\s*$/);\n  if (nameOnly) {\n    return { name: nameOnly[1]!.replace(/:$/, '') };\n  }\n\n  return null;\n}\n\nfunction parseOptionLine(line: string): FieldMeta | null {\n  // Try cobra-style first: \"  -s, --flag type    Description\" or \"      --flag type    Description\"\n  // The type hint can be a bare word (string, int) or a complex placeholder ([HOST/]OWNER/REPO)\n  // but NOT angle-bracket values like <string> (those fall through to GNU pattern)\n  const cobraMatch = line.match(/^\\s{2,}(?:(-\\w),\\s+)?(-{1,2}[\\w-]+)(?:\\s+([^\\s<>]+))?\\s{2,}(.+)$/);\n\n  if (cobraMatch) {\n    const shortFlag = cobraMatch[1];\n    const longFlag = cobraMatch[2]!;\n    const typeHint = cobraMatch[3];\n    const description = cobraMatch[4]?.trim();\n\n    const name = normalizeOptionName(longFlag);\n    const aliases = shortFlag ? [normalizeAlias(shortFlag)] : undefined;\n\n    const { type, ambiguous } = resolveType(typeHint);\n\n    const { defaultValue, resolvedType } = extractDefault(description, type, ambiguous);\n    const { enumValues, resolvedType: finalType } = extractEnum(description, resolvedType);\n\n    return reconcileField({\n      name,\n      type: finalType,\n      description,\n      required: type === 'boolean' ? undefined : true,\n      aliases,\n      default: defaultValue,\n      enumValues,\n      ambiguous: ambiguous || undefined,\n    });\n  }\n\n  // GNU/argparse-style: \"  -s, --long-name <value>    Description\"\n  //                      \"  --long-name=<value>        Description\"\n  const gnuMatch = line.match(/^\\s{2,}(?:(-\\w),?\\s+)?(-{1,2}[\\w-]+)(?:\\s*[=\\s]\\s*(?:<([^>]+)>|\\[([^\\]]+)\\]|(\\w+)))?\\s{2,}(.+)$/);\n\n  if (gnuMatch) {\n    const shortFlag = gnuMatch[1];\n    const longFlag = gnuMatch[2]!;\n    const valueName = gnuMatch[3] || gnuMatch[4] || gnuMatch[5];\n    const description = gnuMatch[6]?.trim();\n\n    const name = normalizeOptionName(longFlag);\n    const aliases = shortFlag ? [normalizeAlias(shortFlag)] : undefined;\n\n    const { type, ambiguous } = resolveType(valueName);\n\n    const { defaultValue, resolvedType } = extractDefault(description, type, ambiguous);\n    const { enumValues, resolvedType: finalType } = extractEnum(description, resolvedType);\n\n    // [value] means optional, <value> means required\n    const required = !gnuMatch[4];\n\n    return reconcileField({\n      name,\n      type: finalType,\n      description,\n      required: finalType === 'boolean' ? undefined : required,\n      aliases,\n      default: defaultValue,\n      enumValues,\n      ambiguous: ambiguous || undefined,\n    });\n  }\n\n  // Simplest pattern: \"  --name    Description\"\n  const simple = line.match(/^\\s{2,}(-{1,2}[\\w-]+)\\s{2,}(.+)$/);\n  if (simple) {\n    const name = normalizeOptionName(simple[1]!);\n    return {\n      name,\n      type: 'boolean',\n      description: simple[2]!.trim(),\n    };\n  }\n\n  return null;\n}\n\n/**\n * Resolve a type hint string to a FieldMeta type.\n */\nfunction resolveType(hint: string | undefined): { type: FieldMeta['type']; ambiguous: boolean } {\n  if (!hint) return { type: 'boolean', ambiguous: false };\n\n  const lower = hint.toLowerCase();\n\n  if (/^(num|number|int|integer|port|count|float|duration)$/.test(lower)) {\n    return { type: 'number', ambiguous: false };\n  }\n  if (/^(str|string|text|name|path|file|dir|url|host|query|expression|template)$/.test(lower)) {\n    return { type: 'string', ambiguous: false };\n  }\n  if (/^(bool|boolean)$/.test(lower)) {\n    return { type: 'boolean', ambiguous: false };\n  }\n  if (/^(strings|fields)$/.test(lower)) {\n    return { type: 'array', ambiguous: false };\n  }\n\n  // Unknown type hint — default to string but mark ambiguous\n  return { type: 'string', ambiguous: true };\n}\n\n/**\n * Extract default value from description text.\n */\nfunction extractDefault(\n  description: string | undefined,\n  type: FieldMeta['type'],\n  ambiguous: boolean,\n): { defaultValue: unknown; resolvedType: FieldMeta['type'] } {\n  let resolvedType = type;\n  let defaultValue: unknown;\n\n  const defaultMatch = description?.match(/\\(default[:\\s]+([^)]+)\\)/i) || description?.match(/\\[default[:\\s]+([^\\]]+)\\]/i);\n  if (defaultMatch) {\n    const raw = defaultMatch[1]!.trim();\n    if (raw === 'true' || raw === 'false') {\n      defaultValue = raw === 'true';\n      resolvedType = 'boolean';\n    } else if (/^\\d+$/.test(raw)) {\n      defaultValue = parseInt(raw, 10);\n      if (resolvedType === 'string' && !ambiguous) resolvedType = 'number';\n    } else if (/^\\d+\\.\\d+$/.test(raw)) {\n      defaultValue = parseFloat(raw);\n      if (resolvedType === 'string' && !ambiguous) resolvedType = 'number';\n    } else {\n      defaultValue = raw.replace(/^[\"']|[\"']$/g, '');\n    }\n  }\n\n  return { defaultValue, resolvedType };\n}\n\n/**\n * Extract enum values from description text.\n */\nfunction extractEnum(\n  description: string | undefined,\n  type: FieldMeta['type'],\n): { enumValues: string[] | undefined; resolvedType: FieldMeta['type'] } {\n  // Explicit choices: (choices: a, b, c) or (one of: a|b|c)\n  const choiceMatch = description?.match(/\\((?:one of|choices?)[:\\s]+([^)]+)\\)/i);\n  if (choiceMatch) {\n    const values = choiceMatch[1]!.split(/[,|]/).map((v) => v.trim().replace(/^[\"']|[\"']$/g, ''));\n    return { enumValues: values, resolvedType: 'enum' };\n  }\n\n  // Inline enum in description: {open|closed|merged|all} (gh-style)\n  const inlineMatch = description?.match(/\\{(\\w+(?:\\|[\\w-]+)+)\\}/);\n  if (inlineMatch) {\n    const values = inlineMatch[1]!.split('|');\n    return { enumValues: values, resolvedType: 'enum' };\n  }\n\n  return { enumValues: undefined, resolvedType: type };\n}\n\n/**\n * Fix up a parsed field for edge cases:\n * - Enum default not in the listed values → add it\n * - Default value type doesn't match declared type → reset to type default + mark ambiguous\n */\nfunction reconcileField(field: FieldMeta): FieldMeta {\n  // If enum has a default that isn't in the value list, add it\n  if (field.type === 'enum' && field.enumValues && field.default !== undefined) {\n    const defStr = String(field.default);\n    if (!field.enumValues.includes(defStr)) {\n      field.enumValues = [...field.enumValues, defStr];\n    }\n  }\n\n  // If the default value doesn't match the declared type, reset + mark ambiguous\n  if (field.default !== undefined) {\n    if (field.type === 'boolean' && typeof field.default !== 'boolean') {\n      field.default = false;\n      field.ambiguous = true;\n    } else if (field.type === 'number' && typeof field.default !== 'number') {\n      field.default = 0;\n      field.ambiguous = true;\n    }\n  }\n\n  return field;\n}\n\nfunction parsePositionalLine(line: string): FieldMeta | null {\n  // Pattern: \"  <name>    Description\"\n  // Pattern: \"  name      Description\"\n  const match = line.match(/^\\s{2,}<?(\\w[\\w-]*)>?\\s{2,}(.+)$/);\n  if (!match) return null;\n\n  return {\n    name: match[1]!,\n    type: 'string',\n    description: match[2]!.trim(),\n    positional: true,\n    ambiguous: true,\n  };\n}\n\n/**\n * Strip leading dashes from a flag name, preserving kebab-case.\n */\nfunction normalizeOptionName(flag: string): string {\n  return flag.replace(/^-+/, '');\n}\n\n/**\n * Strip leading dash from a short alias flag (e.g. '-v' → 'v').\n */\nfunction normalizeAlias(alias: string): string {\n  return alias.replace(/^-/, '');\n}\n"],"mappings":"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"}

package/dist/codegen/parsers/merge.d.mts

@@ -0,0 +1,14 @@
+import { CommandMeta } from "../types.mjs";
+
+//#region src/codegen/parsers/merge.d.ts
+/**
+ * Deep-merge multiple CommandMeta from different sources.
+ * Deduplicates fields, resolves conflicts, and combines subcommands.
+ *
+ * Later sources take precedence for descriptions and types,
+ * unless the earlier source was more specific (non-ambiguous).
+ */
+declare function mergeCommandMeta(...sources: CommandMeta[]): CommandMeta;
+//#endregion
+export { mergeCommandMeta };
+//# sourceMappingURL=merge.d.mts.map

package/dist/codegen/parsers/merge.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.mts","names":[],"sources":["../../../src/codegen/parsers/merge.ts"],"mappings":";;;;;AASA;;;;;iBAAgB,gBAAA,IAAoB,OAAA,EAAS,WAAA,KAAgB,WAAW"}