jj 2.5.0 → 2.7.2

package/lib/JJDF.d.ts

@@ -1,74 +0,0 @@
-import { Wrapped } from './types.js';
-import { JJNx } from './JJNx.js';
-/**
- * Wraps a DocumentFragment (which is a descendant of Node).
- *
- * @remarks
- * DocumentFragments are lightweight versions of Document that store a segment of a document structure
- * comprised of nodes just like a standard document. The key difference is that because the document fragment
- * isn't part of the active document tree structure, changes made to the fragment don't affect the document,
- * cause reflow, or incur any performance impact that can occur when changes are made.
- *
- * @example
- * ```ts
- * const frag = JJDF.create()
- * frag.append(
- *   h('div', null, 'Item 1'),
- *   h('div', null, 'Item 2'),
- * )
- * document.body.appendChild(frag.ref)
- * ```
- *
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DocumentFragment | DocumentFragment}
- */
-export declare class JJDF<T extends DocumentFragment = DocumentFragment> extends JJNx<T> {
-    /**
-     * Creates a JJDF instance from a DocumentFragment reference.
-     *
-     * @example
-     * ```ts
-     * const frag = JJDF.from(myFrag)
-     * ```
-     *
-     *
-     * @param ref - The DocumentFragment instance.
-     * @returns A new JJDF instance.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DocumentFragment | DocumentFragment}
-     */
-    static from(ref: DocumentFragment): JJDF;
-    /**
-     * Creates a new empty JJDF instance (wraps a new DocumentFragment).
-     *
-     * @example
-     * ```ts
-     * const frag = JJDF.create()
-     * ```
-     *
-     * @returns A new JJDF instance.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/createDocumentFragment | document.createDocumentFragment}
-     */
-    static create(): JJDF<DocumentFragment>;
-    /**
-     * Creates an instance of JJDF.
-     *
-     * @param ref - The DocumentFragment instance to wrap.
-     * @throws {TypeError} If `ref` is not a DocumentFragment.
-     */
-    constructor(ref: T);
-    /**
-     * Finds an element by ID within this DocumentFragment.
-     *
-     * @example
-     * ```ts
-     * const el = frag.byId('header')  // Returns null if not found
-     * const el = frag.byId('header', true)  // Throws if not found
-     * ```
-     *
-     * @param id - The ID to search for.
-     * @param required - Whether to throw an error if not found. Defaults to false.
-     * @returns The wrapped element, or null if not found and required is false.
-     * @throws {TypeError} If id is not a string or element not found and required is true.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DocumentFragment/getElementById | DocumentFragment.getElementById}
-     */
-    byId(id: string, required?: boolean): Wrapped | null;
-}

package/lib/JJDF.js

@@ -1,98 +0,0 @@
-import { isA, isStr } from 'jty';
-import { JJN } from './JJN.js';
-import { JJNx } from './JJNx.js';
-import { typeErr } from './internal.js';
-/**
- * Wraps a DocumentFragment (which is a descendant of Node).
- *
- * @remarks
- * DocumentFragments are lightweight versions of Document that store a segment of a document structure
- * comprised of nodes just like a standard document. The key difference is that because the document fragment
- * isn't part of the active document tree structure, changes made to the fragment don't affect the document,
- * cause reflow, or incur any performance impact that can occur when changes are made.
- *
- * @example
- * ```ts
- * const frag = JJDF.create()
- * frag.append(
- *   h('div', null, 'Item 1'),
- *   h('div', null, 'Item 2'),
- * )
- * document.body.appendChild(frag.ref)
- * ```
- *
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DocumentFragment | DocumentFragment}
- */
-export class JJDF extends JJNx {
-    /**
-     * Creates a JJDF instance from a DocumentFragment reference.
-     *
-     * @example
-     * ```ts
-     * const frag = JJDF.from(myFrag)
-     * ```
-     *
-     *
-     * @param ref - The DocumentFragment instance.
-     * @returns A new JJDF instance.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DocumentFragment | DocumentFragment}
-     */
-    static from(ref) {
-        return new JJDF(ref);
-    }
-    /**
-     * Creates a new empty JJDF instance (wraps a new DocumentFragment).
-     *
-     * @example
-     * ```ts
-     * const frag = JJDF.create()
-     * ```
-     *
-     * @returns A new JJDF instance.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/createDocumentFragment | document.createDocumentFragment}
-     */
-    static create() {
-        return new JJDF(document.createDocumentFragment());
-    }
-    /**
-     * Creates an instance of JJDF.
-     *
-     * @param ref - The DocumentFragment instance to wrap.
-     * @throws {TypeError} If `ref` is not a DocumentFragment.
-     */
-    constructor(ref) {
-        if (!isA(ref, DocumentFragment)) {
-            throw new TypeError(`Expected a DocumentFragment. Got ${ref} (${typeof ref})`);
-        }
-        super(ref);
-    }
-    /**
-     * Finds an element by ID within this DocumentFragment.
-     *
-     * @example
-     * ```ts
-     * const el = frag.byId('header')  // Returns null if not found
-     * const el = frag.byId('header', true)  // Throws if not found
-     * ```
-     *
-     * @param id - The ID to search for.
-     * @param required - Whether to throw an error if not found. Defaults to false.
-     * @returns The wrapped element, or null if not found and required is false.
-     * @throws {TypeError} If id is not a string or element not found and required is true.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DocumentFragment/getElementById | DocumentFragment.getElementById}
-     */
-    byId(id, required = false) {
-        if (!isStr(id)) {
-            throw typeErr('id', 'a string', id);
-        }
-        const el = this.ref.getElementById(id);
-        if (el) {
-            return JJN.wrap(el);
-        }
-        if (required) {
-            throw new TypeError(`Element with id ${id} not found`);
-        }
-        return null;
-    }
-}
-//# sourceMappingURL=JJDF.js.map

