@optique/core 1.1.0-dev.2152 → 1.1.0-dev.2160

package/dist/index.cjs

@@ -74,6 +74,7 @@ exports.isSuggestionHidden = require_usage.isSuggestionHidden;
 exports.isUsageHidden = require_usage.isUsageHidden;
 exports.isValueParser = require_valueparser.isValueParser;
 exports.json = require_valueparser.json;
+exports.keyValue = require_valueparser.keyValue;
 exports.lineBreak = require_message.lineBreak;
 exports.link = require_message.link;
 exports.locale = require_valueparser.locale;

package/dist/index.d.cts

@@ -3,7 +3,7 @@ import { NonEmptyString, ensureNonEmptyString, isNonEmptyString } from "./nonemp
 import { Message, MessageFormatOptions, MessageTerm, ValueSetOptions, commandLine, envVar, formatMessage, lineBreak, link, message, metavar, optionName, optionNames, text, value, valueSet, values } from "./message.cjs";
 import { HiddenVisibility, OptionName, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, cloneUsage, cloneUsageTerm, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, formatUsage, formatUsageTerm, isDocHidden, isSuggestionHidden, isUsageHidden, mergeHidden, normalizeUsage } from "./usage.cjs";
 import { DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, ShowChoicesOptions, ShowDefaultOptions, cloneDocEntry, deduplicateDocEntries, deduplicateDocFragments, formatDocPage, isDocEntryHidden } from "./doc.cjs";
-import { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, Color, ColorFormat, ColorOptions, DeferredMap, DomainOptions, EmailOptions, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FirstOfOptions, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, Json, JsonOptions, LocaleOptions, MacAddressOptions, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, SemVer, SemVerOptionsObject, SemVerOptionsString, SemVerString, SocketAddressOptions, SocketAddressValue, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, fileSize, firstOf, float, hostname, integer, ip, ipv4, ipv6, isValueParser, json, locale, macAddress, port, portRange, semVer, socketAddress, string, url, uuid } from "./valueparser.cjs";
+import { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, Color, ColorFormat, ColorOptions, DeferredMap, DomainOptions, EmailOptions, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FirstOfOptions, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, Json, JsonOptions, KeyValueOptions, LocaleOptions, MacAddressOptions, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, SemVer, SemVerOptionsObject, SemVerOptionsString, SemVerString, SocketAddressOptions, SocketAddressValue, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, fileSize, firstOf, float, hostname, integer, ip, ipv4, ipv6, isValueParser, json, keyValue, locale, macAddress, port, portRange, semVer, socketAddress, string, url, uuid } from "./valueparser.cjs";
 import { CombineModes, DocState, ExecutionContext, ExecutionPhase, InferMode, InferValue, Mode, ModeIterable, ModeValue, ParseFrame, Parser, ParserContext, ParserResult, Result, Suggestion, createParserContext, getDocPage, getDocPageAsync, getDocPageSync, parse, parseAsync, parseSync, suggest, suggestAsync, suggestSync } from "./internal/parser.cjs";
 import { ShellCompletion, bash, fish, nu, pwsh, zsh } from "./completion.cjs";
 import { ConditionalErrorOptions, ConditionalOptions, DuplicateOptionError, GroupOptions, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, NoMatchContext, ObjectErrorOptions, ObjectOptions, OrErrorOptions, OrOptions, SeqOptions, TupleOptions, concat, conditional, group, longestMatch, merge, object, or, seq, tuple } from "./constructs.cjs";
@@ -12,4 +12,4 @@ import { AnyDependencySource, CombineMode, CombinedDependencyMode, DependencyMod
 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, 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, Color, ColorFormat, ColorOptions, 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, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FirstOfOptions, FlagErrorOptions, FlagOptions, FloatOptions, GroupOptions, HiddenVisibility, HostnameOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, Json, JsonOptions, 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, SemVer, SemVerOptionsObject, SemVerOptionsString, SemVerString, SeqOptions, 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, color, command, commandLine, concat, conditional, constant, createParserContext, deduplicateDocEntries, deduplicateDocFragments, dependency, deriveFrom, deriveFromAsync, deriveFromSync, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fileSize, firstOf, 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, json, 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, semVer, seq, socketAddress, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, valueSet, values, withDefault, zsh };
+export { type Annotations, AnyDependencySource, ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, Color, ColorFormat, ColorOptions, 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, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FirstOfOptions, FlagErrorOptions, FlagOptions, FloatOptions, GroupOptions, HiddenVisibility, HostnameOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, Json, JsonOptions, KeyValueOptions, 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, SemVer, SemVerOptionsObject, SemVerOptionsString, SemVerString, SeqOptions, 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, color, command, commandLine, concat, conditional, constant, createParserContext, deduplicateDocEntries, deduplicateDocFragments, dependency, deriveFrom, deriveFromAsync, deriveFromSync, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fileSize, firstOf, 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, json, keyValue, 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, semVer, seq, socketAddress, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, valueSet, values, withDefault, zsh };

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import { NonEmptyString, ensureNonEmptyString, isNonEmptyString } from "./nonemp
 import { Message, MessageFormatOptions, MessageTerm, ValueSetOptions, commandLine, envVar, formatMessage, lineBreak, link, message, metavar, optionName, optionNames, text, value, valueSet, values } from "./message.js";
 import { HiddenVisibility, OptionName, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, cloneUsage, cloneUsageTerm, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, formatUsage, formatUsageTerm, isDocHidden, isSuggestionHidden, isUsageHidden, mergeHidden, normalizeUsage } from "./usage.js";
 import { DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, ShowChoicesOptions, ShowDefaultOptions, cloneDocEntry, deduplicateDocEntries, deduplicateDocFragments, formatDocPage, isDocEntryHidden } from "./doc.js";
