padrone 1.8.2 → 2.0.0

package/dist/codegen/parsers/merge.mjs

@@ -0,0 +1,76 @@
+//#region src/codegen/parsers/merge.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).
+*/
+function mergeCommandMeta(...sources) {
+	if (sources.length === 0) return { name: "" };
+	if (sources.length === 1) return sources[0];
+	const result = { name: "" };
+	for (const source of sources) {
+		if (source.name && !result.name) result.name = source.name;
+		if (source.description) result.description = source.description;
+		if (source.aliases) result.aliases = [.../* @__PURE__ */ new Set([...result.aliases || [], ...source.aliases])];
+		if (source.examples) result.examples = [.../* @__PURE__ */ new Set([...result.examples || [], ...source.examples])];
+		if (source.deprecated !== void 0) result.deprecated = source.deprecated;
+		if (source.arguments) result.arguments = mergeFields(result.arguments || [], source.arguments);
+		if (source.positionals) result.positionals = mergeFields(result.positionals || [], source.positionals);
+		if (source.subcommands) result.subcommands = mergeSubcommands(result.subcommands || [], source.subcommands);
+	}
+	if (result.aliases?.length === 0) delete result.aliases;
+	if (result.examples?.length === 0) delete result.examples;
+	if (result.arguments?.length === 0) delete result.arguments;
+	if (result.positionals?.length === 0) delete result.positionals;
+	if (result.subcommands?.length === 0) delete result.subcommands;
+	return result;
+}
+/**
+* Merge two arrays of FieldMeta by name.
+* Later fields take precedence unless earlier was non-ambiguous.
+*/
+function mergeFields(existing, incoming) {
+	const map = /* @__PURE__ */ new Map();
+	for (const field of existing) map.set(field.name, { ...field });
+	for (const field of incoming) {
+		const prev = map.get(field.name);
+		if (!prev) {
+			map.set(field.name, { ...field });
+			continue;
+		}
+		const merged = { ...prev };
+		if (field.type !== "unknown") {
+			if (prev.ambiguous || !field.ambiguous) {
+				merged.type = field.type;
+				merged.ambiguous = field.ambiguous;
+			}
+		}
+		if (field.description) merged.description = field.description;
+		if (field.default !== void 0) merged.default = field.default;
+		if (field.required !== void 0) merged.required = field.required;
+		if (field.aliases) merged.aliases = [.../* @__PURE__ */ new Set([...prev.aliases || [], ...field.aliases])];
+		if (field.enumValues) merged.enumValues = [.../* @__PURE__ */ new Set([...prev.enumValues || [], ...field.enumValues])];
+		if (field.items) merged.items = field.items;
+		map.set(field.name, merged);
+	}
+	return [...map.values()];
+}
+/**
+* Merge two arrays of CommandMeta by name, recursively.
+*/
+function mergeSubcommands(existing, incoming) {
+	const map = /* @__PURE__ */ new Map();
+	for (const cmd of existing) map.set(cmd.name, cmd);
+	for (const cmd of incoming) {
+		const prev = map.get(cmd.name);
+		if (!prev) map.set(cmd.name, cmd);
+		else map.set(cmd.name, mergeCommandMeta(prev, cmd));
+	}
+	return [...map.values()];
+}
+//#endregion
+export { mergeCommandMeta };
+
+//# sourceMappingURL=merge.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"merge.mjs","names":[],"sources":["../../../src/codegen/parsers/merge.ts"],"sourcesContent":["import type { CommandMeta, FieldMeta } from '../types.ts';\n\n/**\n * Deep-merge multiple CommandMeta from different sources.\n * Deduplicates fields, resolves conflicts, and combines subcommands.\n *\n * Later sources take precedence for descriptions and types,\n * unless the earlier source was more specific (non-ambiguous).\n */\nexport function mergeCommandMeta(...sources: CommandMeta[]): CommandMeta {\n  if (sources.length === 0) {\n    return { name: '' };\n  }\n\n  if (sources.length === 1) {\n    return sources[0]!;\n  }\n\n  const result: CommandMeta = { name: '' };\n\n  for (const source of sources) {\n    // Name: first non-empty wins\n    if (source.name && !result.name) {\n      result.name = source.name;\n    }\n\n    // Description: last non-empty wins\n    if (source.description) {\n      result.description = source.description;\n    }\n\n    // Aliases: merge and deduplicate\n    if (source.aliases) {\n      result.aliases = [...new Set([...(result.aliases || []), ...source.aliases])];\n    }\n\n    // Examples: merge and deduplicate\n    if (source.examples) {\n      result.examples = [...new Set([...(result.examples || []), ...source.examples])];\n    }\n\n    // Deprecated: last truthy wins\n    if (source.deprecated !== undefined) {\n      result.deprecated = source.deprecated;\n    }\n\n    // Arguments: merge by name\n    if (source.arguments) {\n      result.arguments = mergeFields(result.arguments || [], source.arguments);\n    }\n\n    // Positionals: merge by name\n    if (source.positionals) {\n      result.positionals = mergeFields(result.positionals || [], source.positionals);\n    }\n\n    // Subcommands: merge recursively by name\n    if (source.subcommands) {\n      result.subcommands = mergeSubcommands(result.subcommands || [], source.subcommands);\n    }\n  }\n\n  // Clean up empty arrays\n  if (result.aliases?.length === 0) delete result.aliases;\n  if (result.examples?.length === 0) delete result.examples;\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\n  return result;\n}\n\n/**\n * Merge two arrays of FieldMeta by name.\n * Later fields take precedence unless earlier was non-ambiguous.\n */\nfunction mergeFields(existing: FieldMeta[], incoming: FieldMeta[]): FieldMeta[] {\n  const map = new Map<string, FieldMeta>();\n\n  for (const field of existing) {\n    map.set(field.name, { ...field });\n  }\n\n  for (const field of incoming) {\n    const prev = map.get(field.name);\n    if (!prev) {\n      map.set(field.name, { ...field });\n      continue;\n    }\n\n    // Merge the fields\n    const merged: FieldMeta = { ...prev };\n\n    // Type: prefer non-ambiguous source\n    if (field.type !== 'unknown') {\n      if (prev.ambiguous || !field.ambiguous) {\n        merged.type = field.type;\n        merged.ambiguous = field.ambiguous;\n      }\n    }\n\n    // Description: last non-empty wins\n    if (field.description) {\n      merged.description = field.description;\n    }\n\n    // Default: last non-undefined wins\n    if (field.default !== undefined) {\n      merged.default = field.default;\n    }\n\n    // Required: last defined wins\n    if (field.required !== undefined) {\n      merged.required = field.required;\n    }\n\n    // Aliases: merge and deduplicate\n    if (field.aliases) {\n      merged.aliases = [...new Set([...(prev.aliases || []), ...field.aliases])];\n    }\n\n    // Enum values: merge and deduplicate\n    if (field.enumValues) {\n      merged.enumValues = [...new Set([...(prev.enumValues || []), ...field.enumValues])];\n    }\n\n    // Items: last non-empty wins\n    if (field.items) {\n      merged.items = field.items;\n    }\n\n    map.set(field.name, merged);\n  }\n\n  return [...map.values()];\n}\n\n/**\n * Merge two arrays of CommandMeta by name, recursively.\n */\nfunction mergeSubcommands(existing: CommandMeta[], incoming: CommandMeta[]): CommandMeta[] {\n  const map = new Map<string, CommandMeta>();\n\n  for (const cmd of existing) {\n    map.set(cmd.name, cmd);\n  }\n\n  for (const cmd of incoming) {\n    const prev = map.get(cmd.name);\n    if (!prev) {\n      map.set(cmd.name, cmd);\n    } else {\n      map.set(cmd.name, mergeCommandMeta(prev, cmd));\n    }\n  }\n\n  return [...map.values()];\n}\n"],"mappings":";;;;;;;;AASA,SAAgB,iBAAiB,GAAG,SAAqC;CACvE,IAAI,QAAQ,WAAW,GACrB,OAAO,EAAE,MAAM,GAAG;CAGpB,IAAI,QAAQ,WAAW,GACrB,OAAO,QAAQ;CAGjB,MAAM,SAAsB,EAAE,MAAM,GAAG;CAEvC,KAAK,MAAM,UAAU,SAAS;EAE5B,IAAI,OAAO,QAAQ,CAAC,OAAO,MACzB,OAAO,OAAO,OAAO;EAIvB,IAAI,OAAO,aACT,OAAO,cAAc,OAAO;EAI9B,IAAI,OAAO,SACT,OAAO,UAAU,CAAC,mBAAG,IAAI,IAAI,CAAC,GAAI,OAAO,WAAW,CAAC,GAAI,GAAG,OAAO,OAAO,CAAC,CAAC;EAI9E,IAAI,OAAO,UACT,OAAO,WAAW,CAAC,mBAAG,IAAI,IAAI,CAAC,GAAI,OAAO,YAAY,CAAC,GAAI,GAAG,OAAO,QAAQ,CAAC,CAAC;EAIjF,IAAI,OAAO,eAAe,KAAA,GACxB,OAAO,aAAa,OAAO;EAI7B,IAAI,OAAO,WACT,OAAO,YAAY,YAAY,OAAO,aAAa,CAAC,GAAG,OAAO,SAAS;EAIzE,IAAI,OAAO,aACT,OAAO,cAAc,YAAY,OAAO,eAAe,CAAC,GAAG,OAAO,WAAW;EAI/E,IAAI,OAAO,aACT,OAAO,cAAc,iBAAiB,OAAO,eAAe,CAAC,GAAG,OAAO,WAAW;CAEtF;CAGA,IAAI,OAAO,SAAS,WAAW,GAAG,OAAO,OAAO;CAChD,IAAI,OAAO,UAAU,WAAW,GAAG,OAAO,OAAO;CACjD,IAAI,OAAO,WAAW,WAAW,GAAG,OAAO,OAAO;CAClD,IAAI,OAAO,aAAa,WAAW,GAAG,OAAO,OAAO;CACpD,IAAI,OAAO,aAAa,WAAW,GAAG,OAAO,OAAO;CAEpD,OAAO;AACT;;;;;AAMA,SAAS,YAAY,UAAuB,UAAoC;CAC9E,MAAM,sBAAM,IAAI,IAAuB;CAEvC,KAAK,MAAM,SAAS,UAClB,IAAI,IAAI,MAAM,MAAM,EAAE,GAAG,MAAM,CAAC;CAGlC,KAAK,MAAM,SAAS,UAAU;EAC5B,MAAM,OAAO,IAAI,IAAI,MAAM,IAAI;EAC/B,IAAI,CAAC,MAAM;GACT,IAAI,IAAI,MAAM,MAAM,EAAE,GAAG,MAAM,CAAC;GAChC;EACF;EAGA,MAAM,SAAoB,EAAE,GAAG,KAAK;EAGpC,IAAI,MAAM,SAAS;OACb,KAAK,aAAa,CAAC,MAAM,WAAW;IACtC,OAAO,OAAO,MAAM;IACpB,OAAO,YAAY,MAAM;GAC3B;;EAIF,IAAI,MAAM,aACR,OAAO,cAAc,MAAM;EAI7B,IAAI,MAAM,YAAY,KAAA,GACpB,OAAO,UAAU,MAAM;EAIzB,IAAI,MAAM,aAAa,KAAA,GACrB,OAAO,WAAW,MAAM;EAI1B,IAAI,MAAM,SACR,OAAO,UAAU,CAAC,mBAAG,IAAI,IAAI,CAAC,GAAI,KAAK,WAAW,CAAC,GAAI,GAAG,MAAM,OAAO,CAAC,CAAC;EAI3E,IAAI,MAAM,YACR,OAAO,aAAa,CAAC,mBAAG,IAAI,IAAI,CAAC,GAAI,KAAK,cAAc,CAAC,GAAI,GAAG,MAAM,UAAU,CAAC,CAAC;EAIpF,IAAI,MAAM,OACR,OAAO,QAAQ,MAAM;EAGvB,IAAI,IAAI,MAAM,MAAM,MAAM;CAC5B;CAEA,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC;AACzB;;;;AAKA,SAAS,iBAAiB,UAAyB,UAAwC;CACzF,MAAM,sBAAM,IAAI,IAAyB;CAEzC,KAAK,MAAM,OAAO,UAChB,IAAI,IAAI,IAAI,MAAM,GAAG;CAGvB,KAAK,MAAM,OAAO,UAAU;EAC1B,MAAM,OAAO,IAAI,IAAI,IAAI,IAAI;EAC7B,IAAI,CAAC,MACH,IAAI,IAAI,IAAI,MAAM,GAAG;OAErB,IAAI,IAAI,IAAI,MAAM,iBAAiB,MAAM,GAAG,CAAC;CAEjD;CAEA,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC;AACzB"}

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

