@k37z3r/jbase 2.0.0

package/dist/modules/dom/manipulation.js

@@ -0,0 +1,343 @@
+"use strict";
+/**
+ * @file src/modules/dom/manipulation.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 inserting, moving, and removing elements (append, prepend, remove).
+ * * 🇩🇪: Methoden zum Einfügen, Verschieben und Entfernen von Elementen (append, prepend, remove).
+ * @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.remove = remove;
+exports.empty = empty;
+exports.replaceWithClone = replaceWithClone;
+exports.append = append;
+exports.prepend = prepend;
+exports.before = before;
+exports.after = after;
+exports.replaceWith = replaceWith;
+exports.appendTo = appendTo;
+exports.prependTo = prependTo;
+exports.insertBefore = insertBefore;
+exports.insertAfter = insertAfter;
+exports.wrap = wrap;
+exports.unwrap = unwrap;
+const core_1 = require("../../core");
+/**
+ * * 🇬🇧: Internal Helper: Converts a string into a DOM Node.
+ * * 🇩🇪: Interner Helper: Wandelt einen String in eine DOM Node um.
+ */
+function parseHTML(html) {
+    const tmp = document.createElement('div');
+    tmp.innerHTML = html.trim();
+    return tmp.firstElementChild;
+}
+/**
+ * * 🇬🇧: Internal Helper: Converts arbitrary input into a DocumentFragment to minimize reflows.
+ * * 🇩🇪: Interner Helper: Wandelt beliebigen Input in ein DocumentFragment um, um Reflows zu minimieren.
+ */
+function normalizeToFragment(content) {
+    const fragment = document.createDocumentFragment();
+    const add = (item) => {
+        if (typeof item === 'string') {
+            const temp = document.createElement('div');
+            temp.innerHTML = item.trim();
+            while (temp.firstChild) {
+                fragment.appendChild(temp.firstChild);
+            }
+        }
+        else if (item instanceof Node) {
+            fragment.appendChild(item);
+        }
+        else if (item instanceof core_1.jBase || Array.isArray(item) || item instanceof NodeList) {
+            Array.from(item).forEach(child => add(child));
+        }
+    };
+    add(content);
+    return fragment;
+}
+/**
+ * * 🇬🇧: Removes the selected elements from the DOM.
+ * * 🇩🇪: Entfernt die ausgewählten Elemente vollständig aus dem DOM.
+ * @returns
+ * * 🇬🇧: The current jBase instance.
+ * * 🇩🇪: Die aktuelle jBase-Instanz.
+ */
+function remove() {
+    this.forEach(el => {
+        if (el instanceof Element)
+            el.remove();
+    });
+    return this;
+}
+/**
+ * * 🇬🇧: Removes all child nodes and text content from the selected elements.
+ * * 🇩🇪: Entfernt alle Kind-Elemente und Textknoten aus den ausgewählten Elementen.
+ * @returns
+ * * 🇬🇧: The current jBase instance.
+ * * 🇩🇪: Die aktuelle jBase-Instanz.
+ */
+function empty() {
+    this.forEach(el => {
+        if (el instanceof Element)
+            el.innerHTML = '';
+    });
+    return this;
+}
+/**
+ * * 🇬🇧: Replaces each element with a deep clone of itself. Useful for removing all event listeners ("Nuke" strategy).
+ * * 🇩🇪: Ersetzt jedes Element durch eine tiefe Kopie seiner selbst. Nützlich, um alle Event-Listener hart zu entfernen.
+ * @returns
+ * * 🇬🇧: A new jBase instance containing the cloned elements.
+ * * 🇩🇪: Eine neue jBase-Instanz, die die geklonten Elemente enthält.
+ */
+function replaceWithClone() {
+    const newElements = [];
+    this.forEach(el => {
+        if (el instanceof Element) {
+            const clone = el.cloneNode(true);
+            el.replaceWith(clone);
+            newElements.push(clone);
+        }
+    });
+    return new this.constructor(newElements);
+}
+/**
+ * * 🇬🇧: Inserts content at the end of each selected element (inside).
+ * * 🇩🇪: Fügt Inhalt am Ende jedes Elements in der Sammlung ein (innerhalb).
+ * @param content
+ * * 🇬🇧: HTML string, DOM Node, or jBase collection.
+ * * 🇩🇪: HTML-String, DOM-Node oder jBase-Sammlung.
+ * @returns
+ * * 🇬🇧: The current jBase instance.
+ * * 🇩🇪: Die aktuelle jBase-Instanz.
+ */
+function append(content) {
+    const fragment = normalizeToFragment(content);
+    this.forEach((el, i) => {
+        if (el instanceof Element) {
+            // Clone fragment for multiple targets, retain original for the last one
+            const contentToInsert = (i < this.length - 1) ? fragment.cloneNode(true) : fragment;
+            el.appendChild(contentToInsert);
+        }
+    });
+    return this;
+}
+/**
+ * * 🇬🇧: Inserts content at the beginning of each selected element (inside).
+ * * 🇩🇪: Fügt Inhalt am Anfang jedes Elements in der Sammlung ein (innerhalb).
+ * @param content
+ * * 🇬🇧: HTML string, DOM Node, or jBase collection.
+ * * 🇩🇪: HTML-String, DOM-Node oder jBase-Sammlung.
+ * @returns
+ * * 🇬🇧: The current jBase instance.
+ * * 🇩🇪: Die aktuelle jBase-Instanz.
+ */
+function prepend(content) {
+    const fragment = normalizeToFragment(content);
+    this.forEach((el, i) => {
+        if (el instanceof Element) {
+            const contentToInsert = (i < this.length - 1) ? fragment.cloneNode(true) : fragment;
+            el.prepend(contentToInsert);
+        }
+    });
+    return this;
+}
+/**
+ * * 🇬🇧: Inserts content before the element (outside).
+ * * 🇩🇪: Fügt Inhalt VOR dem Element ein (außerhalb).
+ * @param content
+ * * 🇬🇧: HTML string, DOM Node, or jBase collection.
+ * * 🇩🇪: HTML-String, DOM-Node oder jBase-Sammlung.
+ * @returns
+ * * 🇬🇧: The current jBase instance.
+ * * 🇩🇪: Die aktuelle jBase-Instanz.
+ */
+function before(content) {
+    const fragment = normalizeToFragment(content);
+    this.forEach((el, i) => {
+        if (el instanceof Element) {
+            const contentToInsert = (i < this.length - 1) ? fragment.cloneNode(true) : fragment;
+            el.before(contentToInsert);
+        }
+    });
+    return this;
+}
+/**
+ * * 🇬🇧: Inserts content after the element (outside).
+ * * 🇩🇪: Fügt Inhalt NACH dem Element ein (außerhalb).
+ * @param content
+ * * 🇬🇧: HTML string, DOM Node, or jBase collection.
+ * * 🇩🇪: HTML-String, DOM-Node oder jBase-Sammlung.
+ * @returns
+ * * 🇬🇧: The current jBase instance.
+ * * 🇩🇪: Die aktuelle jBase-Instanz.
+ */
+function after(content) {
+    const fragment = normalizeToFragment(content);
+    this.forEach((el, i) => {
+        if (el instanceof Element) {
+            const contentToInsert = (i < this.length - 1) ? fragment.cloneNode(true) : fragment;
+            el.after(contentToInsert);
+        }
+    });
+    return this;
+}
+/**
+ * * 🇬🇧: Replaces the element with new content.
+ * * 🇩🇪: Ersetzt das Element durch neuen Inhalt.
+ * @param content
+ * * 🇬🇧: The new content.
+ * * 🇩🇪: Der neue Inhalt.
+ * @returns
+ * * 🇬🇧: The current jBase instance.
+ * * 🇩🇪: Die aktuelle jBase-Instanz.
+ */
+function replaceWith(content) {
+    const fragment = normalizeToFragment(content);
+    this.forEach((el, i) => {
+        if (el instanceof Element) {
+            const contentToInsert = (i < this.length - 1) ? fragment.cloneNode(true) : fragment;
+            el.replaceWith(contentToInsert);
+        }
+    });
+    return this;
+}
+/**
+ * * 🇬🇧: Appends the selected elements to the end of a target element.
+ * * 🇩🇪: Hängt die aktuellen Elemente an das Ende des Ziel-Elements an.
+ * @param target
+ * * 🇬🇧: CSS selector or DOM element.
+ * * 🇩🇪: Der CSS-Selektor oder das DOM-Element.
+ * @returns
+ * * 🇬🇧: The current jBase instance.
+ * * 🇩🇪: Die aktuelle jBase-Instanz.
+ */
+function appendTo(target) {
+    const parent = typeof target === 'string' ? document.querySelector(target) : target;
+    if (parent instanceof Element) {
+        const fragment = document.createDocumentFragment();
+        this.forEach(el => {
+            if (el instanceof Node)
+                fragment.appendChild(el);
+        });
+        parent.appendChild(fragment);
+    }
+    return this;
+}
+/**
+ * * 🇬🇧: Prepends the selected elements to the beginning of a target element.
+ * * 🇩🇪: Fügt die aktuellen Elemente am Anfang des Ziel-Elements ein.
+ * @param target
+ * * 🇬🇧: CSS selector or DOM element.
+ * * 🇩🇪: Der CSS-Selektor oder das DOM-Element.
+ * @returns
+ * * 🇬🇧: The current jBase instance.
+ * * 🇩🇪: Die aktuelle jBase-Instanz.
+ */
+function prependTo(target) {
+    const parent = typeof target === 'string' ? document.querySelector(target) : target;
+    if (parent instanceof Element) {
+        const fragment = document.createDocumentFragment();
+        this.forEach(el => {
+            if (el instanceof Node)
+                fragment.appendChild(el);
+        });
+        parent.prepend(fragment);
+    }
+    return this;
+}
+/**
+ * * 🇬🇧: Inserts the selected elements immediately before the target element.
+ * * 🇩🇪: Fügt die aktuellen Elemente unmittelbar VOR dem Ziel-Element ein.
+ * @param target
+ * * 🇬🇧: CSS selector or DOM element.
+ * * 🇩🇪: Der CSS-Selektor oder das DOM-Element.
+ * @returns
+ * * 🇬🇧: The current jBase instance.
+ * * 🇩🇪: Die aktuelle jBase-Instanz.
+ */
+function insertBefore(target) {
+    const targetEl = typeof target === 'string' ? document.querySelector(target) : target;
+    if (targetEl instanceof Element) {
+        const fragment = document.createDocumentFragment();
+        this.forEach(el => {
+            if (el instanceof Node)
+                fragment.appendChild(el);
+        });
+        targetEl.before(fragment);
+    }
+    return this;
+}
+/**
+ * * 🇬🇧: Inserts the selected elements immediately after the target element.
+ * * 🇩🇪: Fügt die aktuellen Elemente unmittelbar NACH dem Ziel-Element ein.
+ * @param target
+ * * 🇬🇧: CSS selector or DOM element.
+ * * 🇩🇪: Der CSS-Selektor oder das DOM-Element.
+ * @returns
+ * * 🇬🇧: The current jBase instance.
+ * * 🇩🇪: Die aktuelle jBase-Instanz.
+ */
+function insertAfter(target) {
+    const targetEl = typeof target === 'string' ? document.querySelector(target) : target;
+    if (targetEl instanceof Element) {
+        const fragment = document.createDocumentFragment();
+        this.forEach(el => {
+            if (el instanceof Node)
+                fragment.appendChild(el);
+        });
+        targetEl.after(fragment);
+    }
+    return this;
+}
+/**
+ * * 🇬🇧: Wraps each selected element with the specified HTML structure.
+ * * 🇩🇪: Umschließt jedes Element in der Auswahl mit der angegebenen HTML-Struktur.
+ * @param wrapperHtml
+ * * 🇬🇧: HTML string defining the wrapper (e.g., `<div class="box"></div>`).
+ * * 🇩🇪: Ein HTML-String, der die Wrapper-Struktur definiert (z.B. `<div class="box"></div>`).
+ * @returns
+ * * 🇬🇧: The current jBase instance.
+ * * 🇩🇪: Die aktuelle jBase-Instanz.
+ */
+function wrap(wrapperHtml) {
+    this.forEach(el => {
+        if (el instanceof Element) {
+            const wrapper = parseHTML(wrapperHtml);
+            if (el.parentNode) {
+                el.parentNode.insertBefore(wrapper, el);
+            }
+            wrapper.appendChild(el);
+        }
+    });
+    return this;
+}
+/**
+ * * 🇬🇧: Removes the direct parent of the selected elements from the DOM.
+ * * 🇩🇪: Entfernt das direkte Elternelement der ausgewählten Elemente aus dem DOM.
+ * @returns
+ * * 🇬🇧: The current jBase instance.
+ * * 🇩🇪: Die aktuelle jBase-Instanz.
+ */
+function unwrap() {
+    this.forEach(el => {
+        if (el instanceof Element && el.parentElement) {
+            const parent = el.parentElement;
+            const fragment = document.createDocumentFragment();
+            while (parent.firstChild) {
+                fragment.appendChild(parent.firstChild);
+            }
+            parent.replaceWith(fragment);
+        }
+    });
+    return this;
+}
+//# sourceMappingURL=manipulation.js.map

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

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

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

