@optique/core 1.1.0-dev.1998 → 1.1.0-dev.2006

package/dist/index.cjs

@@ -81,6 +81,7 @@ exports.mergeHidden = require_usage.mergeHidden;
 exports.message = require_message.message;
 exports.metavar = require_message.metavar;
 exports.multiple = require_modifiers.multiple;
+exports.negatableFlag = require_primitives.negatableFlag;
 exports.nonEmpty = require_modifiers.nonEmpty;
 exports.normalizeUsage = require_usage.normalizeUsage;
 exports.nu = require_completion.nu;

package/dist/index.d.cts

@@ -11,5 +11,5 @@ import { ParserValuePlaceholder, SourceContext, SourceContextRequest } from "./c
 import { AnyDependencySource, CombineMode, CombinedDependencyMode, DependencyMode, DependencySource, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, dependency, deriveFrom, deriveFromAsync, deriveFromSync, isDependencySource, isDerivedValueParser } from "./internal/dependency.cjs";
 import { CommandSubConfig, ContextOptionsParam, ExtractRequiredOptions, OptionSubConfig, RunOptions, RunParserError, RunWithOptions, SubstituteParserValue, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync } from "./facade.cjs";
 import { MultipleErrorOptions, MultipleOptions, WithDefaultError, WithDefaultOptions, map, multiple, nonEmpty, optional, withDefault } from "./modifiers.cjs";
-import { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, OptionErrorOptions, OptionOptions, OptionState, PassThroughFormat, PassThroughOptions, argument, command, constant, fail, flag, option, passThrough } from "./primitives.cjs";
-export { type Annotations, AnyDependencySource, ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, CombineMode, CombineModes, CombinedDependencyMode, CommandErrorOptions, CommandOptions, CommandSubConfig, ConditionalErrorOptions, ConditionalOptions, ContextOptionsParam, DeferredMap, DependencyMode, DependencySource, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DomainOptions, DuplicateOptionError, EmailOptions, ExecutionContext, ExecutionPhase, ExtractRequiredOptions, FlagErrorOptions, FlagOptions, FloatOptions, GroupOptions, HiddenVisibility, HostnameOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MacAddressOptions, MergeOptions, type Message, type MessageFormatOptions, type MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OptionState, OptionSubConfig, OrErrorOptions, OrOptions, ParseFrame, type ParseOptions, Parser, ParserContext, ParserResult, ParserValuePlaceholder, PassThroughFormat, PassThroughOptions, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, Result, RunOptions, RunParserError, RunWithOptions, ShellCompletion, ShowChoicesOptions, ShowDefaultOptions, SocketAddressOptions, SocketAddressValue, SourceContext, SourceContextRequest, StringOptions, SubstituteParserValue, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, type ValueSetOptions, WithDefaultError, WithDefaultOptions, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createParserContext, deduplicateDocEntries, deduplicateDocFragments, dependency, deriveFrom, deriveFromAsync, deriveFromSync, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDependencySource, isDerivedValueParser, isDocEntryHidden, isDocHidden, isNonEmptyString, isSuggestionHidden, isUsageHidden, isValueParser, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, passThrough, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, valueSet, values, withDefault, zsh };
+import { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, NegatableFlagErrorOptions, NegatableFlagNameList, NegatableFlagNames, NegatableFlagOptions, NegatableFlagState, OptionErrorOptions, OptionOptions, OptionState, PassThroughFormat, PassThroughOptions, argument, command, constant, fail, flag, negatableFlag, option, passThrough } from "./primitives.cjs";
+export { type Annotations, AnyDependencySource, ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, CombineMode, CombineModes, CombinedDependencyMode, CommandErrorOptions, CommandOptions, CommandSubConfig, ConditionalErrorOptions, ConditionalOptions, ContextOptionsParam, DeferredMap, DependencyMode, DependencySource, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DomainOptions, DuplicateOptionError, EmailOptions, ExecutionContext, ExecutionPhase, ExtractRequiredOptions, FlagErrorOptions, FlagOptions, FloatOptions, GroupOptions, HiddenVisibility, HostnameOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MacAddressOptions, MergeOptions, type Message, type MessageFormatOptions, type MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NegatableFlagErrorOptions, NegatableFlagNameList, NegatableFlagNames, NegatableFlagOptions, NegatableFlagState, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OptionState, OptionSubConfig, OrErrorOptions, OrOptions, ParseFrame, type ParseOptions, Parser, ParserContext, ParserResult, ParserValuePlaceholder, PassThroughFormat, PassThroughOptions, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, Result, RunOptions, RunParserError, RunWithOptions, ShellCompletion, ShowChoicesOptions, ShowDefaultOptions, SocketAddressOptions, SocketAddressValue, SourceContext, SourceContextRequest, StringOptions, SubstituteParserValue, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, type ValueSetOptions, WithDefaultError, WithDefaultOptions, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createParserContext, deduplicateDocEntries, deduplicateDocFragments, dependency, deriveFrom, deriveFromAsync, deriveFromSync, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDependencySource, isDerivedValueParser, isDocEntryHidden, isDocHidden, isNonEmptyString, isSuggestionHidden, isUsageHidden, isValueParser, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, negatableFlag, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, passThrough, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, valueSet, values, withDefault, zsh };

