@k37z3r/jbase 2.0.0

package/dist/modules/dom/traversal.js

@@ -0,0 +1,527 @@
+"use strict";
+/**
+ * @file src/modules/dom/traversal.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 navigating the DOM tree (find, parent, children, siblings).
+ * * 🇩🇪: Methoden zur Navigation im DOM-Baum (find, parent, children, siblings).
+ * @requires ../../core
+ * * 🇬🇧: Depends on the core jBase class for type definitions.
+ * * 🇩🇪: Hängt von der Core-jBase-Klasse für Typ-Definitionen ab.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.closest = closest;
+exports.parent = parent;
+exports.children = children;
+exports.findAll = findAll;
+exports.descendants = descendants;
+exports.parents = parents;
+exports.parentsUntil = parentsUntil;
+exports.descendantsUntil = descendantsUntil;
+exports.next = next;
+exports.prev = prev;
+exports.nextSibling = nextSibling;
+exports.prevSibling = prevSibling;
+exports.sibling = sibling;
+exports.nextAll = nextAll;
+exports.prevAll = prevAll;
+exports.siblings = siblings;
+exports.nextUntil = nextUntil;
+exports.prevUntil = prevUntil;
+exports.eq = eq;
+exports.first = first;
+exports.last = last;
+exports.filterBy = filterBy;
+exports.not = not;
+/**
+ * * 🇬🇧: Traverses the parents (heading toward the document root) of each element and finds the first element that matches the specified selector.
+ * * 🇩🇪: Durchläuft die Elternelemente (in Richtung Document Root) jedes Elements und findet das erste Element, das dem angegebenen Selektor entspricht.
+ * @param selector
+ * * 🇬🇧: A string containing a selector expression.
+ * * 🇩🇪: Ein String, der einen Selektor-Ausdruck enthält.
+ * @returns
+ * * 🇬🇧: A new jBase instance containing the matched elements.
+ * * 🇩🇪: Eine neue jBase-Instanz mit den gefundenen Elementen.
+ */
+function closest(selector) {
+    const found = [];
+    this.forEach(el => {
+        if (el instanceof Element) {
+            const match = el.closest(selector);
+            if (match) {
+                found.push(match);
+            }
+        }
+    });
+    const Construction = this.constructor;
+    return new Construction([...new Set(found)]);
+}
+/**
+ * * 🇬🇧: Gets the direct parent of each element in the current set. Deduplicates results.
+ * * 🇩🇪: Gibt das direkte Elternelement jedes Elements in der aktuellen Auswahl zurück. Entfernt Duplikate.
+ * @returns
+ * * 🇬🇧: A new jBase instance containing the parent elements.
+ * * 🇩🇪: Eine neue jBase-Instanz mit den Elternelementen.
+ */
+function parent() {
+    const parents = [];
+    this.forEach(el => {
+        if (el instanceof Element && el.parentElement) {
+            parents.push(el.parentElement);
+        }
+    });
+    const Construction = this.constructor;
+    return new Construction([...new Set(parents)]);
+}
+/**
+ * * 🇬🇧: Gets the direct children of each element in the set, optionally filtered by a selector.
+ * * 🇩🇪: Gibt die direkten Kinder jedes Elements zurück, optional gefiltert durch einen Selektor.
+ * @param selector
+ * * 🇬🇧: (Optional) Filter selector.
+ * * 🇩🇪: (Optional) Filter-Selektor.
+ * @returns
+ * * 🇬🇧: A new jBase instance containing the children.
+ * * 🇩🇪: Eine neue jBase-Instanz mit den Kindern.
+ */
+function children(selector) {
+    let allChildren = [];
+    this.forEach(el => {
+        if (el instanceof Element) {
+            const kids = Array.from(el.children);
+            allChildren = allChildren.concat(kids);
+        }
+    });
+    if (selector) {
+        allChildren = allChildren.filter(child => child.matches(selector));
+    }
+    const Construction = this.constructor;
+    return new Construction(allChildren);
+}
+/**
+ * * 🇬🇧: Finds descendants (deep) that match the selector using `querySelectorAll`.
+ * * 🇩🇪: Findet Nachfahren (tief), die dem Selektor entsprechen. Nutzt `querySelectorAll`.
+ * @param selector
+ * * 🇬🇧: The CSS selector to search for.
+ * * 🇩🇪: Der CSS-Selektor für die Suche.
+ * @returns
+ * * 🇬🇧: A new jBase instance with the found elements.
+ * * 🇩🇪: Eine neue jBase-Instanz mit den gefundenen Elementen.
+ */
+function findAll(selector) {
+    const found = [];
+    this.forEach(el => {
+        if (el instanceof Element || el instanceof Document) {
+            const matches = el.querySelectorAll(selector);
+            matches.forEach(m => found.push(m));
+        }
+    });
+    const Construction = this.constructor;
+    return new Construction([...new Set(found)]);
+}
+/**
+ * * 🇬🇧: Recursively gets ALL descendants (not just direct children).
+ * * 🇩🇪: Gibt rekursiv ALLE Nachfahren zurück (nicht nur direkte Kinder).
+ * @returns
+ * * 🇬🇧: A new jBase instance with all descendants.
+ * * 🇩🇪: Eine neue jBase-Instanz mit allen Nachfahren.
+ */
+function descendants() {
+    return this.findAll('*');
+}
+/**
+ * * 🇬🇧: Gets all ancestors (parents, grandparents...) up to the root. Optionally filtered.
+ * * 🇩🇪: Gibt alle Vorfahren (Eltern, Großeltern...) zurück bis zum Root-Element. Optional gefiltert.
+ * @param selector
+ * * 🇬🇧: (Optional) Filter selector for ancestors.
+ * * 🇩🇪: (Optional) Selektor zum Filtern der Vorfahren.
+ * @returns
+ * * 🇬🇧: A new jBase instance with the ancestors.
+ * * 🇩🇪: Eine neue jBase-Instanz mit den Vorfahren.
+ */
+function parents(selector) {
+    const ancestors = [];
+    this.forEach(el => {
+        if (el instanceof Element) {
+            let curr = el.parentElement;
+            while (curr) {
+                if (!selector || curr.matches(selector)) {
+                    ancestors.push(curr);
+                }
+                curr = curr.parentElement;
+            }
+        }
+    });
+    const Construction = this.constructor;
+    return new Construction([...new Set(ancestors)]);
+}
+/**
+ * * 🇬🇧: Gets all ancestors UP TO (but not including) an element matching the selector.
+ * * 🇩🇪: Gibt alle Vorfahren zurück, BIS (aber nicht einschließlich) ein Element dem Selektor entspricht.
+ * @param selector
+ * * 🇬🇧: The selector where traversal stops.
+ * * 🇩🇪: Der Selektor, bei dem gestoppt wird.
+ * @param filter
+ * * 🇬🇧: (Optional) Filter for the collected elements.
+ * * 🇩🇪: (Optional) Zusätzlicher Filter für die gefundenen Elemente.
+ * @returns
+ * * 🇬🇧: A new jBase instance.
+ * * 🇩🇪: Eine neue jBase-Instanz.
+ */
+function parentsUntil(selector, filter) {
+    const ancestors = [];
+    this.forEach(el => {
+        if (el instanceof Element) {
+            let curr = el.parentElement;
+            while (curr && !curr.matches(selector)) {
+                if (!filter || curr.matches(filter)) {
+                    ancestors.push(curr);
+                }
+                curr = curr.parentElement;
+            }
+        }
+    });
+    const Construction = this.constructor;
+    return new Construction([...new Set(ancestors)]);
+}
+/**
+ * * 🇬🇧: Recursively finds descendants but stops traversing a branch if `untilSelector` is met. Useful for finding nested elements without going too deep (e.g., nested forms).
+ * * 🇩🇪: Sucht rekursiv nach Nachfahren, stoppt aber den "Tiefgang" in einem Zweig, sobald ein Element dem `untilSelector` entspricht.
+ * @param untilSelector
+ * * 🇬🇧: The selector that stops recursion in a branch.
+ * * 🇩🇪: Der Selektor, der die Rekursion in diesem Zweig stoppt.
+ * @param filter
+ * * 🇬🇧: (Optional) Selector to filter collected elements.
+ * * 🇩🇪: (Optional) Selektor, welche Elemente gesammelt werden sollen.
+ * @returns
+ * * 🇬🇧: A new jBase instance.
+ * * 🇩🇪: Eine neue jBase-Instanz.
+ */
+function descendantsUntil(untilSelector, filter) {
+    const found = [];
+    const traverse = (parent) => {
+        const kids = parent.children;
+        for (let i = 0; i < kids.length; i++) {
+            const child = kids[i];
+            if (child.matches(untilSelector)) {
+                continue;
+            }
+            if (!filter || child.matches(filter)) {
+                found.push(child);
+            }
+            traverse(child);
+        }
+    };
+    this.forEach(el => {
+        if (el instanceof Element)
+            traverse(el);
+    });
+    const Construction = this.constructor;
+    return new Construction([...new Set(found)]);
+}
+/**
+ * * 🇬🇧: Gets the immediately following sibling.
+ * * 🇩🇪: Holt das unmittelbar folgende Geschwisterelement.
+ * @param selector
+ * * 🇬🇧: (Optional) Filter selector.
+ * * 🇩🇪: (Optional) Filter-Selektor.
+ * @returns
+ * * 🇬🇧: A new jBase instance.
+ * * 🇩🇪: Eine neue jBase-Instanz.
+ */
+function next(selector) {
+    const found = [];
+    this.forEach(el => {
+        if (el instanceof Element && el.nextElementSibling) {
+            const nextEl = el.nextElementSibling;
+            if (!selector || nextEl.matches(selector)) {
+                found.push(nextEl);
+            }
+        }
+    });
+    const Construction = this.constructor;
+    return new Construction([...new Set(found)]);
+}
+/**
+ * * 🇬🇧: Gets the immediately preceding sibling.
+ * * 🇩🇪: Holt das unmittelbar vorhergehende Geschwisterelement.
+ * @param selector
+ * * 🇬🇧: (Optional) Filter selector.
+ * * 🇩🇪: (Optional) Filter-Selektor.
+ * @returns
+ * * 🇬🇧: A new jBase instance.
+ * * 🇩🇪: Eine neue jBase-Instanz.
+ */
+function prev(selector) {
+    const found = [];
+    this.forEach(el => {
+        if (el instanceof Element && el.previousElementSibling) {
+            const prevEl = el.previousElementSibling;
+            if (!selector || prevEl.matches(selector)) {
+                found.push(prevEl);
+            }
+        }
+    });
+    const Construction = this.constructor;
+    return new Construction([...new Set(found)]);
+}
+/**
+ * * 🇬🇧: Alias for `next()`.
+ * * 🇩🇪: Alias für `next()`.
+ */
+function nextSibling(selector) {
+    return this.next(selector);
+}
+/**
+ * * 🇬🇧: Alias for `prev()`.
+ * * 🇩🇪: Alias für `prev()`.
+ */
+function prevSibling(selector) {
+    return this.prev(selector);
+}
+/**
+ * * 🇬🇧: Alias for `next()`.
+ * * 🇩🇪: Alias für `next()`.
+ */
+function sibling(selector) {
+    return this.next(selector);
+}
+/**
+ * * 🇬🇧: Gets ALL following siblings.
+ * * 🇩🇪: Holt ALLE nachfolgenden Geschwisterelemente.
+ * @param selector
+ * * 🇬🇧: (Optional) Filter selector.
+ * * 🇩🇪: (Optional) Filter-Selektor.
+ * @returns
+ * * 🇬🇧: A new jBase instance.
+ * * 🇩🇪: Eine neue jBase-Instanz.
+ */
+function nextAll(selector) {
+    const found = [];
+    this.forEach(el => {
+        if (el instanceof Element) {
+            let curr = el.nextElementSibling;
+            while (curr) {
+                if (!selector || curr.matches(selector)) {
+                    found.push(curr);
+                }
+                curr = curr.nextElementSibling;
+            }
+        }
+    });
+    const Construction = this.constructor;
+    return new Construction([...new Set(found)]);
+}
+/**
+ * * 🇬🇧: Gets ALL preceding siblings.
+ * * 🇩🇪: Holt ALLE vorhergehenden Geschwisterelemente.
+ * @param selector
+ * * 🇬🇧: (Optional) Filter selector.
+ * * 🇩🇪: (Optional) Filter-Selektor.
+ * @returns
+ * * 🇬🇧: A new jBase instance.
+ * * 🇩🇪: Eine neue jBase-Instanz.
+ */
+function prevAll(selector) {
+    const found = [];
+    this.forEach(el => {
+        if (el instanceof Element) {
+            let curr = el.previousElementSibling;
+            while (curr) {
+                if (!selector || curr.matches(selector)) {
+                    found.push(curr);
+                }
+                curr = curr.previousElementSibling;
+            }
+        }
+    });
+    const Construction = this.constructor;
+    return new Construction([...new Set(found)]);
+}
+/**
+ * * 🇬🇧: Gets ALL siblings (previous and next), excluding itself.
+ * * 🇩🇪: Holt ALLE Geschwisterelemente (vorherige UND nachfolgende), außer sich selbst.
+ * @param selector
+ * * 🇬🇧: (Optional) Filter selector.
+ * * 🇩🇪: (Optional) Filter-Selektor.
+ * @returns
+ * * 🇬🇧: A new jBase instance.
+ * * 🇩🇪: Eine neue jBase-Instanz.
+ */
+function siblings(selector) {
+    const found = [];
+    this.forEach(el => {
+        if (el instanceof Element && el.parentElement) {
+            const children = Array.from(el.parentElement.children);
+            children.forEach(child => {
+                if (child !== el) { // Exclude self
+                    if (!selector || child.matches(selector)) {
+                        found.push(child);
+                    }
+                }
+            });
+        }
+    });
+    const Construction = this.constructor;
+    return new Construction([...new Set(found)]);
+}
+/**
+ * * 🇬🇧: Gets all following siblings UNTIL a selector is met (exclusive).
+ * * 🇩🇪: Holt alle nachfolgenden Elemente BIS ein Selektor zutrifft (exklusive).
+ * @param untilSelector
+ * * 🇬🇧: The selector that stops the search.
+ * * 🇩🇪: Der Selektor, der die Suche stoppt.
+ * @param filter
+ * * 🇬🇧: (Optional) Filter for the found elements.
+ * * 🇩🇪: (Optional) Filter für die gefundenen Elemente.
+ * @returns
+ * * 🇬🇧: A new jBase instance.
+ * * 🇩🇪: Eine neue jBase-Instanz.
+ */
+function nextUntil(untilSelector, filter) {
+    const found = [];
+    this.forEach(el => {
+        if (el instanceof Element) {
+            let curr = el.nextElementSibling;
+            while (curr && !curr.matches(untilSelector)) {
+                if (!filter || curr.matches(filter)) {
+                    found.push(curr);
+                }
+                curr = curr.nextElementSibling;
+            }
+        }
+    });
+    const Construction = this.constructor;
+    return new Construction([...new Set(found)]);
+}
+/**
+ * * 🇬🇧: Gets all preceding siblings UNTIL a selector is met (exclusive).
+ * * 🇩🇪: Holt alle vorhergehenden Elemente BIS ein Selektor zutrifft (exklusive).
+ * @param untilSelector
+ * * 🇬🇧: The selector that stops the search.
+ * * 🇩🇪: Der Selektor, der die Suche stoppt.
+ * @param filter
+ * * 🇬🇧: (Optional) Filter for the found elements.
+ * * 🇩🇪: (Optional) Filter für die gefundenen Elemente.
+ * @returns
+ * * 🇬🇧: A new jBase instance.
+ * * 🇩🇪: Eine neue jBase-Instanz.
+ */
+function prevUntil(untilSelector, filter) {
+    const found = [];
+    this.forEach(el => {
+        if (el instanceof Element) {
+            let curr = el.previousElementSibling;
+            while (curr && !curr.matches(untilSelector)) {
+                if (!filter || curr.matches(filter)) {
+                    found.push(curr);
+                }
+                curr = curr.previousElementSibling;
+            }
+        }
+    });
+    const Construction = this.constructor;
+    return new Construction([...new Set(found)]);
+}
+/**
+ * * 🇬🇧: Reduces the set to the element at the specified index. Supports negative indices.
+ * * 🇩🇪: Reduziert das Set auf das Element am angegebenen Index. Unterstützt negative Indizes.
+ * @param index
+ * * 🇬🇧: The position (0-based). Negative values count from the end.
+ * * 🇩🇪: Die Position (0-basiert). Negative Werte zählen vom Ende.
+ * @returns
+ * * 🇬🇧: A new jBase instance containing the single element (or empty).
+ * * 🇩🇪: Eine neue jBase-Instanz mit dem einzelnen Element (oder leer).
+ */
+function eq(index) {
+    const len = this.length;
+    // Calculate negative indices: -1 becomes len - 1
+    const idx = index < 0 ? len + index : index;
+    // Get element (or undefined)
+    const el = this[idx];
+    const Construction = this.constructor;
+    // If element exists, wrap in array, else empty array
+    return new Construction(el ? [el] : []);
+}
+/**
+ * * 🇬🇧: Reduces the set to the first element.
+ * * 🇩🇪: Reduziert das Set auf das erste Element.
+ */
+function first() {
+    return this.eq(0);
+}
+/**
+ * * 🇬🇧: Reduces the set to the last element.
+ * * 🇩🇪: Reduziert das Set auf das letzte Element.
+ */
+function last() {
+    return this.eq(-1);
+}
+/**
+ * * 🇬🇧: Filters elements based on a selector or a function.
+ * * 🇩🇪: Filtert die Elemente basierend auf einem Selektor oder einer Funktion.
+ * @param selectorOrFn
+ * * 🇬🇧: CSS selector string or filter function.
+ * * 🇩🇪: CSS-Selektor (String) oder Filter-Funktion.
+ * @returns
+ * * 🇬🇧: A new jBase instance with filtered elements.
+ * * 🇩🇪: Eine neue jBase-Instanz mit den gefilterten Elementen.
+ */
+function filterBy(selectorOrFn) {
+    const found = [];
+    this.forEach((el, index) => {
+        if (el instanceof Element) {
+            if (typeof selectorOrFn === 'string') {
+                // String filter: Check matches()
+                if (el.matches(selectorOrFn)) {
+                    found.push(el);
+                }
+            }
+            else if (typeof selectorOrFn === 'function') {
+                // Function filter: Check return value (true/false)
+                // 'this' inside the function is the element itself (jQuery Style)
+                if (selectorOrFn.call(el, index, el)) {
+                    found.push(el);
+                }
+            }
+        }
+    });
+    const Construction = this.constructor;
+    return new Construction(found);
+}
+/**
+ * * 🇬🇧: Removes elements from the set that match the selector or function (Inverse of filterBy).
+ * * 🇩🇪: Entfernt Elemente aus dem Set, die dem Selektor oder der Funktion entsprechen (Das Gegenteil von filterBy).
+ * @param selectorOrFn
+ * * 🇬🇧: CSS selector string or filter function.
+ * * 🇩🇪: CSS-Selektor (String) oder Filter-Funktion.
+ * @returns
+ * * 🇬🇧: A new jBase instance with remaining elements.
+ * * 🇩🇪: Eine neue jBase-Instanz mit den verbleibenden Elementen.
+ */
+function not(selectorOrFn) {
+    const found = [];
+    this.forEach((el, index) => {
+        if (el instanceof Element) {
+            if (typeof selectorOrFn === 'string') {
+                // Keep if it does NOT match
+                if (!el.matches(selectorOrFn)) {
+                    found.push(el);
+                }
+            }
+            else if (typeof selectorOrFn === 'function') {
+                // Keep if function returns FALSE
+                if (!selectorOrFn.call(el, index, el)) {
+                    found.push(el);
+                }
+            }
+        }
+    });
+    const Construction = this.constructor;
+    return new Construction(found);
+}
+//# sourceMappingURL=traversal.js.map

