padrone 1.9.0 → 2.0.0

package/dist/codegen/generators/command-file.d.mts

@@ -0,0 +1,25 @@
+import { CodeBuilder, CommandMeta, GeneratorContext } from "../types.mjs";
+
+//#region src/codegen/generators/command-file.d.ts
+interface CommandFileOptions {
+  /** Wrap config: generates .wrap() instead of .action(). */
+  wrap?: {
+    /** The external command to wrap (e.g. 'gh'). */command: string; /** Fixed args preceding the options (e.g. ['pr', 'list']). */
+    args?: string[];
+  };
+  /** Subcommand references to wire into this command via .command() calls. */
+  subcommands?: {
+    name: string;
+    varName: string;
+    importPath: string;
+    aliases?: string[];
+  }[];
+}
+/**
+ * Generate a single Padrone command file from a CommandMeta.
+ * Produces a named function that chains .configure(), .arguments(), and .wrap() or .action().
+ */
+declare function generateCommandFile(command: CommandMeta, ctx: GeneratorContext, options?: CommandFileOptions): CodeBuilder;
+//#endregion
+export { CommandFileOptions, generateCommandFile };
+//# sourceMappingURL=command-file.d.mts.map

package/dist/codegen/generators/command-file.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-file.d.mts","names":[],"sources":["../../../src/codegen/generators/command-file.ts"],"mappings":";;;UA+DiB,kBAAA;EAAkB;EAEjC,IAAA;IAEE,gDAAA,OAAA,UAKF;IAHE,IAAA;EAAA;EAG6C;EAA/C,WAAA;IAAgB,IAAA;IAAc,OAAA;IAAiB,UAAA;IAAoB,OAAA;EAAA;AAAA;;;;;iBAOrD,mBAAA,CAAoB,OAAA,EAAS,WAAA,EAAa,GAAA,EAAK,gBAAA,EAAkB,OAAA,GAAU,kBAAA,GAAqB,WAAA"}

package/dist/codegen/generators/command-file.mjs

