bguard 0.5.0 → 0.7.0

package/lib/asserts/bigint/bigintMaxExcluded.mjs

@@ -1,17 +1,8 @@
 import {
-  setToDefaultLocale
-} from "../../chunk-QWPHP26D.mjs";
-import "../../chunk-ZTCXXAKD.mjs";
-
-// src/asserts/bigint/bigintMaxExcluded.ts
-var bigintMaxExcludedErrorMessage = "The received value is greater than or equal to expected";
-var bigintMaxExcludedErrorKey = "bi:maxExcluded";
-var bigintMaxExcluded = (expected) => (received, ctx) => {
-  if (expected <= received) ctx.addIssue(expected, received, bigintMaxExcludedErrorKey);
-};
-bigintMaxExcluded.key = bigintMaxExcludedErrorKey;
-bigintMaxExcluded.message = bigintMaxExcludedErrorMessage;
-setToDefaultLocale(bigintMaxExcluded);
+  bigintMaxExcluded
+} from "../../chunk-346TIMNH.mjs";
+import "../../chunk-65X7NTUS.mjs";
+import "../../chunk-O2WD4JBG.mjs";
 export {
   bigintMaxExcluded
 };

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/asserts/bigint/bigintMaxExcluded.ts"],"sourcesContent":["import { setToDefaultLocale } from '../../translationMap';\nimport { ExceptionContext, RequiredValidation } from '../../ExceptionContext';\n\nconst bigintMaxExcludedErrorMessage = 'The received value is greater than or equal to expected';\nconst bigintMaxExcludedErrorKey = 'bi:maxExcluded';\n\n/**\n * @description - Asserts that a bigint value is strictly less than a specified maximum value (i.e., the maximum value is excluded).\n * @param {bigint} expected - The maximum allowable value, which is excluded.\n * @returns {RequiredValidation} -  A validation function that takes a received bigint and an exception context.\n * @throws {ValidationError} if the received value is greater than or equal to the expected maximum value.\n * @example\n * const schema = bigint().custom(bigintMaxExcluded(100n));\n * parseOrFail(schema, 99n);  // Valid\n * parseOrFail(schema, 100n); // Throws an error: 'The received value is greater than or equal to expected'\n * parseOrFail(schema, 101n); // Throws an error: 'The received value is greater than or equal to expected'\n *\n * @translation Error Translation Key = 'bi:maxExcluded'\n */\nexport const bigintMaxExcluded =\n  (expected: bigint): RequiredValidation =>\n  (received: bigint, ctx: ExceptionContext) => {\n    if (expected <= received) ctx.addIssue(expected, received, bigintMaxExcludedErrorKey);\n  };\n\nbigintMaxExcluded.key = bigintMaxExcludedErrorKey;\nbigintMaxExcluded.message = bigintMaxExcludedErrorMessage;\nsetToDefaultLocale(bigintMaxExcluded);\n"],"mappings":";;;;;;AAGA,IAAM,gCAAgC;AACtC,IAAM,4BAA4B;AAe3B,IAAM,oBACX,CAAC,aACD,CAAC,UAAkB,QAA0B;AAC3C,MAAI,YAAY,SAAU,KAAI,SAAS,UAAU,UAAU,yBAAyB;AACtF;AAEF,kBAAkB,MAAM;AACxB,kBAAkB,UAAU;AAC5B,mBAAmB,iBAAiB;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -1,5 +1,8 @@
-import { RequiredValidation } from '../../ExceptionContext.mjs';
+import { RequiredValidation } from '../../core.mjs';
 import '../../commonTypes.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
 
 /**
  * @description Asserts that a bigint value is not less than a specified minimum value.
@@ -15,7 +18,7 @@ import '../../commonTypes.mjs';
  * @translation Error Translation Key = 'bi:min'
  */
 declare const bigintMin: {
-    (expected: bigint): RequiredValidation;
+    (expected: bigint): RequiredValidation<bigint>;
     key: string;
     message: string;
 };

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

@@ -1,5 +1,8 @@
-import { RequiredValidation } from '../../ExceptionContext.js';
+import { RequiredValidation } from '../../core.js';
 import '../../commonTypes.js';
+import '../../InferType.js';
+import '../../helpers/constants.js';
+import '../../standardSchema.js';
 
 /**
  * @description Asserts that a bigint value is not less than a specified minimum value.
@@ -15,7 +18,7 @@ import '../../commonTypes.js';
  * @translation Error Translation Key = 'bi:min'
  */
 declare const bigintMin: {
-    (expected: bigint): RequiredValidation;
+    (expected: bigint): RequiredValidation<bigint>;
     key: string;
     message: string;
 };

package/lib/asserts/bigint/bigintMin.js

@@ -1,18 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkEXVTHIT5js = require('../../chunk-EXVTHIT5.js');
-require('../../chunk-FIDPCCCW.js');
+var _chunkORQBVFHYjs = require('../../chunk-ORQBVFHY.js');
+require('../../chunk-ZJGY6EOE.js');
+require('../../chunk-ZWFSAKQK.js');
 