@@ -0,0 +1,50 @@
+/**
+ * @file src/modules/dom/states.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 checking element states (e.g., visibility, checked, disabled).
+ * * 🇩🇪: Methoden zur Prüfung von Element-Zuständen (z.B. Sichtbarkeit, checked, disabled).
+ * @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 or sets the 'checked' state of checkboxes and radio buttons.
+ * * 🇩🇪: Liest oder setzt den 'checked'-Status von Checkboxen und Radiobuttons.
+ * @param state
+ * * 🇬🇧: (Optional) `true` to check, `false` to uncheck. If undefined, acts as a getter.
+ * * 🇩🇪: (Optional) `true` zum Anhaken, `false` zum Deselektieren. Wenn nicht angegeben, wird gelesen.
+ * @returns
+ * * 🇬🇧: Boolean (getter) or the current jBase instance (setter).
+ * * 🇩🇪: Boolean (Getter) oder die aktuelle jBase-Instanz (Setter).
+ */
+export declare function checked(this: jBase, state?: boolean): boolean | jBase;
+/**
+ * * 🇬🇧: Gets or sets the 'selected' state of `<option>` elements.
+ * * 🇩🇪: Liest oder setzt den 'selected'-Status von `<option>`-Elementen.
+ * @param state
+ * * 🇬🇧: (Optional) `true` to select, `false` to deselect. If undefined, acts as a getter.
+ * * 🇩🇪: (Optional) `true` zum Auswählen, `false` zum Abwählen. Wenn nicht angegeben, wird gelesen.
+ * @returns
+ * * 🇬🇧: Boolean (getter) or the current jBase instance (setter).
+ * * 🇩🇪: Boolean (Getter) oder die aktuelle jBase-Instanz (Setter).
+ */
+export declare function selected(this: jBase, state?: boolean): boolean | jBase;
+/**
+ * * 🇬🇧: Enables or disables form fields and buttons. Additionally toggles the CSS class `.disabled`.
+ * * 🇩🇪: Aktiviert oder deaktiviert Formularfelder und Buttons. Toggelt zusätzlich die CSS-Klasse `.disabled`.
+ * @param state
+ * * 🇬🇧: (Optional) `true` to disable, `false` to enable. If undefined, acts as a getter.
+ * * 🇩🇪: (Optional) `true` zum Deaktivieren, `false` zum Aktivieren. Wenn nicht angegeben, wird gelesen.
+ * @returns
+ * * 🇬🇧: Boolean (getter) or the current jBase instance (setter).
+ * * 🇩🇪: Boolean (Getter) oder die aktuelle jBase-Instanz (Setter).
+ */
+export declare function disabled(this: jBase, state?: boolean): boolean | jBase;
+//# sourceMappingURL=states.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"states.d.ts","sourceRoot":"","sources":["../../../src/modules/dom/states.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,KAAK,CAUrE;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,KAAK,CAUtE;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,KAAK,CAetE"}

