@k37z3r/jbase 2.0.0

package/dist/modules/data/arrays.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * @file src/modules/data/arrays.ts
+ * @version 2.0.0
+ * @since 2.0.0
+ * @license GPL-3.0-or-later
+ * @copyright Sven Minio 2026
+ * @author Sven Minio <https://sven-minio.de>
+ * @category Data
+ * @description
+ * * 🇬🇧: Utility functions for array manipulation and data processing.
+ * * 🇩🇪: Hilfsfunktionen für Array-Manipulation und Datenverarbeitung.
+ * @requires ./types
+ * * 🇬🇧: Depends on match logic and types.
+ * * 🇩🇪: Hängt von Match-Logik und Typen ab.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.find = exports.remove = void 0;
+exports.chunk = chunk;
+exports.merge = merge;
+exports.add = add;
+const types_1 = require("./types");
+/**
+ * * 🇬🇧: Splits an array into smaller groups (chunks). Ideal for pagination or grid layouts.
+ * * 🇩🇪: Teilt ein Array in kleinere Gruppen (Chunks) auf. Ideal für Pagination oder Grid-Layouts.
+ * @example
+ * chunk([1, 2, 3, 4, 5], 2) // => [[1, 2], [3, 4], [5]]
+ * @param array
+ * * 🇬🇧: The source array.
+ * * 🇩🇪: Das Ursprungs-Array.
+ * @param size
+ * * 🇬🇧: The size of each chunk.
+ * * 🇩🇪: Die Größe jedes Chunks.
+ * @returns
+ * * 🇬🇧: An array of arrays.
+ * * 🇩🇪: Ein Array aus Arrays.
+ */
+function chunk(array, size) {
+    const chunks = [];
+    for (let i = 0; i < array.length; i += size) {
+        chunks.push(array.slice(i, i + size));
+    }
+    return chunks;
+}
+/**
+ * * 🇬🇧: Merges multiple arrays into a single flat array.
+ * * 🇩🇪: Führt mehrere Arrays zu einem einzigen flachen Array zusammen.
+ * @param arrays
+ * * 🇬🇧: A list of arrays.
+ * * 🇩🇪: Eine Liste von Arrays.
+ * @returns
+ * * 🇬🇧: A new, merged array.
+ * * 🇩🇪: Ein neues, zusammengefügtes Array.
+ */
+function merge(...arrays) {
+    return [].concat(...arrays);
+}
+/**
+ * * 🇬🇧: Safely adds an element at a specific position without mutating the original array (Immutable).
+ * * 🇩🇪: Fügt ein Element sicher an einer bestimmten Position hinzu, ohne das Original-Array zu mutieren (Immutable).
+ * @param array
+ * * 🇬🇧: The array.
+ * * 🇩🇪: Das Array.
+ * @param item
+ * * 🇬🇧: The item to add.
+ * * 🇩🇪: Das hinzuzufügende Element.
+ * @param index
+ * * 🇬🇧: The position (default: end). Negative values count from the back (-1 = before the last one).
+ * * 🇩🇪: Die Position (Standard: Ende). Negative Werte zählen von hinten (-1 = vor dem letzten).
+ * @returns
+ * * 🇬🇧: A new array including the element.
+ * * 🇩🇪: Ein neues Array inklusive dem Element.
+ */
+function add(array, item, index = array.length) {
+    const copy = [...array];
+    const idx = index < 0 ? array.length + index + 1 : index;
+    copy.splice(idx, 0, item);
+    return copy;
+}
+/**
+ * * 🇬🇧: Removes elements based on index or match logic.
+ * * 🇩🇪: Entfernt Elemente basierend auf Index oder Match-Logik.
+ */
+exports.remove = {
+    /**
+     * * 🇬🇧: Removes an element at a specific index.
+     * * 🇩🇪: Entfernt ein Element an einem spezifischen Index.
+     * @param array
+     * * 🇬🇧: The array.
+     * * 🇩🇪: Das Array.
+     * @param index
+     * * 🇬🇧: The index (negative values allowed).
+     * * 🇩🇪: Der Index (negativ möglich).
+     */
+    at(array, index) {
+        const copy = [...array];
+        const idx = index < 0 ? array.length + index : index;
+        if (idx >= 0 && idx < copy.length) {
+            copy.splice(idx, 1);
+        }
+        return copy;
+    },
+    /**
+     * * 🇬🇧: Removes the first element.
+     * * 🇩🇪: Entfernt das erste Element.
+     */
+    first(array) { return array.slice(1); },
+    /**
+     * * 🇬🇧: Removes the last element.
+     * * 🇩🇪: Entfernt das letzte Element.
+     */
+    last(array) { return array.slice(0, -1); },
+    /**
+     * * 🇬🇧: Removes all elements matching a query condition.
+     * * 🇩🇪: Entfernt alle Elemente, die einer Suchbedingung entsprechen.
+     * @example
+     * remove.byMatch(users, 'Admin', 'exact', 'role')
+     * @param array
+     * * 🇬🇧: The array.
+     * * 🇩🇪: Das Array.
+     * @param query
+     * * 🇬🇧: The search query.
+     * * 🇩🇪: Der Suchbegriff.
+     * @param mode
+     * * 🇬🇧: The comparison mode ('exact', 'contains', 'startsWith', 'endsWith').
+     * * 🇩🇪: Der Vergleichsmodus ('exact', 'contains', 'startsWith', 'endsWith').
+     * @param key
+     * * 🇬🇧: (Optional) The object key if it is an array of objects.
+     * * 🇩🇪: (Optional) Der Objektschlüssel, falls es ein Array von Objekten ist.
+     */
+    byMatch(array, query, mode = 'exact', key) {
+        return array.filter(item => {
+            const val = key ? item[key] : item;
+            return !(0, types_1.checkMatch)(val, query, mode);
+        });
+    }
+};
+/**
+ * * 🇬🇧: Searches for elements in the array.
+ * * 🇩🇪: Sucht Elemente im Array.
+ */
+exports.find = {
+    /**
+     * * 🇬🇧: Finds the index of the first match.
+     * * 🇩🇪: Findet den Index des ersten Treffers.
+     * @returns
+     * * 🇬🇧: Index or -1.
+     * * 🇩🇪: Index oder -1.
+     */
+    index(array, query, mode = 'exact', key) {
+        return array.findIndex(item => {
+            const val = key ? item[key] : item;
+            return (0, types_1.checkMatch)(val, query, mode);
+        });
+    },
+    /**
+     * * 🇬🇧: Returns all elements matching the condition (Filter).
+     * * 🇩🇪: Gibt alle Elemente zurück, die der Bedingung entsprechen (Filter).
+     */
+    all(array, query, mode = 'exact', key) {
+        return array.filter(item => {
+            const val = key ? item[key] : item;
+            return (0, types_1.checkMatch)(val, query, mode);
+        });
+    },
+    /**
+     * * 🇬🇧: Returns the first matching element (or undefined).
+     * * 🇩🇪: Gibt das erste gefundene Element zurück (oder undefined).
+     */
+    first(array, query, mode = 'exact', key) {
+        return array.find(item => {
+            const val = key ? item[key] : item;
+            return (0, types_1.checkMatch)(val, query, mode);
+        });
+    }
+};
+//# sourceMappingURL=arrays.js.map

