bguard 0.7.0 → 0.7.1

package/README.md

@@ -722,29 +722,47 @@ message that came from `address.street`. `treeifyErrors` keeps the full structur
 For input that does not arrive already typed — query strings, form data, environment variables.
 
 ```typeScript
-import { coerce } from 'bguard/coerce';
+import { coerceNumber } from 'bguard/coerce/number';
+import { coerceBoolean } from 'bguard/coerce/boolean';
 import { object } from 'bguard/object';
 import { parseOrFail } from 'bguard';
 
 const querySchema = object({
-  page: coerce.number().default(1),
-  limit: coerce.number(),
-  active: coerce.boolean(),
+  page: coerceNumber().default(1),
+  limit: coerceNumber(),
+  active: coerceBoolean(),
 });
 
 parseOrFail(querySchema, { limit: '20', active: 'true' });
 // { page: 1, limit: 20, active: true }
 ```
 
-`coerce.string()`, `coerce.number()`, `coerce.boolean()`, `coerce.bigint()` and `coerce.date()` convert
-the value before validating it. Anything a helper cannot convert is left alone, so validation reports
-the type problem rather than the conversion silently succeeding: `coerce.number()` on `'abc'` fails,
-because `Number('abc')` is `NaN` and `number()` rejects that.
+`coerceString`, `coerceNumber`, `coerceBoolean`, `coerceBigInt` and `coerceDate` convert the value
+before validating it. Each lives in its own module — `bguard/coerce/number` and so on — like every other
+assertion in the package.
+
+They are also gathered on a `coerce` object for when several read better together:
+
+```typeScript
+import { coerce } from 'bguard/coerce';
+import { object } from 'bguard/object';
+
+object({ page: coerce.number(), q: coerce.string() });
+```
+
+> **Notice:** that object references all five, so a bundler has to keep all five wherever it is used.
+> Reaching for `coerce.number()` alone still pulls in the string, boolean, bigint and date schemas —
+> measured at 2033 bytes against 87 for importing `coerceNumber` from its own module. Import the one you
+> need when bundle size matters.
+
+Anything a helper cannot convert is left alone, so validation reports the type problem rather than the conversion silently
+succeeding: `coerceNumber()` on `'abc'` fails, because `Number('abc')` is `NaN` and `number()` rejects
+that.
 
 `null` is never coerced, so `nullable()` still decides whether it is allowed instead of it becoming the
 string `'null'` or the number `0`.
 
-> **Notice:** `coerce.boolean()` only converts what unambiguously means a boolean — the strings
+> **Notice:** `coerceBoolean()` only converts what unambiguously means a boolean — the strings
 > `'true'` and `'false'` in any case, and the numbers `1` and `0`. Everything else is rejected. This is
 > deliberately narrower than passing the value through `Boolean`, which would accept every input and
 > read `'false'` as `true`.