package/dist/modules/dom/traversal.js.map

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

package/dist/modules/effects/fade.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @file src/modules/effects/fade.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 Effects
+ * @description
+ * * 🇬🇧: Methods for fading elements in and out (fadeIn, fadeOut, fadeToggle).
+ * * 🇩🇪: Methoden zum Ein- und Ausblenden von Elementen (fadeIn, fadeOut, fadeToggle).
+ * @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';
+/**
+ * * 🇬🇧: Configuration options for fade effects.
+ * * 🇩🇪: Konfigurationsoptionen für Fade-Effekte.
+ */
+export interface FadeOptions {
+    duration?: number;
+    displayType?: string;
+}
+/**
+ * * 🇬🇧: Fades an element in (Opacity 0 -> 1).
+ * * 🇩🇪: Blendet ein Element sanft ein (Opacity 0 -> 1).
+ * @param options
+ * * 🇬🇧: Duration in ms (default: 300) and display type (default: 'block').
+ * * 🇩🇪: Dauer in ms (Standard: 300) und display-Typ (Standard: 'block').
+ * @returns
+ * * 🇬🇧: The current jBase instance.
+ * * 🇩🇪: Die aktuelle jBase-Instanz.
+ */
+export declare function fadeIn(this: jBase, options?: FadeOptions): jBase;
+/**
+ * * 🇬🇧: Fades an element out (Opacity 1 -> 0) and sets display: none afterwards.
+ * * 🇩🇪: Blendet ein Element sanft aus (Opacity 1 -> 0) und setzt danach display: none.
+ * @param options
+ * * 🇬🇧: Duration in ms (default: 300).
+ * * 🇩🇪: Dauer in ms (Standard: 300).
+ * @returns
+ * * 🇬🇧: The current jBase instance.
+ * * 🇩🇪: Die aktuelle jBase-Instanz.
+ */
+export declare function fadeOut(this: jBase, options?: FadeOptions): jBase;
+/**
+ * * 🇬🇧: Toggles between fadeIn and fadeOut based on the current display state.
+ * * 🇩🇪: Wechselt zwischen fadeIn und fadeOut basierend auf dem aktuellen display-Status.
+ * @param options
+ * * 🇬🇧: Animation options.
+ * * 🇩🇪: Animations-Optionen.
+ * @returns
+ * * 🇬🇧: The current jBase instance.
+ * * 🇩🇪: Die aktuelle jBase-Instanz.
+ */
+export declare function fadeToggle(this: jBase, options?: FadeOptions): jBase;
+//# sourceMappingURL=fade.d.ts.map

package/dist/modules/effects/fade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fade.d.ts","sourceRoot":"","sources":["../../../src/modules/effects/fade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,GAAE,WAAgB,GAAG,KAAK,CAkBpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,GAAE,WAAgB,GAAG,KAAK,CAkBrE;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,GAAE,WAAgB,GAAG,KAAK,CAaxE"}