eleva 1.0.0-alpha → 1.2.0-alpha

package/dist/eleva.min.js.map

@@ -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 * 🔒 TemplateEngine: Secure interpolation & dynamic attribute parsing.\n *\n * This class provides methods to parse template strings by replacing\n * interpolation expressions with dynamic data values and to evaluate expressions\n * 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} 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 an expression using the provided data context.\n   *\n   * @param {string} expr - The JavaScript expression to evaluate.\n   * @param {object} data - The data context for evaluating the expression.\n   * @returns {*} 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 = keys.map((k) => data[k]);\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 * ⚡ Signal: Fine-grained reactivity.\n *\n * A reactive data holder that notifies registered watchers when its value changes,\n * allowing for 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} fn - The callback function to invoke on value change.\n   * @returns {Function} 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 * 🎙️ Emitter: Robust inter-component communication with event bubbling.\n *\n * Implements a basic publish-subscribe pattern for event handling,\n * allowing components 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} 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} 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 {...*} 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 * 🎨 Renderer: Handles DOM patching, diffing, and attribute updates.\n *\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      // 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      // Remove old nodes not present in the new tree.\n      if (oldNode && !newNode) {\n        oldParent.removeChild(oldNode);\n        continue;\n      }\n\n      // 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      // 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      // 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      // 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 * 🧩 Eleva Core: Signal-based component runtime framework with lifecycle, scoped styles, and plugins.\n *\n * The Eleva class is the core of the framework. It manages component registration,\n * plugin integration, lifecycle hooks, 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} [config={}] - Optional configuration for the instance.\n   */\n  constructor(name, config = {}) {\n    this.name = name;\n    this.config = config;\n    this._components = {};\n    this._plugins = [];\n    this._lifecycleHooks = [\n      \"onBeforeMount\",\n      \"onMount\",\n      \"onBeforeUpdate\",\n      \"onUpdate\",\n      \"onUnmount\",\n    ];\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} [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 {object} 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 {string|HTMLElement} selectorOrElement - A CSS selector string or DOM element where the component will be mounted.\n   * @param {string} compName - The name of the component to mount.\n   * @param {object} [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 Will throw an error if the container or component is not found.\n   */\n  mount(selectorOrElement, compName, props = {}) {\n    const container =\n      typeof selectorOrElement === \"string\"\n        ? document.querySelector(selectorOrElement)\n        : selectorOrElement;\n    if (!container)\n      throw new Error(`Container not found: ${selectorOrElement}`);\n\n    const definition = this._components[compName];\n    if (!definition) throw new Error(`Component \"${compName}\" not registered.`);\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} 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        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 if needed.\n    const setupResult = setup(context);\n    if (setupResult && typeof setupResult.then === \"function\") {\n      return setupResult.then((data) => processMount(data));\n    } else {\n      const data = setupResult || {};\n      return processMount(data);\n    }\n  }\n\n  /**\n   * Prepares default no-operation lifecycle hook functions.\n   *\n   * @returns {object} 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} 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} styleFn - A function that returns CSS styles as a string.\n   * @param {object} 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} children - An object mapping child component selectors to their definitions.\n   * @param {Array} 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((childName) => {\n      container.querySelectorAll(childName).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, childName, props);\n        childInstances.push(instance);\n      });\n    });\n  }\n}\n"],"names":["TemplateEngine","parse","template","data","replace","_","expr","value","this","evaluate","undefined","keys","Object","values","map","k","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","selectorOrElement","compName","props","querySelector","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","setupResult","then","reduce","acc","hook","querySelectorAll","el","slice","addEventListener","styleFn","styleEl","textContent","childName","childEl","instance"],"mappings":"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"}
+{"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

@@ -5,18 +5,17 @@
 })(this, (function () { 'use strict';
 
   /**
-   * 🔒 TemplateEngine: Secure interpolation & dynamic attribute parsing.
-   *
-   * This class provides methods to parse template strings by replacing
-   * interpolation expressions with dynamic data values and to evaluate expressions
-   * within a given data context.
+   * @class 🔒 TemplateEngine
+   * @classdesc Secure interpolation & dynamic attribute parsing.
+   * Provides methods to parse template strings by replacing interpolation expressions
+   * with dynamic data values and to evaluate expressions within a given data context.
    */
   class TemplateEngine {
     /**
      * Parses a template string and replaces interpolation expressions with corresponding values.
      *
-     * @param {string} template - The template string containing expressions in the format {{ expression }}.
-     * @param {object} data - The data object to use for evaluating expressions.
+     * @param {string} template - The template string containing expressions in the format `{{ expression }}`.
+     * @param {Object<string, any>} data - The data object to use for evaluating expressions.
      * @returns {string} The resulting string with evaluated values.
      */
     static parse(template, data) {
@@ -27,16 +26,16 @@
     }
 
     /**
-     * Evaluates an expression using the provided data context.
+     * Evaluates a JavaScript expression using the provided data context.
      *
      * @param {string} expr - The JavaScript expression to evaluate.
-     * @param {object} data - The data context for evaluating the expression.
-     * @returns {*} The result of the evaluated expression, or an empty string if undefined or on error.
+     * @param {Object<string, any>} data - The data context for evaluating the expression.
+     * @returns {any} The result of the evaluated expression, or an empty string if undefined or on error.
      */
     static evaluate(expr, data) {
       try {
         const keys = Object.keys(data);
-        const values = keys.map(k => data[k]);
+        const values = Object.values(data);
         const result = new Function(...keys, `return ${expr}`)(...values);
         return result === undefined ? "" : result;
       } catch (error) {
@@ -51,10 +50,10 @@
   }
 
   /**
-   * ⚡ Signal: Fine-grained reactivity.
-   *
+   * @class ⚡ Signal
+   * @classdesc Fine-grained reactivity.
    * A reactive data holder that notifies registered watchers when its value changes,
-   * allowing for fine-grained DOM patching rather than full re-renders.
+   * enabling fine-grained DOM patching rather than full re-renders.
    */
   class Signal {
     /**
@@ -63,7 +62,9 @@
      * @param {*} value - The initial value of the signal.
      */
     constructor(value) {
+      /** @private {*} Internal storage for the signal's current value */
       this._value = value;
+      /** @private {Set<function>} Collection of callback functions to be notified when value changes */
       this._watchers = new Set();
     }
 
@@ -91,8 +92,8 @@
     /**
      * Registers a watcher function that will be called whenever the signal's value changes.
      *
-     * @param {Function} fn - The callback function to invoke on value change.
-     * @returns {Function} A function to unsubscribe the watcher.
+     * @param {function(any): void} fn - The callback function to invoke on value change.
+     * @returns {function(): boolean} A function to unsubscribe the watcher.
      */
     watch(fn) {
       this._watchers.add(fn);
@@ -101,17 +102,17 @@
   }
 
   /**
-   * 🎙️ Emitter: Robust inter-component communication with event bubbling.
-   *
-   * Implements a basic publish-subscribe pattern for event handling,
-   * allowing components to communicate through custom events.
+   * @class 🎙️ Emitter
+   * @classdesc Robust inter-component communication with event bubbling.
+   * Implements a basic publish-subscribe pattern for event handling, allowing components
+   * to communicate through custom events.
    */
   class Emitter {
     /**
      * Creates a new Emitter instance.
      */
     constructor() {
-      /** @type {Object.<string, Function[]>} */
+      /** @type {Object.<string, Function[]>} Storage for event handlers mapped by event name */
       this.events = {};
     }
 
@@ -119,7 +120,7 @@
      * Registers an event handler for the specified event.
      *
      * @param {string} event - The name of the event.
-     * @param {Function} handler - The function to call when the event is emitted.
+     * @param {function(...any): void} handler - The function to call when the event is emitted.
      */
     on(event, handler) {
       (this.events[event] || (this.events[event] = [])).push(handler);
@@ -129,7 +130,7 @@
      * Removes a previously registered event handler.
      *
      * @param {string} event - The name of the event.
-     * @param {Function} handler - The handler function to remove.
+     * @param {function(...any): void} handler - The handler function to remove.
      */
     off(event, handler) {
       if (this.events[event]) {
@@ -141,7 +142,7 @@
      * Emits an event, invoking all handlers registered for that event.
      *
      * @param {string} event - The event name.
-     * @param {...*} args - Additional arguments to pass to the event handlers.
+     * @param {...any} args - Additional arguments to pass to the event handlers.
      */
     emit(event, ...args) {
       (this.events[event] || []).forEach(handler => handler(...args));
@@ -149,8 +150,8 @@
   }
 
   /**
-   * 🎨 Renderer: Handles DOM patching, diffing, and attribute updates.
-   *
+   * @class 🎨 Renderer
+   * @classdesc Handles DOM patching, diffing, and attribute updates.
    * Provides methods for efficient DOM updates by diffing the new and old DOM structures
    * and applying only the necessary changes.
    */
@@ -181,18 +182,18 @@
         const oldNode = oldNodes[i];
         const newNode = newNodes[i];
 
-        // Append new nodes that don't exist in the old tree.
+        // Case 1: Append new nodes that don't exist in the old tree.
         if (!oldNode && newNode) {
           oldParent.appendChild(newNode.cloneNode(true));
           continue;
         }
-        // Remove old nodes not present in the new tree.
+        // Case 2: Remove old nodes not present in the new tree.
         if (oldNode && !newNode) {
           oldParent.removeChild(oldNode);
           continue;
         }
 
-        // For element nodes, compare keys if available.
+        // Case 3: For element nodes, compare keys if available.
         if (oldNode.nodeType === Node.ELEMENT_NODE && newNode.nodeType === Node.ELEMENT_NODE) {
           const oldKey = oldNode.getAttribute("key");
           const newKey = newNode.getAttribute("key");
@@ -204,19 +205,19 @@
           }
         }
 
-        // Replace nodes if types or tag names differ.
+        // Case 4: Replace nodes if types or tag names differ.
         if (oldNode.nodeType !== newNode.nodeType || oldNode.nodeName !== newNode.nodeName) {
           oldParent.replaceChild(newNode.cloneNode(true), oldNode);
           continue;
         }
-        // For text nodes, update content if different.
+        // Case 5: For text nodes, update content if different.
         if (oldNode.nodeType === Node.TEXT_NODE) {
           if (oldNode.nodeValue !== newNode.nodeValue) {
             oldNode.nodeValue = newNode.nodeValue;
           }
           continue;
         }
-        // For element nodes, update attributes and then diff children.
+        // Case 6: For element nodes, update attributes and then diff children.
         if (oldNode.nodeType === Node.ELEMENT_NODE) {
           this.updateAttributes(oldNode, newNode);
           this.diff(oldNode, newNode);
@@ -261,34 +262,65 @@
   }
 
   /**
-   * 🧩 Eleva Core: Signal-based component runtime framework with lifecycle, scoped styles, and plugins.
+   * Defines the structure and behavior of a component.
+   * @typedef {Object} ComponentDefinition
+   * @property {function(Object<string, any>): (Object<string, any>|Promise<Object<string, any>>)} [setup]
+   *           Optional setup function that initializes the component's reactive state and lifecycle.
+   *           Receives props and context as an argument and should return an object containing the component's state.
+   *           Can return either a synchronous object or a Promise that resolves to an object for async initialization.
+   *
+   * @property {function(Object<string, any>): string} template
+   *           Required function that defines the component's HTML structure.
+   *           Receives the merged context (props + setup data) and must return an HTML template string.
+   *           Supports dynamic expressions using {{ }} syntax for reactive data binding.
+   *
+   * @property {function(Object<string, any>): string} [style]
+   *           Optional function that defines component-scoped CSS styles.
+   *           Receives the merged context and returns a CSS string that will be automatically scoped to the component.
+   *           Styles are injected into the component's container and only affect elements within it.
    *
-   * The Eleva class is the core of the framework. It manages component registration,
-   * plugin integration, lifecycle hooks, event handling, and DOM rendering.
+   * @property {Object<string, ComponentDefinition>} [children]
+   *           Optional object that defines nested child components.
+   *           Keys are CSS selectors that match elements in the template where child components should be mounted.
+   *           Values are ComponentDefinition objects that define the structure and behavior of each child component.
+   */
+
+  /**
+   * @class 🧩 Eleva
+   * @classdesc Signal-based component runtime framework with lifecycle hooks, scoped styles, and plugin support.
+   * Manages component registration, plugin integration, event handling, and DOM rendering.
    */
   class Eleva {
     /**
      * Creates a new Eleva instance.
      *
      * @param {string} name - The name of the Eleva instance.
-     * @param {object} [config={}] - Optional configuration for the instance.
+     * @param {Object<string, any>} [config={}] - Optional configuration for the instance.
      */
     constructor(name, config = {}) {
+      /** @type {string} The unique identifier name for this Eleva instance */
       this.name = name;
+      /** @type {Object<string, any>} Optional configuration object for the Eleva instance */
       this.config = config;
+      /** @type {Object<string, ComponentDefinition>} Object storing registered component definitions by name */
       this._components = {};
+      /** @private {Array<Object>} Collection of installed plugin instances */
       this._plugins = [];
+      /** @private {string[]} Array of lifecycle hook names supported by the component */
       this._lifecycleHooks = ["onBeforeMount", "onMount", "onBeforeUpdate", "onUpdate", "onUnmount"];
+      /** @private {boolean} Flag indicating if component is currently mounted */
       this._isMounted = false;
+      /** @private {Emitter} Instance of the event emitter for handling component events */
       this.emitter = new Emitter();
+      /** @private {Renderer} Instance of the renderer for handling DOM updates and patching */
       this.renderer = new Renderer();
     }
 
     /**
      * Integrates a plugin with the Eleva framework.
      *
-     * @param {object} [plugin] - The plugin object which should have an install function.
-     * @param {object} [options={}] - Optional options to pass to the plugin.
+     * @param {Object} plugin - The plugin object which should have an `install` function.
+     * @param {Object<string, any>} [options={}] - Optional options to pass to the plugin.
      * @returns {Eleva} The Eleva instance (for chaining).
      */
     use(plugin, options = {}) {
@@ -303,7 +335,7 @@
      * Registers a component with the Eleva instance.
      *
      * @param {string} name - The name of the component.
-     * @param {object} definition - The component definition including setup, template, style, and children.
+     * @param {ComponentDefinition} definition - The component definition including setup, template, style, and children.
      * @returns {Eleva} The Eleva instance (for chaining).
      */
     component(name, definition) {
@@ -314,27 +346,50 @@
     /**
      * Mounts a registered component to a DOM element.
      *
-     * @param {string|HTMLElement} selectorOrElement - A CSS selector string or DOM element where the component will be mounted.
-     * @param {string} compName - The name of the component to mount.
-     * @param {object} [props={}] - Optional properties to pass to the component.
+     * @param {HTMLElement} container - A DOM element where the component will be mounted.
+     * @param {string|ComponentDefinition} compName - The name of the component to mount or a component definition.
+     * @param {Object<string, any>} [props={}] - Optional properties to pass to the component.
      * @returns {object|Promise<object>} An object representing the mounted component instance, or a Promise that resolves to it for asynchronous setups.
-     * @throws Will throw an error if the container or component is not found.
+     * @throws {Error} If the container is not found or if the component is not registered.
      */
-    mount(selectorOrElement, compName, props = {}) {
-      const container = typeof selectorOrElement === "string" ? document.querySelector(selectorOrElement) : selectorOrElement;
-      if (!container) throw new Error(`Container not found: ${selectorOrElement}`);
-      const definition = this._components[compName];
-      if (!definition) throw new Error(`Component "${compName}" not registered.`);
+    mount(container, compName, props = {}) {
+      if (!container) throw new Error(`Container not found: ${container}`);
+      let definition;
+      if (typeof compName === "string") {
+        definition = this._components[compName];
+        if (!definition) throw new Error(`Component "${compName}" not registered.`);
+      } else if (typeof compName === "object") {
+        definition = compName;
+      } else {
+        throw new Error("Invalid component parameter.");
+      }
+
+      /**
+       * Destructure the component definition to access core functionality.
+       * - setup: Optional function for component initialization and state management
+       * - template: Required function that returns the component's HTML structure
+       * - style: Optional function for component-scoped CSS styles
+       * - children: Optional object defining nested child components
+       */
       const {
         setup,
         template,
         style,
         children
       } = definition;
+
+      /**
+       * Creates the initial context object for the component instance.
+       * This context provides core functionality and will be merged with setup data.
+       * @type {Object<string, any>}
+       * @property {Object<string, any>} props - Component properties passed during mounting
+       * @property {Emitter} emitter - Event emitter instance for component event handling
+       * @property {function(any): Signal} signal - Factory function to create reactive Signal instances
+       * @property {Object<string, function(): void>} ...lifecycleHooks - Prepared lifecycle hook functions
+       */
       const context = {
         props,
-        emit: this.emitter.emit.bind(this.emitter),
-        on: this.emitter.on.bind(this.emitter),
+        emitter: this.emitter,
         signal: v => new Signal(v),
         ...this._prepareLifecycleHooks()
       };
@@ -342,7 +397,7 @@
       /**
        * Processes the mounting of the component.
        *
-       * @param {object} data - Data returned from the component's setup function.
+       * @param {Object<string, any>} data - Data returned from the component's setup function.
        * @returns {object} An object with the container, merged context data, and an unmount function.
        */
       const processMount = data => {
@@ -375,6 +430,12 @@
             mergedContext.onUpdate && mergedContext.onUpdate();
           }
         };
+
+        /**
+         * Sets up reactive watchers for all Signal instances in the component's data.
+         * When a Signal's value changes, the component will re-render to reflect the updates.
+         * Stores unsubscribe functions to clean up watchers when component unmounts.
+         */
         Object.values(data).forEach(val => {
           if (val instanceof Signal) watcherUnsubscribers.push(val.watch(render));
         });
@@ -384,6 +445,8 @@
           data: mergedContext,
           /**
            * Unmounts the component, cleaning up watchers, child components, and clearing the container.
+           *
+           * @returns {void}
            */
           unmount: () => {
             watcherUnsubscribers.forEach(fn => fn());
@@ -394,20 +457,14 @@
         };
       };
 
-      // Handle asynchronous setup if needed.
-      const setupResult = setup(context);
-      if (setupResult && typeof setupResult.then === "function") {
-        return setupResult.then(data => processMount(data));
-      } else {
-        const data = setupResult || {};
-        return processMount(data);
-      }
+      // Handle asynchronous setup.
+      return Promise.resolve(typeof setup === "function" ? setup(context) : {}).then(data => processMount(data));
     }
 
     /**
      * Prepares default no-operation lifecycle hook functions.
      *
-     * @returns {object} An object with keys for lifecycle hooks mapped to empty functions.
+     * @returns {Object<string, function(): void>} An object with keys for lifecycle hooks mapped to empty functions.
      * @private
      */
     _prepareLifecycleHooks() {
@@ -421,7 +478,7 @@
      * Processes DOM elements for event binding based on attributes starting with "@".
      *
      * @param {HTMLElement} container - The container element in which to search for events.
-     * @param {object} context - The current context containing event handler definitions.
+     * @param {Object<string, any>} context - The current context containing event handler definitions.
      * @private
      */
     _processEvents(container, context) {
@@ -447,8 +504,8 @@
      *
      * @param {HTMLElement} container - The container element.
      * @param {string} compName - The component name used to identify the style element.
-     * @param {Function} styleFn - A function that returns CSS styles as a string.
-     * @param {object} context - The current context for style interpolation.
+     * @param {function(Object<string, any>): string} [styleFn] - A function that returns CSS styles as a string.
+     * @param {Object<string, any>} context - The current context for style interpolation.
      * @private
      */
     _injectStyles(container, compName, styleFn, context) {
@@ -467,15 +524,15 @@
      * Mounts child components within the parent component's container.
      *
      * @param {HTMLElement} container - The parent container element.
-     * @param {object} children - An object mapping child component selectors to their definitions.
-     * @param {Array} childInstances - An array to store the mounted child component instances.
+     * @param {Object<string, ComponentDefinition>} [children] - An object mapping child component selectors to their definitions.
+     * @param {Array<object>} childInstances - An array to store the mounted child component instances.
      * @private
      */
     _mountChildren(container, children, childInstances) {
       childInstances.forEach(child => child.unmount());
       childInstances.length = 0;
-      Object.keys(children || {}).forEach(childName => {
-        container.querySelectorAll(childName).forEach(childEl => {
+      Object.keys(children || {}).forEach(childSelector => {
+        container.querySelectorAll(childSelector).forEach(childEl => {
           const props = {};
           [...childEl.attributes].forEach(({
             name,
@@ -485,7 +542,7 @@
               props[name.slice("eleva-prop-".length)] = value;
             }
           });
-          const instance = this.mount(childEl, childName, props);
+          const instance = this.mount(childEl, children[childSelector], props);
           childInstances.push(instance);
         });
       });