jj 2.5.0 → 2.6.0

package/lib/JJE.js

@@ -1,401 +0,0 @@
-import { isA, isArr, isObj, isStr } from 'jty';
-import { JJSR } from './JJSR.js';
-import { JJNx } from './JJNx.js';
-import { typeErr } from './internal.js';
-/**
- * Wraps a DOM Element (which is a descendant of Node).
- *
- * @remarks
- * This class provides a wrapper around the native `Element` interface, adding fluent API methods
- * for attribute manipulation, class handling, and event binding.
- *
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element | Element}
- */
-export class JJE extends JJNx {
-    /**
-     * Creates a JJE instance from an Element reference.
-     *
-     * @example
-     * ```ts
-     * const el = JJE.from(document.querySelector('.my-class'))
-     * ```
-     *
-     * @param ref - The Element instance.
-     * @returns A new JJE instance.
-     */
-    static from(ref) {
-        return new JJE(ref);
-    }
-    /**
-     * Creates an instance of JJE.
-     *
-     * @param ref - The Element to wrap.
-     * @throws {TypeError} If `ref` is not an Element.
-     */
-    constructor(ref) {
-        if (!isA(ref, Element)) {
-            throw new TypeError(`JJE expects an Element instance. Got ${ref} (${typeof ref}). ` +
-                `Use JJE.from(element) with a DOM Element, or use the specific wrapper (JJHE for HTMLElement, JJSE for SVGElement).`);
-        }
-        super(ref);
-    }
-    /**
-     * Gets the value of an attribute.
-     *
-     * @param name - The name of the attribute.
-     * @returns The attribute value, or null if not present.
-     * @throws {TypeError} If `name` is not a string.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/getAttribute | Element.getAttribute}
-     */
-    getAttr(name) {
-        if (!isStr(name)) {
-            throw typeErr('name', 'a string', name);
-        }
-        return this.ref.getAttribute(name);
-    }
-    /**
-     * Checks if an attribute exists.
-     *
-     * @param name - The name of the attribute.
-     * @returns `true` if the attribute exists, otherwise `false`.
-     * @throws {TypeError} If `name` is not a string.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/hasAttribute | Element.hasAttribute}
-     */
-    hasAttr(name) {
-        if (!isStr(name)) {
-            throw typeErr('name', 'a string', name);
-        }
-        return this.ref.hasAttribute(name);
-    }
-    setAttr(nameOrObj, value) {
-        if (typeof nameOrObj === 'string') {
-            this.ref.setAttribute(nameOrObj, value);
-        }
-        else if (isObj(nameOrObj)) {
-            for (const [k, v] of Object.entries(nameOrObj)) {
-                this.ref.setAttribute(k, v);
-            }
-        }
-        else {
-            throw typeErr('nameOrObj', 'a string or object', nameOrObj);
-        }
-        return this;
-    }
-    /**
-     * Removes one or more attributes from the Element.
-     *
-     * @example
-     * ```ts
-     * el.rmAttr('disabled')  // Remove single
-     * el.rmAttr('hidden', 'aria-hidden')  // Remove multiple
-     * ```
-     *
-     * @param names - The name(s) of the attribute(s) to remove.
-     * @returns This instance for chaining.
-     * @throws {TypeError} If any name is not a string.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/removeAttribute | Element.removeAttribute}
-     */
-    rmAttr(...names) {
-        for (const name of names) {
-            if (!isStr(name)) {
-                throw typeErr('name', 'a string', name);
-            }
-            this.ref.removeAttribute(name);
-        }
-        return this;
-    }
-    /**
-     * Gets the value of an ARIA attribute.
-     *
-     * @remarks
-     * Automatically prepends `aria-` to the name.
-     *
-     * @example
-     * ```ts
-     * el.getAria('label') // gets 'aria-label'
-     * ```
-     *
-     * @param name - The ARIA attribute suffix (e.g., 'label' for 'aria-label').
-     * @returns The attribute value, or null if not present.
-     * @throws {TypeError} If `name` is not a string.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes | ARIA Attributes}
-     */
-    getAria(name) {
-        if (!isStr(name)) {
-            throw typeErr('name', 'a string', name);
-        }
-        return this.ref.getAttribute(`aria-${name}`);
-    }
-    /**
-     * Checks if an ARIA attribute exists.
-     *
-     * @param name - The ARIA attribute suffix.
-     * @returns `true` if the attribute exists.
-     * @throws {TypeError} If `name` is not a string.
-     */
-    hasAria(name) {
-        if (!isStr(name)) {
-            throw typeErr('name', 'a string', name);
-        }
-        return this.ref.hasAttribute(`aria-${name}`);
-    }
-    setAria(nameOrObj, value) {
-        if (isStr(nameOrObj)) {
-            this.ref.setAttribute(`aria-${nameOrObj}`, value);
-        }
-        else if (isObj(nameOrObj)) {
-            for (const [k, v] of Object.entries(nameOrObj)) {
-                this.ref.setAttribute(`aria-${k}`, v);
-            }
-        }
-        else {
-            throw typeErr('nameOrObj', 'a string or object', nameOrObj);
-        }
-        return this;
-    }
-    /**
-     * Removes one or more ARIA attributes from the Element.
-     *
-     * @example
-     * ```ts
-     * el.rmAria('hidden')  // Remove single
-     * el.rmAria('label', 'hidden')  // Remove multiple
-     * ```
-     *
-     * @param names - The ARIA attribute suffix(es) to remove.
-     * @returns This instance for chaining.
-     * @throws {TypeError} If any name is not a string.
-     */
-    rmAria(...names) {
-        for (const name of names) {
-            if (!isStr(name)) {
-                throw typeErr('name', 'a string', name);
-            }
-            this.ref.removeAttribute(`aria-${name}`);
-        }
-        return this;
-    }
-    /**
-     * Gets the class attribute.
-     *
-     * @returns The class attribute value, or null if not present.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/className | Element.className}
-     */
-    getClass() {
-        return this.getAttr('class');
-    }
-    setClass(classNameOrMap) {
-        if (typeof classNameOrMap === 'string') {
-            return this.setAttr('class', classNameOrMap);
-        }
-        // Conditional class object (Vue.js style)
-        for (const [className, condition] of Object.entries(classNameOrMap)) {
-            if (condition) {
-                this.ref.classList.add(className);
-            }
-            else {
-                this.ref.classList.remove(className);
-            }
-        }
-        return this;
-    }
-    /**
-     * Adds one or more classes to the Element.
-     *
-     * @example
-     * ```ts
-     * el.addClass('btn', 'btn-primary')
-     * ```
-     *
-     * @param classNames - The classes to add.
-     * @returns This instance for chaining.
-     * @throws {TypeError} If any class name is not a string.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/classList | Element.classList}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DOMTokenList/add | DOMTokenList.add}
-     */
-    addClass(...classNames) {
-        for (const className of classNames) {
-            if (!isStr(className)) {
-                throw typeErr('className', 'a string', className);
-            }
-        }
-        this.ref.classList.add(...classNames);
-        return this;
-    }
-    /**
-     * Removes one or more classes from the Element.
-     *
-     * @example
-     * ```ts
-     * el.rmClass('active')  // Remove single
-     * el.rmClass('btn', 'btn-primary')  // Remove multiple
-     * ```
-     *
-     * @param classNames - The classes to remove.
-     * @returns This instance for chaining.
-     * @throws {TypeError} If any class name is not a string.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/classList | Element.classList}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DOMTokenList/remove | DOMTokenList.remove}
-     */
-    rmClass(...classNames) {
-        for (const className of classNames) {
-            if (!isStr(className)) {
-                throw typeErr('className', 'a string', className);
-            }
-        }
-        this.ref.classList.remove(...classNames);
-        return this;
-    }
-    /**
-     * Checks if the Element has a specific class.
-     *
-     * @param className - The class to check for.
-     * @returns `true` if the element has the class.
-     * @throws {TypeError} If `className` is not a string.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/classList | Element.classList}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DOMTokenList/contains | DOMTokenList.contains}
-     */
-    hasClass(className) {
-        if (!isStr(className)) {
-            throw typeErr('className', 'a string', className);
-        }
-        return this.ref.classList.contains(className);
-    }
-    /**
-     * Toggles a class on the Element.
-     *
-     * @param className - The class to toggle.
-     * @returns This instance for chaining.
-     * @throws {TypeError} If `className` is not a string.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/classList | Element.classList}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DOMTokenList/toggle | DOMTokenList.toggle}
-     */
-    toggleClass(className) {
-        if (!isStr(className)) {
-            throw typeErr('className', 'a string', className);
-        }
-        this.ref.classList.toggle(className);
-        return this;
-    }
-    /**
-     * Replaces a class with another one
-     *
-     * @remarks
-     * If the `oldClassName` doesn't exist, the `newClassName` isn't added
-     *
-     * @param oldClassName - The class name to remove
-     * @param newClassName - The class name to add
-     * @throws {TypeError} If either className is not a string.
-     */
-    replaceClass(oldClassName, newClassName) {
-        if (!isStr(oldClassName)) {
-            throw typeErr('oldClassName', 'a string', oldClassName);
-        }
-        if (!isStr(newClassName)) {
-            throw typeErr('newClassName', 'a string', newClassName);
-        }
-        this.ref.classList.replace(oldClassName, newClassName);
-        return this;
-    }
-    /**
-
-     * Hides the Element by setting the `hidden` attribute and `aria-hidden="true"`.
-     *
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/hidden | hidden attribute}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-hidden | aria-hidden}
-     */
-    hide() {
-        return this.setAttr('hidden', '').setAttr('aria-hidden', 'true');
-    }
-    /**
-     * Shows the Element by removing the `hidden` and `aria-hidden` attributes.
-     *
-     * @returns This instance for chaining.
-     */
-    show() {
-        return this.rmAttr('hidden', 'aria-hidden');
-    }
-    /**
-     * Disables the Element by setting the `disabled` attribute and `aria-disabled="true"`.
-     *
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/disabled | disabled attribute}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-disabled | aria-disabled}
-     */
-    disable() {
-        return this.setAttr('disabled', '').setAttr('aria-disabled', 'true');
-    }
-    /**
-     * Enables the Element by removing the `disabled` and `aria-disabled` attributes.
-     *
-     * @returns This instance for chaining.
-     */
-    enable() {
-        return this.rmAttr('disabled', 'aria-disabled');
-    }
-    /**
-     * Gets the inner HTML of the Element.
-     *
-     * @remarks
-     * This method operates on `innerHTML`. The method name is kept short for convenience.
-     *
-     * @returns The inner HTML string.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/innerHTML | Element.innerHTML}
-     */
-    getHTML() {
-        return this.ref.innerHTML;
-    }
-    /**
-     * Sets the inner HTML of the Element.
-     *
-     * @remarks
-     * This method operates on `innerHTML`. The method name is kept short for convenience.
-     * Pass an empty string, `null`, or `undefined` to clear the content.
-     *
-     * @param html - The HTML string to set, or null/undefined to clear.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/innerHTML | Element.innerHTML}
-     */
-    setHTML(html) {
-        this.ref.innerHTML = html ?? '';
-        return this;
-    }
-    /**
-     * Attaches a Shadow DOM to the Element and optionally sets its content and styles.
-     *
-     * @remarks
-     * We prevent FOUC by assigning the template and CSS in one go.
-     * **Note:** You can't attach a shadow root to every type of element. There are some that can't have a
-     * shadow DOM for security reasons (for example `<a>`).
-     *
-     * @param mode - The encapsulation mode ('open' or 'closed'). Defaults to 'open'.
-     * @param config - Optional configuration object containing `template` (HTML string) and `styles` (array of CSSStyleSheet).
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/attachShadow | Element.attachShadow}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/ShadowRoot/adoptedStyleSheets | ShadowRoot.adoptedStyleSheets}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/adoptedStyleSheets | Document.adoptedStyleSheets}
-     */
-    initShadow(mode = 'open', config) {
-        const shadowRoot = this.ref.shadowRoot ?? this.ref.attachShadow({ mode });
-        if (isObj(config)) {
-            const { template, styles } = config;
-            if (template) {
-                shadowRoot.innerHTML = template;
-            }
-            if (isArr(styles) && styles.length) {
-                shadowRoot.adoptedStyleSheets.push(...styles);
-            }
-        }
-        return this;
-    }
-    /**
-     * Gets a wrapper around the Element's Shadow Root, if it exists.
-     *
-     * @returns A JJSR instance wrapping the shadow root, or null if no shadow root exists.
-     */
-    get shadow() {
-        return this.ref.shadowRoot ? new JJSR(this.ref.shadowRoot) : null;
-    }
-}
-//# sourceMappingURL=JJE.js.map

