* Added the value's expected type to the function name (e.g. requireT…

…hatString() instead of requireThat()). This is the only way to ensure that the value's compile-time and runtime types match.

* Previous validator implementations failed to take undefined values into consideration.

build/Project.mts

@@ -79,7 +79,6 @@ class Project
 
 	/**
 	 * @param sources - the files to compile
-	 * @private
 	 */
 	private async bundleForNode(sources: string[])
 	{
@@ -410,7 +409,6 @@ class Project
 
 	/**
 	 * @returns the resources in the project
-	 * @private
 	 */
 	private getResourceFiles()
 	{

eslint.config.mjs

@@ -60,6 +60,9 @@ export default tsEslint.config(
 			"@typescript-eslint/restrict-template-expressions": [
 				"error",
 				{
+					allowArray: true,
+					allowBoolean: true,
+					allowNullish: true,
 					allowNumber: true
 				}
 			]

src/DefaultJavascriptValidators.mts

@@ -5,7 +5,7 @@ import {
 	type ArrayValidator,
 	type SetValidator,
 	type MapValidator,
-	type ObjectValidator,
+	type UnknownValidator,
 	Configuration,
 	JavascriptValidatorsImpl,
 	MainApplicationScope,
@@ -153,7 +153,7 @@ function requireThatString<T extends string | undefined | null>
 }
 
 /**
- * Validates the state of an object.
+ * Validates the state of an unknown value or a value that does not have a specialized validator.
  * <p>
  * The returned validator throws an exception immediately if a validation fails. This exception is then
  * converted into an {@link AssertionError}. Exceptions unrelated to validation failures are not converted.
@@ -165,10 +165,9 @@ function requireThatString<T extends string | undefined | null>
  * @throws TypeError  if `name` is `undefined` or `null`
  * @throws RangeError if `name` is empty
  */
-function requireThatObject<T extends object | undefined | null>
-(value: T, name: string): ObjectValidator<T>
+function requireThat<T>(value: T, name: string): UnknownValidator<T>
 {
-	return DELEGATE.requireThatObject<T>(value, name);
+	return DELEGATE.requireThat<T>(value, name);
 }
 
 /**
@@ -290,7 +289,7 @@ function assertThatString<T extends string | undefined | null>
 }
 
 /**
- * Validates the state of a number.
+ * Validates the state of an unknown value or a value that does not have a specialized validator.
  * <p>
  * The returned validator throws an exception immediately if a validation fails. This exception is then
  * converted into an {@link AssertionError}. Exceptions unrelated to validation failures are not converted.
@@ -302,10 +301,9 @@ function assertThatString<T extends string | undefined | null>
  * @throws TypeError  if `name` is `undefined` or `null`
  * @throws RangeError if `name` is empty
  */
-function assertThatObject<T extends object | undefined | null>
-(value: T, name?: string): ObjectValidator<T>
+function assertThat<T>(value: T, name?: string): UnknownValidator<T>
 {
-	return DELEGATE.assertThatObject<T>(value, name);
+	return DELEGATE.assertThat<T>(value, name);
 }
 
 /**
@@ -421,7 +419,7 @@ function checkIfString<T extends string | undefined | null>
 }
 
 /**
- * Validates the state of an object.
+ * Validates the state of an unknown value or a value that does not have a specialized validator.
  * <p>
  * The returned validator throws an error immediately if a validation fails.
  *
@@ -435,10 +433,9 @@ function checkIfString<T extends string | undefined | null>
  * @throws TypeError  if `name` is `undefined` or `null`
  * @throws RangeError if `name` is empty
  */
-function checkIfObject<T extends object | undefined | null>
-(value: T, name: string): ObjectValidator<T>
+function checkIf<T>(value: T, name: string): UnknownValidator<T>
 {
-	return DELEGATE.checkIfObject<T>(value, name);
+	return DELEGATE.checkIf<T>(value, name);
 }
 
 /**
@@ -521,21 +518,21 @@ export {
 	requireThatSet,
 	requireThatMap,
 	requireThatString,
-	requireThatObject,
+	requireThat,
 	assertThatNumber,
 	assertThatBoolean,
 	assertThatArray,
 	assertThatSet,
 	assertThatMap,
 	assertThatString,
-	assertThatObject,
+	assertThat,
 	checkIfNumber,
 	checkIfBoolean,
 	checkIfArray,
 	checkIfSet,
 	checkIfMap,
 	checkIfString,
-	checkIfObject,
+	checkIf,
 	updateConfiguration,
 	getContext,
 	withContext,

src/JavascriptAssertThat.mts

@@ -9,7 +9,7 @@ import {
 	type MapValidator,
 	type StringValidator,
 	type NumberValidator,
-	type ObjectValidator,
+	type UnknownValidator,
 	type ArrayValidator,
 	AssertionError
 } from "./internal/internal.mjs";
@@ -122,7 +122,7 @@ interface JavascriptAssertThat
 	assertThatString<T extends string | undefined | null>(value: T, name?: string): StringValidator<T>;
 
 	/**
-	 * Validates the state of an `object`.
+	 * Validates the state of an unknown value or a value that does not have a specialized validator.
 	 * <p>
 	 * The returned validator throws an error immediately if a validation fails. This error is then
 	 * converted into an {@link AssertionError}. Errors unrelated to validation failures are not converted.
@@ -134,7 +134,7 @@ interface JavascriptAssertThat
 	 * @throws TypeError if `name` is `undefined` or `null`
 	 * @throws RangeError if `name` contains whitespace or is empty
 	 */
-	assertThatObject<T extends object | undefined | null>(value: T, name?: string): ObjectValidator<T>;
+	assertThat<T>(value: T, name?: string): UnknownValidator<T>;
 }
 
 export type {JavascriptAssertThat};

src/JavascriptCheckIf.mts

@@ -7,7 +7,7 @@ import {
 	type BooleanValidator,
 	type StringValidator,
 	type NumberValidator,
-	type ObjectValidator,
+	type UnknownValidator,
 	type ArrayValidator,
 	type SetValidator,
 	type MapValidator
@@ -120,7 +120,7 @@ interface JavascriptCheckIf
 	checkIfString<T extends string | undefined | null>(value: T, name: string): StringValidator<T>;
 
 	/**
-	 * Validates the state of an `object`.
+	 * Validates the state of an unknown value or a value that does not have a specialized validator.
 	 * <p>
 	 * The returned validator captures errors on validation failure rather than throwing them immediately.
 	 * These errors can be retrieved or thrown once the validation completes. Errors unrelated to
@@ -133,7 +133,7 @@ interface JavascriptCheckIf
 	 * @throws TypeError if `name` is `undefined` or `null`
 	 * @throws RangeError if `name` contains whitespace or is empty
 	 */
-	checkIfObject<T extends object | undefined | null>(value: T, name: string): ObjectValidator<T>;
+	checkIf<T>(value: T, name: string): UnknownValidator<T>;
 }
 
 export type {JavascriptCheckIf};

src/JavascriptRequireThat.mts

@@ -10,7 +10,7 @@ import {
 	type SetValidator,
 	type MapValidator,
 	type StringValidator,
-	type ObjectValidator
+	type UnknownValidator
 } from "./internal/internal.mjs";
 
 /**
@@ -107,7 +107,7 @@ interface JavascriptRequireThat
 	requireThatString<T extends string | undefined | null>(value: T, name: string): StringValidator<T>;
 
 	/**
-	 * Validates the state of an `object`.
+	 * Validates the state of an unknown value or a value that does not have a specialized validator.
 	 * <p>
 	 * The returned validator throws an error immediately if a validation fails.
 	 *
@@ -118,7 +118,7 @@ interface JavascriptRequireThat
 	 * @throws TypeError if `name` is `undefined` or `null`
 	 * @throws RangeError if `name` contains whitespace or is empty
 	 */
-	requireThatObject<T extends object | undefined | null>(value: T, name: string): ObjectValidator<T>;
+	requireThat<T>(value: T, name: string): UnknownValidator<T>;
 }
 
 export type {JavascriptRequireThat};

src/JavascriptValidators.mts

@@ -18,7 +18,7 @@ import {
 	type JavascriptCheckIf,
 	Configuration,
 	type GlobalConfiguration,
-	type ObjectValidator,
+	type UnknownValidator,
 	AssertionError
 } from "./internal/internal.mjs";
 
@@ -83,8 +83,7 @@ abstract class JavascriptValidators
 	abstract requireThatString<T extends string | undefined | null>
 	(value: T, name: string): StringValidator<T>;
 
-	abstract requireThatObject<T extends object | undefined | null>
-	(value: T, name: string): ObjectValidator<T>;
+	abstract requireThat<T>(value: T, name: string): UnknownValidator<T>;
 
 	abstract assertThatNumber<T extends number | undefined | null>
 	(value: T, name?: string): NumberValidator<T>;
@@ -104,8 +103,7 @@ abstract class JavascriptValidators
 	abstract assertThatString<T extends string | undefined | null>
 	(value: T, name?: string): StringValidator<T>;
 
-	abstract assertThatObject<T extends object | undefined | null>
-	(value: T, name?: string): ObjectValidator<T>;
+	abstract assertThat<T>(value: T, name?: string): UnknownValidator<T>;
 
 	abstract checkIfNumber<T extends number | undefined | null>
 	(value: T, name?: string): NumberValidator<T>;
@@ -125,8 +123,7 @@ abstract class JavascriptValidators
 	abstract checkIfString<T extends string | undefined | null>
 	(value: T, name?: string): StringValidator<T>;
 
-	abstract checkIfObject<T extends object | undefined | null>
-	(value: T, name?: string): ObjectValidator<T>;
+	abstract checkIf<T>(value: T, name?: string): UnknownValidator<T>;
 }
 
 export {JavascriptValidators};