@@ -0,0 +1,16 @@
+import { CommandMeta } from "../types.mjs";
+
+//#region src/codegen/parsers/zsh.d.ts
+/**
+ * Parse zsh completion function definitions into CommandMeta.
+ *
+ * Zsh completions typically use _arguments or compadd:
+ *   _arguments \
+ *     '-v[verbose mode]' \
+ *     '--output=[output file]:filename:_files' \
+ *     '1:command:(start stop restart)'
+ */
+declare function parseZshCompletions(text: string): CommandMeta;
+//#endregion
+export { parseZshCompletions };
+//# sourceMappingURL=zsh.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zsh.d.mts","names":[],"sources":["../../../src/codegen/parsers/zsh.ts"],"mappings":";;;;;AAWA;;;;AAA8D;;;iBAA9C,mBAAA,CAAoB,IAAA,WAAe,WAAW"}

package/dist/codegen/parsers/zsh.mjs

@@ -0,0 +1,161 @@
+//#region src/codegen/parsers/zsh.ts
+/**
+* Parse zsh completion function definitions into CommandMeta.
+*
+* Zsh completions typically use _arguments or compadd:
+*   _arguments \
+*     '-v[verbose mode]' \
+*     '--output=[output file]:filename:_files' \
+*     '1:command:(start stop restart)'
+*/
+function parseZshCompletions(text) {
+	const result = {
+		name: "",
+		arguments: [],
+		positionals: [],
+		subcommands: []
+	};
+	const compdefMatch = text.match(/#compdef\s+(\S+)/);
+	if (compdefMatch) result.name = compdefMatch[1];
+	else {
+		const funcMatch = text.match(/^_(\w+)\s*\(\)/m);
+		if (funcMatch) result.name = funcMatch[1];
+	}
+	const argumentsBlocks = findArgumentsBlocks(text);
+	for (const block of argumentsBlocks) {
+		const specs = parseArgumentSpecs(block);
+		for (const spec of specs) if (spec.positional) result.positionals.push(spec);
+		else result.arguments.push(spec);
+	}
+	const subcommands = findSubcommands(text);
+	result.subcommands.push(...subcommands);
+	if (result.arguments.length === 0) delete result.arguments;
+	if (result.positionals.length === 0) delete result.positionals;
+	if (result.subcommands.length === 0) delete result.subcommands;
+	return result;
+}
+/**
+* Extract _arguments blocks from zsh completion text.
+* Handles backslash continuation lines.
+*/
+function findArgumentsBlocks(text) {
+	const blocks = [];
+	const lines = text.replace(/\\\n\s*/g, " ").split("\n");
+	for (const line of lines) {
+		const match = line.match(/_arguments\s+(.+)/);
+		if (match) blocks.push(match[1]);
+	}
+	return blocks;
+}
+/**
+* Parse individual argument specs from an _arguments line.
+*/
+function parseArgumentSpecs(block) {
+	const results = [];
+	const specs = extractQuotedStrings(block);
+	for (const spec of specs) {
+		const field = parseZshSpec(spec);
+		if (field) results.push(field);
+	}
+	return results;
+}
+/**
+* Extract single-quoted strings from an _arguments block.
+*/
+function extractQuotedStrings(text) {
+	const strings = [];
+	const regex = /'([^']+)'/g;
+	let match;
+	while ((match = regex.exec(text)) !== null) strings.push(match[1]);
+	return strings;
+}
+/**
+* Parse a single zsh argument spec.
+*
+* Formats:
+*   '-v[verbose mode]'                              → boolean flag
+*   '--output=[output file]:filename:_files'         → string with value
+*   '(-v --verbose)'{-v,--verbose}'[verbose mode]'   → flag with aliases
+*   '*--flag[repeatable]'                            → array
+*   '1:command:(start stop restart)'                 → positional enum
+*   ':filename:_files'                               → positional
+*/
+function parseZshSpec(spec) {
+	const positionalMatch = spec.match(/^(\d+)?:([^:]*):(.*)$/);
+	if (positionalMatch) {
+		const description = positionalMatch[2] || void 0;
+		const enumMatch = positionalMatch[3]?.match(/^\(([^)]+)\)$/);
+		if (enumMatch) {
+			const values = enumMatch[1].split(/\s+/);
+			return {
+				name: description?.toLowerCase().replace(/\s+/g, "_") || `arg${positionalMatch[1] || "0"}`,
+				type: "enum",
+				enumValues: values,
+				description,
+				positional: true
+			};
+		}
+		return {
+			name: description?.toLowerCase().replace(/\s+/g, "_") || `arg${positionalMatch[1] || "0"}`,
+			type: "string",
+			description,
+			positional: true,
+			ambiguous: true
+		};
+	}
+	const repeatable = spec.startsWith("*");
+	const flagMatch = (repeatable ? spec.slice(1) : spec).match(/^(-{1,2}[\w-]+)(?:=?)(?:\[([^\]]*)\])?(?::([^:]*):?(.*))?$/);
+	if (!flagMatch) return null;
+	const rawName = flagMatch[1];
+	const description = flagMatch[2] || void 0;
+	const valueName = flagMatch[3] || void 0;
+	const name = rawName.replace(/^-+/, "").replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+	let type = rawName.includes("=") || !!valueName ? "string" : "boolean";
+	if (repeatable) type = "array";
+	let enumValues;
+	if (flagMatch[4]) {
+		const enumMatch = flagMatch[4].match(/^\(([^)]+)\)$/);
+		if (enumMatch) {
+			enumValues = enumMatch[1].split(/\s+/);
+			type = "enum";
+		}
+	}
+	return {
+		name,
+		type,
+		description,
+		enumValues
+	};
+}
+/**
+* Find subcommand definitions from _describe calls or case statements.
+*/
+function findSubcommands(text) {
+	const subcommands = [];
+	const seen = /* @__PURE__ */ new Set();
+	const describeRegex = /\(([^)]+)\)/g;
+	const joined = text.replace(/\\\n\s*/g, " ");
+	let match;
+	while ((match = describeRegex.exec(joined)) !== null) {
+		const content = match[1];
+		const entries = content.match(/'([^']+)'/g) || content.match(/"([^"]+)"/g);
+		if (!entries) continue;
+		for (const entry of entries) {
+			const parts = entry.replace(/^['"]|['"]$/g, "").split(":");
+			if (parts.length >= 2 && /^[\w-]+$/.test(parts[0])) {
+				const name = parts[0];
+				if (seen.has(name)) continue;
+				seen.add(name);
+				subcommands.push({
+					name,
+					description: parts.slice(1).join(":")
+				});
+			}
+		}
+	}
+	return subcommands;
+}
+//#endregion
+export { parseZshCompletions };
+
+//# sourceMappingURL=zsh.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zsh.mjs","names":[],"sources":["../../../src/codegen/parsers/zsh.ts"],"sourcesContent":["import type { CommandMeta, FieldMeta } from '../types.ts';\n\n/**\n * Parse zsh completion function definitions into CommandMeta.\n *\n * Zsh completions typically use _arguments or compadd:\n *   _arguments \\\n *     '-v[verbose mode]' \\\n *     '--output=[output file]:filename:_files' \\\n *     '1:command:(start stop restart)'\n */\nexport function parseZshCompletions(text: string): CommandMeta {\n  const result: CommandMeta = {\n    name: '',\n    arguments: [],\n    positionals: [],\n    subcommands: [],\n  };\n\n  // Try to detect command name from function name: _command() or #compdef command\n  const compdefMatch = text.match(/#compdef\\s+(\\S+)/);\n  if (compdefMatch) {\n    result.name = compdefMatch[1]!;\n  } else {\n    const funcMatch = text.match(/^_(\\w+)\\s*\\(\\)/m);\n    if (funcMatch) {\n      result.name = funcMatch[1]!;\n    }\n  }\n\n  // Find _arguments blocks\n  const argumentsBlocks = findArgumentsBlocks(text);\n\n  for (const block of argumentsBlocks) {\n    const specs = parseArgumentSpecs(block);\n    for (const spec of specs) {\n      if (spec.positional) {\n        result.positionals!.push(spec);\n      } else {\n        result.arguments!.push(spec);\n      }\n    }\n  }\n\n  // Find subcommand definitions from case statements or _describe\n  const subcommands = findSubcommands(text);\n  result.subcommands!.push(...subcommands);\n\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\n  return result;\n}\n\n/**\n * Extract _arguments blocks from zsh completion text.\n * Handles backslash continuation lines.\n */\nfunction findArgumentsBlocks(text: string): string[] {\n  const blocks: string[] = [];\n\n  // Join continuation lines\n  const joined = text.replace(/\\\\\\n\\s*/g, ' ');\n  const lines = joined.split('\\n');\n\n  for (const line of lines) {\n    const match = line.match(/_arguments\\s+(.+)/);\n    if (match) {\n      blocks.push(match[1]!);\n    }\n  }\n\n  return blocks;\n}\n\n/**\n * Parse individual argument specs from an _arguments line.\n */\nfunction parseArgumentSpecs(block: string): FieldMeta[] {\n  const results: FieldMeta[] = [];\n\n  // Split into individual specs (quoted strings)\n  const specs = extractQuotedStrings(block);\n\n  for (const spec of specs) {\n    const field = parseZshSpec(spec);\n    if (field) results.push(field);\n  }\n\n  return results;\n}\n\n/**\n * Extract single-quoted strings from an _arguments block.\n */\nfunction extractQuotedStrings(text: string): string[] {\n  const strings: string[] = [];\n  const regex = /'([^']+)'/g;\n  let match: RegExpExecArray | null;\n\n  while ((match = regex.exec(text)) !== null) {\n    strings.push(match[1]!);\n  }\n\n  return strings;\n}\n\n/**\n * Parse a single zsh argument spec.\n *\n * Formats:\n *   '-v[verbose mode]'                              → boolean flag\n *   '--output=[output file]:filename:_files'         → string with value\n *   '(-v --verbose)'{-v,--verbose}'[verbose mode]'   → flag with aliases\n *   '*--flag[repeatable]'                            → array\n *   '1:command:(start stop restart)'                 → positional enum\n *   ':filename:_files'                               → positional\n */\nfunction parseZshSpec(spec: string): FieldMeta | null {\n  // Positional argument: 'N:description:action' or ':description:action'\n  const positionalMatch = spec.match(/^(\\d+)?:([^:]*):(.*)$/);\n  if (positionalMatch) {\n    const description = positionalMatch[2] || undefined;\n\n    // Check for enum values in (val1 val2 val3)\n    const enumMatch = positionalMatch[3]?.match(/^\\(([^)]+)\\)$/);\n    if (enumMatch) {\n      const values = enumMatch[1]!.split(/\\s+/);\n      return {\n        name: description?.toLowerCase().replace(/\\s+/g, '_') || `arg${positionalMatch[1] || '0'}`,\n        type: 'enum',\n        enumValues: values,\n        description,\n        positional: true,\n      };\n    }\n\n    return {\n      name: description?.toLowerCase().replace(/\\s+/g, '_') || `arg${positionalMatch[1] || '0'}`,\n      type: 'string',\n      description,\n      positional: true,\n      ambiguous: true,\n    };\n  }\n\n  // Flag argument\n  const repeatable = spec.startsWith('*');\n  const flagSpec = repeatable ? spec.slice(1) : spec;\n\n  // Extract flag name and description\n  // Pattern: --flag=[description]:value_description:action\n  // Pattern: -f[description]\n  const flagMatch = flagSpec.match(/^(-{1,2}[\\w-]+)(?:=?)(?:\\[([^\\]]*)\\])?(?::([^:]*):?(.*))?$/);\n  if (!flagMatch) return null;\n\n  const rawName = flagMatch[1]!;\n  const description = flagMatch[2] || undefined;\n  const valueName = flagMatch[3] || undefined;\n\n  const name = rawName.replace(/^-+/, '').replace(/-([a-z])/g, (_, c: string) => c.toUpperCase());\n  const hasValue = rawName.includes('=') || !!valueName;\n  let type: FieldMeta['type'] = hasValue ? 'string' : 'boolean';\n\n  if (repeatable) type = 'array';\n\n  // Check for enum values\n  let enumValues: string[] | undefined;\n  if (flagMatch[4]) {\n    const enumMatch = flagMatch[4].match(/^\\(([^)]+)\\)$/);\n    if (enumMatch) {\n      enumValues = enumMatch[1]!.split(/\\s+/);\n      type = 'enum';\n    }\n  }\n\n  return {\n    name,\n    type,\n    description,\n    enumValues,\n  };\n}\n\n/**\n * Find subcommand definitions from _describe calls or case statements.\n */\nfunction findSubcommands(text: string): CommandMeta[] {\n  const subcommands: CommandMeta[] = [];\n  const seen = new Set<string>();\n\n  // Look for _describe patterns: _describe 'command' commands\n  // where commands is an array like: ('start:start the service' 'stop:stop the service')\n  const describeRegex = /\\(([^)]+)\\)/g;\n  const joined = text.replace(/\\\\\\n\\s*/g, ' ');\n\n  // Look for arrays of 'name:description' patterns near _describe\n  let match: RegExpExecArray | null;\n  while ((match = describeRegex.exec(joined)) !== null) {\n    const content = match[1]!;\n    const entries = content.match(/'([^']+)'/g) || content.match(/\"([^\"]+)\"/g);\n    if (!entries) continue;\n\n    for (const entry of entries) {\n      const clean = entry.replace(/^['\"]|['\"]$/g, '');\n      const parts = clean.split(':');\n      if (parts.length >= 2 && /^[\\w-]+$/.test(parts[0]!)) {\n        const name = parts[0]!;\n        if (seen.has(name)) continue;\n        seen.add(name);\n        subcommands.push({\n          name,\n          description: parts.slice(1).join(':'),\n        });\n      }\n    }\n  }\n\n  return subcommands;\n}\n"],"mappings":"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"}

