politty 0.4.3 → 0.4.6

package/dist/{value-completion-resolver-BQgHsX7b.d.cts → index-BZalbMeu.d.ts}

@@ -1,4 +1,4 @@
-import { d as Command, n as ResolvedFieldMeta, s as AnyCommand } from "./schema-extractor-DFaAZzaY.cjs";
+import { c as AnyCommand, f as Command, l as ArgsSchema, n as ResolvedFieldMeta } from "./schema-extractor-C9APqeSL.js";
 import { z } from "zod";
 
 //#region src/completion/types.d.ts
@@ -18,6 +18,8 @@ interface CompletionOptions {
   includeSubcommands?: boolean;
   /** Include description in completions where supported (default: true) */
   includeDescriptions?: boolean;
+  /** Global args schema for deriving global options in completion */
+  globalArgsSchema?: ArgsSchema;
 }
 /**
  * Value completion specification for shell scripts
@@ -253,8 +255,13 @@ declare function formatForShell(result: CandidateResult, options: ShellFormatOpt
 declare function extractPositionals(command: AnyCommand): ResolvedFieldMeta[];
 /**
  * Extract completion data from a command tree
+ *
+ * @param command - The root command
+ * @param programName - Program name for completion scripts
+ * @param globalArgsSchema - Optional global args schema. When provided, global options
+ *   are derived from this schema instead of the root command's options.
  */
-declare function extractCompletionData(command: AnyCommand, programName: string): CompletionData;
+declare function extractCompletionData(command: AnyCommand, programName: string, globalArgsSchema?: ArgsSchema): CompletionData;
 //#endregion
 //#region src/completion/value-completion-resolver.d.ts
 /**
@@ -287,5 +294,77 @@ interface ValueCompletionField {
  */
 declare function resolveValueCompletion(field: ValueCompletionField): ValueCompletion | undefined;
 //#endregion