-import { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, Color, ColorFormat, ColorOptions, DeferredMap, DomainOptions, EmailOptions, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FirstOfOptions, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, Json, JsonOptions, LocaleOptions, MacAddressOptions, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, SemVer, SemVerOptionsObject, SemVerOptionsString, SemVerString, SocketAddressOptions, SocketAddressValue, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, fileSize, firstOf, float, hostname, integer, ip, ipv4, ipv6, isValueParser, json, locale, macAddress, port, portRange, semVer, socketAddress, string, url, uuid } from "./valueparser.js";
+import { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, Color, ColorFormat, ColorOptions, DeferredMap, DomainOptions, EmailOptions, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FirstOfOptions, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, Json, JsonOptions, KeyValueOptions, LocaleOptions, MacAddressOptions, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, SemVer, SemVerOptionsObject, SemVerOptionsString, SemVerString, SocketAddressOptions, SocketAddressValue, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, fileSize, firstOf, float, hostname, integer, ip, ipv4, ipv6, isValueParser, json, keyValue, locale, macAddress, port, portRange, semVer, socketAddress, string, url, uuid } from "./valueparser.js";
 import { CombineModes, DocState, ExecutionContext, ExecutionPhase, InferMode, InferValue, Mode, ModeIterable, ModeValue, ParseFrame, Parser, ParserContext, ParserResult, Result, Suggestion, createParserContext, getDocPage, getDocPageAsync, getDocPageSync, parse, parseAsync, parseSync, suggest, suggestAsync, suggestSync } from "./internal/parser.js";
 import { ShellCompletion, bash, fish, nu, pwsh, zsh } from "./completion.js";
 import { ConditionalErrorOptions, ConditionalOptions, DuplicateOptionError, GroupOptions, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, NoMatchContext, ObjectErrorOptions, ObjectOptions, OrErrorOptions, OrOptions, SeqOptions, TupleOptions, concat, conditional, group, longestMatch, merge, object, or, seq, tuple } from "./constructs.js";
@@ -12,4 +12,4 @@ import { AnyDependencySource, CombineMode, CombinedDependencyMode, DependencyMod
 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, 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, Color, ColorFormat, ColorOptions, 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, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FirstOfOptions, FlagErrorOptions, FlagOptions, FloatOptions, GroupOptions, HiddenVisibility, HostnameOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, Json, JsonOptions, 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, SemVer, SemVerOptionsObject, SemVerOptionsString, SemVerString, SeqOptions, 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, color, command, commandLine, concat, conditional, constant, createParserContext, deduplicateDocEntries, deduplicateDocFragments, dependency, deriveFrom, deriveFromAsync, deriveFromSync, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fileSize, firstOf, 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, json, 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, semVer, seq, socketAddress, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, valueSet, values, withDefault, zsh };
+export { type Annotations, AnyDependencySource, ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, Color, ColorFormat, ColorOptions, 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, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FirstOfOptions, FlagErrorOptions, FlagOptions, FloatOptions, GroupOptions, HiddenVisibility, HostnameOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, Json, JsonOptions, KeyValueOptions, 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, SemVer, SemVerOptionsObject, SemVerOptionsString, SemVerString, SeqOptions, 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, color, command, commandLine, concat, conditional, constant, createParserContext, deduplicateDocEntries, deduplicateDocFragments, dependency, deriveFrom, deriveFromAsync, deriveFromSync, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fileSize, firstOf, 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, json, keyValue, 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, semVer, seq, socketAddress, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, valueSet, values, withDefault, zsh };

package/dist/index.js

@@ -8,8 +8,8 @@ import { bash, fish, nu, pwsh, zsh } from "./completion.js";
 import { DuplicateOptionError, concat, conditional, group, longestMatch, merge, object, or, seq, tuple } from "./constructs.js";
 import { WithDefaultError, map, multiple, nonEmpty, optional, withDefault } from "./modifiers.js";
 import { ensureNonEmptyString, isNonEmptyString } from "./nonempty.js";
-import { checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, fileSize, firstOf, float, hostname, integer, ip, ipv4, ipv6, isValueParser, json, locale, macAddress, port, portRange, semVer, socketAddress, string, url, uuid } from "./valueparser.js";
+import { checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, fileSize, firstOf, float, hostname, integer, ip, ipv4, ipv6, isValueParser, json, keyValue, locale, macAddress, port, portRange, semVer, socketAddress, string, url, uuid } from "./valueparser.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, color, command, commandLine, concat, conditional, constant, createParserContext, deduplicateDocEntries, deduplicateDocFragments, dependency, deriveFrom, deriveFromAsync, deriveFromSync, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fileSize, firstOf, 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, json, 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, semVer, seq, 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, color, command, commandLine, concat, conditional, constant, createParserContext, deduplicateDocEntries, deduplicateDocFragments, dependency, deriveFrom, deriveFromAsync, deriveFromSync, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fileSize, firstOf, 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, json, keyValue, 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, semVer, seq, socketAddress, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, valueSet, values, withDefault, zsh };

package/dist/valueparser.cjs

@@ -327,6 +327,323 @@ function string(options = {}) {
 		}
 	};
 }