package/dist/codegen/schema-to-code.d.mts

@@ -0,0 +1,24 @@
+import { FieldMeta } from "./types.mjs";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/codegen/schema-to-code.d.ts
+interface SchemaToCodeResult {
+  /** The generated Zod source code */
+  code: string;
+  /** Imports needed (e.g. ['z']) */
+  imports: string[];
+}
+/**
+ * Generate Zod source code from a Standard Schema instance by introspecting
+ * its `~standard.jsonSchema` interface.
+ */
+declare function schemaToCode(schema: StandardSchemaV1): SchemaToCodeResult;
+/**
+ * Build a real Zod schema from FieldMeta objects.
+ * Returns the schema as Zod source code, since we can't dynamically import Zod here
+ * (codegen has no runtime dependency on padrone's main entry point).
+ */
+declare function fieldMetaToCode(fields: FieldMeta[]): SchemaToCodeResult;
+//#endregion
+export { fieldMetaToCode, schemaToCode };
+//# sourceMappingURL=schema-to-code.d.mts.map

package/dist/codegen/schema-to-code.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-to-code.d.mts","names":[],"sources":["../../src/codegen/schema-to-code.ts"],"mappings":";;;;UAIU,kBAAA;;EAER,IAAA;EAF0B;EAI1B,OAAO;AAAA;AAAA;AAkDT;;;AAlDS,iBAkDO,YAAA,CAAa,MAAA,EAAQ,gBAAA,GAAmB,kBAAkB;;;;;AAAA;iBAkC1D,eAAA,CAAgB,MAAA,EAAQ,SAAA,KAAc,kBAAkB"}