-export { ShellType as S, CompletableSubcommand as _, ShellFormatOptions as a, CompletionOptions as b, hasCompleteCommand as c, CompletionDirective as d, generateCandidates as f, CompletableOption as g, parseCompletionContext as h, extractPositionals as i, CandidateResult as l, CompletionType as m, resolveValueCompletion as n, formatForShell as o, CompletionContext as p, extractCompletionData as r, createDynamicCompleteCommand as s, ValueCompletionField as t, CompletionCandidate as u, CompletionData as v, CompletionResult as x, CompletionGenerator as y };
-//# sourceMappingURL=value-completion-resolver-BQgHsX7b.d.cts.map
+//#region src/completion/index.d.ts
+/**
+ * Generate completion script for the specified shell
+ */
+declare function generateCompletion(command: AnyCommand, options: CompletionOptions): CompletionResult;
+/**
+ * Get the list of supported shells
+ */
+declare function getSupportedShells(): ShellType[];
+/**
+ * Detect the current shell from environment
+ */
+declare function detectShell(): ShellType | null;
+/**
+ * Schema for the completion command arguments
+ */
+declare const completionArgsSchema: z.ZodObject<{
+  shell: z.ZodOptional<z.ZodEnum<{
+    bash: "bash";
+    zsh: "zsh";
+    fish: "fish";
+  }>>;
+  instructions: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+type CompletionArgs = z.infer<typeof completionArgsSchema>;
+/**
+ * Create a completion subcommand for your CLI
+ *
+ * This creates a ready-to-use subcommand that generates completion scripts.
+ *
+ * @example
+ * ```typescript
+ * const mainCommand = defineCommand({
+ *   name: "mycli",
+ *   subCommands: {
+ *     completion: createCompletionCommand(mainCommand)
+ *   }
+ * });
+ * ```
+ */
+declare function createCompletionCommand(rootCommand: AnyCommand, programName?: string, globalArgsSchema?: ArgsSchema): Command<typeof completionArgsSchema, CompletionArgs, any>;
+/**
+ * Options for withCompletionCommand
+ */
+interface WithCompletionOptions {
+  /** Override the program name (defaults to command.name) */
+  programName?: string;
+  /** Global args schema for deriving global options in completion */
+  globalArgsSchema?: ArgsSchema;
+}
+/**
+ * Wrap a command with a completion subcommand
+ *
+ * This avoids circular references that occur when a command references itself
+ * in its subCommands (e.g., for completion generation).
+ *
+ * @param command - The command to wrap
+ * @param options - Options including programName
+ * @returns A new command with the completion subcommand added
+ *
+ * @example
+ * ```typescript
+ * const mainCommand = withCompletionCommand(
+ *   defineCommand({
+ *     name: "mycli",
+ *     subCommands: { ... },
+ *   }),
+ * );
+ * ```
+ */
+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-BZalbMeu.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index-BZalbMeu.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/{value-completion-resolver-C9LTGr0O.d.ts → index-C5-0RXiH.d.cts}

@@ -1,4 +1,4 @@
-import { d as Command, n as ResolvedFieldMeta, s as AnyCommand } from "./schema-extractor-n9288WJ6.js";
+import { c as AnyCommand, f as Command, l as ArgsSchema, n as ResolvedFieldMeta } from "./schema-extractor-CVf0J4An.cjs";
 import { z } from "zod";
 
 //#region src/completion/types.d.ts
@@ -18,6 +18,8 @@ interface CompletionOptions {
   includeSubcommands?: boolean;
   /** Include description in completions where supported (default: true) */
   includeDescriptions?: boolean;
+  /** Global args schema for deriving global options in completion */
+  globalArgsSchema?: ArgsSchema;
 }
 /**
  * Value completion specification for shell scripts
@@ -253,8 +255,13 @@ declare function formatForShell(result: CandidateResult, options: ShellFormatOpt
 declare function extractPositionals(command: AnyCommand): ResolvedFieldMeta[];
 /**
  * Extract completion data from a command tree
+ *
+ * @param command - The root command
+ * @param programName - Program name for completion scripts
+ * @param globalArgsSchema - Optional global args schema. When provided, global options
+ *   are derived from this schema instead of the root command's options.
  */
-declare function extractCompletionData(command: AnyCommand, programName: string): CompletionData;
+declare function extractCompletionData(command: AnyCommand, programName: string, globalArgsSchema?: ArgsSchema): CompletionData;
 //#endregion
 //#region src/completion/value-completion-resolver.d.ts
 /**
@@ -287,5 +294,77 @@ interface ValueCompletionField {
  */
 declare function resolveValueCompletion(field: ValueCompletionField): ValueCompletion | undefined;
 //#endregion
-export { ShellType as S, CompletableSubcommand as _, ShellFormatOptions as a, CompletionOptions as b, hasCompleteCommand as c, CompletionDirective as d, generateCandidates as f, CompletableOption as g, parseCompletionContext as h, extractPositionals as i, CandidateResult as l, CompletionType as m, resolveValueCompletion as n, formatForShell as o, CompletionContext as p, extractCompletionData as r, createDynamicCompleteCommand as s, ValueCompletionField as t, CompletionCandidate as u, CompletionData as v, CompletionResult as x, CompletionGenerator as y };
-//# sourceMappingURL=value-completion-resolver-C9LTGr0O.d.ts.map
+//#region src/completion/index.d.ts
+/**
+ * Generate completion script for the specified shell
+ */
+declare function generateCompletion(command: AnyCommand, options: CompletionOptions): CompletionResult;
+/**
+ * Get the list of supported shells
+ */
+declare function getSupportedShells(): ShellType[];
+/**
+ * Detect the current shell from environment
+ */
+declare function detectShell(): ShellType | null;
+/**
+ * Schema for the completion command arguments
+ */
+declare const completionArgsSchema: z.ZodObject<{
+  shell: z.ZodOptional<z.ZodEnum<{
+    bash: "bash";
+    zsh: "zsh";
+    fish: "fish";
+  }>>;
+  instructions: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+type CompletionArgs = z.infer<typeof completionArgsSchema>;
+/**
+ * Create a completion subcommand for your CLI
+ *
+ * This creates a ready-to-use subcommand that generates completion scripts.
+ *
+ * @example
+ * ```typescript
+ * const mainCommand = defineCommand({
+ *   name: "mycli",
+ *   subCommands: {
+ *     completion: createCompletionCommand(mainCommand)
+ *   }
+ * });
+ * ```
+ */
+declare function createCompletionCommand(rootCommand: AnyCommand, programName?: string, globalArgsSchema?: ArgsSchema): Command<typeof completionArgsSchema, CompletionArgs, any>;
+/**
+ * Options for withCompletionCommand
+ */
+interface WithCompletionOptions {
+  /** Override the program name (defaults to command.name) */
+  programName?: string;
+  /** Global args schema for deriving global options in completion */
+  globalArgsSchema?: ArgsSchema;
+}
+/**
+ * Wrap a command with a completion subcommand
+ *
+ * This avoids circular references that occur when a command references itself
+ * in its subCommands (e.g., for completion generation).
+ *
+ * @param command - The command to wrap
+ * @param options - Options including programName
+ * @returns A new command with the completion subcommand added
+ *
+ * @example
+ * ```typescript
+ * const mainCommand = withCompletionCommand(
+ *   defineCommand({
+ *     name: "mycli",
+ *     subCommands: { ... },
+ *   }),
+ * );
+ * ```
+ */
+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-C5-0RXiH.d.cts.map

package/dist/index-C5-0RXiH.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-C5-0RXiH.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,19 +1,19 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_lazy = require('./lazy-BEDnSR0m.cjs');
-const require_zsh = require('./zsh-CASZWn0o.cjs');
-const require_completion_index = require('./completion/index.cjs');
-const require_runner = require('./runner-C4fSHJMe.cjs');
+const require_lazy = require('./lazy-DHlvJiQQ.cjs');
+const require_completion = require('./completion-Df0eZ70u.cjs');
+const require_runner = require('./runner-C1Aah5c5.cjs');
 
 exports.DuplicateAliasError = require_runner.DuplicateAliasError;
 exports.DuplicateFieldError = require_runner.DuplicateFieldError;
 exports.PositionalConfigError = require_runner.PositionalConfigError;
 exports.ReservedAliasError = require_runner.ReservedAliasError;
 exports.arg = require_lazy.arg;
-exports.defineCommand = require_zsh.defineCommand;
+exports.createDefineCommand = require_completion.createDefineCommand;
+exports.defineCommand = require_completion.defineCommand;
 exports.extractFields = require_lazy.extractFields;
 exports.formatCommandValidationErrors = require_runner.formatCommandValidationErrors;
 exports.formatValidationErrors = require_runner.formatValidationErrors;
-exports.generateCompletion = require_completion_index.generateCompletion;
+exports.generateCompletion = require_completion.generateCompletion;
 exports.generateHelp = require_runner.generateHelp;
 exports.getUnknownKeysMode = require_lazy.getUnknownKeysMode;
 exports.isColorEnabled = require_runner.isColorEnabled;
@@ -28,10 +28,11 @@ exports.runMain = require_runner.runMain;
 exports.setColorEnabled = require_runner.setColorEnabled;
 exports.styles = require_runner.styles;
 exports.symbols = require_runner.symbols;
+exports.toCamelCase = require_lazy.toCamelCase;
 exports.toKebabCase = require_lazy.toKebabCase;
 exports.validateCommand = require_runner.validateCommand;
 exports.validateDuplicateAliases = require_runner.validateDuplicateAliases;
 exports.validateDuplicateFields = require_runner.validateDuplicateFields;
 exports.validatePositionalConfig = require_runner.validatePositionalConfig;
 exports.validateReservedAliases = require_runner.validateReservedAliases;
-exports.withCompletionCommand = require_completion_index.withCompletionCommand;
+exports.withCompletionCommand = require_completion.withCompletionCommand;

package/dist/index.d.cts

@@ -1,7 +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 lazy, C as RunResultSuccess, D as SubCommandsRecord, E as SubCommandValue, O as LazyCommand, S as RunResultFailure, T as SetupContext, _ as Logger, a as getUnknownKeysMode, b as RunCommandOptions, c as ArgsSchema, d as Command, f as CommandBase, g as LogStream, h as LogLevel, i as extractFields, k as isLazyCommand, l as CleanupContext, m as LogEntry, n as ResolvedFieldMeta, o as toKebabCase, p as Example, r as UnknownKeysMode, s as AnyCommand, t as ExtractedFields, u as CollectedLogs, v as MainOptions, w as RunnableCommand, x as RunResult, y as NonRunnableCommand } from "./schema-extractor-DFaAZzaY.cjs";
-import { b as CompletionOptions, x as CompletionResult } from "./value-completion-resolver-BQgHsX7b.cjs";
-import { WithCompletionOptions, generateCompletion, withCompletionCommand } from "./completion/index.cjs";
+import { A as LazyCommand, C as RunResult, D as SetupContext, E as RunnableCommand, M as lazy, O as SubCommandValue, S as RunCommandOptions, T as RunResultSuccess, _ as LogLevel, a as getUnknownKeysMode, b as MainOptions, c as AnyCommand, d as CollectedLogs, f as Command, g as LogEntry, h as GlobalArgs, i as extractFields, j as isLazyCommand, k as SubCommandsRecord, 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 LogStream, w as RunResultFailure, x as NonRunnableCommand, y as Logger } from "./schema-extractor-CVf0J4An.cjs";
+import { D as CompletionResult, E as CompletionOptions, i as generateCompletion, o as withCompletionCommand, t as WithCompletionOptions } from "./index-C5-0RXiH.cjs";
 import { z } from "zod";
 
 //#region src/core/command.d.ts
@@ -9,22 +8,36 @@ 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).
+ */
+type MergedArgs<TLocalArgs, TGlobalArgs> = IsEmpty<TGlobalArgs> extends true ? TLocalArgs : TLocalArgs & TGlobalArgs;
+/**
+ * Resolve merged args from schema and global args type
+ */
+type ResolvedArgs<TArgsSchema, TGlobalArgs> = MergedArgs<InferArgs<TArgsSchema>, TGlobalArgs>;
 /**
  * Config for defining a command
  * @template TArgsSchema - The Zod schema type for arguments
  * @template TResult - The return type of run function (void if no run)
+ * @template TGlobalArgs - Global args type (from declaration merging or factory)
  */