package/dist/modules/data/arrays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrays.js","sourceRoot":"","sources":["../../../src/modules/data/arrays.ts"],"names":[],"mappings":"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"}

package/dist/modules/data/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @file src/modules/data/index.ts
+ * @version 2.0.0
+ * @since 2.0.0
+ * * @license GPL-3.0-or-later
+ * @copyright Sven Minio 2026
+ * @author Sven Minio <https://sven-minio.de>
+ * @category Data
+ * @description
+ * * 🇬🇧: Central entry point for data manipulation modules. Aggregates array and object utilities.
+ * * 🇩🇪: Zentraler Einstiegspunkt für Datenmanipulations-Module. Aggregiert Array- und Objekt-Hilfsmethoden.
+ * @requires ./arrays
+ * * 🇬🇧: Array manipulation methods.
+ * * 🇩🇪: Methoden zur Array-Manipulation.
+ * @requires ./objects
+ * * 🇬🇧: Object manipulation methods.
+ * * 🇩🇪: Methoden zur Objekt-Manipulation.
+ */
+import * as arrayMethods from './arrays';
+import * as objectMethods from './objects';
+/**
+ * * 🇬🇧: Central data utility object. Bundles array ('arr') and object ('obj') manipulation methods.
+ * * 🇩🇪: Zentrales Daten-Utility-Objekt. Bündelt Methoden zur Array- ('arr') und Objekt-Manipulation ('obj').
+ */
+export declare const data: {
+    arr: typeof arrayMethods;
+    obj: typeof objectMethods;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/data/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/data/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,YAAY,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,aAAa,MAAM,WAAW,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,IAAI;;;CAGhB,CAAC"}

package/dist/modules/data/index.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * @file src/modules/data/index.ts
+ * @version 2.0.0
+ * @since 2.0.0
+ * * @license GPL-3.0-or-later
+ * @copyright Sven Minio 2026
+ * @author Sven Minio <https://sven-minio.de>
+ * @category Data
+ * @description
+ * * 🇬🇧: Central entry point for data manipulation modules. Aggregates array and object utilities.
+ * * 🇩🇪: Zentraler Einstiegspunkt für Datenmanipulations-Module. Aggregiert Array- und Objekt-Hilfsmethoden.
+ * @requires ./arrays
+ * * 🇬🇧: Array manipulation methods.
+ * * 🇩🇪: Methoden zur Array-Manipulation.
+ * @requires ./objects
+ * * 🇬🇧: Object manipulation methods.
+ * * 🇩🇪: Methoden zur Objekt-Manipulation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.data = void 0;
+const tslib_1 = require("tslib");
+const arrayMethods = tslib_1.__importStar(require("./arrays"));
+const objectMethods = tslib_1.__importStar(require("./objects"));
+/**
+ * * 🇬🇧: Central data utility object. Bundles array ('arr') and object ('obj') manipulation methods.
+ * * 🇩🇪: Zentrales Daten-Utility-Objekt. Bündelt Methoden zur Array- ('arr') und Objekt-Manipulation ('obj').
+ */
+exports.data = {
+    arr: arrayMethods,
+    obj: objectMethods
+};
+//# sourceMappingURL=index.js.map

package/dist/modules/data/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/data/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;;AAEH,+DAAyC;AACzC,iEAA2C;AAE3C;;;GAGG;AACU,QAAA,IAAI,GAAG;IAChB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,aAAa;CACrB,CAAC"}

package/dist/modules/data/objects.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @file src/modules/data/objects.ts
+ * @version 2.0.0
+ * @since 2.0.0
+ * @license GPL-3.0-or-later
+ * @copyright Sven Minio 2026
+ * @author Sven Minio <https://sven-minio.de>
+ * @category Data
+ * @description
+ * * 🇬🇧: Utility functions for object manipulation (e.g., deep merging, extension).
+ * * 🇩🇪: Hilfsfunktionen für Objekt-Manipulation (z.B. Deep Merge, Erweiterung).
+ * @requires ./types
+ * * 🇬🇧: Depends on match logic and types.
+ * * 🇩🇪: Hängt von Match-Logik und Typen ab.
+ */
+import { MatchMode } from './types';
+/**
+ * * 🇬🇧: Recursively merges multiple objects (Deep Merge).
+ * * 🇩🇪: Führt mehrere Objekte rekursiv zusammen (Deep Merge).
+ * @example
+ * merge({ a: 1, b: { x: 1 } }, { b: { y: 2 } }) // => { a: 1, b: { x: 1, y: 2 } }
+ * @param target
+ * * 🇬🇧: The target object (will be modified!).
+ * * 🇩🇪: Das Zielobjekt (wird modifiziert!).
+ * @param sources
+ * * 🇬🇧: One or more source objects.
+ * * 🇩🇪: Ein oder mehrere Quellobjekte.
+ * @returns
+ * * 🇬🇧: The modified target object.
+ * * 🇩🇪: Das modifizierte Zielobjekt.
+ */
+export declare function merge(target: any, ...sources: any[]): any;
+/**
+ * * 🇬🇧: Creates a new object containing only the specified keys (Allowlist).
+ * * 🇩🇪: Erstellt ein neues Objekt, das nur die angegebenen Schlüssel enthält (Allowlist).
+ * @param obj
+ * * 🇬🇧: The source object.
+ * * 🇩🇪: Das Quellobjekt.
+ * @param keys
+ * * 🇬🇧: Array of keys to keep.
+ * * 🇩🇪: Array der Schlüssel, die übernommen werden sollen.
+ * @returns
+ * * 🇬🇧: A new object with selected keys.
+ * * 🇩🇪: Ein neues Objekt mit den gewählten Schlüsseln.
+ */
+export declare function pick<T extends object, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+/**
+ * * 🇬🇧: Creates a new object containing all keys EXCEPT the specified ones (Blocklist).
+ * * 🇩🇪: Erstellt ein neues Objekt, das alle Schlüssel enthält AUẞER den angegebenen (Blocklist).
+ * @param obj
+ * * 🇬🇧: The source object.
+ * * 🇩🇪: Das Quellobjekt.
+ * @param keys
+ * * 🇬🇧: Array of keys to remove.
+ * * 🇩🇪: Array der Schlüssel, die entfernt werden sollen.
+ * @returns
+ * * 🇬🇧: A new object without the specified keys.
+ * * 🇩🇪: Ein neues Objekt ohne die angegebenen Schlüssel.
+ */
+export declare function omit<T, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
+/**
+ * * 🇬🇧: Safely retrieves a value from a nested object (Safe Navigation).
+ * * 🇩🇪: Liest einen Wert aus einem verschachtelten Objekt sicher aus (Safe Navigation).
+ * @example
+ * get(user, 'address.city') // Returns city or undefined
+ * @param obj
+ * * 🇬🇧: The object.
+ * * 🇩🇪: Das Objekt.
+ * @param path
+ * * 🇬🇧: The path as a dot-notation string.
+ * * 🇩🇪: Der Pfad als String mit Punkt-Notation.
+ * @returns
+ * * 🇬🇧: The found value or undefined.
+ * * 🇩🇪: Der gefundene Wert oder undefined.
+ */
+export declare function get(obj: any, path: string): any;
+/**
+ * * 🇬🇧: Sets a value deeply within a nested object. Creates missing intermediate objects automatically.
+ * * 🇩🇪: Setzt einen Wert tief in einem verschachtelten Objekt. Erstellt fehlende Zwischen-Objekte automatisch.
+ * @param obj
+ * * 🇬🇧: The object to modify.
+ * * 🇩🇪: Das zu modifizierende Objekt.
+ * @param path
+ * * 🇬🇧: The path as a string (e.g., 'settings.theme.color').
+ * * 🇩🇪: Der Pfad als String (z.B. 'settings.theme.color').
+ * @param value
+ * * 🇬🇧: The value to set.
+ * * 🇩🇪: Der zu setzende Wert.
+ */
+export declare function set(obj: any, path: string, value: any): void;
+/**
+ * * 🇬🇧: Searches keys or values in the object.
+ * * 🇩🇪: Sucht Keys oder Values im Objekt.
+ */
+export declare const find: {
+    /**
+     * * 🇬🇧: Finds all keys matching the query.
+     * * 🇩🇪: Findet alle Schlüssel (Keys), die auf den Suchbegriff passen.
+     * @example find.key(config, 'api_', 'startsWith')
+     */
+    key(obj: any, query: string, mode?: MatchMode): string[];
+    /**
+     * * 🇬🇧: Finds all values matching the query.
+     * * 🇩🇪: Findet alle Werte (Values), die auf den Suchbegriff passen.
+     */
+    value(obj: any, query: string, mode?: MatchMode): any[];
+};
+//# sourceMappingURL=objects.d.ts.map

package/dist/modules/data/objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../../src/modules/data/objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAc,MAAM,SAAS,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,CAgBzD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAMvF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAMxE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAE/C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAS5D;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI;IACb;;;;OAIG;aACM,GAAG,SAAS,MAAM,SAAQ,SAAS,GAAa,MAAM,EAAE;IAIjE;;;OAGG;eACQ,GAAG,SAAS,MAAM,SAAQ,SAAS,GAAa,GAAG,EAAE;CAGnE,CAAC"}

package/dist/modules/data/objects.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * @file src/modules/data/objects.ts
+ * @version 2.0.0
+ * @since 2.0.0
+ * @license GPL-3.0-or-later
+ * @copyright Sven Minio 2026
+ * @author Sven Minio <https://sven-minio.de>
+ * @category Data
+ * @description
+ * * 🇬🇧: Utility functions for object manipulation (e.g., deep merging, extension).
+ * * 🇩🇪: Hilfsfunktionen für Objekt-Manipulation (z.B. Deep Merge, Erweiterung).
+ * @requires ./types
+ * * 🇬🇧: Depends on match logic and types.
+ * * 🇩🇪: Hängt von Match-Logik und Typen ab.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.find = void 0;
+exports.merge = merge;
+exports.pick = pick;
+exports.omit = omit;
+exports.get = get;
+exports.set = set;
+const types_1 = require("./types");
+/**
+ * * 🇬🇧: Recursively merges multiple objects (Deep Merge).
+ * * 🇩🇪: Führt mehrere Objekte rekursiv zusammen (Deep Merge).
+ * @example
+ * merge({ a: 1, b: { x: 1 } }, { b: { y: 2 } }) // => { a: 1, b: { x: 1, y: 2 } }
+ * @param target
+ * * 🇬🇧: The target object (will be modified!).
+ * * 🇩🇪: Das Zielobjekt (wird modifiziert!).
+ * @param sources
+ * * 🇬🇧: One or more source objects.
+ * * 🇩🇪: Ein oder mehrere Quellobjekte.
+ * @returns
+ * * 🇬🇧: The modified target object.
+ * * 🇩🇪: Das modifizierte Zielobjekt.
+ */
+function merge(target, ...sources) {
+    if (!sources.length)
+        return target;
+    const source = sources.shift();
+    if (isObject(target) && isObject(source)) {
+        for (const key in source) {
+            if (key === '__proto__' || key === 'constructor')
+                continue;
+            if (isObject(source[key])) {
+                if (!target[key])
+                    Object.assign(target, { [key]: {} });
+                merge(target[key], source[key]);
+            }
+            else {
+                Object.assign(target, { [key]: source[key] });
+            }
+        }
+    }
+    return merge(target, ...sources);
+}
+/**
+ * * 🇬🇧: Creates a new object containing only the specified keys (Allowlist).
+ * * 🇩🇪: Erstellt ein neues Objekt, das nur die angegebenen Schlüssel enthält (Allowlist).
+ * @param obj
+ * * 🇬🇧: The source object.
+ * * 🇩🇪: Das Quellobjekt.
+ * @param keys
+ * * 🇬🇧: Array of keys to keep.
+ * * 🇩🇪: Array der Schlüssel, die übernommen werden sollen.
+ * @returns
+ * * 🇬🇧: A new object with selected keys.
+ * * 🇩🇪: Ein neues Objekt mit den gewählten Schlüsseln.
+ */
+function pick(obj, keys) {
+    const ret = {};
+    keys.forEach(key => {
+        if (key in obj)
+            ret[key] = obj[key];
+    });
+    return ret;
+}
+/**
+ * * 🇬🇧: Creates a new object containing all keys EXCEPT the specified ones (Blocklist).
+ * * 🇩🇪: Erstellt ein neues Objekt, das alle Schlüssel enthält AUẞER den angegebenen (Blocklist).
+ * @param obj
+ * * 🇬🇧: The source object.
+ * * 🇩🇪: Das Quellobjekt.
+ * @param keys
+ * * 🇬🇧: Array of keys to remove.
+ * * 🇩🇪: Array der Schlüssel, die entfernt werden sollen.
+ * @returns
+ * * 🇬🇧: A new object without the specified keys.
+ * * 🇩🇪: Ein neues Objekt ohne die angegebenen Schlüssel.
+ */
+function omit(obj, keys) {
+    const ret = { ...obj };
+    keys.forEach(key => {
+        delete ret[key];
+    });
+    return ret;
+}
+/**
+ * * 🇬🇧: Safely retrieves a value from a nested object (Safe Navigation).
+ * * 🇩🇪: Liest einen Wert aus einem verschachtelten Objekt sicher aus (Safe Navigation).
+ * @example
+ * get(user, 'address.city') // Returns city or undefined
+ * @param obj
+ * * 🇬🇧: The object.
+ * * 🇩🇪: Das Objekt.
+ * @param path
+ * * 🇬🇧: The path as a dot-notation string.
+ * * 🇩🇪: Der Pfad als String mit Punkt-Notation.
+ * @returns
+ * * 🇬🇧: The found value or undefined.
+ * * 🇩🇪: Der gefundene Wert oder undefined.
+ */
+function get(obj, path) {
+    return path.split('.').reduce((acc, part) => acc && acc[part], obj);
+}
+/**
+ * * 🇬🇧: Sets a value deeply within a nested object. Creates missing intermediate objects automatically.
+ * * 🇩🇪: Setzt einen Wert tief in einem verschachtelten Objekt. Erstellt fehlende Zwischen-Objekte automatisch.
+ * @param obj
+ * * 🇬🇧: The object to modify.
+ * * 🇩🇪: Das zu modifizierende Objekt.
+ * @param path
+ * * 🇬🇧: The path as a string (e.g., 'settings.theme.color').
+ * * 🇩🇪: Der Pfad als String (z.B. 'settings.theme.color').
+ * @param value
+ * * 🇬🇧: The value to set.
+ * * 🇩🇪: Der zu setzende Wert.
+ */
+function set(obj, path, value) {
+    const parts = path.split('.');
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (!current[part])
+            current[part] = {};
+        current = current[part];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+/**
+ * * 🇬🇧: Searches keys or values in the object.
+ * * 🇩🇪: Sucht Keys oder Values im Objekt.
+ */
+exports.find = {
+    /**
+     * * 🇬🇧: Finds all keys matching the query.
+     * * 🇩🇪: Findet alle Schlüssel (Keys), die auf den Suchbegriff passen.
+     * @example find.key(config, 'api_', 'startsWith')
+     */
+    key(obj, query, mode = 'exact') {
+        return Object.keys(obj).filter(key => (0, types_1.checkMatch)(key, query, mode));
+    },
+    /**
+     * * 🇬🇧: Finds all values matching the query.
+     * * 🇩🇪: Findet alle Werte (Values), die auf den Suchbegriff passen.
+     */
+    value(obj, query, mode = 'exact') {
+        return Object.values(obj).filter(val => (0, types_1.checkMatch)(val, query, mode));
+    }
+};
+// Helper
+function isObject(item) {
+    return (item && typeof item === 'object' && !Array.isArray(item));
+}
+//# sourceMappingURL=objects.js.map

package/dist/modules/data/objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.js","sourceRoot":"","sources":["../../../src/modules/data/objects.ts"],"names":[],"mappings":"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"}

package/dist/modules/data/types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @file src/modules/data/types.ts
+ * @version 2.0.0
+ * @since 2.0.0
+ * @license GPL-3.0-or-later
+ * @copyright Sven Minio 2026
+ * @author Sven Minio <https://sven-minio.de>
+ * @category Data
+ * @description
+ * * 🇬🇧: Type definitions and validation helpers for data structures.
+ * * 🇩🇪: Typ-Definitionen und Validierungs-Hilfsmittel für Datenstrukturen.
+ */
+/**
+ * * 🇬🇧: Defines the matching modes for search operations.
+ * * 🇩🇪: Definiert die Vergleichsmodi für Suchoperationen.
+ */
+export type MatchMode = 'exact' | 'contains' | 'startsWith' | 'endsWith';
+/**
+ * * 🇬🇧: Internal helper to compare values based on the specified mode. Converts values to strings and lowercase for comparison.
+ * * 🇩🇪: Interner Helfer zum Vergleichen von Werten basierend auf dem angegebenen Modus. Konvertiert Werte für den Vergleich in Strings und Kleinschreibung.
+ * @param value
+ * * 🇬🇧: The value to check.
+ * * 🇩🇪: Der zu prüfende Wert.
+ * @param query
+ * * 🇬🇧: The search query.
+ * * 🇩🇪: Der Suchbegriff.
+ * @param mode
+ * * 🇬🇧: The matching mode.
+ * * 🇩🇪: Der Vergleichsmodus.
+ * @returns
+ * * 🇬🇧: True if the value matches the query.
+ * * 🇩🇪: True, wenn der Wert mit der Query übereinstimmt.
+ */
+export declare function checkMatch(value: any, query: any, mode: MatchMode): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/modules/data/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/modules/data/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,CAAC;AAEzE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAW3E"}

package/dist/modules/data/types.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * @file src/modules/data/types.ts
+ * @version 2.0.0
+ * @since 2.0.0
+ * @license GPL-3.0-or-later
+ * @copyright Sven Minio 2026
+ * @author Sven Minio <https://sven-minio.de>
+ * @category Data
+ * @description
+ * * 🇬🇧: Type definitions and validation helpers for data structures.
+ * * 🇩🇪: Typ-Definitionen und Validierungs-Hilfsmittel für Datenstrukturen.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkMatch = checkMatch;
+/**
+ * * 🇬🇧: Internal helper to compare values based on the specified mode. Converts values to strings and lowercase for comparison.
+ * * 🇩🇪: Interner Helfer zum Vergleichen von Werten basierend auf dem angegebenen Modus. Konvertiert Werte für den Vergleich in Strings und Kleinschreibung.
+ * @param value
+ * * 🇬🇧: The value to check.
+ * * 🇩🇪: Der zu prüfende Wert.
+ * @param query
+ * * 🇬🇧: The search query.
+ * * 🇩🇪: Der Suchbegriff.
+ * @param mode
+ * * 🇬🇧: The matching mode.
+ * * 🇩🇪: Der Vergleichsmodus.
+ * @returns
+ * * 🇬🇧: True if the value matches the query.
+ * * 🇩🇪: True, wenn der Wert mit der Query übereinstimmt.
+ */
+function checkMatch(value, query, mode) {
+    const valStr = String(value).toLowerCase();
+    const queryStr = String(query).toLowerCase();
+    switch (mode) {
+        case 'exact': return valStr === queryStr;
+        case 'startsWith': return valStr.startsWith(queryStr);
+        case 'endsWith': return valStr.endsWith(queryStr);
+        case 'contains': return valStr.includes(queryStr);
+        default: return false;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/modules/data/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/modules/data/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAwBH,gCAWC;AA3BD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,UAAU,CAAC,KAAU,EAAE,KAAU,EAAE,IAAe;IAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAE7C,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,OAAO,CAAC,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC;QACzC,KAAK,YAAY,CAAC,CAAC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACtD,KAAK,UAAU,CAAC,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClD,KAAK,UAAU,CAAC,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClD,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC;IAC1B,CAAC;AACL,CAAC"}

package/dist/modules/dom/attributes.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @file src/modules/dom/attributes.ts
+ * @version 2.0.0
+ * @since 2.0.0
+ * @license GPL-3.0-or-later
+ * @copyright Sven Minio 2026
+ * @author Sven Minio <https://sven-minio.de>
+ * @category DOM
+ * @description
+ * * 🇬🇧: Methods for getting and setting HTML attributes and properties (attr, data, val).
+ * * 🇩🇪: Methoden zum Lesen und Setzen von HTML-Attributen und Eigenschaften (attr, data, val).
+ * @requires ../../core
+ * * 🇬🇧: Depends on the core jBase class for type definitions.
+ * * 🇩🇪: Hängt von der Core-jBase-Klasse für Typ-Definitionen ab.
+ */
+import { jBase } from '../../core';
+/**
+ * * 🇬🇧: Gets an attribute from the first element or sets it for all elements in the selection.
+ * * 🇩🇪: Liest ein Attribut vom ersten Element oder setzt es für alle Elemente in der Auswahl.
+ * @param name
+ * * 🇬🇧: The name of the attribute (e.g., 'href', 'data-id').
+ * * 🇩🇪: Der Name des Attributs (z.B. 'href', 'data-id').
+ * @param value
+ * * 🇬🇧: (Optional) The value to set. If undefined, acts as a getter.
+ * * 🇩🇪: (Optional) Der zu setzende Wert. Wenn nicht angegeben, wird gelesen.
+ * @returns
+ * * 🇬🇧: The attribute value (string/null) when reading, or the jBase instance when writing.
+ * * 🇩🇪: Beim Lesen: Der Wert des Attributs (string/null). Beim Schreiben: Die jBase-Instanz.
+ */
+export declare function attr(this: jBase, name: string, value?: string): string | null | jBase;
+/**
+ * * 🇬🇧: Gets the 'value' from the first form element or sets it for all elements. Supports Input, Textarea, and Select elements.
+ * * 🇩🇪: Liest den 'value' vom ersten Formularelement oder setzt ihn für alle Elemente. Unterstützt Input-, Textarea- und Select-Elemente.
+ * @param value
+ * * 🇬🇧: (Optional) The value to set. If undefined, acts as a getter.
+ * * 🇩🇪: (Optional) Der zu setzende Wert. Wenn nicht angegeben, wird gelesen.
+ * @returns
+ * * 🇬🇧: The current value as a string when reading, or the jBase instance when writing.
+ * * 🇩🇪: Beim Lesen: Der aktuelle Wert als String. Beim Schreiben: Die jBase-Instanz.
+ */
+export declare function val(this: jBase, value?: string): string | jBase;
+//# sourceMappingURL=attributes.d.ts.map