package/lib/JJE.js.map

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

package/lib/JJET.d.ts

@@ -1,79 +0,0 @@
-/**
- * Wraps a DOM EventTarget.
- *
- * @remarks
- * This is the base class for all JJ wrappers that wrap an EventTarget.
- *
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget | EventTarget}
- */
-export declare class JJET<T extends EventTarget = EventTarget> {
-    #private;
-    static from(ref: EventTarget): JJET<EventTarget>;
-    /**
-     * Creates a JJET instance.
-     *
-     * @param ref - The EventTarget to wrap.
-     * @throws {TypeError} If `ref` is not an EventTarget.
-     */
-    constructor(ref: T);
-    /**
-     * Gets the underlying DOM object.
-     */
-    get ref(): T;
-    /**
-     * Adds an event listener.
-     *
-     *  * @example
-     * ```ts
-     * JJET.from(window).on('resize', () => console.log('resized'))
-     * ```
-     * @param eventName - The name of the event.
-     * @param handler - The event handler.
-     * @param options - Optional event listener options.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener | EventTarget.addEventListener}
-     */
-    on(eventName: string, handler: EventListenerOrEventListenerObject | null, options?: AddEventListenerOptions): this;
-    /**
-     * Removes an event listener.
-     *
-     *  * @example
-     * ```ts
-     * JJET.from(window).off('resize', previouslyAttachedHandler)
-     * ```
-     * @param eventName - The name of the event.
-     * @param handler - The event handler.
-     * @param options - Optional event listener options or boolean.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener | EventTarget.removeEventListener}
-     */
-    off(eventName: string, handler: EventListenerOrEventListenerObject | null, options?: EventListenerOptions | boolean): this;
-    /**
-     * Dispatches an Event at the specified EventTarget.
-     *
-     * @param event - The Event object to dispatch.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/dispatchEvent | EventTarget.dispatchEvent}
-     */
-    trigger(event: Event): this;
-    /**
-     * Runs a function in the context of this JJET instance.
-     *
-     * @example
-     * ```ts
-     * node.run(function() {
-     *   console.log(this.ref)
-     * })
-     * ```
-     * @remarks
-     * If you want to access the current JJ* instance using `this` keyword, you SHOULD use a `function` not an arrow function.
-     * If the function throws, `run()` doesn't swallow the exception.
-     * So if you're expecting an error, make sure to wrap it in a `try..catch` block and handle the exception.
-     * If the function returns a promise, you can `await` on the response.
-     *
-     * @param fn - The function to run. `this` inside the function will refer to this JJET instance.
-     * @param args - Arguments to pass to the function.
-     * @returns The return value of the function.
-     */
-    run<R, Args extends any[]>(fn: (this: this, ...args: Args) => R, ...args: Args): R;
-}