package/dist/index.d.ts

@@ -11,5 +11,5 @@ import { ParserValuePlaceholder, SourceContext, SourceContextRequest } from "./c
 import { AnyDependencySource, CombineMode, CombinedDependencyMode, DependencyMode, DependencySource, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, dependency, deriveFrom, deriveFromAsync, deriveFromSync, isDependencySource, isDerivedValueParser } from "./internal/dependency.js";
 import { CommandSubConfig, ContextOptionsParam, ExtractRequiredOptions, OptionSubConfig, RunOptions, RunParserError, RunWithOptions, SubstituteParserValue, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync } from "./facade.js";
 import { MultipleErrorOptions, MultipleOptions, WithDefaultError, WithDefaultOptions, map, multiple, nonEmpty, optional, withDefault } from "./modifiers.js";
-import { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, OptionErrorOptions, OptionOptions, OptionState, PassThroughFormat, PassThroughOptions, argument, command, constant, fail, flag, option, passThrough } from "./primitives.js";
-export { type Annotations, AnyDependencySource, ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, CombineMode, CombineModes, CombinedDependencyMode, CommandErrorOptions, CommandOptions, CommandSubConfig, ConditionalErrorOptions, ConditionalOptions, ContextOptionsParam, DeferredMap, DependencyMode, DependencySource, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DomainOptions, DuplicateOptionError, EmailOptions, ExecutionContext, ExecutionPhase, ExtractRequiredOptions, FlagErrorOptions, FlagOptions, FloatOptions, GroupOptions, HiddenVisibility, HostnameOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MacAddressOptions, MergeOptions, type Message, type MessageFormatOptions, type MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OptionState, OptionSubConfig, OrErrorOptions, OrOptions, ParseFrame, type ParseOptions, Parser, ParserContext, ParserResult, ParserValuePlaceholder, PassThroughFormat, PassThroughOptions, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, Result, RunOptions, RunParserError, RunWithOptions, ShellCompletion, ShowChoicesOptions, ShowDefaultOptions, SocketAddressOptions, SocketAddressValue, SourceContext, SourceContextRequest, StringOptions, SubstituteParserValue, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, type ValueSetOptions, WithDefaultError, WithDefaultOptions, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createParserContext, deduplicateDocEntries, deduplicateDocFragments, dependency, deriveFrom, deriveFromAsync, deriveFromSync, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDependencySource, isDerivedValueParser, isDocEntryHidden, isDocHidden, isNonEmptyString, isSuggestionHidden, isUsageHidden, isValueParser, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, passThrough, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, valueSet, values, withDefault, zsh };
+import { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, NegatableFlagErrorOptions, NegatableFlagNameList, NegatableFlagNames, NegatableFlagOptions, NegatableFlagState, OptionErrorOptions, OptionOptions, OptionState, PassThroughFormat, PassThroughOptions, argument, command, constant, fail, flag, negatableFlag, option, passThrough } from "./primitives.js";
+export { type Annotations, AnyDependencySource, ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, CombineMode, CombineModes, CombinedDependencyMode, CommandErrorOptions, CommandOptions, CommandSubConfig, ConditionalErrorOptions, ConditionalOptions, ContextOptionsParam, DeferredMap, DependencyMode, DependencySource, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DomainOptions, DuplicateOptionError, EmailOptions, ExecutionContext, ExecutionPhase, ExtractRequiredOptions, FlagErrorOptions, FlagOptions, FloatOptions, GroupOptions, HiddenVisibility, HostnameOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MacAddressOptions, MergeOptions, type Message, type MessageFormatOptions, type MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NegatableFlagErrorOptions, NegatableFlagNameList, NegatableFlagNames, NegatableFlagOptions, NegatableFlagState, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OptionState, OptionSubConfig, OrErrorOptions, OrOptions, ParseFrame, type ParseOptions, Parser, ParserContext, ParserResult, ParserValuePlaceholder, PassThroughFormat, PassThroughOptions, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, Result, RunOptions, RunParserError, RunWithOptions, ShellCompletion, ShowChoicesOptions, ShowDefaultOptions, SocketAddressOptions, SocketAddressValue, SourceContext, SourceContextRequest, StringOptions, SubstituteParserValue, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, type ValueSetOptions, WithDefaultError, WithDefaultOptions, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createParserContext, deduplicateDocEntries, deduplicateDocFragments, dependency, deriveFrom, deriveFromAsync, deriveFromSync, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDependencySource, isDerivedValueParser, isDocEntryHidden, isDocHidden, isNonEmptyString, isSuggestionHidden, isUsageHidden, isValueParser, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, negatableFlag, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, passThrough, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, valueSet, values, withDefault, zsh };

package/dist/index.js