package/dist/codegen/schema-to-code.mjs

@@ -0,0 +1,147 @@
+import { getJsonSchema } from "../core/args.mjs";
+//#region src/codegen/schema-to-code.ts
+/**
+* Convert a JSON Schema property to Zod code.
+*/
+function jsonSchemaPropertyToZod(prop, required, ambiguous) {
+	let code;
+	const type = prop.type;
+	const enumValues = prop.enum;
+	if (enumValues && enumValues.length > 0) code = `z.enum([${enumValues.map((v) => JSON.stringify(v)).join(", ")}])`;
+	else if (type === "string") code = "z.string()";
+	else if (type === "number" || type === "integer") code = "z.number()";
+	else if (type === "boolean") code = "z.boolean()";
+	else if (type === "array") {
+		const items = prop.items;
+		code = `${items ? jsonSchemaPropertyToZod(items, true) : "z.unknown()"}.array()`;
+	} else code = "z.unknown()";
+	if (prop.default !== void 0) code += `.default(${JSON.stringify(prop.default)})`;
+	else if (!required) code += ".optional()";
+	if (prop.description) code += `.describe(${JSON.stringify(prop.description)})`;
+	if (ambiguous) code += " /* TODO: verify type */";
+	return code;
+}
+/**
+* Generate Zod source code from a Standard Schema instance by introspecting
+* its `~standard.jsonSchema` interface.
+*/
+function schemaToCode(schema) {
+	try {
+		return jsonSchemaToCode(getJsonSchema(schema));
+	} catch {
+		return {
+			code: "z.unknown()",
+			imports: ["z"]
+		};
+	}
+}
+function jsonSchemaToCode(jsonSchema) {
+	if (jsonSchema.type === "object" && jsonSchema.properties) {
+		const properties = jsonSchema.properties;
+		const required = new Set(jsonSchema.required || []);
+		return {
+			code: `z.object({\n${Object.entries(properties).map(([key, prop]) => {
+				return `  ${key}: ${jsonSchemaPropertyToZod(prop, required.has(key))},`;
+			}).join("\n")}\n})`,
+			imports: ["z"]
+		};
+	}
+	return {
+		code: jsonSchemaPropertyToZod(jsonSchema, true),
+		imports: ["z"]
+	};
+}
+/**
+* Build a real Zod schema from FieldMeta objects.
+* Returns the schema as Zod source code, since we can't dynamically import Zod here
+* (codegen has no runtime dependency on padrone's main entry point).
+*/
+function fieldMetaToCode(fields) {
+	return {
+		code: `z.object({\n${fields.map((field) => {
+			let code;
+			switch (field.type) {
+				case "string":
+					code = "z.string()";
+					break;
+				case "number":
+					code = "z.number()";
+					break;
+				case "boolean":
+					code = "z.boolean()";
+					break;
+				case "array":
+					code = `${(field.items || "string") === "number" ? "z.number()" : "z.string()"}.array()`;
+					break;
+				case "enum":
+					if (field.enumValues && field.enumValues.length > 0) code = `z.enum([${field.enumValues.map((v) => JSON.stringify(v)).join(", ")}])`;
+					else code = "z.string()";
+					break;
+				default:
+					code = "z.unknown()";
+					break;
+			}
+			if (field.default !== void 0) code += `.default(${JSON.stringify(field.default)})`;
+			else if (!field.required) code += ".optional()";
+			if (field.description) code += `.describe(${JSON.stringify(field.description)})`;
+			if (field.ambiguous) code += " /* TODO: verify type */";
+			return `  ${needsQuoting(field.name) ? JSON.stringify(field.name) : field.name}: ${code},`;
+		}).join("\n")}\n})`,
+		imports: ["z"]
+	};
+}
+const JS_RESERVED = /* @__PURE__ */ new Set([
+	"break",
+	"case",
+	"catch",
+	"continue",
+	"debugger",
+	"default",
+	"delete",
+	"do",
+	"else",
+	"export",
+	"extends",
+	"finally",
+	"for",
+	"function",
+	"if",
+	"import",
+	"in",
+	"instanceof",
+	"new",
+	"return",
+	"super",
+	"switch",
+	"this",
+	"throw",
+	"try",
+	"typeof",
+	"var",
+	"void",
+	"while",
+	"with",
+	"yield",
+	"class",
+	"const",
+	"enum",
+	"let",
+	"static",
+	"implements",
+	"interface",
+	"package",
+	"private",
+	"protected",
+	"public",
+	"await",
+	"async"
+]);
+/** Returns true if the name needs quoting to be a valid JS object key. */
+function needsQuoting(name) {
+	if (JS_RESERVED.has(name)) return true;
+	return !/^[a-zA-Z_$][\w$]*$/.test(name);
+}
+//#endregion
+export { fieldMetaToCode, schemaToCode };
+
+//# sourceMappingURL=schema-to-code.mjs.map