package/lib/JJET.js

@@ -1,114 +0,0 @@
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _JJET_ref;
-import { isA } from 'jty';
-/**
- * Wraps a DOM EventTarget.
- *
- * @remarks
- * This is the base class for all JJ wrappers that wrap an EventTarget.
- *
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget | EventTarget}
- */
-export class JJET {
-    static from(ref) {
-        return new JJET(ref);
-    }
-    /**
-     * Creates a JJET instance.
-     *
-     * @param ref - The EventTarget to wrap.
-     * @throws {TypeError} If `ref` is not an EventTarget.
-     */
-    constructor(ref) {
-        _JJET_ref.set(this, void 0);
-        if (!isA(ref, EventTarget)) {
-            throw new TypeError(`JJET expects an EventTarget instance. Got ${ref} (${typeof ref}). `);
-        }
-        __classPrivateFieldSet(this, _JJET_ref, ref, "f");
-    }
-    /**
-     * Gets the underlying DOM object.
-     */
-    get ref() {
-        return __classPrivateFieldGet(this, _JJET_ref, "f");
-    }
-    /**
-     * Adds an event listener.
-     *
-     *  * @example
-     * ```ts
-     * JJET.from(window).on('resize', () => console.log('resized'))
-     * ```
-     * @param eventName - The name of the event.
-     * @param handler - The event handler.
-     * @param options - Optional event listener options.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener | EventTarget.addEventListener}
-     */
-    on(eventName, handler, options) {
-        this.ref.addEventListener(eventName, handler, options);
-        return this;
-    }
-    /**
-     * Removes an event listener.
-     *
-     *  * @example
-     * ```ts
-     * JJET.from(window).off('resize', previouslyAttachedHandler)
-     * ```
-     * @param eventName - The name of the event.
-     * @param handler - The event handler.
-     * @param options - Optional event listener options or boolean.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener | EventTarget.removeEventListener}
-     */
-    off(eventName, handler, options) {
-        this.ref.removeEventListener(eventName, handler, options);
-        return this;
-    }
-    /**
-     * Dispatches an Event at the specified EventTarget.
-     *
-     * @param event - The Event object to dispatch.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/dispatchEvent | EventTarget.dispatchEvent}
-     */
-    trigger(event) {
-        this.ref.dispatchEvent(event);
-        return this;
-    }
-    /**
-     * Runs a function in the context of this JJET instance.
-     *
-     * @example
-     * ```ts
-     * node.run(function() {
-     *   console.log(this.ref)
-     * })
-     * ```
-     * @remarks
-     * If you want to access the current JJ* instance using `this` keyword, you SHOULD use a `function` not an arrow function.
-     * If the function throws, `run()` doesn't swallow the exception.
-     * So if you're expecting an error, make sure to wrap it in a `try..catch` block and handle the exception.
-     * If the function returns a promise, you can `await` on the response.
-     *
-     * @param fn - The function to run. `this` inside the function will refer to this JJET instance.
-     * @param args - Arguments to pass to the function.
-     * @returns The return value of the function.
-     */
-    run(fn, ...args) {
-        return fn.call(this, ...args);
-    }
-}
-_JJET_ref = new WeakMap();
-//# sourceMappingURL=JJET.js.map

