@k37z3r/jbase 2.0.1 → 2.0.3

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

@@ -1,131 +1,163 @@
 /**
  * @file src/modules/data/arrays.ts
- * @version 2.0.0
+ * @version 2.0.2
  * @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.
+ * * Utility functions for array manipulation and data processing.
  * @requires ./types
- * * 🇬🇧: Depends on match logic and types.
- * * 🇩🇪: Hängt von Match-Logik und Typen ab.
+ * * Depends on types.
  */
 import { MatchMode } from './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.
+ * * Splits an array into smaller groups (chunks). Ideal for pagination or grid layouts.
  * @example
- * chunk([1, 2, 3, 4, 5], 2) // => [[1, 2], [3, 4], [5]]
+ * chunk([1, 2, 3, 4, 5], 2) => [[1, 2], [3, 4], [5]]
  * @param array
- * * 🇬🇧: The source array.
- * * 🇩🇪: Das Ursprungs-Array.
+ * * The source array.
  * @param size
- * * 🇬🇧: The size of each chunk.
- * * 🇩🇪: Die Größe jedes Chunks.
+ * * The size of each chunk.
  * @returns
- * * 🇬🇧: An array of arrays.
- * * 🇩🇪: Ein Array aus Arrays.
+ * * An array of arrays.
  */
 export declare function chunk<T>(array: T[], size: number): T[][];
 /**
- * * 🇬🇧: Merges multiple arrays into a single flat array.
- * * 🇩🇪: Führt mehrere Arrays zu einem einzigen flachen Array zusammen.
+ * * Merges multiple arrays into a single flat array.
  * @param arrays
- * * 🇬🇧: A list of arrays.
- * * 🇩🇪: Eine Liste von Arrays.
+ * * A list of arrays.
  * @returns
- * * 🇬🇧: A new, merged array.
- * * 🇩🇪: Ein neues, zusammengefügtes Array.
+ * * A new, merged array.
  */