package/dist/codegen/schema-to-code.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-to-code.mjs","names":[],"sources":["../../src/codegen/schema-to-code.ts"],"sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { getJsonSchema } from '../core/args.ts';\nimport type { FieldMeta } from './types.ts';\n\ninterface SchemaToCodeResult {\n  /** The generated Zod source code */\n  code: string;\n  /** Imports needed (e.g. ['z']) */\n  imports: string[];\n}\n\n/**\n * Convert a JSON Schema property to Zod code.\n */\nfunction jsonSchemaPropertyToZod(prop: Record<string, any>, required: boolean, ambiguous?: boolean): string {\n  let code: string;\n\n  const type = prop.type as string | undefined;\n  const enumValues = prop.enum as unknown[] | undefined;\n\n  if (enumValues && enumValues.length > 0) {\n    const values = enumValues.map((v) => JSON.stringify(v)).join(', ');\n    code = `z.enum([${values}])`;\n  } else if (type === 'string') {\n    code = 'z.string()';\n  } else if (type === 'number' || type === 'integer') {\n    code = 'z.number()';\n  } else if (type === 'boolean') {\n    code = 'z.boolean()';\n  } else if (type === 'array') {\n    const items = prop.items as Record<string, any> | undefined;\n    const itemCode = items ? jsonSchemaPropertyToZod(items, true) : 'z.unknown()';\n    code = `${itemCode}.array()`;\n  } else {\n    code = 'z.unknown()';\n  }\n\n  if (prop.default !== undefined) {\n    code += `.default(${JSON.stringify(prop.default)})`;\n  } else if (!required) {\n    code += '.optional()';\n  }\n\n  if (prop.description) {\n    code += `.describe(${JSON.stringify(prop.description)})`;\n  }\n\n  if (ambiguous) {\n    code += ' /* TODO: verify type */';\n  }\n\n  return code;\n}\n\n/**\n * Generate Zod source code from a Standard Schema instance by introspecting\n * its `~standard.jsonSchema` interface.\n */\nexport function schemaToCode(schema: StandardSchemaV1): SchemaToCodeResult {\n  try {\n    const jsonSchema = getJsonSchema(schema as any) as Record<string, any>;\n    return jsonSchemaToCode(jsonSchema);\n  } catch {\n    return { code: 'z.unknown()', imports: ['z'] };\n  }\n}\n\nfunction jsonSchemaToCode(jsonSchema: Record<string, any>): SchemaToCodeResult {\n  if (jsonSchema.type === 'object' && jsonSchema.properties) {\n    const properties = jsonSchema.properties as Record<string, any>;\n    const required = new Set((jsonSchema.required as string[]) || []);\n\n    const entries = Object.entries(properties).map(([key, prop]) => {\n      const isRequired = required.has(key);\n      const zodCode = jsonSchemaPropertyToZod(prop as Record<string, any>, isRequired);\n      return `  ${key}: ${zodCode},`;\n    });\n\n    const code = `z.object({\\n${entries.join('\\n')}\\n})`;\n    return { code, imports: ['z'] };\n  }\n\n  // Fallback for non-object schemas\n  const code = jsonSchemaPropertyToZod(jsonSchema, true);\n  return { code, imports: ['z'] };\n}\n\n/**\n * Build a real Zod schema from FieldMeta objects.\n * Returns the schema as Zod source code, since we can't dynamically import Zod here\n * (codegen has no runtime dependency on padrone's main entry point).\n */\nexport function fieldMetaToCode(fields: FieldMeta[]): SchemaToCodeResult {\n  const entries = fields.map((field) => {\n    let code: string;\n\n    switch (field.type) {\n      case 'string':\n        code = 'z.string()';\n        break;\n      case 'number':\n        code = 'z.number()';\n        break;\n      case 'boolean':\n        code = 'z.boolean()';\n        break;\n      case 'array': {\n        const itemType = field.items || 'string';\n        const itemCode = itemType === 'number' ? 'z.number()' : 'z.string()';\n        code = `${itemCode}.array()`;\n        break;\n      }\n      case 'enum':\n        if (field.enumValues && field.enumValues.length > 0) {\n          const values = field.enumValues.map((v) => JSON.stringify(v)).join(', ');\n          code = `z.enum([${values}])`;\n        } else {\n          code = 'z.string()';\n        }\n        break;\n      default:\n        code = 'z.unknown()';\n        break;\n    }\n\n    if (field.default !== undefined) {\n      code += `.default(${JSON.stringify(field.default)})`;\n    } else if (!field.required) {\n      code += '.optional()';\n    }\n\n    if (field.description) {\n      code += `.describe(${JSON.stringify(field.description)})`;\n    }\n\n    if (field.ambiguous) {\n      code += ' /* TODO: verify type */';\n    }\n\n    const key = needsQuoting(field.name) ? JSON.stringify(field.name) : field.name;\n    return `  ${key}: ${code},`;\n  });\n\n  const code = `z.object({\\n${entries.join('\\n')}\\n})`;\n  return { code, imports: ['z'] };\n}\n\nconst JS_RESERVED = new Set([\n  'break',\n  'case',\n  'catch',\n  'continue',\n  'debugger',\n  'default',\n  'delete',\n  'do',\n  'else',\n  'export',\n  'extends',\n  'finally',\n  'for',\n  'function',\n  'if',\n  'import',\n  'in',\n  'instanceof',\n  'new',\n  'return',\n  'super',\n  'switch',\n  'this',\n  'throw',\n  'try',\n  'typeof',\n  'var',\n  'void',\n  'while',\n  'with',\n  'yield',\n  'class',\n  'const',\n  'enum',\n  'let',\n  'static',\n  'implements',\n  'interface',\n  'package',\n  'private',\n  'protected',\n  'public',\n  'await',\n  'async',\n]);\n\n/** Returns true if the name needs quoting to be a valid JS object key. */\nfunction needsQuoting(name: string): boolean {\n  if (JS_RESERVED.has(name)) return true;\n  // Must be a valid identifier: starts with letter/$/_, contains only word chars\n  return !/^[a-zA-Z_$][\\w$]*$/.test(name);\n}\n"],"mappings":"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"}

package/dist/codegen/template.d.mts

@@ -0,0 +1,18 @@
+//#region src/codegen/template.d.ts
+/**
+ * Lightweight string template engine.
+ *
+ * Syntax:
+ * - `{{var}}` — interpolation
+ * - `{{#arr}}...{{/arr}}` — iteration (`.` refers to current item)
+ * - `{{#bool}}...{{/bool}}` — conditional blocks
+ * - `{{>partial}}` — include a named sub-template
+ */
+type TemplateRenderer = (data: Record<string, unknown>, partials?: Record<string, string>) => string;
+/**
+ * Compile a template string into a reusable render function.
+ */
+declare function template(text: string): TemplateRenderer;
+//#endregion
+export { template };
+//# sourceMappingURL=template.d.mts.map

package/dist/codegen/template.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.mts","names":[],"sources":["../../src/codegen/template.ts"],"mappings":";;;;;;;;;;KAUK,gBAAA,IAAoB,IAAA,EAAM,MAAA,mBAAyB,QAAA,GAAW,MAAM;AAAgB;AAKzF;;AALyF,iBAKzE,QAAA,CAAS,IAAA,WAAe,gBAAgB"}

package/dist/codegen/template.mjs

@@ -0,0 +1,37 @@
+//#region src/codegen/template.ts
+/**
+* Compile a template string into a reusable render function.
+*/
+function template(text) {
+	return (data, partials) => {
+		return render(text, data, partials);
+	};
+}
+function render(text, data, partials) {
+	let result = text;
+	result = result.replace(/\{\{#(\w+)\}\}([\s\S]*?)\{\{\/\1\}\}/g, (_match, key, body) => {
+		const value = data[key];
+		if (value === void 0 || value === null || value === false) return "";
+		if (Array.isArray(value)) return value.map((item) => {
+			if (typeof item === "object" && item !== null) return render(body, item, partials);
+			return body.replace(/\{\{\.\}\}/g, String(item));
+		}).join("");
+		if (typeof value === "object") return render(body, value, partials);
+		return render(body, data, partials);
+	});
+	if (partials) result = result.replace(/\{\{>(\w+)\}\}/g, (_match, name) => {
+		const partialText = partials[name];
+		if (!partialText) return "";
+		return render(partialText, data, partials);
+	});
+	result = result.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
+		const value = data[key];
+		if (value === void 0 || value === null) return "";
+		return String(value);
+	});
+	return result;
+}
+//#endregion
+export { template };
+
+//# sourceMappingURL=template.mjs.map

