npm - jj - Versions diffs - 2.2.0 → 2.3.0 - Mend

jj 2.2.0 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (93) hide show

package/lib/JJD.d.ts ADDED Viewed

@@ -0,0 +1,76 @@
+import { JJN } from './JJN.js';
+import { IAppendPrepend, IById, IQuery } from './mixin-types.js';
+export interface JJD<T extends Document> extends IById, IQuery, IAppendPrepend {
+}
+/**
+ * Wraps a Document (which is a descendant of Node).
+ *
+ * @remarks
+ * This class provides a wrapper around the native `Document` interface, inheriting
+ * the fluent API capabilities of `JJN`.
+ * It also supports querying (`byId`, `query`) and manipulation (`append`, `prepend`) methods.
+ *
+ * @example
+ * ```ts
+ * const doc = JJD.from(document)
+ * doc.on('DOMContentLoaded', () => console.log('Ready'))
+ * ```
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document | Document}
+ */
+export declare class JJD<T extends Document = Document> extends JJN<T> {
+    /**
+     * Creates a JJD instance from a Document reference.
+     *
+     * @example
+     * ```ts
+     * const doc = JJD.from(document)
+     * ```
+     *
+     * @param ref - The Document instance.
+     * @returns A new JJD instance.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document | Document}
+     */
+    static from(ref: Document): JJD;
+    /**
+     * Creates an instance of JJD.
+     *
+     * @param ref - The Document instance to wrap.
+     * @throws {TypeError} If `ref` is not a Document.
+     */
+    constructor(ref: T);
+    /**
+     * Gets the `<head>` element of the document wrapped in a `JJHE` instance.
+     *
+     * @returns The wrapped head element.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/head | Document.head}
+     */
+    get head(): import("./types.js").Wrapped;
+    /**
+     * Gets the `<body>` element of the document wrapped in a `JJHE` instance.
+     *
+     * @returns The wrapped body element.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/body | Document.body}
+     */
+    get body(): import("./types.js").Wrapped;
+    /**
+     * Sets the document title.
+     *
+     * @example
+     * ```ts
+     * JJD.from(document).setTitle('New Page Title')
+     * ```
+     *
+     * @param title - The new title string.
+     * @returns This instance for chaining.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/title | Document.title}
+     */
+    setTitle(title: string): this;
+    /**
+     * Gets the document title.
+     *
+     * @returns The current title of the document.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/title | Document.title}
+     */
+    getTitle(): string;
+}

package/lib/JJD.js ADDED Viewed

@@ -0,0 +1,91 @@
+import { isA } from 'jty';
+import { JJN } from './JJN.js';
+/**
+ * Wraps a Document (which is a descendant of Node).
+ *
+ * @remarks
+ * This class provides a wrapper around the native `Document` interface, inheriting
+ * the fluent API capabilities of `JJN`.
+ * It also supports querying (`byId`, `query`) and manipulation (`append`, `prepend`) methods.
+ *
+ * @example
+ * ```ts
+ * const doc = JJD.from(document)
+ * doc.on('DOMContentLoaded', () => console.log('Ready'))
+ * ```
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document | Document}
+ */
+export class JJD extends JJN {
+    /**
+     * Creates a JJD instance from a Document reference.
+     *
+     * @example
+     * ```ts
+     * const doc = JJD.from(document)
+     * ```
+     *
+     * @param ref - The Document instance.
+     * @returns A new JJD instance.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document | Document}
+     */
+    static from(ref) {
+        return new JJD(ref);
+    }
+    /**
+     * Creates an instance of JJD.
+     *
+     * @param ref - The Document instance to wrap.
+     * @throws {TypeError} If `ref` is not a Document.
+     */
+    constructor(ref) {
+        if (!isA(ref, Document)) {
+            throw new TypeError(`Expected a Document. Got ${ref} (${typeof ref})`);
+        }
+        super(ref);
+    }
+    /**
+     * Gets the `<head>` element of the document wrapped in a `JJHE` instance.
+     *
+     * @returns The wrapped head element.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/head | Document.head}
+     */
+    get head() {
+        return JJN.wrap(this.ref.head);
+    }
+    /**
+     * Gets the `<body>` element of the document wrapped in a `JJHE` instance.
+     *
+     * @returns The wrapped body element.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/body | Document.body}
+     */
+    get body() {
+        return JJN.wrap(this.ref.body);
+    }
+    /**
+     * Sets the document title.
+     *
+     * @example
+     * ```ts
+     * JJD.from(document).setTitle('New Page Title')
+     * ```
+     *
+     * @param title - The new title string.
+     * @returns This instance for chaining.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/title | Document.title}
+     */
+    setTitle(title) {
+        this.ref.title = title;
+        return this;
+    }
+    /**
+     * Gets the document title.
+     *
+     * @returns The current title of the document.
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/title | Document.title}
+     */
+    getTitle() {
+        return this.ref.title;
+    }
+}
+//# sourceMappingURL=JJD.js.map

