jj 2.4.0 → 2.6.0

package/lib/JJN.js

@@ -1,323 +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 _JJN_ref;
-import { isA, isObj, isStr } from 'jty';
-import { off, on } from './util.js';
-/**
- * Wraps a DOM Node.
- *
- * @remarks
- * This is the base class for all JJ wrappers. It provides common functionality for DOM manipulation,
- * traversal, and event handling.
- *
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Node | Node}
- */
-export class JJN {
-    /**
-     * Creates a JJN instance from a Node reference.
-     *
-     * @example
-     * ```ts
-     * const node = JJN.from(document.createTextNode('hello'))
-     * ```
-     *
-     * @param node - The Node instance.
-     * @returns A new JJN instance.
-     */
-    static from(node) {
-        return new JJN(node);
-    }
-    /**
-     * Checks if a value can be passed to the `wrap()` or `unwrap()` function.
-     *
-     * @remarks
-     * This is useful for filtering the array that is passed to `append()`, `prepend()` or `setChildren()`
-     *
-     * @param x an unknown value
-     * @returns true if `x` is a string, Node (or its descendents), JJN (or its descendents)
-     */
-    static isWrapable(x) {
-        return isStr(x) || isA(x, Node) || isA(x, JJN);
-    }
-    /**
-     * Wraps a native DOM node or string into the most specific JJ wrapper available.
-     *
-     * @remarks
-     * This function acts as a factory, inspecting the input type and returning the appropriate
-     * subclass of `JJN` (e.g., `JJHE` for `HTMLElement`, `JJT` for `Text`).
-     *
-     * @example
-     * ```ts
-     * const bodyWrapper = JJN.wrap(document.body) // Returns JJHE
-     * const textWrapper = JJN.wrap('Hello') // Returns JJT wrapping a new Text node
-     * ```
-     *
-     * @param raw - The object to wrap. If it's already Wrapped, it'll be returned without any change. We don't double-wrap or clone it.
-     * @returns The most granular Wrapped subclass instance. If the input is already wrapped, it'll be returned as is without cloning.
-     * @throws {TypeError} If the input is not a Node, string, or JJ wrapper.
-     */
-    static wrap(raw) {
-        throw new ReferenceError(`The mixin is supposed to override this method.`);
-    }
-    /**
-     * Extracts the underlying native DOM node from a wrapper.
-     *
-     * @remarks
-     * If the input is already a native Node, it is returned as is.
-     * If the input is a string, a new Text node is created and returned.
-     *
-     * @example
-     * ```ts
-     * const rawElement = JJN.unwrap(myJJHE) // Returns HTMLElement
-     * ```
-     *
-     * @param obj - The object to unwrap.
-     * @returns The underlying DOM node.
-     * @throws {TypeError} If the input cannot be unwrapped.
-     */
-    static unwrap(obj) {
-        if (isStr(obj)) {
-            return document.createTextNode(obj);
-        }
-        if (!isObj(obj)) {
-            throw new TypeError(`Expected an object. Got ${obj} (${typeof obj})`);
-        }
-        if (isA(obj, Node)) {
-            return obj;
-        }
-        if (isA(obj, JJN)) {
-            return obj.ref;
-        }
-        throw new TypeError(`Could not unwrap ${obj} (${typeof obj})`);
-    }
-    /**
-     * Wraps an iterable object (e.g. an array of wrapped or DOM elements).
-     *
-     * @example
-     * ```ts
-     * const wrappedList = JJN.wrapAll(document.querySelectorAll('div'))
-     * ```
-     *
-     * @param iterable - The iterable to wrap.
-     * @returns An array of wrapped instances.
-     */
-    static wrapAll(iterable) {
-        return Array.from(iterable, JJN.wrap);
-    }
-    /**
-     * Unwraps an iterable object (e.g. an array or HTMLCollection).
-     *
-     * @example
-     * ```ts
-     * const nodes = JJN.unwrapAll(wrappedList)
-     * ```
-     *
-     * @param iterable - The iterable to unwrap.
-     * @returns An array of native DOM nodes.
-     */
-    static unwrapAll(iterable) {
-        return Array.from(iterable, JJN.unwrap);
-    }
-    /**
-     * Creates an instance of JJN.
-     *
-     * @param ref - The Node to wrap.
-     * @throws {TypeError} If `ref` is not a Node.
-     */
-    constructor(ref) {
-        _JJN_ref.set(this, void 0);
-        if (!isA(ref, Node)) {
-            throw new TypeError(`Expected a Node. Got ${ref} (${typeof ref})`);
-        }
-        __classPrivateFieldSet(this, _JJN_ref, ref, "f");
-    }
-    /**
-     * Gets the underlying DOM Node.
-     */
-    get ref() {
-        return __classPrivateFieldGet(this, _JJN_ref, "f");
-    }
-    /**
-     * Clones the node.
-     *
-     * @param deep - If true, clones the subtree.
-     * @returns A new wrapped instance of the clone.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Node/cloneNode | Node.cloneNode}
-     */
-    clone(deep) {
-        return JJN.wrap(this.ref.cloneNode(deep));
-    }
-    /**
-     * Appends children to this node.
-     *
-     * @remarks
-     * To make template codes easier, this function ignores any child that is not possible to `wrap()` (e.g. undefined, null, false).
-     *
-     * @param children - The children to append (Nodes, strings, or Wrappers).
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/append | Element.append}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Node/appendChild | Node.appendChild}
-     */
-    append(...children) {
-        const nodes = JJN.unwrapAll(children.filter(JJN.isWrapable));
-        const ref = this.ref;
-        for (const node of nodes) {
-            if (node) {
-                ref.appendChild(node);
-            }
-        }
-        return this;
-    }
-    /**
-     * Maps an array to children and appends them.
-     *
-     * @example
-     * ```ts
-     * list.mapAppend(['a', 'b'], item => h('li', null, item))
-     * ```
-     *
-     * @remarks
-     * To make template codes easier, this function ignores any child that is not possible to `wrap()` (e.g. undefined, null, false).
-     *
-     * @param array - The source array.
-     * @param mapFn - The mapping function returning a Wrappable.
-     * @returns This instance for chaining.
-     */
-    mapAppend(array, mapFn) {
-        return this.append(...array.map(mapFn));
-    }
-    /**
-     * Prepends children to this node.
-     *
-     * @remarks
-     * To make template codes easier, this function ignores any child that is not possible to `wrap()` (e.g. undefined, null, false).
-     *
-     * @param children - The children to prepend.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/prepend | Element.prepend}
-     */
-    prepend(...children) {
-        const nodes = JJN.unwrapAll(children.filter(JJN.isWrapable));
-        const ref = this.ref;
-        const first = ref.firstChild;
-        for (const node of nodes) {
-            if (node) {
-                ref.insertBefore(node, first);
-            }
-        }
-        return this;
-    }
-    /**
-     * Maps an array to children and prepends them.
-     *
-     * @example
-     * ```ts
-     * list.mapPrepend(['a', 'b'], item => JJHE.fromTag('li').setText(item))
-     * ```
-     *
-     * @remarks
-     * To make template codes easier, this function ignores any child that is not possible to `wrap()` (e.g. undefined, null, false).
-     *
-     * @param array - The source array.
-     * @param mapFn - The mapping function.
-     * @returns This instance for chaining.
-     */
-    mapPrepend(array, mapFn) {
-        return this.prepend(...array.map(mapFn));
-    }
-    /**
-     * Replaces the existing children of this node with a specified new set of children.
-     *
-     * @remarks
-     * If no children are specified, it essentially empties the node
-     * To make template codes easier, this function ignores any child that is not possible to `wrap()` (e.g. undefined, null, false).
-     *
-     * @param children - The new children to set.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/replaceChildren | Element.replaceChildren}
-     */
-    setChildren(...children) {
-        return this.empty().append(...children.filter(JJN.isWrapable));
-    }
-    /**
-     * Adds an event listener.
-     *
-     * @param eventName - The event name.
-     * @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}
-     */
-    on(eventName, handler) {
-        on(this.ref, eventName, handler);
-        return this;
-    }
-    /**
-     * Removes an event listener.
-     *
-     * @param eventName - The event name.
-     * @param handler - The event handler.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener | EventTarget.removeEventListener}
-     */
-    off(eventName, handler) {
-        off(this.ref, eventName, handler);
-        return this;
-    }
-    /**
-     * Removes this node from the DOM.
-     *
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Node/removeChild | Node.removeChild}
-     */
-    rm() {
-        this.ref.parentNode?.removeChild(this.ref);
-        return this;
-    }
-    /**
-     * Removes all children from this node.
-     *
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/replaceChildren | Element.replaceChildren}
-     */
-    empty() {
-        const element = this.ref;
-        while (element.firstChild) {
-            element.removeChild(element.firstChild);
-        }
-        return this;
-    }
-    /**
-     * Runs a function in the context of this JJN instance.
-     *
-     * @example
-     * ```ts
-     * div.run(function() {
-     *   this.addClass('active')
-     *   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 JJN instance.
-     * @param args - Arguments to pass to the function.
-     * @returns The return value of the function.
-     */
-    run(fn, ...args) {
-        return fn.call(this, ...args);
-    }
-}
-_JJN_ref = new WeakMap();
-//# sourceMappingURL=JJN.js.map

