@medyll/idae-be 1.11.0 → 1.12.0

package/dist/be.d.ts

@@ -52,6 +52,7 @@ export declare class Be {
     clear: DomHandler['clear'];
     normalize: DomHandler['normalize'];
     wrap: DomHandler['wrap'];
+    unwrap: DomHandler['unwrap'];
     text: (actions: TextHandlerHandle) => Be;
     private textHandler;
     appendText: TextHandler['append'];

package/dist/be.js

@@ -57,6 +57,7 @@ export class Be {
     clear;
     normalize;
     wrap;
+    unwrap;
     // text
     text;
     textHandler;

package/dist/modules/dom.d.ts

@@ -13,7 +13,8 @@ declare enum domMethods {
     wrap = "wrap",
     normalize = "normalize",
     replace = "replace",
-    clear = "clear"
+    clear = "clear",
+    unwrap = "unwrap"
 }
 type Content = string | HTMLElement | Be;
 export interface DomHandlerHandle {
@@ -203,6 +204,16 @@ export declare class DomHandler implements DomHandlerInterface, CommonHandler<Do
      * beInstance.wrap('section'); // Wraps the div with a <section> element
      */
     wrap(tag?: string, callback?: HandlerCallBackFn): Be;
+    /**
+     * Removes the parent element of the selected element(s), keeping the selected element(s) in the DOM.
+     * @param callback - Optional callback function to execute after unwrapping.
+     * @returns The Be instance for method chaining.
+     * @example
+     * // HTML: <div id="wrapper"><span id="child">Content</span></div>
+     * const beInstance = be('#child');
+     * beInstance.unwrap(); // Removes the <div id="wrapper">, keeping <span id="child">
+     */
+    unwrap(callback?: HandlerCallBackFn): Be;
     private adjacentElement;
     private normalizeContent;
     private insertContent;

package/dist/modules/dom.js

@@ -14,6 +14,7 @@ var domMethods;
     domMethods["normalize"] = "normalize";
     domMethods["replace"] = "replace";
     domMethods["clear"] = "clear";
+    domMethods["unwrap"] = "unwrap";
 })(domMethods || (domMethods = {}));
 /**
  * Handles DOM manipulation operations for Be elements.
@@ -63,6 +64,9 @@ export class DomHandler {
                 case 'wrap':
                     this.wrap(props.tag, props.callback);
                     break;
+                case 'unwrap':
+                    this.unwrap(props.callback);
+                    break;
             }
         });
         return this.beElement;
@@ -350,6 +354,34 @@ export class DomHandler {
         });
         return this.beElement;
     }
+    /**
+     * Removes the parent element of the selected element(s), keeping the selected element(s) in the DOM.
+     * @param callback - Optional callback function to execute after unwrapping.
+     * @returns The Be instance for method chaining.
+     * @example
+     * // HTML: <div id="wrapper"><span id="child">Content</span></div>
+     * const beInstance = be('#child');
+     * beInstance.unwrap(); // Removes the <div id="wrapper">, keeping <span id="child">
+     */
+    unwrap(callback) {
+        this.beElement.eachNode((el) => {
+            const parent = el.parentElement;
+            if (parent) {
+                // Move the element itself before the parent
+                while (el.firstChild) {
+                    parent.insertBefore(el.firstChild, el);
+                }
+                // Remove the parent after moving its children
+                parent.replaceWith(...Array.from(parent.childNodes));
+            }
+            callback?.({
+                fragment: undefined,
+                be: be(el),
+                root: this.beElement
+            });
+        });
+        return this.beElement;
+    }
     adjacentElement(element, content, mode) {
         const normalizedContent = this.normalizeContent(content);
         if (typeof content === 'string') {

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@medyll/idae-be",
 	"scope": "@medyll",
-	"version": "1.11.0",
+	"version": "1.12.0",
 	"description": "A modern, lightweight, and extensible DOM manipulation library built with TypeScript. Designed for precise element targeting and manipulation using a callback-based approach. Features include advanced DOM traversal, event handling, style management, attribute control, HTTP content loading, timers, and more. Ideal for developers seeking a modular and consistent API for dynamic web applications.",
 	"keywords": [
 		"DOM",