@optique/core 1.1.0-dev.2065 → 1.1.0-dev.2069

package/dist/index.cjs

@@ -106,6 +106,7 @@ exports.runParserSync = require_facade.runParserSync;
 exports.runWith = require_facade.runWith;
 exports.runWithAsync = require_facade.runWithAsync;
 exports.runWithSync = require_facade.runWithSync;
+exports.semVer = require_valueparser.semVer;
 exports.socketAddress = require_valueparser.socketAddress;
 exports.string = require_valueparser.string;
 exports.suggest = require_parser.suggest;

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, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, MacAddressOptions, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, SocketAddressOptions, SocketAddressValue, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, fileSize, float, hostname, integer, ip, ipv4, ipv6, isValueParser, locale, macAddress, port, portRange, socketAddress, string, url, uuid } from "./valueparser.cjs";
+import { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, Color, ColorFormat, ColorOptions, DeferredMap, DomainOptions, EmailOptions, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, 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, float, hostname, integer, ip, ipv4, ipv6, isValueParser, 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, TupleOptions, concat, conditional, group, longestMatch, merge, object, or, 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, 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, color, command, commandLine, concat, conditional, constant, createParserContext, deduplicateDocEntries, deduplicateDocFragments, dependency, deriveFrom, deriveFromAsync, deriveFromSync, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fileSize, 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 };
+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, 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, SemVer, SemVerOptionsObject, SemVerOptionsString, SemVerString, 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, 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, semVer, 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, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, MacAddressOptions, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, SocketAddressOptions, SocketAddressValue, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, fileSize, float, hostname, integer, ip, ipv4, ipv6, isValueParser, locale, macAddress, port, portRange, socketAddress, string, url, uuid } from "./valueparser.js";
+import { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, Color, ColorFormat, ColorOptions, DeferredMap, DomainOptions, EmailOptions, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, 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, float, hostname, integer, ip, ipv4, ipv6, isValueParser, 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, TupleOptions, concat, conditional, group, longestMatch, merge, object, or, 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, 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, color, command, commandLine, concat, conditional, constant, createParserContext, deduplicateDocEntries, deduplicateDocFragments, dependency, deriveFrom, deriveFromAsync, deriveFromSync, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fileSize, 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 };
+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, 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, SemVer, SemVerOptionsObject, SemVerOptionsString, SemVerString, 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, 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, semVer, socketAddress, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, valueSet, values, withDefault, zsh };

package/dist/index.js

@@ -8,8 +8,8 @@ import { createParserContext, getDocPage, getDocPageAsync, getDocPageSync, parse
 import { DuplicateOptionError, concat, conditional, group, longestMatch, merge, object, or, 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, float, hostname, integer, ip, ipv4, ipv6, isValueParser, locale, macAddress, port, portRange, socketAddress, string, url, uuid } from "./valueparser.js";
+import { checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, fileSize, float, hostname, integer, ip, ipv4, ipv6, isValueParser, 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, 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 };
+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, 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, semVer, socketAddress, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, valueSet, values, withDefault, zsh };

package/dist/valueparser.cjs

@@ -5144,6 +5144,97 @@ function cidr(options) {
 	});
 	return cidrParserObj;
 }