-// src/asserts/bigint/bigintMin.ts
-var bigintMinErrorMessage = "The received value is less than expected";
-var bigintMinErrorKey = "bi:min";
-var bigintMin = (expected) => (received, ctx) => {
-  if (expected > received) ctx.addIssue(expected, received, bigintMinErrorKey);
-};
-bigintMin.key = bigintMinErrorKey;
-bigintMin.message = bigintMinErrorMessage;
-_chunkEXVTHIT5js.setToDefaultLocale.call(void 0, bigintMin);
 
-
-exports.bigintMin = bigintMin;
+exports.bigintMin = _chunkORQBVFHYjs.bigintMin;
 //# sourceMappingURL=bigintMin.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/bigint/bigintMin.js","../../../src/asserts/bigint/bigintMin.ts"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC;AACA;ACFA,IAAM,sBAAA,EAAwB,0CAAA;AAC9B,IAAM,kBAAA,EAAoB,QAAA;AAenB,IAAM,UAAA,EACX,CAAC,QAAA,EAAA,GACD,CAAC,QAAA,EAAkB,GAAA,EAAA,GAA0B;AAC3C,EAAA,GAAA,CAAI,SAAA,EAAW,QAAA,EAAU,GAAA,CAAI,QAAA,CAAS,QAAA,EAAU,QAAA,EAAU,iBAAiB,CAAA;AAC7E,CAAA;AAEF,SAAA,CAAU,IAAA,EAAM,iBAAA;AAChB,SAAA,CAAU,QAAA,EAAU,qBAAA;AACpB,iDAAA,SAA4B,CAAA;ADb5B;AACE;AACF,8BAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/bigint/bigintMin.js","sourcesContent":[null,"import { setToDefaultLocale } from '../../translationMap';\nimport { ExceptionContext, RequiredValidation } from '../../ExceptionContext';\n\nconst bigintMinErrorMessage = 'The received value is less than expected';\nconst bigintMinErrorKey = 'bi:min';\n\n/**\n * @description Asserts that a bigint value is not less than a specified minimum value.\n * @param {bigint} expected The minimum allowable value.\n * @returns {RequiredValidation} A validation function that takes a received bigint and an exception context.\n * @throws {ValidationError} if the received value is less than the expected minimum value.\n * @example\n * const schema = bigint().custom(bigintMin(10n));\n * parseOrFail(schema, 11n);  // Valid\n * parseOrFail(schema, 10n);  // Valid\n * parseOrFail(schema, 9n);   // Throws an error: 'The received value is less than expected'\n *\n * @translation Error Translation Key = 'bi:min'\n */\nexport const bigintMin =\n  (expected: bigint): RequiredValidation =>\n  (received: bigint, ctx: ExceptionContext) => {\n    if (expected > received) ctx.addIssue(expected, received, bigintMinErrorKey);\n  };\n\nbigintMin.key = bigintMinErrorKey;\nbigintMin.message = bigintMinErrorMessage;\nsetToDefaultLocale(bigintMin);\n"]}
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/bigint/bigintMin.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,+CAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/bigint/bigintMin.js"}

package/lib/asserts/bigint/bigintMin.mjs