@@ -9,7 +9,7 @@ import { DuplicateOptionError, concat, conditional, group, longestMatch, merge,
 import { WithDefaultError, map, multiple, nonEmpty, optional, withDefault } from "./modifiers.js";
 import { ensureNonEmptyString, isNonEmptyString } from "./nonempty.js";
 import { checkBooleanOption, checkEnumOption, choice, cidr, domain, email, float, hostname, integer, ip, ipv4, ipv6, isValueParser, locale, macAddress, port, portRange, socketAddress, string, url, uuid } from "./valueparser.js";
-import { argument, command, constant, fail, flag, option, passThrough } from "./primitives.js";
+import { argument, command, constant, fail, flag, negatableFlag, option, passThrough } from "./primitives.js";
 import { RunParserError, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync } from "./facade.js";
 
-export { DuplicateOptionError, RunParserError, WithDefaultError, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createParserContext, deduplicateDocEntries, deduplicateDocFragments, dependency, deriveFrom, deriveFromAsync, deriveFromSync, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDependencySource, isDerivedValueParser, isDocEntryHidden, isDocHidden, isNonEmptyString, isSuggestionHidden, isUsageHidden, isValueParser, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, passThrough, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, valueSet, values, withDefault, zsh };
+export { DuplicateOptionError, RunParserError, WithDefaultError, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createParserContext, deduplicateDocEntries, deduplicateDocFragments, dependency, deriveFrom, deriveFromAsync, deriveFromSync, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDependencySource, isDerivedValueParser, isDocEntryHidden, isDocHidden, isNonEmptyString, isSuggestionHidden, isUsageHidden, isValueParser, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, negatableFlag, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, passThrough, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, valueSet, values, withDefault, zsh };

package/dist/primitives.cjs

@@ -929,6 +929,221 @@ function flag(...args) {
 	});
 	return result;
 }