package/dist/codegen/template.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.mjs","names":[],"sources":["../../src/codegen/template.ts"],"sourcesContent":["/**\n * Lightweight string template engine.\n *\n * Syntax:\n * - `{{var}}` — interpolation\n * - `{{#arr}}...{{/arr}}` — iteration (`.` refers to current item)\n * - `{{#bool}}...{{/bool}}` — conditional blocks\n * - `{{>partial}}` — include a named sub-template\n */\n\ntype TemplateRenderer = (data: Record<string, unknown>, partials?: Record<string, string>) => string;\n\n/**\n * Compile a template string into a reusable render function.\n */\nexport function template(text: string): TemplateRenderer {\n  return (data: Record<string, unknown>, partials?: Record<string, string>) => {\n    return render(text, data, partials);\n  };\n}\n\nfunction render(text: string, data: Record<string, unknown>, partials?: Record<string, string>): string {\n  let result = text;\n\n  // Process block sections: {{#key}}...{{/key}}\n  result = result.replace(/\\{\\{#(\\w+)\\}\\}([\\s\\S]*?)\\{\\{\\/\\1\\}\\}/g, (_match, key: string, body: string) => {\n    const value = data[key];\n\n    if (value === undefined || value === null || value === false) {\n      return '';\n    }\n\n    if (Array.isArray(value)) {\n      return value\n        .map((item) => {\n          if (typeof item === 'object' && item !== null) {\n            return render(body, item as Record<string, unknown>, partials);\n          }\n          // For primitive items, replace {{.}} with the item value\n          return body.replace(/\\{\\{\\.\\}\\}/g, String(item));\n        })\n        .join('');\n    }\n\n    // Truthy conditional\n    if (typeof value === 'object') {\n      return render(body, value as Record<string, unknown>, partials);\n    }\n    return render(body, data, partials);\n  });\n\n  // Process partials: {{>partialName}}\n  if (partials) {\n    result = result.replace(/\\{\\{>(\\w+)\\}\\}/g, (_match, name: string) => {\n      const partialText = partials[name];\n      if (!partialText) return '';\n      return render(partialText, data, partials);\n    });\n  }\n\n  // Process interpolation: {{var}}\n  result = result.replace(/\\{\\{(\\w+)\\}\\}/g, (_match, key: string) => {\n    const value = data[key];\n    if (value === undefined || value === null) return '';\n    return String(value);\n  });\n\n  return result;\n}\n"],"mappings":";;;;AAeA,SAAgB,SAAS,MAAgC;CACvD,QAAQ,MAA+B,aAAsC;EAC3E,OAAO,OAAO,MAAM,MAAM,QAAQ;CACpC;AACF;AAEA,SAAS,OAAO,MAAc,MAA+B,UAA2C;CACtG,IAAI,SAAS;CAGb,SAAS,OAAO,QAAQ,0CAA0C,QAAQ,KAAa,SAAiB;EACtG,MAAM,QAAQ,KAAK;EAEnB,IAAI,UAAU,KAAA,KAAa,UAAU,QAAQ,UAAU,OACrD,OAAO;EAGT,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,MACJ,KAAK,SAAS;GACb,IAAI,OAAO,SAAS,YAAY,SAAS,MACvC,OAAO,OAAO,MAAM,MAAiC,QAAQ;GAG/D,OAAO,KAAK,QAAQ,eAAe,OAAO,IAAI,CAAC;EACjD,CAAC,CAAC,CACD,KAAK,EAAE;EAIZ,IAAI,OAAO,UAAU,UACnB,OAAO,OAAO,MAAM,OAAkC,QAAQ;EAEhE,OAAO,OAAO,MAAM,MAAM,QAAQ;CACpC,CAAC;CAGD,IAAI,UACF,SAAS,OAAO,QAAQ,oBAAoB,QAAQ,SAAiB;EACnE,MAAM,cAAc,SAAS;EAC7B,IAAI,CAAC,aAAa,OAAO;EACzB,OAAO,OAAO,aAAa,MAAM,QAAQ;CAC3C,CAAC;CAIH,SAAS,OAAO,QAAQ,mBAAmB,QAAQ,QAAgB;EACjE,MAAM,QAAQ,KAAK;EACnB,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM,OAAO;EAClD,OAAO,OAAO,KAAK;CACrB,CAAC;CAED,OAAO;AACT"}