@@ -1,17 +1,8 @@
 import {
-  setToDefaultLocale
-} from "../../chunk-QWPHP26D.mjs";
-import "../../chunk-ZTCXXAKD.mjs";
-
-// src/asserts/bigint/bigintMin.ts
-var bigintMinErrorMessage = "The received value is less than expected";
-var bigintMinErrorKey = "bi:min";
-var bigintMin = (expected) => (received, ctx) => {
-  if (expected > received) ctx.addIssue(expected, received, bigintMinErrorKey);
-};
-bigintMin.key = bigintMinErrorKey;
-bigintMin.message = bigintMinErrorMessage;
-setToDefaultLocale(bigintMin);
+  bigintMin
+} from "../../chunk-H3FXZTYS.mjs";
+import "../../chunk-65X7NTUS.mjs";
+import "../../chunk-O2WD4JBG.mjs";
 export {
   bigintMin
 };

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/asserts/bigint/bigintMin.ts"],"sourcesContent":["import { setToDefaultLocale } from '../../translationMap';\nimport { ExceptionContext, RequiredValidation } from '../../ExceptionContext';\n\nconst bigintMinErrorMessage = 'The received value is less than expected';\nconst bigintMinErrorKey = 'bi:min';\n\n/**\n * @description Asserts that a bigint value is not less than a specified minimum value.\n * @param {bigint} expected The minimum allowable value.\n * @returns {RequiredValidation} A validation function that takes a received bigint and an exception context.\n * @throws {ValidationError} if the received value is less than the expected minimum value.\n * @example\n * const schema = bigint().custom(bigintMin(10n));\n * parseOrFail(schema, 11n);  // Valid\n * parseOrFail(schema, 10n);  // Valid\n * parseOrFail(schema, 9n);   // Throws an error: 'The received value is less than expected'\n *\n * @translation Error Translation Key = 'bi:min'\n */\nexport const bigintMin =\n  (expected: bigint): RequiredValidation =>\n  (received: bigint, ctx: ExceptionContext) => {\n    if (expected > received) ctx.addIssue(expected, received, bigintMinErrorKey);\n  };\n\nbigintMin.key = bigintMinErrorKey;\nbigintMin.message = bigintMinErrorMessage;\nsetToDefaultLocale(bigintMin);\n"],"mappings":";;;;;;AAGA,IAAM,wBAAwB;AAC9B,IAAM,oBAAoB;AAenB,IAAM,YACX,CAAC,aACD,CAAC,UAAkB,QAA0B;AAC3C,MAAI,WAAW,SAAU,KAAI,SAAS,UAAU,UAAU,iBAAiB;AAC7E;AAEF,UAAU,MAAM;AAChB,UAAU,UAAU;AACpB,mBAAmB,SAAS;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -1,5 +1,8 @@
-import { RequiredValidation } from '../../ExceptionContext.mjs';
+import { RequiredValidation } from '../../core.mjs';
 import '../../commonTypes.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
 
 /**
  * @description Asserts that a bigint value is strictly greater than a specified minimum value (i.e., the minimum value is excluded).
@@ -15,7 +18,7 @@ import '../../commonTypes.mjs';
  * @translation Error Translation Key = 'bi:minExcluded'
  */
 declare const bigintMinExcluded: {
-    (expected: bigint): RequiredValidation;
+    (expected: bigint): RequiredValidation<bigint>;
     key: string;
     message: string;
 };

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

@@ -1,5 +1,8 @@
-import { RequiredValidation } from '../../ExceptionContext.js';
+import { RequiredValidation } from '../../core.js';
 import '../../commonTypes.js';
+import '../../InferType.js';
+import '../../helpers/constants.js';
+import '../../standardSchema.js';
 
 /**
  * @description Asserts that a bigint value is strictly greater than a specified minimum value (i.e., the minimum value is excluded).
@@ -15,7 +18,7 @@ import '../../commonTypes.js';
  * @translation Error Translation Key = 'bi:minExcluded'
  */
 declare const bigintMinExcluded: {
-    (expected: bigint): RequiredValidation;
+    (expected: bigint): RequiredValidation<bigint>;
     key: string;
     message: string;
 };

package/lib/asserts/bigint/bigintMinExcluded.js

@@ -1,18 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkEXVTHIT5js = require('../../chunk-EXVTHIT5.js');
-require('../../chunk-FIDPCCCW.js');
+var _chunkGSLVYDXOjs = require('../../chunk-GSLVYDXO.js');
+require('../../chunk-ZJGY6EOE.js');
+require('../../chunk-ZWFSAKQK.js');
 
-// src/asserts/bigint/bigintMinExcluded.ts
-var bigintMinExcludedErrorMessage = "The received value is less than or equal to expected";
-var bigintMinExcludedErrorKey = "bi:minExcluded";
-var bigintMinExcluded = (expected) => (received, ctx) => {
-  if (expected >= received) ctx.addIssue(expected, received, bigintMinExcludedErrorKey);
-};
-bigintMinExcluded.key = bigintMinExcludedErrorKey;
-bigintMinExcluded.message = bigintMinExcludedErrorMessage;
-_chunkEXVTHIT5js.setToDefaultLocale.call(void 0, bigintMinExcluded);
 