@@ -755,12 +773,12 @@ string `'null'` or the number `0`.
 *accepts*. The two differ wherever a schema converts or supplies something:
 
 ```typeScript
-import { coerce } from 'bguard/coerce';
+import { coerceNumber } from 'bguard/coerce/number';
 import { object } from 'bguard/object';
 import { string } from 'bguard/string';
 import type { InferType, InferInput } from 'bguard/InferType';
 
-const schema = object({ page: coerce.number().default(1), q: string() });
+const schema = object({ page: coerceNumber().default(1), q: string() });
 
 type Output = InferType<typeof schema>;   // { page: number; q: string }
 type Input = InferInput<typeof schema>;   // { q: string; page?: unknown }

package/lib/asserts/array/index.d.mts

@@ -23,4 +23,4 @@ declare class ArraySchema extends CommonSchema {
     private validateArrayEntry;
 }
 
-export { array };
+export { ArraySchema, array };

package/lib/asserts/array/index.d.ts

@@ -23,4 +23,4 @@ declare class ArraySchema extends CommonSchema {
     private validateArrayEntry;
 }
 
-export { array };
+export { ArraySchema, array };

package/lib/asserts/array/index.js

@@ -1,6 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkEJCCIGXHjs = require('../../chunk-EJCCIGXH.js');
+
+var _chunkAGB5RWYDjs = require('../../chunk-AGB5RWYD.js');
 require('../../chunk-6LUSV3SS.js');
 require('../../chunk-ZJGY6EOE.js');
 require('../../chunk-VBTWYDEM.js');
@@ -8,5 +9,6 @@ require('../../chunk-LHEU4XAC.js');
 require('../../chunk-ZWFSAKQK.js');
 
 
-exports.array = _chunkEJCCIGXHjs.array;
+
+exports.ArraySchema = _chunkAGB5RWYDjs.ArraySchema; exports.array = _chunkAGB5RWYDjs.array;
 //# sourceMappingURL=index.js.map

package/lib/asserts/array/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/array/index.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,uCAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/array/index.js"}
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/array/index.js"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACA;AACF,2FAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/array/index.js"}

package/lib/asserts/array/index.mjs

@@ -1,12 +1,14 @@
 import {
+  ArraySchema,
   array
-} from "../../chunk-B2R5S6OH.mjs";
+} from "../../chunk-A2LPSUNQ.mjs";
 import "../../chunk-LDZFOOWN.mjs";
 import "../../chunk-65X7NTUS.mjs";
 import "../../chunk-YBVMP4EI.mjs";
 import "../../chunk-C76DLZFD.mjs";
 import "../../chunk-O2WD4JBG.mjs";
 export {
+  ArraySchema,
   array
 };
 //# sourceMappingURL=index.mjs.map

package/lib/asserts/bigint/index.d.mts

@@ -48,4 +48,4 @@ declare class BigIntSchema extends CommonSchema {
     private limitGuard;
 }
 
-export { bigint };
+export { BigIntSchema, bigint };

package/lib/asserts/bigint/index.d.ts

@@ -48,4 +48,4 @@ declare class BigIntSchema extends CommonSchema {
     private limitGuard;
 }
 
-export { bigint };
+export { BigIntSchema, bigint };

package/lib/asserts/bigint/index.js

@@ -1,8 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkL7YFDMZUjs = require('../../chunk-L7YFDMZU.js');
-require('../../chunk-3D6TPN7F.js');
+
+var _chunkWH7WJMFFjs = require('../../chunk-WH7WJMFF.js');
 require('../../chunk-OPA6AXSH.js');
+require('../../chunk-3D6TPN7F.js');
 require('../../chunk-FTHEF6SB.js');
 require('../../chunk-6LUSV3SS.js');
 require('../../chunk-ZJGY6EOE.js');
@@ -11,5 +12,6 @@ require('../../chunk-LHEU4XAC.js');
 require('../../chunk-ZWFSAKQK.js');
 
 
-exports.bigint = _chunkL7YFDMZUjs.bigint;
+
+exports.BigIntSchema = _chunkWH7WJMFFjs.BigIntSchema; exports.bigint = _chunkWH7WJMFFjs.bigint;
 //# sourceMappingURL=index.js.map

package/lib/asserts/bigint/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/bigint/index.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,yCAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/bigint/index.js"}
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/bigint/index.js"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACA;AACF,+FAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/bigint/index.js"}

package/lib/asserts/bigint/index.mjs

@@ -1,8 +1,9 @@
 import {
+  BigIntSchema,
   bigint
-} from "../../chunk-UWONIZJZ.mjs";
-import "../../chunk-D42AL6CN.mjs";
+} from "../../chunk-5PXMSVTE.mjs";
 import "../../chunk-YQP44G45.mjs";
+import "../../chunk-D42AL6CN.mjs";
 import "../../chunk-IIL6D2UL.mjs";
 import "../../chunk-LDZFOOWN.mjs";
 import "../../chunk-65X7NTUS.mjs";
@@ -10,6 +11,7 @@ import "../../chunk-YBVMP4EI.mjs";
 import "../../chunk-C76DLZFD.mjs";
 import "../../chunk-O2WD4JBG.mjs";
 export {
+  BigIntSchema,
   bigint
 };
 //# sourceMappingURL=index.mjs.map

package/lib/asserts/boolean/index.d.mts

@@ -45,4 +45,4 @@ declare class BooleanSchema extends CommonSchema {
     onlyFalse(): WithBGuardType<this, false>;
 }
 
-export { boolean };
+export { BooleanSchema, boolean };

package/lib/asserts/boolean/index.d.ts

@@ -45,4 +45,4 @@ declare class BooleanSchema extends CommonSchema {
     onlyFalse(): WithBGuardType<this, false>;
 }
 
-export { boolean };
+export { BooleanSchema, boolean };

package/lib/asserts/boolean/index.js

@@ -1,6 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkGYLCPX6Ojs = require('../../chunk-GYLCPX6O.js');
+
+var _chunk23R5R7PLjs = require('../../chunk-23R5R7PL.js');
 require('../../chunk-FTHEF6SB.js');
 require('../../chunk-6LUSV3SS.js');
 require('../../chunk-ZJGY6EOE.js');
@@ -9,5 +10,6 @@ require('../../chunk-LHEU4XAC.js');
 require('../../chunk-ZWFSAKQK.js');
 
 
-exports.boolean = _chunkGYLCPX6Ojs.boolean;
+
+exports.BooleanSchema = _chunk23R5R7PLjs.BooleanSchema; exports.boolean = _chunk23R5R7PLjs.boolean;
 //# sourceMappingURL=index.js.map

package/lib/asserts/boolean/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/boolean/index.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,2CAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/boolean/index.js"}
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/boolean/index.js"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACA;AACF,mGAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/boolean/index.js"}

package/lib/asserts/boolean/index.mjs

@@ -1,6 +1,7 @@
 import {
+  BooleanSchema,
   boolean
-} from "../../chunk-5VZDHJKM.mjs";
+} from "../../chunk-KGXWQ3XP.mjs";
 import "../../chunk-IIL6D2UL.mjs";
 import "../../chunk-LDZFOOWN.mjs";
 import "../../chunk-65X7NTUS.mjs";
@@ -8,6 +9,7 @@ import "../../chunk-YBVMP4EI.mjs";
 import "../../chunk-C76DLZFD.mjs";
 import "../../chunk-O2WD4JBG.mjs";
 export {
+  BooleanSchema,
   boolean
 };
 //# sourceMappingURL=index.mjs.map

package/lib/asserts/coerce/bigint.d.mts

@@ -0,0 +1,32 @@
+import { WithInput, WithBGuardType } from '../../commonTypes.mjs';
+import { BigIntSchema } from '../bigint/index.mjs';
+import '../../core.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
+
+/**
+ * A coercing transform must never throw: it runs before validation, and throwing would replace a clear
+ * validation error with an unexplained failure. Anything it cannot convert is passed through unchanged
+ * so that validation reports the type problem itself.
+ *
+ * `null` is never coerced, so `nullable()` still decides whether it is allowed rather than it becoming
+ * the string `'null'` or the number `0`.
+ *
+ * The return type is inferred rather than written out. Naming it flattened the schema to
+ * `CommonSchema`, which silently dropped the methods only the concrete classes define — `equalTo`,
+ * `oneOfValues`, `onlyTrue`, `onlyFalse`.
+ */
+/**
+ * @description Coerces the received value to a bigint before validating it.
+ *
+ * `BigInt` throws on a value it cannot read, so the original is kept for validation to reject rather
+ * than the error escaping.
+ *
+ * @returns A bigint schema that accepts `unknown` as its input type.
+ * @example
+ * parseOrFail(coerceBigInt(), '42'); // 42n
+ */
+declare const coerceBigInt: () => WithInput<WithBGuardType<BigIntSchema, bigint>, unknown>;
+
+export { coerceBigInt };

package/lib/asserts/coerce/bigint.d.ts

@@ -0,0 +1,32 @@
+import { WithInput, WithBGuardType } from '../../commonTypes.js';
+import { BigIntSchema } from '../bigint/index.js';
+import '../../core.js';
+import '../../InferType.js';
+import '../../helpers/constants.js';
+import '../../standardSchema.js';
+
+/**
+ * A coercing transform must never throw: it runs before validation, and throwing would replace a clear
+ * validation error with an unexplained failure. Anything it cannot convert is passed through unchanged
+ * so that validation reports the type problem itself.
+ *
+ * `null` is never coerced, so `nullable()` still decides whether it is allowed rather than it becoming
+ * the string `'null'` or the number `0`.
+ *
+ * The return type is inferred rather than written out. Naming it flattened the schema to
+ * `CommonSchema`, which silently dropped the methods only the concrete classes define — `equalTo`,
+ * `oneOfValues`, `onlyTrue`, `onlyFalse`.
+ */
+/**
+ * @description Coerces the received value to a bigint before validating it.
+ *
+ * `BigInt` throws on a value it cannot read, so the original is kept for validation to reject rather
+ * than the error escaping.
+ *
+ * @returns A bigint schema that accepts `unknown` as its input type.
+ * @example
+ * parseOrFail(coerceBigInt(), '42'); // 42n
+ */
+declare const coerceBigInt: () => WithInput<WithBGuardType<BigIntSchema, bigint>, unknown>;
+
+export { coerceBigInt };

package/lib/asserts/coerce/bigint.js

@@ -0,0 +1,16 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkWLZZTIOVjs = require('../../chunk-WLZZTIOV.js');
+require('../../chunk-WH7WJMFF.js');
+require('../../chunk-OPA6AXSH.js');
+require('../../chunk-3D6TPN7F.js');
+require('../../chunk-FTHEF6SB.js');
+require('../../chunk-6LUSV3SS.js');
+require('../../chunk-ZJGY6EOE.js');
+require('../../chunk-VBTWYDEM.js');
+require('../../chunk-LHEU4XAC.js');
+require('../../chunk-ZWFSAKQK.js');
+
+
+exports.coerceBigInt = _chunkWLZZTIOVjs.coerceBigInt;
+//# sourceMappingURL=bigint.js.map

package/lib/asserts/coerce/bigint.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/coerce/bigint.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,qDAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/coerce/bigint.js"}

package/lib/asserts/coerce/bigint.mjs

@@ -0,0 +1,16 @@
+import {
+  coerceBigInt
+} from "../../chunk-ET2I4EXQ.mjs";
+import "../../chunk-5PXMSVTE.mjs";
+import "../../chunk-YQP44G45.mjs";
+import "../../chunk-D42AL6CN.mjs";
+import "../../chunk-IIL6D2UL.mjs";
+import "../../chunk-LDZFOOWN.mjs";
+import "../../chunk-65X7NTUS.mjs";
+import "../../chunk-YBVMP4EI.mjs";
+import "../../chunk-C76DLZFD.mjs";
+import "../../chunk-O2WD4JBG.mjs";
+export {
+  coerceBigInt
+};
+//# sourceMappingURL=bigint.mjs.map

package/lib/asserts/coerce/bigint.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/lib/asserts/coerce/boolean.d.mts

@@ -0,0 +1,35 @@
+import { WithInput, WithBGuardType } from '../../commonTypes.mjs';
+import { BooleanSchema } from '../boolean/index.mjs';
+import '../../core.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
+
+/**
+ * A coercing transform must never throw: it runs before validation, and throwing would replace a clear
+ * validation error with an unexplained failure. Anything it cannot convert is passed through unchanged
+ * so that validation reports the type problem itself.
+ *
+ * `null` is never coerced, so `nullable()` still decides whether it is allowed rather than it becoming
+ * the string `'null'` or the number `0`.
+ *
+ * The return type is inferred rather than written out. Naming it flattened the schema to
+ * `CommonSchema`, which silently dropped the methods only the concrete classes define — `equalTo`,
+ * `oneOfValues`, `onlyTrue`, `onlyFalse`.
+ */
+/**
+ * @description Coerces the received value to a boolean before validating it.
+ *
+ * Only the values that unambiguously mean a boolean are converted: the strings `'true'` and `'false'`
+ * in any case, and the numbers `1` and `0`. Everything else is left for validation to reject.
+ *
+ * Deliberately narrower than passing the value through `Boolean`, which would accept every input and
+ * quietly read `'false'` as `true`.
+ *
+ * @returns A boolean schema that accepts `unknown` as its input type.
+ * @example
+ * parseOrFail(coerceBoolean(), 'false'); // false
+ */
+declare const coerceBoolean: () => WithInput<WithBGuardType<BooleanSchema, boolean>, unknown>;
+
+export { coerceBoolean };

package/lib/asserts/coerce/boolean.d.ts

@@ -0,0 +1,35 @@
+import { WithInput, WithBGuardType } from '../../commonTypes.js';
+import { BooleanSchema } from '../boolean/index.js';
+import '../../core.js';
+import '../../InferType.js';
+import '../../helpers/constants.js';
+import '../../standardSchema.js';
+
+/**
+ * A coercing transform must never throw: it runs before validation, and throwing would replace a clear
+ * validation error with an unexplained failure. Anything it cannot convert is passed through unchanged
+ * so that validation reports the type problem itself.
+ *
+ * `null` is never coerced, so `nullable()` still decides whether it is allowed rather than it becoming
+ * the string `'null'` or the number `0`.
+ *
+ * The return type is inferred rather than written out. Naming it flattened the schema to
+ * `CommonSchema`, which silently dropped the methods only the concrete classes define — `equalTo`,
+ * `oneOfValues`, `onlyTrue`, `onlyFalse`.
+ */
+/**
+ * @description Coerces the received value to a boolean before validating it.
+ *
+ * Only the values that unambiguously mean a boolean are converted: the strings `'true'` and `'false'`
+ * in any case, and the numbers `1` and `0`. Everything else is left for validation to reject.
+ *
+ * Deliberately narrower than passing the value through `Boolean`, which would accept every input and
+ * quietly read `'false'` as `true`.
+ *
+ * @returns A boolean schema that accepts `unknown` as its input type.
+ * @example
+ * parseOrFail(coerceBoolean(), 'false'); // false
+ */
+declare const coerceBoolean: () => WithInput<WithBGuardType<BooleanSchema, boolean>, unknown>;
+
+export { coerceBoolean };

package/lib/asserts/coerce/boolean.js

@@ -0,0 +1,14 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunk56TWNROCjs = require('../../chunk-56TWNROC.js');
+require('../../chunk-23R5R7PL.js');
+require('../../chunk-FTHEF6SB.js');
+require('../../chunk-6LUSV3SS.js');
+require('../../chunk-ZJGY6EOE.js');
+require('../../chunk-VBTWYDEM.js');
+require('../../chunk-LHEU4XAC.js');
+require('../../chunk-ZWFSAKQK.js');
+
+
+exports.coerceBoolean = _chunk56TWNROCjs.coerceBoolean;
+//# sourceMappingURL=boolean.js.map

package/lib/asserts/coerce/boolean.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/coerce/boolean.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,uDAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/coerce/boolean.js"}

package/lib/asserts/coerce/boolean.mjs

@@ -0,0 +1,14 @@
+import {
+  coerceBoolean
+} from "../../chunk-FA3S35LQ.mjs";
+import "../../chunk-KGXWQ3XP.mjs";
+import "../../chunk-IIL6D2UL.mjs";
+import "../../chunk-LDZFOOWN.mjs";
+import "../../chunk-65X7NTUS.mjs";
+import "../../chunk-YBVMP4EI.mjs";
+import "../../chunk-C76DLZFD.mjs";
+import "../../chunk-O2WD4JBG.mjs";
+export {
+  coerceBoolean
+};
+//# sourceMappingURL=boolean.mjs.map

package/lib/asserts/coerce/boolean.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/lib/asserts/coerce/date.d.mts

@@ -0,0 +1,32 @@
+import { WithInput, WithBGuardType } from '../../commonTypes.mjs';
+import { DateSchema } from '../date/index.mjs';
+import '../../core.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
+
+/**
+ * A coercing transform must never throw: it runs before validation, and throwing would replace a clear
+ * validation error with an unexplained failure. Anything it cannot convert is passed through unchanged
+ * so that validation reports the type problem itself.
+ *
+ * `null` is never coerced, so `nullable()` still decides whether it is allowed rather than it becoming
+ * the string `'null'` or the number `0`.
+ *
+ * The return type is inferred rather than written out. Naming it flattened the schema to
+ * `CommonSchema`, which silently dropped the methods only the concrete classes define — `equalTo`,
+ * `oneOfValues`, `onlyTrue`, `onlyFalse`.
+ */
+/**
+ * @description Coerces the received value to a Date before validating it. Anything that is not already
+ * a Date is passed through `new Date`.
+ *
+ * An unreadable value becomes an invalid Date, which `date()` rejects.
+ *
+ * @returns A date schema that accepts `unknown` as its input type.
+ * @example
+ * parseOrFail(coerceDate(), '2024-01-01'); // Date
+ */
+declare const coerceDate: () => WithInput<WithBGuardType<DateSchema, Date>, unknown>;
+
+export { coerceDate };

package/lib/asserts/coerce/date.d.ts

@@ -0,0 +1,32 @@
+import { WithInput, WithBGuardType } from '../../commonTypes.js';
+import { DateSchema } from '../date/index.js';
+import '../../core.js';
+import '../../InferType.js';
+import '../../helpers/constants.js';
+import '../../standardSchema.js';
+
+/**
+ * A coercing transform must never throw: it runs before validation, and throwing would replace a clear
+ * validation error with an unexplained failure. Anything it cannot convert is passed through unchanged
+ * so that validation reports the type problem itself.
+ *
+ * `null` is never coerced, so `nullable()` still decides whether it is allowed rather than it becoming
+ * the string `'null'` or the number `0`.
+ *
+ * The return type is inferred rather than written out. Naming it flattened the schema to
+ * `CommonSchema`, which silently dropped the methods only the concrete classes define — `equalTo`,
+ * `oneOfValues`, `onlyTrue`, `onlyFalse`.
+ */
+/**
+ * @description Coerces the received value to a Date before validating it. Anything that is not already
+ * a Date is passed through `new Date`.
+ *
+ * An unreadable value becomes an invalid Date, which `date()` rejects.
+ *
+ * @returns A date schema that accepts `unknown` as its input type.
+ * @example
+ * parseOrFail(coerceDate(), '2024-01-01'); // Date
+ */
+declare const coerceDate: () => WithInput<WithBGuardType<DateSchema, Date>, unknown>;
+
+export { coerceDate };

package/lib/asserts/coerce/date.js

@@ -0,0 +1,13 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkK7CDOU6Fjs = require('../../chunk-K7CDOU6F.js');
+require('../../chunk-YPOEO3UF.js');
+require('../../chunk-6LUSV3SS.js');
+require('../../chunk-ZJGY6EOE.js');
+require('../../chunk-VBTWYDEM.js');
+require('../../chunk-LHEU4XAC.js');
+require('../../chunk-ZWFSAKQK.js');
+
+
+exports.coerceDate = _chunkK7CDOU6Fjs.coerceDate;
+//# sourceMappingURL=date.js.map

package/lib/asserts/coerce/date.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/coerce/date.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,iDAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/coerce/date.js"}

package/lib/asserts/coerce/date.mjs

@@ -0,0 +1,13 @@
+import {
+  coerceDate
+} from "../../chunk-MUXY6Q45.mjs";
+import "../../chunk-FU5WAVRB.mjs";
+import "../../chunk-LDZFOOWN.mjs";
+import "../../chunk-65X7NTUS.mjs";
+import "../../chunk-YBVMP4EI.mjs";
+import "../../chunk-C76DLZFD.mjs";
+import "../../chunk-O2WD4JBG.mjs";
+export {
+  coerceDate
+};
+//# sourceMappingURL=date.mjs.map

package/lib/asserts/coerce/date.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}