jj 2.7.2 → 2.9.0

package/lib/bundle.js

@@ -303,9 +303,9 @@ var JJN = class _JJN extends JJET {
    * 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)
+   * @returns true if `x` is a string, Node (or its descendent), JJN (or its descendent)
    */
-  static isWrapable(x) {
+  static isWrappable(x) {
     return isStr(x) || isA(x, Node) || isA(x, _JJN);
   }
   /**
@@ -314,6 +314,7 @@ var JJN = class _JJN extends JJET {
    * @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`).
+   * JJN.ts overrides this method to a richer version that handles all subclasses of JJN.
    *
    * @example
    * ```ts
@@ -326,7 +327,15 @@ var JJN = class _JJN extends JJET {
    * @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.`);
+    if (isObj(raw)) {
+      if (isA(raw, _JJN)) {
+        return raw;
+      }
+      if (isA(raw, Node)) {
+        return new _JJN(raw);
+      }
+    }
+    throw typeErr("raw", "a Node", raw);
   }
   /**
    * Extracts the underlying native DOM node from a wrapper.
@@ -403,6 +412,44 @@ var JJN = class _JJN extends JJET {
     }
     super(ref);
   }
+  /**
+   * Gets the parent node wrapped in the most specific JJ wrapper available.
+   *
+   * @remarks
+   * Returns `null` when this node is detached and therefore has no parent.
+   *
+   * @example
+   * ```ts
+   * const text = JJT.fromStr('hello')
+   * JJHE.create('div').addChild(text)
+   * const parent = text.parent // JJHE
+   * ```
+   *
+   * @returns The wrapped parent node, or `null` if this node has no parent.
+   * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Node/parentNode | Node.parentNode}
+   */
+  get parent() {
+    const { parentNode } = this.ref;
+    return parentNode ? _JJN.wrap(parentNode) : null;
+  }
+  /**
+   * Gets the child nodes wrapped in the most specific JJ wrappers available.
+   *
+   * @remarks
+   * Returns an empty array when this node has no children.
+   *
+   * @example
+   * ```ts
+   * const el = JJHE.create('div').addChild('hello', JJHE.create('span'))
+   * const children = el.children // [JJT, JJHE]
+   * ```
+   *
+   * @returns The wrapped child nodes.
+   * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Node/childNodes | Node.childNodes}
+   */
+  get children() {
+    return _JJN.wrapAll(this.ref.childNodes);
+  }
   /**
    * Clones the Node.
    *
@@ -413,6 +460,29 @@ var JJN = class _JJN extends JJET {
   clone(deep) {
     return _JJN.wrap(this.ref.cloneNode(deep));
   }
+  /**
+   * Removes this node from its parent.
+   *
+   * @remarks
+   * If the node has no parent, this method does nothing.
+   *
+   * @example
+   * ```ts
+   * const el = JJHE.create('div')
+   * doc.body.addChild(el)
+   * el.rm()
+   * ```
+   *
+   * @returns This instance for chaining.
+   * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Node/removeChild | Node.removeChild}
+   */
+  rm() {
+    const { parentNode } = this.ref;
+    if (parentNode) {
+      parentNode.removeChild(this.ref);
+    }
+    return this;
+  }
   /**
    * Creates a Text node from a string and appends it to this Node.
    *
@@ -429,9 +499,9 @@ var JJN = class _JJN extends JJET {
    * @returns This instance for chaining.
    * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/createTextNode | document.createTextNode}
    */
-  addText(text) {
-    if (text) {
-      this.ref.appendChild(document.createTextNode(text));
+  addText(...textArr) {
+    if (textArr) {
+      this.ref.appendChild(document.createTextNode(textArr.join("")));
     }
     return this;
   }
@@ -496,7 +566,7 @@ var JJNx = class extends JJN {
    * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/append | Element.append}
    */
   addChild(...children) {
-    const nodes = JJN.unwrapAll(children.filter(JJN.isWrapable));
+    const nodes = JJN.unwrapAll(children.filter(JJN.isWrappable));
     this.ref.append(...nodes);
     return this;
   }
@@ -516,7 +586,7 @@ var JJNx = class extends JJN {
    * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/prepend | Element.prepend}
    */
   preChild(...children) {
-    const nodes = JJN.unwrapAll(children.filter(JJN.isWrapable));
+    const nodes = JJN.unwrapAll(children.filter(JJN.isWrappable));
     this.ref.prepend(...nodes);
     return this;
   }
@@ -572,7 +642,7 @@ var JJNx = class extends JJN {
    * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/replaceChildren | Element.replaceChildren}
    */
   setChildren(...children) {
-    const nodes = JJN.unwrapAll(children.filter(JJN.isWrapable));
+    const nodes = JJN.unwrapAll(children.filter(JJN.isWrappable));
     this.ref.replaceChildren(...nodes);
     return this;
   }
@@ -1334,7 +1404,7 @@ var JJHE = class _JJHE extends JJEx {
    * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText | HTMLElement.innerText}
    */
   setText(text) {
-    this.ref.innerText = text ?? "";
+    this.ref.innerText = text;
     return this;
   }
 };
@@ -1406,7 +1476,7 @@ var JJT = class _JJT extends JJN {
    * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent | Node.textContent}
    */
   setText(text) {
-    this.ref.textContent = text ?? null;
+    this.ref.textContent = text;
     return this;
   }
   /**
@@ -1419,14 +1489,12 @@ var JJT = class _JJT extends JJN {
    * console.log(text.getText()) // 'hello world'
    * ```
    *
-   * @param text - The string to add to the existing contents. If null or undefined, nothing is added.
+   * @param textArr - The string to add to the existing contents. If null or undefined, nothing is added.
    * @returns This instance for chaining.
    * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent | Node.textContent}
    */
-  addText(text) {
-    if (text != null) {
-      this.ref.textContent += text;
-    }
+  addText(...textArr) {
+    this.setText(this.getText() + textArr.join(""));
     return this;
   }
   /**
@@ -1585,7 +1653,7 @@ var JJSE = class _JJSE extends JJEx {
    * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent | Node.textContent}
    */
   setText(text) {
-    this.ref.textContent = text ?? "";
+    this.ref.textContent = text;
     return this;
   }
   /**