package/lib/JJET.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"JJET.js","sourceRoot":"","sources":["../src/JJET.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAEzB;;;;;;;GAOG;AACH,MAAM,OAAO,IAAI;IACb,MAAM,CAAC,IAAI,CAAC,GAAgB;QACxB,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAA;IACxB,CAAC;IAID;;;;;OAKG;IACH,YAAY,GAAM;QARlB,4BAAQ;QASJ,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,SAAS,CAAC,6CAA6C,GAAG,KAAK,OAAO,GAAG,KAAK,CAAC,CAAA;QAC7F,CAAC;QACD,uBAAA,IAAI,aAAQ,GAAG,MAAA,CAAA;IACnB,CAAC;IAED;;OAEG;IACH,IAAI,GAAG;QACH,OAAO,uBAAA,IAAI,iBAAK,CAAA;IACpB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,EAAE,CAAC,SAAiB,EAAE,OAAkD,EAAE,OAAiC;QACvG,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;QACtD,OAAO,IAAI,CAAA;IACf,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,GAAG,CACC,SAAiB,EACjB,OAAkD,EAClD,OAAwC;QAExC,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;QACzD,OAAO,IAAI,CAAA;IACf,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,KAAY;QAChB,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;QAC7B,OAAO,IAAI,CAAA;IACf,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,GAAG,CAAwB,EAAoC,EAAE,GAAG,IAAU;QAC1E,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAA;IACjC,CAAC;CACJ"}