package/lib/JJDF.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"JJDF.js","sourceRoot":"","sources":["../src/JJDF.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,KAAK,CAAA;AAChC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,IAAoD,SAAQ,IAAO;IAC5E;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAI,CAAC,GAAqB;QAC7B,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAA;IACxB,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAM;QACT,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,sBAAsB,EAAE,CAAC,CAAA;IACtD,CAAC;IAED;;;;;OAKG;IACH,YAAY,GAAM;QACd,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,SAAS,CAAC,oCAAoC,GAAG,KAAK,OAAO,GAAG,GAAG,CAAC,CAAA;QAClF,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,CAAA;IACd,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,EAAU,EAAE,QAAQ,GAAG,KAAK;QAC7B,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACb,MAAM,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,CAAA;QACvC,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC,CAAA;QACtC,IAAI,EAAE,EAAE,CAAC;YACL,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACvB,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACX,MAAM,IAAI,SAAS,CAAC,mBAAmB,EAAE,YAAY,CAAC,CAAA;QAC1D,CAAC;QACD,OAAO,IAAI,CAAA;IACf,CAAC;CACJ"}

package/lib/JJE.d.ts

@@ -1,299 +0,0 @@
-import { JJSR } from './JJSR.js';
-import { ShadowConfig } from './types.js';
-import { JJNx } from './JJNx.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 declare class JJE<T extends Element = Element> extends JJNx<T> {
-    /**
-     * 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: Element): JJE;
-    /**
-     * Creates an instance of JJE.
-     *
-     * @param ref - The Element to wrap.
-     * @throws {TypeError} If `ref` is not an Element.
-     */
-    constructor(ref: T);
-    /**
-     * 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: string): string | null;
-    /**
-     * 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: string): boolean;
-    /**
-     * Sets one or more attributes on the Element.
-     *
-     * @example
-     * ```ts
-     * el.setAttr('id', 'my-id')  // Single attribute
-     * el.setAttr({ id: 'my-id', class: 'my-class' })  // Multiple attributes
-     * el.setAttr('x', 50)  // Numbers are automatically converted
-     * ```
-     *
-     * @throws {TypeError} If arguments are invalid types.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/setAttribute | Element.setAttribute}
-     */
-    setAttr(name: string, value: any): this;
-    setAttr(obj: Record<string, any>): 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: string[]): 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: string): string | null;
-    /**
-     * 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: string): boolean;
-    /**
-     * Sets one or more ARIA attributes on the Element.
-     *
-     * @example
-     * ```ts
-     * el.setAria('hidden', 'true')  // Single: sets aria-hidden="true"
-     * el.setAria({ label: 'Close', hidden: 'false' })  // Multiple
-     * el.setAria('level', 2)  // Numbers are automatically converted
-     * ```
-     *
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes | ARIA Attributes}
-     */
-    setAria(name: string, value: any): this;
-    setAria(obj: Record<string, any>): 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: string[]): 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(): string | null;
-    /**
-     * Sets the class attribute or conditionally adds/removes classes.
-     *
-     * @remarks
-     * - Pass a string to replace the entire class attribute
-     * - Pass an object with class names as keys and boolean values to conditionally add/remove classes
-     * - To remove all classes, pass an empty string: `setClass('')`
-     *
-     * @example
-     * ```ts
-     * el.setClass('btn btn-primary')  // Set classes as string
-     * el.setClass({                   // Conditional classes (Vue.js style)
-     *   'active': true,               // adds 'active'
-     *   'disabled': false,            // removes 'disabled'
-     *   'highlight': isHighlighted    // adds/removes based on condition
-     * })
-     * ```
-     *
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/className | Element.className}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/classList | Element.classList}
-     */
-    setClass(className: string): this;
-    setClass(classMap: Record<string, boolean | unknown>): 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: string[]): 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: string[]): 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: string): boolean;
-    /**
-     * 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: string): 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: string, newClassName: string): 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(): this;
-    /**
-     * Shows the Element by removing the `hidden` and `aria-hidden` attributes.
-     *
-     * @returns This instance for chaining.
-     */
-    show(): this;
-    /**
-     * 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(): this;
-    /**
-     * Enables the Element by removing the `disabled` and `aria-disabled` attributes.
-     *
-     * @returns This instance for chaining.
-     */
-    enable(): this;
-    /**
-     * 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(): string;
-    /**
-     * 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?: string | null): 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?: ShadowRootMode, config?: ShadowConfig): 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(): JJSR<ShadowRoot> | null;
-}