+function keyValue(options = {}) {
+	const separator = options.separator ?? "=";
+	if (typeof separator !== "string") throw new TypeError(`Expected separator to be a string, but got ${typeof separator}: ${String(separator)}.`);
+	require_nonempty.ensureNonEmptyString(separator);
+	checkBooleanOption(options, "allowEmptyKey");
+	checkBooleanOption(options, "allowEmptyValue");
+	checkEnumOption(options, "split", ["first", "last"]);
+	const split = options.split ?? "first";
+	const allowEmptyKey = options.allowEmptyKey ?? false;
+	const allowEmptyValue = options.allowEmptyValue ?? true;
+	const metavar$1 = options.metavar ?? `KEY${separator}VALUE`;
+	require_nonempty.ensureNonEmptyString(metavar$1);
+	const rawKeyParser = options.key ?? string({ placeholder: "KEY" });
+	const rawValueParser = options.value ?? string({ placeholder: allowEmptyValue ? "" : "VALUE" });
+	checkKeyValueChildParser("key", rawKeyParser);
+	checkKeyValueChildParser("value", rawValueParser);
+	const keyParser = rawKeyParser;
+	const valueParser = rawValueParser;
+	const hasNormalize = typeof keyParser.normalize === "function" || typeof valueParser.normalize === "function";
+	const hasSuggest = typeof keyParser.suggest === "function" || typeof valueParser.suggest === "function";
+	function findSeparator(input) {
+		return split === "last" ? input.lastIndexOf(separator) : input.indexOf(separator);
+	}
+	function emptyKeyError(input) {
+		const custom = options.errors?.emptyKey;
+		if (custom != null) return typeof custom === "function" ? custom(input) : custom;
+		return require_message.message`Expected a non-empty key in ${input}.`;
+	}
+	function emptyValueError(input) {
+		const custom = options.errors?.emptyValue;
+		if (custom != null) return typeof custom === "function" ? custom(input) : custom;
+		return require_message.message`Expected a non-empty value in ${input}.`;
+	}
+	function missingSeparatorError(input) {
+		const custom = options.errors?.missingSeparator;
+		if (custom != null) return typeof custom === "function" ? custom(input, separator) : custom;
+		return require_message.message`Expected ${separator} in ${input}.`;
+	}
+	function invalidKeyError(error) {
+		const custom = options.errors?.invalidKey;
+		if (custom != null) return typeof custom === "function" ? custom(error) : custom;
+		return [require_message.text("Invalid key: "), ...require_message.cloneMessage(error)];
+	}
+	function invalidValueError(error) {
+		const custom = options.errors?.invalidValue;
+		if (custom != null) return typeof custom === "function" ? custom(error) : custom;
+		return [require_message.text("Invalid value: "), ...require_message.cloneMessage(error)];
+	}
+	function validateParts(input, key, value) {
+		if (!allowEmptyKey && key === "") return {
+			success: false,
+			error: emptyKeyError(input)
+		};
+		if (!allowEmptyValue && value === "") return {
+			success: false,
+			error: emptyValueError(input)
+		};
+		const keyResult = keyParser.parse(key);
+		if (!keyResult.success) return {
+			success: false,
+			error: invalidKeyError(keyResult.error)
+		};
+		const valueResult = valueParser.parse(value);
+		if (!valueResult.success) return {
+			success: false,
+			error: invalidValueError(valueResult.error)
+		};
+		return validateResultParts(input, keyResult, valueResult);
+	}
+	function validateKeyForSuggestion(key) {
+		if (!allowEmptyKey && key === "") return false;
+		if (!partsRoundTrip(key, "")) return false;
+		const keyResult = keyParser.parse(key);
+		if (!keyResult.success) return false;
+		if (!allowEmptyKey && keyResult.value === "") return false;
+		const formattedKeyResult = formatValueParserValue(keyParser, keyResult.value);
+		if (!formattedKeyResult.success) return false;
+		const formattedKey = formattedKeyResult.value;
+		return formattedKey == null || partsRoundTrip(formattedKey, "");
+	}
+	function validateKeyPatternForSuggestion(key) {
+		if (!allowEmptyKey && key === "") return false;
+		return partsRoundTrip(key, "");
+	}
+	function fallbackInput(key, value) {
+		return `${typeof key === "string" ? key : ""}${separator}${typeof value === "string" ? value : ""}`;
+	}
+	function partsRoundTrip(key, value) {
+		const input = `${key}${separator}${value}`;
+		const index = findSeparator(input);
+		if (index < 0) return false;
+		return input.slice(0, index) === key && input.slice(index + separator.length) === value;
+	}
+	function validateResultParts(input, keyResult, valueResult) {
+		if (!allowEmptyKey && keyResult.value === "") return {
+			success: false,
+			error: emptyKeyError(input)
+		};
+		if (!allowEmptyValue && valueResult.value === "") return {
+			success: false,
+			error: emptyValueError(input)
+		};
+		const formattedKeyResult = formatValueParserValue(keyParser, keyResult.value);
+		if (!formattedKeyResult.success) return {
+			success: false,
+			error: invalidKeyError(formattedKeyResult.error)
+		};
+		const formattedValueResult = formatValueParserValue(valueParser, valueResult.value);
+		if (!formattedValueResult.success) return {
+			success: false,
+			error: invalidValueError(formattedValueResult.error)
+		};
+		const formattedKey = formattedKeyResult.value;
+		const formattedValue = formattedValueResult.value;
+		if (!allowEmptyKey && formattedKey === "") return {
+			success: false,
+			error: emptyKeyError(input)
+		};
+		if (!allowEmptyValue && formattedValue === "") return {
+			success: false,
+			error: emptyValueError(input)
+		};
+		if (split === "first" && formattedKey != null && formattedKey.includes(separator)) return {
+			success: false,
+			error: invalidKeyError(require_message.message`Expected a key without ${separator}, but got ${formattedKey}.`)
+		};
+		if (split === "last" && formattedValue != null && formattedValue.includes(separator)) return {
+			success: false,
+			error: invalidValueError(require_message.message`Expected a value without ${separator}, but got ${formattedValue}.`)
+		};
+		if (formattedKey != null && formattedValue != null) {
+			if (!partsRoundTrip(formattedKey, formattedValue)) return split === "first" ? {
+				success: false,
+				error: invalidKeyError(require_message.message`Expected a key that round-trips with ${separator}, but got ${formattedKey}.`)
+			} : {
+				success: false,
+				error: invalidValueError(require_message.message`Expected a value that round-trips with ${separator}, but got ${formattedValue}.`)
+			};
+		}
+		return makeKeyValueSuccess(keyResult, valueResult);
+	}
+	function validateTuple(value) {
+		if (!allowEmptyKey && value[0] === "") return {
+			success: false,
+			error: emptyKeyError(fallbackInput(value[0], value[1]))
+		};
+		if (!allowEmptyValue && value[1] === "") return {
+			success: false,
+			error: emptyValueError(fallbackInput(value[0], value[1]))
+		};
+		const keyResult = validateValueParserValue(keyParser, value[0]);
+		if (!keyResult.success) return {
+			success: false,
+			error: invalidKeyError(keyResult.error)
+		};
+		const valueResult = validateValueParserValue(valueParser, value[1]);
+		if (!valueResult.success) return {
+			success: false,
+			error: invalidValueError(valueResult.error)
+		};
+		return validateResultParts(fallbackInput(value[0], value[1]), keyResult, valueResult);
+	}
+	return {
+		mode: "sync",
+		metavar: metavar$1,
+		placeholder: [keyParser.placeholder, valueParser.placeholder],
+		parse(input) {
+			const index = findSeparator(input);
+			if (index < 0) return {
+				success: false,
+				error: missingSeparatorError(input)
+			};
+			const key = input.slice(0, index);
+			const value = input.slice(index + separator.length);
+			return validateParts(input, key, value);
+		},
+		format(value) {
+			return `${keyParser.format(value[0])}${separator}${valueParser.format(value[1])}`;
+		},
+		validate(value) {
+			if (!isKeyValueTuple(value)) return {
+				success: false,
+				error: require_message.message`Expected a key-value tuple.`
+			};
+			return validateTuple(value);
+		},
+		...hasNormalize ? { normalize(value) {
+			if (!isKeyValueTuple(value)) return value;
+			const normalized = [typeof keyParser.normalize === "function" ? keyParser.normalize(value[0]) : value[0], typeof valueParser.normalize === "function" ? valueParser.normalize(value[1]) : value[1]];
+			return validateTuple(normalized).success ? normalized : value;
+		} } : {},
+		...hasSuggest ? { *suggest(prefix) {
+			const index = findSeparator(prefix);
+			const suggestions = [];
+			if (index < 0 || split === "last") {
+				if (typeof keyParser.suggest === "function") for (const suggestion of keyParser.suggest(prefix)) {
+					const key = suggestionTextValue(suggestion);
+					if (suggestion.kind === "literal" ? !validateKeyForSuggestion(key) : !validateKeyPatternForSuggestion(key)) continue;
+					suggestions.push(prefixKeyValueSuggestion(suggestion, "", separator));
+				}
+			}
+			if (index < 0) {
+				yield* require_suggestion.deduplicateSuggestions(suggestions);
+				return;
+			}
+			if (typeof valueParser.suggest === "function") {
+				const key = prefix.slice(0, index);
+				if (!validateKeyForSuggestion(key)) {
+					yield* require_suggestion.deduplicateSuggestions(suggestions);
+					return;
+				}
+				const valuePrefix = prefix.slice(index + separator.length);
+				for (const suggestion of valueParser.suggest(valuePrefix)) {
+					const value = suggestionTextValue(suggestion);
+					if (!partsRoundTrip(key, value)) continue;
+					if (suggestion.kind === "literal" && !validateParts(`${key}${separator}${value}`, key, value).success) continue;
+					suggestions.push(prefixKeyValueSuggestion(suggestion, `${key}${separator}`));
+				}
+			}
+			yield* require_suggestion.deduplicateSuggestions(suggestions);
+		} } : {}
+	};
+}
+function checkKeyValueChildParser(role, parser) {
+	if (!isValueParser(parser)) throw new TypeError(`The ${role} option for keyValue() must be a value parser.`);
+	if (parser.mode !== "sync") throw new TypeError(`keyValue() only supports sync ${role} parsers, but an async one was given.`);
+	if (require_internal_dependency.isDerivedValueParser(parser)) throw new TypeError(`keyValue() does not support dependency-derived ${role} parsers (created via deriveFrom() or dependency().derive()); pass the derived parser directly to option() or argument() instead.`);
+}
+function validateValueParserValue(parser, value) {
+	if (typeof parser.validate === "function") return parser.validate(value);
+	let formatted;
+	try {
+		formatted = parser.format(value);
+	} catch {
+		return {
+			success: true,
+			value
+		};
+	}
+	if (typeof formatted !== "string") return {
+		success: false,
+		error: stringFormatError()
+	};
+	return parser.parse(formatted);
+}
+function formatValueParserValue(parser, value) {
+	let formatted;
+	try {
+		formatted = parser.format(value);
+	} catch {
+		return {
+			success: true,
+			value: void 0
+		};
+	}
+	if (typeof formatted !== "string") return {
+		success: false,
+		error: stringFormatError()
+	};
+	return {
+		success: true,
+		value: formatted
+	};
+}
+function stringFormatError() {
+	return require_message.message`Expected a value formatted as a string.`;
+}
+function suggestionTextValue(suggestion) {
+	return suggestion.kind === "literal" ? suggestion.text : suggestion.pattern ?? "";
+}
+function prefixKeyValueSuggestion(suggestion, prefix, suffix = "") {
+	const textValue = suggestionTextValue(suggestion);
+	const text$1 = `${prefix}${textValue}${suffix}`;
+	if (suggestion.kind === "file" && suffix === "") return {
+		...suggestion,
+		pattern: text$1
+	};
+	return suggestion.description == null ? {
+		kind: "literal",
+		text: text$1
+	} : {
+		kind: "literal",
+		text: text$1,
+		description: suggestion.description
+	};
+}
+function isKeyValueTuple(value) {
+	return Array.isArray(value) && value.length === 2 && 0 in value && 1 in value;
+}
+function makeKeyValueSuccess(keyResult, valueResult) {
+	const deferredKeys = /* @__PURE__ */ new Map();
+	let hasDeferred = false;
+	collectKeyValueDeferredKeys(deferredKeys, 0, keyResult, () => {
+		hasDeferred = true;
+	});
+	collectKeyValueDeferredKeys(deferredKeys, 1, valueResult, () => {
+		hasDeferred = true;
+	});
+	return {
+		success: true,
+		value: [keyResult.value, valueResult.value],
+		...hasDeferred ? {
+			deferred: true,
+			...deferredKeys.size > 0 ? { deferredKeys } : {}
+		} : {}
+	};
+}
+function collectKeyValueDeferredKeys(deferredKeys, index, result, markDeferred) {
+	if (result.deferredKeys != null) {
+		markDeferred();
+		deferredKeys.set(index, result.deferredKeys);
+		return;
+	}
+	if (result.deferred !== true) return;
+	markDeferred();
+	deferredKeys.set(index, null);
+}
 /**
 * Creates a ValueParser for parsing integer values from strings.
 *
@@ -5799,6 +6116,7 @@ exports.ipv6 = ipv6;
 exports.isNonEmptyString = require_nonempty.isNonEmptyString;
 exports.isValueParser = isValueParser;
 exports.json = json;
+exports.keyValue = keyValue;
 exports.locale = locale;
 exports.macAddress = macAddress;
 exports.port = port;

package/dist/valueparser.d.cts

@@ -385,6 +385,130 @@ declare function checkEnumOption<T extends object>(options: T | undefined, key:
  *         `RegExp` instance.
  */
 declare function string(options?: StringOptions): ValueParser<"sync", string>;