package/lib/JJEx.d.ts

@@ -1,63 +0,0 @@
-import { JJE } from './JJE.js';
-export declare abstract class JJEx<T extends HTMLElement | SVGElement> extends JJE<T> {
-    /**
-     * Gets a data attribute from the HTMLElement.
-     *
-     * @example
-     * ```ts
-     * const value = el.getData('my-key')
-     * ```
-     *
-     * @param name - The data attribute name (in camelCase).
-     * @returns The value of the attribute, or undefined if not set.
-     * @throws {TypeError} If `name` is not a string.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset | HTMLElement.dataset}
-     */
-    getData(name: string): string | undefined;
-    /**
-     * Checks if a data attribute exists on the HTMLElement.
-     *
-     * @example
-     * ```ts
-     * if (el.hasData('my-key')) {
-     *   // ...
-     * }
-     * ```
-     *
-     * @param name - The data attribute name (in camelCase).
-     * @returns True if the attribute exists, false otherwise.
-     * @throws {TypeError} If `name` is not a string.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset | HTMLElement.dataset}
-     */
-    hasData(name: string): boolean;
-    /**
-     * Sets one or more data attributes on the HTMLElement.
-     *
-     * @example
-     * ```ts
-     * el.setData('myKey', 'myValue')  // Single
-     * el.setData({ myKey: 'myValue', otherKey: 'otherValue' })  // Multiple
-     * el.setData('count', 42)  // Numbers are automatically converted
-     * ```
-     *
-     * @throws {TypeError} If arguments are invalid types.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset | HTMLElement.dataset}
-     */
-    setData(name: string, value: any): this;
-    setData(obj: Record<string, any>): this;
-    /**
-     * Removes one or more data attributes from the HTMLElement.
-     *
-     * @example
-     * ```ts
-     * el.rmData('myKey')  // Remove single
-     * el.rmData('myKey', 'otherKey')  // Remove multiple
-     * ```
-     *
-     * @param names - The data attribute name(s) (in camelCase).
-     * @returns This instance for chaining.
-     * @throws {TypeError} If any name is not a string.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset | HTMLElement.dataset}
-     */
-    rmData(...names: string[]): this;
-}