jj 2.6.0 → 2.8.0

package/README.md

@@ -17,7 +17,6 @@ JJHE.create('div')
     .addClass('card')
     .setText('Hello World!')
     .on('click', () => console.log('Hi'))
-    .appendToBody()
 ```
 
 ## 🚀 Why JJ?

package/SKILL.md

@@ -1,10 +1,6 @@
 ---
-name: jj-dom-helpers
-description: >
-    Minimal, imperative TypeScript DOM library for AI-assisted development. Use when
-    working with DOM manipulation, custom elements, or building lightweight web
-    components without frameworks. Triggers on tasks involving direct DOM manipulation,
-    Shadow DOM, document fragments, template handling, or converting from React/Vue/jQuery.
+name: jj
+description: Minimal, imperative TypeScript DOM library for AI-assisted development. Use when working with DOM manipulation, custom elements, or building lightweight web components without frameworks. Triggers on tasks involving direct DOM manipulation, Shadow DOM, document fragments, template handling, or converting from React/Vue/jQuery.
 license: MIT
 metadata:
     author: alexewerlof

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;
   }
   /**