+interface KeyValueOptionsBase {
+  /**
+   * The metavariable name for this parser.  Used in help messages to
+   * indicate the expected key–value shape.
+   * @default `"KEY=VALUE"` with the configured separator.
+   */
+  readonly metavar?: NonEmptyString;
+  /**
+   * The separator between key and value.
+   * @default `"="`
+   */
+  readonly separator?: string;
+  /**
+   * If `true`, accepts an empty key before the separator.
+   * @default `false`
+   */
+  readonly allowEmptyKey?: boolean;
+  /**
+   * If `true`, accepts an empty value after the separator.
+   * @default `true`
+   */
+  readonly allowEmptyValue?: boolean;
+  /**
+   * Chooses which separator occurrence is used when input contains the
+   * separator more than once.
+   * @default `"first"`
+   */
+  readonly split?: "first" | "last";
+  /**
+   * Custom error messages for key–value parsing failures.
+   * @since 1.1.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error when the input does not contain the separator.
+     */
+    readonly missingSeparator?: Message | ((input: string, separator: string) => Message);
+    /**
+     * Custom error when the key side is empty and empty keys are disabled.
+     */
+    readonly emptyKey?: Message | ((input: string) => Message);
+    /**
+     * Custom error when the value side is empty and empty values are disabled.
+     */
+    readonly emptyValue?: Message | ((input: string) => Message);
+    /**
+     * Custom error wrapper for key parser failures.
+     */
+    readonly invalidKey?: Message | ((error: Message) => Message);
+    /**
+     * Custom error wrapper for value parser failures.
+     */
+    readonly invalidValue?: Message | ((error: Message) => Message);
+  };
+}
+type IsDefaultString<T> = [T] extends [string] ? [string] extends [T] ? true : false : false;
+type KeyValueKeyOption<K> = IsDefaultString<K> extends true ? {
+  /**
+   * Parser used to validate and transform the key side.
+   * @default `string({ placeholder: "KEY" })`
+   */
+  readonly key?: ValueParser<"sync", K>;
+} : {
+  /**
+   * Parser used to validate and transform the key side.
+   * @default `string({ placeholder: "KEY" })`
+   */
+  readonly key: ValueParser<"sync", K>;
+};
+type KeyValueValueOption<V> = IsDefaultString<V> extends true ? {
+  /**
+   * Parser used to validate and transform the value side.
+   * @default `string()`
+   */
+  readonly value?: ValueParser<"sync", V>;
+} : {
+  /**
+   * Parser used to validate and transform the value side.
+   * @default `string()`
+   */
+  readonly value: ValueParser<"sync", V>;
+};
+/**
+ * Options for creating a {@link keyValue} parser.
+ *
+ * The default key and value parsers produce strings.  If {@link K} or
+ * {@link V} is anything other than the default `string` type, the
+ * corresponding child parser is required so the option object cannot promise
+ * a type that the default parser would not produce.
+ *
+ * @template K The parsed key type.
+ * @template V The parsed value type.
+ * @since 1.1.0
+ */
+type KeyValueOptions<K = string, V = string> = KeyValueOptionsBase & KeyValueKeyOption<K> & KeyValueValueOption<V>;
+type KeyValueOptionsInput = KeyValueOptionsBase & {
+  readonly key?: ValueParser<"sync", unknown>;
+  readonly value?: ValueParser<"sync", unknown>;
+};
+type KeyValueKeyType<Options> = Options extends {
+  readonly key: ValueParser<"sync", infer K>;
+} ? K : string;
+type KeyValueValueType<Options> = Options extends {
+  readonly value: ValueParser<"sync", infer V>;
+} ? V : string;
+type KeyValueResultType<Options> = Options extends KeyValueOptionsInput ? readonly [KeyValueKeyType<Options>, KeyValueValueType<Options>] : readonly [string, string];
+/**
+ * Creates a value parser for strings shaped like `KEY=VALUE`.
+ *
+ * The default parser splits on the first `=`, rejects empty keys, allows
+ * empty values, and returns a readonly `[key, value]` tuple.  Custom key and
+ * value parsers can narrow or transform either side while preserving the
+ * inferred tuple type.
+ *
+ * @template Options The option object type used to infer child parser results.
+ * @param options Configuration options for the key–value parser.
+ * @returns A sync value parser producing readonly key–value tuples.
+ * @throws {TypeError} If `separator` or `metavar` is empty, if
+ *   `allowEmptyKey` or `allowEmptyValue` is not a boolean, if `split` is not
+ *   `"first"` or `"last"`, or if `key` or `value` is not a sync value parser.
+ * @since 1.1.0
+ */
+declare function keyValue(): ValueParser<"sync", readonly [string, string]>;
+declare function keyValue<const Options extends KeyValueOptionsInput | undefined>(options: Options): ValueParser<"sync", KeyValueResultType<Options>>;
 /**
  * Options for creating an integer parser that returns a JavaScript `number`.
  *
@@ -2934,4 +3058,4 @@ declare function firstOf<const TParsers extends readonly [ValueParser<"sync", un
  */
 declare function firstOf<const TParsers extends readonly ValueParser<"sync", unknown>[]>(parsers: TParsers, options?: FirstOfOptions): ValueParser<"sync", ValueParserValue<TParsers[number]>>;
 //#endregion
