@warlock.js/seal 5.7.0 → 5.9.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `@warlock.js/seal` are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
 
+## 5.9.0 - 2026-09-13
+
+### Added
+
+- `.coerce()` modifier on the number validators (`int` / `number` / `float` / `numeric`): opt into parsing a numeric-shaped string (e.g. a query-string param) into a number while the type rule stays strict. `v.int()` is unchanged by default; chain `.coerce()` to accept `"2"` as `2`. The inferred output type is unaffected.
+
 ## 5.7.0 - 2026-09-11
 
 ### Changed

package/cjs/index.cjs

@@ -6977,6 +6977,26 @@ var NumberValidator = class extends PrimitiveValidator {
 		return this.addMutator(toFixedMutator, { decimals });
 	}
 	/**
+	* Opt in to coercion: a numeric-shaped string is converted to a number
+	* **before** the type rules run; any other value passes through unchanged
+	* so bad input still fails the type rule.
+	*
+	* Strictness is preserved — coercion only fixes the string *representation*,
+	* not the value's shape. `v.int().coerce()` turns `"5"` into `5` (valid) but
+	* `"5.5"` into `5.5`, which still fails the integer rule. Number validators
+	* do **not** coerce by default; this only takes effect when explicitly chained.
+	*
+	* The output type is unchanged (`Infer<>` keys off the validator class), so
+	* `v.int().coerce()` still infers `number`.
+	*
+	* @example
+	* v.int().coerce()      // "5" → 5 (valid); "5.5" → 5.5 (invalid); "abc" → invalid
+	* v.number().coerce()   // "5.5" → 5.5 (valid)
+	*/
+	coerce() {
+		return this.addMutator(numericMutator);
+	}
+	/**
 	* @inheritdoc
 	*
 	* Returns `{ type: "number" }` with numeric constraint keywords.