@@ -0,0 +1,130 @@
+import { fieldMetaToCode } from "../schema-to-code.mjs";
+//#region src/codegen/generators/command-file.ts
+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"
+]);
+/** Convert a command name to a safe JS identifier (camelCase, reserved-word-safe). */
+function toSafeIdentifier(name) {
+	const camel = name.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+	if (/^\d/.test(camel)) return `_${camel}`;
+	if (JS_RESERVED.has(camel)) return `_${camel}`;
+	return camel;
+}
+/** Build the exported function name for a command (e.g. 'repo' → 'repoCommand'). */
+function toCommandFunctionName(name) {
+	return `${toSafeIdentifier(name)}Command`;
+}
+/**
+* Generate a single Padrone command file from a CommandMeta.
+* Produces a named function that chains .configure(), .arguments(), and .wrap() or .action().
+*/
+function generateCommandFile(command, ctx, options) {
+	const code = ctx.createCodeBuilder();
+	const hasArgs = command.arguments && command.arguments.length > 0 || command.positionals && command.positionals.length > 0;
+	if (hasArgs) code.import("z", "zod/v4");
+	code.importType("AnyPadroneBuilder", "padrone");
+	if (options?.subcommands) for (const sub of options.subcommands) code.import([sub.varName], sub.importPath);
+	code.line();
+	if (command.deprecated) {
+		const msg = typeof command.deprecated === "string" ? command.deprecated : "This command is deprecated";
+		code.comment(`@deprecated ${msg}`);
+	}
+	const fnName = toCommandFunctionName(command.name);
+	code.line(`export function ${fnName}<T extends AnyPadroneBuilder>(cmd: T) {`);
+	code.line(`  return cmd`);
+	const configParts = [];
+	if (command.description) configParts.push(`description: ${JSON.stringify(command.description)}`);
+	if (command.deprecated) configParts.push(`deprecated: ${typeof command.deprecated === "string" ? JSON.stringify(command.deprecated) : "true"}`);
+	if (configParts.length > 0) code.line(`    .configure({ ${configParts.join(", ")} })`);
+	if (hasArgs) {
+		const allFields = [...command.arguments || [], ...command.positionals || []];
+		const schemaCode = fieldMetaToCode(allFields);
+		const positionalNames = (command.positionals || []).map((p) => p.type === "array" ? `'...${p.name}'` : `'${p.name}'`);
+		const fieldsMap = buildFieldsMap(allFields);
+		if (positionalNames.length > 0 || fieldsMap) {
+			code.line(`    .arguments(${schemaCode.code}, {`);
+			if (positionalNames.length > 0) code.line(`      positional: [${positionalNames.join(", ")}],`);
+			if (fieldsMap) code.line(`      fields: ${fieldsMap},`);
+			code.line(`    })`);
+		} else code.line(`    .arguments(${schemaCode.code})`);
+	}
+	if (options?.subcommands) for (const sub of options.subcommands) {
+		const nameArg = sub.aliases && sub.aliases.length > 0 ? `[${JSON.stringify(sub.name)}, ${sub.aliases.map((a) => JSON.stringify(a)).join(", ")}]` : JSON.stringify(sub.name);
+		code.line(`    .command(${nameArg}, ${sub.varName})`);
+	}
+	if (options?.wrap) {
+		const wrapParts = [];
+		wrapParts.push(`command: ${JSON.stringify(options.wrap.command)}`);
+		if (options.wrap.args && options.wrap.args.length > 0) wrapParts.push(`args: [${options.wrap.args.map((a) => JSON.stringify(a)).join(", ")}]`);
+		code.line(`    .wrap({ ${wrapParts.join(", ")} })`);
+	} else code.line(`    .action((args) => { /* TODO */ })`);
+	code.line(`}`);
+	return code;
+}
+function buildFieldsMap(fields) {
+	const entries = [];
+	for (const field of fields) if (field.aliases && field.aliases.length > 0) {
+		const singleChar = field.aliases.filter((a) => a.replace(/^-+/, "").length === 1).map((a) => a.replace(/^-+/, ""));
+		const multiChar = field.aliases.filter((a) => a.replace(/^-+/, "").length > 1).map((a) => a.replace(/^-+/, ""));
+		const key = /^[a-zA-Z_$][\w$]*$/.test(field.name) ? field.name : JSON.stringify(field.name);
+		const parts = [];
+		if (singleChar.length > 0) {
+			const flags = singleChar.length === 1 ? JSON.stringify(singleChar[0]) : `[${singleChar.map((a) => JSON.stringify(a)).join(", ")}]`;
+			parts.push(`flags: ${flags}`);
+		}
+		if (multiChar.length > 0) {
+			const alias = multiChar.length === 1 ? JSON.stringify(multiChar[0]) : `[${multiChar.map((a) => JSON.stringify(a)).join(", ")}]`;
+			parts.push(`alias: ${alias}`);
+		}
+		if (parts.length > 0) entries.push(`${key}: { ${parts.join(", ")} }`);
+	}
+	if (entries.length === 0) return null;
+	return `{ ${entries.join(", ")} }`;
+}
+//#endregion
+export { generateCommandFile, toCommandFunctionName, toSafeIdentifier };
+
+//# sourceMappingURL=command-file.mjs.map

