xdbc 1.0.211 → 1.0.213

package/src/DBC/INSTANCE.ts

@@ -14,7 +14,10 @@ export class INSTANCE extends DBC {
 	 *
 	 * @returns TRUE if the value **toCheck** is is an instance of the *reference**, **undefined** or **null**, otherwise FALSE. */
 	// biome-ignore lint/suspicious/noExplicitAny: In order to perform an "instanceof" check.
-	public static checkAlgorithm(toCheck: any, ...references: any[]): boolean | string {
+	public static checkAlgorithm(
+		toCheck: any,
+		...references: any[]
+	): boolean | string {
 		if (toCheck === null || toCheck === undefined) {
 			return true;
 		}
@@ -25,7 +28,7 @@ export class INSTANCE extends DBC {
 			}
 		}
 
-		return `Value has to be an instance of "${references.map(ref => ref.name || ref).join(', ')}" but is of type "${typeof toCheck}"`;
+		return `Value has to be an instance of "${references.map((ref) => ref.name || ref).join(", ")}" but is of type "${typeof toCheck}"`;
 	}
 	/**
 	 * A parameter-decorator factory using the {@link INSTANCE.checkAlgorithm } to determine whether this {@link DBC } is fulfilled
@@ -104,42 +107,54 @@ export class INSTANCE extends DBC {
 	 * @returns See {@link INSTANCE.checkAlgorithm}. */
 	// biome-ignore lint/suspicious/noExplicitAny: <explanation>
 	public check(toCheck: any) {
-		return Array.isArray(this.reference) ? INSTANCE.checkAlgorithm(toCheck, ...this.reference) : INSTANCE.checkAlgorithm(toCheck, this.reference);
+		return Array.isArray(this.reference)
+			? INSTANCE.checkAlgorithm(toCheck, ...this.reference)
+			: INSTANCE.checkAlgorithm(toCheck, this.reference);
 	}
 	/**
 	 * Type-safe check that validates if a value is an instance of a specified reference.
-	 * 
+	 *
 	 * @param toCheck 	The value to check for instance validity.
 	 * @param reference	The {@link object } the one **toCheck** has to be an instance of.
 	 * @param hint		An optional {@link string } providing extra information in case of an infringement.
 	 * @param id		A {@link string } identifying this {@link INSTANCE } via the {@link DBC.Infringement }-Message.
-	 * 
+	 *
 	 * @returns The **CANDIDATE** **toCheck** if it fulfills this {@link INSTANCE }.
-	 * 
+	 *
 	 * @throws A {@link DBC.Infringement } if the **CANDIDATE** **toCheck** does not fulfill this {@link INSTANCE }. */
-	public static tsCheck<CANDIDATE = unknown>(toCheck: any, reference: any, hint: string = undefined, id: string | undefined = undefined): CANDIDATE {
+	public static tsCheck<CANDIDATE = unknown>(
+		toCheck: any,
+		reference: any,
+		hint: string = undefined,
+		id: string | undefined = undefined,
+	): CANDIDATE {
 		return INSTANCE.tsCheckMulti<CANDIDATE>(toCheck, [reference], hint, id);
 	}
 	/**
 	 * Invokes the {@link INSTANCE.checkAlgorithm } passing the value **toCheck** and the {@link INSTANCE.reference } .
-	 * 
+	 *
 	 * @param toCheck 	See {@link INSTANCE.checkAlgorithm }.
 	 * @param reference	See {@link INSTANCE.checkAlgorithm }.
 	 * @param hint		An optional {@link string } providing extra information in case of an infringement.
 	 * @param id		A {@link string } identifying this {@link INSTANCE } via the {@link DBC.Infringement }-Message.
-	 * 
+	 *
 	 * @returns The **CANDIDATE** **toCheck** doesn't fulfill this {@link INSTANCE }.
-	 * 
+	 *
 	 * @throws A {@link DBC.Infringement } if the **CANDIDATE** **toCheck** does not fulfill this {@link DEFINED }. */
-	public static tsCheckMulti<CANDIDATE = unknown>(toCheck: any, references: any[], hint: string = undefined, id: string | undefined = undefined): CANDIDATE {
+	public static tsCheckMulti<CANDIDATE = unknown>(
+		toCheck: any,
+		references: any[],
+		hint: string = undefined,
+		id: string | undefined = undefined,
+	): CANDIDATE {
 		const result = INSTANCE.checkAlgorithm(toCheck, ...references);
 
 		if (result === true) {
 			return toCheck;
 		}
-		else {
-			throw new DBC.Infringement(`${id ? `(${id}) ` : ""}${result as string} ${hint ? `✨ ${hint} ✨` : ""}`);
-		}
+		throw new DBC.Infringement(
+			`${id ? `(${id}) ` : ""}${result as string} ${hint ? `✨ ${hint} ✨` : ""}`,
+		);
 	}
 	/**
 	 * Creates this {@link INSTANCE } by setting the protected property {@link INSTANCE.reference } used by {@link INSTANCE.check }.

package/src/DBC/JSON.OP.ts

@@ -71,7 +71,12 @@ export class JSON_OP extends DBC {
 		methodName: string | symbol,
 		parameterIndex: number,
 	) => void {
-		return DBC.createPRE(JSON_OP.checkAlgorithm, [necessaryProperties, checkElements], dbc, path);
+		return DBC.createPRE(
+			JSON_OP.checkAlgorithm,
+			[necessaryProperties, checkElements],
+			dbc,
+			path,
+		);
 	}
 	/**
 	 * A method-decorator factory using the {@link JSON_OP.checkAlgorithm } to determine whether this {@link DBC } is fulfilled
@@ -92,7 +97,12 @@ export class JSON_OP extends DBC {
 		propertyKey: string,
 		descriptor: PropertyDescriptor,
 	) => PropertyDescriptor {
-		return DBC.createPOST(JSON_OP.checkAlgorithm, [necessaryProperties, checkElements], dbc, path);
+		return DBC.createPOST(
+			JSON_OP.checkAlgorithm,
+			[necessaryProperties, checkElements],
+			dbc,
+			path,
+		);
 	}
 	/**
 	 * A field-decorator factory using the {@link JSON_OP.checkAlgorithm } to determine whether this {@link DBC } is fulfilled
@@ -109,7 +119,12 @@ export class JSON_OP extends DBC {
 		path: string | undefined = undefined,
 		dbc = "WaXCode.DBC",
 	) {
-		return DBC.createINVARIANT(JSON_OP, [necessaryProperties, checkElements], dbc, path);
+		return DBC.createINVARIANT(
+			JSON_OP,
+			[necessaryProperties, checkElements],
+			dbc,
+			path,
+		);
 	}
 	// #endregion Condition checking.
 	// #region Referenced Condition checking.

package/src/DBC/JSON.Parse.ts

@@ -52,7 +52,13 @@ export class JSON_Parse extends DBC {
 		methodName: string | symbol,
 		parameterIndex: number,
 	) => void {
-		return DBC.createPRE(JSON_Parse.checkAlgorithm, [receptor], dbc, path, hint);
+		return DBC.createPRE(
+			JSON_Parse.checkAlgorithm,
+			[receptor],
+			dbc,
+			path,
+			hint,
+		);
 	}
 	/**
 	 * A method-decorator factory using the {@link JSON_Parse.checkAlgorithm } to determine whether this {@link DBC } is fulfilled
@@ -73,7 +79,13 @@ export class JSON_Parse extends DBC {
 		propertyKey: string,
 		descriptor: PropertyDescriptor,
 	) => PropertyDescriptor {
-		return DBC.createPOST(JSON_Parse.checkAlgorithm, [receptor], dbc, path, hint);
+		return DBC.createPOST(
+			JSON_Parse.checkAlgorithm,
+			[receptor],
+			dbc,
+			path,
+			hint,
+		);
 	}
 	/**
 	 * A field-decorator factory using the {@link JSON_Parse.checkAlgorithm } to determine whether this {@link DBC } is fulfilled
@@ -105,14 +117,19 @@ export class JSON_Parse extends DBC {
 	 * @returns See {@link JSON_Parse.checkAlgorithm}. */
 	// biome-ignore lint/suspicious/noExplicitAny: <explanation>
 	public check(toCheck: any) {
-		return JSON_Parse.checkAlgorithm(toCheck, this.receptor as (json: object) => void);
+		return JSON_Parse.checkAlgorithm(
+			toCheck,
+			this.receptor as (json: object) => void,
+		);
 	}
 	/**
 	 * Creates this {@link JSON_Parse } by setting the protected property {@link JSON_Parse.necessaryProperties } and {@link checkElements } used by {@link JSON_Parse.check }.
 	 *
 	 * @param necessaryProperties	See {@link JSON_Parse.check }.
 	 * @param checkElements 		See {@link JSON_Parse.check }. */
-	public constructor(public receptor: ((json: object) => void) | undefined = undefined) {
+	public constructor(
+		public receptor: ((json: object) => void) | undefined = undefined,
+	) {
 		super();
 	}
 	// #endregion Referenced Condition checking.

package/src/DBC/OR.ts

@@ -150,19 +150,24 @@ export class OR extends DBC {
 	 * @param toCheck See {@link OR.checkAlgorithm }.
 	 *
 	 * @returns The **CANDIDATE** **toCheck** doesn't fulfill this {@link OR }.
-	 * 
+	 *
 	 * @throws A {@link DBC.Infringement } if the **CANDIDATE** **toCheck** does not fulfill this {@link OR }.*/
-	public static tsCheck<CANDIDATE>(toCheck: unknown | undefined | null, conditions: Array<{
-		check: (toCheck: unknown | undefined | null | object) => boolean | string;
-	}>, hint: string = undefined, id: string | undefined = undefined): CANDIDATE {
+	public static tsCheck<CANDIDATE>(
+		toCheck: unknown | undefined | null,
+		conditions: Array<{
+			check: (toCheck: unknown | undefined | null | object) => boolean | string;
+		}>,
+		hint: string = undefined,
+		id: string | undefined = undefined,
+	): CANDIDATE {
 		const result = OR.checkAlgorithm(conditions, toCheck);
 
 		if (result) {
 			return toCheck as CANDIDATE;
 		}
-		else {
-			throw new DBC.Infringement(`${id ? `(${id}) ` : ""}${result as string}${hint ? ` ✨ ${hint} ✨` : ""}`);
-		}
+		throw new DBC.Infringement(
+			`${id ? `(${id}) ` : ""}${result as string}${hint ? ` ✨ ${hint} ✨` : ""}`,
+		);
 	}
 	/**
 	 * Creates this {@link OR } by setting the protected property {@link OR.conditions } used by {@link OR.check }.

package/src/DBC/REGEX.ts

@@ -6,20 +6,22 @@ import { DBC } from "../DBC";
  * Maintainer: Callari, Salvatore (XDBC@WaXCode.net) */
 export class REGEX extends DBC {
 	/** Stores often used {@link RegExp }s. Patterns are compiled lazily on first access. */
-	private static _stdExp: {
-		htmlAttributeName: RegExp;
-		eMail: RegExp;
-		property: RegExp;
-		url: RegExp;
-		keyPath: RegExp;
-		date: RegExp;
-		dateFormat: RegExp;
-		cssSelector: RegExp;
-		boolean: RegExp;
-		colorCodeHEX: RegExp;
-		simpleHotkey: RegExp;
-		bcp47: RegExp;
-	} | undefined;
+	private static _stdExp:
+		| {
+				htmlAttributeName: RegExp;
+				eMail: RegExp;
+				property: RegExp;
+				url: RegExp;
+				keyPath: RegExp;
+				date: RegExp;
+				dateFormat: RegExp;
+				cssSelector: RegExp;
+				boolean: RegExp;
+				colorCodeHEX: RegExp;
+				simpleHotkey: RegExp;
+				bcp47: RegExp;
+		  }
+		| undefined;
 
 	public static get stdExp() {
 		if (!REGEX._stdExp) {
@@ -37,7 +39,8 @@ export class REGEX extends DBC {
 				boolean: /^(TRUE|FALSE)$/i,
 				colorCodeHEX: /^#([A-Fa-f\d]{3,4}|[A-Fa-f\d]{6}|[A-Fa-f\d]{8})$/i,
 				simpleHotkey: /^((Alt|Ctrl|Shift|Meta)\+)+[a-z\d]$/i,
-				bcp47: /^(?:[a-z]{2,3}(?:-[a-z]{3}){0,3}|[a-z]{4}|[a-z]{5,8})(?:-[a-z]{4})?(?:-[a-z]{2}|-[0-9]{3})?(?:-[a-z0-9]{5,8}|-[0-9][a-z0-9]{3})*(?:-[0-9a-wy-z](?:-[a-z0-9]{2,8})+)*(?:-x(?:-[a-z0-9]{1,8})+)?$|^x(?:-[a-z0-9]{1,8})+$/i
+				bcp47:
+					/^(?:[a-z]{2,3}(?:-[a-z]{3}){0,3}|[a-z]{4}|[a-z]{5,8})(?:-[a-z]{4})?(?:-[a-z]{2}|-[0-9]{3})?(?:-[a-z0-9]{5,8}|-[0-9][a-z0-9]{3})*(?:-[0-9a-wy-z](?:-[a-z0-9]{2,8})+)*(?:-x(?:-[a-z0-9]{1,8})+)?$|^x(?:-[a-z0-9]{1,8})+$/i,
 			};
 		}
 		return REGEX._stdExp;
@@ -55,7 +58,8 @@ export class REGEX extends DBC {
 		toCheck: unknown | null | undefined,
 		expression: RegExp,
 	): boolean | string {
-		if (toCheck === undefined || toCheck === null || toCheck === "") return true;
+		if (toCheck === undefined || toCheck === null || toCheck === "")
+			return true;
 
 		if (!expression.test(toCheck as string)) {
 			return `Value has to comply to regular expression "${expression}"`;
@@ -146,17 +150,22 @@ export class REGEX extends DBC {
 	 * @param id			Optional identifier to include in the error message.
 	 *
 	 * @returns The validated value cast to the CANDIDATE type.
-	 * 
+	 *
 	 * @throws {@link DBC.Infringement} if the value does not match the regular expression. */
-	public static tsCheck<CANDIDATE = unknown>(toCheck: any, expression: RegExp, hint: string | undefined = undefined, id: string | undefined = undefined): CANDIDATE {
+	public static tsCheck<CANDIDATE = unknown>(
+		toCheck: any,
+		expression: RegExp,
+		hint: string | undefined = undefined,
+		id: string | undefined = undefined,
+	): CANDIDATE {
 		const result = REGEX.checkAlgorithm(toCheck, expression);
 
 		if (result) {
 			return toCheck;
 		}
-		else {
-			throw new DBC.Infringement(`${id ? `(${id}) ` : ""}${result as string}${hint ? ` ✨ ${hint} ✨` : ""}`);
-		}
+		throw new DBC.Infringement(
+			`${id ? `(${id}) ` : ""}${result as string}${hint ? ` ✨ ${hint} ✨` : ""}`,
+		);
 	}
 	/**
 	 * Creates this {@link REGEX } by setting the protected property {@link REGEX.expression } used by {@link REGEX.check }.

package/src/DBC/TYPE.ts

@@ -17,12 +17,12 @@ export class TYPE extends DBC {
 	public static checkAlgorithm(toCheck: any, type: string): boolean | string {
 		if (toCheck === undefined || toCheck === null) return true;
 
-		const types = type.split("|").map(t => t.trim());
+		const types = type.split("|").map((t) => t.trim());
 		const actualType = typeof toCheck;
 
 		// #region Check if the actual type matches at least one of the specified types
 		// biome-ignore lint/suspicious/useValidTypeof: Necessary
-		const isValid = types.some(t => actualType === t);
+		const isValid = types.some((t) => actualType === t);
 
 		if (!isValid) {
 			if (types.length === 1) {
@@ -47,7 +47,7 @@ export class TYPE extends DBC {
 		type: string,
 		path: string | undefined = undefined,
 		hint: string | undefined = undefined,
-		dbc: string | undefined = undefined
+		dbc: string | undefined = undefined,
 	): (
 		target: object,
 		methodName: string | symbol,
@@ -70,7 +70,6 @@ export class TYPE extends DBC {
 		path: string | undefined = undefined,
 		hint: string | undefined = undefined,
 		dbc: string | undefined = undefined,
-
 	): (
 		target: object,
 		propertyKey: string,
@@ -113,24 +112,29 @@ export class TYPE extends DBC {
 	}
 	/**
 	 * Invokes the {@link TYPE.checkAlgorithm } passing the value **toCheck** and the {@link TYPE.type } .
-	 * 
+	 *
 	 * @param toCheck	See {@link TYPE.checkAlgorithm }.
 	 * @param type		See {@link TYPE.checkAlgorithm }.
 	 * @param hint		An optional {@link string } providing extra information in case of an infringement.
 	 * @param id		A {@link string } identifying this {@link TYPE } via the {@link DBC.Infringement }-Message.
-	 * 
+	 *
 	 * @returns The **CANDIDATE** **toCheck** doesn't fulfill this {@link TYPE }.
-	 * 
+	 *
 	 * @throws A {@link DBC.Infringement } if the **CANDIDATE** **toCheck** does not fulfill this {@link DEFINED }. */
-	public static tsCheck<CANDIDATE = unknown>(toCheck: any, type: string, hint: string | undefined = undefined, id: string | undefined = undefined): CANDIDATE {
+	public static tsCheck<CANDIDATE = unknown>(
+		toCheck: any,
+		type: string,
+		hint: string | undefined = undefined,
+		id: string | undefined = undefined,
+	): CANDIDATE {
 		const result = TYPE.checkAlgorithm(toCheck, type);
 
 		if (result === true) {
 			return toCheck;
 		}
-		else {
-			throw new DBC.Infringement(`${id ? `(${id}) ` : ""}${result as string}${hint ? ` ✨ ${hint} ✨` : ""}`);
-		}
+		throw new DBC.Infringement(
+			`${id ? `(${id}) ` : ""}${result as string}${hint ? ` ✨ ${hint} ✨` : ""}`,
+		);
 	}
 	/**
 	 * Creates this {@link TYPE } by setting the protected property {@link TYPE.type } used by {@link TYPE.check }.

package/src/DBC/UNDEFINED.ts

@@ -97,22 +97,19 @@ export class UNDEFINED extends DBC {
 	 *
 	 * @param toCheck	See {@link UNDEFINED.checkAlgorithm }.
 	 * @param id		A {@link string } identifying this {@link INSTANCE } via the {@link DBC.Infringement }-Message.
-	 * 
+	 *
 	 * @returns The **CANDIDATE** **toCheck** doesn't fulfill this {@link UNDEFINED }.
-	 * 
+	 *
 	 * @throws A {@link DBC.Infringement } if the **CANDIDATE** **toCheck** does not fulfill this {@link UNDEFINED }.*/
-	public static tsCheck<CANDIDATE = unknown>(toCheck: CANDIDATE | undefined | null, id: string | undefined = undefined): CANDIDATE {
+	public static tsCheck<CANDIDATE = unknown>(
+		toCheck: CANDIDATE | undefined | null,
+		id: string | undefined = undefined,
+	): CANDIDATE {
 		const result = UNDEFINED.checkAlgorithm(toCheck);
 
 		if (result === true) {
 			return toCheck as CANDIDATE;
 		}
-		else {
-			throw new DBC.Infringement(`${id ? `(${id}) ` : ""}${result as string}`);
-		}
-	}
-	/** Creates this {@link UNDEFINED }. */
-	public constructor() {
-		super();
+		throw new DBC.Infringement(`${id ? `(${id}) ` : ""}${result as string}`);
 	}
 }

package/src/DBC/ZOD.ts

@@ -1,5 +1,5 @@
+import type { z } from "zod";
 import { DBC } from "../DBC";
-import { z } from 'zod';
 /**
  * A {@link DBC } defining that the an {@link object }s gotta be an instance of a certain {@link ZOD.schema }.
  *
@@ -15,7 +15,10 @@ export class ZOD extends DBC {
 	 *
 	 * @returns TRUE if the value **toCheck** complies to the specified **schema**, otherwise FALSE. */
 	// biome-ignore lint/suspicious/noExplicitAny: In order to perform an "instanceof" check.
-	public static checkAlgorithm(toCheck: any, schema: z.ZodType): boolean | string {
+	public static checkAlgorithm(
+		toCheck: any,
+		schema: z.ZodType,
+	): boolean | string {
 		const result = schema.safeParse(toCheck);
 		if (!result.success) {
 			return `Value does not comply to the specified schema. Received: "${JSON.stringify(toCheck)}". Errors: ${result.error.message}`;
@@ -99,23 +102,25 @@ export class ZOD extends DBC {
 	}
 	/**
 	 * Invokes the {@link ZOD.checkAlgorithm } passing the value **toCheck** and the {@link ZOD.schema } .
-	 * 
+	 *
 	 * @param toCheck 	See {@link ZOD.checkAlgorithm }.
 	 * @param schema	See {@link ZOD.checkAlgorithm }.
 	 * @param id		A {@link string } identifying this {@link ZOD } via the {@link DBC.Infringement }-Message.
-	 * 
+	 *
 	 * @returns The **CANDIDATE** **toCheck** doesn't fulfill this {@link ZOD }.
-	 * 
+	 *
 	 * @throws A {@link DBC.Infringement } if the **CANDIDATE** **toCheck** does not fulfill this {@link DEFINED }. */
-	public static tsCheck<CANDIDATE = unknown>(toCheck: any, schema: z.ZodType, id: string | undefined = undefined): CANDIDATE {
+	public static tsCheck<CANDIDATE = unknown>(
+		toCheck: any,
+		schema: z.ZodType,
+		id: string | undefined = undefined,
+	): CANDIDATE {
 		const result = ZOD.checkAlgorithm(toCheck, schema);
 
 		if (result === true) {
 			return toCheck;
 		}
-		else {
-			throw new DBC.Infringement(`${id ? `(${id}) ` : ""}${result as string}`);
-		}
+		throw new DBC.Infringement(`${id ? `(${id}) ` : ""}${result as string}`);
 	}
 	/**
 	 * Creates this {@link ZOD } by setting the protected property {@link ZOD.schema } used by {@link ZOD.check }.