+function normalizeNegatableFlagNameList(names) {
+	return typeof names === "string" ? [names] : names;
+}
+function validateNoDuplicateOptionNames(names, label) {
+	const seen = /* @__PURE__ */ new Set();
+	for (const name of names) {
+		if (seen.has(name)) throw new TypeError(`${label} has a duplicate name: "${name}".`);
+		seen.add(name);
+	}
+}
+function validateNoNegatableFlagNameCollision(positiveNames, negativeNames) {
+	const positiveSet = new Set(positiveNames);
+	for (const name of negativeNames) if (positiveSet.has(name)) throw new TypeError(`Negatable flag name is both positive and negative: "${name}".`);
+}
+function formatNegatableFlagDuplicateError(options, token) {
+	return options.errors?.duplicate ? typeof options.errors.duplicate === "function" ? options.errors.duplicate(token) : options.errors.duplicate : require_message.message`${require_message.optionName(token)} cannot be used multiple times.`;
+}
+function formatNegatableFlagConflictError(options, previousToken, token) {
+	return options.errors?.conflict ? typeof options.errors.conflict === "function" ? options.errors.conflict(previousToken, token) : options.errors.conflict : require_message.message`${require_message.optionName(previousToken)} and ${require_message.optionName(token)} cannot be used together.`;
+}
+function formatNegatableFlagUnexpectedValueError(options, optionName$1, value) {
+	return options.errors?.unexpectedValue ? typeof options.errors.unexpectedValue === "function" ? options.errors.unexpectedValue(optionName$1, value) : options.errors.unexpectedValue : require_message.message`Flag ${require_message.optionName(optionName$1)} does not accept a value, but got: ${value}.`;
+}
+function parseMatchedNegatableFlag(context, token, value, consumed, consumedOnFailure, buffer, options) {
+	if (context.state != null) return {
+		success: false,
+		consumed: consumedOnFailure,
+		error: context.state.value === value ? formatNegatableFlagDuplicateError(options, token) : formatNegatableFlagConflictError(options, context.state.token, token)
+	};
+	return {
+		success: true,
+		next: {
+			...context,
+			state: {
+				value,
+				token
+			},
+			buffer
+		},
+		consumed
+	};
+}
+/**
+* Creates a parser for a pair of command-line flags that explicitly enable or
+* disable a Boolean value.
+*
+* The positive names produce `true`; the negative names produce `false`.
+* Unlike {@link option}, this parser fails when neither side is present,
+* matching {@link flag} semantics. Wrap it in {@link optional} for a
+* tri-state override or {@link withDefault} for a concrete fallback.
+*
+* @param names The positive and negative option names to parse.
+* @param options Optional metadata and error customization.
+* @returns A {@link Parser} that produces `true` for positive names and
+*          `false` for negative names.
+* @throws {TypeError} If any option name is invalid, duplicated within one
+*         side, or shared by the positive and negative sides.
+* @since 1.1.0
+*/
+function negatableFlag(names, options = {}) {
+	const positiveNames = normalizeNegatableFlagNameList(names.positive);
+	const negativeNames = normalizeNegatableFlagNameList(names.negative);
+	require_validate.validateOptionNames(positiveNames, "Positive flag");
+	require_validate.validateOptionNames(negativeNames, "Negative flag");
+	validateNoDuplicateOptionNames(positiveNames, "Positive flag");
+	validateNoDuplicateOptionNames(negativeNames, "Negative flag");
+	validateNoNegatableFlagNameCollision(positiveNames, negativeNames);
+	const optionNames$1 = [...positiveNames, ...negativeNames];
+	const valueByName = /* @__PURE__ */ new Map();
+	for (const name of positiveNames) valueByName.set(name, true);
+	for (const name of negativeNames) valueByName.set(name, false);
+	const result = {
+		$valueType: [],
+		$stateType: [],
+		mode: "sync",
+		priority: 10,
+		usage: [{
+			type: "option",
+			names: optionNames$1,
+			...options.hidden != null && { hidden: options.hidden }
+		}],
+		leadingNames: new Set(optionNames$1),
+		acceptingAnyToken: false,
+		initialState: void 0,
+		parse(context) {
+			if (context.optionsTerminated) return {
+				success: false,
+				consumed: 0,
+				error: options.errors?.optionsTerminated ?? require_message.message`No more options can be parsed.`
+			};
+			else if (context.buffer.length < 1) return {
+				success: false,
+				consumed: 0,
+				error: options.errors?.endOfInput ?? require_message.message`Expected an option, but got end of input.`
+			};
+			if (context.buffer[0] === "--") return {
+				success: true,
+				next: {
+					...context,
+					buffer: context.buffer.slice(1),
+					state: context.state,
+					optionsTerminated: true
+				},
+				consumed: context.buffer.slice(0, 1)
+			};
+			const directValue = valueByName.get(context.buffer[0]);
+			if (directValue != null) return parseMatchedNegatableFlag(context, context.buffer[0], directValue, context.buffer.slice(0, 1), 1, context.buffer.slice(1), options);
+			for (const name of optionNames$1) {
+				if (!name.startsWith("--") && !name.startsWith("/") && !name.startsWith("+") && !(name.startsWith("-") && name.length > 2)) continue;
+				const prefix = name.startsWith("/") ? `${name}:` : `${name}=`;
+				if (context.buffer[0].startsWith(prefix)) {
+					const value = context.buffer[0].slice(prefix.length);
+					return {
+						success: false,
+						consumed: 1,
+						error: formatNegatableFlagUnexpectedValueError(options, prefix.slice(0, -1), value)
+					};
+				}
+			}
+			for (const shortOption of optionNames$1) {
+				if (!shortOption.match(/^-[^-]$/)) continue;
+				if (!context.buffer[0].startsWith(shortOption)) continue;
+				return parseMatchedNegatableFlag(context, shortOption, valueByName.get(shortOption), [context.buffer[0].slice(0, 2)], 1, [`-${context.buffer[0].slice(2)}`, ...context.buffer.slice(1)], options);
+			}
+			const invalidOption = context.buffer[0];
+			if (options.errors?.noMatch) {
+				const candidates = /* @__PURE__ */ new Set();
+				for (const name of require_usage.extractOptionNames(context.usage)) candidates.add(name);
+				const suggestions = require_suggestion.findSimilar(invalidOption, candidates, require_suggestion.DEFAULT_FIND_SIMILAR_OPTIONS);
+				return {
+					success: false,
+					consumed: 0,
+					error: typeof options.errors.noMatch === "function" ? options.errors.noMatch(invalidOption, suggestions) : options.errors.noMatch
+				};
+			}
+			const baseError = require_message.message`No matched option for ${require_message.optionName(invalidOption)}.`;
+			return {
+				success: false,
+				consumed: 0,
+				error: require_suggestion.createErrorWithSuggestions(baseError, invalidOption, context.usage, "option")
+			};
+		},
+		complete(state, _exec) {
+			if (state == null) return {
+				success: false,
+				error: options.errors?.missing ? typeof options.errors.missing === "function" ? options.errors.missing(positiveNames, negativeNames) : options.errors.missing : require_message.message`Required flag ${require_message.optionNames(optionNames$1)} is missing.`
+			};
+			return {
+				success: true,
+				value: state.value
+			};
+		},
+		suggest(_context, prefix) {
+			if (require_usage.isSuggestionHidden(options.hidden)) return [];
+			const suggestions = [];
+			if (prefix.startsWith("--") || prefix.startsWith("-") || prefix.startsWith("/") || prefix.startsWith("+")) {
+				for (const optionName$1 of optionNames$1) if (optionName$1.startsWith(prefix)) {
+					if (prefix === "-" && optionName$1.length !== 2) continue;
+					suggestions.push({
+						kind: "literal",
+						text: optionName$1
+					});
+				}
+			}
+			return suggestions;
+		},
+		getDocFragments(_state, _defaultValue) {
+			if (require_usage.isDocHidden(options.hidden)) return {
+				fragments: [],
+				description: options.description
+			};
+			const fragments = [{
+				type: "entry",
+				term: {
+					type: "option",
+					names: optionNames$1
+				},
+				description: options.description
+			}];
+			return {
+				fragments,
+				description: options.description
+			};
+		},
+		[Symbol.for("Deno.customInspect")]() {
+			const args = [`positive: ${JSON.stringify(positiveNames)}`, `negative: ${JSON.stringify(negativeNames)}`];
+			return `negatableFlag({ ${args.join(", ")} })`;
+		}
+	};
+	Object.defineProperty(result, "validateValue", {
+		value(v) {
+			if (typeof v !== "boolean") {
+				const actualType = v === null ? "null" : typeof v;
+				return {
+					success: false,
+					error: require_message.message`${require_message.optionNames(optionNames$1)}: Expected a boolean value, but received ${actualType}.`
+				};
+			}
+			return {
+				success: true,
+				value: v
+			};
+		},
+		configurable: true,
+		enumerable: false,
+		writable: false
+	});
+	Object.defineProperty(result, "placeholder", {
+		value: false,
+		configurable: true,
+		enumerable: false,
+		writable: false
+	});
+	return result;
+}
 /**
 * Creates a parser that expects a single argument value.
 * This parser is typically used for positional arguments
@@ -1606,5 +1821,6 @@ exports.command = command;
 exports.constant = constant;
 exports.fail = fail;
 exports.flag = flag;
+exports.negatableFlag = negatableFlag;
 exports.option = option;
 exports.passThrough = passThrough;

package/dist/primitives.d.cts

@@ -237,6 +237,110 @@ interface FlagErrorOptions {
  * ```
  */
 declare function flag(...args: readonly [OptionName, ...readonly OptionName[], FlagOptions] | readonly [OptionName, ...readonly OptionName[]]): Parser<"sync", true, ValueParserResult<true> | undefined>;
