politty 0.4.1 → 0.4.2

package/dist/{arg-registry-C3GP-5C9.d.ts → arg-registry-BNoIwnNr.d.cts}

@@ -38,16 +38,23 @@ interface CustomCompletion {
  * branch: arg(z.string(), {
  *   completion: { custom: { shellCommand: "git branch --format='%(refname:short)'" } }
  * })
+ *
+ * // File completion with glob pattern matcher
+ * envFile: arg(z.string(), {
+ *   completion: { type: "file", matcher: [".env.*"] }
+ * })
  * ```
  */
-interface CompletionMeta {
-  /** Built-in completion type */
-  type?: CompletionType;
-  /** Custom completion (takes precedence over type if both specified) */
+type CompletionMeta = {
+  /** Built-in completion type */type?: CompletionType; /** Custom completion (takes precedence over type if both specified) */
   custom?: CustomCompletion;
-  /** File extension filter (only applies when type is "file") */
-  extensions?: string[];
-}
+} & ({
+  /** File extension filter (only applies when type is "file") */extensions?: string[];
+  matcher?: never;
+} | {
+  /** Glob patterns for file matching (only applies when type is "file") */matcher?: string[];
+  extensions?: never;
+});
 /**
  * Base metadata shared by all argument types
  */
@@ -134,4 +141,4 @@ declare function arg<T extends z.ZodType>(schema: T): T;
 declare function arg<T extends z.ZodType, M extends ArgMeta>(schema: T, meta: ValidateArgMeta<M>): T;
 //#endregion
 export { arg as a, CustomCompletion as i, CompletionMeta as n, CompletionType as r, ArgMeta as t };
-//# sourceMappingURL=arg-registry-C3GP-5C9.d.ts.map
+//# sourceMappingURL=arg-registry-BNoIwnNr.d.cts.map

package/dist/arg-registry-BNoIwnNr.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-registry-BNoIwnNr.d.cts","names":[],"sources":["../src/core/arg-registry.ts"],"mappings":";;;;;AAKA;KAAY,cAAA;;;;UAKK,gBAAA;EAAgB;EAE/B,OAAA;EAAA;EAEA,YAAA;AAAA;;;;;;;;;;;;;;AAqDF;;;;;;;;;;;;AA6BA;;;;;AAQA;KAxDY,cAAA;iCAEV,IAAA,GAAO,cAAA,EAsDuC;EApD9C,MAAA,GAAS,gBAAA;AAAA;EAwDW,+DArDgD,UAAA;EAChE,OAAA;AAAA;EA0Da,yEAvD6D,OAAA;EAC1E,UAAA;AAAA;;AA4D2C;;UArDhC,WAAA;EAkFS;EAhFxB,WAAA;EAkFI;EAhFJ,UAAA;EAkFsB;EAhFtB,WAAA;EAoFE;;;;;;;;;;;;;;EArEF,GAAA;EAqEG;EAnEH,UAAA,GAAa,cAAA;AAAA;;;;UAME,cAAA,SAAuB,WAAA;EA+Da;EA7DnD,KAAA;AAAA;;;;UAMe,sBAAA,SAA+B,WAAA;EAuDP;EArDvC,KAAA;EAqDoD;EAnDpD,oBAAA;AAAA;;;;KAMU,OAAA,GAAU,cAAA,GAAiB,sBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmClC,eAAA,MAAqB,CAAA;EAAY,KAAA;AAAA,IAClC,CAAA;EAAY,oBAAA;AAAA,IACV,CAAA,iBAEc,CAAA,GAAI,CAAA,CAAE,CAAA;EAElB,WAAA;AAAA,IAEJ,CAAA;AAAA,iBAEY,GAAA,WAAc,CAAA,CAAE,OAAA,CAAA,CAAS,MAAA,EAAQ,CAAA,GAAI,CAAA;AAAA,iBACrC,GAAA,WAAc,CAAA,CAAE,OAAA,YAAmB,OAAA,CAAA,CAAS,MAAA,EAAQ,CAAA,EAAG,IAAA,EAAM,eAAA,CAAgB,CAAA,IAAK,CAAA"}

package/dist/{arg-registry-B4a4Fj7f.d.cts → arg-registry-BUUhZ7JR.d.ts}

@@ -38,16 +38,23 @@ interface CustomCompletion {
  * branch: arg(z.string(), {
  *   completion: { custom: { shellCommand: "git branch --format='%(refname:short)'" } }
  * })
+ *
+ * // File completion with glob pattern matcher
+ * envFile: arg(z.string(), {
+ *   completion: { type: "file", matcher: [".env.*"] }
+ * })
  * ```
  */
-interface CompletionMeta {
-  /** Built-in completion type */
-  type?: CompletionType;
-  /** Custom completion (takes precedence over type if both specified) */
+type CompletionMeta = {
+  /** Built-in completion type */type?: CompletionType; /** Custom completion (takes precedence over type if both specified) */
   custom?: CustomCompletion;
-  /** File extension filter (only applies when type is "file") */
-  extensions?: string[];
-}
+} & ({
+  /** File extension filter (only applies when type is "file") */extensions?: string[];
+  matcher?: never;
+} | {
+  /** Glob patterns for file matching (only applies when type is "file") */matcher?: string[];
+  extensions?: never;
+});
 /**
  * Base metadata shared by all argument types
  */
@@ -134,4 +141,4 @@ declare function arg<T extends z.ZodType>(schema: T): T;
 declare function arg<T extends z.ZodType, M extends ArgMeta>(schema: T, meta: ValidateArgMeta<M>): T;
 //#endregion
 export { arg as a, CustomCompletion as i, CompletionMeta as n, CompletionType as r, ArgMeta as t };
-//# sourceMappingURL=arg-registry-B4a4Fj7f.d.cts.map
+//# sourceMappingURL=arg-registry-BUUhZ7JR.d.ts.map

package/dist/arg-registry-BUUhZ7JR.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-registry-BUUhZ7JR.d.ts","names":[],"sources":["../src/core/arg-registry.ts"],"mappings":";;;;;AAKA;KAAY,cAAA;;;;UAKK,gBAAA;EAAgB;EAE/B,OAAA;EAAA;EAEA,YAAA;AAAA;;;;;;;;;;;;;;AAqDF;;;;;;;;;;;;AA6BA;;;;;AAQA;KAxDY,cAAA;iCAEV,IAAA,GAAO,cAAA,EAsDuC;EApD9C,MAAA,GAAS,gBAAA;AAAA;EAwDW,+DArDgD,UAAA;EAChE,OAAA;AAAA;EA0Da,yEAvD6D,OAAA;EAC1E,UAAA;AAAA;;AA4D2C;;UArDhC,WAAA;EAkFS;EAhFxB,WAAA;EAkFI;EAhFJ,UAAA;EAkFsB;EAhFtB,WAAA;EAoFE;;;;;;;;;;;;;;EArEF,GAAA;EAqEG;EAnEH,UAAA,GAAa,cAAA;AAAA;;;;UAME,cAAA,SAAuB,WAAA;EA+Da;EA7DnD,KAAA;AAAA;;;;UAMe,sBAAA,SAA+B,WAAA;EAuDP;EArDvC,KAAA;EAqDoD;EAnDpD,oBAAA;AAAA;;;;KAMU,OAAA,GAAU,cAAA,GAAiB,sBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmClC,eAAA,MAAqB,CAAA;EAAY,KAAA;AAAA,IAClC,CAAA;EAAY,oBAAA;AAAA,IACV,CAAA,iBAEc,CAAA,GAAI,CAAA,CAAE,CAAA;EAElB,WAAA;AAAA,IAEJ,CAAA;AAAA,iBAEY,GAAA,WAAc,CAAA,CAAE,OAAA,CAAA,CAAS,MAAA,EAAQ,CAAA,GAAI,CAAA;AAAA,iBACrC,GAAA,WAAc,CAAA,CAAE,OAAA,YAAmB,OAAA,CAAA,CAAS,MAAA,EAAQ,CAAA,EAAG,IAAA,EAAM,eAAA,CAAgB,CAAA,IAAK,CAAA"}

package/dist/augment.d.cts

@@ -1,4 +1,4 @@
-import { t as ArgMeta } from "./arg-registry-B4a4Fj7f.cjs";
+import { t as ArgMeta } from "./arg-registry-BNoIwnNr.cjs";
 
 //#region src/augment.d.ts
 declare module "zod" {

package/dist/augment.d.ts

@@ -1,4 +1,4 @@
-import { t as ArgMeta } from "./arg-registry-C3GP-5C9.js";
+import { t as ArgMeta } from "./arg-registry-BUUhZ7JR.js";
 
 //#region src/augment.d.ts
 declare module "zod" {

package/dist/completion/index.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_subcommand_router = require('../subcommand-router-4d1Xbp8B.cjs');
-const require_schema_extractor = require('../schema-extractor-Mk1MHBkQ.cjs');
-const require_extractor = require('../extractor-cjruDqQ2.cjs');
+const require_subcommand_router = require('../subcommand-router-ZjNjFaUL.cjs');
+const require_lazy = require('../lazy-BEDnSR0m.cjs');
+const require_zsh = require('../zsh-CASZWn0o.cjs');
 let zod = require("zod");
 
 //#region src/completion/index.ts
@@ -35,9 +35,9 @@ let zod = require("zod");
 */
 function generateCompletion(command, options) {
 	switch (options.shell) {
-		case "bash": return require_extractor.generateBashCompletion(command, options);
-		case "zsh": return require_extractor.generateZshCompletion(command, options);
-		case "fish": return require_extractor.generateFishCompletion(command, options);
+		case "bash": return require_zsh.generateBashCompletion(command, options);
+		case "zsh": return require_zsh.generateZshCompletion(command, options);
+		case "fish": return require_zsh.generateFishCompletion(command, options);
 		default: throw new Error(`Unsupported shell: ${options.shell}`);
 	}
 }
@@ -65,7 +65,7 @@ function detectShell() {
 * Schema for the completion command arguments
 */
 const completionArgsSchema = zod.z.object({
-	shell: require_schema_extractor.arg(zod.z.enum([
+	shell: require_lazy.arg(zod.z.enum([
 		"bash",
 		"zsh",
 		"fish"
@@ -74,7 +74,7 @@ const completionArgsSchema = zod.z.object({
 		description: "Shell type (bash, zsh, or fish)",
 		placeholder: "SHELL"
 	}),
-	instructions: require_schema_extractor.arg(zod.z.boolean().default(false), {
+	instructions: require_lazy.arg(zod.z.boolean().default(false), {
 		alias: "i",
 		description: "Show installation instructions"
 	})
@@ -98,9 +98,9 @@ function createCompletionCommand(rootCommand, programName) {
 	const resolvedProgramName = programName ?? rootCommand.name;
 	if (!rootCommand.subCommands?.__complete) rootCommand.subCommands = {
 		...rootCommand.subCommands,
-		__complete: require_extractor.createDynamicCompleteCommand(rootCommand, resolvedProgramName)
+		__complete: require_zsh.createDynamicCompleteCommand(rootCommand, resolvedProgramName)
 	};
-	return require_extractor.defineCommand({
+	return require_zsh.defineCommand({
 		name: "completion",
 		description: "Generate shell completion script",
 		args: completionArgsSchema,
@@ -147,24 +147,24 @@ function withCompletionCommand(command, options) {
 	wrappedCommand.subCommands = {
 		...command.subCommands,
 		completion: createCompletionCommand(wrappedCommand, programName),
-		__complete: require_extractor.createDynamicCompleteCommand(wrappedCommand, programName)
+		__complete: require_zsh.createDynamicCompleteCommand(wrappedCommand, programName)
 	};
 	return wrappedCommand;
 }
 
 //#endregion
-exports.CompletionDirective = require_extractor.CompletionDirective;
+exports.CompletionDirective = require_zsh.CompletionDirective;
 exports.createCompletionCommand = createCompletionCommand;
-exports.createDynamicCompleteCommand = require_extractor.createDynamicCompleteCommand;
+exports.createDynamicCompleteCommand = require_zsh.createDynamicCompleteCommand;
 exports.detectShell = detectShell;
-exports.extractCompletionData = require_extractor.extractCompletionData;
-exports.extractPositionals = require_extractor.extractPositionals;
-exports.formatForShell = require_extractor.formatForShell;
-exports.generateCandidates = require_extractor.generateCandidates;
+exports.extractCompletionData = require_zsh.extractCompletionData;
+exports.extractPositionals = require_zsh.extractPositionals;
+exports.formatForShell = require_zsh.formatForShell;
+exports.generateCandidates = require_zsh.generateCandidates;
 exports.generateCompletion = generateCompletion;
 exports.getSupportedShells = getSupportedShells;
-exports.hasCompleteCommand = require_extractor.hasCompleteCommand;
-exports.parseCompletionContext = require_extractor.parseCompletionContext;
-exports.resolveValueCompletion = require_extractor.resolveValueCompletion;
+exports.hasCompleteCommand = require_zsh.hasCompleteCommand;
+exports.parseCompletionContext = require_zsh.parseCompletionContext;
+exports.resolveValueCompletion = require_zsh.resolveValueCompletion;
 exports.withCompletionCommand = withCompletionCommand;
 //# sourceMappingURL=index.cjs.map

package/dist/completion/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["generateBashCompletion","generateZshCompletion","generateFishCompletion","z","arg","createDynamicCompleteCommand","defineCommand"],"sources":["../../src/completion/index.ts"],"sourcesContent":["/**\n * Shell completion generation module\n *\n * Provides utilities to generate shell completion scripts for bash, zsh, and fish.\n *\n * @example\n * ```typescript\n * import { generateCompletion, createCompletionCommand } from \"politty/completion\";\n *\n * // Generate completion script directly\n * const result = generateCompletion(myCommand, {\n *   shell: \"bash\",\n *   programName: \"mycli\"\n * });\n * console.log(result.script);\n *\n * // Or add a completion subcommand to your CLI\n * const mainCommand = withCompletionCommand(\n *   defineCommand({\n *     name: \"mycli\",\n *     subCommands: { ... },\n *   }),\n * );\n * ```\n */\n\nimport { z } from \"zod\";\nimport { arg } from \"../core/arg-registry.js\";\nimport { defineCommand } from \"../core/command.js\";\nimport type { AnyCommand, Command } from \"../types.js\";\nimport { generateBashCompletion } from \"./bash.js\";\nimport { createDynamicCompleteCommand } from \"./dynamic/index.js\";\nimport { generateFishCompletion } from \"./fish.js\";\nimport type { CompletionOptions, CompletionResult, ShellType } from \"./types.js\";\nimport { generateZshCompletion } from \"./zsh.js\";\n\n// Re-export dynamic completion\nexport {\n  CompletionDirective,\n  createDynamicCompleteCommand,\n  formatForShell,\n  generateCandidates,\n  hasCompleteCommand,\n  parseCompletionContext,\n  type CandidateResult,\n  type CompletionCandidate,\n  type CompletionContext,\n  type CompletionType,\n  type ShellFormatOptions,\n} from \"./dynamic/index.js\";\n// Re-export extractor\nexport { extractCompletionData, extractPositionals } from \"./extractor.js\";\n// Re-export types\nexport type {\n  CompletableOption,\n  CompletableSubcommand,\n  CompletionData,\n  CompletionGenerator,\n  CompletionOptions,\n  CompletionResult,\n  ShellType,\n} from \"./types.js\";\n// Re-export value completion resolver\nexport { resolveValueCompletion, type ValueCompletionField } from \"./value-completion-resolver.js\";\n\n/**\n * Generate completion script for the specified shell\n */\nexport function generateCompletion(\n  command: AnyCommand,\n  options: CompletionOptions,\n): CompletionResult {\n  switch (options.shell) {\n    case \"bash\":\n      return generateBashCompletion(command, options);\n    case \"zsh\":\n      return generateZshCompletion(command, options);\n    case \"fish\":\n      return generateFishCompletion(command, options);\n    default:\n      throw new Error(`Unsupported shell: ${options.shell}`);\n  }\n}\n\n/**\n * Get the list of supported shells\n */\nexport function getSupportedShells(): ShellType[] {\n  return [\"bash\", \"zsh\", \"fish\"];\n}\n\n/**\n * Detect the current shell from environment\n */\nexport function detectShell(): ShellType | null {\n  const shell = process.env.SHELL || \"\";\n  const shellName = shell.split(\"/\").pop()?.toLowerCase() || \"\";\n\n  if (shellName.includes(\"bash\")) {\n    return \"bash\";\n  }\n  if (shellName.includes(\"zsh\")) {\n    return \"zsh\";\n  }\n  if (shellName.includes(\"fish\")) {\n    return \"fish\";\n  }\n\n  return null;\n}\n\n/**\n * Schema for the completion command arguments\n */\nconst completionArgsSchema = z.object({\n  shell: arg(\n    z\n      .enum([\"bash\", \"zsh\", \"fish\"])\n      .optional()\n      .describe(\"Shell type (auto-detected if not specified)\"),\n    {\n      positional: true,\n      description: \"Shell type (bash, zsh, or fish)\",\n      placeholder: \"SHELL\",\n    },\n  ),\n  instructions: arg(z.boolean().default(false), {\n    alias: \"i\",\n    description: \"Show installation instructions\",\n  }),\n});\n\ntype CompletionArgs = z.infer<typeof completionArgsSchema>;\n\n/**\n * Create a completion subcommand for your CLI\n *\n * This creates a ready-to-use subcommand that generates completion scripts.\n *\n * @example\n * ```typescript\n * const mainCommand = defineCommand({\n *   name: \"mycli\",\n *   subCommands: {\n *     completion: createCompletionCommand(mainCommand)\n *   }\n * });\n * ```\n */\nexport function createCompletionCommand(\n  rootCommand: AnyCommand,\n  programName?: string,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): Command<typeof completionArgsSchema, CompletionArgs, any> {\n  const resolvedProgramName = programName ?? rootCommand.name;\n\n  if (!rootCommand.subCommands?.__complete) {\n    rootCommand.subCommands = {\n      ...rootCommand.subCommands,\n      __complete: createDynamicCompleteCommand(rootCommand, resolvedProgramName),\n    };\n  }\n\n  return defineCommand({\n    name: \"completion\",\n    description: \"Generate shell completion script\",\n    args: completionArgsSchema,\n    run(args) {\n      // Detect shell if not specified\n      const shellType = args.shell || detectShell();\n\n      if (!shellType) {\n        console.error(\"Could not detect shell type. Please specify one of: bash, zsh, fish\");\n        process.exitCode = 1;\n        return;\n      }\n\n      const result = generateCompletion(rootCommand, {\n        shell: shellType,\n        programName: resolvedProgramName,\n        includeDescriptions: true,\n      });\n\n      if (args.instructions) {\n        console.log(result.installInstructions);\n      } else {\n        console.log(result.script);\n      }\n    },\n  });\n}\n\n/**\n * Options for withCompletionCommand\n */\nexport interface WithCompletionOptions {\n  /** Override the program name (defaults to command.name) */\n  programName?: string;\n}\n\n/**\n * Wrap a command with a completion subcommand\n *\n * This avoids circular references that occur when a command references itself\n * in its subCommands (e.g., for completion generation).\n *\n * @param command - The command to wrap\n * @param options - Options including programName\n * @returns A new command with the completion subcommand added\n *\n * @example\n * ```typescript\n * const mainCommand = withCompletionCommand(\n *   defineCommand({\n *     name: \"mycli\",\n *     subCommands: { ... },\n *   }),\n * );\n * ```\n */\nexport function withCompletionCommand<T extends AnyCommand>(\n  command: T,\n  options?: string | WithCompletionOptions,\n): T {\n  // Support both string (programName) and options object for backwards compatibility\n  const opts: WithCompletionOptions =\n    typeof options === \"string\" ? { programName: options } : (options ?? {});\n\n  const { programName } = opts;\n\n  const wrappedCommand = {\n    ...command,\n  } as T;\n\n  wrappedCommand.subCommands = {\n    ...command.subCommands,\n    completion: createCompletionCommand(wrappedCommand, programName),\n    __complete: createDynamicCompleteCommand(wrappedCommand, programName),\n  };\n\n  return wrappedCommand;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEA,SAAgB,mBACd,SACA,SACkB;AAClB,SAAQ,QAAQ,OAAhB;EACE,KAAK,OACH,QAAOA,yCAAuB,SAAS,QAAQ;EACjD,KAAK,MACH,QAAOC,wCAAsB,SAAS,QAAQ;EAChD,KAAK,OACH,QAAOC,yCAAuB,SAAS,QAAQ;EACjD,QACE,OAAM,IAAI,MAAM,sBAAsB,QAAQ,QAAQ;;;;;;AAO5D,SAAgB,qBAAkC;AAChD,QAAO;EAAC;EAAQ;EAAO;EAAO;;;;;AAMhC,SAAgB,cAAgC;CAE9C,MAAM,aADQ,QAAQ,IAAI,SAAS,IACX,MAAM,IAAI,CAAC,KAAK,EAAE,aAAa,IAAI;AAE3D,KAAI,UAAU,SAAS,OAAO,CAC5B,QAAO;AAET,KAAI,UAAU,SAAS,MAAM,CAC3B,QAAO;AAET,KAAI,UAAU,SAAS,OAAO,CAC5B,QAAO;AAGT,QAAO;;;;;AAMT,MAAM,uBAAuBC,MAAE,OAAO;CACpC,OAAOC,6BACLD,MACG,KAAK;EAAC;EAAQ;EAAO;EAAO,CAAC,CAC7B,UAAU,CACV,SAAS,8CAA8C,EAC1D;EACE,YAAY;EACZ,aAAa;EACb,aAAa;EACd,CACF;CACD,cAAcC,6BAAID,MAAE,SAAS,CAAC,QAAQ,MAAM,EAAE;EAC5C,OAAO;EACP,aAAa;EACd,CAAC;CACH,CAAC;;;;;;;;;;;;;;;;AAmBF,SAAgB,wBACd,aACA,aAE2D;CAC3D,MAAM,sBAAsB,eAAe,YAAY;AAEvD,KAAI,CAAC,YAAY,aAAa,WAC5B,aAAY,cAAc;EACxB,GAAG,YAAY;EACf,YAAYE,+CAA6B,aAAa,oBAAoB;EAC3E;AAGH,QAAOC,gCAAc;EACnB,MAAM;EACN,aAAa;EACb,MAAM;EACN,IAAI,MAAM;GAER,MAAM,YAAY,KAAK,SAAS,aAAa;AAE7C,OAAI,CAAC,WAAW;AACd,YAAQ,MAAM,sEAAsE;AACpF,YAAQ,WAAW;AACnB;;GAGF,MAAM,SAAS,mBAAmB,aAAa;IAC7C,OAAO;IACP,aAAa;IACb,qBAAqB;IACtB,CAAC;AAEF,OAAI,KAAK,aACP,SAAQ,IAAI,OAAO,oBAAoB;OAEvC,SAAQ,IAAI,OAAO,OAAO;;EAG/B,CAAC;;;;;;;;;;;;;;;;;;;;;;AA+BJ,SAAgB,sBACd,SACA,SACG;CAKH,MAAM,EAAE,gBAFN,OAAO,YAAY,WAAW,EAAE,aAAa,SAAS,GAAI,WAAW,EAAE;CAIzE,MAAM,iBAAiB,EACrB,GAAG,SACJ;AAED,gBAAe,cAAc;EAC3B,GAAG,QAAQ;EACX,YAAY,wBAAwB,gBAAgB,YAAY;EAChE,YAAYD,+CAA6B,gBAAgB,YAAY;EACtE;AAED,QAAO"}
+{"version":3,"file":"index.cjs","names":["generateBashCompletion","generateZshCompletion","generateFishCompletion","z","arg","createDynamicCompleteCommand","defineCommand"],"sources":["../../src/completion/index.ts"],"sourcesContent":["/**\n * Shell completion generation module\n *\n * Provides utilities to generate shell completion scripts for bash, zsh, and fish.\n *\n * @example\n * ```typescript\n * import { generateCompletion, createCompletionCommand } from \"politty/completion\";\n *\n * // Generate completion script directly\n * const result = generateCompletion(myCommand, {\n *   shell: \"bash\",\n *   programName: \"mycli\"\n * });\n * console.log(result.script);\n *\n * // Or add a completion subcommand to your CLI\n * const mainCommand = withCompletionCommand(\n *   defineCommand({\n *     name: \"mycli\",\n *     subCommands: { ... },\n *   }),\n * );\n * ```\n */\n\nimport { z } from \"zod\";\nimport { arg } from \"../core/arg-registry.js\";\nimport { defineCommand } from \"../core/command.js\";\nimport type { AnyCommand, Command } from \"../types.js\";\nimport { generateBashCompletion } from \"./bash.js\";\nimport { createDynamicCompleteCommand } from \"./dynamic/index.js\";\nimport { generateFishCompletion } from \"./fish.js\";\nimport type { CompletionOptions, CompletionResult, ShellType } from \"./types.js\";\nimport { generateZshCompletion } from \"./zsh.js\";\n\n// Re-export dynamic completion\nexport {\n  CompletionDirective,\n  createDynamicCompleteCommand,\n  formatForShell,\n  generateCandidates,\n  hasCompleteCommand,\n  parseCompletionContext,\n  type CandidateResult,\n  type CompletionCandidate,\n  type CompletionContext,\n  type CompletionType,\n  type ShellFormatOptions,\n} from \"./dynamic/index.js\";\n// Re-export extractor\nexport { extractCompletionData, extractPositionals } from \"./extractor.js\";\n// Re-export types\nexport type {\n  CompletableOption,\n  CompletableSubcommand,\n  CompletionData,\n  CompletionGenerator,\n  CompletionOptions,\n  CompletionResult,\n  ShellType,\n} from \"./types.js\";\n// Re-export value completion resolver\nexport { resolveValueCompletion, type ValueCompletionField } from \"./value-completion-resolver.js\";\n\n/**\n * Generate completion script for the specified shell\n */\nexport function generateCompletion(\n  command: AnyCommand,\n  options: CompletionOptions,\n): CompletionResult {\n  switch (options.shell) {\n    case \"bash\":\n      return generateBashCompletion(command, options);\n    case \"zsh\":\n      return generateZshCompletion(command, options);\n    case \"fish\":\n      return generateFishCompletion(command, options);\n    default:\n      throw new Error(`Unsupported shell: ${options.shell}`);\n  }\n}\n\n/**\n * Get the list of supported shells\n */\nexport function getSupportedShells(): ShellType[] {\n  return [\"bash\", \"zsh\", \"fish\"];\n}\n\n/**\n * Detect the current shell from environment\n */\nexport function detectShell(): ShellType | null {\n  const shell = process.env.SHELL || \"\";\n  const shellName = shell.split(\"/\").pop()?.toLowerCase() || \"\";\n\n  if (shellName.includes(\"bash\")) {\n    return \"bash\";\n  }\n  if (shellName.includes(\"zsh\")) {\n    return \"zsh\";\n  }\n  if (shellName.includes(\"fish\")) {\n    return \"fish\";\n  }\n\n  return null;\n}\n\n/**\n * Schema for the completion command arguments\n */\nconst completionArgsSchema = z.object({\n  shell: arg(\n    z\n      .enum([\"bash\", \"zsh\", \"fish\"])\n      .optional()\n      .describe(\"Shell type (auto-detected if not specified)\"),\n    {\n      positional: true,\n      description: \"Shell type (bash, zsh, or fish)\",\n      placeholder: \"SHELL\",\n    },\n  ),\n  instructions: arg(z.boolean().default(false), {\n    alias: \"i\",\n    description: \"Show installation instructions\",\n  }),\n});\n\ntype CompletionArgs = z.infer<typeof completionArgsSchema>;\n\n/**\n * Create a completion subcommand for your CLI\n *\n * This creates a ready-to-use subcommand that generates completion scripts.\n *\n * @example\n * ```typescript\n * const mainCommand = defineCommand({\n *   name: \"mycli\",\n *   subCommands: {\n *     completion: createCompletionCommand(mainCommand)\n *   }\n * });\n * ```\n */\nexport function createCompletionCommand(\n  rootCommand: AnyCommand,\n  programName?: string,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): Command<typeof completionArgsSchema, CompletionArgs, any> {\n  const resolvedProgramName = programName ?? rootCommand.name;\n\n  if (!rootCommand.subCommands?.__complete) {\n    rootCommand.subCommands = {\n      ...rootCommand.subCommands,\n      __complete: createDynamicCompleteCommand(rootCommand, resolvedProgramName),\n    };\n  }\n\n  return defineCommand({\n    name: \"completion\",\n    description: \"Generate shell completion script\",\n    args: completionArgsSchema,\n    run(args) {\n      // Detect shell if not specified\n      const shellType = args.shell || detectShell();\n\n      if (!shellType) {\n        console.error(\"Could not detect shell type. Please specify one of: bash, zsh, fish\");\n        process.exitCode = 1;\n        return;\n      }\n\n      const result = generateCompletion(rootCommand, {\n        shell: shellType,\n        programName: resolvedProgramName,\n        includeDescriptions: true,\n      });\n\n      if (args.instructions) {\n        console.log(result.installInstructions);\n      } else {\n        console.log(result.script);\n      }\n    },\n  });\n}\n\n/**\n * Options for withCompletionCommand\n */\nexport interface WithCompletionOptions {\n  /** Override the program name (defaults to command.name) */\n  programName?: string;\n}\n\n/**\n * Wrap a command with a completion subcommand\n *\n * This avoids circular references that occur when a command references itself\n * in its subCommands (e.g., for completion generation).\n *\n * @param command - The command to wrap\n * @param options - Options including programName\n * @returns A new command with the completion subcommand added\n *\n * @example\n * ```typescript\n * const mainCommand = withCompletionCommand(\n *   defineCommand({\n *     name: \"mycli\",\n *     subCommands: { ... },\n *   }),\n * );\n * ```\n */\nexport function withCompletionCommand<T extends AnyCommand>(\n  command: T,\n  options?: string | WithCompletionOptions,\n): T {\n  // Support both string (programName) and options object for backwards compatibility\n  const opts: WithCompletionOptions =\n    typeof options === \"string\" ? { programName: options } : (options ?? {});\n\n  const { programName } = opts;\n\n  const wrappedCommand = {\n    ...command,\n  } as T;\n\n  wrappedCommand.subCommands = {\n    ...command.subCommands,\n    completion: createCompletionCommand(wrappedCommand, programName),\n    __complete: createDynamicCompleteCommand(wrappedCommand, programName),\n  };\n\n  return wrappedCommand;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEA,SAAgB,mBACd,SACA,SACkB;AAClB,SAAQ,QAAQ,OAAhB;EACE,KAAK,OACH,QAAOA,mCAAuB,SAAS,QAAQ;EACjD,KAAK,MACH,QAAOC,kCAAsB,SAAS,QAAQ;EAChD,KAAK,OACH,QAAOC,mCAAuB,SAAS,QAAQ;EACjD,QACE,OAAM,IAAI,MAAM,sBAAsB,QAAQ,QAAQ;;;;;;AAO5D,SAAgB,qBAAkC;AAChD,QAAO;EAAC;EAAQ;EAAO;EAAO;;;;;AAMhC,SAAgB,cAAgC;CAE9C,MAAM,aADQ,QAAQ,IAAI,SAAS,IACX,MAAM,IAAI,CAAC,KAAK,EAAE,aAAa,IAAI;AAE3D,KAAI,UAAU,SAAS,OAAO,CAC5B,QAAO;AAET,KAAI,UAAU,SAAS,MAAM,CAC3B,QAAO;AAET,KAAI,UAAU,SAAS,OAAO,CAC5B,QAAO;AAGT,QAAO;;;;;AAMT,MAAM,uBAAuBC,MAAE,OAAO;CACpC,OAAOC,iBACLD,MACG,KAAK;EAAC;EAAQ;EAAO;EAAO,CAAC,CAC7B,UAAU,CACV,SAAS,8CAA8C,EAC1D;EACE,YAAY;EACZ,aAAa;EACb,aAAa;EACd,CACF;CACD,cAAcC,iBAAID,MAAE,SAAS,CAAC,QAAQ,MAAM,EAAE;EAC5C,OAAO;EACP,aAAa;EACd,CAAC;CACH,CAAC;;;;;;;;;;;;;;;;AAmBF,SAAgB,wBACd,aACA,aAE2D;CAC3D,MAAM,sBAAsB,eAAe,YAAY;AAEvD,KAAI,CAAC,YAAY,aAAa,WAC5B,aAAY,cAAc;EACxB,GAAG,YAAY;EACf,YAAYE,yCAA6B,aAAa,oBAAoB;EAC3E;AAGH,QAAOC,0BAAc;EACnB,MAAM;EACN,aAAa;EACb,MAAM;EACN,IAAI,MAAM;GAER,MAAM,YAAY,KAAK,SAAS,aAAa;AAE7C,OAAI,CAAC,WAAW;AACd,YAAQ,MAAM,sEAAsE;AACpF,YAAQ,WAAW;AACnB;;GAGF,MAAM,SAAS,mBAAmB,aAAa;IAC7C,OAAO;IACP,aAAa;IACb,qBAAqB;IACtB,CAAC;AAEF,OAAI,KAAK,aACP,SAAQ,IAAI,OAAO,oBAAoB;OAEvC,SAAQ,IAAI,OAAO,OAAO;;EAG/B,CAAC;;;;;;;;;;;;;;;;;;;;;;AA+BJ,SAAgB,sBACd,SACA,SACG;CAKH,MAAM,EAAE,gBAFN,OAAO,YAAY,WAAW,EAAE,aAAa,SAAS,GAAI,WAAW,EAAE;CAIzE,MAAM,iBAAiB,EACrB,GAAG,SACJ;AAED,gBAAe,cAAc;EAC3B,GAAG,QAAQ;EACX,YAAY,wBAAwB,gBAAgB,YAAY;EAChE,YAAYD,yCAA6B,gBAAgB,YAAY;EACtE;AAED,QAAO"}

package/dist/completion/index.d.cts

@@ -1,6 +1,6 @@
-import "../arg-registry-B4a4Fj7f.cjs";
-import { d as Command, s as AnyCommand } from "../schema-extractor-DyfK21m_.cjs";
-import { S as ShellType, _ as CompletableSubcommand, a as ShellFormatOptions, b as CompletionOptions, c as hasCompleteCommand, d as CompletionDirective, f as generateCandidates, g as CompletableOption, h as parseCompletionContext, i as extractPositionals, l as CandidateResult, m as CompletionType, n as resolveValueCompletion, o as formatForShell, p as CompletionContext, r as extractCompletionData, s as createDynamicCompleteCommand, t as ValueCompletionField, u as CompletionCandidate, v as CompletionData, x as CompletionResult, y as CompletionGenerator } from "../value-completion-resolver-0xf8_07p.cjs";
+import "../arg-registry-BNoIwnNr.cjs";
+import { d as Command, s as AnyCommand } from "../schema-extractor-DFaAZzaY.cjs";
+import { S as ShellType, _ as CompletableSubcommand, a as ShellFormatOptions, b as CompletionOptions, c as hasCompleteCommand, d as CompletionDirective, f as generateCandidates, g as CompletableOption, h as parseCompletionContext, i as extractPositionals, l as CandidateResult, m as CompletionType, n as resolveValueCompletion, o as formatForShell, p as CompletionContext, r as extractCompletionData, s as createDynamicCompleteCommand, t as ValueCompletionField, u as CompletionCandidate, v as CompletionData, x as CompletionResult, y as CompletionGenerator } from "../value-completion-resolver-BQgHsX7b.cjs";
 import { z } from "zod";
 
 //#region src/completion/index.d.ts

package/dist/completion/index.d.ts

@@ -1,6 +1,6 @@
-import "../arg-registry-C3GP-5C9.js";
-import { d as Command, s as AnyCommand } from "../schema-extractor-CHiBRT39.js";
-import { S as ShellType, _ as CompletableSubcommand, a as ShellFormatOptions, b as CompletionOptions, c as hasCompleteCommand, d as CompletionDirective, f as generateCandidates, g as CompletableOption, h as parseCompletionContext, i as extractPositionals, l as CandidateResult, m as CompletionType, n as resolveValueCompletion, o as formatForShell, p as CompletionContext, r as extractCompletionData, s as createDynamicCompleteCommand, t as ValueCompletionField, u as CompletionCandidate, v as CompletionData, x as CompletionResult, y as CompletionGenerator } from "../value-completion-resolver-CUKbibx-.js";
+import "../arg-registry-BUUhZ7JR.js";
+import { d as Command, s as AnyCommand } from "../schema-extractor-n9288WJ6.js";
+import { S as ShellType, _ as CompletableSubcommand, a as ShellFormatOptions, b as CompletionOptions, c as hasCompleteCommand, d as CompletionDirective, f as generateCandidates, g as CompletableOption, h as parseCompletionContext, i as extractPositionals, l as CandidateResult, m as CompletionType, n as resolveValueCompletion, o as formatForShell, p as CompletionContext, r as extractCompletionData, s as createDynamicCompleteCommand, t as ValueCompletionField, u as CompletionCandidate, v as CompletionData, x as CompletionResult, y as CompletionGenerator } from "../value-completion-resolver-C9LTGr0O.js";
 import { z } from "zod";
 
 //#region src/completion/index.d.ts

package/dist/completion/index.js

@@ -1,5 +1,5 @@
-import { a as arg } from "../schema-extractor-DAkmmrOy.js";
-import { a as createDynamicCompleteCommand, c as parseCompletionContext, d as generateCandidates, f as generateBashCompletion, i as generateFishCompletion, l as resolveValueCompletion, n as extractPositionals, o as hasCompleteCommand, p as defineCommand, r as generateZshCompletion, s as formatForShell, t as extractCompletionData, u as CompletionDirective } from "../extractor-DO-FDKkW.js";
+import { c as arg } from "../lazy-BrEg8SgI.js";
+import { a as formatForShell, c as generateCandidates, d as extractPositionals, f as resolveValueCompletion, i as hasCompleteCommand, l as generateBashCompletion, n as generateFishCompletion, o as parseCompletionContext, p as defineCommand, r as createDynamicCompleteCommand, s as CompletionDirective, t as generateZshCompletion, u as extractCompletionData } from "../zsh-hjvdI8uZ.js";
 import { z } from "zod";
 
 //#region src/completion/index.ts

package/dist/docs/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_subcommand_router = require('../subcommand-router-4d1Xbp8B.cjs');
-const require_schema_extractor = require('../schema-extractor-Mk1MHBkQ.cjs');
+const require_subcommand_router = require('../subcommand-router-ZjNjFaUL.cjs');
+const require_lazy = require('../lazy-BEDnSR0m.cjs');
 let zod = require("zod");
 let node_util = require("node:util");
 let node_fs = require("node:fs");
@@ -644,7 +644,7 @@ function deleteFile(filePath, fileSystem = node_fs) {
 * Build CommandInfo from a command
 */
 async function buildCommandInfo(command, rootName, commandPath = []) {
-	const extracted = require_schema_extractor.getExtractedFields(command);
+	const extracted = require_lazy.getExtractedFields(command);
 	const positionalArgs = extracted?.fields.filter((f) => f.positional) ?? [];
 	const options = extracted?.fields.filter((f) => !f.positional) ?? [];
 	const subCommands = [];
@@ -723,7 +723,7 @@ async function executeSingleExample(example, rootCommand, commandPath) {
 	collector.start();
 	let success = true;
 	try {
-		const { runCommand } = await Promise.resolve().then(() => require("../runner-0yr2HFay.cjs")).then((n) => n.runner_exports);
+		const { runCommand } = await Promise.resolve().then(() => require("../runner-CpyB8JiY.cjs")).then((n) => n.runner_exports);
 		const result = await runCommand(rootCommand, argv);
 		success = result.success;
 		if (!result.success && result.error) console.error(result.error.message);
@@ -787,7 +787,7 @@ function parseExampleCmd(cmd) {
 * ResolvedFieldMeta format used by politty's rendering functions.
 */
 function extractArgsFields(args) {
-	return require_schema_extractor.extractFields(zod.z.object(args)).fields;
+	return require_lazy.extractFields(zod.z.object(args)).fields;
 }
 /**
 * Render args definition as a markdown options table
@@ -1350,7 +1350,7 @@ function isGlobalOptionsConfigWithOptions(config) {
 * Positional args are not rendered in args tables, so they must not be excluded.
 */
 function collectRenderableGlobalOptionFields(argsShape) {
-	return require_schema_extractor.extractFields(zod.z.object(argsShape)).fields.filter((field) => !field.positional);
+	return require_lazy.extractFields(zod.z.object(argsShape)).fields.filter((field) => !field.positional);
 }
 /**
 * Compare option definitions for global-options compatibility.