package/dist/codegen/generators/command-file.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-file.mjs","names":[],"sources":["../../../src/codegen/generators/command-file.ts"],"sourcesContent":["import { fieldMetaToCode } from '../schema-to-code.ts';\nimport type { CodeBuilder, CommandMeta, FieldMeta, GeneratorContext } from '../types.ts';\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/** Convert a command name to a safe JS identifier (camelCase, reserved-word-safe). */\nexport function toSafeIdentifier(name: string): string {\n  const camel = name.replace(/-([a-z])/g, (_, c: string) => c.toUpperCase());\n  if (/^\\d/.test(camel)) return `_${camel}`;\n  if (JS_RESERVED.has(camel)) return `_${camel}`;\n  return camel;\n}\n\n/** Build the exported function name for a command (e.g. 'repo' → 'repoCommand'). */\nexport function toCommandFunctionName(name: string): string {\n  return `${toSafeIdentifier(name)}Command`;\n}\n\nexport interface CommandFileOptions {\n  /** Wrap config: generates .wrap() instead of .action(). */\n  wrap?: {\n    /** The external command to wrap (e.g. 'gh'). */\n    command: string;\n    /** Fixed args preceding the options (e.g. ['pr', 'list']). */\n    args?: string[];\n  };\n  /** Subcommand references to wire into this command via .command() calls. */\n  subcommands?: { name: string; varName: string; importPath: string; aliases?: string[] }[];\n}\n\n/**\n * Generate a single Padrone command file from a CommandMeta.\n * Produces a named function that chains .configure(), .arguments(), and .wrap() or .action().\n */\nexport function generateCommandFile(command: CommandMeta, ctx: GeneratorContext, options?: CommandFileOptions): CodeBuilder {\n  const code = ctx.createCodeBuilder();\n\n  const hasArgs = (command.arguments && command.arguments.length > 0) || (command.positionals && command.positionals.length > 0);\n\n  if (hasArgs) {\n    code.import('z', 'zod/v4');\n  }\n\n  code.importType('AnyPadroneBuilder', 'padrone');\n\n  // Import subcommand modules\n  if (options?.subcommands) {\n    for (const sub of options.subcommands) {\n      code.import([sub.varName], sub.importPath);\n    }\n  }\n\n  code.line();\n\n  if (command.deprecated) {\n    const msg = typeof command.deprecated === 'string' ? command.deprecated : 'This command is deprecated';\n    code.comment(`@deprecated ${msg}`);\n  }\n\n  const fnName = toCommandFunctionName(command.name);\n  code.line(`export function ${fnName}<T extends AnyPadroneBuilder>(cmd: T) {`);\n  code.line(`  return cmd`);\n\n  // .configure()\n  const configParts: string[] = [];\n  if (command.description) {\n    configParts.push(`description: ${JSON.stringify(command.description)}`);\n  }\n  if (command.deprecated) {\n    configParts.push(`deprecated: ${typeof command.deprecated === 'string' ? JSON.stringify(command.deprecated) : 'true'}`);\n  }\n  if (configParts.length > 0) {\n    code.line(`    .configure({ ${configParts.join(', ')} })`);\n  }\n\n  // .arguments()\n  if (hasArgs) {\n    const allFields = [...(command.arguments || []), ...(command.positionals || [])];\n    const schemaCode = fieldMetaToCode(allFields);\n\n    const positionalNames = (command.positionals || []).map((p) => (p.type === 'array' ? `'...${p.name}'` : `'${p.name}'`));\n    const fieldsMap = buildFieldsMap(allFields);\n    const hasMetaOptions = positionalNames.length > 0 || fieldsMap;\n\n    if (hasMetaOptions) {\n      code.line(`    .arguments(${schemaCode.code}, {`);\n      if (positionalNames.length > 0) {\n        code.line(`      positional: [${positionalNames.join(', ')}],`);\n      }\n      if (fieldsMap) {\n        code.line(`      fields: ${fieldsMap},`);\n      }\n      code.line(`    })`);\n    } else {\n      code.line(`    .arguments(${schemaCode.code})`);\n    }\n  }\n\n  // .command() calls for subcommands\n  if (options?.subcommands) {\n    for (const sub of options.subcommands) {\n      const nameArg =\n        sub.aliases && sub.aliases.length > 0\n          ? `[${JSON.stringify(sub.name)}, ${sub.aliases.map((a) => JSON.stringify(a)).join(', ')}]`\n          : JSON.stringify(sub.name);\n      code.line(`    .command(${nameArg}, ${sub.varName})`);\n    }\n  }\n\n  // .wrap() or .action()\n  if (options?.wrap) {\n    const wrapParts: string[] = [];\n    wrapParts.push(`command: ${JSON.stringify(options.wrap.command)}`);\n    if (options.wrap.args && options.wrap.args.length > 0) {\n      wrapParts.push(`args: [${options.wrap.args.map((a) => JSON.stringify(a)).join(', ')}]`);\n    }\n    code.line(`    .wrap({ ${wrapParts.join(', ')} })`);\n  } else {\n    code.line(`    .action((args) => { /* TODO */ })`);\n  }\n\n  code.line(`}`);\n\n  return code;\n}\n\nfunction buildFieldsMap(fields: FieldMeta[]): string | null {\n  const entries: string[] = [];\n  for (const field of fields) {\n    if (field.aliases && field.aliases.length > 0) {\n      // Split into flags (single-char) and aliases (multi-char)\n      const singleChar = field.aliases.filter((a) => a.replace(/^-+/, '').length === 1).map((a) => a.replace(/^-+/, ''));\n      const multiChar = field.aliases.filter((a) => a.replace(/^-+/, '').length > 1).map((a) => a.replace(/^-+/, ''));\n\n      const key = /^[a-zA-Z_$][\\w$]*$/.test(field.name) ? field.name : JSON.stringify(field.name);\n      const parts: string[] = [];\n      if (singleChar.length > 0) {\n        const flags = singleChar.length === 1 ? JSON.stringify(singleChar[0]) : `[${singleChar.map((a) => JSON.stringify(a)).join(', ')}]`;\n        parts.push(`flags: ${flags}`);\n      }\n      if (multiChar.length > 0) {\n        const alias = multiChar.length === 1 ? JSON.stringify(multiChar[0]) : `[${multiChar.map((a) => JSON.stringify(a)).join(', ')}]`;\n        parts.push(`alias: ${alias}`);\n      }\n      if (parts.length > 0) {\n        entries.push(`${key}: { ${parts.join(', ')} }`);\n      }\n    }\n  }\n  if (entries.length === 0) return null;\n  return `{ ${entries.join(', ')} }`;\n}\n"],"mappings":"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"}

package/dist/codegen/generators/command-tree.d.mts

@@ -0,0 +1,17 @@
+import { CommandMeta, GeneratorContext } from "../types.mjs";
+
+//#region src/codegen/generators/command-tree.d.ts
+interface CommandTreeOptions {
+  /** When set, generates .wrap() calls instead of .action(). */
+  wrap?: {
+    /** The external command being wrapped (e.g. 'gh'). */command: string;
+  };
+}
+/**
+ * Walk a CommandMeta tree and emit one file per command plus a root program file.
+ * Maps nested subcommands to a directory structure.
+ */
+declare function generateCommandTree(root: CommandMeta, ctx: GeneratorContext, options?: CommandTreeOptions): void;
+//#endregion
+export { CommandTreeOptions, generateCommandTree };
+//# sourceMappingURL=command-tree.d.mts.map

package/dist/codegen/generators/command-tree.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-tree.d.mts","names":[],"sources":["../../../src/codegen/generators/command-tree.ts"],"mappings":";;;UAKiB,kBAAA;;EAEf,IAAA;IAFiC,sDAI/B,OAAO;EAAA;AAAA;AAQX;;;;AAAA,iBAAgB,mBAAA,CAAoB,IAAA,EAAM,WAAA,EAAa,GAAA,EAAK,gBAAA,EAAkB,OAAA,GAAU,kBAAA"}

package/dist/codegen/generators/command-tree.mjs

@@ -0,0 +1,72 @@
+import { fieldMetaToCode } from "../schema-to-code.mjs";
+import { generateCommandFile, toCommandFunctionName } from "./command-file.mjs";
+//#region src/codegen/generators/command-tree.ts
+/**
+* Walk a CommandMeta tree and emit one file per command plus a root program file.
+* Maps nested subcommands to a directory structure.
+*/
+function generateCommandTree(root, ctx, options) {
+	const rootImports = [];
+	function walkCommands(cmd, dirPath, parentArgs) {
+		if (cmd === root) {
+			for (const sub of cmd.subcommands || []) walkCommands(sub, "commands", []);
+			return;
+		}
+		const filePath = `${dirPath}/${cmd.name}.ts`;
+		const childRefs = [];
+		if (cmd.subcommands && cmd.subcommands.length > 0) for (const sub of cmd.subcommands) {
+			walkCommands(sub, `${dirPath}/${cmd.name}`, [...parentArgs, cmd.name]);
+			childRefs.push({
+				name: sub.name,
+				varName: toCommandFunctionName(sub.name),
+				importPath: `./${cmd.name}/${sub.name}.ts`,
+				aliases: sub.aliases
+			});
+		}
+		const fileOptions = {};
+		if (options?.wrap) fileOptions.wrap = {
+			command: options.wrap.command,
+			args: [...parentArgs, cmd.name]
+		};
+		if (childRefs.length > 0) fileOptions.subcommands = childRefs;
+		const code = generateCommandFile(cmd, ctx, Object.keys(fileOptions).length > 0 ? fileOptions : void 0);
+		ctx.emitter.addFile(filePath, code.build());
+		rootImports.push({
+			name: cmd.name,
+			varName: toCommandFunctionName(cmd.name),
+			path: `./${filePath.replace(/\.ts$/, ".ts")}`,
+			aliases: cmd.aliases
+		});
+	}
+	walkCommands(root, "", []);
+	const program = ctx.createCodeBuilder();
+	const rootHasArgs = root.arguments && root.arguments.length > 0 || root.positionals && root.positionals.length > 0;
+	if (rootHasArgs) program.import("z", "zod/v4");
+	program.import(["createPadrone"], "padrone");
+	const directChildren = rootImports.filter((imp) => imp.path.split("/").length <= 3);
+	for (const imp of directChildren) program.import([imp.varName], imp.path);
+	program.line();
+	program.line(`const program = createPadrone(${JSON.stringify(root.name)})`);
+	const configParts = [];
+	if (root.description) configParts.push(`description: ${JSON.stringify(root.description)}`);
+	if (configParts.length > 0) program.line(`  .configure({ ${configParts.join(", ")} })`);
+	if (rootHasArgs) {
+		const schemaCode = fieldMetaToCode([...root.arguments || [], ...root.positionals || []]);
+		program.line(`  .arguments(${schemaCode.code})`);
+	}
+	for (const imp of directChildren) {
+		const nameArg = imp.aliases && imp.aliases.length > 0 ? `[${JSON.stringify(imp.name)}, ${imp.aliases.map((a) => JSON.stringify(a)).join(", ")}]` : JSON.stringify(imp.name);
+		program.line(`  .command(${nameArg}, ${imp.varName})`);
+	}
+	if (directChildren.length === 0 && options?.wrap) program.line(`  .wrap({ command: ${JSON.stringify(options.wrap.command)} })`);
+	program.line();
+	program.line(`export default program`);
+	ctx.emitter.addFile("program.ts", program.build());
+	const index = ctx.createCodeBuilder();
+	index.line(`export { default } from './program.ts'`);
+	ctx.emitter.addFile("index.ts", index.build());
+}
+//#endregion
+export { generateCommandTree };
+
+//# sourceMappingURL=command-tree.mjs.map

package/dist/codegen/generators/command-tree.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-tree.mjs","names":[],"sources":["../../../src/codegen/generators/command-tree.ts"],"sourcesContent":["import { fieldMetaToCode } from '../schema-to-code.ts';\nimport type { CommandMeta, GeneratorContext } from '../types.ts';\nimport type { CommandFileOptions } from './command-file.ts';\nimport { generateCommandFile, toCommandFunctionName } from './command-file.ts';\n\nexport interface CommandTreeOptions {\n  /** When set, generates .wrap() calls instead of .action(). */\n  wrap?: {\n    /** The external command being wrapped (e.g. 'gh'). */\n    command: string;\n  };\n}\n\n/**\n * Walk a CommandMeta tree and emit one file per command plus a root program file.\n * Maps nested subcommands to a directory structure.\n */\nexport function generateCommandTree(root: CommandMeta, ctx: GeneratorContext, options?: CommandTreeOptions): void {\n  const rootImports: { name: string; varName: string; path: string; aliases?: string[] }[] = [];\n\n  // Recursively generate command files (depth-first so children exist before parents)\n  function walkCommands(cmd: CommandMeta, dirPath: string, parentArgs: string[]): void {\n    if (cmd === root) {\n      for (const sub of cmd.subcommands || []) {\n        walkCommands(sub, 'commands', []);\n      }\n      return;\n    }\n\n    const filePath = `${dirPath}/${cmd.name}.ts`;\n\n    // Recurse into subcommands first so we can reference them\n    const childRefs: { name: string; varName: string; importPath: string; aliases?: string[] }[] = [];\n    if (cmd.subcommands && cmd.subcommands.length > 0) {\n      for (const sub of cmd.subcommands) {\n        walkCommands(sub, `${dirPath}/${cmd.name}`, [...parentArgs, cmd.name]);\n        childRefs.push({\n          name: sub.name,\n          varName: toCommandFunctionName(sub.name),\n          importPath: `./${cmd.name}/${sub.name}.ts`,\n          aliases: sub.aliases,\n        });\n      }\n    }\n\n    const fileOptions: CommandFileOptions = {};\n    if (options?.wrap) {\n      fileOptions.wrap = { command: options.wrap.command, args: [...parentArgs, cmd.name] };\n    }\n    if (childRefs.length > 0) {\n      fileOptions.subcommands = childRefs;\n    }\n\n    const code = generateCommandFile(cmd, ctx, Object.keys(fileOptions).length > 0 ? fileOptions : undefined);\n    ctx.emitter.addFile(filePath, code.build());\n\n    rootImports.push({\n      name: cmd.name,\n      varName: toCommandFunctionName(cmd.name),\n      path: `./${filePath.replace(/\\.ts$/, '.ts')}`,\n      aliases: cmd.aliases,\n    });\n  }\n\n  walkCommands(root, '', []);\n\n  // Generate root program.ts\n  const program = ctx.createCodeBuilder();\n\n  const rootHasArgs = (root.arguments && root.arguments.length > 0) || (root.positionals && root.positionals.length > 0);\n  if (rootHasArgs) {\n    program.import('z', 'zod/v4');\n  }\n  program.import(['createPadrone'], 'padrone');\n\n  // Only import direct children of root\n  const directChildren = rootImports.filter((imp) => imp.path.split('/').length <= 3);\n  for (const imp of directChildren) {\n    program.import([imp.varName], imp.path);\n  }\n\n  program.line();\n  program.line(`const program = createPadrone(${JSON.stringify(root.name)})`);\n\n  // .configure()\n  const configParts: string[] = [];\n  if (root.description) {\n    configParts.push(`description: ${JSON.stringify(root.description)}`);\n  }\n  if (configParts.length > 0) {\n    program.line(`  .configure({ ${configParts.join(', ')} })`);\n  }\n\n  // Root arguments (for programs that have options at the root level)\n  if (rootHasArgs) {\n    const allFields = [...(root.arguments || []), ...(root.positionals || [])];\n    const schemaCode = fieldMetaToCode(allFields);\n    program.line(`  .arguments(${schemaCode.code})`);\n  }\n\n  // Chain .command() calls for direct children\n  for (const imp of directChildren) {\n    const nameArg =\n      imp.aliases && imp.aliases.length > 0\n        ? `[${JSON.stringify(imp.name)}, ${imp.aliases.map((a) => JSON.stringify(a)).join(', ')}]`\n        : JSON.stringify(imp.name);\n    program.line(`  .command(${nameArg}, ${imp.varName})`);\n  }\n\n  // If root has no subcommands, add .wrap() or .action()\n  if (directChildren.length === 0 && options?.wrap) {\n    program.line(`  .wrap({ command: ${JSON.stringify(options.wrap.command)} })`);\n  }\n\n  program.line();\n  program.line(`export default program`);\n\n  ctx.emitter.addFile('program.ts', program.build());\n\n  // Generate index.ts\n  const index = ctx.createCodeBuilder();\n  index.line(`export { default } from './program.ts'`);\n  ctx.emitter.addFile('index.ts', index.build());\n}\n"],"mappings":"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"}

package/dist/codegen/index.d.mts

@@ -1,330 +1,15 @@
-import { StandardSchemaV1 } from "@standard-schema/spec";
-
-//#region src/codegen/types.d.ts
-/**
- * Metadata for a single field/option/flag parsed from CLI help or completion data.
- */
-interface FieldMeta {
-  name: string;
-  type: 'string' | 'number' | 'boolean' | 'array' | 'enum' | 'unknown';
-  /** For arrays: the item type */
-  items?: string;
-  /** For enums: the allowed values */
-  enumValues?: string[];
-  description?: string;
-  default?: unknown;
-  required?: boolean;
-  aliases?: string[];
-  positional?: boolean;
-  /** Mark fields the parser wasn't confident about */
-  ambiguous?: boolean;
-}
-/**
- * Intermediate representation for a CLI command.
- * All parsers produce these, all generators consume them.
- */
-interface CommandMeta {
-  name: string;
-  description?: string;
-  aliases?: string[];
-  /** Named options/flags */
-  arguments?: FieldMeta[];
-  /** Positional arguments */
-  positionals?: FieldMeta[];
-  /** Recursive subcommands */
-  subcommands?: CommandMeta[];
-  examples?: string[];
-  deprecated?: boolean | string;
-}
-/**
- * Logger interface for generators to report progress.
- */
-interface GeneratorLogger {
-  info(message: string): void;
-  warn(message: string): void;
-  error(message: string): void;
-  success(message: string): void;
-}
-/**
- * Shared context passed to all generators.
- */
-interface GeneratorContext {
-  /** Target output directory */
-  outDir: string;
-  /** Code builder factory */
-  createCodeBuilder: () => CodeBuilder;
-  /** File emitter for writing output */
-  emitter: FileEmitter;
-  /** Template engine */
-  template: TemplateFunction;
-  /** User-facing logger */
-  log: GeneratorLogger;
-}
-/**
- * Result from CodeBuilder.build()
- */
-interface CodeBuildResult {
-  /** The formatted source string */
-  text: string;
-  /** Resolved import map for deduplication across files */
-  imports: Map<string, {
-    specifiers: Set<string>;
-    typeOnly: boolean;
-  }>;
-}
-/**
- * Fluent builder for constructing TypeScript source files.
- */
-interface CodeBuilder {
-  /** Add a named import: import { specifier } from source */
-  import(specifier: string | string[], source: string): CodeBuilder;
-  /** Add a default import: import name from source */
-  importDefault(name: string, source: string): CodeBuilder;
-  /** Add a type-only import: import type { specifier } from source */
-  importType(specifier: string | string[], source: string): CodeBuilder;
-  /** Add a line of code (empty string or no argument for blank line) */
-  line(code?: string): CodeBuilder;
-  /** Add a nested block with automatic indentation */
-  block(builder: (b: CodeBuilder) => CodeBuilder): CodeBuilder;
-  /** Add a nested block with open/close strings */
-  block(open: string, builder: (b: CodeBuilder) => CodeBuilder, close?: string): CodeBuilder;
-  /** Add a nested block with open string, close string override, and builder */
-  block(open: string, close: string, builder: (b: CodeBuilder) => CodeBuilder): CodeBuilder;
-  /** Add a single-line comment */
-  comment(text: string): CodeBuilder;
-  /** Add a JSDoc comment */
-  docComment(text: string): CodeBuilder;
-  /** Add a TODO comment */
-  todoComment(text: string): CodeBuilder;
-  /** Add raw pre-formatted code (no indentation adjustment) */
-  raw(code: string): CodeBuilder;
-  /** Build the final source string */
-  build(): CodeBuildResult;
-}
-/**
- * Result from FileEmitter.emit()
- */
-interface EmitResult {
-  /** Files that were written */
-  written: string[];
-  /** Files that were skipped (already exist, no overwrite) */
-  skipped: string[];
-  /** Files that failed to write */
-  errors: {
-    file: string;
-    error: Error;
-  }[];
-}
-/**
- * Options for creating a FileEmitter.
- */
-interface FileEmitterOptions {
-  /** Target output directory */
-  outDir: string;
-  /** Header comment prepended to every file */
-  header?: string;
-  /** How to handle existing files: true = overwrite, false = skip */
-  overwrite?: boolean;
-  /** Print what would be written without writing */
-  dryRun?: boolean;
-}
-/**
- * Manages writing multiple generated files to disk.
- */
-interface FileEmitter {
-  /** Queue a file for writing */
-  addFile(path: string, content: string | CodeBuildResult): void;
-  /** Write all queued files to disk */
-  emit(): Promise<EmitResult>;
-}
-/**
- * Template function returned by template().
- */
-type TemplateFunction = (text: string) => (data: Record<string, unknown>) => string;
-//#endregion
-//#region src/codegen/code-builder.d.ts
-/**
- * Create a new CodeBuilder for constructing TypeScript source files.
- */
-declare function createCodeBuilder(): CodeBuilder;
-//#endregion
-//#region src/codegen/discovery.d.ts
-type DiscoverySource = 'help' | 'completion' | 'bash' | 'fish' | 'zsh';
-interface DiscoveryOptions {
-  /** The command to discover (e.g. 'gh', 'docker', 'kubectl'). */
-  command: string;
-  /**
-   * Which parsing sources to use. Default: ['help'].
-   * Use `'completion'` to auto-detect the best shell completion source
-   * by probing `<cmd> completion <shell>` (bash → fish → zsh).
-   */
-  sources?: DiscoverySource[];
-  /** Max subcommand depth. 0 = root only, undefined = unlimited. */
-  depth?: number;
-  /** Delay in ms between help invocations. Default: 50 */
-  delay?: number;
-  /** Logger for progress reporting. */
-  log?: GeneratorLogger;
-  /** Timeout per help invocation in ms. Default: 10000 */
-  timeout?: number;
-}
-interface DiscoveryResult {
-  /** The discovered command tree. */
-  command: CommandMeta;
-  /** Number of help invocations made. */
-  invocations: number;
-  /** Errors encountered (non-fatal). */
-  warnings: string[];
-}
-/**
- * Discover CLI structure by running --help recursively and optionally
- * parsing shell completion scripts.
- */
-declare function discoverCli(options: DiscoveryOptions): Promise<DiscoveryResult>;
-/**
- * Detect the best shell for completion parsing by probing the command.
- * Tries `<cmd> completion <shell>` for bash, fish, zsh (in that order).
- * Returns the shell name if successful, or null if no completion command exists.
- */
-declare function detectCompletionShell(command: string, timeout?: number): Promise<'bash' | 'fish' | 'zsh' | null>;
-//#endregion
-//#region src/codegen/file-emitter.d.ts
-/**
- * Create a FileEmitter for writing multiple generated files to disk.
- */
-declare function createFileEmitter(options: FileEmitterOptions): FileEmitter;
-//#endregion
-//#region src/codegen/generators/barrel-file.d.ts
-/**
- * Generate an index.ts barrel file that re-exports all given files.
- */
-declare function generateBarrelFile(files: string[], ctx: GeneratorContext): CodeBuilder;
-//#endregion
-//#region src/codegen/generators/command-file.d.ts
-interface CommandFileOptions {
-  /** Wrap config: generates .wrap() instead of .action(). */
-  wrap?: {
-    /** The external command to wrap (e.g. 'gh'). */command: string; /** Fixed args preceding the options (e.g. ['pr', 'list']). */
-    args?: string[];
-  };
-  /** Subcommand references to wire into this command via .command() calls. */
-  subcommands?: {
-    name: string;
-    varName: string;
-    importPath: string;
-    aliases?: string[];
-  }[];
-}
-/**
- * Generate a single Padrone command file from a CommandMeta.
- * Produces a named function that chains .configure(), .arguments(), and .wrap() or .action().
- */
-declare function generateCommandFile(command: CommandMeta, ctx: GeneratorContext, options?: CommandFileOptions): CodeBuilder;
-//#endregion
-//#region src/codegen/generators/command-tree.d.ts
-interface CommandTreeOptions {
-  /** When set, generates .wrap() calls instead of .action(). */
-  wrap?: {
-    /** The external command being wrapped (e.g. 'gh'). */command: string;
-  };
-}
-/**
- * Walk a CommandMeta tree and emit one file per command plus a root program file.
- * Maps nested subcommands to a directory structure.
- */
-declare function generateCommandTree(root: CommandMeta, ctx: GeneratorContext, options?: CommandTreeOptions): void;
-//#endregion
-//#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
-//#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
-//#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
-//#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
-//#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
-//#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
-//#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 { type CodeBuildResult, type CodeBuilder, type CommandFileOptions, type CommandMeta, type CommandTreeOptions, type DiscoveryOptions, type DiscoveryResult, type DiscoverySource, type EmitResult, type FieldMeta, type FileEmitter, type FileEmitterOptions, type GeneratorContext, type GeneratorLogger, type TemplateFunction, createCodeBuilder, createFileEmitter, detectCompletionShell, discoverCli, fieldMetaToCode, generateBarrelFile, generateCommandFile, generateCommandTree, mergeCommandMeta, parseBashCompletions, parseFishCompletions, parseHelpOutput, parseZshCompletions, schemaToCode, template };
-//# sourceMappingURL=index.d.mts.map
+import { CodeBuildResult, CodeBuilder, CommandMeta, EmitResult, FieldMeta, FileEmitter, FileEmitterOptions, GeneratorContext, GeneratorLogger, TemplateFunction } from "./types.mjs";
+import { createCodeBuilder } from "./code-builder.mjs";
+import { DiscoveryOptions, DiscoveryResult, DiscoverySource, detectCompletionShell, discoverCli } from "./discovery.mjs";
+import { createFileEmitter } from "./file-emitter.mjs";
+import { generateBarrelFile } from "./generators/barrel-file.mjs";
+import { CommandFileOptions, generateCommandFile } from "./generators/command-file.mjs";
+import { CommandTreeOptions, generateCommandTree } from "./generators/command-tree.mjs";
+import { parseBashCompletions } from "./parsers/bash.mjs";
+import { parseFishCompletions } from "./parsers/fish.mjs";
+import { parseHelpOutput } from "./parsers/help.mjs";
+import { mergeCommandMeta } from "./parsers/merge.mjs";
+import { parseZshCompletions } from "./parsers/zsh.mjs";
+import { fieldMetaToCode, schemaToCode } from "./schema-to-code.mjs";
+import { template } from "./template.mjs";
+export { type CodeBuildResult, type CodeBuilder, type CommandFileOptions, type CommandMeta, type CommandTreeOptions, type DiscoveryOptions, type DiscoveryResult, type DiscoverySource, type EmitResult, type FieldMeta, type FileEmitter, type FileEmitterOptions, type GeneratorContext, type GeneratorLogger, type TemplateFunction, createCodeBuilder, createFileEmitter, detectCompletionShell, discoverCli, fieldMetaToCode, generateBarrelFile, generateCommandFile, generateCommandTree, mergeCommandMeta, parseBashCompletions, parseFishCompletions, parseHelpOutput, parseZshCompletions, schemaToCode, template };