-export { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, Color, ColorFormat, ColorOptions, DeferredMap, DomainOptions, EmailOptions, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FirstOfOptions, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, Json, JsonOptions, LocaleOptions, MacAddressOptions, type Mode, type ModeIterable, type ModeValue, type NonEmptyString, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, SemVer, SemVerOptionsObject, SemVerOptionsString, SemVerString, SocketAddressOptions, SocketAddressValue, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, ensureNonEmptyString, fileSize, firstOf, float, hostname, integer, ip, ipv4, ipv6, isNonEmptyString, isValueParser, json, locale, macAddress, port, portRange, semVer, socketAddress, string, url, uuid };
+export { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, Color, ColorFormat, ColorOptions, DeferredMap, DomainOptions, EmailOptions, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FirstOfOptions, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, Json, JsonOptions, KeyValueOptions, LocaleOptions, MacAddressOptions, type Mode, type ModeIterable, type ModeValue, type NonEmptyString, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, SemVer, SemVerOptionsObject, SemVerOptionsString, SemVerString, SocketAddressOptions, SocketAddressValue, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, ensureNonEmptyString, fileSize, firstOf, float, hostname, integer, ip, ipv4, ipv6, isNonEmptyString, isValueParser, json, keyValue, locale, macAddress, port, portRange, semVer, socketAddress, string, url, uuid };

package/dist/valueparser.d.ts