-export declare function merge<T>(...arrays: T[][]): T[];
+export declare function mergeArray<T>(...arrays: T[][]): T[];
 /**
- * * 🇬🇧: 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).
+ * * Safely adds an element at a specific position without mutating the original array (Immutable).
  * @param array
- * * 🇬🇧: The array.
- * * 🇩🇪: Das Array.
+ * * The array.
  * @param item
- * * 🇬🇧: The item to add.
- * * 🇩🇪: Das hinzuzufügende Element.
+ * * The item to add.
  * @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).
+ * * The position (default: end). Negative values count from the back (-1 = before the last one).
  * @returns
- * * 🇬🇧: A new array including the element.
- * * 🇩🇪: Ein neues Array inklusive dem Element.
+ * * A new array including the element.
  */
 export declare function add<T>(array: T[], item: T, index?: number): T[];
 /**
- * * 🇬🇧: Removes elements based on index or match logic.
- * * 🇩🇪: Entfernt Elemente basierend auf Index oder Match-Logik.
+ * * Removes elements based on index or match logic.
  */
 export declare const remove: {
     /**
-     * * 🇬🇧: Removes an element at a specific index.
-     * * 🇩🇪: Entfernt ein Element an einem spezifischen Index.
+     * * Removes an element at a specific index.
      * @param array
-     * * 🇬🇧: The array.
-     * * 🇩🇪: Das Array.
+     * * The array.
      * @param index
-     * * 🇬🇧: The index (negative values allowed).
-     * * 🇩🇪: Der Index (negativ möglich).
+     * * The index (negative values allowed).
      */
     at<T>(array: T[], index: number): T[];
     /**
-     * * 🇬🇧: Removes the first element.
-     * * 🇩🇪: Entfernt das erste Element.
+     * * Removes the first element.
+     * @param array
+     * * The array.
      */
     first<T>(array: T[]): T[];
     /**
-     * * 🇬🇧: Removes the last element.
-     * * 🇩🇪: Entfernt das letzte Element.
+     * * Removes the last element.
+     * @param array
+     * * The array.
      */
     last<T>(array: T[]): T[];
     /**
-     * * 🇬🇧: Removes all elements matching a query condition.
-     * * 🇩🇪: Entfernt alle Elemente, die einer Suchbedingung entsprechen.
+     * * Removes all elements matching a query condition.
      * @example
      * remove.byMatch(users, 'Admin', 'exact', 'role')
      * @param array
-     * * 🇬🇧: The array.
-     * * 🇩🇪: Das Array.
+     * * The array.
      * @param query
-     * * 🇬🇧: The search query.
-     * * 🇩🇪: Der Suchbegriff.
+     * * The search query.
      * @param mode
-     * * 🇬🇧: The comparison mode ('exact', 'contains', 'startsWith', 'endsWith').
-     * * 🇩🇪: Der Vergleichsmodus ('exact', 'contains', 'startsWith', 'endsWith').
+     * * The comparison mode ('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.
+     * * (Optional) The object key if it is an array of objects.
      */
     byMatch<T>(array: T[], query: string | number, mode?: MatchMode, key?: keyof T): T[];
 };
 /**
- * * 🇬🇧: Searches for elements in the array.
- * * 🇩🇪: Sucht Elemente im Array.
+ * * Searches for elements in the array.
  */
 export declare const find: {
     /**
-     * * 🇬🇧: Finds the index of the first match.
-     * * 🇩🇪: Findet den Index des ersten Treffers.
+     * * Finds the index of the first match.
+     * @param array
+     * * The array.
+     * @param query
+     * * The search query.
+     * @param mode
+     * * The comparison mode ('exact', 'contains', 'startsWith', 'endsWith').
+     * @param key
+     * * (Optional) The object key if it is an array of objects.
      * @returns
-     * * 🇬🇧: Index or -1.
-     * * 🇩🇪: Index oder -1.
+     * * Index or -1.
      */
-    index<T>(array: T[], query: string | number, mode?: MatchMode, key?: keyof T): number;
+    at<T>(array: T[], query: string | number, mode?: MatchMode, key?: keyof T): number;
     /**
-     * * 🇬🇧: Returns all elements matching the condition (Filter).
-     * * 🇩🇪: Gibt alle Elemente zurück, die der Bedingung entsprechen (Filter).
+     * * Returns all elements matching the condition (Filter).
+     * @param array
+     * * The array.
+     * @param query
+     * * The search query.
+     * @param mode
+     * * The comparison mode ('exact', 'contains', 'startsWith', 'endsWith').
+     * @param key
+     * * (Optional) The object key if it is an array of objects.
+     * @returns
+     * * All matching elements or -1.
      */
     all<T>(array: T[], query: string | number, mode?: MatchMode, key?: keyof T): T[];
     /**
-     * * 🇬🇧: Returns the first matching element (or undefined).
-     * * 🇩🇪: Gibt das erste gefundene Element zurück (oder undefined).
+     * * Returns the first matching element (or undefined).
+     * @param array
+     * * The array.
+     * @param query
+     * * The search query.
+     * @param mode
+     * * The comparison mode ('exact', 'contains', 'startsWith', 'endsWith').
+     * @param key
+     * * (Optional) The object key if it is an array of objects.
+     * @returns
+     * * Index or -1.
      */
     first<T>(array: T[], query: string | number, mode?: MatchMode, key?: keyof T): T | undefined;
+    /**
+     * * Returns the last matching element (or undefined).
+     * @param array
+     * * The array.
+     * @param query
+     * * The search query.
+     * @param mode
+     * * The comparison mode ('exact', 'contains', 'startsWith', 'endsWith').
+     * @param key
+     * * (Optional) The object key if it is an array of objects.
+     * @returns
+     * * Index or -1.
+     */
+    last<T>(array: T[], query: string | number, mode?: MatchMode, key?: keyof T): T | undefined;
+    /**
+     * * Removes all elements matching a query condition.
+     * @example
+     * find.byMatch(users, 'Admin', 'exact', 'role')
+     * @param array
+     * * The array.
+     * @param query
+     * * The search query.
+     * @param mode
+     * * The comparison mode ('exact', 'contains', 'startsWith', 'endsWith').
+     * @param key
+     * * (Optional) The object key if it is an array of objects.
+     * @returns
+     * * Index or -1.
+     */
+    byMatch<T>(array: T[], query: string | number, mode?: MatchMode, key?: keyof T): number | undefined;
 };
 //# sourceMappingURL=arrays.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"arrays.d.ts","sourceRoot":"","sources":["../../../src/modules/data/arrays.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAc,MAAM,SAAS,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAMxD;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAE9C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,GAAE,MAAqB,GAAG,CAAC,EAAE,CAK7E;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM;IACf;;;;;;;;;OASG;OACA,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,GAAG,CAAC,EAAE;IASrC;;;OAGG;UACG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE;IAEzB;;;OAGG;SACE,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE;IAExB;;;;;;;;;;;;;;;;;OAiBG;YACK,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,SAAQ,SAAS,QAAkB,MAAM,CAAC,GAAG,CAAC,EAAE;CAMhG,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,IAAI;IACb;;;;;;OAMG;UACG,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,SAAQ,SAAS,QAAkB,MAAM,CAAC,GAAG,MAAM;IAO9F;;;OAGG;QACC,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,SAAQ,SAAS,QAAkB,MAAM,CAAC,GAAG,CAAC,EAAE;IAOzF;;;OAGG;UACG,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,SAAQ,SAAS,QAAkB,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS;CAMxG,CAAC"}
