jj 2.7.2 → 2.8.0

package/lib/bundle.cjs

@@ -354,9 +354,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);
   }
   /**
@@ -365,6 +365,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
@@ -377,7 +378,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.
@@ -480,9 +489,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;
   }
@@ -547,7 +556,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;
   }
@@ -567,7 +576,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;
   }
@@ -623,7 +632,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;
   }
@@ -1385,7 +1394,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;
   }
 };
@@ -1457,7 +1466,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;
   }
   /**
@@ -1470,14 +1479,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;
   }
   /**
@@ -1636,7 +1643,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;
   }
   /**