@@ -385,6 +385,130 @@ declare function checkEnumOption<T extends object>(options: T | undefined, key:
  *         `RegExp` instance.
  */
 declare function string(options?: StringOptions): ValueParser<"sync", string>;
+interface KeyValueOptionsBase {
+  /**
+   * The metavariable name for this parser.  Used in help messages to
+   * indicate the expected key–value shape.
+   * @default `"KEY=VALUE"` with the configured separator.
+   */
+  readonly metavar?: NonEmptyString;
+  /**
+   * The separator between key and value.
+   * @default `"="`
+   */
+  readonly separator?: string;
+  /**
+   * If `true`, accepts an empty key before the separator.
+   * @default `false`
+   */
+  readonly allowEmptyKey?: boolean;
+  /**
+   * If `true`, accepts an empty value after the separator.
+   * @default `true`
+   */
+  readonly allowEmptyValue?: boolean;
+  /**
+   * Chooses which separator occurrence is used when input contains the
+   * separator more than once.
+   * @default `"first"`
+   */
+  readonly split?: "first" | "last";
+  /**
+   * Custom error messages for key–value parsing failures.
+   * @since 1.1.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error when the input does not contain the separator.
+     */
+    readonly missingSeparator?: Message | ((input: string, separator: string) => Message);
+    /**
+     * Custom error when the key side is empty and empty keys are disabled.
+     */
+    readonly emptyKey?: Message | ((input: string) => Message);
+    /**
+     * Custom error when the value side is empty and empty values are disabled.
+     */
+    readonly emptyValue?: Message | ((input: string) => Message);
+    /**
+     * Custom error wrapper for key parser failures.
+     */
+    readonly invalidKey?: Message | ((error: Message) => Message);
+    /**
+     * Custom error wrapper for value parser failures.
+     */
+    readonly invalidValue?: Message | ((error: Message) => Message);
+  };
+}
+type IsDefaultString<T> = [T] extends [string] ? [string] extends [T] ? true : false : false;
+type KeyValueKeyOption<K> = IsDefaultString<K> extends true ? {
+  /**
+   * Parser used to validate and transform the key side.
+   * @default `string({ placeholder: "KEY" })`
+   */
+  readonly key?: ValueParser<"sync", K>;
+} : {
+  /**
+   * Parser used to validate and transform the key side.
+   * @default `string({ placeholder: "KEY" })`
+   */
+  readonly key: ValueParser<"sync", K>;
+};
+type KeyValueValueOption<V> = IsDefaultString<V> extends true ? {
+  /**
+   * Parser used to validate and transform the value side.
+   * @default `string()`
+   */
+  readonly value?: ValueParser<"sync", V>;
+} : {
+  /**
+   * Parser used to validate and transform the value side.
+   * @default `string()`
+   */
+  readonly value: ValueParser<"sync", V>;
+};
+/**
+ * Options for creating a {@link keyValue} parser.
+ *
+ * The default key and value parsers produce strings.  If {@link K} or
+ * {@link V} is anything other than the default `string` type, the
+ * corresponding child parser is required so the option object cannot promise
+ * a type that the default parser would not produce.
+ *
+ * @template K The parsed key type.
+ * @template V The parsed value type.
+ * @since 1.1.0
+ */
+type KeyValueOptions<K = string, V = string> = KeyValueOptionsBase & KeyValueKeyOption<K> & KeyValueValueOption<V>;
+type KeyValueOptionsInput = KeyValueOptionsBase & {
+  readonly key?: ValueParser<"sync", unknown>;
+  readonly value?: ValueParser<"sync", unknown>;
+};
+type KeyValueKeyType<Options> = Options extends {
+  readonly key: ValueParser<"sync", infer K>;
+} ? K : string;
+type KeyValueValueType<Options> = Options extends {
+  readonly value: ValueParser<"sync", infer V>;
+} ? V : string;
+type KeyValueResultType<Options> = Options extends KeyValueOptionsInput ? readonly [KeyValueKeyType<Options>, KeyValueValueType<Options>] : readonly [string, string];
+/**
+ * Creates a value parser for strings shaped like `KEY=VALUE`.
+ *
+ * The default parser splits on the first `=`, rejects empty keys, allows
+ * empty values, and returns a readonly `[key, value]` tuple.  Custom key and
+ * value parsers can narrow or transform either side while preserving the
+ * inferred tuple type.
+ *
+ * @template Options The option object type used to infer child parser results.
+ * @param options Configuration options for the key–value parser.
+ * @returns A sync value parser producing readonly key–value tuples.
+ * @throws {TypeError} If `separator` or `metavar` is empty, if
+ *   `allowEmptyKey` or `allowEmptyValue` is not a boolean, if `split` is not
+ *   `"first"` or `"last"`, or if `key` or `value` is not a sync value parser.
+ * @since 1.1.0
+ */
+declare function keyValue(): ValueParser<"sync", readonly [string, string]>;
+declare function keyValue<const Options extends KeyValueOptionsInput | undefined>(options: Options): ValueParser<"sync", KeyValueResultType<Options>>;
 /**
  * Options for creating an integer parser that returns a JavaScript `number`.
  *
@@ -2934,4 +3058,4 @@ declare function firstOf<const TParsers extends readonly [ValueParser<"sync", un
  */
 declare function firstOf<const TParsers extends readonly ValueParser<"sync", unknown>[]>(parsers: TParsers, options?: FirstOfOptions): ValueParser<"sync", ValueParserValue<TParsers[number]>>;
 //#endregion
-export { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, Color, ColorFormat, ColorOptions, DeferredMap, DomainOptions, EmailOptions, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FirstOfOptions, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, Json, JsonOptions, LocaleOptions, MacAddressOptions, type Mode, type ModeIterable, type ModeValue, type NonEmptyString, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, SemVer, SemVerOptionsObject, SemVerOptionsString, SemVerString, SocketAddressOptions, SocketAddressValue, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, ensureNonEmptyString, fileSize, firstOf, float, hostname, integer, ip, ipv4, ipv6, isNonEmptyString, isValueParser, json, locale, macAddress, port, portRange, semVer, socketAddress, string, url, uuid };
+export { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, Color, ColorFormat, ColorOptions, DeferredMap, DomainOptions, EmailOptions, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FirstOfOptions, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, Json, JsonOptions, KeyValueOptions, LocaleOptions, MacAddressOptions, type Mode, type ModeIterable, type ModeValue, type NonEmptyString, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, SemVer, SemVerOptionsObject, SemVerOptionsString, SemVerString, SocketAddressOptions, SocketAddressValue, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, ensureNonEmptyString, fileSize, firstOf, float, hostname, integer, ip, ipv4, ipv6, isNonEmptyString, isValueParser, json, keyValue, locale, macAddress, port, portRange, semVer, socketAddress, string, url, uuid };

package/dist/valueparser.js

@@ -327,6 +327,323 @@ function string(options = {}) {
 		}
 	};
 }
