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

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.705+5cb74130",
+  "version": "1.0.0-dev.717+e59d286e",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",