-
-exports.bigintMinExcluded = bigintMinExcluded;
+exports.bigintMinExcluded = _chunkGSLVYDXOjs.bigintMinExcluded;
 //# sourceMappingURL=bigintMinExcluded.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/bigint/bigintMinExcluded.js","../../../src/asserts/bigint/bigintMinExcluded.ts"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC;AACA;ACFA,IAAM,8BAAA,EAAgC,sDAAA;AACtC,IAAM,0BAAA,EAA4B,gBAAA;AAe3B,IAAM,kBAAA,EACX,CAAC,QAAA,EAAA,GACD,CAAC,QAAA,EAAkB,GAAA,EAAA,GAA0B;AAC3C,EAAA,GAAA,CAAI,SAAA,GAAY,QAAA,EAAU,GAAA,CAAI,QAAA,CAAS,QAAA,EAAU,QAAA,EAAU,yBAAyB,CAAA;AACtF,CAAA;AAEF,iBAAA,CAAkB,IAAA,EAAM,yBAAA;AACxB,iBAAA,CAAkB,QAAA,EAAU,6BAAA;AAC5B,iDAAA,iBAAoC,CAAA;ADbpC;AACE;AACF,8CAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/bigint/bigintMinExcluded.js","sourcesContent":[null,"import { setToDefaultLocale } from '../../translationMap';\nimport { ExceptionContext, RequiredValidation } from '../../ExceptionContext';\n\nconst bigintMinExcludedErrorMessage = 'The received value is less than or equal to expected';\nconst bigintMinExcludedErrorKey = 'bi:minExcluded';\n\n/**\n * @description Asserts that a bigint value is strictly greater than a specified minimum value (i.e., the minimum value is excluded).\n * @param {bigint} expected The minimum allowable value, which is excluded.\n * @returns {RequiredValidation} A validation function that takes a received bigint and an exception context.\n * @throws {ValidationError} if the received value is less than or equal to the expected minimum value.\n * @example\n * const schema = bigint().custom(bigintMinExcluded(10n));\n * parseOrFail(schema, 11n);  // Valid\n * parseOrFail(schema, 10n); // Throws an error: 'The received value is less than or equal to expected'\n * parseOrFail(schema, 9n);  // Throws an error: 'The received value is less than or equal to expected'\n *\n * @translation Error Translation Key = 'bi:minExcluded'\n */\nexport const bigintMinExcluded =\n  (expected: bigint): RequiredValidation =>\n  (received: bigint, ctx: ExceptionContext) => {\n    if (expected >= received) ctx.addIssue(expected, received, bigintMinExcludedErrorKey);\n  };\n\nbigintMinExcluded.key = bigintMinExcludedErrorKey;\nbigintMinExcluded.message = bigintMinExcludedErrorMessage;\nsetToDefaultLocale(bigintMinExcluded);\n"]}
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/bigint/bigintMinExcluded.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,+DAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/bigint/bigintMinExcluded.js"}

package/lib/asserts/bigint/bigintMinExcluded.mjs

@@ -1,17 +1,8 @@
 import {
-  setToDefaultLocale
-} from "../../chunk-QWPHP26D.mjs";
-import "../../chunk-ZTCXXAKD.mjs";
-
-// src/asserts/bigint/bigintMinExcluded.ts
-var bigintMinExcludedErrorMessage = "The received value is less than or equal to expected";
-var bigintMinExcludedErrorKey = "bi:minExcluded";
-var bigintMinExcluded = (expected) => (received, ctx) => {
-  if (expected >= received) ctx.addIssue(expected, received, bigintMinExcludedErrorKey);
-};
-bigintMinExcluded.key = bigintMinExcludedErrorKey;
-bigintMinExcluded.message = bigintMinExcludedErrorMessage;
-setToDefaultLocale(bigintMinExcluded);
+  bigintMinExcluded
+} from "../../chunk-7F4P72SG.mjs";
+import "../../chunk-65X7NTUS.mjs";
+import "../../chunk-O2WD4JBG.mjs";
 export {
   bigintMinExcluded
 };

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/asserts/bigint/bigintMinExcluded.ts"],"sourcesContent":["import { setToDefaultLocale } from '../../translationMap';\nimport { ExceptionContext, RequiredValidation } from '../../ExceptionContext';\n\nconst bigintMinExcludedErrorMessage = 'The received value is less than or equal to expected';\nconst bigintMinExcludedErrorKey = 'bi:minExcluded';\n\n/**\n * @description Asserts that a bigint value is strictly greater than a specified minimum value (i.e., the minimum value is excluded).\n * @param {bigint} expected The minimum allowable value, which is excluded.\n * @returns {RequiredValidation} A validation function that takes a received bigint and an exception context.\n * @throws {ValidationError} if the received value is less than or equal to the expected minimum value.\n * @example\n * const schema = bigint().custom(bigintMinExcluded(10n));\n * parseOrFail(schema, 11n);  // Valid\n * parseOrFail(schema, 10n); // Throws an error: 'The received value is less than or equal to expected'\n * parseOrFail(schema, 9n);  // Throws an error: 'The received value is less than or equal to expected'\n *\n * @translation Error Translation Key = 'bi:minExcluded'\n */\nexport const bigintMinExcluded =\n  (expected: bigint): RequiredValidation =>\n  (received: bigint, ctx: ExceptionContext) => {\n    if (expected >= received) ctx.addIssue(expected, received, bigintMinExcludedErrorKey);\n  };\n\nbigintMinExcluded.key = bigintMinExcludedErrorKey;\nbigintMinExcluded.message = bigintMinExcludedErrorMessage;\nsetToDefaultLocale(bigintMinExcluded);\n"],"mappings":";;;;;;AAGA,IAAM,gCAAgC;AACtC,IAAM,4BAA4B;AAe3B,IAAM,oBACX,CAAC,aACD,CAAC,UAAkB,QAA0B;AAC3C,MAAI,YAAY,SAAU,KAAI,SAAS,UAAU,UAAU,yBAAyB;AACtF;AAEF,kBAAkB,MAAM;AACxB,kBAAkB,UAAU;AAC5B,mBAAmB,iBAAiB;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -1,11 +1,11 @@
 import { WithBGuardType } from '../../commonTypes.mjs';
