eleva 1.1.0-alpha → 1.2.0-alpha
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +32 -20
- package/dist/eleva.d.ts +42 -81
- package/dist/eleva.esm.js +52 -13
- package/dist/eleva.esm.js.map +1 -1
- package/dist/eleva.min.js +1 -1
- package/dist/eleva.min.js.map +1 -1
- package/dist/eleva.umd.js +52 -13
- package/dist/eleva.umd.js.map +1 -1
- package/package.json +2 -1
- package/src/core/Eleva.js +47 -12
- package/src/modules/Emitter.js +1 -1
- package/src/modules/Signal.js +2 -0
- package/types/core/Eleva.d.ts +42 -19
- package/types/core/Eleva.d.ts.map +1 -1
- package/types/modules/Emitter.d.ts +1 -1
- package/types/modules/Emitter.d.ts.map +1 -1
- package/types/modules/Signal.d.ts +4 -2
- package/types/modules/Signal.d.ts.map +1 -1
package/dist/eleva.min.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):(e="undefined"!=typeof globalThis?globalThis:e||self).Eleva=t()}(this,(function(){"use strict";class e{static parse(e,t){return e.replace(/\{\{\s*(.*?)\s*\}\}/g,((e,n)=>{const o=this.evaluate(n,t);return void 0===o?"":o}))}static evaluate(e,t){try{const n=Object.keys(t),o=Object.values(t),s=new Function(...n,`return ${e}`)(...o);return void 0===s?"":s}catch(n){return console.error("Template evaluation error:",{expression:e,data:t,error:n.message}),""}}}class t{constructor(e){this._value=e,this._watchers=new Set}get value(){return this._value}set value(e){e!==this._value&&(this._value=e,this._watchers.forEach((t=>t(e))))}watch(e){return this._watchers.add(e),()=>this._watchers.delete(e)}}class n{constructor(){this.events={}}on(e,t){(this.events[e]||(this.events[e]=[])).push(t)}off(e,t){this.events[e]&&(this.events[e]=this.events[e].filter((e=>e!==t)))}emit(e,...t){(this.events[e]||[]).forEach((e=>e(...t)))}}class o{patchDOM(e,t){const n=document.createElement("div");n.innerHTML=t,this.diff(e,n)}diff(e,t){const n=Array.from(e.childNodes),o=Array.from(t.childNodes),s=Math.max(n.length,o.length);for(let t=0;t<s;t++){const s=n[t],r=o[t];if(s||!r)if(!s||r){if(s.nodeType===Node.ELEMENT_NODE&&r.nodeType===Node.ELEMENT_NODE){const t=s.getAttribute("key"),n=r.getAttribute("key");if((t||n)&&t!==n){e.replaceChild(r.cloneNode(!0),s);continue}}s.nodeType===r.nodeType&&s.nodeName===r.nodeName?s.nodeType!==Node.TEXT_NODE?s.nodeType===Node.ELEMENT_NODE&&(this.updateAttributes(s,r),this.diff(s,r)):s.nodeValue!==r.nodeValue&&(s.nodeValue=r.nodeValue):e.replaceChild(r.cloneNode(!0),s)}else e.removeChild(s);else e.appendChild(r.cloneNode(!0))}}updateAttributes(e,t){const n={value:"value",checked:"checked",selected:"selected",disabled:"disabled"};Array.from(e.attributes).forEach((n=>{n.name.startsWith("@")||t.hasAttribute(n.name)||e.removeAttribute(n.name)})),Array.from(t.attributes).forEach((t=>{t.name.startsWith("@")||e.getAttribute(t.name)!==t.value&&(e.setAttribute(t.name,t.value),n[t.name]?e[n[t.name]]=t.value:t.name in e&&(e[t.name]=t.value))}))}}return class{constructor(e,t={}){this.name=e,this.config=t,this._components={},this._plugins=[],this._lifecycleHooks=["onBeforeMount","onMount","onBeforeUpdate","onUpdate","onUnmount"],this._isMounted=!1,this.emitter=new n,this.renderer=new o}use(e,t={}){return"function"==typeof e.install&&e.install(this,t),this._plugins.push(e),this}component(e,t){return this._components[e]=t,this}mount(n,o,s={}){if(!n)throw new Error(`Container not found: ${n}`);let r;if("string"==typeof o){if(r=this._components[o],!r)throw new Error(`Component "${o}" not registered.`)}else{if("object"!=typeof o)throw new Error("Invalid component parameter.");r=o}const{setup:i,template:a,style:c,children:l}=r,u={props:s,
|
|
1
|
+
!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):(e="undefined"!=typeof globalThis?globalThis:e||self).Eleva=t()}(this,(function(){"use strict";class e{static parse(e,t){return e.replace(/\{\{\s*(.*?)\s*\}\}/g,((e,n)=>{const o=this.evaluate(n,t);return void 0===o?"":o}))}static evaluate(e,t){try{const n=Object.keys(t),o=Object.values(t),s=new Function(...n,`return ${e}`)(...o);return void 0===s?"":s}catch(n){return console.error("Template evaluation error:",{expression:e,data:t,error:n.message}),""}}}class t{constructor(e){this._value=e,this._watchers=new Set}get value(){return this._value}set value(e){e!==this._value&&(this._value=e,this._watchers.forEach((t=>t(e))))}watch(e){return this._watchers.add(e),()=>this._watchers.delete(e)}}class n{constructor(){this.events={}}on(e,t){(this.events[e]||(this.events[e]=[])).push(t)}off(e,t){this.events[e]&&(this.events[e]=this.events[e].filter((e=>e!==t)))}emit(e,...t){(this.events[e]||[]).forEach((e=>e(...t)))}}class o{patchDOM(e,t){const n=document.createElement("div");n.innerHTML=t,this.diff(e,n)}diff(e,t){const n=Array.from(e.childNodes),o=Array.from(t.childNodes),s=Math.max(n.length,o.length);for(let t=0;t<s;t++){const s=n[t],r=o[t];if(s||!r)if(!s||r){if(s.nodeType===Node.ELEMENT_NODE&&r.nodeType===Node.ELEMENT_NODE){const t=s.getAttribute("key"),n=r.getAttribute("key");if((t||n)&&t!==n){e.replaceChild(r.cloneNode(!0),s);continue}}s.nodeType===r.nodeType&&s.nodeName===r.nodeName?s.nodeType!==Node.TEXT_NODE?s.nodeType===Node.ELEMENT_NODE&&(this.updateAttributes(s,r),this.diff(s,r)):s.nodeValue!==r.nodeValue&&(s.nodeValue=r.nodeValue):e.replaceChild(r.cloneNode(!0),s)}else e.removeChild(s);else e.appendChild(r.cloneNode(!0))}}updateAttributes(e,t){const n={value:"value",checked:"checked",selected:"selected",disabled:"disabled"};Array.from(e.attributes).forEach((n=>{n.name.startsWith("@")||t.hasAttribute(n.name)||e.removeAttribute(n.name)})),Array.from(t.attributes).forEach((t=>{t.name.startsWith("@")||e.getAttribute(t.name)!==t.value&&(e.setAttribute(t.name,t.value),n[t.name]?e[n[t.name]]=t.value:t.name in e&&(e[t.name]=t.value))}))}}return class{constructor(e,t={}){this.name=e,this.config=t,this._components={},this._plugins=[],this._lifecycleHooks=["onBeforeMount","onMount","onBeforeUpdate","onUpdate","onUnmount"],this._isMounted=!1,this.emitter=new n,this.renderer=new o}use(e,t={}){return"function"==typeof e.install&&e.install(this,t),this._plugins.push(e),this}component(e,t){return this._components[e]=t,this}mount(n,o,s={}){if(!n)throw new Error(`Container not found: ${n}`);let r;if("string"==typeof o){if(r=this._components[o],!r)throw new Error(`Component "${o}" not registered.`)}else{if("object"!=typeof o)throw new Error("Invalid component parameter.");r=o}const{setup:i,template:a,style:c,children:l}=r,u={props:s,emitter:this.emitter,signal:e=>new t(e),...this._prepareLifecycleHooks()},h=s=>{const r={...u,...s},i=[],h=[];this._isMounted?r.onBeforeUpdate&&r.onBeforeUpdate():r.onBeforeMount&&r.onBeforeMount();const d=()=>{const t=e.parse(a(r),r);this.renderer.patchDOM(n,t),this._processEvents(n,r),this._injectStyles(n,o,c,r),this._mountChildren(n,l,h),this._isMounted?r.onUpdate&&r.onUpdate():(r.onMount&&r.onMount(),this._isMounted=!0)};return Object.values(s).forEach((e=>{e instanceof t&&i.push(e.watch(d))})),d(),{container:n,data:r,unmount:()=>{i.forEach((e=>e())),h.forEach((e=>e.unmount())),r.onUnmount&&r.onUnmount(),n.innerHTML=""}}};return Promise.resolve("function"==typeof i?i(u):{}).then((e=>h(e)))}_prepareLifecycleHooks(){return this._lifecycleHooks.reduce(((e,t)=>(e[t]=()=>{},e)),{})}_processEvents(t,n){t.querySelectorAll("*").forEach((t=>{[...t.attributes].forEach((({name:o,value:s})=>{if(o.startsWith("@")){const r=o.slice(1),i=e.evaluate(s,n);"function"==typeof i&&(t.addEventListener(r,i),t.removeAttribute(o))}}))}))}_injectStyles(t,n,o,s){if(o){let r=t.querySelector(`style[data-eleva-style="${n}"]`);r||(r=document.createElement("style"),r.setAttribute("data-eleva-style",n),t.appendChild(r)),r.textContent=e.parse(o(s),s)}}_mountChildren(e,t,n){n.forEach((e=>e.unmount())),n.length=0,Object.keys(t||{}).forEach((o=>{e.querySelectorAll(o).forEach((e=>{const s={};[...e.attributes].forEach((({name:e,value:t})=>{e.startsWith("eleva-prop-")&&(s[e.slice(11)]=t)}));const r=this.mount(e,t[o],s);n.push(r)}))}))}}}));
|
|
2
2
|
//# sourceMappingURL=eleva.min.js.map
|
package/dist/eleva.min.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"eleva.min.js","sources":["../src/modules/TemplateEngine.js","../src/modules/Signal.js","../src/modules/Emitter.js","../src/modules/Renderer.js","../src/core/Eleva.js"],"sourcesContent":["\"use strict\";\n\n/**\n * @class 🔒 TemplateEngine\n * @classdesc Secure interpolation & dynamic attribute parsing.\n * Provides methods to parse template strings by replacing interpolation expressions\n * with dynamic data values and to evaluate expressions within a given data context.\n */\nexport class TemplateEngine {\n /**\n * Parses a template string and replaces interpolation expressions with corresponding values.\n *\n * @param {string} template - The template string containing expressions in the format `{{ expression }}`.\n * @param {Object<string, any>} data - The data object to use for evaluating expressions.\n * @returns {string} The resulting string with evaluated values.\n */\n static parse(template, data) {\n return template.replace(/\\{\\{\\s*(.*?)\\s*\\}\\}/g, (_, expr) => {\n const value = this.evaluate(expr, data);\n return value === undefined ? \"\" : value;\n });\n }\n\n /**\n * Evaluates a JavaScript expression using the provided data context.\n *\n * @param {string} expr - The JavaScript expression to evaluate.\n * @param {Object<string, any>} data - The data context for evaluating the expression.\n * @returns {any} The result of the evaluated expression, or an empty string if undefined or on error.\n */\n static evaluate(expr, data) {\n try {\n const keys = Object.keys(data);\n const values = Object.values(data);\n const result = new Function(...keys, `return ${expr}`)(...values);\n return result === undefined ? \"\" : result;\n } catch (error) {\n console.error(`Template evaluation error:`, {\n expression: expr,\n data,\n error: error.message,\n });\n return \"\";\n }\n }\n}\n","\"use strict\";\n\n/**\n * @class ⚡ Signal\n * @classdesc Fine-grained reactivity.\n * A reactive data holder that notifies registered watchers when its value changes,\n * enabling fine-grained DOM patching rather than full re-renders.\n */\nexport class Signal {\n /**\n * Creates a new Signal instance.\n *\n * @param {*} value - The initial value of the signal.\n */\n constructor(value) {\n this._value = value;\n this._watchers = new Set();\n }\n\n /**\n * Gets the current value of the signal.\n *\n * @returns {*} The current value.\n */\n get value() {\n return this._value;\n }\n\n /**\n * Sets a new value for the signal and notifies all registered watchers if the value has changed.\n *\n * @param {*} newVal - The new value to set.\n */\n set value(newVal) {\n if (newVal !== this._value) {\n this._value = newVal;\n this._watchers.forEach((fn) => fn(newVal));\n }\n }\n\n /**\n * Registers a watcher function that will be called whenever the signal's value changes.\n *\n * @param {function(any): void} fn - The callback function to invoke on value change.\n * @returns {function(): boolean} A function to unsubscribe the watcher.\n */\n watch(fn) {\n this._watchers.add(fn);\n return () => this._watchers.delete(fn);\n }\n}\n","\"use strict\";\n\n/**\n * @class 🎙️ Emitter\n * @classdesc Robust inter-component communication with event bubbling.\n * Implements a basic publish-subscribe pattern for event handling, allowing components\n * to communicate through custom events.\n */\nexport class Emitter {\n /**\n * Creates a new Emitter instance.\n */\n constructor() {\n /** @type {Object.<string, Function[]>} */\n this.events = {};\n }\n\n /**\n * Registers an event handler for the specified event.\n *\n * @param {string} event - The name of the event.\n * @param {function(...any): void} handler - The function to call when the event is emitted.\n */\n on(event, handler) {\n (this.events[event] || (this.events[event] = [])).push(handler);\n }\n\n /**\n * Removes a previously registered event handler.\n *\n * @param {string} event - The name of the event.\n * @param {function(...any): void} handler - The handler function to remove.\n */\n off(event, handler) {\n if (this.events[event]) {\n this.events[event] = this.events[event].filter((h) => h !== handler);\n }\n }\n\n /**\n * Emits an event, invoking all handlers registered for that event.\n *\n * @param {string} event - The event name.\n * @param {...any} args - Additional arguments to pass to the event handlers.\n */\n emit(event, ...args) {\n (this.events[event] || []).forEach((handler) => handler(...args));\n }\n}\n","\"use strict\";\n\n/**\n * @class 🎨 Renderer\n * @classdesc Handles DOM patching, diffing, and attribute updates.\n * Provides methods for efficient DOM updates by diffing the new and old DOM structures\n * and applying only the necessary changes.\n */\nexport class Renderer {\n /**\n * Patches the DOM of a container element with new HTML content.\n *\n * @param {HTMLElement} container - The container element to patch.\n * @param {string} newHtml - The new HTML content to apply.\n */\n patchDOM(container, newHtml) {\n const tempContainer = document.createElement(\"div\");\n tempContainer.innerHTML = newHtml;\n this.diff(container, tempContainer);\n }\n\n /**\n * Diffs two DOM trees (old and new) and applies updates to the old DOM.\n *\n * @param {HTMLElement} oldParent - The original DOM element.\n * @param {HTMLElement} newParent - The new DOM element.\n */\n diff(oldParent, newParent) {\n const oldNodes = Array.from(oldParent.childNodes);\n const newNodes = Array.from(newParent.childNodes);\n const max = Math.max(oldNodes.length, newNodes.length);\n for (let i = 0; i < max; i++) {\n const oldNode = oldNodes[i];\n const newNode = newNodes[i];\n\n // Case 1: Append new nodes that don't exist in the old tree.\n if (!oldNode && newNode) {\n oldParent.appendChild(newNode.cloneNode(true));\n continue;\n }\n // Case 2: Remove old nodes not present in the new tree.\n if (oldNode && !newNode) {\n oldParent.removeChild(oldNode);\n continue;\n }\n\n // Case 3: For element nodes, compare keys if available.\n if (\n oldNode.nodeType === Node.ELEMENT_NODE &&\n newNode.nodeType === Node.ELEMENT_NODE\n ) {\n const oldKey = oldNode.getAttribute(\"key\");\n const newKey = newNode.getAttribute(\"key\");\n if (oldKey || newKey) {\n if (oldKey !== newKey) {\n oldParent.replaceChild(newNode.cloneNode(true), oldNode);\n continue;\n }\n }\n }\n\n // Case 4: Replace nodes if types or tag names differ.\n if (\n oldNode.nodeType !== newNode.nodeType ||\n oldNode.nodeName !== newNode.nodeName\n ) {\n oldParent.replaceChild(newNode.cloneNode(true), oldNode);\n continue;\n }\n // Case 5: For text nodes, update content if different.\n if (oldNode.nodeType === Node.TEXT_NODE) {\n if (oldNode.nodeValue !== newNode.nodeValue) {\n oldNode.nodeValue = newNode.nodeValue;\n }\n continue;\n }\n // Case 6: For element nodes, update attributes and then diff children.\n if (oldNode.nodeType === Node.ELEMENT_NODE) {\n this.updateAttributes(oldNode, newNode);\n this.diff(oldNode, newNode);\n }\n }\n }\n\n /**\n * Updates the attributes of an element to match those of a new element.\n *\n * @param {HTMLElement} oldEl - The element to update.\n * @param {HTMLElement} newEl - The element providing the updated attributes.\n */\n updateAttributes(oldEl, newEl) {\n const attributeToPropertyMap = {\n value: \"value\",\n checked: \"checked\",\n selected: \"selected\",\n disabled: \"disabled\",\n };\n\n // Remove old attributes that no longer exist.\n Array.from(oldEl.attributes).forEach((attr) => {\n if (attr.name.startsWith(\"@\")) return;\n if (!newEl.hasAttribute(attr.name)) {\n oldEl.removeAttribute(attr.name);\n }\n });\n // Add or update attributes from newEl.\n Array.from(newEl.attributes).forEach((attr) => {\n if (attr.name.startsWith(\"@\")) return;\n if (oldEl.getAttribute(attr.name) !== attr.value) {\n oldEl.setAttribute(attr.name, attr.value);\n if (attributeToPropertyMap[attr.name]) {\n oldEl[attributeToPropertyMap[attr.name]] = attr.value;\n } else if (attr.name in oldEl) {\n oldEl[attr.name] = attr.value;\n }\n }\n });\n }\n}\n","\"use strict\";\n\nimport { TemplateEngine } from \"../modules/TemplateEngine.js\";\nimport { Signal } from \"../modules/Signal.js\";\nimport { Emitter } from \"../modules/Emitter.js\";\nimport { Renderer } from \"../modules/Renderer.js\";\n\n/**\n * @typedef {Object} ComponentDefinition\n * @property {function(Object<string, any>): (Object<string, any>|Promise<Object<string, any>>)} [setup]\n * A setup function that initializes the component state and returns an object or a promise that resolves to an object.\n * @property {function(Object<string, any>): string} template\n * A function that returns the HTML template string for the component.\n * @property {function(Object<string, any>): string} [style]\n * An optional function that returns scoped CSS styles as a string.\n * @property {Object<string, ComponentDefinition>} [children]\n * An optional mapping of CSS selectors to child component definitions.\n */\n\n/**\n * @class 🧩 Eleva\n * @classdesc Signal-based component runtime framework with lifecycle hooks, scoped styles, and plugin support.\n * Manages component registration, plugin integration, event handling, and DOM rendering.\n */\nexport class Eleva {\n /**\n * Creates a new Eleva instance.\n *\n * @param {string} name - The name of the Eleva instance.\n * @param {Object<string, any>} [config={}] - Optional configuration for the instance.\n */\n constructor(name, config = {}) {\n /** @type {string} */\n this.name = name;\n /** @type {Object<string, any>} */\n this.config = config;\n /** @type {Object<string, ComponentDefinition>} */\n this._components = {};\n /** @type {Array<Object>} */\n this._plugins = [];\n /** @private */\n this._lifecycleHooks = [\n \"onBeforeMount\",\n \"onMount\",\n \"onBeforeUpdate\",\n \"onUpdate\",\n \"onUnmount\",\n ];\n /** @private {boolean} */\n this._isMounted = false;\n this.emitter = new Emitter();\n this.renderer = new Renderer();\n }\n\n /**\n * Integrates a plugin with the Eleva framework.\n *\n * @param {Object} plugin - The plugin object which should have an `install` function.\n * @param {Object<string, any>} [options={}] - Optional options to pass to the plugin.\n * @returns {Eleva} The Eleva instance (for chaining).\n */\n use(plugin, options = {}) {\n if (typeof plugin.install === \"function\") {\n plugin.install(this, options);\n }\n this._plugins.push(plugin);\n return this;\n }\n\n /**\n * Registers a component with the Eleva instance.\n *\n * @param {string} name - The name of the component.\n * @param {ComponentDefinition} definition - The component definition including setup, template, style, and children.\n * @returns {Eleva} The Eleva instance (for chaining).\n */\n component(name, definition) {\n this._components[name] = definition;\n return this;\n }\n\n /**\n * Mounts a registered component to a DOM element.\n *\n * @param {HTMLElement} container - A DOM element where the component will be mounted.\n * @param {string|ComponentDefinition} compName - The name of the component to mount or a component definition.\n * @param {Object<string, any>} [props={}] - Optional properties to pass to the component.\n * @returns {object|Promise<object>} An object representing the mounted component instance, or a Promise that resolves to it for asynchronous setups.\n * @throws {Error} If the container is not found or if the component is not registered.\n */\n mount(container, compName, props = {}) {\n if (!container) throw new Error(`Container not found: ${container}`);\n\n let definition;\n if (typeof compName === \"string\") {\n definition = this._components[compName];\n if (!definition)\n throw new Error(`Component \"${compName}\" not registered.`);\n } else if (typeof compName === \"object\") {\n definition = compName;\n } else {\n throw new Error(\"Invalid component parameter.\");\n }\n\n const { setup, template, style, children } = definition;\n const context = {\n props,\n emit: this.emitter.emit.bind(this.emitter),\n on: this.emitter.on.bind(this.emitter),\n signal: (v) => new Signal(v),\n ...this._prepareLifecycleHooks(),\n };\n\n /**\n * Processes the mounting of the component.\n *\n * @param {Object<string, any>} data - Data returned from the component's setup function.\n * @returns {object} An object with the container, merged context data, and an unmount function.\n */\n const processMount = (data) => {\n const mergedContext = { ...context, ...data };\n const watcherUnsubscribers = [];\n const childInstances = [];\n\n if (!this._isMounted) {\n mergedContext.onBeforeMount && mergedContext.onBeforeMount();\n } else {\n mergedContext.onBeforeUpdate && mergedContext.onBeforeUpdate();\n }\n\n /**\n * Renders the component by parsing the template, patching the DOM,\n * processing events, injecting styles, and mounting child components.\n */\n const render = () => {\n const newHtml = TemplateEngine.parse(\n template(mergedContext),\n mergedContext\n );\n this.renderer.patchDOM(container, newHtml);\n this._processEvents(container, mergedContext);\n this._injectStyles(container, compName, style, mergedContext);\n this._mountChildren(container, children, childInstances);\n if (!this._isMounted) {\n mergedContext.onMount && mergedContext.onMount();\n this._isMounted = true;\n } else {\n mergedContext.onUpdate && mergedContext.onUpdate();\n }\n };\n\n Object.values(data).forEach((val) => {\n if (val instanceof Signal) watcherUnsubscribers.push(val.watch(render));\n });\n\n render();\n\n return {\n container,\n data: mergedContext,\n /**\n * Unmounts the component, cleaning up watchers, child components, and clearing the container.\n *\n * @returns {void}\n */\n unmount: () => {\n watcherUnsubscribers.forEach((fn) => fn());\n childInstances.forEach((child) => child.unmount());\n mergedContext.onUnmount && mergedContext.onUnmount();\n container.innerHTML = \"\";\n },\n };\n };\n\n // Handle asynchronous setup.\n return Promise.resolve(\n typeof setup === \"function\" ? setup(context) : {}\n ).then((data) => processMount(data));\n }\n\n /**\n * Prepares default no-operation lifecycle hook functions.\n *\n * @returns {Object<string, function(): void>} An object with keys for lifecycle hooks mapped to empty functions.\n * @private\n */\n _prepareLifecycleHooks() {\n return this._lifecycleHooks.reduce((acc, hook) => {\n acc[hook] = () => {};\n return acc;\n }, {});\n }\n\n /**\n * Processes DOM elements for event binding based on attributes starting with \"@\".\n *\n * @param {HTMLElement} container - The container element in which to search for events.\n * @param {Object<string, any>} context - The current context containing event handler definitions.\n * @private\n */\n _processEvents(container, context) {\n container.querySelectorAll(\"*\").forEach((el) => {\n [...el.attributes].forEach(({ name, value }) => {\n if (name.startsWith(\"@\")) {\n const event = name.slice(1);\n const handler = TemplateEngine.evaluate(value, context);\n if (typeof handler === \"function\") {\n el.addEventListener(event, handler);\n el.removeAttribute(name);\n }\n }\n });\n });\n }\n\n /**\n * Injects scoped styles into the component's container.\n *\n * @param {HTMLElement} container - The container element.\n * @param {string} compName - The component name used to identify the style element.\n * @param {function(Object<string, any>): string} [styleFn] - A function that returns CSS styles as a string.\n * @param {Object<string, any>} context - The current context for style interpolation.\n * @private\n */\n _injectStyles(container, compName, styleFn, context) {\n if (styleFn) {\n let styleEl = container.querySelector(\n `style[data-eleva-style=\"${compName}\"]`\n );\n if (!styleEl) {\n styleEl = document.createElement(\"style\");\n styleEl.setAttribute(\"data-eleva-style\", compName);\n container.appendChild(styleEl);\n }\n styleEl.textContent = TemplateEngine.parse(styleFn(context), context);\n }\n }\n\n /**\n * Mounts child components within the parent component's container.\n *\n * @param {HTMLElement} container - The parent container element.\n * @param {Object<string, ComponentDefinition>} [children] - An object mapping child component selectors to their definitions.\n * @param {Array<object>} childInstances - An array to store the mounted child component instances.\n * @private\n */\n _mountChildren(container, children, childInstances) {\n childInstances.forEach((child) => child.unmount());\n childInstances.length = 0;\n\n Object.keys(children || {}).forEach((childSelector) => {\n container.querySelectorAll(childSelector).forEach((childEl) => {\n const props = {};\n [...childEl.attributes].forEach(({ name, value }) => {\n if (name.startsWith(\"eleva-prop-\")) {\n props[name.slice(\"eleva-prop-\".length)] = value;\n }\n });\n const instance = this.mount(childEl, children[childSelector], props);\n childInstances.push(instance);\n });\n });\n }\n}\n"],"names":["TemplateEngine","parse","template","data","replace","_","expr","value","this","evaluate","undefined","keys","Object","values","result","Function","error","console","expression","message","Signal","constructor","_value","_watchers","Set","newVal","forEach","fn","watch","add","delete","Emitter","events","on","event","handler","push","off","filter","h","emit","args","Renderer","patchDOM","container","newHtml","tempContainer","document","createElement","innerHTML","diff","oldParent","newParent","oldNodes","Array","from","childNodes","newNodes","max","Math","length","i","oldNode","newNode","nodeType","Node","ELEMENT_NODE","oldKey","getAttribute","newKey","replaceChild","cloneNode","nodeName","TEXT_NODE","updateAttributes","nodeValue","removeChild","appendChild","oldEl","newEl","attributeToPropertyMap","checked","selected","disabled","attributes","attr","name","startsWith","hasAttribute","removeAttribute","setAttribute","config","_components","_plugins","_lifecycleHooks","_isMounted","emitter","renderer","use","plugin","options","install","component","definition","mount","compName","props","Error","setup","style","children","context","bind","signal","v","_prepareLifecycleHooks","processMount","mergedContext","watcherUnsubscribers","childInstances","onBeforeUpdate","onBeforeMount","render","_processEvents","_injectStyles","_mountChildren","onUpdate","onMount","val","unmount","child","onUnmount","Promise","resolve","then","reduce","acc","hook","querySelectorAll","el","slice","addEventListener","styleFn","styleEl","querySelector","textContent","childSelector","childEl","instance"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"eleva.min.js","sources":["../src/modules/TemplateEngine.js","../src/modules/Signal.js","../src/modules/Emitter.js","../src/modules/Renderer.js","../src/core/Eleva.js"],"sourcesContent":["\"use strict\";\n\n/**\n * @class 🔒 TemplateEngine\n * @classdesc Secure interpolation & dynamic attribute parsing.\n * Provides methods to parse template strings by replacing interpolation expressions\n * with dynamic data values and to evaluate expressions within a given data context.\n */\nexport class TemplateEngine {\n /**\n * Parses a template string and replaces interpolation expressions with corresponding values.\n *\n * @param {string} template - The template string containing expressions in the format `{{ expression }}`.\n * @param {Object<string, any>} data - The data object to use for evaluating expressions.\n * @returns {string} The resulting string with evaluated values.\n */\n static parse(template, data) {\n return template.replace(/\\{\\{\\s*(.*?)\\s*\\}\\}/g, (_, expr) => {\n const value = this.evaluate(expr, data);\n return value === undefined ? \"\" : value;\n });\n }\n\n /**\n * Evaluates a JavaScript expression using the provided data context.\n *\n * @param {string} expr - The JavaScript expression to evaluate.\n * @param {Object<string, any>} data - The data context for evaluating the expression.\n * @returns {any} The result of the evaluated expression, or an empty string if undefined or on error.\n */\n static evaluate(expr, data) {\n try {\n const keys = Object.keys(data);\n const values = Object.values(data);\n const result = new Function(...keys, `return ${expr}`)(...values);\n return result === undefined ? \"\" : result;\n } catch (error) {\n console.error(`Template evaluation error:`, {\n expression: expr,\n data,\n error: error.message,\n });\n return \"\";\n }\n }\n}\n","\"use strict\";\n\n/**\n * @class ⚡ Signal\n * @classdesc Fine-grained reactivity.\n * A reactive data holder that notifies registered watchers when its value changes,\n * enabling fine-grained DOM patching rather than full re-renders.\n */\nexport class Signal {\n /**\n * Creates a new Signal instance.\n *\n * @param {*} value - The initial value of the signal.\n */\n constructor(value) {\n /** @private {*} Internal storage for the signal's current value */\n this._value = value;\n /** @private {Set<function>} Collection of callback functions to be notified when value changes */\n this._watchers = new Set();\n }\n\n /**\n * Gets the current value of the signal.\n *\n * @returns {*} The current value.\n */\n get value() {\n return this._value;\n }\n\n /**\n * Sets a new value for the signal and notifies all registered watchers if the value has changed.\n *\n * @param {*} newVal - The new value to set.\n */\n set value(newVal) {\n if (newVal !== this._value) {\n this._value = newVal;\n this._watchers.forEach((fn) => fn(newVal));\n }\n }\n\n /**\n * Registers a watcher function that will be called whenever the signal's value changes.\n *\n * @param {function(any): void} fn - The callback function to invoke on value change.\n * @returns {function(): boolean} A function to unsubscribe the watcher.\n */\n watch(fn) {\n this._watchers.add(fn);\n return () => this._watchers.delete(fn);\n }\n}\n","\"use strict\";\n\n/**\n * @class 🎙️ Emitter\n * @classdesc Robust inter-component communication with event bubbling.\n * Implements a basic publish-subscribe pattern for event handling, allowing components\n * to communicate through custom events.\n */\nexport class Emitter {\n /**\n * Creates a new Emitter instance.\n */\n constructor() {\n /** @type {Object.<string, Function[]>} Storage for event handlers mapped by event name */\n this.events = {};\n }\n\n /**\n * Registers an event handler for the specified event.\n *\n * @param {string} event - The name of the event.\n * @param {function(...any): void} handler - The function to call when the event is emitted.\n */\n on(event, handler) {\n (this.events[event] || (this.events[event] = [])).push(handler);\n }\n\n /**\n * Removes a previously registered event handler.\n *\n * @param {string} event - The name of the event.\n * @param {function(...any): void} handler - The handler function to remove.\n */\n off(event, handler) {\n if (this.events[event]) {\n this.events[event] = this.events[event].filter((h) => h !== handler);\n }\n }\n\n /**\n * Emits an event, invoking all handlers registered for that event.\n *\n * @param {string} event - The event name.\n * @param {...any} args - Additional arguments to pass to the event handlers.\n */\n emit(event, ...args) {\n (this.events[event] || []).forEach((handler) => handler(...args));\n }\n}\n","\"use strict\";\n\n/**\n * @class 🎨 Renderer\n * @classdesc Handles DOM patching, diffing, and attribute updates.\n * Provides methods for efficient DOM updates by diffing the new and old DOM structures\n * and applying only the necessary changes.\n */\nexport class Renderer {\n /**\n * Patches the DOM of a container element with new HTML content.\n *\n * @param {HTMLElement} container - The container element to patch.\n * @param {string} newHtml - The new HTML content to apply.\n */\n patchDOM(container, newHtml) {\n const tempContainer = document.createElement(\"div\");\n tempContainer.innerHTML = newHtml;\n this.diff(container, tempContainer);\n }\n\n /**\n * Diffs two DOM trees (old and new) and applies updates to the old DOM.\n *\n * @param {HTMLElement} oldParent - The original DOM element.\n * @param {HTMLElement} newParent - The new DOM element.\n */\n diff(oldParent, newParent) {\n const oldNodes = Array.from(oldParent.childNodes);\n const newNodes = Array.from(newParent.childNodes);\n const max = Math.max(oldNodes.length, newNodes.length);\n for (let i = 0; i < max; i++) {\n const oldNode = oldNodes[i];\n const newNode = newNodes[i];\n\n // Case 1: Append new nodes that don't exist in the old tree.\n if (!oldNode && newNode) {\n oldParent.appendChild(newNode.cloneNode(true));\n continue;\n }\n // Case 2: Remove old nodes not present in the new tree.\n if (oldNode && !newNode) {\n oldParent.removeChild(oldNode);\n continue;\n }\n\n // Case 3: For element nodes, compare keys if available.\n if (\n oldNode.nodeType === Node.ELEMENT_NODE &&\n newNode.nodeType === Node.ELEMENT_NODE\n ) {\n const oldKey = oldNode.getAttribute(\"key\");\n const newKey = newNode.getAttribute(\"key\");\n if (oldKey || newKey) {\n if (oldKey !== newKey) {\n oldParent.replaceChild(newNode.cloneNode(true), oldNode);\n continue;\n }\n }\n }\n\n // Case 4: Replace nodes if types or tag names differ.\n if (\n oldNode.nodeType !== newNode.nodeType ||\n oldNode.nodeName !== newNode.nodeName\n ) {\n oldParent.replaceChild(newNode.cloneNode(true), oldNode);\n continue;\n }\n // Case 5: For text nodes, update content if different.\n if (oldNode.nodeType === Node.TEXT_NODE) {\n if (oldNode.nodeValue !== newNode.nodeValue) {\n oldNode.nodeValue = newNode.nodeValue;\n }\n continue;\n }\n // Case 6: For element nodes, update attributes and then diff children.\n if (oldNode.nodeType === Node.ELEMENT_NODE) {\n this.updateAttributes(oldNode, newNode);\n this.diff(oldNode, newNode);\n }\n }\n }\n\n /**\n * Updates the attributes of an element to match those of a new element.\n *\n * @param {HTMLElement} oldEl - The element to update.\n * @param {HTMLElement} newEl - The element providing the updated attributes.\n */\n updateAttributes(oldEl, newEl) {\n const attributeToPropertyMap = {\n value: \"value\",\n checked: \"checked\",\n selected: \"selected\",\n disabled: \"disabled\",\n };\n\n // Remove old attributes that no longer exist.\n Array.from(oldEl.attributes).forEach((attr) => {\n if (attr.name.startsWith(\"@\")) return;\n if (!newEl.hasAttribute(attr.name)) {\n oldEl.removeAttribute(attr.name);\n }\n });\n // Add or update attributes from newEl.\n Array.from(newEl.attributes).forEach((attr) => {\n if (attr.name.startsWith(\"@\")) return;\n if (oldEl.getAttribute(attr.name) !== attr.value) {\n oldEl.setAttribute(attr.name, attr.value);\n if (attributeToPropertyMap[attr.name]) {\n oldEl[attributeToPropertyMap[attr.name]] = attr.value;\n } else if (attr.name in oldEl) {\n oldEl[attr.name] = attr.value;\n }\n }\n });\n }\n}\n","\"use strict\";\n\nimport { TemplateEngine } from \"../modules/TemplateEngine.js\";\nimport { Signal } from \"../modules/Signal.js\";\nimport { Emitter } from \"../modules/Emitter.js\";\nimport { Renderer } from \"../modules/Renderer.js\";\n\n/**\n * Defines the structure and behavior of a component.\n * @typedef {Object} ComponentDefinition\n * @property {function(Object<string, any>): (Object<string, any>|Promise<Object<string, any>>)} [setup]\n * Optional setup function that initializes the component's reactive state and lifecycle.\n * Receives props and context as an argument and should return an object containing the component's state.\n * Can return either a synchronous object or a Promise that resolves to an object for async initialization.\n *\n * @property {function(Object<string, any>): string} template\n * Required function that defines the component's HTML structure.\n * Receives the merged context (props + setup data) and must return an HTML template string.\n * Supports dynamic expressions using {{ }} syntax for reactive data binding.\n *\n * @property {function(Object<string, any>): string} [style]\n * Optional function that defines component-scoped CSS styles.\n * Receives the merged context and returns a CSS string that will be automatically scoped to the component.\n * Styles are injected into the component's container and only affect elements within it.\n *\n * @property {Object<string, ComponentDefinition>} [children]\n * Optional object that defines nested child components.\n * Keys are CSS selectors that match elements in the template where child components should be mounted.\n * Values are ComponentDefinition objects that define the structure and behavior of each child component.\n */\n\n/**\n * @class 🧩 Eleva\n * @classdesc Signal-based component runtime framework with lifecycle hooks, scoped styles, and plugin support.\n * Manages component registration, plugin integration, event handling, and DOM rendering.\n */\nexport class Eleva {\n /**\n * Creates a new Eleva instance.\n *\n * @param {string} name - The name of the Eleva instance.\n * @param {Object<string, any>} [config={}] - Optional configuration for the instance.\n */\n constructor(name, config = {}) {\n /** @type {string} The unique identifier name for this Eleva instance */\n this.name = name;\n /** @type {Object<string, any>} Optional configuration object for the Eleva instance */\n this.config = config;\n /** @type {Object<string, ComponentDefinition>} Object storing registered component definitions by name */\n this._components = {};\n /** @private {Array<Object>} Collection of installed plugin instances */\n this._plugins = [];\n /** @private {string[]} Array of lifecycle hook names supported by the component */\n this._lifecycleHooks = [\n \"onBeforeMount\",\n \"onMount\",\n \"onBeforeUpdate\",\n \"onUpdate\",\n \"onUnmount\",\n ];\n /** @private {boolean} Flag indicating if component is currently mounted */\n this._isMounted = false;\n /** @private {Emitter} Instance of the event emitter for handling component events */\n this.emitter = new Emitter();\n /** @private {Renderer} Instance of the renderer for handling DOM updates and patching */\n this.renderer = new Renderer();\n }\n\n /**\n * Integrates a plugin with the Eleva framework.\n *\n * @param {Object} plugin - The plugin object which should have an `install` function.\n * @param {Object<string, any>} [options={}] - Optional options to pass to the plugin.\n * @returns {Eleva} The Eleva instance (for chaining).\n */\n use(plugin, options = {}) {\n if (typeof plugin.install === \"function\") {\n plugin.install(this, options);\n }\n this._plugins.push(plugin);\n return this;\n }\n\n /**\n * Registers a component with the Eleva instance.\n *\n * @param {string} name - The name of the component.\n * @param {ComponentDefinition} definition - The component definition including setup, template, style, and children.\n * @returns {Eleva} The Eleva instance (for chaining).\n */\n component(name, definition) {\n this._components[name] = definition;\n return this;\n }\n\n /**\n * Mounts a registered component to a DOM element.\n *\n * @param {HTMLElement} container - A DOM element where the component will be mounted.\n * @param {string|ComponentDefinition} compName - The name of the component to mount or a component definition.\n * @param {Object<string, any>} [props={}] - Optional properties to pass to the component.\n * @returns {object|Promise<object>} An object representing the mounted component instance, or a Promise that resolves to it for asynchronous setups.\n * @throws {Error} If the container is not found or if the component is not registered.\n */\n mount(container, compName, props = {}) {\n if (!container) throw new Error(`Container not found: ${container}`);\n\n let definition;\n if (typeof compName === \"string\") {\n definition = this._components[compName];\n if (!definition)\n throw new Error(`Component \"${compName}\" not registered.`);\n } else if (typeof compName === \"object\") {\n definition = compName;\n } else {\n throw new Error(\"Invalid component parameter.\");\n }\n\n /**\n * Destructure the component definition to access core functionality.\n * - setup: Optional function for component initialization and state management\n * - template: Required function that returns the component's HTML structure\n * - style: Optional function for component-scoped CSS styles\n * - children: Optional object defining nested child components\n */\n const { setup, template, style, children } = definition;\n\n /**\n * Creates the initial context object for the component instance.\n * This context provides core functionality and will be merged with setup data.\n * @type {Object<string, any>}\n * @property {Object<string, any>} props - Component properties passed during mounting\n * @property {Emitter} emitter - Event emitter instance for component event handling\n * @property {function(any): Signal} signal - Factory function to create reactive Signal instances\n * @property {Object<string, function(): void>} ...lifecycleHooks - Prepared lifecycle hook functions\n */\n const context = {\n props,\n emitter: this.emitter,\n signal: (v) => new Signal(v),\n ...this._prepareLifecycleHooks(),\n };\n\n /**\n * Processes the mounting of the component.\n *\n * @param {Object<string, any>} data - Data returned from the component's setup function.\n * @returns {object} An object with the container, merged context data, and an unmount function.\n */\n const processMount = (data) => {\n const mergedContext = { ...context, ...data };\n const watcherUnsubscribers = [];\n const childInstances = [];\n\n if (!this._isMounted) {\n mergedContext.onBeforeMount && mergedContext.onBeforeMount();\n } else {\n mergedContext.onBeforeUpdate && mergedContext.onBeforeUpdate();\n }\n\n /**\n * Renders the component by parsing the template, patching the DOM,\n * processing events, injecting styles, and mounting child components.\n */\n const render = () => {\n const newHtml = TemplateEngine.parse(\n template(mergedContext),\n mergedContext\n );\n this.renderer.patchDOM(container, newHtml);\n this._processEvents(container, mergedContext);\n this._injectStyles(container, compName, style, mergedContext);\n this._mountChildren(container, children, childInstances);\n if (!this._isMounted) {\n mergedContext.onMount && mergedContext.onMount();\n this._isMounted = true;\n } else {\n mergedContext.onUpdate && mergedContext.onUpdate();\n }\n };\n\n /**\n * Sets up reactive watchers for all Signal instances in the component's data.\n * When a Signal's value changes, the component will re-render to reflect the updates.\n * Stores unsubscribe functions to clean up watchers when component unmounts.\n */\n Object.values(data).forEach((val) => {\n if (val instanceof Signal) watcherUnsubscribers.push(val.watch(render));\n });\n\n render();\n\n return {\n container,\n data: mergedContext,\n /**\n * Unmounts the component, cleaning up watchers, child components, and clearing the container.\n *\n * @returns {void}\n */\n unmount: () => {\n watcherUnsubscribers.forEach((fn) => fn());\n childInstances.forEach((child) => child.unmount());\n mergedContext.onUnmount && mergedContext.onUnmount();\n container.innerHTML = \"\";\n },\n };\n };\n\n // Handle asynchronous setup.\n return Promise.resolve(\n typeof setup === \"function\" ? setup(context) : {}\n ).then((data) => processMount(data));\n }\n\n /**\n * Prepares default no-operation lifecycle hook functions.\n *\n * @returns {Object<string, function(): void>} An object with keys for lifecycle hooks mapped to empty functions.\n * @private\n */\n _prepareLifecycleHooks() {\n return this._lifecycleHooks.reduce((acc, hook) => {\n acc[hook] = () => {};\n return acc;\n }, {});\n }\n\n /**\n * Processes DOM elements for event binding based on attributes starting with \"@\".\n *\n * @param {HTMLElement} container - The container element in which to search for events.\n * @param {Object<string, any>} context - The current context containing event handler definitions.\n * @private\n */\n _processEvents(container, context) {\n container.querySelectorAll(\"*\").forEach((el) => {\n [...el.attributes].forEach(({ name, value }) => {\n if (name.startsWith(\"@\")) {\n const event = name.slice(1);\n const handler = TemplateEngine.evaluate(value, context);\n if (typeof handler === \"function\") {\n el.addEventListener(event, handler);\n el.removeAttribute(name);\n }\n }\n });\n });\n }\n\n /**\n * Injects scoped styles into the component's container.\n *\n * @param {HTMLElement} container - The container element.\n * @param {string} compName - The component name used to identify the style element.\n * @param {function(Object<string, any>): string} [styleFn] - A function that returns CSS styles as a string.\n * @param {Object<string, any>} context - The current context for style interpolation.\n * @private\n */\n _injectStyles(container, compName, styleFn, context) {\n if (styleFn) {\n let styleEl = container.querySelector(\n `style[data-eleva-style=\"${compName}\"]`\n );\n if (!styleEl) {\n styleEl = document.createElement(\"style\");\n styleEl.setAttribute(\"data-eleva-style\", compName);\n container.appendChild(styleEl);\n }\n styleEl.textContent = TemplateEngine.parse(styleFn(context), context);\n }\n }\n\n /**\n * Mounts child components within the parent component's container.\n *\n * @param {HTMLElement} container - The parent container element.\n * @param {Object<string, ComponentDefinition>} [children] - An object mapping child component selectors to their definitions.\n * @param {Array<object>} childInstances - An array to store the mounted child component instances.\n * @private\n */\n _mountChildren(container, children, childInstances) {\n childInstances.forEach((child) => child.unmount());\n childInstances.length = 0;\n\n Object.keys(children || {}).forEach((childSelector) => {\n container.querySelectorAll(childSelector).forEach((childEl) => {\n const props = {};\n [...childEl.attributes].forEach(({ name, value }) => {\n if (name.startsWith(\"eleva-prop-\")) {\n props[name.slice(\"eleva-prop-\".length)] = value;\n }\n });\n const instance = this.mount(childEl, children[childSelector], props);\n childInstances.push(instance);\n });\n });\n }\n}\n"],"names":["TemplateEngine","parse","template","data","replace","_","expr","value","this","evaluate","undefined","keys","Object","values","result","Function","error","console","expression","message","Signal","constructor","_value","_watchers","Set","newVal","forEach","fn","watch","add","delete","Emitter","events","on","event","handler","push","off","filter","h","emit","args","Renderer","patchDOM","container","newHtml","tempContainer","document","createElement","innerHTML","diff","oldParent","newParent","oldNodes","Array","from","childNodes","newNodes","max","Math","length","i","oldNode","newNode","nodeType","Node","ELEMENT_NODE","oldKey","getAttribute","newKey","replaceChild","cloneNode","nodeName","TEXT_NODE","updateAttributes","nodeValue","removeChild","appendChild","oldEl","newEl","attributeToPropertyMap","checked","selected","disabled","attributes","attr","name","startsWith","hasAttribute","removeAttribute","setAttribute","config","_components","_plugins","_lifecycleHooks","_isMounted","emitter","renderer","use","plugin","options","install","component","definition","mount","compName","props","Error","setup","style","children","context","signal","v","_prepareLifecycleHooks","processMount","mergedContext","watcherUnsubscribers","childInstances","onBeforeUpdate","onBeforeMount","render","_processEvents","_injectStyles","_mountChildren","onUpdate","onMount","val","unmount","child","onUnmount","Promise","resolve","then","reduce","acc","hook","querySelectorAll","el","slice","addEventListener","styleFn","styleEl","querySelector","textContent","childSelector","childEl","instance"],"mappings":"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"}
|
package/dist/eleva.umd.js
CHANGED
|
@@ -62,7 +62,9 @@
|
|
|
62
62
|
* @param {*} value - The initial value of the signal.
|
|
63
63
|
*/
|
|
64
64
|
constructor(value) {
|
|
65
|
+
/** @private {*} Internal storage for the signal's current value */
|
|
65
66
|
this._value = value;
|
|
67
|
+
/** @private {Set<function>} Collection of callback functions to be notified when value changes */
|
|
66
68
|
this._watchers = new Set();
|
|
67
69
|
}
|
|
68
70
|
|
|
@@ -110,7 +112,7 @@
|
|
|
110
112
|
* Creates a new Emitter instance.
|
|
111
113
|
*/
|
|
112
114
|
constructor() {
|
|
113
|
-
/** @type {Object.<string, Function[]>} */
|
|
115
|
+
/** @type {Object.<string, Function[]>} Storage for event handlers mapped by event name */
|
|
114
116
|
this.events = {};
|
|
115
117
|
}
|
|
116
118
|
|
|
@@ -260,15 +262,27 @@
|
|
|
260
262
|
}
|
|
261
263
|
|
|
262
264
|
/**
|
|
265
|
+
* Defines the structure and behavior of a component.
|
|
263
266
|
* @typedef {Object} ComponentDefinition
|
|
264
267
|
* @property {function(Object<string, any>): (Object<string, any>|Promise<Object<string, any>>)} [setup]
|
|
265
|
-
*
|
|
268
|
+
* Optional setup function that initializes the component's reactive state and lifecycle.
|
|
269
|
+
* Receives props and context as an argument and should return an object containing the component's state.
|
|
270
|
+
* Can return either a synchronous object or a Promise that resolves to an object for async initialization.
|
|
271
|
+
*
|
|
266
272
|
* @property {function(Object<string, any>): string} template
|
|
267
|
-
*
|
|
273
|
+
* Required function that defines the component's HTML structure.
|
|
274
|
+
* Receives the merged context (props + setup data) and must return an HTML template string.
|
|
275
|
+
* Supports dynamic expressions using {{ }} syntax for reactive data binding.
|
|
276
|
+
*
|
|
268
277
|
* @property {function(Object<string, any>): string} [style]
|
|
269
|
-
*
|
|
278
|
+
* Optional function that defines component-scoped CSS styles.
|
|
279
|
+
* Receives the merged context and returns a CSS string that will be automatically scoped to the component.
|
|
280
|
+
* Styles are injected into the component's container and only affect elements within it.
|
|
281
|
+
*
|
|
270
282
|
* @property {Object<string, ComponentDefinition>} [children]
|
|
271
|
-
*
|
|
283
|
+
* Optional object that defines nested child components.
|
|
284
|
+
* Keys are CSS selectors that match elements in the template where child components should be mounted.
|
|
285
|
+
* Values are ComponentDefinition objects that define the structure and behavior of each child component.
|
|
272
286
|
*/
|
|
273
287
|
|
|
274
288
|
/**
|
|
@@ -284,19 +298,21 @@
|
|
|
284
298
|
* @param {Object<string, any>} [config={}] - Optional configuration for the instance.
|
|
285
299
|
*/
|
|
286
300
|
constructor(name, config = {}) {
|
|
287
|
-
/** @type {string} */
|
|
301
|
+
/** @type {string} The unique identifier name for this Eleva instance */
|
|
288
302
|
this.name = name;
|
|
289
|
-
/** @type {Object<string, any>} */
|
|
303
|
+
/** @type {Object<string, any>} Optional configuration object for the Eleva instance */
|
|
290
304
|
this.config = config;
|
|
291
|
-
/** @type {Object<string, ComponentDefinition>} */
|
|
305
|
+
/** @type {Object<string, ComponentDefinition>} Object storing registered component definitions by name */
|
|
292
306
|
this._components = {};
|
|
293
|
-
/** @
|
|
307
|
+
/** @private {Array<Object>} Collection of installed plugin instances */
|
|
294
308
|
this._plugins = [];
|
|
295
|
-
/** @private */
|
|
309
|
+
/** @private {string[]} Array of lifecycle hook names supported by the component */
|
|
296
310
|
this._lifecycleHooks = ["onBeforeMount", "onMount", "onBeforeUpdate", "onUpdate", "onUnmount"];
|
|
297
|
-
/** @private {boolean} */
|
|
311
|
+
/** @private {boolean} Flag indicating if component is currently mounted */
|
|
298
312
|
this._isMounted = false;
|
|
313
|
+
/** @private {Emitter} Instance of the event emitter for handling component events */
|
|
299
314
|
this.emitter = new Emitter();
|
|
315
|
+
/** @private {Renderer} Instance of the renderer for handling DOM updates and patching */
|
|
300
316
|
this.renderer = new Renderer();
|
|
301
317
|
}
|
|
302
318
|
|
|
@@ -347,16 +363,33 @@
|
|
|
347
363
|
} else {
|
|
348
364
|
throw new Error("Invalid component parameter.");
|
|
349
365
|
}
|
|
366
|
+
|
|
367
|
+
/**
|
|
368
|
+
* Destructure the component definition to access core functionality.
|
|
369
|
+
* - setup: Optional function for component initialization and state management
|
|
370
|
+
* - template: Required function that returns the component's HTML structure
|
|
371
|
+
* - style: Optional function for component-scoped CSS styles
|
|
372
|
+
* - children: Optional object defining nested child components
|
|
373
|
+
*/
|
|
350
374
|
const {
|
|
351
375
|
setup,
|
|
352
376
|
template,
|
|
353
377
|
style,
|
|
354
378
|
children
|
|
355
379
|
} = definition;
|
|
380
|
+
|
|
381
|
+
/**
|
|
382
|
+
* Creates the initial context object for the component instance.
|
|
383
|
+
* This context provides core functionality and will be merged with setup data.
|
|
384
|
+
* @type {Object<string, any>}
|
|
385
|
+
* @property {Object<string, any>} props - Component properties passed during mounting
|
|
386
|
+
* @property {Emitter} emitter - Event emitter instance for component event handling
|
|
387
|
+
* @property {function(any): Signal} signal - Factory function to create reactive Signal instances
|
|
388
|
+
* @property {Object<string, function(): void>} ...lifecycleHooks - Prepared lifecycle hook functions
|
|
389
|
+
*/
|
|
356
390
|
const context = {
|
|
357
391
|
props,
|
|
358
|
-
|
|
359
|
-
on: this.emitter.on.bind(this.emitter),
|
|
392
|
+
emitter: this.emitter,
|
|
360
393
|
signal: v => new Signal(v),
|
|
361
394
|
...this._prepareLifecycleHooks()
|
|
362
395
|
};
|
|
@@ -397,6 +430,12 @@
|
|
|
397
430
|
mergedContext.onUpdate && mergedContext.onUpdate();
|
|
398
431
|
}
|
|
399
432
|
};
|
|
433
|
+
|
|
434
|
+
/**
|
|
435
|
+
* Sets up reactive watchers for all Signal instances in the component's data.
|
|
436
|
+
* When a Signal's value changes, the component will re-render to reflect the updates.
|
|
437
|
+
* Stores unsubscribe functions to clean up watchers when component unmounts.
|
|
438
|
+
*/
|
|
400
439
|
Object.values(data).forEach(val => {
|
|
401
440
|
if (val instanceof Signal) watcherUnsubscribers.push(val.watch(render));
|
|
402
441
|
});
|
package/dist/eleva.umd.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"eleva.umd.js","sources":["../src/modules/TemplateEngine.js","../src/modules/Signal.js","../src/modules/Emitter.js","../src/modules/Renderer.js","../src/core/Eleva.js"],"sourcesContent":["\"use strict\";\n\n/**\n * @class 🔒 TemplateEngine\n * @classdesc Secure interpolation & dynamic attribute parsing.\n * Provides methods to parse template strings by replacing interpolation expressions\n * with dynamic data values and to evaluate expressions within a given data context.\n */\nexport class TemplateEngine {\n /**\n * Parses a template string and replaces interpolation expressions with corresponding values.\n *\n * @param {string} template - The template string containing expressions in the format `{{ expression }}`.\n * @param {Object<string, any>} data - The data object to use for evaluating expressions.\n * @returns {string} The resulting string with evaluated values.\n */\n static parse(template, data) {\n return template.replace(/\\{\\{\\s*(.*?)\\s*\\}\\}/g, (_, expr) => {\n const value = this.evaluate(expr, data);\n return value === undefined ? \"\" : value;\n });\n }\n\n /**\n * Evaluates a JavaScript expression using the provided data context.\n *\n * @param {string} expr - The JavaScript expression to evaluate.\n * @param {Object<string, any>} data - The data context for evaluating the expression.\n * @returns {any} The result of the evaluated expression, or an empty string if undefined or on error.\n */\n static evaluate(expr, data) {\n try {\n const keys = Object.keys(data);\n const values = Object.values(data);\n const result = new Function(...keys, `return ${expr}`)(...values);\n return result === undefined ? \"\" : result;\n } catch (error) {\n console.error(`Template evaluation error:`, {\n expression: expr,\n data,\n error: error.message,\n });\n return \"\";\n }\n }\n}\n","\"use strict\";\n\n/**\n * @class ⚡ Signal\n * @classdesc Fine-grained reactivity.\n * A reactive data holder that notifies registered watchers when its value changes,\n * enabling fine-grained DOM patching rather than full re-renders.\n */\nexport class Signal {\n /**\n * Creates a new Signal instance.\n *\n * @param {*} value - The initial value of the signal.\n */\n constructor(value) {\n this._value = value;\n this._watchers = new Set();\n }\n\n /**\n * Gets the current value of the signal.\n *\n * @returns {*} The current value.\n */\n get value() {\n return this._value;\n }\n\n /**\n * Sets a new value for the signal and notifies all registered watchers if the value has changed.\n *\n * @param {*} newVal - The new value to set.\n */\n set value(newVal) {\n if (newVal !== this._value) {\n this._value = newVal;\n this._watchers.forEach((fn) => fn(newVal));\n }\n }\n\n /**\n * Registers a watcher function that will be called whenever the signal's value changes.\n *\n * @param {function(any): void} fn - The callback function to invoke on value change.\n * @returns {function(): boolean} A function to unsubscribe the watcher.\n */\n watch(fn) {\n this._watchers.add(fn);\n return () => this._watchers.delete(fn);\n }\n}\n","\"use strict\";\n\n/**\n * @class 🎙️ Emitter\n * @classdesc Robust inter-component communication with event bubbling.\n * Implements a basic publish-subscribe pattern for event handling, allowing components\n * to communicate through custom events.\n */\nexport class Emitter {\n /**\n * Creates a new Emitter instance.\n */\n constructor() {\n /** @type {Object.<string, Function[]>} */\n this.events = {};\n }\n\n /**\n * Registers an event handler for the specified event.\n *\n * @param {string} event - The name of the event.\n * @param {function(...any): void} handler - The function to call when the event is emitted.\n */\n on(event, handler) {\n (this.events[event] || (this.events[event] = [])).push(handler);\n }\n\n /**\n * Removes a previously registered event handler.\n *\n * @param {string} event - The name of the event.\n * @param {function(...any): void} handler - The handler function to remove.\n */\n off(event, handler) {\n if (this.events[event]) {\n this.events[event] = this.events[event].filter((h) => h !== handler);\n }\n }\n\n /**\n * Emits an event, invoking all handlers registered for that event.\n *\n * @param {string} event - The event name.\n * @param {...any} args - Additional arguments to pass to the event handlers.\n */\n emit(event, ...args) {\n (this.events[event] || []).forEach((handler) => handler(...args));\n }\n}\n","\"use strict\";\n\n/**\n * @class 🎨 Renderer\n * @classdesc Handles DOM patching, diffing, and attribute updates.\n * Provides methods for efficient DOM updates by diffing the new and old DOM structures\n * and applying only the necessary changes.\n */\nexport class Renderer {\n /**\n * Patches the DOM of a container element with new HTML content.\n *\n * @param {HTMLElement} container - The container element to patch.\n * @param {string} newHtml - The new HTML content to apply.\n */\n patchDOM(container, newHtml) {\n const tempContainer = document.createElement(\"div\");\n tempContainer.innerHTML = newHtml;\n this.diff(container, tempContainer);\n }\n\n /**\n * Diffs two DOM trees (old and new) and applies updates to the old DOM.\n *\n * @param {HTMLElement} oldParent - The original DOM element.\n * @param {HTMLElement} newParent - The new DOM element.\n */\n diff(oldParent, newParent) {\n const oldNodes = Array.from(oldParent.childNodes);\n const newNodes = Array.from(newParent.childNodes);\n const max = Math.max(oldNodes.length, newNodes.length);\n for (let i = 0; i < max; i++) {\n const oldNode = oldNodes[i];\n const newNode = newNodes[i];\n\n // Case 1: Append new nodes that don't exist in the old tree.\n if (!oldNode && newNode) {\n oldParent.appendChild(newNode.cloneNode(true));\n continue;\n }\n // Case 2: Remove old nodes not present in the new tree.\n if (oldNode && !newNode) {\n oldParent.removeChild(oldNode);\n continue;\n }\n\n // Case 3: For element nodes, compare keys if available.\n if (\n oldNode.nodeType === Node.ELEMENT_NODE &&\n newNode.nodeType === Node.ELEMENT_NODE\n ) {\n const oldKey = oldNode.getAttribute(\"key\");\n const newKey = newNode.getAttribute(\"key\");\n if (oldKey || newKey) {\n if (oldKey !== newKey) {\n oldParent.replaceChild(newNode.cloneNode(true), oldNode);\n continue;\n }\n }\n }\n\n // Case 4: Replace nodes if types or tag names differ.\n if (\n oldNode.nodeType !== newNode.nodeType ||\n oldNode.nodeName !== newNode.nodeName\n ) {\n oldParent.replaceChild(newNode.cloneNode(true), oldNode);\n continue;\n }\n // Case 5: For text nodes, update content if different.\n if (oldNode.nodeType === Node.TEXT_NODE) {\n if (oldNode.nodeValue !== newNode.nodeValue) {\n oldNode.nodeValue = newNode.nodeValue;\n }\n continue;\n }\n // Case 6: For element nodes, update attributes and then diff children.\n if (oldNode.nodeType === Node.ELEMENT_NODE) {\n this.updateAttributes(oldNode, newNode);\n this.diff(oldNode, newNode);\n }\n }\n }\n\n /**\n * Updates the attributes of an element to match those of a new element.\n *\n * @param {HTMLElement} oldEl - The element to update.\n * @param {HTMLElement} newEl - The element providing the updated attributes.\n */\n updateAttributes(oldEl, newEl) {\n const attributeToPropertyMap = {\n value: \"value\",\n checked: \"checked\",\n selected: \"selected\",\n disabled: \"disabled\",\n };\n\n // Remove old attributes that no longer exist.\n Array.from(oldEl.attributes).forEach((attr) => {\n if (attr.name.startsWith(\"@\")) return;\n if (!newEl.hasAttribute(attr.name)) {\n oldEl.removeAttribute(attr.name);\n }\n });\n // Add or update attributes from newEl.\n Array.from(newEl.attributes).forEach((attr) => {\n if (attr.name.startsWith(\"@\")) return;\n if (oldEl.getAttribute(attr.name) !== attr.value) {\n oldEl.setAttribute(attr.name, attr.value);\n if (attributeToPropertyMap[attr.name]) {\n oldEl[attributeToPropertyMap[attr.name]] = attr.value;\n } else if (attr.name in oldEl) {\n oldEl[attr.name] = attr.value;\n }\n }\n });\n }\n}\n","\"use strict\";\n\nimport { TemplateEngine } from \"../modules/TemplateEngine.js\";\nimport { Signal } from \"../modules/Signal.js\";\nimport { Emitter } from \"../modules/Emitter.js\";\nimport { Renderer } from \"../modules/Renderer.js\";\n\n/**\n * @typedef {Object} ComponentDefinition\n * @property {function(Object<string, any>): (Object<string, any>|Promise<Object<string, any>>)} [setup]\n * A setup function that initializes the component state and returns an object or a promise that resolves to an object.\n * @property {function(Object<string, any>): string} template\n * A function that returns the HTML template string for the component.\n * @property {function(Object<string, any>): string} [style]\n * An optional function that returns scoped CSS styles as a string.\n * @property {Object<string, ComponentDefinition>} [children]\n * An optional mapping of CSS selectors to child component definitions.\n */\n\n/**\n * @class 🧩 Eleva\n * @classdesc Signal-based component runtime framework with lifecycle hooks, scoped styles, and plugin support.\n * Manages component registration, plugin integration, event handling, and DOM rendering.\n */\nexport class Eleva {\n /**\n * Creates a new Eleva instance.\n *\n * @param {string} name - The name of the Eleva instance.\n * @param {Object<string, any>} [config={}] - Optional configuration for the instance.\n */\n constructor(name, config = {}) {\n /** @type {string} */\n this.name = name;\n /** @type {Object<string, any>} */\n this.config = config;\n /** @type {Object<string, ComponentDefinition>} */\n this._components = {};\n /** @type {Array<Object>} */\n this._plugins = [];\n /** @private */\n this._lifecycleHooks = [\n \"onBeforeMount\",\n \"onMount\",\n \"onBeforeUpdate\",\n \"onUpdate\",\n \"onUnmount\",\n ];\n /** @private {boolean} */\n this._isMounted = false;\n this.emitter = new Emitter();\n this.renderer = new Renderer();\n }\n\n /**\n * Integrates a plugin with the Eleva framework.\n *\n * @param {Object} plugin - The plugin object which should have an `install` function.\n * @param {Object<string, any>} [options={}] - Optional options to pass to the plugin.\n * @returns {Eleva} The Eleva instance (for chaining).\n */\n use(plugin, options = {}) {\n if (typeof plugin.install === \"function\") {\n plugin.install(this, options);\n }\n this._plugins.push(plugin);\n return this;\n }\n\n /**\n * Registers a component with the Eleva instance.\n *\n * @param {string} name - The name of the component.\n * @param {ComponentDefinition} definition - The component definition including setup, template, style, and children.\n * @returns {Eleva} The Eleva instance (for chaining).\n */\n component(name, definition) {\n this._components[name] = definition;\n return this;\n }\n\n /**\n * Mounts a registered component to a DOM element.\n *\n * @param {HTMLElement} container - A DOM element where the component will be mounted.\n * @param {string|ComponentDefinition} compName - The name of the component to mount or a component definition.\n * @param {Object<string, any>} [props={}] - Optional properties to pass to the component.\n * @returns {object|Promise<object>} An object representing the mounted component instance, or a Promise that resolves to it for asynchronous setups.\n * @throws {Error} If the container is not found or if the component is not registered.\n */\n mount(container, compName, props = {}) {\n if (!container) throw new Error(`Container not found: ${container}`);\n\n let definition;\n if (typeof compName === \"string\") {\n definition = this._components[compName];\n if (!definition)\n throw new Error(`Component \"${compName}\" not registered.`);\n } else if (typeof compName === \"object\") {\n definition = compName;\n } else {\n throw new Error(\"Invalid component parameter.\");\n }\n\n const { setup, template, style, children } = definition;\n const context = {\n props,\n emit: this.emitter.emit.bind(this.emitter),\n on: this.emitter.on.bind(this.emitter),\n signal: (v) => new Signal(v),\n ...this._prepareLifecycleHooks(),\n };\n\n /**\n * Processes the mounting of the component.\n *\n * @param {Object<string, any>} data - Data returned from the component's setup function.\n * @returns {object} An object with the container, merged context data, and an unmount function.\n */\n const processMount = (data) => {\n const mergedContext = { ...context, ...data };\n const watcherUnsubscribers = [];\n const childInstances = [];\n\n if (!this._isMounted) {\n mergedContext.onBeforeMount && mergedContext.onBeforeMount();\n } else {\n mergedContext.onBeforeUpdate && mergedContext.onBeforeUpdate();\n }\n\n /**\n * Renders the component by parsing the template, patching the DOM,\n * processing events, injecting styles, and mounting child components.\n */\n const render = () => {\n const newHtml = TemplateEngine.parse(\n template(mergedContext),\n mergedContext\n );\n this.renderer.patchDOM(container, newHtml);\n this._processEvents(container, mergedContext);\n this._injectStyles(container, compName, style, mergedContext);\n this._mountChildren(container, children, childInstances);\n if (!this._isMounted) {\n mergedContext.onMount && mergedContext.onMount();\n this._isMounted = true;\n } else {\n mergedContext.onUpdate && mergedContext.onUpdate();\n }\n };\n\n Object.values(data).forEach((val) => {\n if (val instanceof Signal) watcherUnsubscribers.push(val.watch(render));\n });\n\n render();\n\n return {\n container,\n data: mergedContext,\n /**\n * Unmounts the component, cleaning up watchers, child components, and clearing the container.\n *\n * @returns {void}\n */\n unmount: () => {\n watcherUnsubscribers.forEach((fn) => fn());\n childInstances.forEach((child) => child.unmount());\n mergedContext.onUnmount && mergedContext.onUnmount();\n container.innerHTML = \"\";\n },\n };\n };\n\n // Handle asynchronous setup.\n return Promise.resolve(\n typeof setup === \"function\" ? setup(context) : {}\n ).then((data) => processMount(data));\n }\n\n /**\n * Prepares default no-operation lifecycle hook functions.\n *\n * @returns {Object<string, function(): void>} An object with keys for lifecycle hooks mapped to empty functions.\n * @private\n */\n _prepareLifecycleHooks() {\n return this._lifecycleHooks.reduce((acc, hook) => {\n acc[hook] = () => {};\n return acc;\n }, {});\n }\n\n /**\n * Processes DOM elements for event binding based on attributes starting with \"@\".\n *\n * @param {HTMLElement} container - The container element in which to search for events.\n * @param {Object<string, any>} context - The current context containing event handler definitions.\n * @private\n */\n _processEvents(container, context) {\n container.querySelectorAll(\"*\").forEach((el) => {\n [...el.attributes].forEach(({ name, value }) => {\n if (name.startsWith(\"@\")) {\n const event = name.slice(1);\n const handler = TemplateEngine.evaluate(value, context);\n if (typeof handler === \"function\") {\n el.addEventListener(event, handler);\n el.removeAttribute(name);\n }\n }\n });\n });\n }\n\n /**\n * Injects scoped styles into the component's container.\n *\n * @param {HTMLElement} container - The container element.\n * @param {string} compName - The component name used to identify the style element.\n * @param {function(Object<string, any>): string} [styleFn] - A function that returns CSS styles as a string.\n * @param {Object<string, any>} context - The current context for style interpolation.\n * @private\n */\n _injectStyles(container, compName, styleFn, context) {\n if (styleFn) {\n let styleEl = container.querySelector(\n `style[data-eleva-style=\"${compName}\"]`\n );\n if (!styleEl) {\n styleEl = document.createElement(\"style\");\n styleEl.setAttribute(\"data-eleva-style\", compName);\n container.appendChild(styleEl);\n }\n styleEl.textContent = TemplateEngine.parse(styleFn(context), context);\n }\n }\n\n /**\n * Mounts child components within the parent component's container.\n *\n * @param {HTMLElement} container - The parent container element.\n * @param {Object<string, ComponentDefinition>} [children] - An object mapping child component selectors to their definitions.\n * @param {Array<object>} childInstances - An array to store the mounted child component instances.\n * @private\n */\n _mountChildren(container, children, childInstances) {\n childInstances.forEach((child) => child.unmount());\n childInstances.length = 0;\n\n Object.keys(children || {}).forEach((childSelector) => {\n container.querySelectorAll(childSelector).forEach((childEl) => {\n const props = {};\n [...childEl.attributes].forEach(({ name, value }) => {\n if (name.startsWith(\"eleva-prop-\")) {\n props[name.slice(\"eleva-prop-\".length)] = value;\n }\n });\n const instance = this.mount(childEl, children[childSelector], props);\n childInstances.push(instance);\n });\n });\n }\n}\n"],"names":["TemplateEngine","parse","template","data","replace","_","expr","value","evaluate","undefined","keys","Object","values","result","Function","error","console","expression","message","Signal","constructor","_value","_watchers","Set","newVal","forEach","fn","watch","add","delete","Emitter","events","on","event","handler","push","off","filter","h","emit","args","Renderer","patchDOM","container","newHtml","tempContainer","document","createElement","innerHTML","diff","oldParent","newParent","oldNodes","Array","from","childNodes","newNodes","max","Math","length","i","oldNode","newNode","appendChild","cloneNode","removeChild","nodeType","Node","ELEMENT_NODE","oldKey","getAttribute","newKey","replaceChild","nodeName","TEXT_NODE","nodeValue","updateAttributes","oldEl","newEl","attributeToPropertyMap","checked","selected","disabled","attributes","attr","name","startsWith","hasAttribute","removeAttribute","setAttribute","Eleva","config","_components","_plugins","_lifecycleHooks","_isMounted","emitter","renderer","use","plugin","options","install","component","definition","mount","compName","props","Error","setup","style","children","context","bind","signal","v","_prepareLifecycleHooks","processMount","mergedContext","watcherUnsubscribers","childInstances","onBeforeMount","onBeforeUpdate","render","_processEvents","_injectStyles","_mountChildren","onMount","onUpdate","val","unmount","child","onUnmount","Promise","resolve","then","reduce","acc","hook","querySelectorAll","el","slice","addEventListener","styleFn","styleEl","querySelector","textContent","childSelector","childEl","instance"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"eleva.umd.js","sources":["../src/modules/TemplateEngine.js","../src/modules/Signal.js","../src/modules/Emitter.js","../src/modules/Renderer.js","../src/core/Eleva.js"],"sourcesContent":["\"use strict\";\n\n/**\n * @class 🔒 TemplateEngine\n * @classdesc Secure interpolation & dynamic attribute parsing.\n * Provides methods to parse template strings by replacing interpolation expressions\n * with dynamic data values and to evaluate expressions within a given data context.\n */\nexport class TemplateEngine {\n /**\n * Parses a template string and replaces interpolation expressions with corresponding values.\n *\n * @param {string} template - The template string containing expressions in the format `{{ expression }}`.\n * @param {Object<string, any>} data - The data object to use for evaluating expressions.\n * @returns {string} The resulting string with evaluated values.\n */\n static parse(template, data) {\n return template.replace(/\\{\\{\\s*(.*?)\\s*\\}\\}/g, (_, expr) => {\n const value = this.evaluate(expr, data);\n return value === undefined ? \"\" : value;\n });\n }\n\n /**\n * Evaluates a JavaScript expression using the provided data context.\n *\n * @param {string} expr - The JavaScript expression to evaluate.\n * @param {Object<string, any>} data - The data context for evaluating the expression.\n * @returns {any} The result of the evaluated expression, or an empty string if undefined or on error.\n */\n static evaluate(expr, data) {\n try {\n const keys = Object.keys(data);\n const values = Object.values(data);\n const result = new Function(...keys, `return ${expr}`)(...values);\n return result === undefined ? \"\" : result;\n } catch (error) {\n console.error(`Template evaluation error:`, {\n expression: expr,\n data,\n error: error.message,\n });\n return \"\";\n }\n }\n}\n","\"use strict\";\n\n/**\n * @class ⚡ Signal\n * @classdesc Fine-grained reactivity.\n * A reactive data holder that notifies registered watchers when its value changes,\n * enabling fine-grained DOM patching rather than full re-renders.\n */\nexport class Signal {\n /**\n * Creates a new Signal instance.\n *\n * @param {*} value - The initial value of the signal.\n */\n constructor(value) {\n /** @private {*} Internal storage for the signal's current value */\n this._value = value;\n /** @private {Set<function>} Collection of callback functions to be notified when value changes */\n this._watchers = new Set();\n }\n\n /**\n * Gets the current value of the signal.\n *\n * @returns {*} The current value.\n */\n get value() {\n return this._value;\n }\n\n /**\n * Sets a new value for the signal and notifies all registered watchers if the value has changed.\n *\n * @param {*} newVal - The new value to set.\n */\n set value(newVal) {\n if (newVal !== this._value) {\n this._value = newVal;\n this._watchers.forEach((fn) => fn(newVal));\n }\n }\n\n /**\n * Registers a watcher function that will be called whenever the signal's value changes.\n *\n * @param {function(any): void} fn - The callback function to invoke on value change.\n * @returns {function(): boolean} A function to unsubscribe the watcher.\n */\n watch(fn) {\n this._watchers.add(fn);\n return () => this._watchers.delete(fn);\n }\n}\n","\"use strict\";\n\n/**\n * @class 🎙️ Emitter\n * @classdesc Robust inter-component communication with event bubbling.\n * Implements a basic publish-subscribe pattern for event handling, allowing components\n * to communicate through custom events.\n */\nexport class Emitter {\n /**\n * Creates a new Emitter instance.\n */\n constructor() {\n /** @type {Object.<string, Function[]>} Storage for event handlers mapped by event name */\n this.events = {};\n }\n\n /**\n * Registers an event handler for the specified event.\n *\n * @param {string} event - The name of the event.\n * @param {function(...any): void} handler - The function to call when the event is emitted.\n */\n on(event, handler) {\n (this.events[event] || (this.events[event] = [])).push(handler);\n }\n\n /**\n * Removes a previously registered event handler.\n *\n * @param {string} event - The name of the event.\n * @param {function(...any): void} handler - The handler function to remove.\n */\n off(event, handler) {\n if (this.events[event]) {\n this.events[event] = this.events[event].filter((h) => h !== handler);\n }\n }\n\n /**\n * Emits an event, invoking all handlers registered for that event.\n *\n * @param {string} event - The event name.\n * @param {...any} args - Additional arguments to pass to the event handlers.\n */\n emit(event, ...args) {\n (this.events[event] || []).forEach((handler) => handler(...args));\n }\n}\n","\"use strict\";\n\n/**\n * @class 🎨 Renderer\n * @classdesc Handles DOM patching, diffing, and attribute updates.\n * Provides methods for efficient DOM updates by diffing the new and old DOM structures\n * and applying only the necessary changes.\n */\nexport class Renderer {\n /**\n * Patches the DOM of a container element with new HTML content.\n *\n * @param {HTMLElement} container - The container element to patch.\n * @param {string} newHtml - The new HTML content to apply.\n */\n patchDOM(container, newHtml) {\n const tempContainer = document.createElement(\"div\");\n tempContainer.innerHTML = newHtml;\n this.diff(container, tempContainer);\n }\n\n /**\n * Diffs two DOM trees (old and new) and applies updates to the old DOM.\n *\n * @param {HTMLElement} oldParent - The original DOM element.\n * @param {HTMLElement} newParent - The new DOM element.\n */\n diff(oldParent, newParent) {\n const oldNodes = Array.from(oldParent.childNodes);\n const newNodes = Array.from(newParent.childNodes);\n const max = Math.max(oldNodes.length, newNodes.length);\n for (let i = 0; i < max; i++) {\n const oldNode = oldNodes[i];\n const newNode = newNodes[i];\n\n // Case 1: Append new nodes that don't exist in the old tree.\n if (!oldNode && newNode) {\n oldParent.appendChild(newNode.cloneNode(true));\n continue;\n }\n // Case 2: Remove old nodes not present in the new tree.\n if (oldNode && !newNode) {\n oldParent.removeChild(oldNode);\n continue;\n }\n\n // Case 3: For element nodes, compare keys if available.\n if (\n oldNode.nodeType === Node.ELEMENT_NODE &&\n newNode.nodeType === Node.ELEMENT_NODE\n ) {\n const oldKey = oldNode.getAttribute(\"key\");\n const newKey = newNode.getAttribute(\"key\");\n if (oldKey || newKey) {\n if (oldKey !== newKey) {\n oldParent.replaceChild(newNode.cloneNode(true), oldNode);\n continue;\n }\n }\n }\n\n // Case 4: Replace nodes if types or tag names differ.\n if (\n oldNode.nodeType !== newNode.nodeType ||\n oldNode.nodeName !== newNode.nodeName\n ) {\n oldParent.replaceChild(newNode.cloneNode(true), oldNode);\n continue;\n }\n // Case 5: For text nodes, update content if different.\n if (oldNode.nodeType === Node.TEXT_NODE) {\n if (oldNode.nodeValue !== newNode.nodeValue) {\n oldNode.nodeValue = newNode.nodeValue;\n }\n continue;\n }\n // Case 6: For element nodes, update attributes and then diff children.\n if (oldNode.nodeType === Node.ELEMENT_NODE) {\n this.updateAttributes(oldNode, newNode);\n this.diff(oldNode, newNode);\n }\n }\n }\n\n /**\n * Updates the attributes of an element to match those of a new element.\n *\n * @param {HTMLElement} oldEl - The element to update.\n * @param {HTMLElement} newEl - The element providing the updated attributes.\n */\n updateAttributes(oldEl, newEl) {\n const attributeToPropertyMap = {\n value: \"value\",\n checked: \"checked\",\n selected: \"selected\",\n disabled: \"disabled\",\n };\n\n // Remove old attributes that no longer exist.\n Array.from(oldEl.attributes).forEach((attr) => {\n if (attr.name.startsWith(\"@\")) return;\n if (!newEl.hasAttribute(attr.name)) {\n oldEl.removeAttribute(attr.name);\n }\n });\n // Add or update attributes from newEl.\n Array.from(newEl.attributes).forEach((attr) => {\n if (attr.name.startsWith(\"@\")) return;\n if (oldEl.getAttribute(attr.name) !== attr.value) {\n oldEl.setAttribute(attr.name, attr.value);\n if (attributeToPropertyMap[attr.name]) {\n oldEl[attributeToPropertyMap[attr.name]] = attr.value;\n } else if (attr.name in oldEl) {\n oldEl[attr.name] = attr.value;\n }\n }\n });\n }\n}\n","\"use strict\";\n\nimport { TemplateEngine } from \"../modules/TemplateEngine.js\";\nimport { Signal } from \"../modules/Signal.js\";\nimport { Emitter } from \"../modules/Emitter.js\";\nimport { Renderer } from \"../modules/Renderer.js\";\n\n/**\n * Defines the structure and behavior of a component.\n * @typedef {Object} ComponentDefinition\n * @property {function(Object<string, any>): (Object<string, any>|Promise<Object<string, any>>)} [setup]\n * Optional setup function that initializes the component's reactive state and lifecycle.\n * Receives props and context as an argument and should return an object containing the component's state.\n * Can return either a synchronous object or a Promise that resolves to an object for async initialization.\n *\n * @property {function(Object<string, any>): string} template\n * Required function that defines the component's HTML structure.\n * Receives the merged context (props + setup data) and must return an HTML template string.\n * Supports dynamic expressions using {{ }} syntax for reactive data binding.\n *\n * @property {function(Object<string, any>): string} [style]\n * Optional function that defines component-scoped CSS styles.\n * Receives the merged context and returns a CSS string that will be automatically scoped to the component.\n * Styles are injected into the component's container and only affect elements within it.\n *\n * @property {Object<string, ComponentDefinition>} [children]\n * Optional object that defines nested child components.\n * Keys are CSS selectors that match elements in the template where child components should be mounted.\n * Values are ComponentDefinition objects that define the structure and behavior of each child component.\n */\n\n/**\n * @class 🧩 Eleva\n * @classdesc Signal-based component runtime framework with lifecycle hooks, scoped styles, and plugin support.\n * Manages component registration, plugin integration, event handling, and DOM rendering.\n */\nexport class Eleva {\n /**\n * Creates a new Eleva instance.\n *\n * @param {string} name - The name of the Eleva instance.\n * @param {Object<string, any>} [config={}] - Optional configuration for the instance.\n */\n constructor(name, config = {}) {\n /** @type {string} The unique identifier name for this Eleva instance */\n this.name = name;\n /** @type {Object<string, any>} Optional configuration object for the Eleva instance */\n this.config = config;\n /** @type {Object<string, ComponentDefinition>} Object storing registered component definitions by name */\n this._components = {};\n /** @private {Array<Object>} Collection of installed plugin instances */\n this._plugins = [];\n /** @private {string[]} Array of lifecycle hook names supported by the component */\n this._lifecycleHooks = [\n \"onBeforeMount\",\n \"onMount\",\n \"onBeforeUpdate\",\n \"onUpdate\",\n \"onUnmount\",\n ];\n /** @private {boolean} Flag indicating if component is currently mounted */\n this._isMounted = false;\n /** @private {Emitter} Instance of the event emitter for handling component events */\n this.emitter = new Emitter();\n /** @private {Renderer} Instance of the renderer for handling DOM updates and patching */\n this.renderer = new Renderer();\n }\n\n /**\n * Integrates a plugin with the Eleva framework.\n *\n * @param {Object} plugin - The plugin object which should have an `install` function.\n * @param {Object<string, any>} [options={}] - Optional options to pass to the plugin.\n * @returns {Eleva} The Eleva instance (for chaining).\n */\n use(plugin, options = {}) {\n if (typeof plugin.install === \"function\") {\n plugin.install(this, options);\n }\n this._plugins.push(plugin);\n return this;\n }\n\n /**\n * Registers a component with the Eleva instance.\n *\n * @param {string} name - The name of the component.\n * @param {ComponentDefinition} definition - The component definition including setup, template, style, and children.\n * @returns {Eleva} The Eleva instance (for chaining).\n */\n component(name, definition) {\n this._components[name] = definition;\n return this;\n }\n\n /**\n * Mounts a registered component to a DOM element.\n *\n * @param {HTMLElement} container - A DOM element where the component will be mounted.\n * @param {string|ComponentDefinition} compName - The name of the component to mount or a component definition.\n * @param {Object<string, any>} [props={}] - Optional properties to pass to the component.\n * @returns {object|Promise<object>} An object representing the mounted component instance, or a Promise that resolves to it for asynchronous setups.\n * @throws {Error} If the container is not found or if the component is not registered.\n */\n mount(container, compName, props = {}) {\n if (!container) throw new Error(`Container not found: ${container}`);\n\n let definition;\n if (typeof compName === \"string\") {\n definition = this._components[compName];\n if (!definition)\n throw new Error(`Component \"${compName}\" not registered.`);\n } else if (typeof compName === \"object\") {\n definition = compName;\n } else {\n throw new Error(\"Invalid component parameter.\");\n }\n\n /**\n * Destructure the component definition to access core functionality.\n * - setup: Optional function for component initialization and state management\n * - template: Required function that returns the component's HTML structure\n * - style: Optional function for component-scoped CSS styles\n * - children: Optional object defining nested child components\n */\n const { setup, template, style, children } = definition;\n\n /**\n * Creates the initial context object for the component instance.\n * This context provides core functionality and will be merged with setup data.\n * @type {Object<string, any>}\n * @property {Object<string, any>} props - Component properties passed during mounting\n * @property {Emitter} emitter - Event emitter instance for component event handling\n * @property {function(any): Signal} signal - Factory function to create reactive Signal instances\n * @property {Object<string, function(): void>} ...lifecycleHooks - Prepared lifecycle hook functions\n */\n const context = {\n props,\n emitter: this.emitter,\n signal: (v) => new Signal(v),\n ...this._prepareLifecycleHooks(),\n };\n\n /**\n * Processes the mounting of the component.\n *\n * @param {Object<string, any>} data - Data returned from the component's setup function.\n * @returns {object} An object with the container, merged context data, and an unmount function.\n */\n const processMount = (data) => {\n const mergedContext = { ...context, ...data };\n const watcherUnsubscribers = [];\n const childInstances = [];\n\n if (!this._isMounted) {\n mergedContext.onBeforeMount && mergedContext.onBeforeMount();\n } else {\n mergedContext.onBeforeUpdate && mergedContext.onBeforeUpdate();\n }\n\n /**\n * Renders the component by parsing the template, patching the DOM,\n * processing events, injecting styles, and mounting child components.\n */\n const render = () => {\n const newHtml = TemplateEngine.parse(\n template(mergedContext),\n mergedContext\n );\n this.renderer.patchDOM(container, newHtml);\n this._processEvents(container, mergedContext);\n this._injectStyles(container, compName, style, mergedContext);\n this._mountChildren(container, children, childInstances);\n if (!this._isMounted) {\n mergedContext.onMount && mergedContext.onMount();\n this._isMounted = true;\n } else {\n mergedContext.onUpdate && mergedContext.onUpdate();\n }\n };\n\n /**\n * Sets up reactive watchers for all Signal instances in the component's data.\n * When a Signal's value changes, the component will re-render to reflect the updates.\n * Stores unsubscribe functions to clean up watchers when component unmounts.\n */\n Object.values(data).forEach((val) => {\n if (val instanceof Signal) watcherUnsubscribers.push(val.watch(render));\n });\n\n render();\n\n return {\n container,\n data: mergedContext,\n /**\n * Unmounts the component, cleaning up watchers, child components, and clearing the container.\n *\n * @returns {void}\n */\n unmount: () => {\n watcherUnsubscribers.forEach((fn) => fn());\n childInstances.forEach((child) => child.unmount());\n mergedContext.onUnmount && mergedContext.onUnmount();\n container.innerHTML = \"\";\n },\n };\n };\n\n // Handle asynchronous setup.\n return Promise.resolve(\n typeof setup === \"function\" ? setup(context) : {}\n ).then((data) => processMount(data));\n }\n\n /**\n * Prepares default no-operation lifecycle hook functions.\n *\n * @returns {Object<string, function(): void>} An object with keys for lifecycle hooks mapped to empty functions.\n * @private\n */\n _prepareLifecycleHooks() {\n return this._lifecycleHooks.reduce((acc, hook) => {\n acc[hook] = () => {};\n return acc;\n }, {});\n }\n\n /**\n * Processes DOM elements for event binding based on attributes starting with \"@\".\n *\n * @param {HTMLElement} container - The container element in which to search for events.\n * @param {Object<string, any>} context - The current context containing event handler definitions.\n * @private\n */\n _processEvents(container, context) {\n container.querySelectorAll(\"*\").forEach((el) => {\n [...el.attributes].forEach(({ name, value }) => {\n if (name.startsWith(\"@\")) {\n const event = name.slice(1);\n const handler = TemplateEngine.evaluate(value, context);\n if (typeof handler === \"function\") {\n el.addEventListener(event, handler);\n el.removeAttribute(name);\n }\n }\n });\n });\n }\n\n /**\n * Injects scoped styles into the component's container.\n *\n * @param {HTMLElement} container - The container element.\n * @param {string} compName - The component name used to identify the style element.\n * @param {function(Object<string, any>): string} [styleFn] - A function that returns CSS styles as a string.\n * @param {Object<string, any>} context - The current context for style interpolation.\n * @private\n */\n _injectStyles(container, compName, styleFn, context) {\n if (styleFn) {\n let styleEl = container.querySelector(\n `style[data-eleva-style=\"${compName}\"]`\n );\n if (!styleEl) {\n styleEl = document.createElement(\"style\");\n styleEl.setAttribute(\"data-eleva-style\", compName);\n container.appendChild(styleEl);\n }\n styleEl.textContent = TemplateEngine.parse(styleFn(context), context);\n }\n }\n\n /**\n * Mounts child components within the parent component's container.\n *\n * @param {HTMLElement} container - The parent container element.\n * @param {Object<string, ComponentDefinition>} [children] - An object mapping child component selectors to their definitions.\n * @param {Array<object>} childInstances - An array to store the mounted child component instances.\n * @private\n */\n _mountChildren(container, children, childInstances) {\n childInstances.forEach((child) => child.unmount());\n childInstances.length = 0;\n\n Object.keys(children || {}).forEach((childSelector) => {\n container.querySelectorAll(childSelector).forEach((childEl) => {\n const props = {};\n [...childEl.attributes].forEach(({ name, value }) => {\n if (name.startsWith(\"eleva-prop-\")) {\n props[name.slice(\"eleva-prop-\".length)] = value;\n }\n });\n const instance = this.mount(childEl, children[childSelector], props);\n childInstances.push(instance);\n });\n });\n }\n}\n"],"names":["TemplateEngine","parse","template","data","replace","_","expr","value","evaluate","undefined","keys","Object","values","result","Function","error","console","expression","message","Signal","constructor","_value","_watchers","Set","newVal","forEach","fn","watch","add","delete","Emitter","events","on","event","handler","push","off","filter","h","emit","args","Renderer","patchDOM","container","newHtml","tempContainer","document","createElement","innerHTML","diff","oldParent","newParent","oldNodes","Array","from","childNodes","newNodes","max","Math","length","i","oldNode","newNode","appendChild","cloneNode","removeChild","nodeType","Node","ELEMENT_NODE","oldKey","getAttribute","newKey","replaceChild","nodeName","TEXT_NODE","nodeValue","updateAttributes","oldEl","newEl","attributeToPropertyMap","checked","selected","disabled","attributes","attr","name","startsWith","hasAttribute","removeAttribute","setAttribute","Eleva","config","_components","_plugins","_lifecycleHooks","_isMounted","emitter","renderer","use","plugin","options","install","component","definition","mount","compName","props","Error","setup","style","children","context","signal","v","_prepareLifecycleHooks","processMount","mergedContext","watcherUnsubscribers","childInstances","onBeforeMount","onBeforeUpdate","render","_processEvents","_injectStyles","_mountChildren","onMount","onUpdate","val","unmount","child","onUnmount","Promise","resolve","then","reduce","acc","hook","querySelectorAll","el","slice","addEventListener","styleFn","styleEl","querySelector","textContent","childSelector","childEl","instance"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "eleva",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.2.0-alpha",
|
|
4
4
|
"description": "A minimalist and lightweight, pure vanilla JavaScript frontend runtime framework.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/eleva.js",
|
|
@@ -64,6 +64,7 @@
|
|
|
64
64
|
"url": "https://www.tarekraafat.com"
|
|
65
65
|
},
|
|
66
66
|
"license": "MIT",
|
|
67
|
+
"homepage": "https://tarekraafat.github.io/eleva",
|
|
67
68
|
"repository": {
|
|
68
69
|
"type": "git",
|
|
69
70
|
"url": "git+https://github.com/TarekRaafat/eleva.git"
|
package/src/core/Eleva.js
CHANGED
|
@@ -6,15 +6,27 @@ import { Emitter } from "../modules/Emitter.js";
|
|
|
6
6
|
import { Renderer } from "../modules/Renderer.js";
|
|
7
7
|
|
|
8
8
|
/**
|
|
9
|
+
* Defines the structure and behavior of a component.
|
|
9
10
|
* @typedef {Object} ComponentDefinition
|
|
10
11
|
* @property {function(Object<string, any>): (Object<string, any>|Promise<Object<string, any>>)} [setup]
|
|
11
|
-
*
|
|
12
|
+
* Optional setup function that initializes the component's reactive state and lifecycle.
|
|
13
|
+
* Receives props and context as an argument and should return an object containing the component's state.
|
|
14
|
+
* Can return either a synchronous object or a Promise that resolves to an object for async initialization.
|
|
15
|
+
*
|
|
12
16
|
* @property {function(Object<string, any>): string} template
|
|
13
|
-
*
|
|
17
|
+
* Required function that defines the component's HTML structure.
|
|
18
|
+
* Receives the merged context (props + setup data) and must return an HTML template string.
|
|
19
|
+
* Supports dynamic expressions using {{ }} syntax for reactive data binding.
|
|
20
|
+
*
|
|
14
21
|
* @property {function(Object<string, any>): string} [style]
|
|
15
|
-
*
|
|
22
|
+
* Optional function that defines component-scoped CSS styles.
|
|
23
|
+
* Receives the merged context and returns a CSS string that will be automatically scoped to the component.
|
|
24
|
+
* Styles are injected into the component's container and only affect elements within it.
|
|
25
|
+
*
|
|
16
26
|
* @property {Object<string, ComponentDefinition>} [children]
|
|
17
|
-
*
|
|
27
|
+
* Optional object that defines nested child components.
|
|
28
|
+
* Keys are CSS selectors that match elements in the template where child components should be mounted.
|
|
29
|
+
* Values are ComponentDefinition objects that define the structure and behavior of each child component.
|
|
18
30
|
*/
|
|
19
31
|
|
|
20
32
|
/**
|
|
@@ -30,15 +42,15 @@ export class Eleva {
|
|
|
30
42
|
* @param {Object<string, any>} [config={}] - Optional configuration for the instance.
|
|
31
43
|
*/
|
|
32
44
|
constructor(name, config = {}) {
|
|
33
|
-
/** @type {string} */
|
|
45
|
+
/** @type {string} The unique identifier name for this Eleva instance */
|
|
34
46
|
this.name = name;
|
|
35
|
-
/** @type {Object<string, any>} */
|
|
47
|
+
/** @type {Object<string, any>} Optional configuration object for the Eleva instance */
|
|
36
48
|
this.config = config;
|
|
37
|
-
/** @type {Object<string, ComponentDefinition>} */
|
|
49
|
+
/** @type {Object<string, ComponentDefinition>} Object storing registered component definitions by name */
|
|
38
50
|
this._components = {};
|
|
39
|
-
/** @
|
|
51
|
+
/** @private {Array<Object>} Collection of installed plugin instances */
|
|
40
52
|
this._plugins = [];
|
|
41
|
-
/** @private */
|
|
53
|
+
/** @private {string[]} Array of lifecycle hook names supported by the component */
|
|
42
54
|
this._lifecycleHooks = [
|
|
43
55
|
"onBeforeMount",
|
|
44
56
|
"onMount",
|
|
@@ -46,9 +58,11 @@ export class Eleva {
|
|
|
46
58
|
"onUpdate",
|
|
47
59
|
"onUnmount",
|
|
48
60
|
];
|
|
49
|
-
/** @private {boolean} */
|
|
61
|
+
/** @private {boolean} Flag indicating if component is currently mounted */
|
|
50
62
|
this._isMounted = false;
|
|
63
|
+
/** @private {Emitter} Instance of the event emitter for handling component events */
|
|
51
64
|
this.emitter = new Emitter();
|
|
65
|
+
/** @private {Renderer} Instance of the renderer for handling DOM updates and patching */
|
|
52
66
|
this.renderer = new Renderer();
|
|
53
67
|
}
|
|
54
68
|
|
|
@@ -102,11 +116,27 @@ export class Eleva {
|
|
|
102
116
|
throw new Error("Invalid component parameter.");
|
|
103
117
|
}
|
|
104
118
|
|
|
119
|
+
/**
|
|
120
|
+
* Destructure the component definition to access core functionality.
|
|
121
|
+
* - setup: Optional function for component initialization and state management
|
|
122
|
+
* - template: Required function that returns the component's HTML structure
|
|
123
|
+
* - style: Optional function for component-scoped CSS styles
|
|
124
|
+
* - children: Optional object defining nested child components
|
|
125
|
+
*/
|
|
105
126
|
const { setup, template, style, children } = definition;
|
|
127
|
+
|
|
128
|
+
/**
|
|
129
|
+
* Creates the initial context object for the component instance.
|
|
130
|
+
* This context provides core functionality and will be merged with setup data.
|
|
131
|
+
* @type {Object<string, any>}
|
|
132
|
+
* @property {Object<string, any>} props - Component properties passed during mounting
|
|
133
|
+
* @property {Emitter} emitter - Event emitter instance for component event handling
|
|
134
|
+
* @property {function(any): Signal} signal - Factory function to create reactive Signal instances
|
|
135
|
+
* @property {Object<string, function(): void>} ...lifecycleHooks - Prepared lifecycle hook functions
|
|
136
|
+
*/
|
|
106
137
|
const context = {
|
|
107
138
|
props,
|
|
108
|
-
|
|
109
|
-
on: this.emitter.on.bind(this.emitter),
|
|
139
|
+
emitter: this.emitter,
|
|
110
140
|
signal: (v) => new Signal(v),
|
|
111
141
|
...this._prepareLifecycleHooks(),
|
|
112
142
|
};
|
|
@@ -149,6 +179,11 @@ export class Eleva {
|
|
|
149
179
|
}
|
|
150
180
|
};
|
|
151
181
|
|
|
182
|
+
/**
|
|
183
|
+
* Sets up reactive watchers for all Signal instances in the component's data.
|
|
184
|
+
* When a Signal's value changes, the component will re-render to reflect the updates.
|
|
185
|
+
* Stores unsubscribe functions to clean up watchers when component unmounts.
|
|
186
|
+
*/
|
|
152
187
|
Object.values(data).forEach((val) => {
|
|
153
188
|
if (val instanceof Signal) watcherUnsubscribers.push(val.watch(render));
|
|
154
189
|
});
|
package/src/modules/Emitter.js
CHANGED
package/src/modules/Signal.js
CHANGED
|
@@ -13,7 +13,9 @@ export class Signal {
|
|
|
13
13
|
* @param {*} value - The initial value of the signal.
|
|
14
14
|
*/
|
|
15
15
|
constructor(value) {
|
|
16
|
+
/** @private {*} Internal storage for the signal's current value */
|
|
16
17
|
this._value = value;
|
|
18
|
+
/** @private {Set<function>} Collection of callback functions to be notified when value changes */
|
|
17
19
|
this._watchers = new Set();
|
|
18
20
|
}
|
|
19
21
|
|