politty 0.4.7 → 0.4.9

package/dist/{index-BA0GkZQx.d.cts → index-DcwMaTvt.d.ts}

@@ -1,4 +1,5 @@
-import { c as AnyCommand, f as Command, l as ArgsSchema, n as ResolvedFieldMeta } from "./schema-extractor-BoWkcP9a.cjs";
+import { c as ArgsSchema, d as Command, s as AnyCommand } from "./arg-registry-CHmAzJOM.js";
+import { n as ResolvedFieldMeta } from "./schema-extractor-D1sJW-sc.js";
 import { z } from "zod";
 
 //#region src/completion/types.d.ts
@@ -367,4 +368,4 @@ interface WithCompletionOptions {
 declare function withCompletionCommand<T extends AnyCommand>(command: T, options?: string | WithCompletionOptions): T;
 //#endregion
 export { CompletableSubcommand as C, CompletionResult as D, CompletionOptions as E, ShellType as O, CompletableOption as S, CompletionGenerator as T, CompletionDirective as _, getSupportedShells as a, CompletionType as b, resolveValueCompletion as c, ShellFormatOptions as d, formatForShell as f, CompletionCandidate as g, CandidateResult as h, generateCompletion as i, extractCompletionData as l, hasCompleteCommand as m, createCompletionCommand as n, withCompletionCommand as o, createDynamicCompleteCommand as p, detectShell as r, ValueCompletionField as s, WithCompletionOptions as t, extractPositionals as u, generateCandidates as v, CompletionData as w, parseCompletionContext as x, CompletionContext as y };
-//# sourceMappingURL=index-BA0GkZQx.d.cts.map
+//# sourceMappingURL=index-DcwMaTvt.d.ts.map

package/dist/index-DcwMaTvt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-DcwMaTvt.d.ts","names":[],"sources":["../src/completion/types.ts","../src/completion/dynamic/context-parser.ts","../src/completion/dynamic/candidate-generator.ts","../src/completion/dynamic/complete-command.ts","../src/completion/dynamic/shell-formatter.ts","../src/completion/extractor.ts","../src/completion/value-completion-resolver.ts","../src/completion/index.ts"],"mappings":"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"}

package/dist/{index-rMDe9hp1.d.ts → index-DjU9BErU.d.cts}

@@ -1,4 +1,5 @@
-import { c as AnyCommand, f as Command, l as ArgsSchema, n as ResolvedFieldMeta } from "./schema-extractor-DoDO4M_i.js";
+import { c as ArgsSchema, d as Command, s as AnyCommand } from "./arg-registry-BDybpyo5.cjs";
+import { n as ResolvedFieldMeta } from "./schema-extractor-RainqdRn.cjs";
 import { z } from "zod";
 
 //#region src/completion/types.d.ts
@@ -367,4 +368,4 @@ interface WithCompletionOptions {
 declare function withCompletionCommand<T extends AnyCommand>(command: T, options?: string | WithCompletionOptions): T;
 //#endregion
 export { CompletableSubcommand as C, CompletionResult as D, CompletionOptions as E, ShellType as O, CompletableOption as S, CompletionGenerator as T, CompletionDirective as _, getSupportedShells as a, CompletionType as b, resolveValueCompletion as c, ShellFormatOptions as d, formatForShell as f, CompletionCandidate as g, CandidateResult as h, generateCompletion as i, extractCompletionData as l, hasCompleteCommand as m, createCompletionCommand as n, withCompletionCommand as o, createDynamicCompleteCommand as p, detectShell as r, ValueCompletionField as s, WithCompletionOptions as t, extractPositionals as u, generateCandidates as v, CompletionData as w, parseCompletionContext as x, CompletionContext as y };
-//# sourceMappingURL=index-rMDe9hp1.d.ts.map
+//# sourceMappingURL=index-DjU9BErU.d.cts.map

package/dist/index-DjU9BErU.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-DjU9BErU.d.cts","names":[],"sources":["../src/completion/types.ts","../src/completion/dynamic/context-parser.ts","../src/completion/dynamic/candidate-generator.ts","../src/completion/dynamic/complete-command.ts","../src/completion/dynamic/shell-formatter.ts","../src/completion/extractor.ts","../src/completion/value-completion-resolver.ts","../src/completion/index.ts"],"mappings":"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"}

package/dist/index.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_lazy = require('./lazy-DHlvJiQQ.cjs');
-const require_completion = require('./completion-Df0eZ70u.cjs');
-const require_runner = require('./runner-Cn6Oq4ZZ.cjs');
+const require_lazy = require('./lazy-B_E2X0KR.cjs');
+const require_completion = require('./completion-BADAzqT9.cjs');
+const require_runner = require('./runner-nKNXknDl.cjs');
 
 exports.DuplicateAliasError = require_runner.DuplicateAliasError;
 exports.DuplicateFieldError = require_runner.DuplicateFieldError;

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { a as arg, i as CustomCompletion, n as CompletionMeta, r as CompletionType, t as ArgMeta } from "./arg-registry-BNoIwnNr.cjs";
-import { A as SubCommandValue, C as NonRunnableCommand, D as RunResultSuccess, E as RunResultFailure, M as LazyCommand, N as isLazyCommand, O as RunnableCommand, P as lazy, S as MainOptions, T as RunResult, _ as GlobalSetupContext, a as getUnknownKeysMode, b as LogStream, c as AnyCommand, d as CollectedLogs, f as Command, g as GlobalCleanupContext, h as GlobalArgs, i as extractFields, j as SubCommandsRecord, k as SetupContext, l as ArgsSchema, m as Example, n as ResolvedFieldMeta, o as toCamelCase, p as CommandBase, r as UnknownKeysMode, s as toKebabCase, t as ExtractedFields, u as CleanupContext, v as LogEntry, w as RunCommandOptions, x as Logger, y as LogLevel } from "./schema-extractor-BoWkcP9a.cjs";
-import { D as CompletionResult, E as CompletionOptions, i as generateCompletion, o as withCompletionCommand, t as WithCompletionOptions } from "./index-BA0GkZQx.cjs";
+import { A as SubCommandValue, C as NonRunnableCommand, D as RunResultSuccess, E as RunResultFailure, M as LazyCommand, N as isLazyCommand, O as RunnableCommand, P as lazy, S as MainOptions, T as RunResult, _ as IsEmpty, a as EffectContext, b as LogStream, c as ArgsSchema, d as Command, f as CommandBase, g as GlobalSetupContext, h as GlobalCleanupContext, i as CustomCompletion, j as SubCommandsRecord, k as SetupContext, l as CleanupContext, m as GlobalArgs, n as CompletionMeta, o as arg, p as Example, r as CompletionType, s as AnyCommand, t as ArgMeta, u as CollectedLogs, v as LogEntry, w as RunCommandOptions, x as Logger, y as LogLevel } from "./arg-registry-BDybpyo5.cjs";
+import { D as CompletionResult, E as CompletionOptions, i as generateCompletion, o as withCompletionCommand, t as WithCompletionOptions } from "./index-DjU9BErU.cjs";
+import { a as getUnknownKeysMode, i as extractFields, n as ResolvedFieldMeta, o as toCamelCase, r as UnknownKeysMode, s as toKebabCase, t as ExtractedFields } from "./schema-extractor-RainqdRn.cjs";
 import { z } from "zod";
 
 //#region src/core/command.d.ts
@@ -8,10 +8,6 @@ import { z } from "zod";
  * Infer args type from schema, defaults to empty object if undefined
  */
 type InferArgs<TArgsSchema> = TArgsSchema extends z.ZodType ? z.infer<TArgsSchema> : Record<string, never>;
-/**
- * Detect empty interface (used for GlobalArgs declaration merging)
- */
-type IsEmpty<T> = keyof T extends never ? true : false;
 /**
  * Merge local args with global args.
  * No-op when TGlobalArgs is empty (default GlobalArgs not extended).
@@ -559,5 +555,5 @@ type ValidationResult<T> = {
  */
 declare function formatValidationErrors(errors: ValidationError[]): string;
 //#endregion
-export { type AnyCommand, type ArgMeta, type ArgsSchema, type BuiltinOptionDescriptions, type CleanupContext, type CollectedLogs, type Command, type CommandBase, type CommandContext, type CommandValidationError, type CommandValidationResult, type CompletionMeta, type CompletionOptions, type CompletionResult, type CompletionType, type CustomCompletion, DuplicateAliasError, DuplicateFieldError, type Example, type ExtractedFields, type GlobalArgs, type GlobalCleanupContext, type GlobalSetupContext, type HelpOptions, type LazyCommand, type LogEntry, type LogLevel, type LogStream, type Logger, type MainOptions, type MergedArgs, type NonRunnableCommand, type ParsedArgv, type ParserOptions, PositionalConfigError, ReservedAliasError, type ResolvedFieldMeta, type RunCommandOptions, type RunResult, type RunResultFailure, type RunResultSuccess, type RunnableCommand, type SetupContext, type SubCommandValue, type SubCommandsRecord, type UnknownKeysMode, type ValidationError, type ValidationResult, type WithCompletionOptions, arg, createDefineCommand, defineCommand, extractFields, formatCommandValidationErrors, formatValidationErrors, generateCompletion, generateHelp, getUnknownKeysMode, isColorEnabled, isLazyCommand, lazy, logger, parseArgv, renderInline, renderMarkdown, runCommand, runMain, setColorEnabled, styles, symbols, toCamelCase, toKebabCase, validateCommand, validateDuplicateAliases, validateDuplicateFields, validatePositionalConfig, validateReservedAliases, withCompletionCommand };
+export { type AnyCommand, type ArgMeta, type ArgsSchema, type BuiltinOptionDescriptions, type CleanupContext, type CollectedLogs, type Command, type CommandBase, type CommandContext, type CommandValidationError, type CommandValidationResult, type CompletionMeta, type CompletionOptions, type CompletionResult, type CompletionType, type CustomCompletion, DuplicateAliasError, DuplicateFieldError, type EffectContext, type Example, type ExtractedFields, type GlobalArgs, type GlobalCleanupContext, type GlobalSetupContext, type HelpOptions, type LazyCommand, type LogEntry, type LogLevel, type LogStream, type Logger, type MainOptions, type MergedArgs, type NonRunnableCommand, type ParsedArgv, type ParserOptions, PositionalConfigError, ReservedAliasError, type ResolvedFieldMeta, type RunCommandOptions, type RunResult, type RunResultFailure, type RunResultSuccess, type RunnableCommand, type SetupContext, type SubCommandValue, type SubCommandsRecord, type UnknownKeysMode, type ValidationError, type ValidationResult, type WithCompletionOptions, arg, createDefineCommand, defineCommand, extractFields, formatCommandValidationErrors, formatValidationErrors, generateCompletion, generateHelp, getUnknownKeysMode, isColorEnabled, isLazyCommand, lazy, logger, parseArgv, renderInline, renderMarkdown, runCommand, runMain, setColorEnabled, styles, symbols, toCamelCase, toKebabCase, validateCommand, validateDuplicateAliases, validateDuplicateFields, validatePositionalConfig, validateReservedAliases, withCompletionCommand };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/core/command.ts","../src/core/runner.ts","../src/output/help-generator.ts","../src/output/logger.ts","../src/output/markdown-renderer.ts","../src/parser/argv-parser.ts","../src/validator/validation-errors.ts","../src/validator/command-validator.ts","../src/validator/zod-validator.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/core/command.ts","../src/core/runner.ts","../src/output/help-generator.ts","../src/output/logger.ts","../src/output/markdown-renderer.ts","../src/parser/argv-parser.ts","../src/validator/validation-errors.ts","../src/validator/command-validator.ts","../src/validator/zod-validator.ts"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { a as arg, i as CustomCompletion, n as CompletionMeta, r as CompletionType, t as ArgMeta } from "./arg-registry-2m40k1Et.js";
-import { A as SubCommandValue, C as NonRunnableCommand, D as RunResultSuccess, E as RunResultFailure, M as LazyCommand, N as isLazyCommand, O as RunnableCommand, P as lazy, S as MainOptions, T as RunResult, _ as GlobalSetupContext, a as getUnknownKeysMode, b as LogStream, c as AnyCommand, d as CollectedLogs, f as Command, g as GlobalCleanupContext, h as GlobalArgs, i as extractFields, j as SubCommandsRecord, k as SetupContext, l as ArgsSchema, m as Example, n as ResolvedFieldMeta, o as toCamelCase, p as CommandBase, r as UnknownKeysMode, s as toKebabCase, t as ExtractedFields, u as CleanupContext, v as LogEntry, w as RunCommandOptions, x as Logger, y as LogLevel } from "./schema-extractor-DoDO4M_i.js";
-import { D as CompletionResult, E as CompletionOptions, i as generateCompletion, o as withCompletionCommand, t as WithCompletionOptions } from "./index-rMDe9hp1.js";
+import { A as SubCommandValue, C as NonRunnableCommand, D as RunResultSuccess, E as RunResultFailure, M as LazyCommand, N as isLazyCommand, O as RunnableCommand, P as lazy, S as MainOptions, T as RunResult, _ as IsEmpty, a as EffectContext, b as LogStream, c as ArgsSchema, d as Command, f as CommandBase, g as GlobalSetupContext, h as GlobalCleanupContext, i as CustomCompletion, j as SubCommandsRecord, k as SetupContext, l as CleanupContext, m as GlobalArgs, n as CompletionMeta, o as arg, p as Example, r as CompletionType, s as AnyCommand, t as ArgMeta, u as CollectedLogs, v as LogEntry, w as RunCommandOptions, x as Logger, y as LogLevel } from "./arg-registry-CHmAzJOM.js";
+import { D as CompletionResult, E as CompletionOptions, i as generateCompletion, o as withCompletionCommand, t as WithCompletionOptions } from "./index-DcwMaTvt.js";
+import { a as getUnknownKeysMode, i as extractFields, n as ResolvedFieldMeta, o as toCamelCase, r as UnknownKeysMode, s as toKebabCase, t as ExtractedFields } from "./schema-extractor-D1sJW-sc.js";
 import { z } from "zod";
 
 //#region src/core/command.d.ts
@@ -8,10 +8,6 @@ import { z } from "zod";
  * Infer args type from schema, defaults to empty object if undefined
  */
 type InferArgs<TArgsSchema> = TArgsSchema extends z.ZodType ? z.infer<TArgsSchema> : Record<string, never>;
-/**
- * Detect empty interface (used for GlobalArgs declaration merging)
- */
-type IsEmpty<T> = keyof T extends never ? true : false;
 /**
  * Merge local args with global args.
  * No-op when TGlobalArgs is empty (default GlobalArgs not extended).
@@ -559,5 +555,5 @@ type ValidationResult<T> = {
  */
 declare function formatValidationErrors(errors: ValidationError[]): string;
 //#endregion
-export { type AnyCommand, type ArgMeta, type ArgsSchema, type BuiltinOptionDescriptions, type CleanupContext, type CollectedLogs, type Command, type CommandBase, type CommandContext, type CommandValidationError, type CommandValidationResult, type CompletionMeta, type CompletionOptions, type CompletionResult, type CompletionType, type CustomCompletion, DuplicateAliasError, DuplicateFieldError, type Example, type ExtractedFields, type GlobalArgs, type GlobalCleanupContext, type GlobalSetupContext, type HelpOptions, type LazyCommand, type LogEntry, type LogLevel, type LogStream, type Logger, type MainOptions, type MergedArgs, type NonRunnableCommand, type ParsedArgv, type ParserOptions, PositionalConfigError, ReservedAliasError, type ResolvedFieldMeta, type RunCommandOptions, type RunResult, type RunResultFailure, type RunResultSuccess, type RunnableCommand, type SetupContext, type SubCommandValue, type SubCommandsRecord, type UnknownKeysMode, type ValidationError, type ValidationResult, type WithCompletionOptions, arg, createDefineCommand, defineCommand, extractFields, formatCommandValidationErrors, formatValidationErrors, generateCompletion, generateHelp, getUnknownKeysMode, isColorEnabled, isLazyCommand, lazy, logger, parseArgv, renderInline, renderMarkdown, runCommand, runMain, setColorEnabled, styles, symbols, toCamelCase, toKebabCase, validateCommand, validateDuplicateAliases, validateDuplicateFields, validatePositionalConfig, validateReservedAliases, withCompletionCommand };
+export { type AnyCommand, type ArgMeta, type ArgsSchema, type BuiltinOptionDescriptions, type CleanupContext, type CollectedLogs, type Command, type CommandBase, type CommandContext, type CommandValidationError, type CommandValidationResult, type CompletionMeta, type CompletionOptions, type CompletionResult, type CompletionType, type CustomCompletion, DuplicateAliasError, DuplicateFieldError, type EffectContext, type Example, type ExtractedFields, type GlobalArgs, type GlobalCleanupContext, type GlobalSetupContext, type HelpOptions, type LazyCommand, type LogEntry, type LogLevel, type LogStream, type Logger, type MainOptions, type MergedArgs, type NonRunnableCommand, type ParsedArgv, type ParserOptions, PositionalConfigError, ReservedAliasError, type ResolvedFieldMeta, type RunCommandOptions, type RunResult, type RunResultFailure, type RunResultSuccess, type RunnableCommand, type SetupContext, type SubCommandValue, type SubCommandsRecord, type UnknownKeysMode, type ValidationError, type ValidationResult, type WithCompletionOptions, arg, createDefineCommand, defineCommand, extractFields, formatCommandValidationErrors, formatValidationErrors, generateCompletion, generateHelp, getUnknownKeysMode, isColorEnabled, isLazyCommand, lazy, logger, parseArgv, renderInline, renderMarkdown, runCommand, runMain, setColorEnabled, styles, symbols, toCamelCase, toKebabCase, validateCommand, validateDuplicateAliases, validateDuplicateFields, validatePositionalConfig, validateReservedAliases, withCompletionCommand };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/core/command.ts","../src/core/runner.ts","../src/output/help-generator.ts","../src/output/logger.ts","../src/output/markdown-renderer.ts","../src/parser/argv-parser.ts","../src/validator/validation-errors.ts","../src/validator/command-validator.ts","../src/validator/zod-validator.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/core/command.ts","../src/core/runner.ts","../src/output/help-generator.ts","../src/output/logger.ts","../src/output/markdown-renderer.ts","../src/parser/argv-parser.ts","../src/validator/validation-errors.ts","../src/validator/command-validator.ts","../src/validator/zod-validator.ts"],"mappings":"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"}

package/dist/index.js

@@ -1,5 +1,5 @@
-import { C as symbols, S as styles, _ as renderInline, a as parseArgv, b as logger, c as validateDuplicateAliases, d as validateReservedAliases, f as DuplicateAliasError, g as generateHelp, h as ReservedAliasError, i as formatValidationErrors, l as validateDuplicateFields, m as PositionalConfigError, n as runMain, o as formatCommandValidationErrors, p as DuplicateFieldError, s as validateCommand, t as runCommand, u as validatePositionalConfig, v as renderMarkdown, x as setColorEnabled, y as isColorEnabled } from "./runner-D4ByDT5I.js";
-import { c as toKebabCase, i as extractFields, l as arg, n as lazy, o as getUnknownKeysMode, s as toCamelCase, t as isLazyCommand } from "./lazy-DSyfzR-F.js";
-import { a as withCompletionCommand, g as defineCommand, h as createDefineCommand, r as generateCompletion } from "./completion-_AnQsWh9.js";
+import { C as symbols, S as styles, _ as renderInline, a as parseArgv, b as logger, c as validateDuplicateAliases, d as validateReservedAliases, f as DuplicateAliasError, g as generateHelp, h as ReservedAliasError, i as formatValidationErrors, l as validateDuplicateFields, m as PositionalConfigError, n as runMain, o as formatCommandValidationErrors, p as DuplicateFieldError, s as validateCommand, t as runCommand, u as validatePositionalConfig, v as renderMarkdown, x as setColorEnabled, y as isColorEnabled } from "./runner-BQcd2UEj.js";
+import { c as toKebabCase, i as extractFields, l as arg, n as lazy, o as getUnknownKeysMode, s as toCamelCase, t as isLazyCommand } from "./lazy-D6nL_iKJ.js";
+import { a as withCompletionCommand, g as defineCommand, h as createDefineCommand, r as generateCompletion } from "./completion-Dj7ytbLu.js";
 
 export { DuplicateAliasError, DuplicateFieldError, PositionalConfigError, ReservedAliasError, arg, createDefineCommand, defineCommand, extractFields, formatCommandValidationErrors, formatValidationErrors, generateCompletion, generateHelp, getUnknownKeysMode, isColorEnabled, isLazyCommand, lazy, logger, parseArgv, renderInline, renderMarkdown, runCommand, runMain, setColorEnabled, styles, symbols, toCamelCase, toKebabCase, validateCommand, validateDuplicateAliases, validateDuplicateFields, validatePositionalConfig, validateReservedAliases, withCompletionCommand };

package/dist/{lazy-DHlvJiQQ.cjs → lazy-B_E2X0KR.cjs}

@@ -1,4 +1,4 @@
-const require_subcommand_router = require('./subcommand-router-sZHhUP7b.cjs');
+const require_subcommand_router = require('./subcommand-router-BTOzDQnY.cjs');
 let zod = require("zod");
 
 //#region src/core/arg-registry.ts
@@ -74,7 +74,7 @@ function unwrapSchema(schema) {
 		if (innerSchema) return unwrapSchema(innerSchema);
 	}
 	if (typeName === "pipe") {
-		const innerSchema = def?.schema;
+		const innerSchema = def?.in ?? def?.schema;
 		if (innerSchema) return unwrapSchema(innerSchema);
 	}
 	return schema;
@@ -215,7 +215,8 @@ function resolveFieldMeta(name, schema) {
 		type: detectType(schema),
 		schema,
 		enumValues,
-		completion: argMeta?.completion
+		completion: argMeta?.completion,
+		effect: argMeta?.effect
 	};
 	if (argMeta && "overrideBuiltinAlias" in argMeta && argMeta.overrideBuiltinAlias === true) meta.overrideBuiltinAlias = true;
 	return meta;
@@ -367,6 +368,28 @@ function extractFields(schema) {
 		case "intersection":
 			result = extractFromIntersection(schema);
 			break;
+		case "pipe": {
+			const pipeInner = def?.in ?? def?.schema;
+			if (pipeInner) {
+				const innerResult = extractFields(pipeInner);
+				const pipeDescription = extractDescription(schema);
+				result = {
+					...innerResult,
+					schema,
+					...pipeDescription ? { description: pipeDescription } : {}
+				};
+				break;
+			}
+			const pipeDescription = extractDescription(schema);
+			result = {
+				fields: [],
+				schema,
+				schemaType: "object",
+				unknownKeysMode: getUnknownKeysMode(schema),
+				...pipeDescription ? { description: pipeDescription } : {}
+			};
+			break;
+		}
 		default: {
 			const description = extractDescription(schema);
 			result = {
@@ -505,4 +528,4 @@ Object.defineProperty(exports, 'toKebabCase', {
     return toKebabCase;
   }
 });
-//# sourceMappingURL=lazy-DHlvJiQQ.cjs.map
+//# sourceMappingURL=lazy-B_E2X0KR.cjs.map

package/dist/lazy-B_E2X0KR.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-B_E2X0KR.cjs","names":["z","getArgMeta","getArgMetaFromRegistry"],"sources":["../src/core/arg-registry.ts","../src/core/schema-extractor.ts","../src/lazy.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport type { GlobalArgs, IsEmpty } from \"../types.js\";\n\n/**\n * Built-in completion types\n */\nexport type CompletionType = \"file\" | \"directory\" | \"none\";\n\n/**\n * Custom completion specification\n */\nexport interface CustomCompletion {\n  /** Static list of choices for completion */\n  choices?: string[];\n  /** Shell command to execute for dynamic completion */\n  shellCommand?: string;\n}\n\n/**\n * Completion metadata for an argument\n *\n * @example\n * ```ts\n * // File completion with extension filter\n * input: arg(z.string(), {\n *   completion: { type: \"file\", extensions: [\"json\", \"yaml\"] }\n * })\n *\n * // Directory completion\n * outputDir: arg(z.string(), {\n *   completion: { type: \"directory\" }\n * })\n *\n * // Custom static choices\n * logLevel: arg(z.string(), {\n *   completion: { custom: { choices: [\"debug\", \"info\", \"warn\", \"error\"] } }\n * })\n *\n * // Dynamic completion from shell command\n * branch: arg(z.string(), {\n *   completion: { custom: { shellCommand: \"git branch --format='%(refname:short)'\" } }\n * })\n *\n * // File completion with glob pattern matcher\n * envFile: arg(z.string(), {\n *   completion: { type: \"file\", matcher: [\".env.*\"] }\n * })\n * ```\n */\nexport type CompletionMeta = {\n  /** Built-in completion type */\n  type?: CompletionType;\n  /** Custom completion (takes precedence over type if both specified) */\n  custom?: CustomCompletion;\n} & (\n  | {\n      /** File extension filter (only applies when type is \"file\") */ extensions?: string[];\n      matcher?: never;\n    }\n  | {\n      /** Glob patterns for file matching (only applies when type is \"file\") */ matcher?: string[];\n      extensions?: never;\n    }\n);\n\n/**\n * Context provided to effect callbacks.\n * When GlobalArgs is extended via declaration merging, `globalArgs` is typed accordingly.\n */\nexport type EffectContext = {\n  /** Field name (camelCase) */\n  name: string;\n  /** Validated args for this schema (global args for global effects, command args for command effects) */\n  args: Readonly<Record<string, unknown>>;\n} & (IsEmpty<GlobalArgs> extends true\n  ? { globalArgs?: Readonly<Record<string, unknown>> }\n  : { globalArgs?: Readonly<GlobalArgs> });\n\n/**\n * Base metadata shared by all argument types\n */\nexport interface BaseArgMeta<TValue = unknown> {\n  /** Argument description */\n  description?: string;\n  /** Treat as positional argument */\n  positional?: boolean;\n  /** Placeholder for help display */\n  placeholder?: string;\n  /**\n   * Environment variable name(s) to read value from.\n   * If an array is provided, earlier entries take priority.\n   * CLI arguments always take precedence over environment variables.\n   *\n   * @example\n   * ```ts\n   * // Single env var\n   * port: arg(z.coerce.number(), { env: \"PORT\" })\n   *\n   * // Multiple env vars (PORT takes priority over SERVER_PORT)\n   * port: arg(z.coerce.number(), { env: [\"PORT\", \"SERVER_PORT\"] })\n   * ```\n   */\n  env?: string | string[];\n  /** Completion configuration for shell tab-completion */\n  completion?: CompletionMeta;\n  /**\n   * Side-effect callback executed after argument parsing and validation.\n   * Runs before the command lifecycle (setup/run/cleanup).\n   * Use Zod .transform() for value transformation instead.\n   *\n   * @example\n   * ```ts\n   * verbose: arg(z.boolean().default(false), {\n   *   alias: \"v\",\n   *   effect: (value) => {\n   *     if (value) logger.setLevel(\"debug\");\n   *   },\n   * })\n   * ```\n   */\n  effect?: (value: TValue, context: EffectContext) => void | PromiseLike<void>;\n}\n\n/**\n * Metadata for regular arguments (non-builtin aliases)\n */\nexport interface RegularArgMeta<TValue = unknown> extends BaseArgMeta<TValue> {\n  /** Short alias (e.g., 'v' for --verbose) */\n  alias?: string;\n}\n\n/**\n * Metadata for overriding built-in aliases (-h, -H)\n */\nexport interface BuiltinOverrideArgMeta<TValue = unknown> extends BaseArgMeta<TValue> {\n  /** Built-in alias to override ('h' or 'H') */\n  alias: \"h\" | \"H\";\n  /** Must be true to override built-in aliases */\n  overrideBuiltinAlias: true;\n}\n\n/**\n * Metadata options for argument definition\n */\nexport type ArgMeta<TValue = unknown> = RegularArgMeta<TValue> | BuiltinOverrideArgMeta<TValue>;\n\n/**\n * Custom registry for politty argument metadata\n * This avoids polluting Zod's GlobalMeta\n */\nexport const argRegistry = z.registry<ArgMeta>();\n\n/**\n * Register metadata for a Zod schema\n *\n * @param schema - The Zod schema\n * @param meta - Argument metadata\n * @returns The same schema (for chaining)\n *\n * @example\n * ```ts\n * import { z } from \"zod\";\n * import { arg, defineCommand } from \"politty\";\n *\n * const cmd = defineCommand({\n *   args: z.object({\n *     name: arg(z.string(), { description: \"User name\", positional: true }),\n *     verbose: arg(z.boolean().default(false), { alias: \"v\" }),\n *   }),\n *   run: (args) => {\n *     console.log(args.name, args.verbose);\n *   },\n * });\n * ```\n */\n/**\n * Type helper to validate ArgMeta\n * Forces a type error if alias is \"h\" or \"H\" without overrideBuiltinAlias: true\n */\ntype ValidateArgMeta<M> = M extends { alias: \"h\" | \"H\" }\n  ? M extends { overrideBuiltinAlias: true }\n    ? M\n    : {\n        [K in keyof M]: M[K];\n      } & {\n        __typeError: \"Alias 'h' or 'H' requires overrideBuiltinAlias: true\";\n      }\n  : M;\n\nexport function arg<T extends z.ZodType>(schema: T): T;\nexport function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(\n  schema: T,\n  meta: ValidateArgMeta<M>,\n): T;\nexport function arg<T extends z.ZodType>(schema: T, meta?: ValidateArgMeta<ArgMeta>): T {\n  if (meta) {\n    argRegistry.add(schema, meta as ArgMeta);\n  }\n  return schema;\n}\n\n/**\n * Get metadata for a schema from the registry\n *\n * @param schema - The Zod schema\n * @returns The metadata if registered, undefined otherwise\n */\nexport function getArgMeta(schema: z.ZodType): ArgMeta | undefined {\n  return argRegistry.get(schema);\n}\n","import { z } from \"zod\";\nimport type { AnyCommand, ArgsSchema } from \"../types.js\";\nimport {\n  getArgMeta as getArgMetaFromRegistry,\n  type ArgMeta,\n  type CompletionMeta,\n  type EffectContext,\n} from \"./arg-registry.js\";\n\n/**\n * Get ArgMeta from both the custom registry and Zod's _def\n * Priority: custom registry > _def.argMeta\n */\nfunction getArgMeta(schema: z.ZodType): ArgMeta | undefined {\n  // First check custom registry\n  const fromRegistry = getArgMetaFromRegistry(schema);\n  if (fromRegistry) return fromRegistry;\n  // Check Zod native meta\n  // Some Zod versions or extensions use a global registry accessed via .meta()\n  if (typeof (schema as any).meta === \"function\") {\n    const meta = (schema as any).meta();\n    if (meta && typeof meta === \"object\") {\n      return meta as ArgMeta;\n    }\n  }\n\n  // Then check _def.argMeta (for augmented Zod types)\n  const def = (schema as any)._def;\n  if (def?.argMeta) return def.argMeta;\n\n  // Also check _def.meta just in case\n  if (def?.meta) return def.meta as ArgMeta;\n\n  return undefined;\n}\n\n/**\n * Resolved metadata for an argument field\n */\nexport interface ResolvedFieldMeta {\n  /** Field name (camelCase, as defined in schema) */\n  name: string;\n  /** CLI option name (kebab-case, for command line usage) */\n  cliName: string;\n  /** Short alias (e.g., 'v' for --verbose) */\n  alias?: string | undefined;\n  /** Argument description */\n  description?: string | undefined;\n  /** Whether this is a positional argument */\n  positional: boolean;\n  /** Placeholder for help display */\n  placeholder?: string | undefined;\n  /**\n   * Environment variable name(s) to read value from.\n   * If an array, earlier entries take priority.\n   */\n  env?: string | string[] | undefined;\n  /** Whether this argument is required */\n  required: boolean;\n  /** Default value if any */\n  defaultValue?: unknown;\n  /** Detected type from schema */\n  type: \"string\" | \"number\" | \"boolean\" | \"array\" | \"unknown\";\n  /** Original Zod schema */\n  schema: z.ZodType;\n  /** True if this overrides built-in aliases (-h, -H) */\n  overrideBuiltinAlias?: true;\n  /** Enum values if detected from schema (z.enum) */\n  enumValues?: string[] | undefined;\n  /** Completion metadata from arg() */\n  completion?: CompletionMeta | undefined;\n  /** Side-effect callback from arg() metadata */\n  effect?: ((value: unknown, context: EffectContext) => void | PromiseLike<void>) | undefined;\n}\n\n/**\n * Extracted fields from a schema\n */\nexport interface ExtractedFields {\n  /** All field definitions */\n  fields: ResolvedFieldMeta[];\n  /** Original schema for validation */\n  schema: ArgsSchema;\n  /** Schema type */\n  schemaType: \"object\" | \"discriminatedUnion\" | \"union\" | \"xor\" | \"intersection\";\n  /** Discriminator key (for discriminatedUnion) */\n  discriminator?: string;\n  /** Variants (for discriminatedUnion) */\n  variants?: Array<{\n    discriminatorValue: string;\n    fields: ResolvedFieldMeta[];\n    description?: string;\n  }>;\n  /** Options (for union) */\n  unionOptions?: ExtractedFields[];\n  /** Schema description */\n  description?: string;\n  /**\n   * Unknown keys handling mode\n   * - \"strict\": Unknown keys cause validation errors (z.strictObject or z.object().strict())\n   * - \"strip\": Unknown keys trigger warnings (default, z.object())\n   * - \"passthrough\": Unknown keys are silently ignored (z.looseObject or z.object().passthrough())\n   */\n  unknownKeysMode: UnknownKeysMode;\n}\n\n/**\n * Unknown keys handling mode for object schemas\n * - \"strict\": Unknown keys cause validation errors\n * - \"strip\": Unknown keys are silently ignored (default)\n * - \"passthrough\": Unknown keys are passed through\n */\nexport type UnknownKeysMode = \"strict\" | \"strip\" | \"passthrough\";\n\n// Internal type for accessing zod v4 internals\ninterface ZodV4Def {\n  type?: string;\n  innerType?: z.ZodType;\n  schema?: z.ZodType;\n  defaultValue?: unknown;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  shape?: Record<string, any>;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  options?: any[];\n  discriminator?: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  left?: any;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  right?: any;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  catchall?: any;\n  /** Pipe input schema (zod v4 transform/refine) */\n  in?: z.ZodType;\n  /** Pipe output schema (zod v4 transform/refine) */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  out?: any;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype ZodSchemaWithDef = z.ZodType & { def?: ZodV4Def; _def?: ZodV4Def; type?: string; shape?: any };\n\n/**\n * Get the type name from a zod schema (v4 compatible)\n */\nfunction getTypeName(schema: z.ZodType): string | undefined {\n  const s = schema as ZodSchemaWithDef;\n  return s.def?.type ?? s._def?.type ?? s.type;\n}\n\n/**\n * Detect unknown keys handling mode from a Zod object schema\n *\n * In Zod v4:\n * - Default (strip): _def.catchall is undefined\n * - strict: _def.catchall is ZodNever (type = \"never\")\n * - passthrough: _def.catchall is ZodUnknown (type = \"unknown\")\n */\nexport function getUnknownKeysMode(schema: z.ZodType): UnknownKeysMode {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  const catchall = def?.catchall;\n\n  if (!catchall) {\n    // Default behavior: strip unknown keys (but we want to warn)\n    return \"strip\";\n  }\n\n  const catchallType = getTypeName(catchall);\n\n  if (catchallType === \"never\") {\n    // z.strictObject() or z.object().strict() - reject unknown keys\n    return \"strict\";\n  }\n\n  if (catchallType === \"unknown\" || catchallType === \"any\") {\n    // z.looseObject() or z.object().passthrough() - allow unknown keys\n    return \"passthrough\";\n  }\n\n  // Unknown catchall type, default to strip behavior\n  return \"strip\";\n}\n\n/**\n * Get the inner schema, unwrapping optional, nullable, default, etc.\n */\nfunction unwrapSchema(schema: z.ZodType): z.ZodType {\n  const typeName = getTypeName(schema);\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  if (typeName === \"optional\" || typeName === \"nullable\" || typeName === \"default\") {\n    const innerSchema = def?.innerType;\n    if (innerSchema) {\n      return unwrapSchema(innerSchema);\n    }\n  }\n\n  // Handle effects (transform, refine, etc.)\n  if (typeName === \"pipe\") {\n    const innerSchema = def?.in ?? def?.schema;\n    if (innerSchema) {\n      return unwrapSchema(innerSchema);\n    }\n  }\n\n  return schema;\n}\n\n/**\n * Detect the base type of a schema\n */\nfunction detectType(schema: z.ZodType): \"string\" | \"number\" | \"boolean\" | \"array\" | \"unknown\" {\n  const innerSchema = unwrapSchema(schema);\n  const typeName = getTypeName(innerSchema);\n\n  switch (typeName) {\n    case \"string\":\n    case \"enum\":\n      return \"string\";\n    case \"number\":\n    case \"int\":\n      return \"number\";\n    case \"boolean\":\n      return \"boolean\";\n    case \"array\":\n      return \"array\";\n    default:\n      return \"unknown\";\n  }\n}\n\n/**\n * Extract enum values from a schema if it's an enum type\n *\n * @param schema - The Zod schema to extract enum values from\n * @returns Array of enum values if schema is an enum, undefined otherwise\n */\nexport function extractEnumValues(schema: z.ZodType): string[] | undefined {\n  const innerSchema = unwrapSchema(schema);\n  const typeName = getTypeName(innerSchema);\n  const s = innerSchema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  if (typeName === \"enum\") {\n    // Zod v4: enum values are in def.entries or def.values\n    const entries = (def as { entries?: Record<string, string> })?.entries;\n    if (entries && typeof entries === \"object\") {\n      return Object.values(entries);\n    }\n\n    // Check for values array (some Zod versions)\n    const values = (def as { values?: string[] })?.values;\n    if (Array.isArray(values)) {\n      return values;\n    }\n\n    // Fallback: check for options property on schema\n    const options = (s as { options?: string[] }).options;\n    if (Array.isArray(options)) {\n      return options;\n    }\n  }\n\n  // Handle array types: extract enum values from the element type\n  if (typeName === \"array\") {\n    const element = (def as { element?: z.ZodType })?.element;\n    if (element) {\n      return extractEnumValues(element);\n    }\n  }\n\n  // Also handle literal union patterns (z.literal(\"a\").or(z.literal(\"b\")))\n  if (typeName === \"union\") {\n    const options = def?.options;\n    if (Array.isArray(options)) {\n      const literalValues: string[] = [];\n      for (const option of options) {\n        const optionTypeName = getTypeName(option);\n        if (optionTypeName === \"literal\") {\n          const optionDef = (option as ZodSchemaWithDef).def ?? (option as ZodSchemaWithDef)._def;\n          const value = (optionDef as { value?: unknown; values?: unknown[] })?.value;\n          const values = (optionDef as { value?: unknown; values?: unknown[] })?.values;\n          const literalValue = value ?? values?.[0];\n          if (typeof literalValue === \"string\") {\n            literalValues.push(literalValue);\n          }\n        }\n      }\n      // Only return if all options are string literals\n      if (literalValues.length === options.length && literalValues.length > 0) {\n        return literalValues;\n      }\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Convert camelCase to kebab-case\n * @example toKebabCase(\"dryRun\") => \"dry-run\"\n * @example toKebabCase(\"outputDir\") => \"output-dir\"\n * @example toKebabCase(\"XMLParser\") => \"xml-parser\"\n */\nexport function toKebabCase(str: string): string {\n  return str\n    .replace(/([a-z])([A-Z])/g, \"$1-$2\")\n    .replace(/([A-Z]+)([A-Z][a-z])/g, \"$1-$2\")\n    .toLowerCase();\n}\n\n/**\n * Convert hyphen-separated sequences to camelCase.\n *\n * Replaces `-x` (hyphen followed by a lowercase letter) with the uppercase\n * variant. Non-hyphenated input (e.g., already camelCase) is returned as-is.\n *\n * @param str - A string that may contain hyphens\n * @example toCamelCase(\"dry-run\") => \"dryRun\"\n * @example toCamelCase(\"output-dir\") => \"outputDir\"\n * @example toCamelCase(\"dryRun\") => \"dryRun\"\n */\nexport function toCamelCase(str: string): string {\n  return str.replace(/-([a-z])/g, (_, char) => char.toUpperCase());\n}\n\n/**\n * Check if a schema is required (not optional or has default)\n *\n * Note: We only check isOptional(), not isNullable(), because CLI arguments\n * are either present (string value) or absent (undefined), never null.\n * Also, some coerce types incorrectly report isNullable()=true.\n */\nfunction isRequired(schema: z.ZodType): boolean {\n  return !schema.isOptional();\n}\n\n/**\n * Extract default value from schema if present\n */\nfunction extractDefaultValue(schema: z.ZodType): unknown {\n  const typeName = getTypeName(schema);\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  if (typeName === \"default\") {\n    const defaultValue = def?.defaultValue;\n    // In zod v4, defaultValue can be a direct value or a function\n    if (typeof defaultValue === \"function\") {\n      return defaultValue();\n    }\n    return defaultValue;\n  }\n\n  // Check for nested default in optional/nullable\n  if (typeName === \"optional\" || typeName === \"nullable\") {\n    const innerSchema = def?.innerType;\n    if (innerSchema) {\n      return extractDefaultValue(innerSchema);\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Extract description from schema\n */\nfunction extractDescription(schema: z.ZodType): string | undefined {\n  // Check direct description\n  if (schema.description) {\n    return schema.description;\n  }\n\n  // Check inner schema for wrapped types\n  const typeName = getTypeName(schema);\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  if (typeName === \"optional\" || typeName === \"nullable\" || typeName === \"default\") {\n    const innerSchema = def?.innerType;\n    if (innerSchema) {\n      return extractDescription(innerSchema);\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Resolve field metadata from schema and argRegistry\n */\nfunction resolveFieldMeta(name: string, schema: z.ZodType): ResolvedFieldMeta {\n  // Get metadata from argRegistry\n  const argMeta = getArgMeta(schema) ?? getArgMeta(unwrapSchema(schema));\n\n  // Priority: argRegistry > schema.describe()\n  const description = argMeta?.description ?? extractDescription(schema);\n\n  // Convert camelCase field name to kebab-case for CLI usage\n  const cliName = toKebabCase(name);\n\n  // Extract enum values from schema\n  const enumValues = extractEnumValues(schema);\n\n  const meta: ResolvedFieldMeta = {\n    name,\n    cliName,\n    alias: argMeta?.alias,\n    description,\n    positional: argMeta?.positional ?? false,\n    placeholder: argMeta?.placeholder,\n    env: argMeta?.env,\n    required: isRequired(schema),\n    defaultValue: extractDefaultValue(schema),\n    type: detectType(schema),\n    schema,\n    enumValues,\n    completion: argMeta?.completion,\n    effect: argMeta?.effect,\n  };\n\n  // Add overrideBuiltinAlias only if it's true\n  if (argMeta && \"overrideBuiltinAlias\" in argMeta && argMeta.overrideBuiltinAlias === true) {\n    meta.overrideBuiltinAlias = true;\n  }\n\n  return meta;\n}\n\n/**\n * Get shape from a ZodObject\n */\nfunction getObjectShape(schema: z.ZodType): Record<string, z.ZodType> {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  return def?.shape ?? s.shape ?? {};\n}\n\n/**\n * Extract fields from a ZodObject\n */\nfunction extractFromObject(schema: z.ZodType): ResolvedFieldMeta[] {\n  const shape = getObjectShape(schema);\n  return Object.entries(shape).map(([name, fieldSchema]) => resolveFieldMeta(name, fieldSchema));\n}\n\n/**\n * Extract fields from a discriminated union\n */\nfunction extractFromDiscriminatedUnion(schema: z.ZodType): ExtractedFields {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  const discriminator = def?.discriminator ?? \"\";\n  const options = def?.options ?? [];\n\n  // Collect all unique fields across all variants\n  const allFieldsMap = new Map<string, ResolvedFieldMeta>();\n  const variants: ExtractedFields[\"variants\"] = [];\n\n  for (const option of options) {\n    const shape = getObjectShape(option as z.ZodObject<z.ZodRawShape>);\n    const variantFields: ResolvedFieldMeta[] = [];\n\n    // Get discriminator value\n    let discriminatorValue = \"\";\n    const discriminatorSchema = shape[discriminator];\n    if (discriminatorSchema) {\n      const typeName = getTypeName(discriminatorSchema);\n      if (typeName === \"literal\") {\n        const litDef =\n          (discriminatorSchema as ZodSchemaWithDef).def ??\n          (discriminatorSchema as ZodSchemaWithDef)._def;\n        // In Zod v4, literal values are in _def.values array\n        const value = (litDef as { value?: unknown; values?: unknown[] })?.value;\n        const values = (litDef as { value?: unknown; values?: unknown[] })?.values;\n        discriminatorValue = String(value ?? values?.[0] ?? \"\");\n      }\n    }\n\n    for (const [name, fieldSchema] of Object.entries(shape)) {\n      const fieldMeta = resolveFieldMeta(name, fieldSchema);\n      variantFields.push(fieldMeta);\n\n      // Add to all fields map (first occurrence wins for metadata)\n      if (!allFieldsMap.has(name)) {\n        allFieldsMap.set(name, fieldMeta);\n      }\n    }\n\n    // Extract description from the variant option\n    const variantDescription = extractDescription(option as z.ZodType);\n\n    variants.push({\n      discriminatorValue,\n      fields: variantFields,\n      ...(variantDescription ? { description: variantDescription } : {}),\n    });\n  }\n\n  const description = extractDescription(schema);\n  return {\n    fields: Array.from(allFieldsMap.values()),\n    schema: schema as ArgsSchema,\n    schemaType: \"discriminatedUnion\",\n    unknownKeysMode: getUnknownKeysMode(schema),\n    discriminator,\n    variants,\n    ...(description ? { description } : {}),\n  };\n}\n\n/**\n * Extract fields from a union-like schema (union or xor)\n */\nfunction extractFromUnionLike(schema: z.ZodType, schemaType: \"union\" | \"xor\"): ExtractedFields {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  const options = def?.options ?? [];\n\n  // Collect all unique fields across all options\n  const allFieldsMap = new Map<string, ResolvedFieldMeta>();\n  const unionOptions: ExtractedFields[] = [];\n\n  for (const option of options) {\n    // Extract fields for this option recursively\n    // We cast to ArgsSchema because we expect options to be objects or other supported types\n    const extracted = extractFields(option as ArgsSchema);\n    unionOptions.push(extracted);\n\n    // Add to combined fields map\n    for (const field of extracted.fields) {\n      if (!allFieldsMap.has(field.name)) {\n        allFieldsMap.set(field.name, field);\n      }\n    }\n  }\n\n  const description = extractDescription(schema);\n  return {\n    fields: Array.from(allFieldsMap.values()),\n    schema: schema as ArgsSchema,\n    schemaType,\n    unknownKeysMode: getUnknownKeysMode(schema),\n    unionOptions,\n    ...(description ? { description } : {}),\n  };\n}\n\n/**\n * Extract fields from an intersection\n */\nfunction extractFromIntersection(schema: z.ZodType): ExtractedFields {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  const left = def?.left;\n  const right = def?.right;\n\n  const allFieldsMap = new Map<string, ResolvedFieldMeta>();\n\n  // Helper to extract fields from a sub-schema\n  const extractSubFields = (subSchema: z.ZodType | undefined) => {\n    if (!subSchema) return;\n\n    const extracted = extractFields(subSchema as ArgsSchema);\n    for (const field of extracted.fields) {\n      if (!allFieldsMap.has(field.name)) {\n        allFieldsMap.set(field.name, field);\n      }\n    }\n  };\n\n  extractSubFields(left);\n  extractSubFields(right);\n\n  const description = extractDescription(schema);\n  return {\n    fields: Array.from(allFieldsMap.values()),\n    schema: schema as ArgsSchema,\n    schemaType: \"intersection\",\n    unknownKeysMode: getUnknownKeysMode(schema),\n    ...(description ? { description } : {}),\n  };\n}\n\n/**\n * Cache for extractFields results to avoid redundant schema extraction\n */\nconst extractFieldsCache = new WeakMap<ArgsSchema, ExtractedFields>();\n\n/**\n * Extract all fields from a schema\n *\n * @param schema - The args schema (ZodObject, ZodDiscriminatedUnion, etc.)\n * @returns Extracted field information\n */\nexport function extractFields(schema: ArgsSchema): ExtractedFields {\n  const cached = extractFieldsCache.get(schema);\n  if (cached) return cached;\n\n  let result: ExtractedFields;\n  const typeName = getTypeName(schema);\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  switch (typeName) {\n    case \"object\": {\n      const description = extractDescription(schema);\n      result = {\n        fields: extractFromObject(schema),\n        schema,\n        schemaType: \"object\",\n        unknownKeysMode: getUnknownKeysMode(schema),\n        ...(description ? { description } : {}),\n      };\n      break;\n    }\n\n    case \"union\":\n      // In Zod v4, discriminatedUnion has type \"union\" with a discriminator property\n      if (def?.discriminator) {\n        result = extractFromDiscriminatedUnion(schema);\n      } else {\n        result = extractFromUnionLike(schema, \"union\");\n      }\n      break;\n\n    case \"xor\":\n      result = extractFromUnionLike(schema, \"xor\");\n      break;\n\n    case \"intersection\":\n      result = extractFromIntersection(schema);\n      break;\n\n    case \"pipe\": {\n      // Handle transform/refine on top-level schema (e.g., z.object({...}).transform(...))\n      const pipeInner = def?.in ?? def?.schema;\n      if (pipeInner) {\n        const innerResult = extractFields(pipeInner as ArgsSchema);\n        const pipeDescription = extractDescription(schema);\n        result = {\n          ...innerResult,\n          schema,\n          ...(pipeDescription ? { description: pipeDescription } : {}),\n        };\n        break;\n      }\n      const pipeDescription = extractDescription(schema);\n      result = {\n        fields: [],\n        schema,\n        schemaType: \"object\",\n        unknownKeysMode: getUnknownKeysMode(schema),\n        ...(pipeDescription ? { description: pipeDescription } : {}),\n      };\n      break;\n    }\n\n    default: {\n      const description = extractDescription(schema);\n      // Fallback: try to treat as object\n      result = {\n        fields: [],\n        schema,\n        schemaType: \"object\",\n        unknownKeysMode: getUnknownKeysMode(schema),\n        ...(description ? { description } : {}),\n      };\n      break;\n    }\n  }\n\n  extractFieldsCache.set(schema, result);\n  return result;\n}\n\n/**\n * Get extracted fields from a command\n *\n * @param command - The command to extract fields from\n * @returns Extracted field information, or null if command has no args schema\n */\nexport function getExtractedFields(command: AnyCommand): ExtractedFields | null {\n  if (!command.args) {\n    return null;\n  }\n  return extractFields(command.args);\n}\n","/**\n * Lazy-loaded subcommand with synchronous metadata\n */\n\nimport type { AnyCommand, SubCommandValue } from \"./types.js\";\n\n/**\n * Marker property for LazyCommand identification\n */\nconst LAZY_BRAND = \"__politty_lazy__\" as const;\n\n/**\n * A lazily-loaded command that carries synchronous metadata for\n * static analysis (completion, help) while deferring full module\n * loading to execution time.\n */\nexport interface LazyCommand<T extends AnyCommand = AnyCommand> {\n  readonly __politty_lazy__: true;\n  readonly meta: T;\n  readonly load: () => Promise<AnyCommand>;\n}\n\n/**\n * Type guard: check if a value is a LazyCommand\n */\nexport function isLazyCommand(value: unknown): value is LazyCommand {\n  return (\n    typeof value === \"object\" && value !== null && LAZY_BRAND in value && value[LAZY_BRAND] === true\n  );\n}\n\n/**\n * Create a lazily-loaded subcommand with synchronous metadata.\n *\n * The `meta` command provides names, descriptions, and args schema\n * for static analysis (completion scripts, help text) without loading\n * the full command module.\n *\n * The `load` function is called only at execution time.\n *\n * @example\n * ```ts\n * import { lazy, defineCommand } from \"politty\";\n *\n * const cli = defineCommand({\n *   name: \"mycli\",\n *   subCommands: {\n *     deploy: lazy(\n *       defineCommand({\n *         name: \"deploy\",\n *         description: \"Deploy the application\",\n *         args: z.object({ env: arg(z.string()) }),\n *       }),\n *       () => import(\"./deploy.js\").then((m) => m.deployCommand),\n *     ),\n *   },\n * });\n * ```\n */\nexport function lazy<T extends AnyCommand>(\n  meta: T,\n  load: () => Promise<AnyCommand>,\n): LazyCommand<T> {\n  return {\n    [LAZY_BRAND]: true as const,\n    meta,\n    load,\n  };\n}\n\n/**\n * Resolve synchronous metadata from a SubCommandValue.\n * Returns null for legacy async subcommands whose metadata is unavailable.\n */\nexport function resolveSubCommandMeta(subCmd: SubCommandValue): AnyCommand | null {\n  if (isLazyCommand(subCmd)) return subCmd.meta;\n  if (typeof subCmd === \"function\") return null;\n  return subCmd;\n}\n"],"mappings":"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"}

package/dist/{lazy-DSyfzR-F.js → lazy-D6nL_iKJ.js}

@@ -73,7 +73,7 @@ function unwrapSchema(schema) {
 		if (innerSchema) return unwrapSchema(innerSchema);
 	}
 	if (typeName === "pipe") {
-		const innerSchema = def?.schema;
+		const innerSchema = def?.in ?? def?.schema;
 		if (innerSchema) return unwrapSchema(innerSchema);
 	}
 	return schema;
@@ -214,7 +214,8 @@ function resolveFieldMeta(name, schema) {
 		type: detectType(schema),
 		schema,
 		enumValues,
-		completion: argMeta?.completion
+		completion: argMeta?.completion,
+		effect: argMeta?.effect
 	};
 	if (argMeta && "overrideBuiltinAlias" in argMeta && argMeta.overrideBuiltinAlias === true) meta.overrideBuiltinAlias = true;
 	return meta;
@@ -366,6 +367,28 @@ function extractFields(schema) {
 		case "intersection":
 			result = extractFromIntersection(schema);
 			break;
+		case "pipe": {
+			const pipeInner = def?.in ?? def?.schema;
+			if (pipeInner) {
+				const innerResult = extractFields(pipeInner);
+				const pipeDescription = extractDescription(schema);
+				result = {
+					...innerResult,
+					schema,
+					...pipeDescription ? { description: pipeDescription } : {}
+				};
+				break;
+			}
+			const pipeDescription = extractDescription(schema);
+			result = {
+				fields: [],
+				schema,
+				schemaType: "object",
+				unknownKeysMode: getUnknownKeysMode(schema),
+				...pipeDescription ? { description: pipeDescription } : {}
+			};
+			break;
+		}
 		default: {
 			const description = extractDescription(schema);
 			result = {
@@ -451,4 +474,4 @@ function resolveSubCommandMeta(subCmd) {
 
 //#endregion
 export { getExtractedFields as a, toKebabCase as c, extractFields as i, arg as l, lazy as n, getUnknownKeysMode as o, resolveSubCommandMeta as r, toCamelCase as s, isLazyCommand as t };
-//# sourceMappingURL=lazy-DSyfzR-F.js.map
+//# sourceMappingURL=lazy-D6nL_iKJ.js.map

package/dist/lazy-D6nL_iKJ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-D6nL_iKJ.js","names":["getArgMeta","getArgMetaFromRegistry"],"sources":["../src/core/arg-registry.ts","../src/core/schema-extractor.ts","../src/lazy.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport type { GlobalArgs, IsEmpty } from \"../types.js\";\n\n/**\n * Built-in completion types\n */\nexport type CompletionType = \"file\" | \"directory\" | \"none\";\n\n/**\n * Custom completion specification\n */\nexport interface CustomCompletion {\n  /** Static list of choices for completion */\n  choices?: string[];\n  /** Shell command to execute for dynamic completion */\n  shellCommand?: string;\n}\n\n/**\n * Completion metadata for an argument\n *\n * @example\n * ```ts\n * // File completion with extension filter\n * input: arg(z.string(), {\n *   completion: { type: \"file\", extensions: [\"json\", \"yaml\"] }\n * })\n *\n * // Directory completion\n * outputDir: arg(z.string(), {\n *   completion: { type: \"directory\" }\n * })\n *\n * // Custom static choices\n * logLevel: arg(z.string(), {\n *   completion: { custom: { choices: [\"debug\", \"info\", \"warn\", \"error\"] } }\n * })\n *\n * // Dynamic completion from shell command\n * branch: arg(z.string(), {\n *   completion: { custom: { shellCommand: \"git branch --format='%(refname:short)'\" } }\n * })\n *\n * // File completion with glob pattern matcher\n * envFile: arg(z.string(), {\n *   completion: { type: \"file\", matcher: [\".env.*\"] }\n * })\n * ```\n */\nexport type CompletionMeta = {\n  /** Built-in completion type */\n  type?: CompletionType;\n  /** Custom completion (takes precedence over type if both specified) */\n  custom?: CustomCompletion;\n} & (\n  | {\n      /** File extension filter (only applies when type is \"file\") */ extensions?: string[];\n      matcher?: never;\n    }\n  | {\n      /** Glob patterns for file matching (only applies when type is \"file\") */ matcher?: string[];\n      extensions?: never;\n    }\n);\n\n/**\n * Context provided to effect callbacks.\n * When GlobalArgs is extended via declaration merging, `globalArgs` is typed accordingly.\n */\nexport type EffectContext = {\n  /** Field name (camelCase) */\n  name: string;\n  /** Validated args for this schema (global args for global effects, command args for command effects) */\n  args: Readonly<Record<string, unknown>>;\n} & (IsEmpty<GlobalArgs> extends true\n  ? { globalArgs?: Readonly<Record<string, unknown>> }\n  : { globalArgs?: Readonly<GlobalArgs> });\n\n/**\n * Base metadata shared by all argument types\n */\nexport interface BaseArgMeta<TValue = unknown> {\n  /** Argument description */\n  description?: string;\n  /** Treat as positional argument */\n  positional?: boolean;\n  /** Placeholder for help display */\n  placeholder?: string;\n  /**\n   * Environment variable name(s) to read value from.\n   * If an array is provided, earlier entries take priority.\n   * CLI arguments always take precedence over environment variables.\n   *\n   * @example\n   * ```ts\n   * // Single env var\n   * port: arg(z.coerce.number(), { env: \"PORT\" })\n   *\n   * // Multiple env vars (PORT takes priority over SERVER_PORT)\n   * port: arg(z.coerce.number(), { env: [\"PORT\", \"SERVER_PORT\"] })\n   * ```\n   */\n  env?: string | string[];\n  /** Completion configuration for shell tab-completion */\n  completion?: CompletionMeta;\n  /**\n   * Side-effect callback executed after argument parsing and validation.\n   * Runs before the command lifecycle (setup/run/cleanup).\n   * Use Zod .transform() for value transformation instead.\n   *\n   * @example\n   * ```ts\n   * verbose: arg(z.boolean().default(false), {\n   *   alias: \"v\",\n   *   effect: (value) => {\n   *     if (value) logger.setLevel(\"debug\");\n   *   },\n   * })\n   * ```\n   */\n  effect?: (value: TValue, context: EffectContext) => void | PromiseLike<void>;\n}\n\n/**\n * Metadata for regular arguments (non-builtin aliases)\n */\nexport interface RegularArgMeta<TValue = unknown> extends BaseArgMeta<TValue> {\n  /** Short alias (e.g., 'v' for --verbose) */\n  alias?: string;\n}\n\n/**\n * Metadata for overriding built-in aliases (-h, -H)\n */\nexport interface BuiltinOverrideArgMeta<TValue = unknown> extends BaseArgMeta<TValue> {\n  /** Built-in alias to override ('h' or 'H') */\n  alias: \"h\" | \"H\";\n  /** Must be true to override built-in aliases */\n  overrideBuiltinAlias: true;\n}\n\n/**\n * Metadata options for argument definition\n */\nexport type ArgMeta<TValue = unknown> = RegularArgMeta<TValue> | BuiltinOverrideArgMeta<TValue>;\n\n/**\n * Custom registry for politty argument metadata\n * This avoids polluting Zod's GlobalMeta\n */\nexport const argRegistry = z.registry<ArgMeta>();\n\n/**\n * Register metadata for a Zod schema\n *\n * @param schema - The Zod schema\n * @param meta - Argument metadata\n * @returns The same schema (for chaining)\n *\n * @example\n * ```ts\n * import { z } from \"zod\";\n * import { arg, defineCommand } from \"politty\";\n *\n * const cmd = defineCommand({\n *   args: z.object({\n *     name: arg(z.string(), { description: \"User name\", positional: true }),\n *     verbose: arg(z.boolean().default(false), { alias: \"v\" }),\n *   }),\n *   run: (args) => {\n *     console.log(args.name, args.verbose);\n *   },\n * });\n * ```\n */\n/**\n * Type helper to validate ArgMeta\n * Forces a type error if alias is \"h\" or \"H\" without overrideBuiltinAlias: true\n */\ntype ValidateArgMeta<M> = M extends { alias: \"h\" | \"H\" }\n  ? M extends { overrideBuiltinAlias: true }\n    ? M\n    : {\n        [K in keyof M]: M[K];\n      } & {\n        __typeError: \"Alias 'h' or 'H' requires overrideBuiltinAlias: true\";\n      }\n  : M;\n\nexport function arg<T extends z.ZodType>(schema: T): T;\nexport function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(\n  schema: T,\n  meta: ValidateArgMeta<M>,\n): T;\nexport function arg<T extends z.ZodType>(schema: T, meta?: ValidateArgMeta<ArgMeta>): T {\n  if (meta) {\n    argRegistry.add(schema, meta as ArgMeta);\n  }\n  return schema;\n}\n\n/**\n * Get metadata for a schema from the registry\n *\n * @param schema - The Zod schema\n * @returns The metadata if registered, undefined otherwise\n */\nexport function getArgMeta(schema: z.ZodType): ArgMeta | undefined {\n  return argRegistry.get(schema);\n}\n","import { z } from \"zod\";\nimport type { AnyCommand, ArgsSchema } from \"../types.js\";\nimport {\n  getArgMeta as getArgMetaFromRegistry,\n  type ArgMeta,\n  type CompletionMeta,\n  type EffectContext,\n} from \"./arg-registry.js\";\n\n/**\n * Get ArgMeta from both the custom registry and Zod's _def\n * Priority: custom registry > _def.argMeta\n */\nfunction getArgMeta(schema: z.ZodType): ArgMeta | undefined {\n  // First check custom registry\n  const fromRegistry = getArgMetaFromRegistry(schema);\n  if (fromRegistry) return fromRegistry;\n  // Check Zod native meta\n  // Some Zod versions or extensions use a global registry accessed via .meta()\n  if (typeof (schema as any).meta === \"function\") {\n    const meta = (schema as any).meta();\n    if (meta && typeof meta === \"object\") {\n      return meta as ArgMeta;\n    }\n  }\n\n  // Then check _def.argMeta (for augmented Zod types)\n  const def = (schema as any)._def;\n  if (def?.argMeta) return def.argMeta;\n\n  // Also check _def.meta just in case\n  if (def?.meta) return def.meta as ArgMeta;\n\n  return undefined;\n}\n\n/**\n * Resolved metadata for an argument field\n */\nexport interface ResolvedFieldMeta {\n  /** Field name (camelCase, as defined in schema) */\n  name: string;\n  /** CLI option name (kebab-case, for command line usage) */\n  cliName: string;\n  /** Short alias (e.g., 'v' for --verbose) */\n  alias?: string | undefined;\n  /** Argument description */\n  description?: string | undefined;\n  /** Whether this is a positional argument */\n  positional: boolean;\n  /** Placeholder for help display */\n  placeholder?: string | undefined;\n  /**\n   * Environment variable name(s) to read value from.\n   * If an array, earlier entries take priority.\n   */\n  env?: string | string[] | undefined;\n  /** Whether this argument is required */\n  required: boolean;\n  /** Default value if any */\n  defaultValue?: unknown;\n  /** Detected type from schema */\n  type: \"string\" | \"number\" | \"boolean\" | \"array\" | \"unknown\";\n  /** Original Zod schema */\n  schema: z.ZodType;\n  /** True if this overrides built-in aliases (-h, -H) */\n  overrideBuiltinAlias?: true;\n  /** Enum values if detected from schema (z.enum) */\n  enumValues?: string[] | undefined;\n  /** Completion metadata from arg() */\n  completion?: CompletionMeta | undefined;\n  /** Side-effect callback from arg() metadata */\n  effect?: ((value: unknown, context: EffectContext) => void | PromiseLike<void>) | undefined;\n}\n\n/**\n * Extracted fields from a schema\n */\nexport interface ExtractedFields {\n  /** All field definitions */\n  fields: ResolvedFieldMeta[];\n  /** Original schema for validation */\n  schema: ArgsSchema;\n  /** Schema type */\n  schemaType: \"object\" | \"discriminatedUnion\" | \"union\" | \"xor\" | \"intersection\";\n  /** Discriminator key (for discriminatedUnion) */\n  discriminator?: string;\n  /** Variants (for discriminatedUnion) */\n  variants?: Array<{\n    discriminatorValue: string;\n    fields: ResolvedFieldMeta[];\n    description?: string;\n  }>;\n  /** Options (for union) */\n  unionOptions?: ExtractedFields[];\n  /** Schema description */\n  description?: string;\n  /**\n   * Unknown keys handling mode\n   * - \"strict\": Unknown keys cause validation errors (z.strictObject or z.object().strict())\n   * - \"strip\": Unknown keys trigger warnings (default, z.object())\n   * - \"passthrough\": Unknown keys are silently ignored (z.looseObject or z.object().passthrough())\n   */\n  unknownKeysMode: UnknownKeysMode;\n}\n\n/**\n * Unknown keys handling mode for object schemas\n * - \"strict\": Unknown keys cause validation errors\n * - \"strip\": Unknown keys are silently ignored (default)\n * - \"passthrough\": Unknown keys are passed through\n */\nexport type UnknownKeysMode = \"strict\" | \"strip\" | \"passthrough\";\n\n// Internal type for accessing zod v4 internals\ninterface ZodV4Def {\n  type?: string;\n  innerType?: z.ZodType;\n  schema?: z.ZodType;\n  defaultValue?: unknown;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  shape?: Record<string, any>;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  options?: any[];\n  discriminator?: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  left?: any;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  right?: any;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  catchall?: any;\n  /** Pipe input schema (zod v4 transform/refine) */\n  in?: z.ZodType;\n  /** Pipe output schema (zod v4 transform/refine) */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  out?: any;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype ZodSchemaWithDef = z.ZodType & { def?: ZodV4Def; _def?: ZodV4Def; type?: string; shape?: any };\n\n/**\n * Get the type name from a zod schema (v4 compatible)\n */\nfunction getTypeName(schema: z.ZodType): string | undefined {\n  const s = schema as ZodSchemaWithDef;\n  return s.def?.type ?? s._def?.type ?? s.type;\n}\n\n/**\n * Detect unknown keys handling mode from a Zod object schema\n *\n * In Zod v4:\n * - Default (strip): _def.catchall is undefined\n * - strict: _def.catchall is ZodNever (type = \"never\")\n * - passthrough: _def.catchall is ZodUnknown (type = \"unknown\")\n */\nexport function getUnknownKeysMode(schema: z.ZodType): UnknownKeysMode {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  const catchall = def?.catchall;\n\n  if (!catchall) {\n    // Default behavior: strip unknown keys (but we want to warn)\n    return \"strip\";\n  }\n\n  const catchallType = getTypeName(catchall);\n\n  if (catchallType === \"never\") {\n    // z.strictObject() or z.object().strict() - reject unknown keys\n    return \"strict\";\n  }\n\n  if (catchallType === \"unknown\" || catchallType === \"any\") {\n    // z.looseObject() or z.object().passthrough() - allow unknown keys\n    return \"passthrough\";\n  }\n\n  // Unknown catchall type, default to strip behavior\n  return \"strip\";\n}\n\n/**\n * Get the inner schema, unwrapping optional, nullable, default, etc.\n */\nfunction unwrapSchema(schema: z.ZodType): z.ZodType {\n  const typeName = getTypeName(schema);\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  if (typeName === \"optional\" || typeName === \"nullable\" || typeName === \"default\") {\n    const innerSchema = def?.innerType;\n    if (innerSchema) {\n      return unwrapSchema(innerSchema);\n    }\n  }\n\n  // Handle effects (transform, refine, etc.)\n  if (typeName === \"pipe\") {\n    const innerSchema = def?.in ?? def?.schema;\n    if (innerSchema) {\n      return unwrapSchema(innerSchema);\n    }\n  }\n\n  return schema;\n}\n\n/**\n * Detect the base type of a schema\n */\nfunction detectType(schema: z.ZodType): \"string\" | \"number\" | \"boolean\" | \"array\" | \"unknown\" {\n  const innerSchema = unwrapSchema(schema);\n  const typeName = getTypeName(innerSchema);\n\n  switch (typeName) {\n    case \"string\":\n    case \"enum\":\n      return \"string\";\n    case \"number\":\n    case \"int\":\n      return \"number\";\n    case \"boolean\":\n      return \"boolean\";\n    case \"array\":\n      return \"array\";\n    default:\n      return \"unknown\";\n  }\n}\n\n/**\n * Extract enum values from a schema if it's an enum type\n *\n * @param schema - The Zod schema to extract enum values from\n * @returns Array of enum values if schema is an enum, undefined otherwise\n */\nexport function extractEnumValues(schema: z.ZodType): string[] | undefined {\n  const innerSchema = unwrapSchema(schema);\n  const typeName = getTypeName(innerSchema);\n  const s = innerSchema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  if (typeName === \"enum\") {\n    // Zod v4: enum values are in def.entries or def.values\n    const entries = (def as { entries?: Record<string, string> })?.entries;\n    if (entries && typeof entries === \"object\") {\n      return Object.values(entries);\n    }\n\n    // Check for values array (some Zod versions)\n    const values = (def as { values?: string[] })?.values;\n    if (Array.isArray(values)) {\n      return values;\n    }\n\n    // Fallback: check for options property on schema\n    const options = (s as { options?: string[] }).options;\n    if (Array.isArray(options)) {\n      return options;\n    }\n  }\n\n  // Handle array types: extract enum values from the element type\n  if (typeName === \"array\") {\n    const element = (def as { element?: z.ZodType })?.element;\n    if (element) {\n      return extractEnumValues(element);\n    }\n  }\n\n  // Also handle literal union patterns (z.literal(\"a\").or(z.literal(\"b\")))\n  if (typeName === \"union\") {\n    const options = def?.options;\n    if (Array.isArray(options)) {\n      const literalValues: string[] = [];\n      for (const option of options) {\n        const optionTypeName = getTypeName(option);\n        if (optionTypeName === \"literal\") {\n          const optionDef = (option as ZodSchemaWithDef).def ?? (option as ZodSchemaWithDef)._def;\n          const value = (optionDef as { value?: unknown; values?: unknown[] })?.value;\n          const values = (optionDef as { value?: unknown; values?: unknown[] })?.values;\n          const literalValue = value ?? values?.[0];\n          if (typeof literalValue === \"string\") {\n            literalValues.push(literalValue);\n          }\n        }\n      }\n      // Only return if all options are string literals\n      if (literalValues.length === options.length && literalValues.length > 0) {\n        return literalValues;\n      }\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Convert camelCase to kebab-case\n * @example toKebabCase(\"dryRun\") => \"dry-run\"\n * @example toKebabCase(\"outputDir\") => \"output-dir\"\n * @example toKebabCase(\"XMLParser\") => \"xml-parser\"\n */\nexport function toKebabCase(str: string): string {\n  return str\n    .replace(/([a-z])([A-Z])/g, \"$1-$2\")\n    .replace(/([A-Z]+)([A-Z][a-z])/g, \"$1-$2\")\n    .toLowerCase();\n}\n\n/**\n * Convert hyphen-separated sequences to camelCase.\n *\n * Replaces `-x` (hyphen followed by a lowercase letter) with the uppercase\n * variant. Non-hyphenated input (e.g., already camelCase) is returned as-is.\n *\n * @param str - A string that may contain hyphens\n * @example toCamelCase(\"dry-run\") => \"dryRun\"\n * @example toCamelCase(\"output-dir\") => \"outputDir\"\n * @example toCamelCase(\"dryRun\") => \"dryRun\"\n */\nexport function toCamelCase(str: string): string {\n  return str.replace(/-([a-z])/g, (_, char) => char.toUpperCase());\n}\n\n/**\n * Check if a schema is required (not optional or has default)\n *\n * Note: We only check isOptional(), not isNullable(), because CLI arguments\n * are either present (string value) or absent (undefined), never null.\n * Also, some coerce types incorrectly report isNullable()=true.\n */\nfunction isRequired(schema: z.ZodType): boolean {\n  return !schema.isOptional();\n}\n\n/**\n * Extract default value from schema if present\n */\nfunction extractDefaultValue(schema: z.ZodType): unknown {\n  const typeName = getTypeName(schema);\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  if (typeName === \"default\") {\n    const defaultValue = def?.defaultValue;\n    // In zod v4, defaultValue can be a direct value or a function\n    if (typeof defaultValue === \"function\") {\n      return defaultValue();\n    }\n    return defaultValue;\n  }\n\n  // Check for nested default in optional/nullable\n  if (typeName === \"optional\" || typeName === \"nullable\") {\n    const innerSchema = def?.innerType;\n    if (innerSchema) {\n      return extractDefaultValue(innerSchema);\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Extract description from schema\n */\nfunction extractDescription(schema: z.ZodType): string | undefined {\n  // Check direct description\n  if (schema.description) {\n    return schema.description;\n  }\n\n  // Check inner schema for wrapped types\n  const typeName = getTypeName(schema);\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  if (typeName === \"optional\" || typeName === \"nullable\" || typeName === \"default\") {\n    const innerSchema = def?.innerType;\n    if (innerSchema) {\n      return extractDescription(innerSchema);\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Resolve field metadata from schema and argRegistry\n */\nfunction resolveFieldMeta(name: string, schema: z.ZodType): ResolvedFieldMeta {\n  // Get metadata from argRegistry\n  const argMeta = getArgMeta(schema) ?? getArgMeta(unwrapSchema(schema));\n\n  // Priority: argRegistry > schema.describe()\n  const description = argMeta?.description ?? extractDescription(schema);\n\n  // Convert camelCase field name to kebab-case for CLI usage\n  const cliName = toKebabCase(name);\n\n  // Extract enum values from schema\n  const enumValues = extractEnumValues(schema);\n\n  const meta: ResolvedFieldMeta = {\n    name,\n    cliName,\n    alias: argMeta?.alias,\n    description,\n    positional: argMeta?.positional ?? false,\n    placeholder: argMeta?.placeholder,\n    env: argMeta?.env,\n    required: isRequired(schema),\n    defaultValue: extractDefaultValue(schema),\n    type: detectType(schema),\n    schema,\n    enumValues,\n    completion: argMeta?.completion,\n    effect: argMeta?.effect,\n  };\n\n  // Add overrideBuiltinAlias only if it's true\n  if (argMeta && \"overrideBuiltinAlias\" in argMeta && argMeta.overrideBuiltinAlias === true) {\n    meta.overrideBuiltinAlias = true;\n  }\n\n  return meta;\n}\n\n/**\n * Get shape from a ZodObject\n */\nfunction getObjectShape(schema: z.ZodType): Record<string, z.ZodType> {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  return def?.shape ?? s.shape ?? {};\n}\n\n/**\n * Extract fields from a ZodObject\n */\nfunction extractFromObject(schema: z.ZodType): ResolvedFieldMeta[] {\n  const shape = getObjectShape(schema);\n  return Object.entries(shape).map(([name, fieldSchema]) => resolveFieldMeta(name, fieldSchema));\n}\n\n/**\n * Extract fields from a discriminated union\n */\nfunction extractFromDiscriminatedUnion(schema: z.ZodType): ExtractedFields {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  const discriminator = def?.discriminator ?? \"\";\n  const options = def?.options ?? [];\n\n  // Collect all unique fields across all variants\n  const allFieldsMap = new Map<string, ResolvedFieldMeta>();\n  const variants: ExtractedFields[\"variants\"] = [];\n\n  for (const option of options) {\n    const shape = getObjectShape(option as z.ZodObject<z.ZodRawShape>);\n    const variantFields: ResolvedFieldMeta[] = [];\n\n    // Get discriminator value\n    let discriminatorValue = \"\";\n    const discriminatorSchema = shape[discriminator];\n    if (discriminatorSchema) {\n      const typeName = getTypeName(discriminatorSchema);\n      if (typeName === \"literal\") {\n        const litDef =\n          (discriminatorSchema as ZodSchemaWithDef).def ??\n          (discriminatorSchema as ZodSchemaWithDef)._def;\n        // In Zod v4, literal values are in _def.values array\n        const value = (litDef as { value?: unknown; values?: unknown[] })?.value;\n        const values = (litDef as { value?: unknown; values?: unknown[] })?.values;\n        discriminatorValue = String(value ?? values?.[0] ?? \"\");\n      }\n    }\n\n    for (const [name, fieldSchema] of Object.entries(shape)) {\n      const fieldMeta = resolveFieldMeta(name, fieldSchema);\n      variantFields.push(fieldMeta);\n\n      // Add to all fields map (first occurrence wins for metadata)\n      if (!allFieldsMap.has(name)) {\n        allFieldsMap.set(name, fieldMeta);\n      }\n    }\n\n    // Extract description from the variant option\n    const variantDescription = extractDescription(option as z.ZodType);\n\n    variants.push({\n      discriminatorValue,\n      fields: variantFields,\n      ...(variantDescription ? { description: variantDescription } : {}),\n    });\n  }\n\n  const description = extractDescription(schema);\n  return {\n    fields: Array.from(allFieldsMap.values()),\n    schema: schema as ArgsSchema,\n    schemaType: \"discriminatedUnion\",\n    unknownKeysMode: getUnknownKeysMode(schema),\n    discriminator,\n    variants,\n    ...(description ? { description } : {}),\n  };\n}\n\n/**\n * Extract fields from a union-like schema (union or xor)\n */\nfunction extractFromUnionLike(schema: z.ZodType, schemaType: \"union\" | \"xor\"): ExtractedFields {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  const options = def?.options ?? [];\n\n  // Collect all unique fields across all options\n  const allFieldsMap = new Map<string, ResolvedFieldMeta>();\n  const unionOptions: ExtractedFields[] = [];\n\n  for (const option of options) {\n    // Extract fields for this option recursively\n    // We cast to ArgsSchema because we expect options to be objects or other supported types\n    const extracted = extractFields(option as ArgsSchema);\n    unionOptions.push(extracted);\n\n    // Add to combined fields map\n    for (const field of extracted.fields) {\n      if (!allFieldsMap.has(field.name)) {\n        allFieldsMap.set(field.name, field);\n      }\n    }\n  }\n\n  const description = extractDescription(schema);\n  return {\n    fields: Array.from(allFieldsMap.values()),\n    schema: schema as ArgsSchema,\n    schemaType,\n    unknownKeysMode: getUnknownKeysMode(schema),\n    unionOptions,\n    ...(description ? { description } : {}),\n  };\n}\n\n/**\n * Extract fields from an intersection\n */\nfunction extractFromIntersection(schema: z.ZodType): ExtractedFields {\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n  const left = def?.left;\n  const right = def?.right;\n\n  const allFieldsMap = new Map<string, ResolvedFieldMeta>();\n\n  // Helper to extract fields from a sub-schema\n  const extractSubFields = (subSchema: z.ZodType | undefined) => {\n    if (!subSchema) return;\n\n    const extracted = extractFields(subSchema as ArgsSchema);\n    for (const field of extracted.fields) {\n      if (!allFieldsMap.has(field.name)) {\n        allFieldsMap.set(field.name, field);\n      }\n    }\n  };\n\n  extractSubFields(left);\n  extractSubFields(right);\n\n  const description = extractDescription(schema);\n  return {\n    fields: Array.from(allFieldsMap.values()),\n    schema: schema as ArgsSchema,\n    schemaType: \"intersection\",\n    unknownKeysMode: getUnknownKeysMode(schema),\n    ...(description ? { description } : {}),\n  };\n}\n\n/**\n * Cache for extractFields results to avoid redundant schema extraction\n */\nconst extractFieldsCache = new WeakMap<ArgsSchema, ExtractedFields>();\n\n/**\n * Extract all fields from a schema\n *\n * @param schema - The args schema (ZodObject, ZodDiscriminatedUnion, etc.)\n * @returns Extracted field information\n */\nexport function extractFields(schema: ArgsSchema): ExtractedFields {\n  const cached = extractFieldsCache.get(schema);\n  if (cached) return cached;\n\n  let result: ExtractedFields;\n  const typeName = getTypeName(schema);\n  const s = schema as ZodSchemaWithDef;\n  const def = s.def ?? s._def;\n\n  switch (typeName) {\n    case \"object\": {\n      const description = extractDescription(schema);\n      result = {\n        fields: extractFromObject(schema),\n        schema,\n        schemaType: \"object\",\n        unknownKeysMode: getUnknownKeysMode(schema),\n        ...(description ? { description } : {}),\n      };\n      break;\n    }\n\n    case \"union\":\n      // In Zod v4, discriminatedUnion has type \"union\" with a discriminator property\n      if (def?.discriminator) {\n        result = extractFromDiscriminatedUnion(schema);\n      } else {\n        result = extractFromUnionLike(schema, \"union\");\n      }\n      break;\n\n    case \"xor\":\n      result = extractFromUnionLike(schema, \"xor\");\n      break;\n\n    case \"intersection\":\n      result = extractFromIntersection(schema);\n      break;\n\n    case \"pipe\": {\n      // Handle transform/refine on top-level schema (e.g., z.object({...}).transform(...))\n      const pipeInner = def?.in ?? def?.schema;\n      if (pipeInner) {\n        const innerResult = extractFields(pipeInner as ArgsSchema);\n        const pipeDescription = extractDescription(schema);\n        result = {\n          ...innerResult,\n          schema,\n          ...(pipeDescription ? { description: pipeDescription } : {}),\n        };\n        break;\n      }\n      const pipeDescription = extractDescription(schema);\n      result = {\n        fields: [],\n        schema,\n        schemaType: \"object\",\n        unknownKeysMode: getUnknownKeysMode(schema),\n        ...(pipeDescription ? { description: pipeDescription } : {}),\n      };\n      break;\n    }\n\n    default: {\n      const description = extractDescription(schema);\n      // Fallback: try to treat as object\n      result = {\n        fields: [],\n        schema,\n        schemaType: \"object\",\n        unknownKeysMode: getUnknownKeysMode(schema),\n        ...(description ? { description } : {}),\n      };\n      break;\n    }\n  }\n\n  extractFieldsCache.set(schema, result);\n  return result;\n}\n\n/**\n * Get extracted fields from a command\n *\n * @param command - The command to extract fields from\n * @returns Extracted field information, or null if command has no args schema\n */\nexport function getExtractedFields(command: AnyCommand): ExtractedFields | null {\n  if (!command.args) {\n    return null;\n  }\n  return extractFields(command.args);\n}\n","/**\n * Lazy-loaded subcommand with synchronous metadata\n */\n\nimport type { AnyCommand, SubCommandValue } from \"./types.js\";\n\n/**\n * Marker property for LazyCommand identification\n */\nconst LAZY_BRAND = \"__politty_lazy__\" as const;\n\n/**\n * A lazily-loaded command that carries synchronous metadata for\n * static analysis (completion, help) while deferring full module\n * loading to execution time.\n */\nexport interface LazyCommand<T extends AnyCommand = AnyCommand> {\n  readonly __politty_lazy__: true;\n  readonly meta: T;\n  readonly load: () => Promise<AnyCommand>;\n}\n\n/**\n * Type guard: check if a value is a LazyCommand\n */\nexport function isLazyCommand(value: unknown): value is LazyCommand {\n  return (\n    typeof value === \"object\" && value !== null && LAZY_BRAND in value && value[LAZY_BRAND] === true\n  );\n}\n\n/**\n * Create a lazily-loaded subcommand with synchronous metadata.\n *\n * The `meta` command provides names, descriptions, and args schema\n * for static analysis (completion scripts, help text) without loading\n * the full command module.\n *\n * The `load` function is called only at execution time.\n *\n * @example\n * ```ts\n * import { lazy, defineCommand } from \"politty\";\n *\n * const cli = defineCommand({\n *   name: \"mycli\",\n *   subCommands: {\n *     deploy: lazy(\n *       defineCommand({\n *         name: \"deploy\",\n *         description: \"Deploy the application\",\n *         args: z.object({ env: arg(z.string()) }),\n *       }),\n *       () => import(\"./deploy.js\").then((m) => m.deployCommand),\n *     ),\n *   },\n * });\n * ```\n */\nexport function lazy<T extends AnyCommand>(\n  meta: T,\n  load: () => Promise<AnyCommand>,\n): LazyCommand<T> {\n  return {\n    [LAZY_BRAND]: true as const,\n    meta,\n    load,\n  };\n}\n\n/**\n * Resolve synchronous metadata from a SubCommandValue.\n * Returns null for legacy async subcommands whose metadata is unavailable.\n */\nexport function resolveSubCommandMeta(subCmd: SubCommandValue): AnyCommand | null {\n  if (isLazyCommand(subCmd)) return subCmd.meta;\n  if (typeof subCmd === \"function\") return null;\n  return subCmd;\n}\n"],"mappings":"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"}

package/dist/{runner-D4ByDT5I.js → runner-BQcd2UEj.js}

@@ -1,5 +1,5 @@
-import { a as getExtractedFields, i as extractFields, r as resolveSubCommandMeta, s as toCamelCase } from "./lazy-DSyfzR-F.js";
-import { a as emptyLogs, i as createLogCollector, n as resolveLazyCommand, o as mergeLogs, r as resolveSubcommand, t as listSubCommands } from "./subcommand-router-CKuy6D2b.js";
+import { a as getExtractedFields, i as extractFields, r as resolveSubCommandMeta, s as toCamelCase } from "./lazy-D6nL_iKJ.js";
+import { a as emptyLogs, i as createLogCollector, n as resolveLazyCommand, o as mergeLogs, r as resolveSubcommand, t as listSubCommands } from "./subcommand-router-Bu3YTw_f.js";
 import { z } from "zod";
 import { styleText } from "node:util";
 import stringWidth from "string-width";
@@ -1785,6 +1785,29 @@ function formatValidationErrors(errors) {
 	}).join("\n");
 }
 
+//#endregion
+//#region src/core/effect-runner.ts
+/**
+* Execute all registered effect callbacks for validated args.
+*
+* Effects run sequentially in field-definition order.
+* Only fires for fields that have an `effect` callback defined.
+*
+* @param validatedArgs - The validated (post-Zod) argument values
+* @param extracted - The extracted fields from the schema
+* @param globalArgs - The validated global args (passed to command arg effects)
+*/
+async function runEffects(validatedArgs, extracted, globalArgs) {
+	for (const field of extracted.fields) {
+		if (!field.effect) continue;
+		await field.effect(validatedArgs[field.name], {
+			name: field.name,
+			args: validatedArgs,
+			...globalArgs != null && { globalArgs }
+		});
+	}
+}
+
 //#endregion
 //#region src/core/runner.ts
 var runner_exports = /* @__PURE__ */ __exportAll({
@@ -2079,6 +2102,7 @@ async function runCommandInternal(command, argv, options = {}) {
 			validatedGlobalArgs = globalValidation.data;
 		}
 		if (!command.args) {
+			if (options._globalExtracted) await runEffects(validatedGlobalArgs, options._globalExtracted, validatedGlobalArgs);
 			collector?.stop();
 			return await executeLifecycle(command, validatedGlobalArgs, {
 				handleSignals: options.handleSignals,
@@ -2098,6 +2122,8 @@ async function runCommandInternal(command, argv, options = {}) {
 				logs: getCurrentLogs()
 			};
 		}
+		if (options._globalExtracted) await runEffects(validatedGlobalArgs, options._globalExtracted, validatedGlobalArgs);
+		if (parseResult.extractedFields) await runEffects(validationResult.data, parseResult.extractedFields, validatedGlobalArgs);
 		const mergedArgs = {
 			...validatedGlobalArgs,
 			...validationResult.data
@@ -2141,4 +2167,4 @@ function extractAndValidateGlobal(options) {
 
 //#endregion
 export { symbols as C, styles as S, renderInline as _, parseArgv as a, logger as b, validateDuplicateAliases as c, validateReservedAliases as d, DuplicateAliasError as f, generateHelp as g, ReservedAliasError as h, formatValidationErrors as i, validateDuplicateFields as l, PositionalConfigError as m, runMain as n, formatCommandValidationErrors as o, DuplicateFieldError as p, runner_exports as r, validateCommand as s, runCommand as t, validatePositionalConfig as u, renderMarkdown as v, setColorEnabled as x, isColorEnabled as y };
-//# sourceMappingURL=runner-D4ByDT5I.js.map
+//# sourceMappingURL=runner-BQcd2UEj.js.map