@optique/core 1.0.0-dev.1495 → 1.0.0-dev.1500

package/dist/parser.d.cts

@@ -3,7 +3,7 @@ import { Message } from "./message.cjs";
 import { Usage } from "./usage.cjs";
 import { DocFragments, DocPage } from "./doc.cjs";
 import { DependencyRegistryLike } from "./registry-types.cjs";
-import { ValueParserResult } from "./valueparser.cjs";
+import { DeferredMap, ValueParserResult } from "./valueparser.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";
 import { MultipleErrorOptions, MultipleOptions, WithDefaultError, WithDefaultOptions, map, multiple, nonEmpty, optional, withDefault } from "./modifiers.cjs";
 import { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, OptionErrorOptions, OptionOptions, OptionState, PassThroughFormat, PassThroughOptions, argument, command, constant, fail, flag, option, passThrough } from "./primitives.cjs";
@@ -158,6 +158,20 @@ interface Parser<M extends Mode = "sync", TValue = unknown, TState = unknown> {
    *          fragments for this parser.
    */
   getDocFragments(state: DocState<TState>, defaultValue?: TValue): DocFragments;
+  /**
+   * A type-appropriate default value used as a stand-in during deferred
+   * prompt resolution.  When present, combinators like `prompt()` use this
+   * value instead of an internal sentinel during two-phase parsing, so that
+   * `map()` transforms and dynamic contexts always receive a valid value
+   * of type {@link TValue}.
+   *
+   * This property is set automatically by `option()` and `argument()` from
+   * the underlying {@link ValueParser}'s `placeholder`, and propagated by
+   * combinators like `map()`, `optional()`, and `withDefault()`.
+   *
+   * @since 1.0.0
+   */
+  readonly placeholder?: TValue;
   /**
    * Optional predicate that determines whether completion should be
    * deferred for the given parser state.
@@ -318,6 +332,19 @@ type Result<T> = {
    * have been applied and completed.
    */
   value: T;
+  /**
+   * When `true`, indicates that the value contains deferred prompt
+   * placeholders.  Propagated from {@link ValueParserResult.deferred}.
+   * @since 1.0.0
+   */
+  deferred?: true;
+  /**
+   * Property keys (object field names or array indices) whose values are
+   * deferred placeholders.
+   * Propagated from {@link ValueParserResult.deferredKeys}.
+   * @since 1.0.0
+   */
+  deferredKeys?: DeferredMap;
 } | {
   /**
    * Indicates that the parsing operation failed.

package/dist/parser.d.ts

@@ -3,7 +3,7 @@ import { Message } from "./message.js";
 import { Usage } from "./usage.js";
 import { DocFragments, DocPage } from "./doc.js";
 import { DependencyRegistryLike } from "./registry-types.js";
-import { ValueParserResult } from "./valueparser.js";
+import { DeferredMap, ValueParserResult } from "./valueparser.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";
 import { MultipleErrorOptions, MultipleOptions, WithDefaultError, WithDefaultOptions, map, multiple, nonEmpty, optional, withDefault } from "./modifiers.js";
 import { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, OptionErrorOptions, OptionOptions, OptionState, PassThroughFormat, PassThroughOptions, argument, command, constant, fail, flag, option, passThrough } from "./primitives.js";
@@ -158,6 +158,20 @@ interface Parser<M extends Mode = "sync", TValue = unknown, TState = unknown> {
    *          fragments for this parser.
    */
   getDocFragments(state: DocState<TState>, defaultValue?: TValue): DocFragments;
+  /**
+   * A type-appropriate default value used as a stand-in during deferred
+   * prompt resolution.  When present, combinators like `prompt()` use this
+   * value instead of an internal sentinel during two-phase parsing, so that
+   * `map()` transforms and dynamic contexts always receive a valid value
+   * of type {@link TValue}.
+   *
+   * This property is set automatically by `option()` and `argument()` from
+   * the underlying {@link ValueParser}'s `placeholder`, and propagated by
+   * combinators like `map()`, `optional()`, and `withDefault()`.
+   *
+   * @since 1.0.0
+   */
+  readonly placeholder?: TValue;
   /**
    * Optional predicate that determines whether completion should be
    * deferred for the given parser state.
@@ -318,6 +332,19 @@ type Result<T> = {
    * have been applied and completed.
    */
   value: T;
+  /**
+   * When `true`, indicates that the value contains deferred prompt
+   * placeholders.  Propagated from {@link ValueParserResult.deferred}.
+   * @since 1.0.0
+   */
+  deferred?: true;
+  /**
+   * Property keys (object field names or array indices) whose values are
+   * deferred placeholders.
+   * Propagated from {@link ValueParserResult.deferredKeys}.
+   * @since 1.0.0
+   */
+  deferredKeys?: DeferredMap;
 } | {
   /**
    * Indicates that the parsing operation failed.

package/dist/parser.js

@@ -60,7 +60,9 @@ function parseSync(parser, args, options) {
 	const endResult = parser.complete(context.state);
 	return endResult.success ? {
 		success: true,
-		value: shouldUnwrapAnnotatedValue ? unwrapInjectedAnnotationWrapper(endResult.value) : endResult.value
+		value: shouldUnwrapAnnotatedValue ? unwrapInjectedAnnotationWrapper(endResult.value) : endResult.value,
+		...endResult.deferred ? { deferred: true } : {},
+		...endResult.deferredKeys ? { deferredKeys: endResult.deferredKeys } : {}
 	} : {
 		success: false,
 		error: endResult.error
@@ -110,7 +112,9 @@ async function parseAsync(parser, args, options) {
 	const endResult = await parser.complete(context.state);
 	return endResult.success ? {
 		success: true,
-		value: shouldUnwrapAnnotatedValue ? unwrapInjectedAnnotationWrapper(endResult.value) : endResult.value
+		value: shouldUnwrapAnnotatedValue ? unwrapInjectedAnnotationWrapper(endResult.value) : endResult.value,
+		...endResult.deferred ? { deferred: true } : {},
+		...endResult.deferredKeys ? { deferredKeys: endResult.deferredKeys } : {}
 	} : {
 		success: false,
 		error: endResult.error

package/dist/primitives.cjs

@@ -32,7 +32,7 @@ function createOptionParseState(rawInput, valueParser, parseResult) {
 * @template T The type of the constant value produced by the parser.
 */
 function constant(value) {
-	return {
+	const result = {
 		$valueType: [],
 		$stateType: [],
 		$mode: "sync",
@@ -59,6 +59,13 @@ function constant(value) {
 			return { fragments: [] };
 		}
 	};
+	Object.defineProperty(result, "placeholder", {
+		value,
+		configurable: true,
+		enumerable: false,
+		writable: false
+	});
+	return result;
 }
 /**
 * Creates a parser that always fails without consuming any input.
@@ -546,6 +553,23 @@ function option(...args) {
 			return `option(${optionNames$1.map((o) => JSON.stringify(o)).join(", ")})`;
 		}
 	};
+	if (valueParser != null) Object.defineProperty(result, "placeholder", {
+		get() {
+			try {
+				return valueParser.placeholder;
+			} catch {
+				return void 0;
+			}
+		},
+		configurable: true,
+		enumerable: false
+	});
+	else Object.defineProperty(result, "placeholder", {
+		value: false,
+		configurable: true,
+		enumerable: false,
+		writable: false
+	});
 	return result;
 }
 /**
@@ -588,7 +612,7 @@ function flag(...args) {
 		optionNames$1 = args.slice(0, -1);
 	} else optionNames$1 = args;
 	require_validate.validateOptionNames(optionNames$1, "Flag");
-	return {
+	const result = {
 		$valueType: [],
 		$stateType: [],
 		$mode: "sync",
@@ -738,6 +762,13 @@ function flag(...args) {
 			return `flag(${optionNames$1.map((o) => JSON.stringify(o)).join(", ")})`;
 		}
 	};
+	Object.defineProperty(result, "placeholder", {
+		value: true,
+		configurable: true,
+		enumerable: false,
+		writable: false
+	});
+	return result;
 }
 /**
 * Creates a parser that expects a single argument value.
@@ -872,6 +903,17 @@ function argument(valueParser, options = {}) {
 			return `argument()`;
 		}
 	};
+	Object.defineProperty(result, "placeholder", {
+		get() {
+			try {
+				return valueParser.placeholder;
+			} catch {
+				return void 0;
+			}
+		},
+		configurable: true,
+		enumerable: false
+	});
 	return result;
 }
 function* suggestCommandSync(context, prefix, name, parser, options) {

package/dist/primitives.js

@@ -32,7 +32,7 @@ function createOptionParseState(rawInput, valueParser, parseResult) {
 * @template T The type of the constant value produced by the parser.
 */
 function constant(value) {
-	return {
+	const result = {
 		$valueType: [],
 		$stateType: [],
 		$mode: "sync",
@@ -59,6 +59,13 @@ function constant(value) {
 			return { fragments: [] };
 		}
 	};
+	Object.defineProperty(result, "placeholder", {
+		value,
+		configurable: true,
+		enumerable: false,
+		writable: false
+	});
+	return result;
 }
 /**
 * Creates a parser that always fails without consuming any input.
@@ -546,6 +553,23 @@ function option(...args) {
 			return `option(${optionNames$1.map((o) => JSON.stringify(o)).join(", ")})`;
 		}
 	};
+	if (valueParser != null) Object.defineProperty(result, "placeholder", {
+		get() {
+			try {
+				return valueParser.placeholder;
+			} catch {
+				return void 0;
+			}
+		},
+		configurable: true,
+		enumerable: false
+	});
+	else Object.defineProperty(result, "placeholder", {
+		value: false,
+		configurable: true,
+		enumerable: false,
+		writable: false
+	});
 	return result;
 }
 /**
@@ -588,7 +612,7 @@ function flag(...args) {
 		optionNames$1 = args.slice(0, -1);
 	} else optionNames$1 = args;
 	validateOptionNames(optionNames$1, "Flag");
-	return {
+	const result = {
 		$valueType: [],
 		$stateType: [],
 		$mode: "sync",
@@ -738,6 +762,13 @@ function flag(...args) {
 			return `flag(${optionNames$1.map((o) => JSON.stringify(o)).join(", ")})`;
 		}
 	};
+	Object.defineProperty(result, "placeholder", {
+		value: true,
+		configurable: true,
+		enumerable: false,
+		writable: false
+	});
+	return result;
 }
 /**
 * Creates a parser that expects a single argument value.
@@ -872,6 +903,17 @@ function argument(valueParser, options = {}) {
 			return `argument()`;
 		}
 	};
+	Object.defineProperty(result, "placeholder", {
+		get() {
+			try {
+				return valueParser.placeholder;
+			} catch {
+				return void 0;
+			}
+		},
+		configurable: true,
+		enumerable: false
+	});
 	return result;
 }
 function* suggestCommandSync(context, prefix, name, parser, options) {

package/dist/suggestion.cjs

@@ -81,8 +81,11 @@ function findSimilar(input, candidates, options = {}) {
 	if (input.length === 0) return [];
 	const normalizedInput = caseSensitive ? input : input.toLowerCase();
 	const matches = [];
+	const seen = /* @__PURE__ */ new Set();
 	for (const candidate of candidates) {
 		const normalizedCandidate = caseSensitive ? candidate : candidate.toLowerCase();
+		if (seen.has(candidate)) continue;
+		seen.add(candidate);
 		const distance = levenshteinDistance(normalizedInput, normalizedCandidate);
 		if (distance === 0) return [candidate];
 		const distanceRatio = distance / input.length;

package/dist/suggestion.js

@@ -81,8 +81,11 @@ function findSimilar(input, candidates, options = {}) {
 	if (input.length === 0) return [];
 	const normalizedInput = caseSensitive ? input : input.toLowerCase();
 	const matches = [];
+	const seen = /* @__PURE__ */ new Set();
 	for (const candidate of candidates) {
 		const normalizedCandidate = caseSensitive ? candidate : candidate.toLowerCase();
+		if (seen.has(candidate)) continue;
+		seen.add(candidate);
 		const distance = levenshteinDistance(normalizedInput, normalizedCandidate);
 		if (distance === 0) return [candidate];
 		const distanceRatio = distance / input.length;

package/dist/valueparser.cjs

@@ -6,9 +6,18 @@ const require_nonempty = require('./nonempty.cjs');
 * A predicate function that checks if an object is a {@link ValueParser}.
 * @param object The object to check.
 * @return `true` if the object is a {@link ValueParser}, `false` otherwise.
+* @throws {TypeError} If the object looks like a value parser (has `$mode`,
+*   `metavar`, `parse`, and `format`) but is missing the required
+*   `placeholder` property.
 */
 function isValueParser(object) {
-	return typeof object === "object" && object != null && "$mode" in object && (object.$mode === "sync" || object.$mode === "async") && "metavar" in object && typeof object.metavar === "string" && "parse" in object && typeof object.parse === "function" && "format" in object && typeof object.format === "function";
+	if (typeof object !== "object" || object == null || !("$mode" in object) || object.$mode !== "sync" && object.$mode !== "async") return false;
+	const hasMetavar = "metavar" in object && typeof object.metavar === "string";
+	const hasParse = "parse" in object && typeof object.parse === "function";
+	const hasFormat = "format" in object && typeof object.format === "function";
+	const hasPlaceholder = "placeholder" in object;
+	if (hasMetavar && hasParse && hasFormat && !hasPlaceholder) throw new TypeError("Value parser is missing the required placeholder property. All value parsers must define a placeholder value.");
+	return hasMetavar && hasParse && hasFormat && hasPlaceholder;
 }
 /**
 * Implementation of the choice parser for both string and number types.
@@ -49,6 +58,7 @@ function choice(choices, options = {}) {
 		return {
 			$mode: "sync",
 			metavar,
+			placeholder: choices[0],
 			choices: frozenNumberChoices,
 			parse(input) {
 				const index = numberStrings.indexOf(input);
@@ -130,6 +140,7 @@ function choice(choices, options = {}) {
 	return {
 		$mode: "sync",
 		metavar,
+		placeholder: choices[0],
 		choices: stringChoices,
 		parse(input) {
 			const normalizedInput = caseInsensitive ? input.toLowerCase() : input;
@@ -288,6 +299,7 @@ function string(options = {}) {
 	return {
 		$mode: "sync",
 		metavar,
+		placeholder: options.placeholder ?? "",
 		parse(input) {
 			if (patternSource != null && patternFlags != null) {
 				const pattern = new RegExp(patternSource, patternFlags);
@@ -344,6 +356,8 @@ function string(options = {}) {
 *          integer type.
 * @throws {TypeError} If `options.type` is provided but is neither `"number"`
 *   nor `"bigint"`.
+* @throws {RangeError} If the configured min/max range for number mode contains
+*   no safe integers.
 */
 function integer(options) {
 	if (options?.type !== void 0 && options.type !== "number" && options.type !== "bigint") throw new TypeError(`Expected type to be "number" or "bigint", but got: ${String(options.type)}.`);
@@ -358,6 +372,7 @@ function integer(options) {
 		return {
 			$mode: "sync",
 			metavar: metavar$1,
+			placeholder: options?.placeholder ?? (options?.min != null && options.min > 0n ? options.min : options?.max != null && options.max < 0n ? options.max : 0n),
 			parse(input) {
 				if (!input.match(/^-?\d+$/)) return {
 					success: false,
@@ -386,6 +401,11 @@ function integer(options) {
 	require_nonempty.ensureNonEmptyString(metavar);
 	const maxSafe = BigInt(Number.MAX_SAFE_INTEGER);
 	const minSafe = BigInt(Number.MIN_SAFE_INTEGER);
+	const safeMin = Math.max(options?.min ?? Number.MIN_SAFE_INTEGER, Number.MIN_SAFE_INTEGER);
+	const safeMax = Math.min(options?.max ?? Number.MAX_SAFE_INTEGER, Number.MAX_SAFE_INTEGER);
+	const firstAllowed = Math.ceil(safeMin);
+	const lastAllowed = Math.floor(safeMax);
+	if (firstAllowed > lastAllowed) throw new RangeError("The configured integer range contains no safe integers. Use type: \"bigint\" instead.");
 	const unsafeIntegerError = options?.errors?.unsafeInteger;
 	function makeUnsafeIntegerError(input) {
 		return {
@@ -396,6 +416,7 @@ function integer(options) {
 	return {
 		$mode: "sync",
 		metavar,
+		placeholder: options?.placeholder ?? (firstAllowed > 0 ? firstAllowed : lastAllowed < 0 ? lastAllowed : 0),
 		parse(input) {
 			if (!input.match(/^-?\d+$/)) return {
 				success: false,
@@ -446,6 +467,7 @@ function float(options = {}) {
 	return {
 		$mode: "sync",
 		metavar,
+		placeholder: options?.placeholder ?? (options?.min != null && options.min > 0 ? options.min : options?.max != null && options.max < 0 ? options.max : 0),
 		parse(input) {
 			const invalidNumber = (i) => ({
 				success: false,
@@ -530,6 +552,9 @@ function url(options = {}) {
 	return {
 		$mode: "sync",
 		metavar,
+		get placeholder() {
+			return new URL(`${allowedProtocols?.[0] ?? "http:"}//0.invalid`);
+		},
 		parse(input) {
 			if (!URL.canParse(input)) return {
 				success: false,
@@ -596,6 +621,7 @@ function locale(options = {}) {
 	return {
 		$mode: "sync",
 		metavar,
+		placeholder: new Intl.Locale("und"),
 		parse(input) {
 			let locale$1;
 			try {
@@ -891,6 +917,7 @@ function uuid(options = {}) {
 	return {
 		$mode: "sync",
 		metavar,
+		placeholder: "00000000-0000-0000-0000-000000000000",
 		parse(input) {
 			if (!uuidRegex.test(input)) return {
 				success: false,
@@ -994,9 +1021,11 @@ function port(options) {
 		const min$1 = options.min ?? 1n;
 		const max$1 = options.max ?? 65535n;
 		if (min$1 > max$1) throw new RangeError(`Expected min to be less than or equal to max, but got min: ${min$1} and max: ${max$1}.`);
+		if (options.disallowWellKnown && min$1 < 1024n && max$1 < 1024n) throw new RangeError(`disallowWellKnown is incompatible with the configured port range: all ports ${min$1}..${max$1} are well-known.`);
 		return {
 			$mode: "sync",
 			metavar: metavar$1,
+			placeholder: options.placeholder ?? (options.disallowWellKnown && min$1 < 1024n ? 1024n > min$1 ? 1024n : min$1 : min$1),
 			parse(input) {
 				if (!input.match(/^-?\d+$/)) return {
 					success: false,
@@ -1032,9 +1061,11 @@ function port(options) {
 	const min = options?.min ?? 1;
 	const max = options?.max ?? 65535;
 	if (min > max) throw new RangeError(`Expected min to be less than or equal to max, but got min: ${min} and max: ${max}.`);
+	if (options?.disallowWellKnown && min < 1024 && max < 1024) throw new RangeError(`disallowWellKnown is incompatible with the configured port range: all ports ${min}..${max} are well-known.`);
 	return {
 		$mode: "sync",
 		metavar,
+		placeholder: options?.placeholder ?? (options?.disallowWellKnown && min < 1024 ? Math.max(1024, min) : min),
 		parse(input) {
 			if (!input.match(/^-?\d+$/)) return {
 				success: false,
@@ -1128,6 +1159,7 @@ function ipv4(options) {
 	return {
 		$mode: "sync",
 		metavar,
+		placeholder: allowZero ? "0.0.0.0" : allowLoopback ? "127.0.0.1" : "192.0.2.1",
 		parse(input) {
 			const parts = input.split(".");
 			if (parts.length !== 4) {
@@ -1289,6 +1321,7 @@ function hostname(options) {
 	return {
 		$mode: "sync",
 		metavar,
+		placeholder: options?.placeholder ?? (allowLocalhost ? maxLength >= 9 ? "localhost" : "a.bc" : maxLength >= 11 ? "example.com" : "a.bc"),
 		parse(input) {
 			if (input.length > maxLength) {
 				const errorMsg = options?.errors?.tooLong;
@@ -1408,6 +1441,10 @@ function email(options) {
 	const metavar = options?.metavar ?? "EMAIL";
 	require_nonempty.ensureNonEmptyString(metavar);
 	const allowMultiple = options?.allowMultiple ?? false;
+	if (options?.placeholder != null) {
+		if (allowMultiple && !Array.isArray(options.placeholder)) throw new TypeError("email() placeholder must be an array when allowMultiple is true.");
+		if (!allowMultiple && typeof options.placeholder !== "string") throw new TypeError("email() placeholder must be a string when allowMultiple is false.");
+	}
 	const allowDisplayName = options?.allowDisplayName ?? false;
 	const lowercase = options?.lowercase ?? false;
 	const allowedDomains = options?.allowedDomains != null ? Object.freeze([...options.allowedDomains]) : void 0;
@@ -1504,6 +1541,7 @@ function email(options) {
 	return {
 		$mode: "sync",
 		metavar,
+		placeholder: options?.placeholder ?? (options?.allowMultiple ? [`user@${options?.allowedDomains?.[0] ?? "example.com"}`] : `user@${options?.allowedDomains?.[0] ?? "example.com"}`),
 		parse(input) {
 			if (allowMultiple) {
 				const emails = splitEmails(input).map((e) => e.trim());
@@ -1724,6 +1762,12 @@ function socketAddress(options) {
 	return {
 		$mode: "sync",
 		metavar,
+		get placeholder() {
+			return {
+				host: hostType === "ip" ? ipParser.placeholder : hostnameParser.placeholder,
+				port: defaultPort ?? portParser.placeholder
+			};
+		},
 		parse(input) {
 			const trimmed = input.trim();
 			const canOmitPort = defaultPort !== void 0 && !requirePort;
@@ -1936,6 +1980,15 @@ function portRange(options) {
 	return {
 		$mode: "sync",
 		metavar,
+		get placeholder() {
+			return isBigInt ? {
+				start: portParser.placeholder,
+				end: portParser.placeholder
+			} : {
+				start: portParser.placeholder,
+				end: portParser.placeholder
+			};
+		},
 		parse(input) {
 			const trimmed = input.trim();
 			const separatorIndex = trimmed.indexOf(separator);
@@ -2094,6 +2147,20 @@ function macAddress(options) {
 	return {
 		$mode: "sync",
 		metavar,
+		get placeholder() {
+			const octets = [
+				"00",
+				"00",
+				"00",
+				"00",
+				"00",
+				"00"
+			];
+			const sep = outputSeparator ?? (separator === "any" ? ":" : separator);
+			if (sep === ".") return `${octets[0]}${octets[1]}.${octets[2]}${octets[3]}.${octets[4]}${octets[5]}`;
+			if (sep === "none") return octets.join("");
+			return octets.join(sep);
+		},
 		parse(input) {
 			let octets = [];
 			let inputSeparator;
@@ -2250,6 +2317,7 @@ function domain(options) {
 	return {
 		$mode: "sync",
 		metavar,
+		placeholder: options?.placeholder ?? `example.${allowedTldsLower?.[0] ?? "com"}`,
 		parse(input) {
 			if (input.length > maxLength) {
 				const errorMsg = tooLong;
@@ -2489,6 +2557,7 @@ function ipv6(options) {
 	return {
 		$mode: "sync",
 		metavar,
+		placeholder: allowZero ? "::" : allowLoopback ? "::1" : "2001:db8::1",
 		parse(input) {
 			const normalized = parseAndNormalizeIpv6(input);
 			if (normalized === null) {
@@ -2905,6 +2974,7 @@ function ip(options) {
 	return {
 		$mode: "sync",
 		metavar,
+		placeholder: version === 6 ? ipv6Parser.placeholder : ipv4Parser.placeholder,
 		parse(input) {
 			let ipv4Error = null;
 			let ipv6Error = null;
@@ -3046,6 +3116,17 @@ function cidr(options) {
 	return {
 		$mode: "sync",
 		metavar,
+		get placeholder() {
+			return version === 6 || version === "both" && (minPrefix ?? 0) > 32 ? {
+				address: ipv6Parser.placeholder,
+				prefix: minPrefix ?? 0,
+				version: 6
+			} : {
+				address: ipv4Parser.placeholder,
+				prefix: minPrefix ?? 0,
+				version: 4
+			};
+		},
 		parse(input) {
 			const slashIndex = input.lastIndexOf("/");
 			if (slashIndex === -1) {