+{"version":3,"file":"arrays.d.ts","sourceRoot":"","sources":["../../../src/modules/data/arrays.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAMxD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAEnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,GAAE,MAAqB,GAAG,CAAC,EAAE,CAK7E;AAED;;GAEG;AACH,eAAO,MAAM,MAAM;IACf;;;;;;OAMG;OACA,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,GAAG,CAAC,EAAE;IASrC;;;;OAIG;UACG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE;IAEzB;;;;OAIG;SACE,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE;IAExB;;;;;;;;;;;;OAYG;YACK,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,SAAQ,SAAS,QAAkB,MAAM,CAAC,GAAG,CAAC,EAAE;CAchG,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI;IACb;;;;;;;;;;;;OAYG;OACA,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,SAAQ,SAAS,QAAkB,MAAM,CAAC,GAAG,MAAM;IAe3F;;;;;;;;;;;;OAYG;QACC,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,SAAQ,SAAS,QAAkB,MAAM,CAAC,GAAG,CAAC,EAAE;IAezF;;;;;;;;;;;;OAYG;UACG,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,SAAQ,SAAS,QAAkB,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS;IAerG;;;;;;;;;;;;OAYG;SACE,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,SAAQ,SAAS,QAAkB,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS;IAepG;;;;;;;;;;;;;;OAcG;YACK,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,SAAQ,SAAS,QAAkB,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS;CAc/G,CAAC"}

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

@@ -1,26 +1,22 @@
 /**
  * @file src/modules/data/index.ts
- * @version 2.0.0
+ * @version 2.0.2
  * @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.
+ * * Central entry point for data manipulation modules. Aggregates array and object utilities.
  * @requires ./arrays
- * * 🇬🇧: Array manipulation methods.
- * * 🇩🇪: Methoden zur Array-Manipulation.
+ * * Array manipulation methods.
  * @requires ./objects
- * * 🇬🇧: Object manipulation methods.
- * * 🇩🇪: Methoden zur Objekt-Manipulation.
+ * * Object manipulation methods.
  */
 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').
+ * * Central data utility object. Bundles array ('arr') and object ('obj') manipulation methods.
  */
 export declare const data: {
     arr: typeof arrayMethods;

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/data/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,YAAY,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,aAAa,MAAM,WAAW,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,IAAI;;;CAGhB,CAAC"}

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

@@ -1,107 +1,139 @@
 /**
  * @file src/modules/data/objects.ts
- * @version 2.0.0
+ * @version 2.0.2
  * @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).
+ * * Utility functions for object manipulation (e.g., deep merging, extension).
  * @requires ./types
- * * 🇬🇧: Depends on match logic and types.
- * * 🇩🇪: Hängt von Match-Logik und Typen ab.
+ * * Depends on types.
  */
 import { MatchMode } from './types';
 /**
- * * 🇬🇧: Recursively merges multiple objects (Deep Merge).
- * * 🇩🇪: Führt mehrere Objekte rekursiv zusammen (Deep Merge).
+ * * Recursively merges multiple objects (Deep Merge).
  * @example
- * merge({ a: 1, b: { x: 1 } }, { b: { y: 2 } }) // => { a: 1, b: { x: 1, y: 2 } }
+ * mergeObjects({ 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!).
+ * * The target object (will be modified!).
  * @param sources
- * * 🇬🇧: One or more source objects.
- * * 🇩🇪: Ein oder mehrere Quellobjekte.
+ * * One or more source objects.
  * @returns
- * * 🇬🇧: The modified target object.
- * * 🇩🇪: Das modifizierte Zielobjekt.
+ * * The modified target object.
  */
-export declare function merge(target: any, ...sources: any[]): any;
+export declare function mergeObjects(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).
+ * * Creates a new object containing only the specified keys (Allowlist).
  * @param obj
- * * 🇬🇧: The source object.
- * * 🇩🇪: Das Quellobjekt.
+ * * The source object.
  * @param keys
- * * 🇬🇧: Array of keys to keep.
- * * 🇩🇪: Array der Schlüssel, die übernommen werden sollen.
+ * * Array of keys to keep.
  * @returns
- * * 🇬🇧: A new object with selected keys.
- * * 🇩🇪: Ein neues Objekt mit den gewählten Schlüsseln.
+ * * A new object with selected keys.
  */
 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).
+ * * Creates a new object containing all keys EXCEPT the specified ones (Blocklist).
  * @param obj
- * * 🇬🇧: The source object.
- * * 🇩🇪: Das Quellobjekt.
+ * * The source object.
  * @param keys
- * * 🇬🇧: Array of keys to remove.
- * * 🇩🇪: Array der Schlüssel, die entfernt werden sollen.
+ * * Array of keys to remove.
  * @returns
- * * 🇬🇧: A new object without the specified keys.
- * * 🇩🇪: Ein neues Objekt ohne die angegebenen Schlüssel.
+ * * A new object without the specified keys.
  */
 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).