-import { BigIntSchema } from '../../schemas/BigIntSchema.mjs';
-import '../../CommonSchema-BIfYCtcQ.mjs';
-import '../../ExceptionContext.mjs';
+import { CommonSchema } from '../../core.mjs';
 import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
 
 /**
- * @description Creates a new schema for validating bigint values.
+ * @description - Creates a new schema for validating bigint values.
  * @returns {WithBGuardType<BigIntSchema, bigint>} A new instance of `BigIntSchema` for validating bigints.
  * @example
  * const schema = bigint();
@@ -16,5 +16,36 @@ import '../../InferType.mjs';
  * @instance Of BigIntSchema
  */
 declare function bigint(): WithBGuardType<BigIntSchema, bigint>;
+declare class BigIntSchema extends CommonSchema {
+    protected _bigint: number;
+    private limit;
+    /**
+     * @method equalTo
+     * @description Restricts the schema to exactly match the specified value and infers the literal value as the TypeScript type.
+     * @param expectedValue - The value that the schema must exactly match.
+     * @returns A new schema restricted to the specified value, with the literal value inferred as the TypeScript type
+     * @example
+     * bigint().equalTo(42n); // Infers the type 42n
+     *
+     * @public
+     */
+    equalTo<Y extends bigint>(expectedValue: Y): WithBGuardType<this, Y>;
+    /**
+     * @method oneOfValues
+     * @description Restricts the schema to match one of the specified values and infers the union of those values as the TypeScript type.
+     * @param expectedValues - An array of values that the schema can match.
+     * @returns A new schema restricted to one of the specified values, with the union of those values inferred as the TypeScript type.
+     * @example
+     * bigint().oneOfValues([5n, 7n]); // Infers the type 5n | 7n
+     *
+     * @public
+     */
+    oneOfValues<Y extends bigint>(expectedValue: Y[]): WithBGuardType<this, Y>;
+    /**
+     * Reads the once-only flag without setting it. The flag belongs on the schema that `custom`
+     * returns, not on the one it was derived from.
+     */
+    private limitGuard;
+}
 
 export { bigint };

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

@@ -1,11 +1,11 @@
 import { WithBGuardType } from '../../commonTypes.js';
-import { BigIntSchema } from '../../schemas/BigIntSchema.js';
-import '../../CommonSchema-DIDMH9R7.js';
-import '../../ExceptionContext.js';
+import { CommonSchema } from '../../core.js';
 import '../../InferType.js';
+import '../../helpers/constants.js';
+import '../../standardSchema.js';
 
 /**
- * @description Creates a new schema for validating bigint values.
+ * @description - Creates a new schema for validating bigint values.
  * @returns {WithBGuardType<BigIntSchema, bigint>} A new instance of `BigIntSchema` for validating bigints.
  * @example
  * const schema = bigint();
@@ -16,5 +16,36 @@ import '../../InferType.js';
  * @instance Of BigIntSchema
  */
 declare function bigint(): WithBGuardType<BigIntSchema, bigint>;
+declare class BigIntSchema extends CommonSchema {
+    protected _bigint: number;
+    private limit;
+    /**
+     * @method equalTo
+     * @description Restricts the schema to exactly match the specified value and infers the literal value as the TypeScript type.
+     * @param expectedValue - The value that the schema must exactly match.
+     * @returns A new schema restricted to the specified value, with the literal value inferred as the TypeScript type
+     * @example
+     * bigint().equalTo(42n); // Infers the type 42n
+     *
+     * @public
+     */
+    equalTo<Y extends bigint>(expectedValue: Y): WithBGuardType<this, Y>;
+    /**
+     * @method oneOfValues
+     * @description Restricts the schema to match one of the specified values and infers the union of those values as the TypeScript type.
+     * @param expectedValues - An array of values that the schema can match.
+     * @returns A new schema restricted to one of the specified values, with the union of those values inferred as the TypeScript type.
+     * @example
+     * bigint().oneOfValues([5n, 7n]); // Infers the type 5n | 7n
+     *
+     * @public
+     */
+    oneOfValues<Y extends bigint>(expectedValue: Y[]): WithBGuardType<this, Y>;
+    /**
+     * Reads the once-only flag without setting it. The flag belongs on the schema that `custom`
+     * returns, not on the one it was derived from.
+     */
+    private limitGuard;
+}
 
 export { bigint };

package/lib/asserts/bigint/index.js

@@ -1,22 +1,15 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkRG5NYH2Ijs = require('../../chunk-RG5NYH2I.js');
-require('../../chunk-UTPG4GZB.js');
-require('../../chunk-32MKEBKR.js');
-require('../../chunk-42J6CHIO.js');
-require('../../chunk-3ZQ4ORQH.js');
-require('../../chunk-MMWS3SXR.js');
-require('../../chunk-PQ4GCO3Q.js');
-require('../../chunk-EXVTHIT5.js');
-require('../../chunk-PE55R4KH.js');
+var _chunkL7YFDMZUjs = require('../../chunk-L7YFDMZU.js');
+require('../../chunk-3D6TPN7F.js');
+require('../../chunk-OPA6AXSH.js');
+require('../../chunk-FTHEF6SB.js');
+require('../../chunk-6LUSV3SS.js');
+require('../../chunk-ZJGY6EOE.js');
 require('../../chunk-VBTWYDEM.js');