+/**
+ * A non-empty list of option names, or a single option name.
+ * @since 1.1.0
+ */
+type NegatableFlagNameList = OptionName | readonly [OptionName, ...readonly OptionName[]];
+/**
+ * Option names for the {@link negatableFlag} parser.
+ * @since 1.1.0
+ */
+interface NegatableFlagNames {
+  /**
+   * Option names that produce `true`.
+   */
+  readonly positive: NegatableFlagNameList;
+  /**
+   * Option names that produce `false`.
+   */
+  readonly negative: NegatableFlagNameList;
+}
+/**
+ * Options for the {@link negatableFlag} parser.
+ * @since 1.1.0
+ */
+interface NegatableFlagOptions {
+  /**
+   * The description of the flag pair, which can be used for help messages.
+   */
+  readonly description?: Message;
+  /**
+   * Controls flag visibility:
+   *
+   * - `true`: hide from usage, docs, and suggestions
+   * - `"usage"`: hide from usage only
+   * - `"doc"`: hide from docs only
+   * - `"help"`: hide from usage and docs, keep suggestions
+   */
+  readonly hidden?: HiddenVisibility;
+  /**
+   * Error message customization options.
+   */
+  readonly errors?: NegatableFlagErrorOptions;
+}
+/**
+ * Options for customizing error messages in the {@link negatableFlag} parser.
+ * @since 1.1.0
+ */
+interface NegatableFlagErrorOptions {
+  /**
+   * Custom error message when neither flag is provided.
+   * Can be a static message or a function that receives the positive and
+   * negative option names.
+   */
+  readonly missing?: Message | ((positiveNames: readonly string[], negativeNames: readonly string[]) => Message);
+  /**
+   * Custom error message when options are terminated (after --).
+   */
+  readonly optionsTerminated?: Message;
+  /**
+   * Custom error message when input is empty but a flag is expected.
+   */
+  readonly endOfInput?: Message;
+  /**
+   * Custom error message when the same polarity is used multiple times.
+   */
+  readonly duplicate?: Message | ((token: string) => Message);
+  /**
+   * Custom error message when both positive and negative flags are used.
+   */
+  readonly conflict?: Message | ((previousToken: string, token: string) => Message);
+  /**
+   * Custom error message when a flag receives an unexpected value.
+   */
+  readonly unexpectedValue?: Message | ((optionName: string, value: string) => Message);
+  /**
+   * Custom error message when no matching flag is found.
+   */
+  readonly noMatch?: Message | ((invalidOption: string, suggestions: readonly string[]) => Message);
+}
+/**
+ * State stored by the {@link negatableFlag} parser.
+ * @since 1.1.0
+ */
+interface NegatableFlagState {
+  readonly value: boolean;
+  readonly token: string;
+}
+/**
+ * Creates a parser for a pair of command-line flags that explicitly enable or
+ * disable a Boolean value.
+ *
+ * The positive names produce `true`; the negative names produce `false`.
+ * Unlike {@link option}, this parser fails when neither side is present,
+ * matching {@link flag} semantics. Wrap it in {@link optional} for a
+ * tri-state override or {@link withDefault} for a concrete fallback.
+ *
+ * @param names The positive and negative option names to parse.
+ * @param options Optional metadata and error customization.
+ * @returns A {@link Parser} that produces `true` for positive names and
+ *          `false` for negative names.
+ * @throws {TypeError} If any option name is invalid, duplicated within one
+ *         side, or shared by the positive and negative sides.
+ * @since 1.1.0
+ */
+declare function negatableFlag(names: NegatableFlagNames, options?: NegatableFlagOptions): Parser<"sync", boolean, NegatableFlagState | undefined>;
 /**
  * Options for the {@link argument} parser.
  */
