politty 0.10.0 → 0.11.0

package/dist/{arg-registry-BN3I-XON.d.ts → arg-registry-aHbip9Hs.d.ts}

@@ -57,8 +57,7 @@ interface ResolvedFieldMeta {
    *   help, generated docs, and shell completions.
    * - `false`: neither the default `--no-<cliName>` nor any custom name is
    *   accepted; the field only responds to the positive flag.
-   * - `undefined`: the default `--no-<cliName>` is accepted by the parser
-   *   but hidden from help/docs/completions.
+   * - `undefined`: no negation form is accepted or shown.
    *
    * Only applies to boolean fields; populated as `undefined` otherwise.
    */
@@ -758,18 +757,17 @@ interface BaseArgMeta<TValue = unknown> {
   /**
    * Control the boolean negation option.
    *
-   * Boolean fields automatically accept `--no-<cliName>` (and the camelCase
-   * `--no<Name>` form) to set the value to `false`. By default this form is
-   * accepted by the parser but hidden from help, generated docs, and shell
-   * completions. This option lets you customize or expose that behavior:
+   * Boolean fields accept `--no-<cliName>` (and the camelCase `--no<Name>`
+   * form) to set the value to `false` only when `negation: true` is set.
+   * By default no negation form is accepted. This option lets you customize
+   * or expose that behavior:
    *
    * - `string` — replaces the auto-generated `--no-*` form with a custom
    *   name. The default `--no-*` is no longer recognized.
-   * - `true`  — opt-in to advertising the default `--no-<cliName>` form in
-   *   help, generated docs, and shell completions. Parser behavior is
-   *   unchanged.
-   * - `false` — disables negation entirely; neither the default `--no-*`
-   *   nor any custom name is accepted.
+   * - `true`  — enables the default `--no-<cliName>` form and advertises it
+   *   in help, generated docs, and shell completions.
+   * - `false` — disables negation entirely; same as the default, but explicit.
+   *   Neither the default `--no-*` nor any custom name is accepted.
    *
    * String values follow the same naming conventions as `cliName`
    * (kebab-case is recommended). Only valid on boolean fields; setting
@@ -786,7 +784,7 @@ interface BaseArgMeta<TValue = unknown> {
    * // Accepts: --cache (true), --disable-cache (false)
    * // No longer accepts: --no-cache
    *
-   * // Expose default `--no-X` in help/docs/completion
+   * // Enable default `--no-X` in parsing/help/docs/completion
    * verbose: arg(z.boolean().default(false), {
    *   negation: true,
    * })
@@ -941,4 +939,4 @@ declare function arg<T extends z.ZodType>(schema: T): T;
 declare function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(schema: T, meta: ValidateArgMeta<M, z.output<T>>): T;
 //#endregion
 export { toKebabCase as $, LogStream as A, SetupContext as B, Example as C, IsEmpty as D, GlobalSetupContext as E, RunCommandOptions as F, isLazyCommand as G, SubCommandsRecord as H, RunResult as I, ResolvedFieldMeta as J, lazy as K, RunResultFailure as L, MainOptions as M, NonRunnableCommand as N, LogEntry as O, PromptResolver as P, toCamelCase as Q, RunResultSuccess as R, CommandBase as S, GlobalCleanupContext as T, UnknownSubcommandHandler as U, SubCommandValue as V, LazyCommand as W, extractFields as X, UnknownKeysMode as Y, getUnknownKeysMode as Z, AnyCommand as _, EffectContext as a, CollectedLogs as b, arg as c, ResolvedExpandCandidate as d, CompletionDirectiveMask as f, DynamicCompletionResult as g, DynamicCompletionResolver as h, CustomCompletion as i, Logger as j, LogLevel as k, ExpandCandidate as l, DynamicCompletionContext as m, CompletionMeta as n, PromptMeta as o, DynamicCompletionCandidate as p, ExtractedFields as q, CompletionType as r, PromptType as s, ArgMeta as t, ExpandCompletion as u, ArgsSchema as v, GlobalArgs as w, Command as x, CleanupContext as y, RunnableCommand as z };
-//# sourceMappingURL=arg-registry-BN3I-XON.d.ts.map
+//# sourceMappingURL=arg-registry-aHbip9Hs.d.ts.map

package/dist/augment.d.ts

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

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { n as runMain } from "./runner-DZOmYkN0.js";
+import { n as runMain } from "./runner-Z7R_XvAV.js";
 import { t as arg } from "./arg-registry-BeLLAW5-.js";
 import { n as defineCommand } from "./command-B4yA4LXX.js";
-import { p as generateBundledCompletionWorker } from "./completion-DwTFOtQk.js";
+import { p as generateBundledCompletionWorker } from "./completion-CqKX9sCR.js";
 import "./index.js";
 import { z } from "zod";
 

package/dist/completion/index.d.ts

@@ -1,3 +1,3 @@
-import { f as CompletionDirectiveMask, g as DynamicCompletionResult, h as DynamicCompletionResolver, m as DynamicCompletionContext, p as DynamicCompletionCandidate } from "../arg-registry-BN3I-XON.js";
-import { A as BundledWorkerOptions, C as CandidateResult, D as CompletionContext, E as generateCandidates, F as CompletionMode, I as CompletionOptions, L as CompletionResult, M as CompletableSubcommand, N as CompletionData, O as CompletionType, P as CompletionGenerator, R as ShellType, S as hasCompleteCommand, T as CompletionDirective, _ as extractCompletionData, a as detectShell, b as formatForShell, c as withCompletionCommand, d as GenerateBundledCompletionWorkerOptions, f as GenerateBundledCompletionWorkerResult, g as validateBundledWorkerFile, h as generateBundledCompletionWorker, i as createRefreshCompletionCommand, j as CompletableOption, k as parseCompletionContext, l as ValueCompletionField, m as defaultBundledWorkerOutputPath, n as createCompletionCommand, o as generateCompletion, p as bundledWorkerShellExtension, r as createCompletionWorkerPathCommand, s as getSupportedShells, t as WithCompletionOptions, u as resolveValueCompletion, v as extractPositionals, w as CompletionCandidate, x as createDynamicCompleteCommand, y as ShellFormatOptions } from "../index-CtRrTVTL.js";
+import { f as CompletionDirectiveMask, g as DynamicCompletionResult, h as DynamicCompletionResolver, m as DynamicCompletionContext, p as DynamicCompletionCandidate } from "../arg-registry-aHbip9Hs.js";
+import { A as BundledWorkerOptions, C as CandidateResult, D as CompletionContext, E as generateCandidates, F as CompletionMode, I as CompletionOptions, L as CompletionResult, M as CompletableSubcommand, N as CompletionData, O as CompletionType, P as CompletionGenerator, R as ShellType, S as hasCompleteCommand, T as CompletionDirective, _ as extractCompletionData, a as detectShell, b as formatForShell, c as withCompletionCommand, d as GenerateBundledCompletionWorkerOptions, f as GenerateBundledCompletionWorkerResult, g as validateBundledWorkerFile, h as generateBundledCompletionWorker, i as createRefreshCompletionCommand, j as CompletableOption, k as parseCompletionContext, l as ValueCompletionField, m as defaultBundledWorkerOutputPath, n as createCompletionCommand, o as generateCompletion, p as bundledWorkerShellExtension, r as createCompletionWorkerPathCommand, s as getSupportedShells, t as WithCompletionOptions, u as resolveValueCompletion, v as extractPositionals, w as CompletionCandidate, x as createDynamicCompleteCommand, y as ShellFormatOptions } from "../index-dRZSB_t3.js";
 export { type BundledWorkerOptions, type CandidateResult, type CompletableOption, type CompletableSubcommand, type CompletionCandidate, type CompletionContext, type CompletionData, CompletionDirective, type CompletionDirectiveMask, type CompletionGenerator, type CompletionMode, type CompletionOptions, type CompletionResult, type CompletionType, type DynamicCompletionCandidate, type DynamicCompletionContext, type DynamicCompletionResolver, type DynamicCompletionResult, type GenerateBundledCompletionWorkerOptions, type GenerateBundledCompletionWorkerResult, type ShellFormatOptions, type ShellType, type ValueCompletionField, WithCompletionOptions, bundledWorkerShellExtension, createCompletionCommand, createCompletionWorkerPathCommand, createDynamicCompleteCommand, createRefreshCompletionCommand, defaultBundledWorkerOutputPath, detectShell, extractCompletionData, extractPositionals, formatForShell, generateBundledCompletionWorker, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, resolveValueCompletion, validateBundledWorkerFile, withCompletionCommand };

package/dist/completion/index.js

@@ -1,3 +1,3 @@
-import { _ as CompletionDirective, a as generateCompletion, b as resolveValueCompletion, c as createDynamicCompleteCommand, d as bundledWorkerShellExtension, f as defaultBundledWorkerOutputPath, g as extractPositionals, h as extractCompletionData, i as detectShell, l as hasCompleteCommand, m as validateBundledWorkerFile, n as createCompletionWorkerPathCommand, o as getSupportedShells, p as generateBundledCompletionWorker, r as createRefreshCompletionCommand, s as withCompletionCommand, t as createCompletionCommand, u as formatForShell, v as generateCandidates, y as parseCompletionContext } from "../completion-DwTFOtQk.js";
+import { _ as CompletionDirective, a as generateCompletion, b as resolveValueCompletion, c as createDynamicCompleteCommand, d as bundledWorkerShellExtension, f as defaultBundledWorkerOutputPath, g as extractPositionals, h as extractCompletionData, i as detectShell, l as hasCompleteCommand, m as validateBundledWorkerFile, n as createCompletionWorkerPathCommand, o as getSupportedShells, p as generateBundledCompletionWorker, r as createRefreshCompletionCommand, s as withCompletionCommand, t as createCompletionCommand, u as formatForShell, v as generateCandidates, y as parseCompletionContext } from "../completion-CqKX9sCR.js";
 
 export { CompletionDirective, bundledWorkerShellExtension, createCompletionCommand, createCompletionWorkerPathCommand, createDynamicCompleteCommand, createRefreshCompletionCommand, defaultBundledWorkerOutputPath, detectShell, extractCompletionData, extractPositionals, formatForShell, generateBundledCompletionWorker, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, resolveValueCompletion, validateBundledWorkerFile, withCompletionCommand };

package/dist/{completion-DwTFOtQk.js → completion-CqKX9sCR.js}

@@ -1,6 +1,6 @@
 import { t as arg } from "./arg-registry-BeLLAW5-.js";
 import { n as defineCommand } from "./command-B4yA4LXX.js";
-import { a as toCamelCase, m as resolveSubCommandMeta, n as getAllAliases, t as extractFields, u as resolveSubCommandAlias } from "./schema-extractor-CVHWm23M.js";
+import { a as toCamelCase, m as resolveSubCommandMeta, n as getAllAliases, t as extractFields, u as resolveSubCommandAlias } from "./schema-extractor-DnOTAjV_.js";
 import { z } from "zod";
 import { execFile, execSync, spawn } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
@@ -316,7 +316,7 @@ function extractOptionsFromSchema(schema) {
 			takesValue: field.type !== "boolean",
 			valueType: field.type,
 			required: field.required,
-			defaultNegationAccepted: field.type === "boolean" && (field.negation === void 0 || field.negation === true),
+			defaultNegationAccepted: field.type === "boolean" && field.negation === true,
 			valueCompletion: resolveRuntimeCompletion(resolveValueCompletion(field))
 		};
 	});
@@ -376,7 +376,13 @@ function parsePreSubGlobals(tokens, globalOptions, globalParsedArgs) {
 		}
 		const parsed = parseOption(word);
 		const opt = findOption(globalOptions, parsed);
-		if (!opt) break;
+		if (!opt) {
+			if (isSuppressedDefaultNegation(globalOptions, parsed)) {
+				i++;
+				continue;
+			}
+			break;
+		}
 		if (opt.takesValue) if (hasInlineValue(word)) {
 			const eqIdx = word.indexOf("=");
 			writeGlobal(opt, word.slice(eqIdx + 1));
@@ -513,20 +519,18 @@ function hasInlineValue(word) {
 	return word.includes("=");
 }
 /**
-* For boolean options, the runtime parser accepts the implicit
-* `--no-<cliName>` (and camelCase `--noCliName`) form unless the user
-* opted out via `negation: false` or supplied a custom-string negation
-* (which suppresses the default form). Aliases participate too: a
-* boolean with `alias: "c"` accepts `--no-c` / `--noC` because the
-* runtime resolves the post-`no-` segment through `aliasMap`. Implicit
-* negation is LONG-FORM only — `-no-c` is never an accepted negation —
-* so callers must say so via `isLong` to prevent a short option from
-* being read as a negation.
+* For boolean options, the runtime parser accepts the default
+* `--no-<cliName>` (and camelCase `--noCliName`) form only when the user
+* opts in via `negation: true`. Aliases participate too: a boolean with
+* `alias: "c", negation: true` accepts `--no-c` / `--noC` because the
+* runtime resolves the post-`no-` segment through `aliasMap`. Default
+* negation is LONG-FORM only — `-no-c` is never an accepted negation — so
+* callers must say so via `isLong` to prevent a short option from being read
+* as a negation.
 */
-function isImplicitBooleanNegation(opt, name, isLong) {
+function isDefaultBooleanNegationToken(opt, name, isLong) {
 	if (!isLong) return false;
 	if (opt.valueType !== "boolean") return false;
-	if (opt.defaultNegationAccepted === false) return false;
 	const candidates = [opt.cliName, ...opt.alias ?? []];
 	for (const c of candidates) {
 		const hyphenated = `no-${c}`;
@@ -535,6 +539,12 @@ function isImplicitBooleanNegation(opt, name, isLong) {
 	}
 	return false;
 }
+function isImplicitBooleanNegation(opt, name, isLong) {
+	return opt.defaultNegationAccepted === true && isDefaultBooleanNegationToken(opt, name, isLong);
+}
+function isSuppressedDefaultNegation(options, parsed) {
+	return options.some((opt) => opt.defaultNegationAccepted !== true && isDefaultBooleanNegationToken(opt, parsed.name, parsed.isLong));
+}
 /** True when `source` is hyphenated and its camelCase form equals `name`. */
 function matchesCamelCase(source, name) {
 	return source !== void 0 && source.includes("-") && toCamelCase(source) === name;
@@ -561,8 +571,8 @@ function writeOptionValue(target, opt, value, arraysSeenInFrame) {
 }
 /**
 * True when the typed token is the boolean option's negation form — either
-* the explicit `negation` name (or its camelCase variant) or the implicit
-* `--no-<name>` form. Long-form only; short tokens are never negations.
+* the explicit `negation` name (or its camelCase variant) or the opt-in
+* default `--no-<name>` form. Long-form only; short tokens are never negations.
 */
 function isNegationOf(opt, parsed) {
 	if (!parsed.isLong) return false;
@@ -1412,7 +1422,7 @@ function getSubNamesWithAliases(subs) {
 * sibling choices are known.
 */
 function fieldToOption(field, pending) {
-	const defaultNegationAccepted = field.type === "boolean" && (field.negation === void 0 || field.negation === true);
+	const defaultNegationAccepted = field.type === "boolean" && field.negation === true;
 	const opt = {
 		name: field.name,
 		cliName: field.cliName,
@@ -5596,4 +5606,4 @@ function maybeSpawnRefresh(argv, ctx) {
 
 //#endregion
 export { CompletionDirective as _, generateCompletion as a, resolveValueCompletion as b, createDynamicCompleteCommand as c, bundledWorkerShellExtension as d, defaultBundledWorkerOutputPath as f, extractPositionals as g, extractCompletionData as h, detectShell as i, hasCompleteCommand as l, validateBundledWorkerFile as m, createCompletionWorkerPathCommand as n, getSupportedShells as o, generateBundledCompletionWorker as p, createRefreshCompletionCommand as r, withCompletionCommand as s, createCompletionCommand as t, formatForShell as u, generateCandidates as v, parseCompletionContext as y };
-//# sourceMappingURL=completion-DwTFOtQk.js.map
+//# sourceMappingURL=completion-CqKX9sCR.js.map

package/dist/docs/index.d.ts

@@ -1,4 +1,4 @@
-import { C as Example, J as ResolvedFieldMeta, V as SubCommandValue, _ as AnyCommand, q as ExtractedFields, v as ArgsSchema } from "../arg-registry-BN3I-XON.js";
+import { C as Example, J as ResolvedFieldMeta, V as SubCommandValue, _ as AnyCommand, q as ExtractedFields, v as ArgsSchema } from "../arg-registry-aHbip9Hs.js";
 import { z } from "zod";
 import * as fs from "node:fs";
 

package/dist/docs/index.js

@@ -1,4 +1,4 @@
-import { l as resolveLazyCommand, r as getExtractedFields, t as extractFields } from "../schema-extractor-CVHWm23M.js";
+import { l as resolveLazyCommand, r as getExtractedFields, t as extractFields } from "../schema-extractor-DnOTAjV_.js";
 import { t as createLogCollector } from "../log-collector-DK32-73m.js";
 import { z } from "zod";
 import * as fs from "node:fs";
@@ -919,7 +919,7 @@ async function executeSingleExample(example, rootCommand, commandPath) {
 	collector.start();
 	let success = true;
 	try {
-		const { runCommand } = await import("../runner-DZOmYkN0.js").then((n) => n.r);
+		const { runCommand } = await import("../runner-Z7R_XvAV.js").then((n) => n.r);
 		const result = await runCommand(rootCommand, argv);
 		success = result.success;
 		if (!result.success && result.error) console.error(result.error.message);

package/dist/{index-CtRrTVTL.d.ts → index-dRZSB_t3.d.ts}

@@ -1,4 +1,4 @@
-import { J as ResolvedFieldMeta, _ as AnyCommand, d as ResolvedExpandCandidate, h as DynamicCompletionResolver, u as ExpandCompletion, v as ArgsSchema, x as Command } from "./arg-registry-BN3I-XON.js";
+import { J as ResolvedFieldMeta, _ as AnyCommand, d as ResolvedExpandCandidate, h as DynamicCompletionResolver, u as ExpandCompletion, v as ArgsSchema, x as Command } from "./arg-registry-aHbip9Hs.js";
 import { z } from "zod";
 
 //#region src/completion/types.d.ts
@@ -177,12 +177,11 @@ interface CompletableOption {
   /** Description for the negation option (when distinct from the main description) */
   negationDescription?: string | undefined;
   /**
-   * Whether the runtime parser accepts the implicit `--no-<cliName>` (and
-   * camelCase) form for this boolean option. False when the user set
-   * `negation: false` (suppressed) or `negation: <custom name>` (only the
-   * custom name is accepted). Used by the completion context parser so
-   * dynamic resolvers see the same `parsedArgs` state the runtime would
-   * compute.
+   * Whether the runtime parser accepts the default `--no-<cliName>` (and
+   * camelCase) form for this boolean option. True only when the user set
+   * `negation: true`; false when unset, `negation: false`, or
+   * `negation: <custom name>`. Used by the completion context parser so
+   * dynamic resolvers see the same `parsedArgs` state the runtime would compute.
    */
   defaultNegationAccepted?: boolean;
   /** Description for completion */
@@ -660,4 +659,4 @@ interface WithCompletionOptions {
 declare function withCompletionCommand<T extends AnyCommand>(command: T, options?: string | WithCompletionOptions): T;
 //#endregion
 export { BundledWorkerOptions as A, CandidateResult as C, CompletionContext as D, generateCandidates as E, CompletionMode as F, CompletionOptions as I, CompletionResult as L, CompletableSubcommand as M, CompletionData as N, CompletionType as O, CompletionGenerator as P, ShellType as R, hasCompleteCommand as S, CompletionDirective as T, extractCompletionData as _, detectShell as a, formatForShell as b, withCompletionCommand as c, GenerateBundledCompletionWorkerOptions as d, GenerateBundledCompletionWorkerResult as f, validateBundledWorkerFile as g, generateBundledCompletionWorker as h, createRefreshCompletionCommand as i, CompletableOption as j, parseCompletionContext as k, ValueCompletionField as l, defaultBundledWorkerOutputPath as m, createCompletionCommand as n, generateCompletion as o, bundledWorkerShellExtension as p, createCompletionWorkerPathCommand as r, getSupportedShells as s, WithCompletionOptions as t, resolveValueCompletion as u, extractPositionals as v, CompletionCandidate as w, createDynamicCompleteCommand as x, ShellFormatOptions as y };
-//# sourceMappingURL=index-CtRrTVTL.d.ts.map
+//# sourceMappingURL=index-dRZSB_t3.d.ts.map

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { $ as toKebabCase, A as LogStream, B as SetupContext, C as Example, D as IsEmpty, E as GlobalSetupContext, F as RunCommandOptions, G as isLazyCommand, H as SubCommandsRecord, I as RunResult, J as ResolvedFieldMeta, K as lazy, L as RunResultFailure, M as MainOptions, N as NonRunnableCommand, O as LogEntry, P as PromptResolver, Q as toCamelCase, R as RunResultSuccess, S as CommandBase, T as GlobalCleanupContext, U as UnknownSubcommandHandler, V as SubCommandValue, W as LazyCommand, X as extractFields, Y as UnknownKeysMode, Z as getUnknownKeysMode, _ as AnyCommand, a as EffectContext, b as CollectedLogs, c as arg, d as ResolvedExpandCandidate, f as CompletionDirectiveMask, g as DynamicCompletionResult, h as DynamicCompletionResolver, i as CustomCompletion, j as Logger, k as LogLevel, l as ExpandCandidate, m as DynamicCompletionContext, n as CompletionMeta, o as PromptMeta, p as DynamicCompletionCandidate, q as ExtractedFields, r as CompletionType, s as PromptType, t as ArgMeta, u as ExpandCompletion, v as ArgsSchema, w as GlobalArgs, x as Command, y as CleanupContext, z as RunnableCommand } from "./arg-registry-BN3I-XON.js";
-import { I as CompletionOptions, L as CompletionResult, c as withCompletionCommand, d as GenerateBundledCompletionWorkerOptions, f as GenerateBundledCompletionWorkerResult, h as generateBundledCompletionWorker, o as generateCompletion, t as WithCompletionOptions } from "./index-CtRrTVTL.js";
+import { $ as toKebabCase, A as LogStream, B as SetupContext, C as Example, D as IsEmpty, E as GlobalSetupContext, F as RunCommandOptions, G as isLazyCommand, H as SubCommandsRecord, I as RunResult, J as ResolvedFieldMeta, K as lazy, L as RunResultFailure, M as MainOptions, N as NonRunnableCommand, O as LogEntry, P as PromptResolver, Q as toCamelCase, R as RunResultSuccess, S as CommandBase, T as GlobalCleanupContext, U as UnknownSubcommandHandler, V as SubCommandValue, W as LazyCommand, X as extractFields, Y as UnknownKeysMode, Z as getUnknownKeysMode, _ as AnyCommand, a as EffectContext, b as CollectedLogs, c as arg, d as ResolvedExpandCandidate, f as CompletionDirectiveMask, g as DynamicCompletionResult, h as DynamicCompletionResolver, i as CustomCompletion, j as Logger, k as LogLevel, l as ExpandCandidate, m as DynamicCompletionContext, n as CompletionMeta, o as PromptMeta, p as DynamicCompletionCandidate, q as ExtractedFields, r as CompletionType, s as PromptType, t as ArgMeta, u as ExpandCompletion, v as ArgsSchema, w as GlobalArgs, x as Command, y as CleanupContext, z as RunnableCommand } from "./arg-registry-aHbip9Hs.js";
+import { I as CompletionOptions, L as CompletionResult, c as withCompletionCommand, d as GenerateBundledCompletionWorkerOptions, f as GenerateBundledCompletionWorkerResult, h as generateBundledCompletionWorker, o as generateCompletion, t as WithCompletionOptions } from "./index-dRZSB_t3.js";
 import { z } from "zod";
 
 //#region src/core/case-types.d.ts
@@ -458,11 +458,11 @@ interface ParserOptions {
    */
   negationMap?: Map<string, string>;
   /**
-   * Canonical field names that have a custom `negation` configured.
-   * For these fields the default `--no-<name>` / `--no<Name>` negation
-   * forms are suppressed.
+   * Canonical field names whose default `--no-<name>` / `--no<Name>`
+   * negation forms are suppressed. When omitted, every field in
+   * `booleanFlags` has default negation suppressed.
    */
-  customNegatedFields?: Set<string>;
+  defaultNegationDisabledFields?: Set<string>;
 }
 /**
  * Parse argv into a flat record
@@ -473,7 +473,7 @@ 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`)
+ * - Boolean negation: --no-flag, --noFlag (requires `booleanFlags` and `negation: true`)
  *
  * **Note:** When using negation detection (`--noFlag` / `--no-flag`),
  * supply `definedNames` so that options whose names happen to start with

package/dist/index.js

@@ -1,8 +1,8 @@
-import { C as renderMarkdown, S as renderInline, _ as DuplicateFieldError, a as parseArgv, b as ReservedAliasError, c as validateCommand, d as validateDuplicateFields, f as validateDuplicateNegations, g as DuplicateAliasError, h as CaseVariantCollisionError, i as formatValidationErrors, l as validateCrossSchemaCollisions, m as validateReservedAliases, n as runMain, o as formatCommandValidationErrors, p as validatePositionalConfig, s as validateCaseVariantCollisions, t as runCommand, u as validateDuplicateAliases, v as DuplicateNegationError, w as createDualCaseProxy, x as generateHelp, y as PositionalConfigError } from "./runner-DZOmYkN0.js";
+import { C as renderMarkdown, S as renderInline, _ as DuplicateFieldError, a as parseArgv, b as ReservedAliasError, c as validateCommand, d as validateDuplicateFields, f as validateDuplicateNegations, g as DuplicateAliasError, h as CaseVariantCollisionError, i as formatValidationErrors, l as validateCrossSchemaCollisions, m as validateReservedAliases, n as runMain, o as formatCommandValidationErrors, p as validatePositionalConfig, s as validateCaseVariantCollisions, t as runCommand, u as validateDuplicateAliases, v as DuplicateNegationError, w as createDualCaseProxy, x as generateHelp, y as PositionalConfigError } from "./runner-Z7R_XvAV.js";
 import { t as arg } from "./arg-registry-BeLLAW5-.js";
 import { n as defineCommand, t as createDefineCommand } from "./command-B4yA4LXX.js";
-import { a as toCamelCase, f as isLazyCommand, i as getUnknownKeysMode, o as toKebabCase, p as lazy, t as extractFields } from "./schema-extractor-CVHWm23M.js";
-import { a as generateCompletion, p as generateBundledCompletionWorker, s as withCompletionCommand } from "./completion-DwTFOtQk.js";
+import { a as toCamelCase, f as isLazyCommand, i as getUnknownKeysMode, o as toKebabCase, p as lazy, t as extractFields } from "./schema-extractor-DnOTAjV_.js";
+import { a as generateCompletion, p as generateBundledCompletionWorker, s as withCompletionCommand } from "./completion-CqKX9sCR.js";
 import { a as symbols, i as styles, n as logger, r as setColorEnabled, t as isColorEnabled } from "./logger-DbDkjdfO.js";
 
 export { CaseVariantCollisionError, DuplicateAliasError, DuplicateFieldError, DuplicateNegationError, PositionalConfigError, ReservedAliasError, arg, createDefineCommand, createDualCaseProxy, defineCommand, extractFields, formatCommandValidationErrors, formatValidationErrors, generateBundledCompletionWorker, generateCompletion, generateHelp, getUnknownKeysMode, isColorEnabled, isLazyCommand, lazy, logger, parseArgv, renderInline, renderMarkdown, runCommand, runMain, setColorEnabled, styles, symbols, toCamelCase, toKebabCase, validateCaseVariantCollisions, validateCommand, validateCrossSchemaCollisions, validateDuplicateAliases, validateDuplicateFields, validateDuplicateNegations, validatePositionalConfig, validateReservedAliases, withCompletionCommand };

package/dist/prompt/clack/index.d.ts

@@ -1,4 +1,4 @@
-import { P as PromptResolver } from "../../arg-registry-BN3I-XON.js";
+import { P as PromptResolver } from "../../arg-registry-aHbip9Hs.js";
 
 //#region src/prompt/clack/index.d.ts
 /**

package/dist/prompt/index.d.ts

@@ -1,4 +1,4 @@
-import { J as ResolvedFieldMeta, q as ExtractedFields } from "../arg-registry-BN3I-XON.js";
+import { J as ResolvedFieldMeta, q as ExtractedFields } from "../arg-registry-aHbip9Hs.js";
 
 //#region src/prompt/types.d.ts
 /**

package/dist/prompt/inquirer/index.d.ts

@@ -1,4 +1,4 @@
-import { P as PromptResolver } from "../../arg-registry-BN3I-XON.js";
+import { P as PromptResolver } from "../../arg-registry-aHbip9Hs.js";
 
 //#region src/prompt/inquirer/index.d.ts
 /**

package/dist/{runner-DZOmYkN0.js → runner-Z7R_XvAV.js}

@@ -1,4 +1,4 @@
-import { a as toCamelCase, c as listSubCommands, d as resolveSubcommandWithAlias, f as isLazyCommand, l as resolveLazyCommand, m as resolveSubCommandMeta, n as getAllAliases, o as toKebabCase, r as getExtractedFields, s as listSubCommandNamesWithAliases, t as extractFields } from "./schema-extractor-CVHWm23M.js";
+import { a as toCamelCase, c as listSubCommands, d as resolveSubcommandWithAlias, f as isLazyCommand, l as resolveLazyCommand, m as resolveSubCommandMeta, n as getAllAliases, o as toKebabCase, r as getExtractedFields, s as listSubCommandNamesWithAliases, t as extractFields } from "./schema-extractor-DnOTAjV_.js";
 import { n as emptyLogs, r as mergeLogs, t as createLogCollector } from "./log-collector-DK32-73m.js";
 import { a as symbols, i as styles } from "./logger-DbDkjdfO.js";
 import { stripVTControlCharacters } from "node:util";
@@ -1104,7 +1104,7 @@ function checkDuplicateNegations(extracted, commandPath) {
 				if (camelVariant !== alias) claim(camelVariant, field.name, "alias");
 			}
 		}
-		if (field.type === "boolean" && field.negation !== false && typeof field.negation !== "string") {
+		if (field.type === "boolean" && field.negation === true) {
 			const defaultKebab = `no-${field.cliName}`;
 			claim(defaultKebab, field.name, "default negation");
 			const camelBase = toCamelCase(field.cliName);
@@ -1443,7 +1443,7 @@ function resolveLongOption(arg, lookup) {
 			if (lookup.booleanFlags.has(resolvedName)) {
 				const asIsResolved = lookup.aliasMap.get(withoutDashes) ?? withoutDashes;
 				if (!lookup.definedNames.has(asIsResolved)) {
-					if (lookup.customNegatedFields.has(resolvedName)) return {
+					if (lookup.defaultNegationDisabledFields.has(resolvedName)) return {
 						resolvedName,
 						withoutDashes,
 						isNegated: false,
@@ -1467,7 +1467,7 @@ function resolveLongOption(arg, lookup) {
 		if (lookup.booleanFlags.has(resolvedName)) {
 			const asIsResolved = lookup.aliasMap.get(withoutDashes) ?? withoutDashes;
 			if (!lookup.definedNames.has(asIsResolved)) {
-				if (lookup.customNegatedFields.has(resolvedName)) return {
+				if (lookup.defaultNegationDisabledFields.has(resolvedName)) return {
 					resolvedName,
 					withoutDashes,
 					isNegated: false,
@@ -1504,7 +1504,7 @@ function resolveLongOption(arg, lookup) {
 * - 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`)
+* - Boolean negation: --no-flag, --noFlag (requires `booleanFlags` and `negation: true`)
 *
 * **Note:** When using negation detection (`--noFlag` / `--no-flag`),
 * supply `definedNames` so that options whose names happen to start with
@@ -1517,13 +1517,13 @@ function resolveLongOption(arg, lookup) {
 * @returns Parsed arguments
 */
 function parseArgv(argv, options = {}) {
-	const { aliasMap = /* @__PURE__ */ new Map(), booleanFlags = /* @__PURE__ */ new Set(), arrayFlags = /* @__PURE__ */ new Set(), definedNames = /* @__PURE__ */ new Set(), negationMap = /* @__PURE__ */ new Map(), customNegatedFields = /* @__PURE__ */ new Set() } = options;
+	const { aliasMap = /* @__PURE__ */ new Map(), booleanFlags = /* @__PURE__ */ new Set(), arrayFlags = /* @__PURE__ */ new Set(), definedNames = /* @__PURE__ */ new Set(), negationMap = /* @__PURE__ */ new Map(), defaultNegationDisabledFields: configuredDefaultNegationDisabledFields } = options;
 	const longOptionLookup = {
 		aliasMap,
 		booleanFlags,
 		definedNames,
 		negationMap,
-		customNegatedFields
+		defaultNegationDisabledFields: configuredDefaultNegationDisabledFields ?? new Set(booleanFlags)
 	};
 	const result = {
 		options: {},
@@ -1556,6 +1556,11 @@ function parseArgv(argv, options = {}) {
 		if (arg.startsWith("--")) {
 			const withoutDashes = arg.slice(2);
 			const resolution = resolveLongOption(arg, longOptionLookup);
+			if (resolution.isSuppressedNegation) {
+				setOption(resolution.withoutDashes, true);
+				i++;
+				continue;
+			}
 			if (resolution.isNegated) {
 				setOption(resolution.resolvedName, false);
 				i++;
@@ -1626,7 +1631,7 @@ function buildParserOptions(extracted) {
 	const arrayFlags = /* @__PURE__ */ new Set();
 	const definedNames = /* @__PURE__ */ new Set();
 	const negationMap = /* @__PURE__ */ new Map();
-	const customNegatedFields = /* @__PURE__ */ new Set();
+	const defaultNegationDisabledFields = /* @__PURE__ */ new Set();
 	for (const field of extracted.fields) definedNames.add(field.name);
 	for (const field of extracted.fields) {
 		if (field.cliName !== field.name) aliasMap.set(field.cliName, field.name);
@@ -1641,8 +1646,8 @@ function buildParserOptions(extracted) {
 		if (camelVariant !== field.name && !definedNames.has(camelVariant) && !aliasMap.has(camelVariant)) aliasMap.set(camelVariant, field.name);
 		if (field.type === "boolean") booleanFlags.add(field.name);
 		if (field.type === "array") arrayFlags.add(field.name);
-		if (field.type === "boolean" && (typeof field.negation === "string" || field.negation === false)) {
-			customNegatedFields.add(field.name);
+		if (field.type === "boolean" && field.negation !== true) {
+			defaultNegationDisabledFields.add(field.name);
 			if (typeof field.negation === "string") {
 				negationMap.set(field.negation, field.name);
 				if (field.negation.includes("-")) {
@@ -1658,7 +1663,7 @@ function buildParserOptions(extracted) {
 		arrayFlags,
 		definedNames,
 		negationMap,
-		customNegatedFields
+		defaultNegationDisabledFields
 	};
 }
 /**
@@ -1689,7 +1694,7 @@ function mergeWithPositionals(parsed, extracted) {
 * Shared by scanForSubcommand, separateGlobalArgs, and findFirstPositional.
 */
 function buildGlobalFlagLookup(globalExtracted) {
-	const { aliasMap = /* @__PURE__ */ new Map(), booleanFlags = /* @__PURE__ */ new Set(), definedNames = /* @__PURE__ */ new Set(), negationMap = /* @__PURE__ */ new Map(), customNegatedFields = /* @__PURE__ */ new Set() } = buildParserOptions(globalExtracted);
+	const { aliasMap = /* @__PURE__ */ new Map(), booleanFlags = /* @__PURE__ */ new Set(), definedNames = /* @__PURE__ */ new Set(), negationMap = /* @__PURE__ */ new Map(), defaultNegationDisabledFields = /* @__PURE__ */ new Set() } = buildParserOptions(globalExtracted);
 	const shortAliases = /* @__PURE__ */ new Set();
 	for (const field of globalExtracted.fields) for (const alias of getAllAliases(field)) if (alias.length === 1) shortAliases.add(alias);
 	return {
@@ -1700,7 +1705,7 @@ function buildGlobalFlagLookup(globalExtracted) {
 		cliNames: new Set(globalExtracted.fields.map((f) => f.cliName)),
 		aliases: shortAliases,
 		negationMap,
-		customNegatedFields
+		defaultNegationDisabledFields
 	};
 }
 /**
@@ -1708,8 +1713,8 @@ function buildGlobalFlagLookup(globalExtracted) {
 * against global flag lookup. Returns the resolved camelCase name and whether
 * it is a known global flag.
 *
-* `isSuppressedNegation` is true when the token matches a default `--no-X`
-* form that has been suppressed by a custom `negation` on the target field.
+* `isSuppressedNegation` is true when the token matches a disabled default
+* `--no-X` form on the target field.
 * The caller may use this to keep argv scanning past such tokens (so a
 * trailing subcommand is still detected) even though they no longer negate.
 */
@@ -1820,7 +1825,7 @@ function scanForSubcommand(argv, subCommandNames, globalExtracted) {
 		suppressedTokens
 	};
 }
-const BUILTIN_FLAGS = new Set([
+const BUILTIN_FLAGS = /* @__PURE__ */ new Set([
 	"--help",
 	"-h",
 	"--help-all",
@@ -1840,7 +1845,8 @@ const BUILTIN_FLAGS = new Set([
 * Without globalExtracted, no flag is global, so any leading flag halts the
 * scan and a positional is only found when it precedes every flag.
 */
-function findFirstPositionalIndex(argv, globalExtracted) {
+function findFirstPositionalIndex(argv, globalExtracted, options = {}) {
+	const stopOnSuppressedNegation = options.stopOnSuppressedNegation === true || globalExtracted?.unknownKeysMode === "strict";
 	const lookup = globalExtracted ? buildGlobalFlagLookup(globalExtracted) : {
 		aliasMap: /* @__PURE__ */ new Map(),
 		booleanFlags: /* @__PURE__ */ new Set(),
@@ -1849,7 +1855,7 @@ function findFirstPositionalIndex(argv, globalExtracted) {
 		cliNames: /* @__PURE__ */ new Set(),
 		aliases: /* @__PURE__ */ new Set(),
 		negationMap: /* @__PURE__ */ new Map(),
-		customNegatedFields: /* @__PURE__ */ new Set()
+		defaultNegationDisabledFields: /* @__PURE__ */ new Set()
 	};
 	for (let i = 0; i < argv.length; i++) {
 		const arg = argv[i];
@@ -1861,7 +1867,10 @@ function findFirstPositionalIndex(argv, globalExtracted) {
 				if (shouldConsumeValue(arg, resolvedName, isNegated, argv[i + 1], lookup.booleanFlags)) i++;
 				continue;
 			}
-			if (isSuppressedNegation) continue;
+			if (isSuppressedNegation) {
+				if (stopOnSuppressedNegation) return -1;
+				continue;
+			}
 			return -1;
 		}
 		const withoutDash = arg.includes("=") ? arg.slice(1, arg.indexOf("=")) : arg.slice(1);
@@ -1914,6 +1923,7 @@ function parseArgs(argv, command, options = {}) {
 				positionals: [],
 				rest: [],
 				unknownFlags: scanResult.suppressedTokens,
+				unknownGlobalFlags: scanResult.suppressedTokens,
 				rawGlobalArgs
 			};
 		}
@@ -1944,6 +1954,15 @@ function parseArgs(argv, command, options = {}) {
 			if (options.globalExtracted) validateCrossSchemaCollisions(options.globalExtracted, extracted);
 		}
 	}
+	let commandArgv = argv;
+	let rawGlobalArgs;
+	let suppressedGlobalFlags = [];
+	if (options.globalExtracted) {
+		const { separated, globalParsed, suppressedTokens } = separateGlobalArgs(argv, options.globalExtracted, extracted);
+		commandArgv = separated;
+		rawGlobalArgs = globalParsed;
+		suppressedGlobalFlags = suppressedTokens;
+	}
 	const ddIdx = argv.indexOf("--");
 	const flagScanArgv = ddIdx >= 0 ? argv.slice(0, ddIdx) : argv;
 	const hasUserDefinedH = extracted?.fields.some((f) => f.overrideBuiltinAlias === true && getAllAliases(f).includes("H")) ?? false;
@@ -1960,15 +1979,10 @@ function parseArgs(argv, command, options = {}) {
 		rawArgs: {},
 		positionals: [],
 		rest: [],
-		unknownFlags: []
+		unknownFlags: [],
+		unknownGlobalFlags: suppressedGlobalFlags,
+		rawGlobalArgs
 	};
-	let commandArgv = argv;
-	let rawGlobalArgs;
-	if (options.globalExtracted) {
-		const { separated, globalParsed } = separateGlobalArgs(argv, options.globalExtracted, extracted);
-		commandArgv = separated;
-		rawGlobalArgs = globalParsed;
-	}
 	if (!extracted) {
 		const ddIdx = commandArgv.indexOf("--");
 		return {
@@ -1981,6 +1995,7 @@ function parseArgs(argv, command, options = {}) {
 			positionals: ddIdx >= 0 ? commandArgv.slice(0, ddIdx) : commandArgv,
 			rest: ddIdx >= 0 ? commandArgv.slice(ddIdx + 1) : [],
 			unknownFlags: [],
+			unknownGlobalFlags: suppressedGlobalFlags,
 			rawGlobalArgs
 		};
 	}
@@ -2018,6 +2033,7 @@ function parseArgs(argv, command, options = {}) {
 		positionals: parsed.positionals,
 		rest: parsed.rest,
 		unknownFlags,
+		unknownGlobalFlags: suppressedGlobalFlags,
 		extractedFields: extracted,
 		rawGlobalArgs
 	};
@@ -2045,9 +2061,21 @@ function separateGlobalArgs(argv, globalExtracted, localExtracted) {
 	const lookup = buildGlobalFlagLookup(globalExtracted);
 	const localFieldNames = new Set(localExtracted?.fields.map((f) => f.name) ?? []);
 	const localCliNames = new Set(localExtracted?.fields.map((f) => f.cliName) ?? []);
-	const localAliasMapKeys = localExtracted ? new Set(buildParserOptions(localExtracted).aliasMap?.keys() ?? []) : /* @__PURE__ */ new Set();
+	const localParserOptions = localExtracted ? buildParserOptions(localExtracted) : void 0;
+	const localAliasMapKeys = new Set(localParserOptions?.aliasMap?.keys() ?? []);
+	const localNegationMapKeys = new Set(localParserOptions?.negationMap?.keys() ?? []);
+	const localDefaultNegationKeys = /* @__PURE__ */ new Set();
+	for (const field of localExtracted?.fields ?? []) {
+		if (field.type !== "boolean" || field.negation !== true) continue;
+		for (const name of [field.cliName, ...getAllAliases(field)]) {
+			const kebab = `no-${name}`;
+			localDefaultNegationKeys.add(kebab);
+			localDefaultNegationKeys.add(toCamelCase(kebab));
+		}
+	}
 	const globalTokens = [];
 	const commandTokens = [];
+	const suppressedTokens = [];
 	for (let i = 0; i < argv.length; i++) {
 		const arg = argv[i];
 		if (arg === "--") {
@@ -2055,13 +2083,17 @@ function separateGlobalArgs(argv, globalExtracted, localExtracted) {
 			break;
 		}
 		if (arg.startsWith("--")) {
-			const { resolvedName, withoutDashes, isNegated, isGlobal } = resolveGlobalLongOption(arg, lookup);
+			const { resolvedName, withoutDashes, isNegated, isGlobal, isSuppressedNegation } = resolveGlobalLongOption(arg, lookup);
 			const flagName = resolvedName;
-			const isLocalCollision = localFieldNames.has(withoutDashes) || localFieldNames.has(flagName) || localCliNames.has(withoutDashes) || localCliNames.has(flagName) || localAliasMapKeys.has(withoutDashes) || localAliasMapKeys.has(flagName);
+			const isLocalCollision = localFieldNames.has(withoutDashes) || localFieldNames.has(flagName) || localCliNames.has(withoutDashes) || localCliNames.has(flagName) || localAliasMapKeys.has(withoutDashes) || localAliasMapKeys.has(flagName) || localNegationMapKeys.has(withoutDashes) || localNegationMapKeys.has(flagName) || localDefaultNegationKeys.has(withoutDashes);
 			if (isGlobal && !isLocalCollision) {
 				i += collectGlobalFlag(argv, i, resolvedName, isNegated, lookup.booleanFlags, globalTokens) - 1;
 				continue;
 			}
+			if (isSuppressedNegation && !isLocalCollision) {
+				suppressedTokens.push(arg.includes("=") ? arg.slice(2, arg.indexOf("=")) : arg.slice(2));
+				continue;
+			}
 		} else if (arg.startsWith("-") && arg.length > 1) {
 			const withoutDash = arg.includes("=") ? arg.slice(1, arg.indexOf("=")) : arg.slice(1);
 			if (withoutDash.length === 1) {
@@ -2076,7 +2108,8 @@ function separateGlobalArgs(argv, globalExtracted, localExtracted) {
 	}
 	return {
 		separated: commandTokens,
-		globalParsed: parseGlobalArgs(globalTokens, globalExtracted)
+		globalParsed: parseGlobalArgs(globalTokens, globalExtracted),
+		suppressedTokens
 	};
 }
 
@@ -2354,10 +2387,10 @@ async function runMain(command, options = {}) {
 		effectiveOptions = rest;
 	}
 	const globalExtracted = extractAndValidateGlobal(effectiveOptions);
-	if (effectiveOptions.onUnknownSubcommand && !isInternalSubcommandInvocation(command, argv, globalExtractedForBypass)) {
+	if (effectiveOptions.onUnknownSubcommand && !command.run && !isInternalSubcommandInvocation(command, argv, globalExtractedForBypass)) {
 		const knownSubCommands = listSubCommandNamesWithAliases(command);
 		if (knownSubCommands.size > 0) {
-			const positionalIndex = findFirstPositionalIndex(argv, globalExtracted);
+			const positionalIndex = findFirstPositionalIndex(argv, globalExtracted, { stopOnSuppressedNegation: globalExtracted?.unknownKeysMode !== "passthrough" });
 			const name = positionalIndex >= 0 ? argv[positionalIndex] : void 0;
 			if (name && !knownSubCommands.has(name)) {
 				const forwardArgs = argv.slice(positionalIndex + 1);
@@ -2447,10 +2480,10 @@ async function runCommandInternal(command, argv, options = {}) {
 			...parseResult.rawGlobalArgs
 		};
 		const nestedCommandPath = context.commandPath ?? [];
-		if (options.onUnknownSubcommand && nestedCommandPath.length > 0) {
+		if (options.onUnknownSubcommand && !command.run && nestedCommandPath.length > 0) {
 			const knownSubCommands = listSubCommandNamesWithAliases(command);
 			if (knownSubCommands.size > 0) {
-				const positionalIndex = findFirstPositionalIndex(argv, options._globalExtracted);
+				const positionalIndex = findFirstPositionalIndex(argv, options._globalExtracted, { stopOnSuppressedNegation: options._globalExtracted?.unknownKeysMode !== "passthrough" });
 				const name = positionalIndex >= 0 ? argv[positionalIndex] : void 0;
 				if (name && !knownSubCommands.has(name)) {
 					const forwardArgs = argv.slice(positionalIndex + 1);
@@ -2516,6 +2549,22 @@ async function runCommandInternal(command, argv, options = {}) {
 				logs: getCurrentLogs()
 			};
 		}
+		if (parseResult.unknownGlobalFlags && parseResult.unknownGlobalFlags.length > 0) {
+			const globalMode = context.globalExtracted?.unknownKeysMode ?? "strip";
+			if (globalMode === "strict") {
+				collector?.stop();
+				return {
+					success: false,
+					error: /* @__PURE__ */ new Error(`Unknown flags: ${parseResult.unknownGlobalFlags.join(", ")}`),
+					exitCode: 1,
+					logs: getCurrentLogs()
+				};
+			}
+			if (globalMode === "strip") {
+				const knownGlobalFlags = context.globalExtracted?.fields.map((f) => f.name) ?? [];
+				for (const flag of parseResult.unknownGlobalFlags) logger.error(formatUnknownFlagWarning(flag, knownGlobalFlags));
+			}
+		}
 		if (parseResult.versionRequested) {
 			const version = context.rootVersion;
 			if (version) logger.log(version);
@@ -2528,22 +2577,6 @@ async function runCommandInternal(command, argv, options = {}) {
 			};
 		}
 		if (parseResult.subCommand) {
-			if (parseResult.unknownFlags.length > 0) {
-				const globalMode = context.globalExtracted?.unknownKeysMode ?? "strip";
-				if (globalMode === "strict") {
-					collector?.stop();
-					return {
-						success: false,
-						error: /* @__PURE__ */ new Error(`Unknown flags: ${parseResult.unknownFlags.join(", ")}`),
-						exitCode: 1,
-						logs: getCurrentLogs()
-					};
-				}
-				if (globalMode === "strip") {
-					const knownGlobalFlags = context.globalExtracted?.fields.map((f) => f.name) ?? [];
-					for (const flag of parseResult.unknownFlags) logger.error(formatUnknownFlagWarning(flag, knownGlobalFlags));
-				}
-			}
 			const resolved = await resolveSubcommandWithAlias(command, parseResult.subCommand);
 			if (resolved) {
 				const subContext = {
@@ -2727,4 +2760,4 @@ function extractAndValidateGlobal(options) {
 
 //#endregion
 export { renderMarkdown as C, renderInline as S, DuplicateFieldError as _, parseArgv as a, ReservedAliasError as b, validateCommand as c, validateDuplicateFields as d, validateDuplicateNegations as f, DuplicateAliasError as g, CaseVariantCollisionError as h, formatValidationErrors as i, validateCrossSchemaCollisions as l, validateReservedAliases as m, runMain as n, formatCommandValidationErrors as o, validatePositionalConfig as p, runner_exports as r, validateCaseVariantCollisions as s, runCommand as t, validateDuplicateAliases as u, DuplicateNegationError as v, createDualCaseProxy as w, generateHelp as x, PositionalConfigError as y };
-//# sourceMappingURL=runner-DZOmYkN0.js.map
+//# sourceMappingURL=runner-Z7R_XvAV.js.map

package/dist/{schema-extractor-CVHWm23M.js → schema-extractor-DnOTAjV_.js}

@@ -153,7 +153,7 @@ function getArgMeta(schema) {
 * Long flag names reserved for built-in handling (parseArgs / scanForSubcommand
 * intercept these before option parsing), so custom negation names must avoid them.
 */
-const RESERVED_NEGATION_NAMES = new Set([
+const RESERVED_NEGATION_NAMES = /* @__PURE__ */ new Set([
 	"help",
 	"help-all",
 	"version"
@@ -597,4 +597,4 @@ function getExtractedFields(command) {
 
 //#endregion
 export { toCamelCase as a, listSubCommands as c, resolveSubcommandWithAlias as d, isLazyCommand as f, getUnknownKeysMode as i, resolveLazyCommand as l, resolveSubCommandMeta as m, getAllAliases as n, toKebabCase as o, lazy as p, getExtractedFields as r, listSubCommandNamesWithAliases as s, extractFields as t, resolveSubCommandAlias as u };
-//# sourceMappingURL=schema-extractor-CVHWm23M.js.map
+//# sourceMappingURL=schema-extractor-DnOTAjV_.js.map

package/dist/skill/index.d.ts

@@ -1,4 +1,4 @@
-import { _ as AnyCommand } from "../arg-registry-BN3I-XON.js";
+import { _ as AnyCommand } from "../arg-registry-aHbip9Hs.js";
 import { z } from "zod";
 
 //#region src/skill/frontmatter.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "politty",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "A lightweight CLI framework inspired by citty with zod v4 registry integration for type-safe metadata management",
   "keywords": [
     "argument-parser",
@@ -68,16 +68,16 @@
     "@clack/prompts": "1.2.0",
     "@inquirer/prompts": "8.5.2",
     "@quansync/fs": "1.0.0",
-    "@types/node": "25.9.3",
-    "@typescript/native-preview": "7.0.0-dev.20260615.1",
+    "@types/node": "25.9.4",
+    "@typescript/native-preview": "7.0.0-dev.20260621.1",
     "@vitest/coverage-v8": "4.1.9",
-    "knip": "6.16.1",
+    "knip": "6.17.1",
     "lefthook": "2.1.9",
     "organize-imports-cli": "1.0.2",
     "oxfmt": "0.55.0",
     "oxlint": "1.70.0",
     "quansync": "1.0.0",
-    "tsdown": "0.22.2",
+    "tsdown": "0.22.3",
     "tsx": "4.22.4",
     "typescript": "6.0.3",
     "vitest": "4.1.9",