jj 2.2.0 → 2.4.0

package/lib/JJE.js

@@ -0,0 +1,412 @@
+import { isA, isArr, isObj, isStr } from 'jty';
+import { JJN } from './JJN.js';
+import { JJSR } from './JJSR.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 JJN {
+    /**
+     * 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(`Expected an Element. Got: ${ref} (${typeof ref})`);
+        }
+        super(ref);
+    }
+    /**
+     * Finds an element by ID within this element's context
+     *
+     * @remarks
+     * This method uses `Element.querySelector()` under the hood.
+     *
+     * @param id - The ID to search for.
+     * @param throwIfNotFound - Whether to throw an error if not found. Defaults to true.
+     * @returns The wrapped element, or null if not found and throwIfNotFound is false.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/querySelector | Element.querySelector}
+     */
+    byId(id, throwIfNotFound = true) {
+        if (!isStr(id)) {
+            throw new TypeError(`Expected a string id. Got ${id} (${typeof id})`);
+        }
+        return this.query(`#${id}`, throwIfNotFound);
+    }
+    /**
+     * Gets the value of an attribute.
+     *
+     * @param name - The name of the attribute.
+     * @returns The attribute value, or null if not present.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/getAttribute | Element.getAttribute}
+     */
+    getAttr(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`.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/hasAttribute | Element.hasAttribute}
+     */
+    hasAttr(name) {
+        return this.ref.hasAttribute(name);
+    }
+    /**
+     * Sets the value of an attribute.
+     *
+     * @param name - The name of the attribute.
+     * @param value - The value to set.
+     * @returns This instance for chaining.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/setAttribute | Element.setAttribute}
+     */
+    setAttr(name, value) {
+        this.ref.setAttribute(name, value);
+        return this;
+    }
+    /**
+     * Sets multiple attributes at once.
+     *
+     * @example
+     * ```ts
+     * el.setAttrs({ id: 'my-id', class: 'my-class' })
+     * ```
+     *
+     * @param obj - An object where keys are attribute names and values are attribute values.
+     * @returns This instance for chaining.
+     * @throws {TypeError} If `obj` is not an object.
+     */
+    setAttrs(obj) {
+        if (!isObj(obj)) {
+            throw new TypeError(`Expected an object. Got: ${obj} (${typeof obj})`);
+        }
+        for (const [name, value] of Object.entries(obj)) {
+            this.setAttr(name, value);
+        }
+        return this;
+    }
+    /**
+     * Removes an attribute.
+     *
+     * @param name - The name of the attribute to remove.
+     * @returns This instance for chaining.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/removeAttribute | Element.removeAttribute}
+     */
+    rmAttr(name) {
+        return this.rmAttrs(name);
+    }
+    /**
+     * Removes multiple attributes.
+     *
+     * @param names - The names of the attributes to remove.
+     * @returns This instance for chaining.
+     */
+    rmAttrs(...names) {
+        for (const name of names) {
+            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.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes | ARIA Attributes}
+     */
+    getAria(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.
+     */
+    hasAria(name) {
+        return this.ref.hasAttribute(`aria-${name}`);
+    }
+    /**
+     * Sets an ARIA attribute.
+     *
+     * @example
+     * ```ts
+     * el.setAria('hidden', 'true') // sets aria-hidden="true"
+     * ```
+     *
+     * @param name - The ARIA attribute suffix.
+     * @param value - The value to set.
+     * @returns This instance for chaining.
+     */
+    setAria(name, value) {
+        this.ref.setAttribute(`aria-${name}`, value);
+        return this;
+    }
+    /**
+     * Removes an ARIA attribute.
+     *
+     * @param name - The ARIA attribute suffix.
+     * @returns This instance for chaining.
+     */
+    rmAria(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');
+    }
+    /**
+     * Sets the class attribute.
+     *
+     * @param className - The class string to set.
+     * @returns This instance for chaining.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/className | Element.className}
+     */
+    setClass(className) {
+        return this.setAttr('class', className);
+    }
+    /**
+     * Removes the `class` attribute of the element.
+     *
+     * @remarks
+     * If you want to remove a few specific class instead of all, use `rmClasses`
+     *
+     * @returns This instance for chaining.
+     */
+    rmClass() {
+        return this.rmAttr('class');
+    }
+    /**
+     * Adds one or more classes to the element.
+     *
+     * @param classNames - The classes to add.
+     * @returns This instance for chaining.
+     * @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) {
+        this.ref.classList.add(...classNames);
+        return this;
+    }
+    /**
+     * Removes one or more classes from the element.
+     *
+     * @param classNames - The classes to remove.
+     * @returns This instance for chaining.
+     * @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}
+     */
+    rmClasses(...classNames) {
+        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.
+     * @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) {
+        return this.ref.classList.contains(className);
+    }
+    /**
+     * Toggles a class on the element.
+     *
+     * @param className - The class to toggle.
+     * @returns This instance for chaining.
+     * @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) {
+        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
+     */
+    replaceClass(oldClassName, newClassName) {
+        this.ref.classList.replace(oldClassName, newClassName);
+        return this;
+    }
+    /**
+     * Adds a click event listener.
+     *
+     * @param handler - The event handler.
+     * @returns This instance for chaining.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener | EventTarget.addEventListener}
+     */
+    onClick(handler) {
+        return this.on('click', handler);
+    }
+    /**
+     * 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.rmAttrs('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.rmAttrs('disabled', 'aria-disabled');
+    }
+    /**
+     * Gets the title attribute.
+     *
+     * @returns The title, or null if not set.
+     */
+    getTitle() {
+        return this.getAttr('title');
+    }
+    /**
+     * Sets the title attribute.
+     *
+     * @param title - The title to set.
+     * @returns This instance for chaining.
+     */
+    setTitle(title) {
+        return this.setAttr('title', title);
+    }
+    /**
+     * Sets the id attribute.
+     *
+     * @param id - The id to set.
+     * @returns This instance for chaining.
+     */
+    setId(id) {
+        return this.setAttr('id', id);
+    }
+    /**
+     * Gets the id attribute.
+     *
+     * @returns The id, or null if not set.
+     */
+    getId() {
+        return this.getAttr('id');
+    }
+    /**
+     * Gets the inner HTML of the element.
+     *
+     * @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.
+     *
+     * @param html - The HTML string to set.
+     * @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

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

package/lib/JJHE.d.ts

@@ -0,0 +1,120 @@
+import { JJE } from './JJE.js';
+import { IElementData, IQuery } from './mixin-types.js';
+import { Wrapped } from './types.js';
+/**
+ * Wraps a DOM HTMLElement (which is a descendant of Element).
+ *
+ * @remarks
+ * This class extends `JJE` to provide specific functionality for HTML elements,
+ * such as access to `dataset`, `innerText`, and form values.
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement | HTMLElement}
+ */
+export declare class JJHE<T extends HTMLElement = HTMLElement> extends JJE<T> {
+    /**
+     * Creates a JJHE instance from an HTMLElement reference.
+     *
+     * @example
+     * ```ts
+     * const el = JJHE.from(document.getElementById('my-id'))
+     * ```
+     *
+     * @param ref - The HTMLElement.
+     * @returns A new JJHE instance.
+     */
+    static from(ref: HTMLElement): JJHE;
+    /**
+     * Creates a JJHE instance from a tag name.
+     *
+     * @example
+     * ```ts
+     * const div = JJHE.fromTag('div')
+     * const input = JJHE.fromTag('input', { is: 'custom-input' })
+     * ```
+     *
+     * @param tagName - The tag name.
+     * @param options - Element creation options.
+     * @returns A new JJHE instance.
+     * @throws {TypeError} If `tagName` is not a string.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/createElement | document.createElement}
+     */
+    static fromTag(tagName: string, options?: ElementCreationOptions): JJHE;
+    /**
+     * Creates an instance of JJHE.
+     *
+     * @param ref - The HTMLElement to wrap.
+     * @throws {TypeError} If `ref` is not an HTMLElement.
+     */
+    constructor(ref: T);
+    /**
+     * Gets the value property of the element (e.g. for inputs).
+     *
+     * @returns The value.
+     * @throws {Error} If the element does not have a value property.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/value | HTMLInputElement.value}
+     */
+    getValue(): unknown;
+    /**
+     * Sets the value property of the element.
+     *
+     * @example
+     * ```ts
+     * input.setValue('new value')
+     * ```
+     *
+     * @param value - The value to set.
+     * @returns This instance for chaining.
+     * @throws {Error} If the element does not have a value property.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/value | HTMLInputElement.value}
+     */
+    setValue(value: string): this;
+    /**
+     * Focuses the element.
+     *
+     * @returns This instance for chaining.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus | HTMLElement.focus}
+     */
+    focus(): this;
+    /**
+     * Clicks the element.
+     *
+     * @returns This instance for chaining.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/click | HTMLElement.click}
+     */
+    click(): this;
+    /**
+     * Gets the inner text of the element.
+     *
+     * @returns The inner text.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText | HTMLElement.innerText}
+     */
+    getText(): string;
+    /**
+     * Sets the inner text of the element.
+     *
+     * @param text - The text to set.
+     * @returns This instance for chaining.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText | HTMLElement.innerText}
+     */
+    setText(text: string): this;
+    /**
+     * Finds the first element matching a selector within this element's context.
+     *
+     * @param selector - The CSS selector.
+     * @param throwIfNotFound - Whether to throw an error if not found. Defaults to true.
+     * @returns The wrapped element, or null.
+     * @throws {TypeError} If the element is not found and `throwIfNotFound` is true.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/querySelector | Element.querySelector}
+     */
+    query(selector: string, throwIfNotFound?: boolean): Wrapped | null;
+    /**
+     * Finds all elements matching a selector within this element's context.
+     *
+     * @param selector - The CSS selector.
+     * @returns An array of wrapped elements.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/querySelectorAll | Element.querySelectorAll}
+     */
+    queryAll(selector: string): Wrapped[];
+}
+export declare interface JJHE<T extends HTMLElement> extends IQuery, IElementData {
+}