@optique/core 1.0.0-dev.701 → 1.0.0-dev.717

package/dist/dependency.cjs

@@ -86,7 +86,7 @@ function dependency(parser) {
 			return createSyncDerivedParser(id, options);
 		},
 		deriveAsync(options) {
-			return createDerivedValueParser(id, parser, options);
+			return createAsyncDerivedParserFromAsyncFactory(id, options);
 		}
 	};
 	return result;
@@ -212,8 +212,17 @@ function createSyncDerivedFromParser(sourceId, options) {
 		[dependencyIds]: alldependencyIds,
 		[defaultValues]: options.defaultValues,
 		parse(input) {
-			const sourceValues = options.defaultValues();
-			const derivedParser = options.factory(...sourceValues);
+			let derivedParser;
+			try {
+				const sourceValues = options.defaultValues();
+				derivedParser = options.factory(...sourceValues);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return {
+					success: false,
+					error: require_message.message`Derived parser error: ${msg}`
+				};
+			}
 			if (isAsyncModeParser(derivedParser)) return {
 				success: false,
 				error: require_message.message`Factory returned an async parser where a sync parser is required.`
@@ -277,9 +286,18 @@ function createAsyncDerivedFromParserFromAsyncFactory(sourceId, options) {
 		[dependencyIds]: alldependencyIds,
 		[defaultValues]: options.defaultValues,
 		parse(input) {
-			const sourceValues = options.defaultValues();
-			const derivedParser = options.factory(...sourceValues);
-			return derivedParser.parse(input);
+			let derivedParser;
+			try {
+				const sourceValues = options.defaultValues();
+				derivedParser = options.factory(...sourceValues);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return Promise.resolve({
+					success: false,
+					error: require_message.message`Derived parser error: ${msg}`
+				});
+			}
+			return Promise.resolve(derivedParser.parse(input));
 		},
 		[parseWithDependency](input, dependencyValue) {
 			let derivedParser;
@@ -292,7 +310,7 @@ function createAsyncDerivedFromParserFromAsyncFactory(sourceId, options) {
 					error: require_message.message`Factory error: ${msg}`
 				});
 			}
-			return derivedParser.parse(input);
+			return Promise.resolve(derivedParser.parse(input));
 		},
 		format(value) {
 			const sourceValues = options.defaultValues();
@@ -334,8 +352,17 @@ function createAsyncDerivedFromParserFromSyncFactory(sourceId, options) {
 		[dependencyIds]: alldependencyIds,
 		[defaultValues]: options.defaultValues,
 		parse(input) {
-			const sourceValues = options.defaultValues();
-			const derivedParser = options.factory(...sourceValues);
+			let derivedParser;
+			try {
+				const sourceValues = options.defaultValues();
+				derivedParser = options.factory(...sourceValues);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return Promise.resolve({
+					success: false,
+					error: require_message.message`Derived parser error: ${msg}`
+				});
+			}
 			return Promise.resolve(derivedParser.parse(input));
 		},
 		[parseWithDependency](input, dependencyValue) {
@@ -402,8 +429,17 @@ function createSyncDerivedParser(sourceId, options) {
 		[derivedValueParserMarker]: true,
 		[dependencyId]: sourceId,
 		parse(input) {
-			const sourceValue = options.defaultValue();
-			const derivedParser = options.factory(sourceValue);
+			let derivedParser;
+			try {
+				const sourceValue = options.defaultValue();
+				derivedParser = options.factory(sourceValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return {
+					success: false,
+					error: require_message.message`Derived parser error: ${msg}`
+				};
+			}
 			if (isAsyncModeParser(derivedParser)) return {
 				success: false,
 				error: require_message.message`Factory returned an async parser where a sync parser is required.`
@@ -463,9 +499,18 @@ function createAsyncDerivedParserFromAsyncFactory(sourceId, options) {
 		[derivedValueParserMarker]: true,
 		[dependencyId]: sourceId,
 		parse(input) {
-			const sourceValue = options.defaultValue();
-			const derivedParser = options.factory(sourceValue);
-			return derivedParser.parse(input);
+			let derivedParser;
+			try {
+				const sourceValue = options.defaultValue();
+				derivedParser = options.factory(sourceValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return Promise.resolve({
+					success: false,
+					error: require_message.message`Derived parser error: ${msg}`
+				});
+			}
+			return Promise.resolve(derivedParser.parse(input));
 		},
 		[parseWithDependency](input, dependencyValue) {
 			let derivedParser;
@@ -478,7 +523,7 @@ function createAsyncDerivedParserFromAsyncFactory(sourceId, options) {
 					error: require_message.message`Factory error: ${msg}`
 				});
 			}
-			return derivedParser.parse(input);
+			return Promise.resolve(derivedParser.parse(input));
 		},
 		format(value) {
 			const sourceValue = options.defaultValue();
@@ -516,8 +561,17 @@ function createAsyncDerivedParserFromSyncFactory(sourceId, options) {
 		[derivedValueParserMarker]: true,
 		[dependencyId]: sourceId,
 		parse(input) {
-			const sourceValue = options.defaultValue();
-			const derivedParser = options.factory(sourceValue);
+			let derivedParser;
+			try {
+				const sourceValue = options.defaultValue();
+				derivedParser = options.factory(sourceValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return Promise.resolve({
+					success: false,
+					error: require_message.message`Derived parser error: ${msg}`
+				});
+			}
 			return Promise.resolve(derivedParser.parse(input));
 		},
 		[parseWithDependency](input, dependencyValue) {

package/dist/dependency.js

@@ -86,7 +86,7 @@ function dependency(parser) {
 			return createSyncDerivedParser(id, options);
 		},
 		deriveAsync(options) {
-			return createDerivedValueParser(id, parser, options);
+			return createAsyncDerivedParserFromAsyncFactory(id, options);
 		}
 	};
 	return result;
@@ -212,8 +212,17 @@ function createSyncDerivedFromParser(sourceId, options) {
 		[dependencyIds]: alldependencyIds,
 		[defaultValues]: options.defaultValues,
 		parse(input) {
-			const sourceValues = options.defaultValues();
-			const derivedParser = options.factory(...sourceValues);
+			let derivedParser;
+			try {
+				const sourceValues = options.defaultValues();
+				derivedParser = options.factory(...sourceValues);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return {
+					success: false,
+					error: message`Derived parser error: ${msg}`
+				};
+			}
 			if (isAsyncModeParser(derivedParser)) return {
 				success: false,
 				error: message`Factory returned an async parser where a sync parser is required.`
@@ -277,9 +286,18 @@ function createAsyncDerivedFromParserFromAsyncFactory(sourceId, options) {
 		[dependencyIds]: alldependencyIds,
 		[defaultValues]: options.defaultValues,
 		parse(input) {
-			const sourceValues = options.defaultValues();
-			const derivedParser = options.factory(...sourceValues);
-			return derivedParser.parse(input);
+			let derivedParser;
+			try {
+				const sourceValues = options.defaultValues();
+				derivedParser = options.factory(...sourceValues);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return Promise.resolve({
+					success: false,
+					error: message`Derived parser error: ${msg}`
+				});
+			}
+			return Promise.resolve(derivedParser.parse(input));
 		},
 		[parseWithDependency](input, dependencyValue) {
 			let derivedParser;
@@ -292,7 +310,7 @@ function createAsyncDerivedFromParserFromAsyncFactory(sourceId, options) {
 					error: message`Factory error: ${msg}`
 				});
 			}
-			return derivedParser.parse(input);
+			return Promise.resolve(derivedParser.parse(input));
 		},
 		format(value) {
 			const sourceValues = options.defaultValues();
@@ -334,8 +352,17 @@ function createAsyncDerivedFromParserFromSyncFactory(sourceId, options) {
 		[dependencyIds]: alldependencyIds,
 		[defaultValues]: options.defaultValues,
 		parse(input) {
-			const sourceValues = options.defaultValues();
-			const derivedParser = options.factory(...sourceValues);
+			let derivedParser;
+			try {
+				const sourceValues = options.defaultValues();
+				derivedParser = options.factory(...sourceValues);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return Promise.resolve({
+					success: false,
+					error: message`Derived parser error: ${msg}`
+				});
+			}
 			return Promise.resolve(derivedParser.parse(input));
 		},
 		[parseWithDependency](input, dependencyValue) {
@@ -402,8 +429,17 @@ function createSyncDerivedParser(sourceId, options) {
 		[derivedValueParserMarker]: true,
 		[dependencyId]: sourceId,
 		parse(input) {
-			const sourceValue = options.defaultValue();
-			const derivedParser = options.factory(sourceValue);
+			let derivedParser;
+			try {
+				const sourceValue = options.defaultValue();
+				derivedParser = options.factory(sourceValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return {
+					success: false,
+					error: message`Derived parser error: ${msg}`
+				};
+			}
 			if (isAsyncModeParser(derivedParser)) return {
 				success: false,
 				error: message`Factory returned an async parser where a sync parser is required.`
@@ -463,9 +499,18 @@ function createAsyncDerivedParserFromAsyncFactory(sourceId, options) {
 		[derivedValueParserMarker]: true,
 		[dependencyId]: sourceId,
 		parse(input) {
-			const sourceValue = options.defaultValue();
-			const derivedParser = options.factory(sourceValue);
-			return derivedParser.parse(input);
+			let derivedParser;
+			try {
+				const sourceValue = options.defaultValue();
+				derivedParser = options.factory(sourceValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return Promise.resolve({
+					success: false,
+					error: message`Derived parser error: ${msg}`
+				});
+			}
+			return Promise.resolve(derivedParser.parse(input));
 		},
 		[parseWithDependency](input, dependencyValue) {
 			let derivedParser;
@@ -478,7 +523,7 @@ function createAsyncDerivedParserFromAsyncFactory(sourceId, options) {
 					error: message`Factory error: ${msg}`
 				});
 			}
-			return derivedParser.parse(input);
+			return Promise.resolve(derivedParser.parse(input));
 		},
 		format(value) {
 			const sourceValue = options.defaultValue();
@@ -516,8 +561,17 @@ function createAsyncDerivedParserFromSyncFactory(sourceId, options) {
 		[derivedValueParserMarker]: true,
 		[dependencyId]: sourceId,
 		parse(input) {
-			const sourceValue = options.defaultValue();
-			const derivedParser = options.factory(sourceValue);
+			let derivedParser;
+			try {
+				const sourceValue = options.defaultValue();
+				derivedParser = options.factory(sourceValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return Promise.resolve({
+					success: false,
+					error: message`Derived parser error: ${msg}`
+				});
+			}
 			return Promise.resolve(derivedParser.parse(input));
 		},
 		[parseWithDependency](input, dependencyValue) {

package/dist/valueparser.cjs

@@ -308,6 +308,15 @@ function integer(options) {
 	}
 	const metavar = options?.metavar ?? "INTEGER";
 	require_nonempty.ensureNonEmptyString(metavar);
+	const maxSafe = BigInt(Number.MAX_SAFE_INTEGER);
+	const minSafe = BigInt(Number.MIN_SAFE_INTEGER);
+	const unsafeIntegerError = options?.errors?.unsafeInteger;
+	function makeUnsafeIntegerError(input) {
+		return {
+			success: false,
+			error: unsafeIntegerError ? typeof unsafeIntegerError === "function" ? unsafeIntegerError(input) : unsafeIntegerError : require_message.message`Expected a safe integer between ${require_message.text(Number.MIN_SAFE_INTEGER.toLocaleString("en"))} and ${require_message.text(Number.MAX_SAFE_INTEGER.toLocaleString("en"))}, but got ${input}. Use type: "bigint" for large values.`
+		};
+	}
 	return {
 		$mode: "sync",
 		metavar,
@@ -316,7 +325,14 @@ function integer(options) {
 				success: false,
 				error: options?.errors?.invalidInteger ? typeof options.errors.invalidInteger === "function" ? options.errors.invalidInteger(input) : options.errors.invalidInteger : require_message.message`Expected a valid integer, but got ${input}.`
 			};
-			const value = Number.parseInt(input);
+			let n;
+			try {
+				n = BigInt(input);
+			} catch {
+				return makeUnsafeIntegerError(input);
+			}
+			if (n > maxSafe || n < minSafe) return makeUnsafeIntegerError(input);
+			const value = Number(input);
 			if (options?.min != null && value < options.min) return {
 				success: false,
 				error: options.errors?.belowMinimum ? typeof options.errors.belowMinimum === "function" ? options.errors.belowMinimum(value, options.min) : options.errors.belowMinimum : require_message.message`Expected a value greater than or equal to ${require_message.text(options.min.toLocaleString("en"))}, but got ${input}.`

package/dist/valueparser.d.cts

@@ -279,6 +279,13 @@ interface IntegerOptionsNumber {
      * @since 0.5.0
      */
     invalidInteger?: Message | ((input: string) => Message);
+    /**
+     * Custom error message when integer is outside the safe integer range
+     * (`Number.MIN_SAFE_INTEGER` to `Number.MAX_SAFE_INTEGER`).
+     * Can be a static message or a function that receives the input string.
+     * @since 1.0.0
+     */
+    unsafeInteger?: Message | ((input: string) => Message);
     /**
      * Custom error message when integer is below minimum value.
      * Can be a static message or a function that receives the value and minimum.

package/dist/valueparser.d.ts

@@ -279,6 +279,13 @@ interface IntegerOptionsNumber {
      * @since 0.5.0
      */
     invalidInteger?: Message | ((input: string) => Message);
+    /**
+     * Custom error message when integer is outside the safe integer range
+     * (`Number.MIN_SAFE_INTEGER` to `Number.MAX_SAFE_INTEGER`).
+     * Can be a static message or a function that receives the input string.
+     * @since 1.0.0
+     */
+    unsafeInteger?: Message | ((input: string) => Message);
     /**
      * Custom error message when integer is below minimum value.
      * Can be a static message or a function that receives the value and minimum.

package/dist/valueparser.js

@@ -308,6 +308,15 @@ function integer(options) {
 	}
 	const metavar = options?.metavar ?? "INTEGER";
 	ensureNonEmptyString(metavar);
+	const maxSafe = BigInt(Number.MAX_SAFE_INTEGER);
+	const minSafe = BigInt(Number.MIN_SAFE_INTEGER);
+	const unsafeIntegerError = options?.errors?.unsafeInteger;
+	function makeUnsafeIntegerError(input) {
+		return {
+			success: false,
+			error: unsafeIntegerError ? typeof unsafeIntegerError === "function" ? unsafeIntegerError(input) : unsafeIntegerError : message`Expected a safe integer between ${text(Number.MIN_SAFE_INTEGER.toLocaleString("en"))} and ${text(Number.MAX_SAFE_INTEGER.toLocaleString("en"))}, but got ${input}. Use type: "bigint" for large values.`
+		};
+	}
 	return {
 		$mode: "sync",
 		metavar,
@@ -316,7 +325,14 @@ function integer(options) {
 				success: false,
 				error: options?.errors?.invalidInteger ? typeof options.errors.invalidInteger === "function" ? options.errors.invalidInteger(input) : options.errors.invalidInteger : message`Expected a valid integer, but got ${input}.`
 			};
-			const value = Number.parseInt(input);
+			let n;
+			try {
+				n = BigInt(input);
+			} catch {
+				return makeUnsafeIntegerError(input);
+			}
+			if (n > maxSafe || n < minSafe) return makeUnsafeIntegerError(input);
+			const value = Number(input);
 			if (options?.min != null && value < options.min) return {
 				success: false,
 				error: options.errors?.belowMinimum ? typeof options.errors.belowMinimum === "function" ? options.errors.belowMinimum(value, options.min) : options.errors.belowMinimum : message`Expected a value greater than or equal to ${text(options.min.toLocaleString("en"))}, but got ${input}.`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.0.0-dev.701+138e5e73",
+  "version": "1.0.0-dev.717+e59d286e",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",