-require('../../chunk-FIDPCCCW.js');
+require('../../chunk-LHEU4XAC.js');
+require('../../chunk-ZWFSAKQK.js');
 
-// src/asserts/bigint/index.ts
-function bigint() {
-  return new (0, _chunkRG5NYH2Ijs.BigIntSchema)({ type: ["bigint"], requiredValidations: [] });
-}
 
-
-exports.bigint = bigint;
+exports.bigint = _chunkL7YFDMZUjs.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","../../../src/asserts/bigint/index.ts"],"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,mCAAgC;AAChC;AACA;ACAO,SAAS,MAAA,CAAA,EAA+C;AAC7D,EAAA,OAAO,IAAI,kCAAA,CAAa,EAAE,IAAA,EAAM,CAAC,QAAQ,CAAA,EAAG,mBAAA,EAAqB,CAAC,EAAE,CAAC,CAAA;AACvE;ADEA;AACE;AACF,wBAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/bigint/index.js","sourcesContent":[null,"import { WithBGuardType } from '../../commonTypes';\nimport { BigIntSchema } from '../../schemas/BigIntSchema';\n\n/**\n * @description Creates a new schema for validating bigint values.\n * @returns {WithBGuardType<BigIntSchema, bigint>} A new instance of `BigIntSchema` for validating bigints.\n * @example\n * const schema = bigint();\n * parseOrFail(schema, 42n); // Validates successfully\n * parseOrFail(schema, 42); // Throws a validation error\n * parseOrFail(schema, '42'); // Throws a validation error\n *\n * @instance Of BigIntSchema\n */\nexport function bigint(): WithBGuardType<BigIntSchema, bigint> {\n  return new BigIntSchema({ type: ['bigint'], requiredValidations: [] }) as WithBGuardType<BigIntSchema, bigint>;\n}\n"]}
+{"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"}

package/lib/asserts/bigint/index.mjs

@@ -1,21 +1,14 @@
 import {
-  BigIntSchema
-} from "../../chunk-U3DJ354I.mjs";
-import "../../chunk-EMOOEIPZ.mjs";
-import "../../chunk-P54CF5QN.mjs";
-import "../../chunk-ASZW6XRM.mjs";
-import "../../chunk-YSCVE4PJ.mjs";
-import "../../chunk-UEYMBPZN.mjs";
-import "../../chunk-IFQLPXCZ.mjs";
-import "../../chunk-QWPHP26D.mjs";
-import "../../chunk-MQRXWXHP.mjs";
+  bigint
+} from "../../chunk-UWONIZJZ.mjs";
+import "../../chunk-D42AL6CN.mjs";
+import "../../chunk-YQP44G45.mjs";
+import "../../chunk-IIL6D2UL.mjs";
+import "../../chunk-LDZFOOWN.mjs";
+import "../../chunk-65X7NTUS.mjs";
 import "../../chunk-YBVMP4EI.mjs";