+function keyValue(options = {}) {
+	const separator = options.separator ?? "=";
+	if (typeof separator !== "string") throw new TypeError(`Expected separator to be a string, but got ${typeof separator}: ${String(separator)}.`);
+	ensureNonEmptyString(separator);
+	checkBooleanOption(options, "allowEmptyKey");
+	checkBooleanOption(options, "allowEmptyValue");
+	checkEnumOption(options, "split", ["first", "last"]);
+	const split = options.split ?? "first";
+	const allowEmptyKey = options.allowEmptyKey ?? false;
+	const allowEmptyValue = options.allowEmptyValue ?? true;
+	const metavar$1 = options.metavar ?? `KEY${separator}VALUE`;
+	ensureNonEmptyString(metavar$1);
+	const rawKeyParser = options.key ?? string({ placeholder: "KEY" });
+	const rawValueParser = options.value ?? string({ placeholder: allowEmptyValue ? "" : "VALUE" });
+	checkKeyValueChildParser("key", rawKeyParser);
+	checkKeyValueChildParser("value", rawValueParser);
+	const keyParser = rawKeyParser;
+	const valueParser = rawValueParser;
+	const hasNormalize = typeof keyParser.normalize === "function" || typeof valueParser.normalize === "function";
+	const hasSuggest = typeof keyParser.suggest === "function" || typeof valueParser.suggest === "function";
+	function findSeparator(input) {
+		return split === "last" ? input.lastIndexOf(separator) : input.indexOf(separator);
+	}
+	function emptyKeyError(input) {
+		const custom = options.errors?.emptyKey;
+		if (custom != null) return typeof custom === "function" ? custom(input) : custom;
+		return message`Expected a non-empty key in ${input}.`;
+	}
+	function emptyValueError(input) {
+		const custom = options.errors?.emptyValue;
+		if (custom != null) return typeof custom === "function" ? custom(input) : custom;
+		return message`Expected a non-empty value in ${input}.`;
+	}
+	function missingSeparatorError(input) {
+		const custom = options.errors?.missingSeparator;
+		if (custom != null) return typeof custom === "function" ? custom(input, separator) : custom;
+		return message`Expected ${separator} in ${input}.`;
+	}
+	function invalidKeyError(error) {
+		const custom = options.errors?.invalidKey;
+		if (custom != null) return typeof custom === "function" ? custom(error) : custom;
+		return [text("Invalid key: "), ...cloneMessage(error)];
+	}
+	function invalidValueError(error) {
+		const custom = options.errors?.invalidValue;
+		if (custom != null) return typeof custom === "function" ? custom(error) : custom;
+		return [text("Invalid value: "), ...cloneMessage(error)];
+	}
+	function validateParts(input, key, value) {
+		if (!allowEmptyKey && key === "") return {
+			success: false,
+			error: emptyKeyError(input)
+		};
+		if (!allowEmptyValue && value === "") return {
+			success: false,
+			error: emptyValueError(input)
+		};
+		const keyResult = keyParser.parse(key);
+		if (!keyResult.success) return {
+			success: false,
+			error: invalidKeyError(keyResult.error)
+		};
+		const valueResult = valueParser.parse(value);
+		if (!valueResult.success) return {
+			success: false,
+			error: invalidValueError(valueResult.error)
+		};
+		return validateResultParts(input, keyResult, valueResult);
+	}
+	function validateKeyForSuggestion(key) {
+		if (!allowEmptyKey && key === "") return false;
+		if (!partsRoundTrip(key, "")) return false;
+		const keyResult = keyParser.parse(key);
+		if (!keyResult.success) return false;
+		if (!allowEmptyKey && keyResult.value === "") return false;
+		const formattedKeyResult = formatValueParserValue(keyParser, keyResult.value);
+		if (!formattedKeyResult.success) return false;
+		const formattedKey = formattedKeyResult.value;
+		return formattedKey == null || partsRoundTrip(formattedKey, "");
+	}
+	function validateKeyPatternForSuggestion(key) {
+		if (!allowEmptyKey && key === "") return false;
+		return partsRoundTrip(key, "");
+	}
+	function fallbackInput(key, value) {
+		return `${typeof key === "string" ? key : ""}${separator}${typeof value === "string" ? value : ""}`;
+	}
+	function partsRoundTrip(key, value) {
+		const input = `${key}${separator}${value}`;
+		const index = findSeparator(input);
+		if (index < 0) return false;
+		return input.slice(0, index) === key && input.slice(index + separator.length) === value;
+	}
+	function validateResultParts(input, keyResult, valueResult) {
+		if (!allowEmptyKey && keyResult.value === "") return {
+			success: false,
+			error: emptyKeyError(input)
+		};
+		if (!allowEmptyValue && valueResult.value === "") return {
+			success: false,
+			error: emptyValueError(input)
+		};
+		const formattedKeyResult = formatValueParserValue(keyParser, keyResult.value);
+		if (!formattedKeyResult.success) return {
+			success: false,
+			error: invalidKeyError(formattedKeyResult.error)
+		};
+		const formattedValueResult = formatValueParserValue(valueParser, valueResult.value);
+		if (!formattedValueResult.success) return {
+			success: false,
+			error: invalidValueError(formattedValueResult.error)
+		};
+		const formattedKey = formattedKeyResult.value;
+		const formattedValue = formattedValueResult.value;
+		if (!allowEmptyKey && formattedKey === "") return {
+			success: false,
+			error: emptyKeyError(input)
+		};
+		if (!allowEmptyValue && formattedValue === "") return {
+			success: false,
+			error: emptyValueError(input)
+		};
+		if (split === "first" && formattedKey != null && formattedKey.includes(separator)) return {
+			success: false,
+			error: invalidKeyError(message`Expected a key without ${separator}, but got ${formattedKey}.`)
+		};
+		if (split === "last" && formattedValue != null && formattedValue.includes(separator)) return {
+			success: false,
+			error: invalidValueError(message`Expected a value without ${separator}, but got ${formattedValue}.`)
+		};
+		if (formattedKey != null && formattedValue != null) {
+			if (!partsRoundTrip(formattedKey, formattedValue)) return split === "first" ? {
+				success: false,
+				error: invalidKeyError(message`Expected a key that round-trips with ${separator}, but got ${formattedKey}.`)
+			} : {
+				success: false,
+				error: invalidValueError(message`Expected a value that round-trips with ${separator}, but got ${formattedValue}.`)
+			};
+		}
+		return makeKeyValueSuccess(keyResult, valueResult);
+	}
+	function validateTuple(value) {
+		if (!allowEmptyKey && value[0] === "") return {
+			success: false,
+			error: emptyKeyError(fallbackInput(value[0], value[1]))
+		};
+		if (!allowEmptyValue && value[1] === "") return {
+			success: false,
+			error: emptyValueError(fallbackInput(value[0], value[1]))
+		};
+		const keyResult = validateValueParserValue(keyParser, value[0]);
+		if (!keyResult.success) return {
+			success: false,
+			error: invalidKeyError(keyResult.error)
+		};
+		const valueResult = validateValueParserValue(valueParser, value[1]);
+		if (!valueResult.success) return {
+			success: false,
+			error: invalidValueError(valueResult.error)
+		};
+		return validateResultParts(fallbackInput(value[0], value[1]), keyResult, valueResult);
+	}
+	return {
+		mode: "sync",
+		metavar: metavar$1,
+		placeholder: [keyParser.placeholder, valueParser.placeholder],
+		parse(input) {
+			const index = findSeparator(input);
+			if (index < 0) return {
+				success: false,
+				error: missingSeparatorError(input)
+			};
+			const key = input.slice(0, index);
+			const value = input.slice(index + separator.length);
+			return validateParts(input, key, value);
+		},
+		format(value) {
+			return `${keyParser.format(value[0])}${separator}${valueParser.format(value[1])}`;
+		},
+		validate(value) {
+			if (!isKeyValueTuple(value)) return {
+				success: false,
+				error: message`Expected a key-value tuple.`
+			};
+			return validateTuple(value);
+		},
+		...hasNormalize ? { normalize(value) {
+			if (!isKeyValueTuple(value)) return value;
+			const normalized = [typeof keyParser.normalize === "function" ? keyParser.normalize(value[0]) : value[0], typeof valueParser.normalize === "function" ? valueParser.normalize(value[1]) : value[1]];
+			return validateTuple(normalized).success ? normalized : value;
+		} } : {},
+		...hasSuggest ? { *suggest(prefix) {
+			const index = findSeparator(prefix);
+			const suggestions = [];
+			if (index < 0 || split === "last") {
+				if (typeof keyParser.suggest === "function") for (const suggestion of keyParser.suggest(prefix)) {
+					const key = suggestionTextValue(suggestion);
+					if (suggestion.kind === "literal" ? !validateKeyForSuggestion(key) : !validateKeyPatternForSuggestion(key)) continue;
+					suggestions.push(prefixKeyValueSuggestion(suggestion, "", separator));
+				}
+			}
+			if (index < 0) {
+				yield* deduplicateSuggestions(suggestions);
+				return;
+			}
+			if (typeof valueParser.suggest === "function") {
+				const key = prefix.slice(0, index);
+				if (!validateKeyForSuggestion(key)) {
+					yield* deduplicateSuggestions(suggestions);
+					return;
+				}
+				const valuePrefix = prefix.slice(index + separator.length);
+				for (const suggestion of valueParser.suggest(valuePrefix)) {
+					const value = suggestionTextValue(suggestion);
+					if (!partsRoundTrip(key, value)) continue;
+					if (suggestion.kind === "literal" && !validateParts(`${key}${separator}${value}`, key, value).success) continue;
+					suggestions.push(prefixKeyValueSuggestion(suggestion, `${key}${separator}`));
+				}
+			}
+			yield* deduplicateSuggestions(suggestions);
+		} } : {}
+	};
+}
+function checkKeyValueChildParser(role, parser) {
+	if (!isValueParser(parser)) throw new TypeError(`The ${role} option for keyValue() must be a value parser.`);
+	if (parser.mode !== "sync") throw new TypeError(`keyValue() only supports sync ${role} parsers, but an async one was given.`);
+	if (isDerivedValueParser(parser)) throw new TypeError(`keyValue() does not support dependency-derived ${role} parsers (created via deriveFrom() or dependency().derive()); pass the derived parser directly to option() or argument() instead.`);
+}
+function validateValueParserValue(parser, value) {
+	if (typeof parser.validate === "function") return parser.validate(value);
+	let formatted;
+	try {
+		formatted = parser.format(value);
+	} catch {
+		return {
+			success: true,
+			value
+		};
+	}
+	if (typeof formatted !== "string") return {
+		success: false,
+		error: stringFormatError()
+	};
+	return parser.parse(formatted);
+}
+function formatValueParserValue(parser, value) {
+	let formatted;
+	try {
+		formatted = parser.format(value);
+	} catch {
+		return {
+			success: true,
+			value: void 0
+		};
+	}
+	if (typeof formatted !== "string") return {
+		success: false,
+		error: stringFormatError()
+	};
+	return {
+		success: true,
+		value: formatted
+	};
+}
+function stringFormatError() {
+	return message`Expected a value formatted as a string.`;
+}
+function suggestionTextValue(suggestion) {
+	return suggestion.kind === "literal" ? suggestion.text : suggestion.pattern ?? "";
+}
+function prefixKeyValueSuggestion(suggestion, prefix, suffix = "") {
+	const textValue = suggestionTextValue(suggestion);
+	const text$1 = `${prefix}${textValue}${suffix}`;
+	if (suggestion.kind === "file" && suffix === "") return {
+		...suggestion,
+		pattern: text$1
+	};
+	return suggestion.description == null ? {
+		kind: "literal",
+		text: text$1
+	} : {
+		kind: "literal",
+		text: text$1,
+		description: suggestion.description
+	};
+}
+function isKeyValueTuple(value) {
+	return Array.isArray(value) && value.length === 2 && 0 in value && 1 in value;
+}
+function makeKeyValueSuccess(keyResult, valueResult) {
+	const deferredKeys = /* @__PURE__ */ new Map();
+	let hasDeferred = false;
+	collectKeyValueDeferredKeys(deferredKeys, 0, keyResult, () => {
+		hasDeferred = true;
+	});
+	collectKeyValueDeferredKeys(deferredKeys, 1, valueResult, () => {
+		hasDeferred = true;
+	});
+	return {
+		success: true,
+		value: [keyResult.value, valueResult.value],
+		...hasDeferred ? {
+			deferred: true,
+			...deferredKeys.size > 0 ? { deferredKeys } : {}
+		} : {}
+	};
+}
+function collectKeyValueDeferredKeys(deferredKeys, index, result, markDeferred) {
+	if (result.deferredKeys != null) {
+		markDeferred();
+		deferredKeys.set(index, result.deferredKeys);
+		return;
+	}
+	if (result.deferred !== true) return;
+	markDeferred();
+	deferredKeys.set(index, null);
+}
 /**
 * Creates a ValueParser for parsing integer values from strings.
 *
@@ -5780,4 +6097,4 @@ function plainObjectsEqual(a, b) {
 }
 
 //#endregion
-export { checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, ensureNonEmptyString, fileSize, firstOf, float, hostname, integer, ip, ipv4, ipv6, isNonEmptyString, isValueParser, json, locale, macAddress, port, portRange, semVer, socketAddress, string, url, uuid };
+export { checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, ensureNonEmptyString, fileSize, firstOf, float, hostname, integer, ip, ipv4, ipv6, isNonEmptyString, isValueParser, json, keyValue, locale, macAddress, port, portRange, semVer, socketAddress, string, url, uuid };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.1.0-dev.2152",
+  "version": "1.1.0-dev.2160",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",
@@ -200,7 +200,7 @@
     "fast-check": "^4.7.0",
     "tsdown": "^0.13.0",
     "typescript": "^5.8.3",
-    "@optique/env": "1.1.0-dev.2152+cc0a0741"
+    "@optique/env": "1.1.0-dev.2160+4b3b85cc"
   },
   "scripts": {
     "build": "tsdown",