xdbc 1.0.93 → 1.0.95

package/src/DBC/OR.ts

@@ -1,18 +1,17 @@
-import { DBC } from "../DBC.js";
+import { DBC } from "../DBC";
 /**
  * A {@link DBC } defining that all elements of an {@link object }s have to fulfill
- * one of the given {@link object }s check-methods (( toCheck : any ) => boolean | string ).
+ * one of the given {@link object }s check-methods (**( toCheck : any ) => boolean | string** ).
  *
  * @remarks
  * Maintainer: Callari, Salvatore (XDBC@WaXCode.net) */
 export class OR extends DBC {
 	// #region Condition checking.
 	/**
-	 * Checks each element of the "value"-{@link Array < any >} against the given "condition", if it is one. If it is not
-	 * the "value" itself will be checked.
+	 * Checks the **value** against the given **conditions**
 	 *
-	 * @param conditions	The { check: (toCheck: any) => boolean | string }-{@link object }s to check the "value" against.
-	 * @param value			Either "value"-{@link Array < any >}, which's elements will be checked, or the value to be
+	 * @param conditions	The **{ check: (toCheck: any) => boolean | string }**-{@link object }s to check the **value** against.
+	 * @param value			Either **value**-{@link Array < any >}, which's elements will be checked, or the value to be
 	 * 						checked itself.
 	 * @param index			If specified with "idxEnd" being undefined, this {@link Number } will be seen as the index of
 	 * 						the value-{@link Array }'s element to check. If value isn't an {@link Array } this parameter
@@ -21,9 +20,9 @@ export class OR extends DBC {
 	 * 						check within the value-{@link Array }.
 	 * @param idxEnd		Indicates the last element's index (including) of the span of value-{@link Array } elements to check.
 	 * 						Setting this parameter to -1 specifies that all value-{@link Array }'s elements beginning from the
-	 * 						specified "index" shall be checked.
+	 * 						specified **index** shall be checked.
 	 *
-	 * @returns TRUE if at least one of the provided "conditions" is fulfilled, otherwise a {@link string } containing all "conditions" returned {@link string }s separated by " || ". */
+	 * @returns TRUE if at least one of the provided **conditions** is fulfilled, otherwise a {@link string } containing all **conditions** returned {@link string }s separated by " || ". */
 	public static checkAlgorithm(
 		conditions: Array<{
 			check: (toCheck: unknown | undefined | null | object) => boolean | string;
@@ -35,32 +34,32 @@ export class OR extends DBC {
 		for (let i = 0; i < conditions.length; i++) {
 			const conditionResult = conditions[i].check(value);
 
-			if (typeof conditionResult !== "boolean") {
-				result += `${conditionResult}${i === conditions.length - 1 ? "" : " || "}`;
+			if (typeof conditionResult === "string") {
+				result += `${conditionResult}${i === conditions.length - 1 ? "" : " or "}`;
 			} else {
 				return true;
 			}
 		}
 
-		return true;
+		return result;
 	}
 	/**
 	 * A parameter-decorator factory using the {@link OR.checkAlgorithm } with either multiple or a single one
-	 * of the "realConditions" to check the tagged parameter-value against with.
-	 * When specifying an "index" and the tagged parameter's "value" is an {@link Array }, the "realConditions" apply to the
-	 * element at the specified "index".
+	 * of the **realConditions** to check the tagged parameter-value against with.
+	 * When specifying an **index** and the tagged parameter's **value** is an {@link Array }, the **realConditions** apply to the
+	 * element at the specified **index**.
 	 * If the {@link Array } is too short the currently processed { check: (toCheck: any) => boolean | string } of
-	 * "realConditions" will be verified to TRUE automatically, considering optional parameters.
-	 * If an "index" is specified but the tagged parameter's value isn't an array, the "index" is treated as being undefined.
-	 * If "index" is undefined and the tagged parameter's value is an {@link Array } each element of it will be checked
-	 * against the "realConditions".
+	 * **realConditions** will be verified to TRUE automatically, considering optional parameters.
+	 * If an **index** is specified but the tagged parameter's value isn't an array, the **index** is treated as being undefined.
+	 * If **index** is undefined and the tagged parameter's value is an {@link Array } each element of it will be checked
+	 * against the **realConditions**.
 	 *
-	 * @param realConditions	Either one or more { check: (toCheck: any) => boolean | string } to check the tagged parameter-value
+	 * @param realConditions	Either one or more **{ check: (toCheck: any) => boolean | string }** to check the tagged parameter-value
 	 * 							against with.
 	 * @param path				See {@link DBC.decPrecondition }.
 	 * @param dbc				See {@link DBC.decPrecondition }.
 	 *
-	 * @returns	A {@link string } as soon as one { check: (toCheck: any) => boolean | string } of "realConditions" returns one.
+	 * @returns	A {@link string } as soon as one { check: (toCheck: any) => boolean | string } of **realConditions** returns one.
 	 * 			Otherwise TRUE. */
 	public static PRE(
 		conditions: Array<{
@@ -88,14 +87,14 @@ export class OR extends DBC {
 	}
 	/**
 	 * A method-decorator factory using the {@link OR.checkAlgorithm } with either multiple or a single one
-	 * of the "realConditions" to check the tagged method's return-value against with.
+	 * of the **realConditions** to check the tagged method's return-value against with.
 	 *
 	 * @param realConditions	Either one or more { check: (toCheck: any) => boolean | string } to check the tagged parameter-value
 	 * 							against with.
 	 * @param path				See {@link DBC.decPrecondition }.
 	 * @param dbc				See {@link DBC.decPrecondition }.
 	 *
-	 * @returns	A {@link string } as soon as one { check: (toCheck: any) => boolean | string } of "realConditions" return one.
+	 * @returns	A {@link string } as soon as one **{ check: (toCheck: any) => boolean | string }** of **realConditions** return one.
 	 * 			Otherwise TRUE. */
 	public static POST(
 		conditions: Array<{
@@ -116,18 +115,37 @@ export class OR extends DBC {
 			path,
 		);
 	}
+	/**
+	 * A field-decorator factory using the {@link OR.checkAlgorithm } with either multiple or a single one
+	 * of the **realConditions** to check the tagged field.
+	 *
+	 * @param realConditions	Either one or more { check: (toCheck: any) => boolean | string } to check the tagged parameter-value
+	 * 							against with.
+	 * @param path				See {@link DBC.decInvariant }.
+	 * @param dbc				See {@link DBC.decInvariant }.
+	 *
+	 * @returns	See {@link DBC.decInvariant }. */
+	public static INVARIANT(
+		conditions: Array<{
+			check: (toCheck: unknown | undefined | null | object) => boolean | string;
+		}>,
+		path: string | undefined = undefined,
+		dbc = "WaXCode.DBC",
+	) {
+		return DBC.decInvariant([new OR(conditions)], path, dbc);
+	}
 	// #endregion Condition checking.
 	// #region Referenced Condition checking.
 	//
 	// For usage in dynamic scenarios (like global functions).
 	//
 	/**
-	 * Invokes the {@link OR.checkAlgorithm } passing the value "toCheck" and {@link OR.conditions }.
+	 * Invokes the {@link OR.checkAlgorithm } passing the value **toCheck** and {@link OR.conditions }.
 	 *
 	 * @param toCheck See {@link OR.checkAlgorithm }.
 	 *
 	 * @returns See {@link OR.checkAlgorithm}. */
-	public override check(toCheck: unknown | null | undefined) {
+	public check(toCheck: unknown | null | undefined) {
 		return OR.checkAlgorithm(this.conditions, toCheck);
 	}
 	/**

package/src/DBC/REGEX.ts

@@ -20,13 +20,13 @@ export class REGEX extends DBC {
 	};
 	// #region Condition checking.
 	/**
-	 * Checks if the value "toCheck" is complies to the {@link RegExp } "expression".
+	 * Checks if the value **toCheck** is complies to the {@link RegExp } **expression**.
 	 *
-	 * @param toCheck		The value that has comply to the {@link RegExp } "expression" for this {@link DBC } to be fulfilled.
-	 * @param expression	The {@link RegExp } the one "toCheck" has comply to in order for this {@link DBC } to be
+	 * @param toCheck		The value that has comply to the {@link RegExp } **expression** for this {@link DBC } to be fulfilled.
+	 * @param expression	The {@link RegExp } the one **toCheck** has comply to in order for this {@link DBC } to be
 	 * 						fulfilled.
 	 *
-	 * @returns TRUE if the value "toCheck" complies with the {@link RegExp } "expression", otherwise FALSE. */
+	 * @returns TRUE if the value **toCheck** complies with the {@link RegExp } **expression**, otherwise FALSE. */
 	public static checkAlgorithm(
 		toCheck: unknown | null | undefined,
 		expression: RegExp,
@@ -94,18 +94,34 @@ export class REGEX extends DBC {
 			path,
 		);
 	}
+	/**
+	 * A field-decorator factory using the {@link REGEX.checkAlgorithm } to determine whether this {@link DBC } is fulfilled
+	 * by the tagged field.
+	 *
+	 * @param expression	See {@link REGEX.checkAlgorithm }.
+	 * @param path			See {@link DBC.decInvariant }.
+	 * @param dbc			See {@link DBC.decInvariant }.
+	 *
+	 * @returns See {@link DBC.decInvariant }. */
+	public static INVARIANT(
+		expression: RegExp,
+		path: string | undefined = undefined,
+		dbc = "WaXCode.DBC",
+	) {
+		return DBC.decInvariant([new REGEX(expression)], path, dbc);
+	}
 	// #endregion Condition checking.
 	// #region Referenced Condition checking.
 	//
 	// For usage in dynamic scenarios (like with AE-DBC).
 	//
 	/**
-	 * Invokes the {@link EQ.checkAlgorithm } passing the value "toCheck" and {@link EQ.equivalent }.
+	 * Invokes the {@link REGEX.checkAlgorithm } passing the value **toCheck** and {@link REGEX.equivalent }.
 	 *
-	 * @param toCheck See {@link EQ.checkAlgorithm }.
+	 * @param toCheck See {@link REGEX.checkAlgorithm }.
 	 *
 	 * @returns See {@link EQ.checkAlgorithm}. */
-	public override check(toCheck: unknown | null | undefined) {
+	public check(toCheck: unknown | null | undefined) {
 		return REGEX.checkAlgorithm(toCheck, this.expression);
 	}
 	/**
@@ -118,10 +134,10 @@ export class REGEX extends DBC {
 	// #endregion Referenced Condition checking.
 	// #region In-Method checking.
 	/**
-	 * Invokes the {@link JSON_OP.checkAlgorithm } passing the value "toCheck" and {@link JSON_OP.expression }.
+	 * Invokes the {@link REGEX.checkAlgorithm } passing the value **toCheck** and {@link REGEX.expression }.
 	 *
-	 * @param toCheck		See {@link JSON_OP.checkAlgorithm} }.
-	 * @param expression	See {@link JSON_OP.checkAlgorithm} }.
+	 * @param toCheck		See {@link REGEX.checkAlgorithm}.
+	 * @param expression	See {@link REGEX.checkAlgorithm}.
 	 */
 	public static check(toCheck: unknown | null | undefined, expression: RegExp) {
 		const checkResult = REGEX.checkAlgorithm(toCheck, expression);

package/src/DBC/TYPE.ts

@@ -1,18 +1,18 @@
-import { DBC } from "../DBC.js";
+import { DBC } from "../DBC";
 /**
- * A {@link DBC } defining that the an {@link object }s gotta be of certain {@link TYPE.type }.
+ * A {@link DBC } defining that an {@link object }s gotta be of certain {@link TYPE.type }.
  *
  * @remarks
  * Author: 		Salvatore Callari (Callari@WaXCode.net) / 2025
  * Maintainer:	Salvatore Callari (XDBC@WaXCode.net) */
 export class TYPE extends DBC {
 	/**
-	 * Checks if the value "toCheck" is of the "type" specified.
+	 * Checks if the value **toCheck** is of the **type** specified.
 	 *
-	 * @param toCheck	The {@link Object } which'S "type" to check.
-	 * @param type		The type the {@link object} "toCheck" has to be of.
+	 * @param toCheck	The {@link Object } which's **type** to check.
+	 * @param type		The type the {@link object} **toCheck** has to be of.
 	 *
-	 * @returns TRUE if the value "toCheck" is of the specified "type", otherwise FALSE. */
+	 * @returns TRUE if the value **toCheck** is of the specified **type**, otherwise FALSE. */
 	// biome-ignore lint/suspicious/noExplicitAny: Necessary for dynamic type checking of also UNDEFINED.
 	public static checkAlgorithm(toCheck: any, type: string): boolean | string {
 		// biome-ignore lint/suspicious/useValidTypeof: Necessary
@@ -79,19 +79,35 @@ export class TYPE extends DBC {
 			path,
 		);
 	}
+	/**
+	 * A field-decorator factory using the {@link TYPE.checkAlgorithm } to determine whether this {@link DBC } is fulfilled
+	 * by the tagged field.
+	 *
+	 * @param type	See {@link TYPE.checkAlgorithm }.
+	 * @param path	See {@link DBC.decInvariant }.
+	 * @param dbc	See {@link DBC.decInvariant }.
+	 *
+	 * @returns See {@link DBC.decInvariant }. */
+	public static INVARIANT(
+		type: string,
+		path: string | undefined = undefined,
+		dbc = "WaXCode.DBC",
+	) {
+		return DBC.decInvariant([new TYPE(type)], path, dbc);
+	}
 	// #endregion Condition checking.
 	// #region Referenced Condition checking.
 	//
 	// For usage in dynamic scenarios (like with AE-DBC).
 	//
 	/**
-	 * Invokes the {@link TYPE.checkAlgorithm } passing the value "toCheck" and the {@link TYPE.type } .
+	 * Invokes the {@link TYPE.checkAlgorithm } passing the value **toCheck** and the {@link TYPE.type } .
 	 *
 	 * @param toCheck See {@link TYPE.checkAlgorithm }.
 	 *
 	 * @returns See {@link TYPE.checkAlgorithm}. */
 	// biome-ignore lint/suspicious/noExplicitAny: <explanation>
-	public override check(toCheck: any) {
+	public check(toCheck: any) {
 		return TYPE.checkAlgorithm(toCheck, this.type);
 	}
 	/**

package/src/DBC.ts

@@ -1,5 +1,5 @@
 /**
- * Provides a [D]esign [B]y [C]ontract Framework using decorators.
+ * Provides a **D**esign **B**y **C**ontract Framework using decorators.
  *
  * @remarks
  * Maintainer: Callari, Salvatore (XDBC@WaXCode.net) */
@@ -76,7 +76,8 @@ export class DBC {
 		return undefined;
 	}
 	/**
-	 * A method-decorator factory checking the {@link paramValueRequests } for value-requests of the method's parameter.
+	 * A method-decorator factory checking the {@link paramValueRequests } for value-requests of the method's parameter thus
+	 * also usable on setters.
 	 * When found it will invoke the "receptor" registered there, inter alia by {@link requestParamValue }, with the
 	 * parameter's value.
 	 *
@@ -115,7 +116,7 @@ export class DBC {
 			}
 			// #endregion 	Check if a value of one of the method's parameter has been requested and pass it to the
 			// 				receptor, if so.
-			// biome-ignore lint/complexity/noThisInStatic: <explanation>
+			// biome-ignore lint/complexity/noThisInStatic: Necessary.
 			return originalMethod.apply(this, args);
 		};
 
@@ -124,39 +125,65 @@ export class DBC {
 	// #endregion Parameter-value requests.
 	// #region Invariant
 	/**
+	 * A property-decorator factory serving as a **D**esign **B**y **C**ontract Invariant.
+	 * Since the value must be initialized or set according to the specified **contracts** the value will only be checked
+	 * when assigning it.
 	 *
-	 * @param toCheck
-	 * @returns
-	 */
-	check(toCheck: unknown | null | undefined): boolean | string {
-		return false;
-	}
-	/**
+	 * @param contracts The {@link DBC }-Contracts the value shall uphold.
 	 *
-	 * @param conditions
-	 * @param property
-	 * @returns
-	 */
-	public static decInvariant(conditions: Array<DBC>, property: string) {
-		return (
-			toCheck: new (...args: Array<unknown | null | undefined>) => object,
-		) => {
-			for (const condition of conditions) {
-				condition.check(new toCheck(...[])[property]);
-			}
+	 * @throws 	A {@link DBC.Infringement } whenever the property is tried to be set to a value that does not comply to the
+	 * 			specified **contracts**, by the returned method.*/
+	public static decInvariant(
+		contracts: Array<{
+			check: (toCheck: unknown | null | undefined) => boolean | string;
+		}>,
+		path: string | undefined = undefined,
+		dbc = "WaXCode.DBC",
+	) {
+		return (target: unknown, propertyKey: string | symbol) => {
+			// biome-ignore lint/suspicious/noExplicitAny: Necessary to intercept UNDEFINED and NULL.
+			let value: any;
+			// #region Replace original property.
+			Object.defineProperty(target, propertyKey, {
+				set(newValue) {
+					const realValue = path ? DBC.resolve(newValue, path) : newValue;
+					// #region Check if all "contracts" are fulfilled.
+					for (const contract of contracts) {
+						const result = contract.check(realValue);
+
+						if (typeof result === "string") {
+							DBC.resolveDBCPath(window, dbc).reportFieldInfringement(
+								result,
+								target as object,
+								path,
+								propertyKey as string,
+								realValue,
+							);
+						}
+					}
+					// #endregion Check if all "contracts" are fulfilled.
+					value = newValue;
+				},
+				enumerable: true,
+				configurable: true,
+			});
+			// #endregion Replace original property.
 		};
 	}
 	// #endregion Invariant
 	// #region Postcondition
 	/**
+	 * A method decorator factory checking the result of a method whenever it is invoked thus also usable on getters.
 	 *
-	 * @param check
-	 * @param dbc
-	 * @param path
-	 * @returns
+	 * @param check	The **(toCheck: any, object, string) => boolean | string** to use for checking.
+	 * @param dbc	See {@link DBC.resolveDBCPath }.
+	 * @param path	The dotted path referring to the actual value to check, starting form the specified one.
+	 *
+	 * @returns The **( target : object, propertyKey : string, descriptor : PropertyDescriptor ) : PropertyDescriptor**
+	 * 			invoked by Typescript.
 	 */
 	public static decPostcondition(
-		// biome-ignore lint/suspicious/noExplicitAny: Gotta be any since parameter-values may be undefined.
+		// biome-ignore lint/suspicious/noExplicitAny: Necessary to intercept UNDEFINED and NULL.
 		check: (toCheck: any, object, string) => boolean | string,
 		dbc: string,
 		path: string | undefined = undefined,
@@ -167,15 +194,11 @@ export class DBC {
 			descriptor: PropertyDescriptor,
 		): PropertyDescriptor => {
 			const originalMethod = descriptor.value;
-			// biome-ignore lint/suspicious/noExplicitAny: Gotta be any since parameter-values may be undefined.
+			// biome-ignore lint/suspicious/noExplicitAny: Necessary to intercept UNDEFINED and NULL.
 			descriptor.value = (...args: any[]) => {
 				// biome-ignore lint/complexity/noThisInStatic: <explanation>
 				const result = originalMethod.apply(this, args);
-				const realValue = path
-					? path
-							?.split(".")
-							.reduce((accumulator, current) => accumulator[current], result)
-					: result;
+				const realValue = path ? DBC.resolve(result, path) : result;
 				const checkResult = check(realValue, target, propertyKey);
 
 				if (typeof checkResult === "string") {
@@ -196,17 +219,17 @@ export class DBC {
 	}
 	// #endregion Postcondition
 	// #region Decorator
-	// #region Parameter
+	// #region Precondition
 	/**
 	 * A parameter-decorator factory that requests the tagged parameter's value passing it to the provided
 	 * "check"-method when the value becomes available.
 	 *
 	 * @param check	The "( unknown ) => void" to be invoked along with the tagged parameter's value as soon
 	 * 				as it becomes available.
-	 * @param path	The dotted path referring to the actual value to check, starting form the specified one.
 	 * @param dbc  	See {@link DBC.resolveDBCPath }.
+	 * @param path	The dotted path referring to the actual value to check, starting form the specified one.
 	 *
-	 * @returns The  { (target: object, methodName: string | symbol, parameterIndex: number ) => void } invoked by Typescript- */
+	 * @returns The **(target: object, methodName: string | symbol, parameterIndex: number ) => void** invoked by Typescript- */
 	protected static decPrecondition(
 		check: (unknown, object, string, number) => boolean | string,
 		dbc: string,
@@ -226,11 +249,7 @@ export class DBC {
 				methodName,
 				parameterIndex,
 				(value: unknown) => {
-					const realValue = path
-						? path
-								?.split(".")
-								.reduce((accumulator, current) => accumulator[current], value)
-						: value;
+					const realValue = path ? DBC.resolve(value, path) : value;
 					const result = check(realValue, target, methodName, parameterIndex);
 
 					if (typeof result === "string") {
@@ -247,7 +266,7 @@ export class DBC {
 			);
 		};
 	}
-	// #endregion Parameter
+	// #endregion Precondition
 	// #endregion Decorator
 	// #region Warning handling.
 	/** Stores settings concerning warnings. */
@@ -265,7 +284,7 @@ export class DBC {
 	}
 	// #endregion Warning handling.
 	// #region infringement handling.
-	/** Stores the setting concerning infringements */
+	/** Stores the settings concerning infringements */
 	public infringementSettings: {
 		throwException: boolean;
 		logToConsole: boolean;
@@ -293,7 +312,7 @@ export class DBC {
 		}
 	}
 	/**
-	 * Reports a parameter-infringement according via {@link reportInfringement } also generating a proper {@link string }-wrapper
+	 * Reports a parameter-infringement via {@link reportInfringement } also generating a proper {@link string }-wrapper
 	 * for the given "message","method", parameter-"index" & value.
 	 *
 	 * @param message	The {@link string } describing the infringement and it's provenience.
@@ -317,6 +336,29 @@ export class DBC {
 			path,
 		);
 	}
+	/**
+	 * Reports a field-infringement via {@link reportInfringement } also generating a proper {@link string }-wrapper
+	 * for the given **message** & **name**.
+	 *
+	 * @param message	A {@link string } describing the infringement and it's provenience.
+	 * @param key 		The property key.
+	 * @param path		The dotted-path {@link string } that leads to the value not fulfilling the contract starting from
+	 * 					the tagged one.
+	 * @param value		The value not fulfilling a contract. */
+	public reportFieldInfringement(
+		message: string,
+		target: object,
+		path: string,
+		key: string,
+		value: unknown,
+	): undefined {
+		this.reportInfringement(
+			`[ New value for "${key}"${path === undefined ? "" : `.${path}`} with value "${value}" did not fulfill one of it's contracts: ${message}]`,
+			key,
+			target,
+			path,
+		);
+	}
 	/**
 	 * Reports a returnvalue-infringement according via {@link reportInfringement } also generating a proper {@link string }-wrapper
 	 * for the given "message","method" & value.
@@ -354,14 +396,23 @@ export class DBC {
 	// #endregion Errors
 	// #endregion Classes
 	// #endregion infringement handling.
+	/**
+	 * Resolves the specified dotted {@link string }-path to a {@link DBC }.
+	 *
+	 * @param obj 	The {@link object } to start resolving from.
+	 * @param path 	The dotted {@link string }-path leading to the {@link DBC }.
+	 *
+	 * @returns The requested {@link DBC }.
+	 */
 	static resolveDBCPath = (obj, path): DBC =>
 		path
 			?.split(".")
 			.reduce((accumulator, current) => accumulator[current], obj);
 	/**
+	 * Constructs this {@link DBC } by setting the {@link DBC.infringementSettings }, define the **WaXCode** namespace in
+	 * **window** if not yet available and setting the property **DBC** in there to the instance of this {@link DBC }.
 	 *
-	 * @param infringementSettings
-	 */
+	 * @param infringementSettings See {@link DBC.infringementSettings }. */
 	constructor(
 		infringementSettings: {
 			throwException: boolean;
@@ -375,6 +426,47 @@ export class DBC {
 		// biome-ignore lint/suspicious/noExplicitAny: <explanation>
 		(window as any).WaXCode.DBC = this;
 	}
-}
+	/**
+	 * Resolves the desired {@link object } out a given one **toResolveFrom** using the specified **path**.
+	 *
+	 * @param toResolveFrom The {@link object } starting to resolve from.
+	 * @param path			The dotted path-{@link string }.
+	 * 						This string uses ., [...], and () to represent accessing nested properties,
+	 * 						array elements/object keys, and calling methods, respectively, mimicking JavaScript syntax to navigate
+	 * 						an object's structure. Code, e.g. something like a.b( 1 as number ).c, will not be executed and
+	 * 						thus make the retrieval fail.
+	 *
+	 * @returns The requested {@link object }, NULL or UNDEFINED. */
+	public static resolve(toResolveFrom: unknown, path: string) {
+		if (!toResolveFrom || typeof path !== "string") {
+			return undefined;
+		}
+
+		const parts = path.replace(/\[(['"]?)(.*?)\1\]/g, ".$2").split("."); // Handle indexers
+
+		let current = toResolveFrom;
+		for (const part of parts) {
+			if (current === null || typeof current === "undefined") {
+				return undefined;
+			}
+
+			const methodMatch = part.match(/(\w+)\((.*)\)/);
+			if (methodMatch) {
+				const methodName = methodMatch[1];
+				const argsStr = methodMatch[2];
+				const args = argsStr.split(",").map((arg) => arg.trim()); // Simple argument parsing
+				if (typeof current[methodName] === "function") {
+					current = current[methodName].apply(current, args);
+				} else {
+					return undefined; // Method not found or not a function
+				}
+			} else {
+				current = current[part];
+			}
+		}
 
+		return current;
+	}
+}
+// Set the main instance with standard **DBC.infringementSettings**.
 new DBC();