package/dist/modules/dom/states.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * @file src/modules/dom/states.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 checking element states (e.g., visibility, checked, disabled).
+ * * 🇩🇪: Methoden zur Prüfung von Element-Zuständen (z.B. Sichtbarkeit, checked, disabled).
+ * @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.checked = checked;
+exports.selected = selected;
+exports.disabled = disabled;
+/**
+ * * 🇬🇧: Gets or sets the 'checked' state of checkboxes and radio buttons.
+ * * 🇩🇪: Liest oder setzt den 'checked'-Status von Checkboxen und Radiobuttons.
+ * @param state
+ * * 🇬🇧: (Optional) `true` to check, `false` to uncheck. If undefined, acts as a getter.
+ * * 🇩🇪: (Optional) `true` zum Anhaken, `false` zum Deselektieren. Wenn nicht angegeben, wird gelesen.
+ * @returns
+ * * 🇬🇧: Boolean (getter) or the current jBase instance (setter).
+ * * 🇩🇪: Boolean (Getter) oder die aktuelle jBase-Instanz (Setter).
+ */
+function checked(state) {
+    if (state === undefined) {
+        const el = this[0];
+        return (el instanceof HTMLInputElement) ? el.checked : false;
+    }
+    this.forEach(el => {
+        if (el instanceof HTMLInputElement)
+            el.checked = state;
+    });
+    return this;
+}
+/**
+ * * 🇬🇧: Gets or sets the 'selected' state of `<option>` elements.
+ * * 🇩🇪: Liest oder setzt den 'selected'-Status von `<option>`-Elementen.
+ * @param state
+ * * 🇬🇧: (Optional) `true` to select, `false` to deselect. If undefined, acts as a getter.
+ * * 🇩🇪: (Optional) `true` zum Auswählen, `false` zum Abwählen. Wenn nicht angegeben, wird gelesen.
+ * @returns
+ * * 🇬🇧: Boolean (getter) or the current jBase instance (setter).
+ * * 🇩🇪: Boolean (Getter) oder die aktuelle jBase-Instanz (Setter).
+ */
+function selected(state) {
+    if (state === undefined) {
+        const el = this[0];
+        return (el instanceof HTMLOptionElement) ? el.selected : false;
+    }
+    this.forEach(el => {
+        if (el instanceof HTMLOptionElement)
+            el.selected = state;
+    });
+    return this;
+}
+/**
+ * * 🇬🇧: Enables or disables form fields and buttons. Additionally toggles the CSS class `.disabled`.
+ * * 🇩🇪: Aktiviert oder deaktiviert Formularfelder und Buttons. Toggelt zusätzlich die CSS-Klasse `.disabled`.
+ * @param state
+ * * 🇬🇧: (Optional) `true` to disable, `false` to enable. If undefined, acts as a getter.
+ * * 🇩🇪: (Optional) `true` zum Deaktivieren, `false` zum Aktivieren. Wenn nicht angegeben, wird gelesen.
+ * @returns
+ * * 🇬🇧: Boolean (getter) or the current jBase instance (setter).
+ * * 🇩🇪: Boolean (Getter) oder die aktuelle jBase-Instanz (Setter).
+ */
+function disabled(state) {
+    if (state === undefined) {
+        const el = this[0];
+        return (el instanceof HTMLElement && 'disabled' in el) ? el.disabled : false;
+    }
+    this.forEach(el => {
+        if (el instanceof HTMLElement && 'disabled' in el) {
+            el.disabled = state;
+            if (state)
+                el.classList.add('disabled');
+            else
+                el.classList.remove('disabled');
+        }
+    });
+    return this;
+}
+//# sourceMappingURL=states.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"states.js","sourceRoot":"","sources":["../../../src/modules/dom/states.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;AAcH,0BAUC;AAYD,4BAUC;AAYD,4BAeC;AArED;;;;;;;;;GASG;AACH,SAAgB,OAAO,CAAc,KAAe;IAChD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,OAAO,CAAC,EAAE,YAAY,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IACjE,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE;QACd,IAAI,EAAE,YAAY,gBAAgB;YAC9B,EAAE,CAAC,OAAO,GAAG,KAAK,CAAC;IAC3B,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,QAAQ,CAAc,KAAe;IACjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,OAAO,CAAC,EAAE,YAAY,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;IACnE,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE;QACd,IAAI,EAAE,YAAY,iBAAiB;YAC/B,EAAE,CAAC,QAAQ,GAAG,KAAK,CAAC;IAC5B,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,QAAQ,CAAc,KAAe;IACjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,OAAO,CAAC,EAAE,YAAY,WAAW,IAAI,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE,EAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1F,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE;QACd,IAAI,EAAE,YAAY,WAAW,IAAI,UAAU,IAAI,EAAE,EAAE,CAAC;YAC/C,EAAU,CAAC,QAAQ,GAAG,KAAK,CAAC;YAC7B,IAAI,KAAK;gBACL,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;;gBAE7B,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AAChB,CAAC"}