+ * * Safely retrieves a value from a nested object (Safe Navigation).
  * @example
- * get(user, 'address.city') // Returns city or undefined
+ * get(user, 'address.city') Returns city or undefined
  * @param obj
- * * 🇬🇧: The object.
- * * 🇩🇪: Das Objekt.
+ * * The object.
  * @param path
- * * 🇬🇧: The path as a dot-notation string.
- * * 🇩🇪: Der Pfad als String mit Punkt-Notation.
+ * * The path as a dot-notation string.
  * @returns
- * * 🇬🇧: The found value or undefined.
- * * 🇩🇪: Der gefundene Wert oder undefined.
+ * * The found value or 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.
+ * * Sets a value deeply within a nested object. Creates missing intermediate objects automatically.
  * @param obj
- * * 🇬🇧: The object to modify.
- * * 🇩🇪: Das zu modifizierende Objekt.
+ * * The object to modify.
  * @param path
- * * 🇬🇧: The path as a string (e.g., 'settings.theme.color').
- * * 🇩🇪: Der Pfad als String (z.B. 'settings.theme.color').
+ * * The path as a string (e.g., 'settings.theme.color').
  * @param value
- * * 🇬🇧: The value to set.
- * * 🇩🇪: Der zu setzende Wert.
+ * * The value to set.
  */
 export declare function set(obj: any, path: string, value: any): void;
 /**
- * * 🇬🇧: Searches keys or values in the object.
- * * 🇩🇪: Sucht Keys oder Values im Objekt.
+ * * Searches keys or values in the object.
  */
 export declare const find: {
     /**
-     * * 🇬🇧: Finds all keys matching the query.
-     * * 🇩🇪: Findet alle Schlüssel (Keys), die auf den Suchbegriff passen.
+     * * Returns the n-th entry of an object as a [key, value] pair. Supports negative indices.
+     * @example find.at({ a: 1, b: 2 }, 1) => ['b', 2]
+     * @param obj
+     * * The object to search.
+     * @param index
+     * * The index (0-based, negative counts from the back).
+     * @returns
+     * * A [key, value] tuple or undefined.
+     */
+    at(obj: any, index: number): [string, any] | undefined;
+    /**
+     * * Finds the first entry where the key or value matches the query.
+     * @example find.first(config, 'admin', 'exact', 'key')
+     * @param obj
+     * * The object to search.
+     * @param query
+     * * The search query.
+     * @param mode
+     * * The comparison mode ('exact', 'contains', 'startsWith', 'endsWith').
+     * @param searchBy
+     * * Whether to search by 'key' or 'value'.
+     * @returns
+     * * The first matching [key, value] pair or undefined.
+     */
+    first(obj: any, query: string | number, mode?: MatchMode, searchBy?: "key" | "value"): [string, any] | undefined;
+    /**
+     * * Finds the last entry where the key or value matches the query.
+     * @example find.last(config, '.php', 'endsWith', 'key')
+     * @param obj
+     * * The object to search.
+     * @param query
+     * * The search query.
+     * @param mode
+     * * The comparison mode ('exact', 'contains', 'startsWith', 'endsWith').
+     * @param searchBy
+     * * Whether to search by 'key' or 'value'.
+     * @returns
+     * * The last matching [key, value] pair or undefined.
+     */
+    last(obj: any, query: string | number, mode?: MatchMode, searchBy?: "key" | "value"): [string, any] | undefined;
+    /**
+     * * Finds all keys matching the query.
      * @example find.key(config, 'api_', 'startsWith')
+     * @param obj
+     * * The object to search.
+     * @param query
+     * * The search query.
+     * @param mode
+     * * The comparison mode ('exact', 'contains', 'startsWith', 'endsWith').
+     * @returns
+     * * An array of matching keys.
      */
     key(obj: any, query: string, mode?: MatchMode): string[];
     /**
-     * * 🇬🇧: Finds all values matching the query.
-     * * 🇩🇪: Findet alle Werte (Values), die auf den Suchbegriff passen.
+     * * Finds all values matching the query.
+     * @param obj
+     * * The object to search.
+     * @param query
+     * * The search query.
+     * @param mode
+     * * The comparison mode ('exact', 'contains', 'startsWith', 'endsWith').
+     * @returns
+     * * An array of matching values.
      */
     value(obj: any, query: string, mode?: MatchMode): any[];
 };

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