+const SEMVER_REGEX = /^(?<prefix>v)?(?<major>0|[1-9]\d*)\.(?<minor>0|[1-9]\d*)\.(?<patch>0|[1-9]\d*)(?:-(?<pre>(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+(?<meta>[0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
+const SEMVER_SUGGESTIONS = Object.freeze([
+	"0.0.0",
+	"1.0.0",
+	"1.0.0-alpha",
+	"1.0.0-alpha.1",
+	"1.0.0+build.1",
+	"1.0.0-alpha.1+build.1"
+]);
+const SEMVER_SUGGESTIONS_WITH_PREFIX = Object.freeze([...SEMVER_SUGGESTIONS, ...SEMVER_SUGGESTIONS.map((s) => `v${s}`)]);
+function semVer(options = {}) {
+	const metavar = options.metavar ?? "SEMVER";
+	require_nonempty.ensureNonEmptyString(metavar);
+	checkEnumOption(options, "type", ["string", "object"]);
+	checkBooleanOption(options, "allowPrefix");
+	const allowPrefix = options.allowPrefix ?? false;
+	const objectMode = options.type === "object";
+	const errorOption = options.errors?.invalidSemVer;
+	const suggestions = allowPrefix ? SEMVER_SUGGESTIONS_WITH_PREFIX : SEMVER_SUGGESTIONS;
+	function makeError(input) {
+		return {
+			success: false,
+			error: errorOption ? typeof errorOption === "function" ? errorOption(input) : errorOption : require_message.message`Expected a valid Semantic Versioning 2.0.0 string (e.g. ${"1.0.0"}), but got ${input}.`
+		};
+	}
+	if (objectMode) return {
+		mode: "sync",
+		metavar,
+		placeholder: {
+			major: 0,
+			minor: 0,
+			patch: 0
+		},
+		parse(input) {
+			const m = SEMVER_REGEX.exec(input);
+			if (m == null) return makeError(input);
+			if (!allowPrefix && m.groups.prefix != null) return makeError(input);
+			const major = parseInt(m.groups.major, 10);
+			const minor = parseInt(m.groups.minor, 10);
+			const patch = parseInt(m.groups.patch, 10);
+			if (!Number.isSafeInteger(major) || !Number.isSafeInteger(minor) || !Number.isSafeInteger(patch)) return makeError(input);
+			const result = {
+				major,
+				minor,
+				patch,
+				...m.groups.pre != null ? { preRelease: m.groups.pre } : {},
+				...m.groups.meta != null ? { metadata: m.groups.meta } : {}
+			};
+			return {
+				success: true,
+				value: result
+			};
+		},
+		format(value) {
+			let s = `${value.major}.${value.minor}.${value.patch}`;
+			if (value.preRelease != null) s += `-${value.preRelease}`;
+			if (value.metadata != null) s += `+${value.metadata}`;
+			return s;
+		},
+		*suggest(prefix) {
+			for (const s of suggestions) if (s.startsWith(prefix)) yield {
+				kind: "literal",
+				text: s
+			};
+		}
+	};
+	return {
+		mode: "sync",
+		metavar,
+		placeholder: "0.0.0",
+		parse(input) {
+			const m = SEMVER_REGEX.exec(input);
+			if (m == null) return makeError(input);
+			if (!allowPrefix && m.groups.prefix != null) return makeError(input);
+			const canonical = `${m.groups.major}.${m.groups.minor}.${m.groups.patch}` + (m.groups.pre != null ? `-${m.groups.pre}` : "") + (m.groups.meta != null ? `+${m.groups.meta}` : "");
+			return {
+				success: true,
+				value: canonical
+			};
+		},
+		format(value) {
+			return value;
+		},
+		*suggest(prefix) {
+			for (const s of suggestions) if (s.startsWith(prefix)) yield {
+				kind: "literal",
+				text: s
+			};
+		}
+	};
+}
 
 //#endregion
 exports.checkBooleanOption = checkBooleanOption;
@@ -5167,6 +5258,7 @@ exports.locale = locale;
 exports.macAddress = macAddress;
 exports.port = port;
 exports.portRange = portRange;
+exports.semVer = semVer;
 exports.socketAddress = socketAddress;
 exports.string = string;
 exports.url = url;

package/dist/valueparser.d.cts

@@ -2405,5 +2405,159 @@ interface CidrOptions {
  * @since 0.10.0
  */
 declare function cidr(options?: CidrOptions): ValueParser<"sync", CidrValue>;
+/**
+ * A normalized Semantic Versioning 2.0.0 string.
+ *
+ * Covers all four valid forms:
+ *  - `MAJOR.MINOR.PATCH`
+ *  - `MAJOR.MINOR.PATCH-preRelease`
+ *  - `MAJOR.MINOR.PATCH+metadata`
+ *  - `MAJOR.MINOR.PATCH-preRelease+metadata`
+ *
+ * Note: this type uses TypeScript template literals as a coarse structural
+ * hint.  The `${number}` slots accept any JavaScript number serialization
+ * (including negative numbers, decimals, and `Infinity`), so the type alone
+ * does not guarantee full SemVer 2.0.0 validity.  Full validation is
+ * enforced at parse time by {@link semVer}.  Only values returned by
+ * `semVer().parse()` are guaranteed to conform to the specification.
+ *
+ * @since 1.1.0
+ */
+type SemVerString = `${number}.${number}.${number}` | `${number}.${number}.${number}-${string}` | `${number}.${number}.${number}+${string}` | `${number}.${number}.${number}-${string}+${string}`;
+/**
+ * A parsed Semantic Versioning 2.0.0 value as a structured object.
+ *
+ * @since 1.1.0
+ */
+interface SemVer {
+  /**
+   * The major version number.
+   *
+   * This field is a JavaScript `number`, so it is limited to
+   * {@link Number.MAX_SAFE_INTEGER} (2⁵³ − 1).  Inputs whose major
+   * component exceeds this value are rejected by {@link semVer} in object
+   * mode; use string mode to handle arbitrarily large version numbers.
+   */
+  readonly major: number;
+  /**
+   * The minor version number.
+   *
+   * Same safe-integer constraint as {@link major}.
+   */
+  readonly minor: number;
+  /**
+   * The patch version number.
+   *
+   * Same safe-integer constraint as {@link major}.
+   */
+  readonly patch: number;
+  /**
+   * The pre-release identifier (the part after `-`, before `+`), if present.
+   * Example: `"alpha.1"` for `1.0.0-alpha.1`.
+   */
+  readonly preRelease?: string;
+  /**
+   * The build metadata (the part after `+`), if present.
+   * Example: `"build.42"` for `1.0.0+build.42`.
+   */
+  readonly metadata?: string;
+}
+/** @internal */
+interface SemVerOptionsBase {
+  /**
+   * The metavariable name for this parser.  Used in help messages.
+   * @default `"SEMVER"`
+   */
+  readonly metavar?: NonEmptyString;
+  /**
+   * Whether to accept an optional leading `v` character (e.g. `v1.2.3`).
+   * The `v` prefix is stripped; output is always the canonical unprefixed form.
+   * @default false
+   */
+  readonly allowPrefix?: boolean;
+  /**
+   * Custom error messages for parse failures.
+   * @since 1.1.0
+   */
+  readonly errors?: {
+    /**
+     * Message when input is not a valid SemVer string.
+     * Can be a static message or a function receiving the rejected input.
+     */
+    readonly invalidSemVer?: Message | ((input: string) => Message);
+  };
+}
+/**
+ * Options for {@link semVer} in string mode (the default).
+ *
+ * @since 1.1.0
+ */
+interface SemVerOptionsString extends SemVerOptionsBase {
+  /** Return a {@link SemVerString} template-literal type. */
+  readonly type?: "string";
+}
+/**
+ * Options for {@link semVer} in object mode.
+ *
+ * In object mode, version components are stored as JavaScript `number`
+ * values.  Components exceeding {@link Number.MAX_SAFE_INTEGER} (2⁵³ − 1)
+ * cannot be represented exactly and are therefore rejected with a parse
+ * error.  Use string mode (the default) if you need to handle version
+ * numbers of arbitrary magnitude.
+ *
+ * @since 1.1.0
+ */
+interface SemVerOptionsObject extends SemVerOptionsBase {
+  /** Return a structured {@link SemVer} object. */
+  readonly type: "object";
+}
+/**
+ * Creates a {@link ValueParser} for [Semantic Versioning 2.0.0] strings.
+ *
+ * In string mode (the default), the parser returns a {@link SemVerString}
+ * template-literal type.  String mode accepts any spec-valid SemVer input,
+ * including version components of arbitrary magnitude.
+ *
+ * In object mode (`type: "object"`), the parser returns a structured
+ * {@link SemVer} value with `major`, `minor`, `patch`, and optional
+ * `preRelease` and `metadata` fields.  Because the numeric components are
+ * stored as JavaScript `number`, object mode additionally rejects inputs
+ * whose major, minor, or patch value exceeds
+ * {@link Number.MAX_SAFE_INTEGER} (2⁵³ − 1).  Use string mode if you need
+ * to handle arbitrarily large version numbers.
+ *
+ * Both modes strictly enforce the SemVer 2.0.0 specification: no leading
+ * zeros in numeric components, no empty pre-release or build identifiers,
+ * and no invalid characters.
+ *
+ * [Semantic Versioning 2.0.0]: https://semver.org/
+ *
+ * @param options Configuration options.
+ * @returns A {@link ValueParser} that validates SemVer strings.
+ * @throws {TypeError} If {@link SemVerOptionsBase.metavar} is an empty string.
+ * @throws {TypeError} If {@link SemVerOptionsBase.allowPrefix} is not a
+ *   boolean.
+ * @throws {TypeError} If {@link SemVerOptionsString.type} is not `"string"`,
+ *   `"object"`, or `undefined`.
+ * @since 1.1.0
+ */
+declare function semVer(options?: SemVerOptionsString): ValueParser<"sync", SemVerString>;
+/**
+ * Creates a {@link ValueParser} for [Semantic Versioning 2.0.0] strings,
+ * returning a structured {@link SemVer} object.
+ *
+ * [Semantic Versioning 2.0.0]: https://semver.org/
+ *
+ * @param options Configuration options with `type: "object"`.
+ * @returns A {@link ValueParser} that converts SemVer strings to {@link SemVer}
+ *   objects.
+ * @throws {TypeError} If {@link SemVerOptionsBase.metavar} is an empty string.
+ * @throws {TypeError} If {@link SemVerOptionsBase.allowPrefix} is not a
+ *   boolean.
+ * @throws {TypeError} If {@link SemVerOptionsObject.type} is not `"string"`,
+ *   `"object"`, or `undefined`.
+ * @since 1.1.0
+ */
+declare function semVer(options: SemVerOptionsObject): ValueParser<"sync", SemVer>;
 //#endregion
-export { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, Color, ColorFormat, ColorOptions, DeferredMap, DomainOptions, EmailOptions, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, MacAddressOptions, type Mode, type ModeIterable, type ModeValue, type NonEmptyString, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, SocketAddressOptions, SocketAddressValue, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, ensureNonEmptyString, fileSize, float, hostname, integer, ip, ipv4, ipv6, isNonEmptyString, isValueParser, locale, macAddress, port, portRange, socketAddress, string, url, uuid };
+export { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, Color, ColorFormat, ColorOptions, DeferredMap, DomainOptions, EmailOptions, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, 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, float, hostname, integer, ip, ipv4, ipv6, isNonEmptyString, isValueParser, locale, macAddress, port, portRange, semVer, socketAddress, string, url, uuid };

package/dist/valueparser.d.ts

@@ -2405,5 +2405,159 @@ interface CidrOptions {
  * @since 0.10.0
  */
 declare function cidr(options?: CidrOptions): ValueParser<"sync", CidrValue>;
+/**
+ * A normalized Semantic Versioning 2.0.0 string.
+ *
+ * Covers all four valid forms:
+ *  - `MAJOR.MINOR.PATCH`
+ *  - `MAJOR.MINOR.PATCH-preRelease`
+ *  - `MAJOR.MINOR.PATCH+metadata`
+ *  - `MAJOR.MINOR.PATCH-preRelease+metadata`
+ *
+ * Note: this type uses TypeScript template literals as a coarse structural
+ * hint.  The `${number}` slots accept any JavaScript number serialization
+ * (including negative numbers, decimals, and `Infinity`), so the type alone
+ * does not guarantee full SemVer 2.0.0 validity.  Full validation is
+ * enforced at parse time by {@link semVer}.  Only values returned by
+ * `semVer().parse()` are guaranteed to conform to the specification.
+ *
+ * @since 1.1.0
+ */
+type SemVerString = `${number}.${number}.${number}` | `${number}.${number}.${number}-${string}` | `${number}.${number}.${number}+${string}` | `${number}.${number}.${number}-${string}+${string}`;
+/**
+ * A parsed Semantic Versioning 2.0.0 value as a structured object.
+ *
+ * @since 1.1.0
+ */
+interface SemVer {
+  /**
+   * The major version number.
+   *
+   * This field is a JavaScript `number`, so it is limited to
+   * {@link Number.MAX_SAFE_INTEGER} (2⁵³ − 1).  Inputs whose major
+   * component exceeds this value are rejected by {@link semVer} in object
+   * mode; use string mode to handle arbitrarily large version numbers.
+   */
+  readonly major: number;
+  /**
+   * The minor version number.
+   *
+   * Same safe-integer constraint as {@link major}.
+   */
+  readonly minor: number;
+  /**
+   * The patch version number.
+   *
+   * Same safe-integer constraint as {@link major}.
+   */
+  readonly patch: number;
+  /**
+   * The pre-release identifier (the part after `-`, before `+`), if present.
+   * Example: `"alpha.1"` for `1.0.0-alpha.1`.
+   */
+  readonly preRelease?: string;
+  /**
+   * The build metadata (the part after `+`), if present.
+   * Example: `"build.42"` for `1.0.0+build.42`.
+   */
+  readonly metadata?: string;
+}
+/** @internal */
+interface SemVerOptionsBase {
+  /**
+   * The metavariable name for this parser.  Used in help messages.
+   * @default `"SEMVER"`
+   */
+  readonly metavar?: NonEmptyString;
+  /**
+   * Whether to accept an optional leading `v` character (e.g. `v1.2.3`).
+   * The `v` prefix is stripped; output is always the canonical unprefixed form.
+   * @default false
+   */
+  readonly allowPrefix?: boolean;
+  /**
+   * Custom error messages for parse failures.
+   * @since 1.1.0
+   */
+  readonly errors?: {
+    /**
+     * Message when input is not a valid SemVer string.
+     * Can be a static message or a function receiving the rejected input.
+     */
+    readonly invalidSemVer?: Message | ((input: string) => Message);
+  };
+}
+/**
+ * Options for {@link semVer} in string mode (the default).
+ *
+ * @since 1.1.0
+ */
+interface SemVerOptionsString extends SemVerOptionsBase {
+  /** Return a {@link SemVerString} template-literal type. */
+  readonly type?: "string";
+}
+/**
+ * Options for {@link semVer} in object mode.
+ *
+ * In object mode, version components are stored as JavaScript `number`
+ * values.  Components exceeding {@link Number.MAX_SAFE_INTEGER} (2⁵³ − 1)
+ * cannot be represented exactly and are therefore rejected with a parse
+ * error.  Use string mode (the default) if you need to handle version
+ * numbers of arbitrary magnitude.
+ *
+ * @since 1.1.0
+ */
+interface SemVerOptionsObject extends SemVerOptionsBase {
+  /** Return a structured {@link SemVer} object. */
+  readonly type: "object";
+}
+/**
+ * Creates a {@link ValueParser} for [Semantic Versioning 2.0.0] strings.
+ *
+ * In string mode (the default), the parser returns a {@link SemVerString}
+ * template-literal type.  String mode accepts any spec-valid SemVer input,
+ * including version components of arbitrary magnitude.
+ *
+ * In object mode (`type: "object"`), the parser returns a structured
+ * {@link SemVer} value with `major`, `minor`, `patch`, and optional
+ * `preRelease` and `metadata` fields.  Because the numeric components are
+ * stored as JavaScript `number`, object mode additionally rejects inputs
+ * whose major, minor, or patch value exceeds
+ * {@link Number.MAX_SAFE_INTEGER} (2⁵³ − 1).  Use string mode if you need
+ * to handle arbitrarily large version numbers.
+ *
+ * Both modes strictly enforce the SemVer 2.0.0 specification: no leading
+ * zeros in numeric components, no empty pre-release or build identifiers,
+ * and no invalid characters.
+ *
+ * [Semantic Versioning 2.0.0]: https://semver.org/
+ *
+ * @param options Configuration options.
+ * @returns A {@link ValueParser} that validates SemVer strings.
+ * @throws {TypeError} If {@link SemVerOptionsBase.metavar} is an empty string.
+ * @throws {TypeError} If {@link SemVerOptionsBase.allowPrefix} is not a
+ *   boolean.
+ * @throws {TypeError} If {@link SemVerOptionsString.type} is not `"string"`,
+ *   `"object"`, or `undefined`.
+ * @since 1.1.0
+ */
+declare function semVer(options?: SemVerOptionsString): ValueParser<"sync", SemVerString>;
+/**
+ * Creates a {@link ValueParser} for [Semantic Versioning 2.0.0] strings,
+ * returning a structured {@link SemVer} object.
+ *
+ * [Semantic Versioning 2.0.0]: https://semver.org/
+ *
+ * @param options Configuration options with `type: "object"`.
+ * @returns A {@link ValueParser} that converts SemVer strings to {@link SemVer}
+ *   objects.
+ * @throws {TypeError} If {@link SemVerOptionsBase.metavar} is an empty string.
+ * @throws {TypeError} If {@link SemVerOptionsBase.allowPrefix} is not a
+ *   boolean.
+ * @throws {TypeError} If {@link SemVerOptionsObject.type} is not `"string"`,
+ *   `"object"`, or `undefined`.
+ * @since 1.1.0
+ */
+declare function semVer(options: SemVerOptionsObject): ValueParser<"sync", SemVer>;
 //#endregion
-export { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, Color, ColorFormat, ColorOptions, DeferredMap, DomainOptions, EmailOptions, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, MacAddressOptions, type Mode, type ModeIterable, type ModeValue, type NonEmptyString, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, SocketAddressOptions, SocketAddressValue, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, ensureNonEmptyString, fileSize, float, hostname, integer, ip, ipv4, ipv6, isNonEmptyString, isValueParser, locale, macAddress, port, portRange, socketAddress, string, url, uuid };
+export { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, Color, ColorFormat, ColorOptions, DeferredMap, DomainOptions, EmailOptions, FileSizeOptions, FileSizeOptionsBigInt, FileSizeOptionsNumber, FileSizeUnit, FloatOptions, HostnameOptions, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, 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, float, hostname, integer, ip, ipv4, ipv6, isNonEmptyString, isValueParser, locale, macAddress, port, portRange, semVer, socketAddress, string, url, uuid };

package/dist/valueparser.js

@@ -5144,6 +5144,97 @@ function cidr(options) {
 	});
 	return cidrParserObj;
 }
+const SEMVER_REGEX = /^(?<prefix>v)?(?<major>0|[1-9]\d*)\.(?<minor>0|[1-9]\d*)\.(?<patch>0|[1-9]\d*)(?:-(?<pre>(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+(?<meta>[0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
+const SEMVER_SUGGESTIONS = Object.freeze([
+	"0.0.0",
+	"1.0.0",
+	"1.0.0-alpha",
+	"1.0.0-alpha.1",
+	"1.0.0+build.1",
+	"1.0.0-alpha.1+build.1"
+]);
+const SEMVER_SUGGESTIONS_WITH_PREFIX = Object.freeze([...SEMVER_SUGGESTIONS, ...SEMVER_SUGGESTIONS.map((s) => `v${s}`)]);
+function semVer(options = {}) {
+	const metavar = options.metavar ?? "SEMVER";
+	ensureNonEmptyString(metavar);
+	checkEnumOption(options, "type", ["string", "object"]);
+	checkBooleanOption(options, "allowPrefix");
+	const allowPrefix = options.allowPrefix ?? false;
+	const objectMode = options.type === "object";
+	const errorOption = options.errors?.invalidSemVer;
+	const suggestions = allowPrefix ? SEMVER_SUGGESTIONS_WITH_PREFIX : SEMVER_SUGGESTIONS;
+	function makeError(input) {
+		return {
+			success: false,
+			error: errorOption ? typeof errorOption === "function" ? errorOption(input) : errorOption : message`Expected a valid Semantic Versioning 2.0.0 string (e.g. ${"1.0.0"}), but got ${input}.`
+		};
+	}
+	if (objectMode) return {
+		mode: "sync",
+		metavar,
+		placeholder: {
+			major: 0,
+			minor: 0,
+			patch: 0
+		},
+		parse(input) {
+			const m = SEMVER_REGEX.exec(input);
+			if (m == null) return makeError(input);
+			if (!allowPrefix && m.groups.prefix != null) return makeError(input);
+			const major = parseInt(m.groups.major, 10);
+			const minor = parseInt(m.groups.minor, 10);
+			const patch = parseInt(m.groups.patch, 10);
+			if (!Number.isSafeInteger(major) || !Number.isSafeInteger(minor) || !Number.isSafeInteger(patch)) return makeError(input);
+			const result = {
+				major,
+				minor,
+				patch,
+				...m.groups.pre != null ? { preRelease: m.groups.pre } : {},
+				...m.groups.meta != null ? { metadata: m.groups.meta } : {}
+			};
+			return {
+				success: true,
+				value: result
+			};
+		},
+		format(value) {
+			let s = `${value.major}.${value.minor}.${value.patch}`;
+			if (value.preRelease != null) s += `-${value.preRelease}`;
+			if (value.metadata != null) s += `+${value.metadata}`;
+			return s;
+		},
+		*suggest(prefix) {
+			for (const s of suggestions) if (s.startsWith(prefix)) yield {
+				kind: "literal",
+				text: s
+			};
+		}
+	};
+	return {
+		mode: "sync",
+		metavar,
+		placeholder: "0.0.0",
+		parse(input) {
+			const m = SEMVER_REGEX.exec(input);
+			if (m == null) return makeError(input);
+			if (!allowPrefix && m.groups.prefix != null) return makeError(input);
+			const canonical = `${m.groups.major}.${m.groups.minor}.${m.groups.patch}` + (m.groups.pre != null ? `-${m.groups.pre}` : "") + (m.groups.meta != null ? `+${m.groups.meta}` : "");
+			return {
+				success: true,
+				value: canonical
+			};
+		},
+		format(value) {
+			return value;
+		},
+		*suggest(prefix) {
+			for (const s of suggestions) if (s.startsWith(prefix)) yield {
+				kind: "literal",
+				text: s
+			};
+		}
+	};
+}
 
 //#endregion
-export { checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, ensureNonEmptyString, fileSize, float, hostname, integer, ip, ipv4, ipv6, isNonEmptyString, isValueParser, locale, macAddress, port, portRange, socketAddress, string, url, uuid };
+export { checkBooleanOption, checkEnumOption, choice, cidr, color, domain, email, ensureNonEmptyString, fileSize, float, hostname, integer, ip, ipv4, ipv6, isNonEmptyString, isValueParser, locale, macAddress, port, portRange, semVer, socketAddress, string, url, uuid };

package/package.json

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