package/lib/JJN.js.map

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

package/lib/JJSE.d.ts

@@ -1,148 +0,0 @@
-import { JJE } from './JJE.js';
-import { IElementData } from './mixin-types.js';
-/**
- * Wraps a DOM SVGElement.
- *
- * @remarks
- * This class extends `JJE` to provide specific functionality for SVG elements,
- * including namespace-aware creation and helper methods for common SVG attributes.
- *
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/SVGElement | SVGElement}
- */
-export declare class JJSE<T extends SVGElement = SVGElement> extends JJE<T> {
-    /**
-     * Creates a JJSE instance from an SVGElement reference.
-     *
-     * @example
-     * ```ts
-     * const svg = JJSE.from(myCircle)
-     * ```
-     *
-     * @param ref - The SVGElement.
-     * @returns A new JJSE instance.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/SVGElement | SVGElement}
-     */
-    static from(ref: SVGElement): JJSE;
-    /**
-     * Creates a JJSE instance from a tag name (in the SVG namespace).
-     *
-     * @remarks
-     * Automatically uses the correct SVG namespace URI: `http://www.w3.org/2000/svg`.
-     *
-     * @example
-     * ```ts
-     * const circle = JJSE.fromTag('circle')
-     * ```
-     *
-     * @param tagName - The tag name.
-     * @param options - Element creation options.
-     * @returns A new JJSE instance.
-     * @throws {TypeError} If `tagName` is not a string.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/createElementNS | document.createElementNS}
-     */
-    static fromTag(tagName: string, options?: ElementCreationOptions): JJSE;
-    /**
-     * Creates an instance of JJSE.
-     *
-     * @param ref - The SVGElement to wrap.
-     * @throws {TypeError} If `ref` is not an SVGElement.
-     */
-    constructor(ref: T);
-    /**
-     * Gets the text content of the element.
-     *
-     * @returns The text content.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent | Node.textContent}
-     */
-    getText(): string;
-    /**
-     * Sets the text content 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/Node/textContent | Node.textContent}
-     */
-    setText(text: string): this;
-    /**
-     * Clears the text content of the element.
-     *
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent | Node.textContent}
-     */
-    empty(): this;
-    /**
-     * Sets the fill attribute.
-     *
-     * @param value - The fill color/value.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/fill | fill}
-     */
-    setFill(value: string): this;
-    /**
-     * Sets the stroke attribute.
-     *
-     * @param value - The stroke color/value.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/stroke | stroke}
-     */
-    setStroke(value: string): this;
-    /**
-     * Sets the stroke-width attribute.
-     *
-     * @param value - The width.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/stroke-width | stroke-width}
-     */
-    setStrokeWidth(value: string | number): this;
-    /**
-     * Sets the viewBox attribute.
-     *
-     * @example
-     * ```ts
-     * svg.setViewBox(0, 0, 100, 100)
-     * svg.setViewBox('0 0 100 100')
-     * ```
-     *
-     * @param p1 - Min-x or string/array value.
-     * @param p2 - Min-y.
-     * @param p3 - Width.
-     * @param p4 - Height.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/viewBox | viewBox}
-     */
-    setViewBox(p1: string | (string | number)[] | number, p2?: number, p3?: number, p4?: number): this;
-    /**
-     * Sets the width attribute.
-     *
-     * @param value - The width.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/width | width}
-     */
-    setWidth(value: string | number): this;
-    /**
-     * Sets the height attribute.
-     *
-     * @param value - The height.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/height | height}
-     */
-    setHeight(value: string | number): this;
-    /**
-     * Sets the d attribute (path data).
-     *
-     * @param value - The path data string or array of segments.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/d | d}
-     */
-    setD(value: string | (string | number)[]): this;
-    /**
-     * Sets the transform attribute.
-     *
-     * @param value - The transform string.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/transform | transform}
-     */
-    setTransform(value: string): this;
-}
-export declare interface JJSE<T extends SVGElement> extends IElementData {
-}