src/index.mts

@@ -5,21 +5,21 @@ export {
 	requireThatSet,
 	requireThatMap,
 	requireThatString,
-	requireThatObject,
+	requireThat,
 	assertThatNumber,
 	assertThatBoolean,
 	assertThatArray,
 	assertThatSet,
 	assertThatMap,
 	assertThatString,
-	assertThatObject,
+	assertThat,
 	checkIfNumber,
 	checkIfBoolean,
 	checkIfArray,
 	checkIfSet,
 	checkIfMap,
 	checkIfString,
-	checkIfObject,
+	checkIf,
 	updateConfiguration,
 	getContext,
 	withContext,
@@ -35,7 +35,7 @@ export {
 	type MapValidator,
 	type NumberValidator,
 	type BooleanValidator,
-	type ObjectValidator,
+	type UnknownValidator,
 	type ElementOf,
 	type MapKey,
 	type MapValue,

src/internal/internal.mts

@@ -9,7 +9,7 @@
 // internal.js determines the library-wide loading order.
 // Dependencies must be loaded before dependents.
 
-import type {ObjectValidator} from "../validator/ObjectValidator.mjs";
+import type {UnknownValidator} from "../validator/UnknownValidator.mjs";
 import {
 	Type,
 	TypeCategory
@@ -68,7 +68,7 @@ import {AbstractApplicationScope} from "./scope/AbstractApplicationScope.mjs";
 import {MainApplicationScope} from "./scope/MainApplicationScope.mjs";
 import {Configuration} from "./Configuration.mjs";
 import {JavascriptValidatorsImpl} from "./validator/JavascriptValidatorsImpl.mjs";
-import {ObjectValidatorImpl} from "./validator/ObjectValidatorImpl.mjs";
+import {UnknownValidatorImpl} from "./validator/UnknownValidatorImpl.mjs";
 import type {MapValidator} from "../validator/MapValidator.mjs";
 import {MapValidatorImpl} from "./validator/MapValidatorImpl.mjs";
 import type {NumberValidator} from "../validator/NumberValidator.mjs";
@@ -101,21 +101,21 @@ import {
 	requireThatSet,
 	requireThatMap,
 	requireThatString,
-	requireThatObject,
+	requireThat,
 	assertThatNumber,
 	assertThatBoolean,
 	assertThatArray,
 	assertThatSet,
 	assertThatMap,
 	assertThatString,
-	assertThatObject,
+	assertThat,
 	checkIfNumber,
 	checkIfBoolean,
 	checkIfArray,
 	checkIfSet,
 	checkIfMap,
 	checkIfString,
-	checkIfObject,
+	checkIf,
 	updateConfiguration,
 	getContext,
 	withContext,
@@ -303,29 +303,29 @@ export
 	quoteString,
 	AbstractValidators,
 	AbstractValidator,
-	ObjectValidatorImpl,
+	UnknownValidatorImpl,
 	Pluralizer,
 	requireThatNumber,
 	requireThatBoolean,
 	requireThatArray,
 	requireThatSet,
 	requireThatMap,
 	requireThatString,
-	requireThatObject,
+	requireThat,
 	assertThatNumber,
 	assertThatBoolean,
 	assertThatArray,
 	assertThatSet,
 	assertThatMap,
 	assertThatString,
-	assertThatObject,
+	assertThat,
 	checkIfNumber,
 	checkIfBoolean,
 	checkIfArray,
 	checkIfSet,
 	checkIfMap,
 	checkIfString,
-	checkIfObject,
+	checkIf,
 	updateConfiguration,
 	getContext,
 	withContext,
@@ -435,7 +435,7 @@ export type
 	MapValidator,
 	NumberValidator,
 	BooleanValidator,
-	ObjectValidator,
+	UnknownValidator,
 	ElementOf,
 	MapKey,
 	MapValue,

src/internal/util/AssertionError.mts

@@ -9,7 +9,7 @@ class AssertionError extends Error
 	 * @param message - an explanation of what went wrong
 	 * @param options - configuration options
 	 */
-	constructor(message?: string, options?: { cause: Error })
+	constructor(message?: string, options?: { cause: unknown })
 	{
 		super(message, options);
 		this.name = this.constructor.name;