-interface DefineCommandConfig<TArgsSchema extends ArgsSchema | undefined, TResult> {
+interface DefineCommandConfig<TArgsSchema extends ArgsSchema | undefined, TResult, TGlobalArgs> {
   name: string;
   description?: string;
   args?: TArgsSchema;
   subCommands?: SubCommandsRecord;
   setup?: (context: {
-    args: InferArgs<TArgsSchema>;
+    args: ResolvedArgs<TArgsSchema, TGlobalArgs>;
   }) => void | Promise<void>;
-  run?: (args: InferArgs<TArgsSchema>) => TResult;
+  run?: (args: ResolvedArgs<TArgsSchema, TGlobalArgs>) => TResult;
   cleanup?: (context: {
-    args: InferArgs<TArgsSchema>;
+    args: ResolvedArgs<TArgsSchema, TGlobalArgs>;
     error?: Error | undefined;
   }) => void | Promise<void>;
   notes?: string;
@@ -33,13 +46,13 @@ interface DefineCommandConfig<TArgsSchema extends ArgsSchema | undefined, TResul
 /**
  * Config with run function (runnable command)
  */
-interface RunnableConfig<TArgsSchema extends ArgsSchema | undefined, TResult> extends DefineCommandConfig<TArgsSchema, TResult> {
-  run: (args: InferArgs<TArgsSchema>) => TResult;
+interface RunnableConfig<TArgsSchema extends ArgsSchema | undefined, TResult, TGlobalArgs> extends DefineCommandConfig<TArgsSchema, TResult, TGlobalArgs> {
+  run: (args: ResolvedArgs<TArgsSchema, TGlobalArgs>) => TResult;
 }
 /**
  * Config without run function (non-runnable command)
  */
-interface NonRunnableConfig<TArgsSchema extends ArgsSchema | undefined> extends Omit<DefineCommandConfig<TArgsSchema, void>, "run"> {
+interface NonRunnableConfig<TArgsSchema extends ArgsSchema | undefined, TGlobalArgs> extends Omit<DefineCommandConfig<TArgsSchema, void, TGlobalArgs>, "run"> {
   run?: undefined;
 }
 /**
@@ -94,8 +107,33 @@ interface NonRunnableConfig<TArgsSchema extends ArgsSchema | undefined> extends
  * });
  * ```
  */
-declare function defineCommand<TArgsSchema extends ArgsSchema | undefined = undefined, TResult = void>(config: RunnableConfig<TArgsSchema, TResult>): RunnableCommand<TArgsSchema, InferArgs<TArgsSchema>, TResult>;
-declare function defineCommand<TArgsSchema extends ArgsSchema | undefined = undefined>(config: NonRunnableConfig<TArgsSchema>): NonRunnableCommand<TArgsSchema, InferArgs<TArgsSchema>>;
+declare function defineCommand<TArgsSchema extends ArgsSchema | undefined = undefined, TResult = void, TGlobalArgs = GlobalArgs>(config: RunnableConfig<TArgsSchema, TResult, TGlobalArgs>): RunnableCommand<TArgsSchema, ResolvedArgs<TArgsSchema, TGlobalArgs>, TResult>;
+declare function defineCommand<TArgsSchema extends ArgsSchema | undefined = undefined, TGlobalArgs = GlobalArgs>(config: NonRunnableConfig<TArgsSchema, TGlobalArgs>): NonRunnableCommand<TArgsSchema, ResolvedArgs<TArgsSchema, TGlobalArgs>>;
+/**
+ * Create a typed defineCommand factory with pre-bound global args type.
+ * This is the recommended pattern for type-safe global options.
+ *
+ * @example
+ * ```ts
+ * // global-args.ts
+ * type GlobalArgsType = { verbose: boolean; config?: string };
+ * export const defineAppCommand = createDefineCommand<GlobalArgsType>();
+ *
+ * // commands/build.ts
+ * export const buildCommand = defineAppCommand({
+ *   name: "build",
+ *   args: z.object({ output: arg(z.string().default("dist")) }),
+ *   run: (args) => {
+ *     args.verbose; // typed via GlobalArgsType
+ *     args.output;  // typed via local args
+ *   },
+ * });
+ * ```
+ */
+declare function createDefineCommand<TGlobalArgs>(): {
+  <TArgsSchema extends ArgsSchema | undefined = undefined, TResult = void>(config: RunnableConfig<TArgsSchema, TResult, TGlobalArgs>): RunnableCommand<TArgsSchema, ResolvedArgs<TArgsSchema, TGlobalArgs>, TResult>;
+  <TArgsSchema extends ArgsSchema | undefined = undefined>(config: NonRunnableConfig<TArgsSchema, TGlobalArgs>): NonRunnableCommand<TArgsSchema, ResolvedArgs<TArgsSchema, TGlobalArgs>>;
+};
 //#endregion
 //#region src/core/runner.d.ts
 /**
@@ -172,6 +210,8 @@ interface CommandContext {
   rootName?: string | undefined;
   /** Root command version */
   rootVersion?: string | undefined;
+  /** Extracted fields from global args schema */
+  globalExtracted?: ExtractedFields | undefined;
 }
 /**
  * Options for help generation
@@ -331,6 +371,13 @@ interface ParserOptions {
   booleanFlags?: Set<string>;
   /** Array flags (can be repeated) */
   arrayFlags?: Set<string>;
+  /**
+   * All known canonical option names (as defined in the schema).
+   * Used to disambiguate negation: when `--no-flag` or `--noFlag` matches
+   * a name in this set, it is treated as a regular option rather than
+   * boolean negation of `flag`.
+   */
+  definedNames?: Set<string>;
 }
 /**
  * Parse argv into a flat record
@@ -341,6 +388,13 @@ interface ParserOptions {
  * - Combined short options: -abc (treated as -a -b -c if all are boolean)
  * - Positional arguments
  * - -- to stop parsing options
+ * - Boolean negation: --no-flag, --noFlag (requires `booleanFlags`)
+ *
+ * **Note:** When using negation detection (`--noFlag` / `--no-flag`),
+ * supply `definedNames` so that options whose names happen to start with
+ * "no" (e.g. `noDryRun`) are not mistaken for negation of another flag.
+ * Without `definedNames`, all `--noX` forms matching a boolean flag will
+ * be treated as negation.
  *
  * @param argv - Command line arguments
  * @param options - Parser options
@@ -505,5 +559,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 HelpOptions, type LazyCommand, type LogEntry, type LogLevel, type LogStream, type Logger, type MainOptions, 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, defineCommand, extractFields, formatCommandValidationErrors, formatValidationErrors, generateCompletion, generateHelp, getUnknownKeysMode, isColorEnabled, isLazyCommand, lazy, logger, parseArgv, renderInline, renderMarkdown, runCommand, runMain, setColorEnabled, styles, symbols, 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 Example, type ExtractedFields, type GlobalArgs, 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,7 +1,6 @@
-import { a as arg, i as CustomCompletion, n as CompletionMeta, r as CompletionType, t as ArgMeta } from "./arg-registry-BUUhZ7JR.js";
-import { A as lazy, C as RunResultSuccess, D as SubCommandsRecord, E as SubCommandValue, O as LazyCommand, S as RunResultFailure, T as SetupContext, _ as Logger, a as getUnknownKeysMode, b as RunCommandOptions, c as ArgsSchema, d as Command, f as CommandBase, g as LogStream, h as LogLevel, i as extractFields, k as isLazyCommand, l as CleanupContext, m as LogEntry, n as ResolvedFieldMeta, o as toKebabCase, p as Example, r as UnknownKeysMode, s as AnyCommand, t as ExtractedFields, u as CollectedLogs, v as MainOptions, w as RunnableCommand, x as RunResult, y as NonRunnableCommand } from "./schema-extractor-n9288WJ6.js";
-import { b as CompletionOptions, x as CompletionResult } from "./value-completion-resolver-C9LTGr0O.js";
-import { WithCompletionOptions, generateCompletion, withCompletionCommand } from "./completion/index.js";
+import { a as arg, i as CustomCompletion, n as CompletionMeta, r as CompletionType, t as ArgMeta } from "./arg-registry-2m40k1Et.js";
+import { A as LazyCommand, C as RunResult, D as SetupContext, E as RunnableCommand, M as lazy, O as SubCommandValue, S as RunCommandOptions, T as RunResultSuccess, _ as LogLevel, a as getUnknownKeysMode, b as MainOptions, c as AnyCommand, d as CollectedLogs, f as Command, g as LogEntry, h as GlobalArgs, i as extractFields, j as isLazyCommand, k as SubCommandsRecord, 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 LogStream, w as RunResultFailure, x as NonRunnableCommand, y as Logger } from "./schema-extractor-C9APqeSL.js";
+import { D as CompletionResult, E as CompletionOptions, i as generateCompletion, o as withCompletionCommand, t as WithCompletionOptions } from "./index-BZalbMeu.js";
 import { z } from "zod";
 
 //#region src/core/command.d.ts
@@ -9,22 +8,36 @@ 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).
+ */
+type MergedArgs<TLocalArgs, TGlobalArgs> = IsEmpty<TGlobalArgs> extends true ? TLocalArgs : TLocalArgs & TGlobalArgs;
+/**
+ * Resolve merged args from schema and global args type
+ */
+type ResolvedArgs<TArgsSchema, TGlobalArgs> = MergedArgs<InferArgs<TArgsSchema>, TGlobalArgs>;
 /**
  * Config for defining a command
  * @template TArgsSchema - The Zod schema type for arguments
  * @template TResult - The return type of run function (void if no run)
+ * @template TGlobalArgs - Global args type (from declaration merging or factory)
  */
-interface DefineCommandConfig<TArgsSchema extends ArgsSchema | undefined, TResult> {
+interface DefineCommandConfig<TArgsSchema extends ArgsSchema | undefined, TResult, TGlobalArgs> {
   name: string;
   description?: string;
   args?: TArgsSchema;
   subCommands?: SubCommandsRecord;
   setup?: (context: {
-    args: InferArgs<TArgsSchema>;
+    args: ResolvedArgs<TArgsSchema, TGlobalArgs>;
   }) => void | Promise<void>;
-  run?: (args: InferArgs<TArgsSchema>) => TResult;
+  run?: (args: ResolvedArgs<TArgsSchema, TGlobalArgs>) => TResult;
   cleanup?: (context: {
-    args: InferArgs<TArgsSchema>;
+    args: ResolvedArgs<TArgsSchema, TGlobalArgs>;
     error?: Error | undefined;
   }) => void | Promise<void>;
   notes?: string;
@@ -33,13 +46,13 @@ interface DefineCommandConfig<TArgsSchema extends ArgsSchema | undefined, TResul
 /**
  * Config with run function (runnable command)
  */
-interface RunnableConfig<TArgsSchema extends ArgsSchema | undefined, TResult> extends DefineCommandConfig<TArgsSchema, TResult> {
-  run: (args: InferArgs<TArgsSchema>) => TResult;
+interface RunnableConfig<TArgsSchema extends ArgsSchema | undefined, TResult, TGlobalArgs> extends DefineCommandConfig<TArgsSchema, TResult, TGlobalArgs> {
+  run: (args: ResolvedArgs<TArgsSchema, TGlobalArgs>) => TResult;
 }
 /**
  * Config without run function (non-runnable command)
  */
-interface NonRunnableConfig<TArgsSchema extends ArgsSchema | undefined> extends Omit<DefineCommandConfig<TArgsSchema, void>, "run"> {
+interface NonRunnableConfig<TArgsSchema extends ArgsSchema | undefined, TGlobalArgs> extends Omit<DefineCommandConfig<TArgsSchema, void, TGlobalArgs>, "run"> {
   run?: undefined;
 }
 /**
@@ -94,8 +107,33 @@ interface NonRunnableConfig<TArgsSchema extends ArgsSchema | undefined> extends
  * });
  * ```
  */
-declare function defineCommand<TArgsSchema extends ArgsSchema | undefined = undefined, TResult = void>(config: RunnableConfig<TArgsSchema, TResult>): RunnableCommand<TArgsSchema, InferArgs<TArgsSchema>, TResult>;
-declare function defineCommand<TArgsSchema extends ArgsSchema | undefined = undefined>(config: NonRunnableConfig<TArgsSchema>): NonRunnableCommand<TArgsSchema, InferArgs<TArgsSchema>>;
+declare function defineCommand<TArgsSchema extends ArgsSchema | undefined = undefined, TResult = void, TGlobalArgs = GlobalArgs>(config: RunnableConfig<TArgsSchema, TResult, TGlobalArgs>): RunnableCommand<TArgsSchema, ResolvedArgs<TArgsSchema, TGlobalArgs>, TResult>;
+declare function defineCommand<TArgsSchema extends ArgsSchema | undefined = undefined, TGlobalArgs = GlobalArgs>(config: NonRunnableConfig<TArgsSchema, TGlobalArgs>): NonRunnableCommand<TArgsSchema, ResolvedArgs<TArgsSchema, TGlobalArgs>>;
+/**
+ * Create a typed defineCommand factory with pre-bound global args type.
+ * This is the recommended pattern for type-safe global options.
+ *
+ * @example
+ * ```ts
+ * // global-args.ts
+ * type GlobalArgsType = { verbose: boolean; config?: string };
+ * export const defineAppCommand = createDefineCommand<GlobalArgsType>();
+ *
+ * // commands/build.ts
+ * export const buildCommand = defineAppCommand({
+ *   name: "build",
+ *   args: z.object({ output: arg(z.string().default("dist")) }),
+ *   run: (args) => {
+ *     args.verbose; // typed via GlobalArgsType
+ *     args.output;  // typed via local args
+ *   },
+ * });
+ * ```
+ */
+declare function createDefineCommand<TGlobalArgs>(): {
+  <TArgsSchema extends ArgsSchema | undefined = undefined, TResult = void>(config: RunnableConfig<TArgsSchema, TResult, TGlobalArgs>): RunnableCommand<TArgsSchema, ResolvedArgs<TArgsSchema, TGlobalArgs>, TResult>;
+  <TArgsSchema extends ArgsSchema | undefined = undefined>(config: NonRunnableConfig<TArgsSchema, TGlobalArgs>): NonRunnableCommand<TArgsSchema, ResolvedArgs<TArgsSchema, TGlobalArgs>>;
+};
 //#endregion
 //#region src/core/runner.d.ts
 /**
@@ -172,6 +210,8 @@ interface CommandContext {
   rootName?: string | undefined;
   /** Root command version */
   rootVersion?: string | undefined;
+  /** Extracted fields from global args schema */
+  globalExtracted?: ExtractedFields | undefined;
 }
 /**
  * Options for help generation
@@ -331,6 +371,13 @@ interface ParserOptions {
   booleanFlags?: Set<string>;
   /** Array flags (can be repeated) */
   arrayFlags?: Set<string>;
+  /**
+   * All known canonical option names (as defined in the schema).
+   * Used to disambiguate negation: when `--no-flag` or `--noFlag` matches
+   * a name in this set, it is treated as a regular option rather than
+   * boolean negation of `flag`.
+   */
+  definedNames?: Set<string>;
 }
 /**
  * Parse argv into a flat record
@@ -341,6 +388,13 @@ interface ParserOptions {
  * - Combined short options: -abc (treated as -a -b -c if all are boolean)
  * - Positional arguments
  * - -- to stop parsing options
+ * - Boolean negation: --no-flag, --noFlag (requires `booleanFlags`)
+ *
+ * **Note:** When using negation detection (`--noFlag` / `--no-flag`),
+ * supply `definedNames` so that options whose names happen to start with
+ * "no" (e.g. `noDryRun`) are not mistaken for negation of another flag.
+ * Without `definedNames`, all `--noX` forms matching a boolean flag will
+ * be treated as negation.
  *
  * @param argv - Command line arguments
  * @param options - Parser options
@@ -505,5 +559,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 HelpOptions, type LazyCommand, type LogEntry, type LogLevel, type LogStream, type Logger, type MainOptions, 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, defineCommand, extractFields, formatCommandValidationErrors, formatValidationErrors, generateCompletion, generateHelp, getUnknownKeysMode, isColorEnabled, isLazyCommand, lazy, logger, parseArgv, renderInline, renderMarkdown, runCommand, runMain, setColorEnabled, styles, symbols, 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 Example, type ExtractedFields, type GlobalArgs, 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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"}