@@ -483,4 +587,4 @@ interface PassThroughOptions {
  */
 declare function passThrough(options?: PassThroughOptions): Parser<"sync", readonly string[], readonly string[]>;
 //#endregion
-export { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, OptionErrorOptions, OptionOptions, OptionState, PassThroughFormat, PassThroughOptions, argument, command, constant, fail, flag, option, passThrough };
+export { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, NegatableFlagErrorOptions, NegatableFlagNameList, NegatableFlagNames, NegatableFlagOptions, NegatableFlagState, OptionErrorOptions, OptionOptions, OptionState, PassThroughFormat, PassThroughOptions, argument, command, constant, fail, flag, negatableFlag, option, passThrough };

package/dist/primitives.d.ts

@@ -237,6 +237,110 @@ interface FlagErrorOptions {
  * ```
  */
 declare function flag(...args: readonly [OptionName, ...readonly OptionName[], FlagOptions] | readonly [OptionName, ...readonly OptionName[]]): Parser<"sync", true, ValueParserResult<true> | undefined>;
+/**
+ * A non-empty list of option names, or a single option name.
+ * @since 1.1.0
+ */
+type NegatableFlagNameList = OptionName | readonly [OptionName, ...readonly OptionName[]];
+/**
+ * Option names for the {@link negatableFlag} parser.
+ * @since 1.1.0
+ */
+interface NegatableFlagNames {
+  /**
+   * Option names that produce `true`.
+   */
+  readonly positive: NegatableFlagNameList;
+  /**
+   * Option names that produce `false`.
+   */
+  readonly negative: NegatableFlagNameList;
+}
+/**
+ * Options for the {@link negatableFlag} parser.
+ * @since 1.1.0
+ */
+interface NegatableFlagOptions {
+  /**
+   * The description of the flag pair, which can be used for help messages.
+   */
+  readonly description?: Message;
+  /**
+   * Controls flag visibility:
+   *
+   * - `true`: hide from usage, docs, and suggestions
+   * - `"usage"`: hide from usage only
+   * - `"doc"`: hide from docs only
+   * - `"help"`: hide from usage and docs, keep suggestions
+   */
+  readonly hidden?: HiddenVisibility;
+  /**
+   * Error message customization options.
+   */
+  readonly errors?: NegatableFlagErrorOptions;
+}
+/**
+ * Options for customizing error messages in the {@link negatableFlag} parser.
+ * @since 1.1.0
+ */
+interface NegatableFlagErrorOptions {
+  /**
+   * Custom error message when neither flag is provided.
+   * Can be a static message or a function that receives the positive and
+   * negative option names.
+   */
+  readonly missing?: Message | ((positiveNames: readonly string[], negativeNames: readonly string[]) => Message);
+  /**
+   * Custom error message when options are terminated (after --).
+   */
+  readonly optionsTerminated?: Message;
+  /**
+   * Custom error message when input is empty but a flag is expected.
+   */
+  readonly endOfInput?: Message;
+  /**
+   * Custom error message when the same polarity is used multiple times.
+   */
+  readonly duplicate?: Message | ((token: string) => Message);
+  /**
+   * Custom error message when both positive and negative flags are used.
+   */
+  readonly conflict?: Message | ((previousToken: string, token: string) => Message);
+  /**
+   * Custom error message when a flag receives an unexpected value.
+   */
+  readonly unexpectedValue?: Message | ((optionName: string, value: string) => Message);
+  /**
+   * Custom error message when no matching flag is found.
+   */
+  readonly noMatch?: Message | ((invalidOption: string, suggestions: readonly string[]) => Message);
+}
+/**
+ * State stored by the {@link negatableFlag} parser.
+ * @since 1.1.0
+ */
+interface NegatableFlagState {
+  readonly value: boolean;
+  readonly token: string;
+}
+/**
+ * Creates a parser for a pair of command-line flags that explicitly enable or
+ * disable a Boolean value.
+ *
+ * The positive names produce `true`; the negative names produce `false`.
+ * Unlike {@link option}, this parser fails when neither side is present,
+ * matching {@link flag} semantics. Wrap it in {@link optional} for a
+ * tri-state override or {@link withDefault} for a concrete fallback.
+ *
+ * @param names The positive and negative option names to parse.
+ * @param options Optional metadata and error customization.
+ * @returns A {@link Parser} that produces `true` for positive names and
+ *          `false` for negative names.
+ * @throws {TypeError} If any option name is invalid, duplicated within one
+ *         side, or shared by the positive and negative sides.
+ * @since 1.1.0
+ */
+declare function negatableFlag(names: NegatableFlagNames, options?: NegatableFlagOptions): Parser<"sync", boolean, NegatableFlagState | undefined>;
 /**
  * Options for the {@link argument} parser.
  */
@@ -483,4 +587,4 @@ interface PassThroughOptions {
  */
 declare function passThrough(options?: PassThroughOptions): Parser<"sync", readonly string[], readonly string[]>;
 //#endregion
-export { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, OptionErrorOptions, OptionOptions, OptionState, PassThroughFormat, PassThroughOptions, argument, command, constant, fail, flag, option, passThrough };
+export { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, NegatableFlagErrorOptions, NegatableFlagNameList, NegatableFlagNames, NegatableFlagOptions, NegatableFlagState, OptionErrorOptions, OptionOptions, OptionState, PassThroughFormat, PassThroughOptions, argument, command, constant, fail, flag, negatableFlag, option, passThrough };

package/dist/primitives.js

@@ -929,6 +929,221 @@ function flag(...args) {
 	});
 	return result;
 }
+function normalizeNegatableFlagNameList(names) {
+	return typeof names === "string" ? [names] : names;
+}
+function validateNoDuplicateOptionNames(names, label) {
+	const seen = /* @__PURE__ */ new Set();
+	for (const name of names) {
+		if (seen.has(name)) throw new TypeError(`${label} has a duplicate name: "${name}".`);
+		seen.add(name);
+	}
+}
+function validateNoNegatableFlagNameCollision(positiveNames, negativeNames) {
+	const positiveSet = new Set(positiveNames);
+	for (const name of negativeNames) if (positiveSet.has(name)) throw new TypeError(`Negatable flag name is both positive and negative: "${name}".`);
+}
+function formatNegatableFlagDuplicateError(options, token) {
+	return options.errors?.duplicate ? typeof options.errors.duplicate === "function" ? options.errors.duplicate(token) : options.errors.duplicate : message`${optionName(token)} cannot be used multiple times.`;
+}
+function formatNegatableFlagConflictError(options, previousToken, token) {
+	return options.errors?.conflict ? typeof options.errors.conflict === "function" ? options.errors.conflict(previousToken, token) : options.errors.conflict : message`${optionName(previousToken)} and ${optionName(token)} cannot be used together.`;
+}
+function formatNegatableFlagUnexpectedValueError(options, optionName$1, value) {
+	return options.errors?.unexpectedValue ? typeof options.errors.unexpectedValue === "function" ? options.errors.unexpectedValue(optionName$1, value) : options.errors.unexpectedValue : message`Flag ${optionName(optionName$1)} does not accept a value, but got: ${value}.`;
+}
+function parseMatchedNegatableFlag(context, token, value, consumed, consumedOnFailure, buffer, options) {
+	if (context.state != null) return {
+		success: false,
+		consumed: consumedOnFailure,
+		error: context.state.value === value ? formatNegatableFlagDuplicateError(options, token) : formatNegatableFlagConflictError(options, context.state.token, token)
+	};
+	return {
+		success: true,
+		next: {
+			...context,
+			state: {
+				value,
+				token
+			},
+			buffer
+		},
+		consumed
+	};
+}
+/**
+* Creates a parser for a pair of command-line flags that explicitly enable or
+* disable a Boolean value.
+*
+* The positive names produce `true`; the negative names produce `false`.
+* Unlike {@link option}, this parser fails when neither side is present,
+* matching {@link flag} semantics. Wrap it in {@link optional} for a
+* tri-state override or {@link withDefault} for a concrete fallback.
+*
+* @param names The positive and negative option names to parse.
+* @param options Optional metadata and error customization.
+* @returns A {@link Parser} that produces `true` for positive names and
+*          `false` for negative names.
+* @throws {TypeError} If any option name is invalid, duplicated within one
+*         side, or shared by the positive and negative sides.
+* @since 1.1.0
+*/
+function negatableFlag(names, options = {}) {
+	const positiveNames = normalizeNegatableFlagNameList(names.positive);
+	const negativeNames = normalizeNegatableFlagNameList(names.negative);
+	validateOptionNames(positiveNames, "Positive flag");
+	validateOptionNames(negativeNames, "Negative flag");
+	validateNoDuplicateOptionNames(positiveNames, "Positive flag");
+	validateNoDuplicateOptionNames(negativeNames, "Negative flag");
+	validateNoNegatableFlagNameCollision(positiveNames, negativeNames);
+	const optionNames$1 = [...positiveNames, ...negativeNames];
+	const valueByName = /* @__PURE__ */ new Map();
+	for (const name of positiveNames) valueByName.set(name, true);
+	for (const name of negativeNames) valueByName.set(name, false);
+	const result = {
+		$valueType: [],
+		$stateType: [],
+		mode: "sync",
+		priority: 10,
+		usage: [{
+			type: "option",
+			names: optionNames$1,
+			...options.hidden != null && { hidden: options.hidden }
+		}],
+		leadingNames: new Set(optionNames$1),
+		acceptingAnyToken: false,
+		initialState: void 0,
+		parse(context) {
+			if (context.optionsTerminated) return {
+				success: false,
+				consumed: 0,
+				error: options.errors?.optionsTerminated ?? message`No more options can be parsed.`
+			};
+			else if (context.buffer.length < 1) return {
+				success: false,
+				consumed: 0,
+				error: options.errors?.endOfInput ?? message`Expected an option, but got end of input.`
+			};
+			if (context.buffer[0] === "--") return {
+				success: true,
+				next: {
+					...context,
+					buffer: context.buffer.slice(1),
+					state: context.state,
+					optionsTerminated: true
+				},
+				consumed: context.buffer.slice(0, 1)
+			};
+			const directValue = valueByName.get(context.buffer[0]);
+			if (directValue != null) return parseMatchedNegatableFlag(context, context.buffer[0], directValue, context.buffer.slice(0, 1), 1, context.buffer.slice(1), options);
+			for (const name of optionNames$1) {
+				if (!name.startsWith("--") && !name.startsWith("/") && !name.startsWith("+") && !(name.startsWith("-") && name.length > 2)) continue;
+				const prefix = name.startsWith("/") ? `${name}:` : `${name}=`;
+				if (context.buffer[0].startsWith(prefix)) {
+					const value = context.buffer[0].slice(prefix.length);
+					return {
+						success: false,
+						consumed: 1,
+						error: formatNegatableFlagUnexpectedValueError(options, prefix.slice(0, -1), value)
+					};
+				}
+			}
+			for (const shortOption of optionNames$1) {
+				if (!shortOption.match(/^-[^-]$/)) continue;
+				if (!context.buffer[0].startsWith(shortOption)) continue;
+				return parseMatchedNegatableFlag(context, shortOption, valueByName.get(shortOption), [context.buffer[0].slice(0, 2)], 1, [`-${context.buffer[0].slice(2)}`, ...context.buffer.slice(1)], options);
+			}
+			const invalidOption = context.buffer[0];
+			if (options.errors?.noMatch) {
+				const candidates = /* @__PURE__ */ new Set();
+				for (const name of extractOptionNames(context.usage)) candidates.add(name);
+				const suggestions = findSimilar(invalidOption, candidates, DEFAULT_FIND_SIMILAR_OPTIONS);
+				return {
+					success: false,
+					consumed: 0,
+					error: typeof options.errors.noMatch === "function" ? options.errors.noMatch(invalidOption, suggestions) : options.errors.noMatch
+				};
+			}
+			const baseError = message`No matched option for ${optionName(invalidOption)}.`;
+			return {
+				success: false,
+				consumed: 0,
+				error: createErrorWithSuggestions(baseError, invalidOption, context.usage, "option")
+			};
+		},
+		complete(state, _exec) {
+			if (state == null) return {
+				success: false,
+				error: options.errors?.missing ? typeof options.errors.missing === "function" ? options.errors.missing(positiveNames, negativeNames) : options.errors.missing : message`Required flag ${optionNames(optionNames$1)} is missing.`
+			};
+			return {
+				success: true,
+				value: state.value
+			};
+		},
+		suggest(_context, prefix) {
+			if (isSuggestionHidden(options.hidden)) return [];
+			const suggestions = [];
+			if (prefix.startsWith("--") || prefix.startsWith("-") || prefix.startsWith("/") || prefix.startsWith("+")) {
+				for (const optionName$1 of optionNames$1) if (optionName$1.startsWith(prefix)) {
+					if (prefix === "-" && optionName$1.length !== 2) continue;
+					suggestions.push({
+						kind: "literal",
+						text: optionName$1
+					});
+				}
+			}
+			return suggestions;
+		},
+		getDocFragments(_state, _defaultValue) {
+			if (isDocHidden(options.hidden)) return {
+				fragments: [],
+				description: options.description
+			};
+			const fragments = [{
+				type: "entry",
+				term: {
+					type: "option",
+					names: optionNames$1
+				},
+				description: options.description
+			}];
+			return {
+				fragments,
+				description: options.description
+			};
+		},
+		[Symbol.for("Deno.customInspect")]() {
+			const args = [`positive: ${JSON.stringify(positiveNames)}`, `negative: ${JSON.stringify(negativeNames)}`];
+			return `negatableFlag({ ${args.join(", ")} })`;
+		}
+	};
+	Object.defineProperty(result, "validateValue", {
+		value(v) {
+			if (typeof v !== "boolean") {
+				const actualType = v === null ? "null" : typeof v;
+				return {
+					success: false,
+					error: message`${optionNames(optionNames$1)}: Expected a boolean value, but received ${actualType}.`
+				};
+			}
+			return {
+				success: true,
+				value: v
+			};
+		},
+		configurable: true,
+		enumerable: false,
+		writable: false
+	});
+	Object.defineProperty(result, "placeholder", {
+		value: false,
+		configurable: true,
+		enumerable: false,
+		writable: false
+	});
+	return result;
+}
 /**
 * Creates a parser that expects a single argument value.
 * This parser is typically used for positional arguments
@@ -1601,4 +1816,4 @@ function passThrough(options = {}) {
 }
 
 //#endregion
-export { argument, command, constant, fail, flag, option, passThrough };
+export { argument, command, constant, fail, flag, negatableFlag, option, passThrough };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.1.0-dev.1998+3e697633",
+  "version": "1.1.0-dev.2006+b336c042",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",