jj 2.3.0 → 2.4.0

package/lib/JJN.d.ts

@@ -23,6 +23,16 @@ export declare class JJN<T extends Node = Node> implements IAppendPrepend {
      * @returns A new JJN instance.
      */
     static from(node: Node): JJN;
+    /**
+     * 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: unknown): x is Wrappable;
     /**
      * Wraps a native DOM node or string into the most specific JJ wrapper available.
      *
@@ -104,6 +114,9 @@ export declare class JJN<T extends Node = Node> implements IAppendPrepend {
     /**
      * 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}
@@ -118,6 +131,9 @@ export declare class JJN<T extends Node = Node> implements IAppendPrepend {
      * 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.
@@ -126,6 +142,9 @@ export declare class JJN<T extends Node = Node> implements IAppendPrepend {
     /**
      * 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}
@@ -139,6 +158,9 @@ export declare class JJN<T extends Node = Node> implements IAppendPrepend {
      * 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.
@@ -149,12 +171,13 @@ export declare class JJN<T extends Node = Node> implements IAppendPrepend {
      *
      * @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}
      */
-    replaceChildren(...children: Wrappable[]): this;
+    setChildren(...children: Wrappable[]): this;
     /**
      * Adds an event listener.
      *
@@ -198,7 +221,7 @@ export declare class JJN<T extends Node = Node> implements IAppendPrepend {
      * })
      * ```
      * @remarks
-     * If you want to access the current JJ* instance, you SHOULD use a `function` not an arrow function.
+     * 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.

package/lib/JJN.js

@@ -10,7 +10,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _JJN_ref;
-import { isA } from 'jty';
+import { isA, isObj, isStr } from 'jty';
 import { off, on } from './util.js';
 /**
  * Wraps a DOM Node.
@@ -36,6 +36,18 @@ export class JJN {
     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.
      *
@@ -73,7 +85,19 @@ export class JJN {
      * @throws {TypeError} If the input cannot be unwrapped.
      */
     static unwrap(obj) {
-        throw new ReferenceError(`The mixin is supposed to override this method.`);
+        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).
@@ -135,13 +159,16 @@ export class JJN {
     /**
      * 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);
+        const nodes = JJN.unwrapAll(children.filter(JJN.isWrapable));
         const ref = this.ref;
         for (const node of nodes) {
             if (node) {
@@ -158,6 +185,9 @@ export class JJN {
      * 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.
@@ -168,12 +198,15 @@ export class JJN {
     /**
      * 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);
+        const nodes = JJN.unwrapAll(children.filter(JJN.isWrapable));
         const ref = this.ref;
         const first = ref.firstChild;
         for (const node of nodes) {
@@ -191,6 +224,9 @@ export class JJN {
      * 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.
@@ -203,13 +239,14 @@ export class JJN {
      *
      * @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}
      */
-    replaceChildren(...children) {
-        return this.empty().append(...children);
+    setChildren(...children) {
+        return this.empty().append(...children.filter(JJN.isWrapable));
     }
     /**
      * Adds an event listener.
@@ -269,7 +306,7 @@ export class JJN {
      * })
      * ```
      * @remarks
-     * If you want to access the current JJ* instance, you SHOULD use a `function` not an arrow function.
+     * 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.

package/lib/JJN.js.map

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

package/lib/bundle.js

@@ -148,6 +148,18 @@ var JJN = class _JJN {
   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.
    *
@@ -185,7 +197,19 @@ var JJN = class _JJN {
    * @throws {TypeError} If the input cannot be unwrapped.
    */
   static unwrap(obj) {
-    throw new ReferenceError(`The mixin is supposed to override this method.`);
+    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).
@@ -247,13 +271,16 @@ var JJN = class _JJN {
   /**
    * 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);
+    const nodes = _JJN.unwrapAll(children.filter(_JJN.isWrapable));
     const ref = this.ref;
     for (const node of nodes) {
       if (node) {
@@ -270,6 +297,9 @@ var JJN = class _JJN {
    * 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.
@@ -280,12 +310,15 @@ var JJN = class _JJN {
   /**
    * 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);
+    const nodes = _JJN.unwrapAll(children.filter(_JJN.isWrapable));
     const ref = this.ref;
     const first = ref.firstChild;
     for (const node of nodes) {
@@ -303,6 +336,9 @@ var JJN = class _JJN {
    * 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.
@@ -315,13 +351,14 @@ var JJN = class _JJN {
    *
    * @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}
    */
-  replaceChildren(...children) {
-    return this.empty().append(...children);
+  setChildren(...children) {
+    return this.empty().append(...children.filter(_JJN.isWrapable));
   }
   /**
    * Adds an event listener.
@@ -381,7 +418,7 @@ var JJN = class _JJN {
    * })
    * ```
    * @remarks
-   * If you want to access the current JJ* instance, you SHOULD use a `function` not an arrow function.
+   * 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.
@@ -1418,7 +1455,7 @@ var JJD = class _JJD extends JJN {
 };
 
 // src/mixins.ts
-var { wrapAll, unwrapAll } = JJN;
+var { wrapAll, unwrap, unwrapAll, isWrapable } = JJN;
 function wrap(raw) {
   if (isStr(raw)) {
     return JJT.from(document.createTextNode(raw));
@@ -1455,21 +1492,6 @@ function wrap(raw) {
   }
   throw new TypeError(`Expected a Node to wrap. Got ${raw} (${typeof raw})`);
 }
-function 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})`);
-}
 function byId(id, throwIfNotFound = true) {
   const el = document.getElementById(id);
   if (el) {
@@ -1577,6 +1599,9 @@ var EDDF = {
    * myDiv.append(h('span', null, 'hello'))
    * ```
    *
+   * @remarks
+   * To make template codes easier, this function ignores any child that is not possible to `wrap()` (e.g. undefined, null, false).
+   *
    * @param this - The JJE, JJD or JJDF instance.
    * @param children - The children to append.
    * @returns This instance for chaining.
@@ -1585,7 +1610,7 @@ var EDDF = {
    * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DocumentFragment/append | DocumentFragment.append}
    */
   append(...children) {
-    const nodes = unwrapAll(children);
+    const nodes = unwrapAll(children.filter(isWrapable));
     this.ref.append(...nodes);
     return this;
   },
@@ -1597,6 +1622,9 @@ var EDDF = {
    * div.prepend(h('span', null, 'first'))
    * ```
    *
+   * @remarks
+   * To make template codes easier, this function ignores any child that is not possible to `wrap()` (e.g. undefined, null, false).
+   *
    * @param this - The JJE, JJD or JJDF instance.
    * @param children - The children to prepend.
    * @returns This instance for chaining.
@@ -1605,7 +1633,7 @@ var EDDF = {
    * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DocumentFragment/prepend | DocumentFragment.prepend}
    */
   prepend(...children) {
-    const nodes = unwrapAll(children);
+    const nodes = unwrapAll(children.filter(isWrapable));
     this.ref.prepend(...nodes);
     return this;
   },
@@ -1617,9 +1645,12 @@ var EDDF = {
    *
    * @example
    * ```ts
-   * div.replaceChildren(h('p', null, 'New Content'))
+   * div.setChildren(h('p', null, 'New Content'))
    * ```
    *
+   * @remarks
+   * To make template codes easier, this function ignores any child that is not possible to `wrap()` (e.g. undefined, null, false).
+   *
    * @param this - The JJE, JJD or JJDF instance.
    * @param children - The children to replace with.
    * @returns This instance for chaining.
@@ -1627,8 +1658,8 @@ var EDDF = {
    * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/replaceChildren | Document.replaceChildren}
    * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DocumentFragment/replaceChildren | DocumentFragment.replaceChildren}
    */
-  replaceChildren(...children) {
-    const nodes = unwrapAll(children);
+  setChildren(...children) {
+    const nodes = unwrapAll(children.filter(isWrapable));
     this.ref.replaceChildren(...nodes);
     return this;
   },
@@ -1641,10 +1672,10 @@ var EDDF = {
    * ```
    *
    * @returns This instance for chaining.
-   * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/replaceChildren | Element.replaceChildren}
+   * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/replaceChildren | Element.setChildren}
    */
   empty() {
-    this.replaceChildren();
+    this.setChildren();
     return this;
   }
 };
@@ -1676,7 +1707,6 @@ function assignPrototype(Class, ...mixins) {
   }
 }
 JJN.wrap = wrap;
-JJN.unwrap = unwrap;
 assignPrototype(JJE, EDDF);
 assignPrototype(JJD, DDF, EDDF);
 assignPrototype(JJDF, DDF, EDDF);
@@ -1914,6 +1944,7 @@ export {
   fetchText,
   fileExt,
   h,
+  isWrapable,
   keb2cam,
   keb2pas,
   nextAnimationFrame,