package/lib/JJD.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"JJD.js","sourceRoot":"","sources":["../src/JJD.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AACzB,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAK9B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,GAAmC,SAAQ,GAAM;IAC1D;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,CAAC,GAAa;QACrB,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;IACvB,CAAC;IAED;;;;;OAKG;IACH,YAAY,GAAM;QACd,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,SAAS,CAAC,4BAA4B,GAAG,KAAK,OAAO,GAAG,GAAG,CAAC,CAAA;QAC1E,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,CAAA;IACd,CAAC;IAED;;;;;OAKG;IACH,IAAI,IAAI;QACJ,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC;IAED;;;;;OAKG;IACH,IAAI,IAAI;QACJ,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,KAAa;QAClB,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAA;QACtB,OAAO,IAAI,CAAA;IACf,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAA;IACzB,CAAC;CACJ"}

package/lib/JJDF.d.ts ADDED Viewed

@@ -0,0 +1,60 @@
+import { JJN } from './JJN.js';
+import { IAppendPrepend, IById, IQuery } from './mixin-types.js';
+export interface JJDF<T extends DocumentFragment> extends IById, IQuery, IAppendPrepend {
+}
+/**
+ * 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 JJN<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);
+}

package/lib/JJDF.js ADDED Viewed

@@ -0,0 +1,68 @@
+import { isA } from 'jty';
+import { JJN } from './JJN.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 JJN {
+    /**
+     * 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);
+    }
+}
+//# sourceMappingURL=JJDF.js.map

package/lib/JJDF.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"JJDF.js","sourceRoot":"","sources":["../src/JJDF.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AACzB,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAK9B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,IAAoD,SAAQ,GAAM;IAC3E;;;;;;;;;;;;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;CACJ"}

package/lib/JJE.d.ts ADDED Viewed

@@ -0,0 +1,313 @@
+import { JJN } from './JJN.js';
+import { JJSR } from './JJSR.js';
+import { IAppendPrepend, IById, IQuery } from './mixin-types.js';
+import { ShadowConfig, Wrapped } from './types.js';
+export interface JJE<T extends Element> extends IQuery, IAppendPrepend {
+}
+/**
+ * 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 JJN<T> implements IById {
+    /**
+     * 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);
+    /**
+     * 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: string, throwIfNotFound?: boolean): Wrapped | null;
+    /**
+     * 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: string): string | null;
+    /**
+     * 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: string): boolean;
+    /**
+     * 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: string, value: string): 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: Record<string, string>): 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: string): this;
+    /**
+     * Removes multiple attributes.
+     *
+     * @param names - The names of the attributes to remove.
+     * @returns This instance for chaining.
+     */
+    rmAttrs(...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.
+     * @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.
+     */
+    hasAria(name: string): boolean;
+    /**
+     * 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: string, value: string): this;
+    /**
+     * Removes an ARIA attribute.
+     *
+     * @param name - The ARIA attribute suffix.
+     * @returns This instance for chaining.
+     */
+    rmAria(name: 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.
+     *
+     * @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: string): this;
+    /**
+     * 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(): this;
+    /**
+     * 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: string[]): 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: 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.
+     * @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.
+     * @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
+     */
+    replaceClass(oldClassName: string, newClassName: string): 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: EventListenerOrEventListenerObject): 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 title attribute.
+     *
+     * @returns The title, or null if not set.
+     */
+    getTitle(): string | null;
+    /**
+     * Sets the title attribute.
+     *
+     * @param title - The title to set.
+     * @returns This instance for chaining.
+     */
+    setTitle(title: string): this;
+    /**
+     * Sets the id attribute.
+     *
+     * @param id - The id to set.
+     * @returns This instance for chaining.
+     */
+    setId(id: string): this;
+    /**
+     * Gets the id attribute.
+     *
+     * @returns The id, or null if not set.
+     */
+    getId(): string | null;
+    /**
+     * 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(): string;
+    /**
+     * 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: string): 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;
+}