package/lib/JJSE.js

@@ -1,190 +0,0 @@
-import { isA, isStr } from 'jty';
-import { JJE } from './JJE.js';
-const SVG_NAMESPACE_URI = 'http://www.w3.org/2000/svg';
-/**
- * Wraps a DOM SVGElement.
- *
- * @remarks
- * This class extends `JJE` to provide specific functionality for SVG elements,
- * including namespace-aware creation and helper methods for common SVG attributes.
- *
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/SVGElement | SVGElement}
- */
-export class JJSE extends JJE {
-    /**
-     * Creates a JJSE instance from an SVGElement reference.
-     *
-     * @example
-     * ```ts
-     * const svg = JJSE.from(myCircle)
-     * ```
-     *
-     * @param ref - The SVGElement.
-     * @returns A new JJSE instance.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/SVGElement | SVGElement}
-     */
-    static from(ref) {
-        return new JJSE(ref);
-    }
-    /**
-     * Creates a JJSE instance from a tag name (in the SVG namespace).
-     *
-     * @remarks
-     * Automatically uses the correct SVG namespace URI: `http://www.w3.org/2000/svg`.
-     *
-     * @example
-     * ```ts
-     * const circle = JJSE.fromTag('circle')
-     * ```
-     *
-     * @param tagName - The tag name.
-     * @param options - Element creation options.
-     * @returns A new JJSE instance.
-     * @throws {TypeError} If `tagName` is not a string.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/createElementNS | document.createElementNS}
-     */
-    static fromTag(tagName, options) {
-        if (!isStr(tagName)) {
-            throw new TypeError(`Expected a string for tagName. Got: ${tagName} (${typeof tagName})`);
-        }
-        // SVG elements must be created with the SVG namespace
-        const element = document.createElementNS(SVG_NAMESPACE_URI, tagName, options);
-        return new JJSE(element);
-    }
-    /**
-     * Creates an instance of JJSE.
-     *
-     * @param ref - The SVGElement to wrap.
-     * @throws {TypeError} If `ref` is not an SVGElement.
-     */
-    constructor(ref) {
-        if (!isA(ref, SVGElement)) {
-            throw new TypeError(`Expected an SVGElement. Got ${ref} (${typeof ref})`);
-        }
-        super(ref);
-    }
-    /**
-     * Gets the text content of the element.
-     *
-     * @returns The text content.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent | Node.textContent}
-     */
-    getText() {
-        return this.ref.textContent ?? '';
-    }
-    /**
-     * Sets the text content 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/Node/textContent | Node.textContent}
-     */
-    setText(text) {
-        this.ref.textContent = text;
-        return this;
-    }
-    /**
-     * Clears the text content of the element.
-     *
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent | Node.textContent}
-     */
-    empty() {
-        this.ref.textContent = '';
-        return this;
-    }
-    /**
-     * Sets the fill attribute.
-     *
-     * @param value - The fill color/value.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/fill | fill}
-     */
-    setFill(value) {
-        return this.setAttr('fill', value);
-    }
-    /**
-     * Sets the stroke attribute.
-     *
-     * @param value - The stroke color/value.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/stroke | stroke}
-     */
-    setStroke(value) {
-        return this.setAttr('stroke', value);
-    }
-    /**
-     * Sets the stroke-width attribute.
-     *
-     * @param value - The width.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/stroke-width | stroke-width}
-     */
-    setStrokeWidth(value) {
-        return this.setAttr('stroke-width', String(value));
-    }
-    /**
-     * Sets the viewBox attribute.
-     *
-     * @example
-     * ```ts
-     * svg.setViewBox(0, 0, 100, 100)
-     * svg.setViewBox('0 0 100 100')
-     * ```
-     *
-     * @param p1 - Min-x or string/array value.
-     * @param p2 - Min-y.
-     * @param p3 - Width.
-     * @param p4 - Height.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/viewBox | viewBox}
-     */
-    setViewBox(p1, p2, p3, p4) {
-        if (typeof p1 === 'number' && p2 !== undefined && p3 !== undefined && p4 !== undefined) {
-            return this.setAttr('viewBox', `${p1} ${p2} ${p3} ${p4}`);
-        }
-        const value = p1;
-        return this.setAttr('viewBox', Array.isArray(value) ? value.join(' ') : value);
-    }
-    /**
-     * Sets the width attribute.
-     *
-     * @param value - The width.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/width | width}
-     */
-    setWidth(value) {
-        return this.setAttr('width', String(value));
-    }
-    /**
-     * Sets the height attribute.
-     *
-     * @param value - The height.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/height | height}
-     */
-    setHeight(value) {
-        return this.setAttr('height', String(value));
-    }
-    /**
-     * Sets the d attribute (path data).
-     *
-     * @param value - The path data string or array of segments.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/d | d}
-     */
-    setD(value) {
-        return this.setAttr('d', Array.isArray(value) ? value.join(' ') : value);
-    }
-    /**
-     * Sets the transform attribute.
-     *
-     * @param value - The transform string.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/transform | transform}
-     */
-    setTransform(value) {
-        return this.setAttr('transform', value);
-    }
-}
-//# sourceMappingURL=JJSE.js.map

package/lib/JJSE.js.map

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