jj 2.8.0 → 2.9.0

package/lib/bundle.d.cts

@@ -319,6 +319,39 @@ declare class JJN<T extends Node = Node> extends JJET<T> {
      * @throws {TypeError} If `ref` is not a Node.
      */
     constructor(ref: T);
+    /**
+     * 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(): Wrapped | 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(): Wrapped[];
     /**
      * Clones the Node.
      *
@@ -327,6 +360,23 @@ declare class JJN<T extends Node = Node> extends JJET<T> {
      * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Node/cloneNode | Node.cloneNode}
      */
     clone(deep?: boolean): Wrapped;
+    /**
+     * 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(): this;
     /**
      * Creates a Text node from a string and appends it to this Node.
      *

package/lib/bundle.d.ts

@@ -319,6 +319,39 @@ declare class JJN<T extends Node = Node> extends JJET<T> {
      * @throws {TypeError} If `ref` is not a Node.
      */
     constructor(ref: T);
+    /**
+     * 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(): Wrapped | 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(): Wrapped[];
     /**
      * Clones the Node.
      *
@@ -327,6 +360,23 @@ declare class JJN<T extends Node = Node> extends JJET<T> {
      * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Node/cloneNode | Node.cloneNode}
      */
     clone(deep?: boolean): Wrapped;
+    /**
+     * 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(): this;
     /**
      * Creates a Text node from a string and appends it to this Node.
      *

package/lib/bundle.global.js

@@ -414,6 +414,44 @@
       }
       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.
      *
@@ -424,6 +462,29 @@
     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.
      *