eleva 0.1.0-alpha → 1.1.0-alpha

package/types/modules/Emitter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @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.
+ */
+export class Emitter {
+    /** @type {Object.<string, Function[]>} */
+    events: {
+        [x: string]: Function[];
+    };
+    /**
+     * Registers an event handler for the specified event.
+     *
+     * @param {string} event - The name of the event.
+     * @param {function(...any): void} handler - The function to call when the event is emitted.
+     */
+    on(event: string, handler: (...args: any[]) => void): void;
+    /**
+     * Removes a previously registered event handler.
+     *
+     * @param {string} event - The name of the event.
+     * @param {function(...any): void} handler - The handler function to remove.
+     */
+    off(event: string, handler: (...args: any[]) => void): void;
+    /**
+     * Emits an event, invoking all handlers registered for that event.
+     *
+     * @param {string} event - The event name.
+     * @param {...any} args - Additional arguments to pass to the event handlers.
+     */
+    emit(event: string, ...args: any[]): void;
+}
+//# sourceMappingURL=Emitter.d.ts.map

package/types/modules/Emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Emitter.d.ts","sourceRoot":"","sources":["../../src/modules/Emitter.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH;IAKI,0CAA0C;IAC1C;;MAAgB;IAGlB;;;;;OAKG;IACH,UAHW,MAAM,WACN,IAAS,IAAM,EAAH,GAAG,EAAA,KAAG,IAAI,QAIhC;IAED;;;;;OAKG;IACH,WAHW,MAAM,WACN,IAAS,IAAM,EAAH,GAAG,EAAA,KAAG,IAAI,QAMhC;IAED;;;;;OAKG;IACH,YAHW,MAAM,WACH,GAAG,EAAA,QAIhB;CACF"}

package/types/modules/Renderer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @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.
+ */
+export class Renderer {
+    /**
+     * Patches the DOM of a container element with new HTML content.
+     *
+     * @param {HTMLElement} container - The container element to patch.
+     * @param {string} newHtml - The new HTML content to apply.
+     */
+    patchDOM(container: HTMLElement, newHtml: string): void;
+    /**
+     * Diffs two DOM trees (old and new) and applies updates to the old DOM.
+     *
+     * @param {HTMLElement} oldParent - The original DOM element.
+     * @param {HTMLElement} newParent - The new DOM element.
+     */
+    diff(oldParent: HTMLElement, newParent: HTMLElement): void;
+    /**
+     * Updates the attributes of an element to match those of a new element.
+     *
+     * @param {HTMLElement} oldEl - The element to update.
+     * @param {HTMLElement} newEl - The element providing the updated attributes.
+     */
+    updateAttributes(oldEl: HTMLElement, newEl: HTMLElement): void;
+}
+//# sourceMappingURL=Renderer.d.ts.map

package/types/modules/Renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Renderer.d.ts","sourceRoot":"","sources":["../../src/modules/Renderer.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH;IACE;;;;;OAKG;IACH,oBAHW,WAAW,WACX,MAAM,QAMhB;IAED;;;;;OAKG;IACH,gBAHW,WAAW,aACX,WAAW,QAyDrB;IAED;;;;;OAKG;IACH,wBAHW,WAAW,SACX,WAAW,QA6BrB;CACF"}

package/types/modules/Signal.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @class ⚡ Signal
+ * @classdesc Fine-grained reactivity.
+ * A reactive data holder that notifies registered watchers when its value changes,
+ * enabling fine-grained DOM patching rather than full re-renders.
+ */
+export class Signal {
+    /**
+     * Creates a new Signal instance.
+     *
+     * @param {*} value - The initial value of the signal.
+     */
+    constructor(value: any);
+    _value: any;
+    _watchers: Set<any>;
+    /**
+     * Sets a new value for the signal and notifies all registered watchers if the value has changed.
+     *
+     * @param {*} newVal - The new value to set.
+     */
+    set value(newVal: any);
+    /**
+     * Gets the current value of the signal.
+     *
+     * @returns {*} The current value.
+     */
+    get value(): any;
+    /**
+     * Registers a watcher function that will be called whenever the signal's value changes.
+     *
+     * @param {function(any): void} fn - The callback function to invoke on value change.
+     * @returns {function(): boolean} A function to unsubscribe the watcher.
+     */
+    watch(fn: (arg0: any) => void): () => boolean;
+}
+//# sourceMappingURL=Signal.d.ts.map

package/types/modules/Signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Signal.d.ts","sourceRoot":"","sources":["../../src/modules/Signal.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH;IACE;;;;OAIG;IACH,mBAFW,GAAC,EAKX;IAFC,YAAmB;IACnB,oBAA0B;IAY5B;;;;OAIG;IACH,kBAFW,GAAC,EAOX;IAnBD;;;;OAIG;IACH,aAFa,GAAC,CAIb;IAcD;;;;;OAKG;IACH,UAHW,CAAS,IAAG,EAAH,GAAG,KAAG,IAAI,GACjB,MAAY,OAAO,CAK/B;CACF"}

package/types/modules/TemplateEngine.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @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.
+ */
+export 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<string, any>} data - The data object to use for evaluating expressions.
+     * @returns {string} The resulting string with evaluated values.
+     */
+    static parse(template: string, data: {
+        [x: string]: any;
+    }): string;
+    /**
+     * Evaluates a JavaScript expression using the provided data context.
+     *
+     * @param {string} expr - The JavaScript expression to evaluate.
+     * @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: string, data: {
+        [x: string]: any;
+    }): any;
+}
+//# sourceMappingURL=TemplateEngine.d.ts.map

package/types/modules/TemplateEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateEngine.d.ts","sourceRoot":"","sources":["../../src/modules/TemplateEngine.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH;IACE;;;;;;OAMG;IACH,uBAJW,MAAM;;QAEJ,MAAM,CAOlB;IAED;;;;;;OAMG;IACH,sBAJW,MAAM;;QAEJ,GAAG,CAgBf;CACF"}