coralite 0.36.1 → 0.36.3

package/README.md

@@ -43,7 +43,7 @@ npm run start
 
 ---
 
-## 📦 Manual Installation & CLI
+## Manual Installation & CLI
 
 If you are adding Coralite to an existing project or building from scratch manually, install the core package:
 

package/dist/lib/coralite-element.d.ts

@@ -6,13 +6,6 @@
  * @returns {any} The coerced value.
  */
 export function coerce(value: any, type: Function | string): any;
-/**
- * Creates a read-only proxy that throws on mutation attempts.
- * @param {Object} target - The object to proxy.
- * @param {WeakMap} [proxies=new WeakMap()] - Cache for existing proxies.
- * @returns {Proxy} The read-only proxy.
- */
-export function createReadOnlyProxy(target: any, proxies?: WeakMap<any, any>): ProxyConstructor;
 /**
  * Factory function to create a Coralite element class.
  * It dynamically defines the class, including observed attributes and hook initialization.

package/dist/lib/coralite-element.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coralite-element.d.ts","sourceRoot":"","sources":["../../lib/coralite-element.js"],"names":[],"mappings":"AAsCA;;;;;;GAMG;AACH,8BAJW,GAAG,QACH,WAAS,MAAM,GACb,GAAG,CAmBf;AAED;;;;;GAKG;AACH,gGAwBC;AA2kBD;;;;;;;;;;GAUG;AACH,6CARW,wBAAwB,kBACxB,WAAS,IAAI,UAErB;IAAyE,uBAAuB,GAAxF,KAAK,CAAC,iDAAiD,CAAC;IACQ,sBAAsB,GAAtF,KAAK,CAAC,gDAAgD,CAAC;IACC,cAAc,GAAtE,KAAK,CAAC,wCAAwC,CAAC;CACvD,GAAU,OAAO,eAAe,CA8BlC;AA/mBD;;;;;;;;;;GAUG;AAEH;;;;;;GAMG;AACH;IAOI;;;;OAIG;IACH,4BAHU,eAAe,GAAC,IAAI,CAGF;IAE5B;;;;OAIG;IACH,uBAHU,MAAM,GAAC,IAAI,CAGE;IAEvB;;;;OAIG;IACH,kBAHU,MAAO,IAAI,CAGH;IAElB;;;;OAIG;IACH,qBAHU,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,CAG1D;IAEnB;;;;OAIG;IACH,4BAHU,OAAO,CAGY;IAE7B;;;;OAIG;IACH,iCAHU,MAAM,GAAC,IAAI,CAGY;IAEjC;;;OAGG;IACH,qBAHU,gBAAgB,GAAC,IAAI,CAGV;IAErB;;;;OAIG;IACH,gCAHU,WAAS,IAAI,CAGS;IAEhC;;;;OAIG;IACH,mCAHU;YAAQ,MAAM,GAAE,eAAe;KAAC,GAAC,IAAI,CAGZ;IAEnC;;;;;;;;OAQG;IACH,kBAPU;QACL,uBAAuB,EAAE,KAAK,CAAC,iDAAiD,CAAC,CAAC;QAClF,sBAAsB,EAAE,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAChF,cAAc,EAAE,KAAK,CAAC,wCAAwC,CAAC,CAAA;KAChE,CAOH;IAED;;;OAGG;IACH,kBAFU,wBAAwB,GAAC,IAAI,CAEX;IAG9B;;;;OAIG;IACH,0BAsDC;IAED;;;;OAIG;IACH,6BAkBC;IAED;;;;;;;OAOG;IACH,+BAJW,MAAM,UACN,MAAM,GAAC,IAAI,UACX,MAAM,GAAC,IAAI,QAWrB;IAED;;;;;OAKG;IACH,oBA2EC;IAED;;;;;;OAMG;IACH,6BAYC;IAED;;;;;OAKG;IACH,oBAHW,MAAM,EAAE,GACN,IAAI,GAAC,IAAI,CAYrB;IAED;;;;OAIG;IACH,uBAiCC;IAED;;;;OAIG;IACH,wBASC;IAED;;;;;;OAMG;IACH,mBA2GC;IAED;;;;OAIG;IACH,sBA4BC;IAED;;;;;;OAMG;IACH,cA8BC;CACF;;;;;iBApkBa,MAAM;;;;mBACN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uEA9FV,oBAAoB;sEAApB,oBAAoB;8DAApB,oBAAoB"}
+{"version":3,"file":"coralite-element.d.ts","sourceRoot":"","sources":["../../lib/coralite-element.js"],"names":[],"mappings":"AAuCA;;;;;;GAMG;AACH,8BAJW,GAAG,QACH,WAAS,MAAM,GACb,GAAG,CAmBf;AA0kBD;;;;;;;;;;GAUG;AACH,6CARW,wBAAwB,kBACxB,WAAS,IAAI,UAErB;IAAyE,uBAAuB,GAAxF,KAAK,CAAC,iDAAiD,CAAC;IACQ,sBAAsB,GAAtF,KAAK,CAAC,gDAAgD,CAAC;IACC,cAAc,GAAtE,KAAK,CAAC,wCAAwC,CAAC;CACvD,GAAU,OAAO,eAAe,CA8BlC;AA/mBD;;;;;;;;;;GAUG;AAEH;;;;;;GAMG;AACH;IAOI;;;;OAIG;IACH,4BAHU,eAAe,GAAC,IAAI,CAGF;IAE5B;;;;OAIG;IACH,uBAHU,MAAM,GAAC,IAAI,CAGE;IAEvB;;;;OAIG;IACH,kBAHU,MAAO,IAAI,CAGH;IAElB;;;;OAIG;IACH,qBAHU,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,CAG1D;IAEnB;;;;OAIG;IACH,4BAHU,OAAO,CAGY;IAE7B;;;;OAIG;IACH,iCAHU,MAAM,GAAC,IAAI,CAGY;IAEjC;;;OAGG;IACH,qBAHU,gBAAgB,GAAC,IAAI,CAGV;IAErB;;;;OAIG;IACH,gCAHU,WAAS,IAAI,CAGS;IAEhC;;;;OAIG;IACH,mCAHU;YAAQ,MAAM,GAAE,eAAe;KAAC,GAAC,IAAI,CAGZ;IAEnC;;;;;;;;OAQG;IACH,kBAPU;QACL,uBAAuB,EAAE,KAAK,CAAC,iDAAiD,CAAC,CAAC;QAClF,sBAAsB,EAAE,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAChF,cAAc,EAAE,KAAK,CAAC,wCAAwC,CAAC,CAAA;KAChE,CAOH;IAED;;;OAGG;IACH,kBAFU,wBAAwB,GAAC,IAAI,CAEX;IAG9B;;;;OAIG;IACH,0BAsDC;IAED;;;;OAIG;IACH,6BAkBC;IAED;;;;;;;OAOG;IACH,+BAJW,MAAM,UACN,MAAM,GAAC,IAAI,UACX,MAAM,GAAC,IAAI,QAWrB;IAED;;;;;OAKG;IACH,oBA2EC;IAED;;;;;;OAMG;IACH,6BAYC;IAED;;;;;OAKG;IACH,oBAHW,MAAM,EAAE,GACN,IAAI,GAAC,IAAI,CAYrB;IAED;;;;OAIG;IACH,uBAiCC;IAED;;;;OAIG;IACH,wBASC;IAED;;;;;;OAMG;IACH,mBA2GC;IAED;;;;OAIG;IACH,sBA4BC;IAED;;;;;;OAMG;IACH,cA8BC;CACF;;;;;iBApkBa,MAAM;;;;mBACN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uEA/DV,oBAAoB;sEAApB,oBAAoB;8DAApB,oBAAoB"}

package/dist/lib/coralite-element.js

@@ -1,4 +1,509 @@
-const BOOLEAN_ATTRIBUTES = /* @__PURE__ */ new Set([
+// lib/utils.js
+import { parse as parseJS } from "acorn";
+import { simple as walkJS } from "acorn-walk";
+import render from "dom-serializer";
+import { sanitize } from "isomorphic-dompurify";
+
+// lib/parse.js
+import { Parser } from "htmlparser2";
+
+// lib/dom.js
+var ELEMENT_NODE = 1;
+var TEXT_NODE = 3;
+var COMMENT_NODE = 8;
+var DOCUMENT_NODE = 9;
+var DOCUMENT_TYPE_NODE = 10;
+var nodeTypes = {
+  tag: ELEMENT_NODE,
+  script: ELEMENT_NODE,
+  style: ELEMENT_NODE,
+  text: TEXT_NODE,
+  comment: COMMENT_NODE,
+  root: DOCUMENT_NODE,
+  directive: DOCUMENT_TYPE_NODE
+};
+function CoraliteNodeConstructor(node) {
+  for (const key in node) {
+    if (["parent", "prev", "next", "slots"].includes(key)) {
+      Object.defineProperty(this, key, {
+        value: node[key],
+        enumerable: false,
+        writable: true,
+        configurable: true
+      });
+    } else {
+      this[key] = node[key];
+    }
+  }
+}
+function makeCircularPropertiesNonEnumerable(node) {
+  for (const key of ["parent", "prev", "next", "slots"]) {
+    if (Object.hasOwn(node, key)) {
+      const value = node[key];
+      delete node[key];
+      Object.defineProperty(node, key, {
+        value,
+        enumerable: false,
+        writable: true,
+        configurable: true
+      });
+    }
+  }
+}
+Object.defineProperties(CoraliteNodeConstructor.prototype, {
+  nodeType: {
+    /**
+     * Returns an integer identifying the type of the node.
+     * @returns {number}
+     */
+    get() {
+      return nodeTypes[this.type] || ELEMENT_NODE;
+    }
+  },
+  parentNode: {
+    /**
+     * Returns the parent of the specified node in the DOM tree.
+     * @returns {CoraliteAnyNode | CoraliteComponentRoot}
+     */
+    get() {
+      return this.parent;
+    },
+    /**
+     * Sets the parent of the node.
+     * @param {CoraliteAnyNode | CoraliteComponentRoot} value - The parent node to set
+     */
+    set(value) {
+      this.parent = value;
+    }
+  },
+  parentElement: {
+    /**
+     * Returns the DOM node's parent Element, or null if the node either has no parent, or its parent isn't a DOM Element.
+     * @returns {CoraliteAnyNode | CoraliteComponentRoot}
+     */
+    get() {
+      return this.parent;
+    },
+    /**
+     * Sets the parent element of the node.
+     * @param {CoraliteAnyNode | CoraliteComponentRoot} value - The parent element to set
+     */
+    set(value) {
+      this.parent = value;
+    }
+  },
+  previousSibling: {
+    /**
+     * Returns the node immediately preceding the specified one in its parent's childNodes list, or null if the specified node is the first in that list.
+     * @returns {CoraliteAnyNode | null}
+     */
+    get() {
+      if (!this.parent || !this.parent.children) {
+        return null;
+      }
+      const index = this.parent.children.indexOf(this);
+      return index > 0 ? this.parent.children[index - 1] : null;
+    }
+  },
+  nextSibling: {
+    /**
+     * Returns the node immediately following the specified one in its parent's childNodes list, or null if the specified node is the last node in that list.
+     * @returns {CoraliteAnyNode | null}
+     */
+    get() {
+      if (!this.parent || !this.parent.children) {
+        return null;
+      }
+      const index = this.parent.children.indexOf(this);
+      return index > -1 && index < this.parent.children.length - 1 ? this.parent.children[index + 1] : null;
+    }
+  }
+});
+function CoraliteElementConstructor(node) {
+  CoraliteNodeConstructor.call(this, node);
+}
+CoraliteElementConstructor.prototype = Object.create(CoraliteNodeConstructor.prototype);
+CoraliteElementConstructor.prototype.constructor = CoraliteElementConstructor;
+Object.defineProperties(CoraliteElementConstructor.prototype, {
+  nodeName: {
+    /**
+     * Returns the name of the node (uppercase tag name for elements).
+     * @returns {string}
+     */
+    get() {
+      return this.name.toUpperCase();
+    }
+  },
+  tagName: {
+    /**
+     * Returns the tag name of the element (uppercase).
+     * @returns {string}
+     */
+    get() {
+      return this.name.toUpperCase();
+    },
+    /**
+     * Sets the tag name of the element (converted to lowercase).
+     * @param {string} value - The tag name to set
+     */
+    set(value) {
+      this.name = value.toLowerCase();
+    }
+  },
+  nodeValue: {
+    /**
+     * Returns null for elements.
+     * @returns {null}
+     */
+    get() {
+      return null;
+    },
+    /**
+     * Setting nodeValue on an element has no effect.
+     */
+    set(value) {
+    }
+  },
+  attributes: {
+    /**
+     * Returns a collection of the element's attributes.
+     * @returns {Object.<string, string>}
+     */
+    get() {
+      return this.attribs;
+    },
+    /**
+     * Sets the attributes of the element.
+     * @param {Object.<string, string>} value - The attributes object to set
+     */
+    set(value) {
+      this.attribs = value;
+    }
+  },
+  childNodes: {
+    /**
+     * Returns a live collection of child nodes of the given element.
+     * @returns {CoraliteAnyNode[]}
+     */
+    get() {
+      return this.children || [];
+    },
+    /**
+     * Sets the child nodes of the element.
+     * @param {CoraliteAnyNode[]} value - The array of child nodes to set
+     */
+    set(value) {
+      this.children = value;
+    }
+  },
+  firstChild: {
+    /**
+     * Returns the node's first child in the tree, or null if the node has no children.
+     * @returns {CoraliteAnyNode | null}
+     */
+    get() {
+      return this.children && this.children.length > 0 ? this.children[0] : null;
+    }
+  },
+  lastChild: {
+    /**
+     * Returns the last child of the node, or null if there are no child nodes.
+     * @returns {CoraliteAnyNode | null}
+     */
+    get() {
+      return this.children && this.children.length > 0 ? this.children[this.children.length - 1] : null;
+    }
+  },
+  textContent: {
+    /**
+     * Returns the text content of the node and its descendants.
+     * @returns {string}
+     */
+    get() {
+      if (this.children) {
+        return this.children.map((child) => child.textContent).join("");
+      }
+      return "";
+    },
+    /**
+     * Sets the text content of the node. Replaces all children with a single text node.
+     * @param {string} value - The text content to set
+     */
+    set(value) {
+      const textNode = createCoraliteTextNode({
+        type: "text",
+        data: value,
+        parent: this
+      });
+      this.children = [textNode];
+    }
+  },
+  id: {
+    /**
+     * Returns the element's ID attribute.
+     * @returns {string}
+     */
+    get() {
+      return this.attribs ? this.attribs.id : "";
+    },
+    /**
+     * Sets the element's ID attribute.
+     * @param {string} value - The ID to set
+     */
+    set(value) {
+      if (this.attribs) {
+        this.attribs.id = value;
+      }
+    }
+  },
+  className: {
+    /**
+     * Returns the element's class attribute.
+     * @returns {string}
+     */
+    get() {
+      return this.attribs ? this.attribs.class : "";
+    },
+    /**
+     * Sets the element's class attribute.
+     * @param {string} value - The class names to set
+     */
+    set(value) {
+      if (this.attribs) {
+        this.attribs.class = value;
+      }
+    }
+  }
+});
+function CoraliteTextNodeConstructor(node) {
+  CoraliteNodeConstructor.call(this, node);
+}
+CoraliteTextNodeConstructor.prototype = Object.create(CoraliteNodeConstructor.prototype);
+CoraliteTextNodeConstructor.prototype.constructor = CoraliteTextNodeConstructor;
+Object.defineProperties(CoraliteTextNodeConstructor.prototype, {
+  nodeName: {
+    /**
+     * Returns the name of the node (#text).
+     * @returns {string}
+     */
+    get() {
+      return "#text";
+    }
+  },
+  nodeValue: {
+    /**
+     * Returns the text content of the node.
+     * @returns {string}
+     */
+    get() {
+      return this.data;
+    },
+    /**
+     * Sets the text content of the node.
+     * @param {string} value - The text content to set
+     */
+    set(value) {
+      this.data = value;
+    }
+  },
+  textContent: {
+    /**
+     * Returns the text content of the node.
+     * @returns {string}
+     */
+    get() {
+      return this.data;
+    },
+    /**
+     * Sets the text content of the node.
+     * @param {string} value - The text content to set
+     */
+    set(value) {
+      this.data = value;
+    }
+  }
+});
+function createCoraliteTextNode(node) {
+  makeCircularPropertiesNonEnumerable(node);
+  Object.setPrototypeOf(node, CoraliteTextNodeConstructor.prototype);
+  return node;
+}
+function CoraliteCommentConstructor(node) {
+  CoraliteNodeConstructor.call(this, node);
+}
+CoraliteCommentConstructor.prototype = Object.create(CoraliteNodeConstructor.prototype);
+CoraliteCommentConstructor.prototype.constructor = CoraliteCommentConstructor;
+Object.defineProperties(CoraliteCommentConstructor.prototype, {
+  nodeName: {
+    /**
+     * Returns the name of the node (#comment).
+     * @returns {string}
+     */
+    get() {
+      return "#comment";
+    }
+  },
+  nodeValue: {
+    /**
+     * Returns the content of the comment.
+     * @returns {string}
+     */
+    get() {
+      return this.data;
+    },
+    /**
+     * Sets the content of the comment.
+     * @param {string} value - The content to set
+     */
+    set(value) {
+      this.data = value;
+    }
+  },
+  textContent: {
+    /**
+     * Returns the content of the comment.
+     * @returns {string}
+     */
+    get() {
+      return this.data;
+    },
+    /**
+     * Sets the content of the comment.
+     * @param {string} value - The content to set
+     */
+    set(value) {
+      this.data = value;
+    }
+  }
+});
+function CoraliteDirectiveConstructor(node) {
+  CoraliteNodeConstructor.call(this, node);
+}
+CoraliteDirectiveConstructor.prototype = Object.create(CoraliteNodeConstructor.prototype);
+CoraliteDirectiveConstructor.prototype.constructor = CoraliteDirectiveConstructor;
+Object.defineProperties(CoraliteDirectiveConstructor.prototype, {
+  nodeName: {
+    /**
+     * Returns the name of the directive (e.g., !DOCTYPE).
+     * @returns {string}
+     */
+    get() {
+      return this.name;
+    }
+  },
+  nodeValue: {
+    /**
+     * Returns the content of the directive.
+     * @returns {string}
+     */
+    get() {
+      return this.data;
+    },
+    /**
+     * Sets the content of the directive.
+     * @param {string} value - The content to set
+     */
+    set(value) {
+      this.data = value;
+    }
+  }
+});
+function CoraliteComponentConstructor(node) {
+  CoraliteNodeConstructor.call(this, node);
+}
+CoraliteComponentConstructor.prototype = Object.create(CoraliteNodeConstructor.prototype);
+CoraliteComponentConstructor.prototype.constructor = CoraliteComponentConstructor;
+Object.defineProperties(CoraliteComponentConstructor.prototype, {
+  nodeName: {
+    /**
+     * Returns the name of the node (#document).
+     * @returns {string}
+     */
+    get() {
+      return "#document";
+    }
+  },
+  nodeValue: {
+    /**
+     * Returns null for document nodes.
+     * @returns {null}
+     */
+    get() {
+      return null;
+    }
+  },
+  childNodes: {
+    /**
+     * Returns a live collection of child nodes of the document.
+     * @returns {CoraliteAnyNode[]}
+     */
+    get() {
+      return this.children || [];
+    },
+    /**
+     * Sets the child nodes of the document.
+     * @param {CoraliteAnyNode[]} value - The array of child nodes to set
+     */
+    set(value) {
+      this.children = value;
+    }
+  },
+  firstChild: {
+    /**
+     * Returns the document's first child in the tree, or null if the document has no children.
+     * @returns {CoraliteAnyNode | null}
+     */
+    get() {
+      return this.children && this.children.length > 0 ? this.children[0] : null;
+    }
+  },
+  lastChild: {
+    /**
+     * Returns the last child of the document, or null if there are no child nodes.
+     * @returns {CoraliteAnyNode | null}
+     */
+    get() {
+      return this.children && this.children.length > 0 ? this.children[this.children.length - 1] : null;
+    }
+  },
+  textContent: {
+    /**
+     * Returns null for document nodes.
+     * @returns {null}
+     */
+    get() {
+      return null;
+    }
+  }
+});
+
+// lib/utils.js
+function createReadOnlyProxy(target, proxies = /* @__PURE__ */ new WeakMap()) {
+  if (proxies.has(target)) {
+    return proxies.get(target);
+  }
+  const handler = {
+    get(target2, property, receiver) {
+      const value = Reflect.get(target2, property, receiver);
+      if (value !== null && typeof value === "object" && !(typeof Node !== "undefined" && value instanceof Node)) {
+        return createReadOnlyProxy(value, proxies);
+      }
+      return value;
+    },
+    set() {
+      throw new Error("Coralite Error: Cannot mutate state inside a getter. State is read-only here.");
+    },
+    deleteProperty() {
+      throw new Error("Coralite Error: Cannot delete state inside a getter. State is read-only here.");
+    }
+  };
+  const proxy = new Proxy(target, handler);
+  proxies.set(target, proxy);
+  return proxy;
+}
+
+// lib/coralite-element.js
+var BOOLEAN_ATTRIBUTES2 = /* @__PURE__ */ new Set([
   "allowfullscreen",
   "async",
   "autofocus",
@@ -44,30 +549,7 @@ function coerce(value, type) {
   }
   return value;
 }
-function createReadOnlyProxy(target, proxies = /* @__PURE__ */ new WeakMap()) {
-  if (proxies.has(target)) {
-    return proxies.get(target);
-  }
-  const handler = {
-    get(target2, property, receiver) {
-      const value = Reflect.get(target2, property, receiver);
-      if (value !== null && typeof value === "object" && !(typeof Node !== "undefined" && value instanceof Node)) {
-        return createReadOnlyProxy(value, proxies);
-      }
-      return value;
-    },
-    set() {
-      throw new Error("Coralite Error: Cannot mutate state inside a getter. State is read-only here.");
-    },
-    deleteProperty() {
-      throw new Error("Coralite Error: Cannot delete state inside a getter. State is read-only here.");
-    }
-  };
-  const proxy = new Proxy(target, handler);
-  proxies.set(target, proxy);
-  return proxy;
-}
-class CoraliteElement extends HTMLElement {
+var CoraliteElement = class extends HTMLElement {
   /**
    * Initializes a new instance of the CoraliteElement.
    * Sets up internal state trackers, binding collections, and hook registries.
@@ -375,7 +857,7 @@ class CoraliteElement extends HTMLElement {
           }
         } else if (binding.type === "attribute") {
           const element = binding.node;
-          if (BOOLEAN_ATTRIBUTES.has(binding.name)) {
+          if (BOOLEAN_ATTRIBUTES2.has(binding.name)) {
             const isFalsy = hydratedValue === "" || hydratedValue === "false" || hydratedValue === "null" || hydratedValue === "0" || hydratedValue === "undefined";
             if (isFalsy) {
               element.removeAttribute(binding.name);
@@ -476,7 +958,7 @@ class CoraliteElement extends HTMLElement {
       }
     }
   }
-}
+};
 function createCoraliteClass(options, contextGetter = null, hooks = {}) {
   return class extends CoraliteElement {
     /**
@@ -509,7 +991,6 @@ function createCoraliteClass(options, contextGetter = null, hooks = {}) {
 export {
   CoraliteElement,
   coerce,
-  createCoraliteClass,
-  createReadOnlyProxy
+  createCoraliteClass
 };
 //# sourceMappingURL=coralite-element.js.map