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

package/dist/completion.cjs

@@ -162,7 +162,7 @@ function _${programName} () {
 
       # Pre-expand file candidates.  When the glob base came from the
       # program's pattern and contains wildcard characters (* or ?),
-      # use it as-is via compgen -G (safe — no command substitution).
+      # use it as-is via compgen -G (safe—no command substitution).
       # Otherwise append * to treat it as a prefix.
       # Note: [ is NOT treated as a glob indicator because it commonly
       # appears in literal filenames like [draft] or foo[1].txt.
@@ -375,7 +375,7 @@ function _${programName.replace(/[^a-zA-Z0-9]/g, "_")} () {
             [[ "\$__compare_pattern" == */* ]] && __compare_pattern="\${__compare_pattern%/*}/" || __compare_pattern=""
           fi
           if [[ ( -n "\$__compare_pattern" || -n "\$__norm_prefix" ) && \${#__norm_prefix} -ge \${#__compare_pattern} && "\${__norm_prefix[1,\${#__compare_pattern}]}" == "\$__compare_pattern" && "\$PREFIX" != "\$pattern" ]]; then
-            # User typed an equivalent or extended form — keep PREFIX
+            # User typed an equivalent or extended form—keep PREFIX
             true
           else
             PREFIX="\$pattern"
@@ -536,7 +536,7 @@ ${escapedArgs ? `    set -l output (${programName} ${escapedArgs} $prev $current
                 end
             end
 
-            # Expand tilde prefix for globbing — fish does not expand ~
+            # Expand tilde prefix for globbing—fish does not expand ~
             # inside variable substitutions, so replace it with $HOME
             if string match -q '~/*' -- "$glob_base"
                 set __tilde_prefix "~"
@@ -1186,7 +1186,7 @@ ${escapedArgs ? `    \$completionArgs += @(${escapedArgs})
                     \$prefix = \$prefix + '/'
                 }
 
-                # Build the glob path — when the prefix contains wildcard
+                # Build the glob path—when the prefix contains wildcard
                 # characters, use it as-is; otherwise append *
                 \$globPath = if (\$prefix -match '[\*\?]') { \$prefix } else { "\${prefix}*" }
 

package/dist/completion.js

@@ -162,7 +162,7 @@ function _${programName} () {
 
       # Pre-expand file candidates.  When the glob base came from the
       # program's pattern and contains wildcard characters (* or ?),
-      # use it as-is via compgen -G (safe — no command substitution).
+      # use it as-is via compgen -G (safe—no command substitution).
       # Otherwise append * to treat it as a prefix.
       # Note: [ is NOT treated as a glob indicator because it commonly
       # appears in literal filenames like [draft] or foo[1].txt.
@@ -375,7 +375,7 @@ function _${programName.replace(/[^a-zA-Z0-9]/g, "_")} () {
             [[ "\$__compare_pattern" == */* ]] && __compare_pattern="\${__compare_pattern%/*}/" || __compare_pattern=""
           fi
           if [[ ( -n "\$__compare_pattern" || -n "\$__norm_prefix" ) && \${#__norm_prefix} -ge \${#__compare_pattern} && "\${__norm_prefix[1,\${#__compare_pattern}]}" == "\$__compare_pattern" && "\$PREFIX" != "\$pattern" ]]; then
-            # User typed an equivalent or extended form — keep PREFIX
+            # User typed an equivalent or extended form—keep PREFIX
             true
           else
             PREFIX="\$pattern"
@@ -536,7 +536,7 @@ ${escapedArgs ? `    set -l output (${programName} ${escapedArgs} $prev $current
                 end
             end
 
-            # Expand tilde prefix for globbing — fish does not expand ~
+            # Expand tilde prefix for globbing—fish does not expand ~
             # inside variable substitutions, so replace it with $HOME
             if string match -q '~/*' -- "$glob_base"
                 set __tilde_prefix "~"
@@ -1186,7 +1186,7 @@ ${escapedArgs ? `    \$completionArgs += @(${escapedArgs})
                     \$prefix = \$prefix + '/'
                 }
 
-                # Build the glob path — when the prefix contains wildcard
+                # Build the glob path—when the prefix contains wildcard
                 # characters, use it as-is; otherwise append *
                 \$globPath = if (\$prefix -match '[\*\?]') { \$prefix } else { "\${prefix}*" }
 

package/dist/constructs.cjs

@@ -1597,7 +1597,7 @@ function filterExcludedFieldParsers(pairs, excludedFields) {
 /**
 * Pre-completes dependency source fields and registers their values in
 * the given registry.  Unlike `completeDependencySourceDefaults()` (used
-* by suggest), this function handles all four Phase 1 cases — including
+* by suggest), this function handles all four Phase 1 cases—including
 * PendingDependencySourceState in arrays and wrappedDependencySourceMarker.
 *
 * The original state is NOT modified; only the registry is populated.

package/dist/constructs.js

@@ -1597,7 +1597,7 @@ function filterExcludedFieldParsers(pairs, excludedFields) {
 /**
 * Pre-completes dependency source fields and registers their values in
 * the given registry.  Unlike `completeDependencySourceDefaults()` (used
-* by suggest), this function handles all four Phase 1 cases — including
+* by suggest), this function handles all four Phase 1 cases—including
 * PendingDependencySourceState in arrays and wrappedDependencySourceMarker.
 *
 * The original state is NOT modified; only the registry is populated.

package/dist/dependency-metadata.d.cts

@@ -20,13 +20,13 @@ interface DependencySourceCapability {
    * The `state` argument is the current parser state for the source-owning
    * parser.  Each wrapper composes this method to handle its own state shape:
    * - plain source: reads from `DependencySourceState`
-   * - `optional()` / `withDefault()`: unwraps `[innerState]` first
+   * - `optional()`/`withDefault()`: unwraps `[innerState]` first
    * - `map()`: reads the pre-transform value from inner state
    *
    * Returns the `ValueParserResult` (which may be successful with any
    * value including `undefined`, or failed), a promise that resolves to the
    * same shape when extraction needs async work, or `undefined` if the state
-   * does not contain a source result at all (unpopulated / wrong shape).
+   * does not contain a source result at all (unpopulated/wrong shape).
    * Callers and wrapper authors must handle both direct and promise-wrapped
    * results when composing `extractSourceValue`.
    */

package/dist/dependency-metadata.d.ts

@@ -20,13 +20,13 @@ interface DependencySourceCapability {
    * The `state` argument is the current parser state for the source-owning
    * parser.  Each wrapper composes this method to handle its own state shape:
    * - plain source: reads from `DependencySourceState`
-   * - `optional()` / `withDefault()`: unwraps `[innerState]` first
+   * - `optional()`/`withDefault()`: unwraps `[innerState]` first
    * - `map()`: reads the pre-transform value from inner state
    *
    * Returns the `ValueParserResult` (which may be successful with any
    * value including `undefined`, or failed), a promise that resolves to the
    * same shape when extraction needs async work, or `undefined` if the state
-   * does not contain a source result at all (unpopulated / wrong shape).
+   * does not contain a source result at all (unpopulated/wrong shape).
    * Callers and wrapper authors must handle both direct and promise-wrapped
    * results when composing `extractSourceValue`.
    */

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/internal/parser.d.cts

@@ -112,7 +112,7 @@ interface Parser<M extends Mode = "sync", TValue = unknown, TState = unknown> {
    *
    * Each built-in combinator computes this from its structural semantics.
    * Custom parser implementations must include every fixed token that
-   * the parser accepts at `argv[0]` — command names, option names, and
+   * the parser accepts at `argv[0]`—command names, option names, and
    * literal values alike.  For example, a parser whose usage declares
    * `{ type: "literal", value: "serve" }` should include `"serve"` in
    * this set.  Parsers that accept *any* token (like `argument()`) should
@@ -265,8 +265,8 @@ interface Parser<M extends Mode = "sync", TValue = unknown, TState = unknown> {
    * parser (e.g., regex patterns, numeric bounds, `choice()` values).
    *
    * Wrappers like `bindEnv()` and `bindConfig()` call this on fallback
-   * values — environment variables parsed by a looser env parser,
-   * configured defaults, and values loaded from config files — so that
+   * values—environment variables parsed by a looser env parser,
+   * configured defaults, and values loaded from config files—so that
    * those values obey the same validation semantics as CLI input.
    * Without it, parser constraints can be silently bypassed through
    * fallback paths.
@@ -292,7 +292,7 @@ interface Parser<M extends Mode = "sync", TValue = unknown, TState = unknown> {
    * current dependency value, and custom value parsers whose `format()`
    * intentionally throws for unsupported inputs.  Values that
    * `format()` successfully serializes to a string are always re-parsed,
-   * and any resulting parse failure is propagated — they represent the
+   * and any resulting parse failure is propagated—they represent the
    * bug class this method exists to surface.
    *
    * @param value The candidate value to validate.
@@ -413,7 +413,7 @@ interface ExecutionContext {
    * `preCompleteAndRegisterDependencies` results directly to children
    * in Phase 3.  Children read it in their own Phase 1 to avoid
    * re-evaluating non-idempotent default thunks, but never write to
-   * it — this prevents sibling completions from leaking into each
+   * it—this prevents sibling completions from leaking into each
    * other.
    *
    * Field-name keying naturally handles parser reuse across different

package/dist/internal/parser.d.ts

@@ -112,7 +112,7 @@ interface Parser<M extends Mode = "sync", TValue = unknown, TState = unknown> {
    *
    * Each built-in combinator computes this from its structural semantics.
    * Custom parser implementations must include every fixed token that
-   * the parser accepts at `argv[0]` — command names, option names, and
+   * the parser accepts at `argv[0]`—command names, option names, and
    * literal values alike.  For example, a parser whose usage declares
    * `{ type: "literal", value: "serve" }` should include `"serve"` in
    * this set.  Parsers that accept *any* token (like `argument()`) should
@@ -265,8 +265,8 @@ interface Parser<M extends Mode = "sync", TValue = unknown, TState = unknown> {
    * parser (e.g., regex patterns, numeric bounds, `choice()` values).
    *
    * Wrappers like `bindEnv()` and `bindConfig()` call this on fallback
-   * values — environment variables parsed by a looser env parser,
-   * configured defaults, and values loaded from config files — so that
+   * values—environment variables parsed by a looser env parser,
+   * configured defaults, and values loaded from config files—so that
    * those values obey the same validation semantics as CLI input.
    * Without it, parser constraints can be silently bypassed through
    * fallback paths.
@@ -292,7 +292,7 @@ interface Parser<M extends Mode = "sync", TValue = unknown, TState = unknown> {
    * current dependency value, and custom value parsers whose `format()`
    * intentionally throws for unsupported inputs.  Values that
    * `format()` successfully serializes to a string are always re-parsed,
-   * and any resulting parse failure is propagated — they represent the
+   * and any resulting parse failure is propagated—they represent the
    * bug class this method exists to surface.
    *
    * @param value The candidate value to validate.
@@ -413,7 +413,7 @@ interface ExecutionContext {
    * `preCompleteAndRegisterDependencies` results directly to children
    * in Phase 3.  Children read it in their own Phase 1 to avoid
    * re-evaluating non-idempotent default thunks, but never write to
-   * it — this prevents sibling completions from leaking into each
+   * it—this prevents sibling completions from leaking into each
    * other.
    *
    * Field-name keying naturally handles parser reuse across different

package/dist/modifiers.cjs

@@ -142,14 +142,14 @@ function extractOptionalLikePhase2Seed(parser, state, exec) {
 }
 /**
 * Computes the inner state to pass through to the wrapped parser inside
-* {@link optional} / {@link withDefault}.  When the outer state is an
+* {@link optional}/{@link withDefault}.  When the outer state is an
 * array, the inner state is `state[0]`.  Otherwise, including the
 * common case where `optional()` sits at top level and the outer state
-* is either `undefined` or an annotation wrapper from `parseOptionalLike`
-* / `parse({ annotations })`, we use the wrapped parser's
+* is either `undefined` or an annotation wrapper from `parseOptionalLike`/
+* `parse({ annotations })`, we use the wrapped parser's
 * `initialState`, propagating annotations from the outer state so that
-* source-binding wrappers under `optional()` / `withDefault()` (e.g.,
-* `bindEnv()` / `bindConfig()`) can resolve their fallbacks.
+* source-binding wrappers under `optional()`/`withDefault()` (e.g.,
+* `bindEnv()`/`bindConfig()`) can resolve their fallbacks.
 *
 * @internal
 */
@@ -677,7 +677,7 @@ function withDefault(parser, defaultValue, options) {
 *
 * Because the `deferred` flag is propagated conservatively, mapped scalar
 * results are treated as missing (`undefined`) during phase-two context
-* collection — even when `transform` only used non-deferred fields.
+* collection—even when `transform` only used non-deferred fields.
 * For example, `map(object({ apiKey: prompt(...), mode: option(...) }),
 * v => v.mode)` makes phase-two contexts see `undefined` instead of the
 * real `mode` value.  This is the intentional trade-off: the alternative

package/dist/modifiers.d.cts

@@ -138,7 +138,7 @@ declare function withDefault<M extends Mode, TValue, TState, const TDefault = TV
  *
  * Because the `deferred` flag is propagated conservatively, mapped scalar
  * results are treated as missing (`undefined`) during phase-two context
- * collection — even when `transform` only used non-deferred fields.
+ * collection—even when `transform` only used non-deferred fields.
  * For example, `map(object({ apiKey: prompt(...), mode: option(...) }),
  * v => v.mode)` makes phase-two contexts see `undefined` instead of the
  * real `mode` value.  This is the intentional trade-off: the alternative

package/dist/modifiers.d.ts

@@ -138,7 +138,7 @@ declare function withDefault<M extends Mode, TValue, TState, const TDefault = TV
  *
  * Because the `deferred` flag is propagated conservatively, mapped scalar
  * results are treated as missing (`undefined`) during phase-two context
- * collection — even when `transform` only used non-deferred fields.
+ * collection—even when `transform` only used non-deferred fields.
  * For example, `map(object({ apiKey: prompt(...), mode: option(...) }),
  * v => v.mode)` makes phase-two contexts see `undefined` instead of the
  * real `mode` value.  This is the intentional trade-off: the alternative

package/dist/modifiers.js

@@ -142,14 +142,14 @@ function extractOptionalLikePhase2Seed(parser, state, exec) {
 }
 /**
 * Computes the inner state to pass through to the wrapped parser inside
-* {@link optional} / {@link withDefault}.  When the outer state is an
+* {@link optional}/{@link withDefault}.  When the outer state is an
 * array, the inner state is `state[0]`.  Otherwise, including the
 * common case where `optional()` sits at top level and the outer state
-* is either `undefined` or an annotation wrapper from `parseOptionalLike`
-* / `parse({ annotations })`, we use the wrapped parser's
+* is either `undefined` or an annotation wrapper from `parseOptionalLike`/
+* `parse({ annotations })`, we use the wrapped parser's
 * `initialState`, propagating annotations from the outer state so that
-* source-binding wrappers under `optional()` / `withDefault()` (e.g.,
-* `bindEnv()` / `bindConfig()`) can resolve their fallbacks.
+* source-binding wrappers under `optional()`/`withDefault()` (e.g.,
+* `bindEnv()`/`bindConfig()`) can resolve their fallbacks.
 *
 * @internal
 */
@@ -677,7 +677,7 @@ function withDefault(parser, defaultValue, options) {
 *
 * Because the `deferred` flag is propagated conservatively, mapped scalar
 * results are treated as missing (`undefined`) during phase-two context
-* collection — even when `transform` only used non-deferred fields.
+* collection—even when `transform` only used non-deferred fields.
 * For example, `map(object({ apiKey: prompt(...), mode: option(...) }),
 * v => v.mode)` makes phase-two contexts see `undefined` instead of the
 * real `mode` value.  This is the intentional trade-off: the alternative

package/dist/usage-internals.cjs

@@ -55,7 +55,7 @@ function collectLeadingCandidates(terms, optionNames, commandNames) {
 *
 * This is the command-only projection of {@link collectLeadingCandidates}
 * and is used to generate accurate "Did you mean?" suggestions in
-* `command()` error messages — suggestions are scoped to commands actually
+* `command()` error messages—suggestions are scoped to commands actually
 * reachable at the current parse position rather than all commands anywhere
 * in the usage tree.
 *

package/dist/usage-internals.js

@@ -55,7 +55,7 @@ function collectLeadingCandidates(terms, optionNames, commandNames) {
 *
 * This is the command-only projection of {@link collectLeadingCandidates}
 * and is used to generate accurate "Did you mean?" suggestions in
-* `command()` error messages — suggestions are scoped to commands actually
+* `command()` error messages—suggestions are scoped to commands actually
 * reachable at the current parse position rather than all commands anywhere
 * in the usage tree.
 *

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

@@ -161,7 +161,7 @@ type ValueParserResult<T> = {
  * A recursive map that tracks which fields in a parsed object hold deferred
  * placeholder values.  Each entry maps a property key to either `null`
  * (the field is fully deferred and should be replaced with `undefined`)
- * or another `DeferredMap` (the field is partially deferred — recurse into
+ * or another `DeferredMap` (the field is partially deferred—recurse into
  * its sub-fields).
  *
  * @since 1.0.0
@@ -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

@@ -161,7 +161,7 @@ type ValueParserResult<T> = {
  * A recursive map that tracks which fields in a parsed object hold deferred
  * placeholder values.  Each entry maps a property key to either `null`
  * (the field is fully deferred and should be replaced with `undefined`)
- * or another `DeferredMap` (the field is partially deferred — recurse into
+ * or another `DeferredMap` (the field is partially deferred—recurse into
  * its sub-fields).
  *
  * @since 1.0.0
@@ -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.2070",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",