-import "../../chunk-ZTCXXAKD.mjs";
-
-// src/asserts/bigint/index.ts
-function bigint() {
-  return new BigIntSchema({ type: ["bigint"], requiredValidations: [] });
-}
+import "../../chunk-C76DLZFD.mjs";
+import "../../chunk-O2WD4JBG.mjs";
 export {
   bigint
 };

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/asserts/bigint/index.ts"],"sourcesContent":["import { WithBGuardType } from '../../commonTypes';\nimport { BigIntSchema } from '../../schemas/BigIntSchema';\n\n/**\n * @description Creates a new schema for validating bigint values.\n * @returns {WithBGuardType<BigIntSchema, bigint>} A new instance of `BigIntSchema` for validating bigints.\n * @example\n * const schema = bigint();\n * parseOrFail(schema, 42n); // Validates successfully\n * parseOrFail(schema, 42); // Throws a validation error\n * parseOrFail(schema, '42'); // Throws a validation error\n *\n * @instance Of BigIntSchema\n */\nexport function bigint(): WithBGuardType<BigIntSchema, bigint> {\n  return new BigIntSchema({ type: ['bigint'], requiredValidations: [] }) as WithBGuardType<BigIntSchema, bigint>;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAcO,SAAS,SAA+C;AAC7D,SAAO,IAAI,aAAa,EAAE,MAAM,CAAC,QAAQ,GAAG,qBAAqB,CAAC,EAAE,CAAC;AACvE;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -1,8 +1,8 @@
 import { WithBGuardType } from '../../commonTypes.mjs';
-import { BooleanSchema } from '../../schemas/BooleanSchema.mjs';
-import '../../CommonSchema-BIfYCtcQ.mjs';
-import '../../ExceptionContext.mjs';
+import { CommonSchema } from '../../core.mjs';
 import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
 
 /**
  * @description Creates a new schema for validating boolean values.
@@ -15,5 +15,34 @@ import '../../InferType.mjs';
  * @instance Of BooleanSchema
  */
 declare function boolean(): WithBGuardType<BooleanSchema, boolean>;
+declare class BooleanSchema extends CommonSchema {
+    protected _boolean: number;
+    private limit;
+    /**
+     * Reads the once-only flag without setting it, matching the string, number and bigint schemas.
+     * Without it, onlyTrue().onlyFalse() built a schema that rejects both true and false.
+     */
+    private limitGuard;
+    /**
+     * @method onlyTrue
+     * @description Restricts the schema to exactly match the boolean value true and infers the true value as the TypeScript type.
+     * @returns A new schema restricted to the value true, with the true value inferred as the TypeScript type
+     * @example
+     * boolean().onlyTrue(); // Infers the type true
+     *
+     * @public
+     */
+    onlyTrue(): WithBGuardType<this, true>;
+    /**
+     * @method onlyFalse
+     * @description Restricts the schema to exactly match the boolean value false and infers the false value as the TypeScript type.
+     * @returns A new schema restricted to the value false, with the false value inferred as the TypeScript type
+     * @example
+     * boolean().onlyFalse(); // Infers the type false
+     *
+     * @public
+     */
+    onlyFalse(): WithBGuardType<this, false>;
+}
 
 export { boolean };

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

@@ -1,8 +1,8 @@
 import { WithBGuardType } from '../../commonTypes.js';
-import { BooleanSchema } from '../../schemas/BooleanSchema.js';
-import '../../CommonSchema-DIDMH9R7.js';
-import '../../ExceptionContext.js';
+import { CommonSchema } from '../../core.js';
 import '../../InferType.js';
+import '../../helpers/constants.js';
+import '../../standardSchema.js';
 
 /**
  * @description Creates a new schema for validating boolean values.
@@ -15,5 +15,34 @@ import '../../InferType.js';
  * @instance Of BooleanSchema
  */
 declare function boolean(): WithBGuardType<BooleanSchema, boolean>;
+declare class BooleanSchema extends CommonSchema {
+    protected _boolean: number;
+    private limit;
+    /**
+     * Reads the once-only flag without setting it, matching the string, number and bigint schemas.
+     * Without it, onlyTrue().onlyFalse() built a schema that rejects both true and false.
+     */
+    private limitGuard;
+    /**
+     * @method onlyTrue
+     * @description Restricts the schema to exactly match the boolean value true and infers the true value as the TypeScript type.
+     * @returns A new schema restricted to the value true, with the true value inferred as the TypeScript type
+     * @example
+     * boolean().onlyTrue(); // Infers the type true
+     *
+     * @public
+     */
+    onlyTrue(): WithBGuardType<this, true>;
+    /**
+     * @method onlyFalse
+     * @description Restricts the schema to exactly match the boolean value false and infers the false value as the TypeScript type.
+     * @returns A new schema restricted to the value false, with the false value inferred as the TypeScript type
+     * @example
+     * boolean().onlyFalse(); // Infers the type false
+     *
+     * @public
+     */
+    onlyFalse(): WithBGuardType<this, false>;
+}
 
 export { boolean };

package/lib/asserts/boolean/index.js

@@ -1,19 +1,13 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkFNBYM254js = require('../../chunk-FNBYM254.js');
-require('../../chunk-3ZQ4ORQH.js');
-require('../../chunk-MMWS3SXR.js');
-require('../../chunk-PQ4GCO3Q.js');
-require('../../chunk-EXVTHIT5.js');
-require('../../chunk-PE55R4KH.js');
+var _chunkGYLCPX6Ojs = require('../../chunk-GYLCPX6O.js');
+require('../../chunk-FTHEF6SB.js');
+require('../../chunk-6LUSV3SS.js');
+require('../../chunk-ZJGY6EOE.js');
 require('../../chunk-VBTWYDEM.js');
-require('../../chunk-FIDPCCCW.js');
+require('../../chunk-LHEU4XAC.js');
+require('../../chunk-ZWFSAKQK.js');
 
-// src/asserts/boolean/index.ts
-function boolean() {
-  return new (0, _chunkFNBYM254js.BooleanSchema)({ type: ["boolean"], requiredValidations: [] });
-}
 
-
-exports.boolean = boolean;
+exports.boolean = _chunkGYLCPX6Ojs.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","../../../src/asserts/boolean/index.ts"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACA;ACEO,SAAS,OAAA,CAAA,EAAkD;AAChE,EAAA,OAAO,IAAI,mCAAA,CAAc,EAAE,IAAA,EAAM,CAAC,SAAS,CAAA,EAAG,mBAAA,EAAqB,CAAC,EAAE,CAAC,CAAA;AACzE;ADAA;AACE;AACF,0BAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/boolean/index.js","sourcesContent":[null,"import { WithBGuardType } from '../../commonTypes';\nimport { BooleanSchema } from '../../schemas/BooleanSchema';\n\n/**\n * @description Creates a new schema for validating boolean values.\n * @returns {WithBGuardType<BooleanSchema, boolean>} A new instance of `BooleanSchema` for validating booleans.\n * @example\n * const schema = boolean();\n * parseOrFail(schema, true); // Validates successfully\n * parseOrFail(schema, 'true'); // Throws a validation error\n *\n * @instance Of BooleanSchema\n */\nexport function boolean(): WithBGuardType<BooleanSchema, boolean> {\n  return new BooleanSchema({ type: ['boolean'], requiredValidations: [] }) as WithBGuardType<BooleanSchema, boolean>;\n}\n"]}
+{"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"}