@@ -1 +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"}
+{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../../src/modules/data/objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,CAkBhE;AAED;;;;;;;;GAQG;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;;;;;;;;GAQG;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;;;;;;;;;;GAUG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAE/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAS5D;AAED;;GAEG;AACH,eAAO,MAAM,IAAI;IACb;;;;;;;;;OASG;YACK,GAAG,SAAS,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;IAMtD;;;;;;;;;;;;;OAaG;eACQ,GAAG,SAAS,MAAM,GAAG,MAAM,SAAQ,SAAS,aAAsB,KAAK,GAAG,OAAO,GAAW,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;IAkBhI;;;;;;;;;;;;;OAaG;cACO,GAAG,SAAS,MAAM,GAAG,MAAM,SAAQ,SAAS,aAAsB,KAAK,GAAG,OAAO,GAAW,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;IAkB/H;;;;;;;;;;;OAWG;aACM,GAAG,SAAS,MAAM,SAAQ,SAAS,GAAa,MAAM,EAAE;IAejE;;;;;;;;;;OAUG;eACQ,GAAG,SAAS,MAAM,SAAQ,SAAS,GAAa,GAAG,EAAE;CAcnE,CAAC"}

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

@@ -1,35 +1,16 @@
 /**
  * @file src/modules/data/types.ts
- * @version 2.0.0
+ * @version 2.0.2
  * @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.
+ * * Type definitions and validation helpers for data structures.
  */
 /**
- * * 🇬🇧: Defines the matching modes for search operations.
- * * 🇩🇪: Definiert die Vergleichsmodi für Suchoperationen.
+ * * Defines the matching modes for search operations.
  */
 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

@@ -1 +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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/modules/data/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,CAAC"}

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

@@ -1,42 +1,33 @@
 /**
  * @file src/modules/dom/attributes.ts
- * @version 2.0.0
+ * @version 2.0.2
  * @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).
+ * * Methods for getting and setting HTML attributes and properties (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.
+ * * Depends on the core jBase class for type definitions.
  */
 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.
+ * * Gets an attribute from the first element or sets it for all elements in the selection.
  * @param name
- * * 🇬🇧: The name of the attribute (e.g., 'href', 'data-id').
- * * 🇩🇪: Der Name des Attributs (z.B. 'href', 'data-id').
+ * * The name of the attribute (e.g., '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.
+ * * (Optional) The value to set. If undefined, acts as a getter.
  * @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.
+ * * The attribute value (string/null) when reading, or the jBase instance when writing.
  */
 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.
+ * * Gets the 'value' from the first form element or sets it for all elements. Supports Input, Textarea, and Select elements.
  * @param value
- * * 🇬🇧: (Optional) The value to set. If undefined, acts as a getter.
- * * 🇩🇪: (Optional) Der zu setzende Wert. Wenn nicht angegeben, wird gelesen.
+ * * (Optional) The value to set. If undefined, acts as a getter.
  * @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.
+ * * The current value as a string when reading, or the jBase instance when writing.
  */
 export declare function val(this: jBase, value?: string): string | jBase;
 //# sourceMappingURL=attributes.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../../src/modules/dom/attributes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,CAUrF;AAED;;;;;;;;;GASG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAe/D"}
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../../src/modules/dom/attributes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,CAUrF;AAED;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAe/D"}

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

@@ -1,39 +1,31 @@
 /**
  * @file src/modules/dom/content.ts
- * @version 2.0.0
+ * @version 2.0.2
  * @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 element content (html, text, empty, replaceWith).
- * * 🇩🇪: Methoden zum Lesen und Setzen von Elementinhalten (html, text, empty, replaceWith).
+ * * Methods for getting and setting element content (html, text, empty, replaceWith).
  * @requires ../../core
- * * 🇬🇧: Depends on the core jBase class for type definitions.
- * * 🇩🇪: Hängt von der Core-jBase-Klasse für Typ-Definitionen ab.
+ * * Depends on the core jBase class for type definitions.
  */
 import { jBase } from '../../core';
 /**
- * * 🇬🇧: Gets the HTML content of the first element or sets the HTML content for all elements in the selection.
- * * 🇩🇪: Ruft den HTML-Inhalt des ersten Elements ab oder setzt den HTML-Inhalt für alle Elemente in der Auswahl.
+ * * Gets the HTML content of the first element or sets the HTML content for all elements in the selection.
  * @param content
- * * 🇬🇧: (Optional) The HTML string to set.
- * * 🇩🇪: (Optional) Der HTML-String, der gesetzt werden soll.
+ * * (Optional) The HTML string to set.
  * @returns
- * * 🇬🇧: The HTML string (getter) or the current jBase instance (setter).
- * * 🇩🇪: Der HTML-String (Getter) oder die aktuelle jBase-Instanz (Setter).
+ * * The HTML string (getter) or the current jBase instance (setter).
  */
 export declare function html(this: jBase, content?: string): string | jBase;
 /**
- * * 🇬🇧: Gets the text content of the first element or sets it for all elements. Safe against XSS attacks.
- * * 🇩🇪: Ruft den reinen Text-Inhalt des ersten Elements ab oder setzt ihn für alle Elemente. Sicher gegen XSS-Angriffe.
+ * * Gets the text content of the first element or sets it for all elements. Safe against XSS attacks.
  * @param content
- * * 🇬🇧: (Optional) The text content to set.
- * * 🇩🇪: (Optional) Der Text, der gesetzt werden soll.
+ * * (Optional) The text content to set.
  * @returns
- * * 🇬🇧: The text content (getter) or the current jBase instance (setter).
- * * 🇩🇪: Der Text-Inhalt (Getter) oder die aktuelle jBase-Instanz (Setter).
+ * * The text content (getter) or the current jBase instance (setter).
  */
 export declare function text(this: jBase, content?: string): string | jBase;
 //# sourceMappingURL=content.d.ts.map

package/dist/modules/dom/content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/modules/dom/content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CASlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAYlE"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/modules/dom/content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CASlE;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAYlE"}