package/lib/asserts/boolean/index.mjs

@@ -1,18 +1,12 @@
 import {
-  BooleanSchema
-} from "../../chunk-XT5E3MPI.mjs";
-import "../../chunk-YSCVE4PJ.mjs";
-import "../../chunk-UEYMBPZN.mjs";
-import "../../chunk-IFQLPXCZ.mjs";
-import "../../chunk-QWPHP26D.mjs";
-import "../../chunk-MQRXWXHP.mjs";
+  boolean
+} from "../../chunk-5VZDHJKM.mjs";
+import "../../chunk-IIL6D2UL.mjs";
+import "../../chunk-LDZFOOWN.mjs";
+import "../../chunk-65X7NTUS.mjs";
 import "../../chunk-YBVMP4EI.mjs";
-import "../../chunk-ZTCXXAKD.mjs";
-
-// src/asserts/boolean/index.ts
-function boolean() {
-  return new BooleanSchema({ type: ["boolean"], requiredValidations: [] });
-}
+import "../../chunk-C76DLZFD.mjs";
+import "../../chunk-O2WD4JBG.mjs";
 export {
   boolean
 };

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/asserts/boolean/index.ts"],"sourcesContent":["import { WithBGuardType } from '../../commonTypes';\nimport { BooleanSchema } from '../../schemas/BooleanSchema';\n\n/**\n * @description Creates a new schema for validating boolean values.\n * @returns {WithBGuardType<BooleanSchema, boolean>} A new instance of `BooleanSchema` for validating booleans.\n * @example\n * const schema = boolean();\n * parseOrFail(schema, true); // Validates successfully\n * parseOrFail(schema, 'true'); // Throws a validation error\n *\n * @instance Of BooleanSchema\n */\nexport function boolean(): WithBGuardType<BooleanSchema, boolean> {\n  return new BooleanSchema({ type: ['boolean'], requiredValidations: [] }) as WithBGuardType<BooleanSchema, boolean>;\n}\n"],"mappings":";;;;;;;;;;;;AAaO,SAAS,UAAkD;AAChE,SAAO,IAAI,cAAc,EAAE,MAAM,CAAC,SAAS,GAAG,qBAAqB,CAAC,EAAE,CAAC;AACzE;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +1,52 @@
+import { WithInput, WithBGuardType } from '../../commonTypes.mjs';
+import { CommonSchema } from '../../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.
+ */
+type Coerced<S, In> = WithInput<S, In>;
+/**
+ * Converts the received value before validating it, for input that does not arrive already typed —
+ * query strings, form data, environment variables.
+ *
+ * Each of these accepts `unknown` and reports that in its inferred input type, while the output type
+ * is unchanged. `null` is left alone, so `nullable()` still decides whether it is allowed rather than
+ * being turned into the string `'null'` or the number `0`.
+ *
+ * @example
+ * const querySchema = object({ page: coerce.number().default(1), q: coerce.string() });
+ * parseOrFail(querySchema, { page: '3', q: 'shoes' }); // { page: 3, q: 'shoes' }
+ */
+declare const coerce: {
+    /** Anything that is not already a string is passed through `String`. */
+    string: () => Coerced<WithBGuardType<CommonSchema, string>, unknown>;
+    /**
+     * Anything that is not already a number is passed through `Number`. A value `Number` cannot read
+     * becomes `NaN`, which `number()` rejects, so `'abc'` fails validation rather than passing as a
+     * number.
+     */
+    number: () => Coerced<WithBGuardType<CommonSchema, number>, unknown>;
+    /**
+     * 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`.
+     */
+    boolean: () => Coerced<WithBGuardType<CommonSchema, boolean>, unknown>;
+    /** `BigInt` throws on a value it cannot read, so the original is kept for validation to reject. */
+    bigint: () => Coerced<WithBGuardType<CommonSchema, bigint>, unknown>;
+    /**
+     * Anything that is not already a Date is passed through `new Date`. An unreadable value becomes an
+     * invalid Date, which `date()` rejects.
+     */
+    date: () => Coerced<WithBGuardType<CommonSchema, Date>, unknown>;
+};
+
+export { coerce };