eleva 1.0.0-rc.6 → 1.0.0-rc.9

package/src/plugins/index.js

@@ -22,14 +22,19 @@
  *
  * @example
  * // Import multiple plugins
- * import { Attr, Router } from 'eleva/plugins';
+ * import { Attr, Router, Store } from 'eleva/plugins';
  *
  * const app = new Eleva("myApp");
  * app.use(Attr);
  * app.use(Router);
+ * app.use(Store, {
+ *   state: { counter: 0 },
+ *   actions: { increment: (state) => state.counter.value++ }
+ * });
  */
 
 // Export plugins with clean names
 export { AttrPlugin as Attr } from "./Attr.js";
 export { RouterPlugin as Router } from "./Router.js";
 export { PropsPlugin as Props } from "./Props.js";
+export { StorePlugin as Store } from "./Store.js";

package/types/core/Eleva.d.ts

@@ -121,14 +121,14 @@ export class Eleva {
     public emitter: Emitter;
     /** @public {typeof Signal} Static reference to the Signal class for creating reactive state */
     public signal: typeof Signal;
+    /** @public {typeof TemplateEngine} Static reference to the TemplateEngine class for template parsing */
+    public templateEngine: typeof TemplateEngine;
     /** @public {Renderer} Instance of the renderer for handling DOM updates and patching */
     public renderer: Renderer;
     /** @private {Map<string, ComponentDefinition>} Registry of all component definitions by name */
     private _components;
     /** @private {Map<string, ElevaPlugin>} Collection of installed plugin instances by name */
     private _plugins;
-    /** @private {boolean} Flag indicating if the root component is currently mounted */
-    private _isMounted;
     /** @private {number} Counter for generating unique component IDs */
     private _componentCounter;
     /**
@@ -136,12 +136,23 @@ export class Eleva {
      * The plugin's install function will be called with the Eleva instance and provided options.
      * After installation, the plugin will be available for use by components.
      *
+     * Note: Plugins that wrap core methods (e.g., mount) must be uninstalled in reverse order
+     * of installation (LIFO - Last In, First Out) to avoid conflicts.
+     *
      * @public
      * @param {ElevaPlugin} plugin - The plugin object which must have an `install` function.
      * @param {Object<string, unknown>} [options={}] - Optional configuration options for the plugin.
      * @returns {Eleva} The Eleva instance (for method chaining).
      * @example
      * app.use(myPlugin, { option1: "value1" });
+     *
+     * @example
+     * // Correct uninstall order (LIFO)
+     * app.use(PluginA);
+     * app.use(PluginB);
+     * // Uninstall in reverse order:
+     * PluginB.uninstall(app);
+     * PluginA.uninstall(app);
      */
     public use(plugin: ElevaPlugin, options?: {
         [x: string]: unknown;
@@ -350,5 +361,6 @@ export type ElevaPlugin = {
 };
 import { Emitter } from "../modules/Emitter.js";
 import { Signal } from "../modules/Signal.js";
+import { TemplateEngine } from "../modules/TemplateEngine.js";
 import { Renderer } from "../modules/Renderer.js";
 //# sourceMappingURL=Eleva.d.ts.map

package/types/core/Eleva.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Eleva.d.ts","sourceRoot":"","sources":["../../src/core/Eleva.js"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;GAMG;AAEH;;;;;;;;;;;;GAYG;AAEH;;;;;;;;GAQG;AAEH;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;IACE;;;;;;;;;;;;;;;;;;OAkBG;IACH,kBAfW,MAAM,WACN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAkCjC;IAnBC,0EAA0E;IAC1E,oBAAgB;IAChB,6FAA6F;IAC7F,uCAAoB;IACpB,oFAAoF;IACpF,wBAA4B;IAC5B,+FAA+F;IAC/F,6BAAoB;IACpB,wFAAwF;IACxF,0BAA8B;IAE9B,gGAAgG;IAChG,oBAA4B;IAC5B,2FAA2F;IAC3F,iBAAyB;IACzB,oFAAoF;IACpF,mBAAuB;IACvB,oEAAoE;IACpE,0BAA0B;IAG5B;;;;;;;;;;;OAWG;IACH,mBANW,WAAW;;QAET,KAAK,CASjB;IAED;;;;;;;;;;;;;;OAcG;IACH,uBAVW,MAAM,cACN,mBAAmB,GACjB,KAAK,CAYjB;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,wBAdW,WAAW,YACX,MAAM,GAAC,mBAAmB;;QAExB,OAAO,CAAC,WAAW,CAAC,CA+JhC;IAED;;;;;;;;;OASG;IACH,uBA0BC;IAED;;;;;;;;;;OAUG;IACH,sBAkBC;IAED;;;;;;;;;;;OAWG;IACH,sBAeC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,yBAcC;CACF;;;;;oBAnesB,gBAAgB,KAAG,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;;;;cAEtF,CAAC,CAAS,IAAgB,EAAhB,gBAAgB,KAAG,MAAM,GAAC,OAAO,CAAC,MAAM,CAAC,CAAC;;;;6BAE1C,gBAAgB,KAAG,MAAM;;;;;;;;;;WAQnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;aAEvB,OAAO;;;;;;;;;4BAIE,oBAAoB,KAAG,OAAO,CAAC,IAAI,CAAC;;;;sBAEpC,oBAAoB,KAAG,OAAO,CAAC,IAAI,CAAC;;;;6BAEpC,oBAAoB,KAAG,OAAO,CAAC,IAAI,CAAC;;;;uBAEpC,oBAAoB,KAAG,OAAO,CAAC,IAAI,CAAC;;;;wBAEpC,kBAAkB,KAAG,OAAO,CAAC,IAAI,CAAC;;;;;;eAM3C,WAAW;;;;aAEX,gBAAgB;;;;;;eAMhB,WAAW;;;;aAEX,gBAAgB;;;;aAEhB;QACT,QAAQ,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QAC5B,SAAS,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QAC7B,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAA;KAC7B;;;;;;eAMU,WAAW;;;;UAEX,gBAAgB;;;;aAEhB,MAAY,OAAO,CAAC,IAAI,CAAC;;;;;;aAMzB,CAAS,IAAK,EAAL,KAAK,EAAE,IAAuB,EAAvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;;;;UAE9C,MAAM;;wBAvEI,uBAAuB;uBADxB,sBAAsB;yBAEpB,wBAAwB"}
+{"version":3,"file":"Eleva.d.ts","sourceRoot":"","sources":["../../src/core/Eleva.js"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;GAMG;AAEH;;;;;;;;;;;;GAYG;AAEH;;;;;;;;GAQG;AAEH;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;IACE;;;;;;;;;;;;;;;;;;OAkBG;IACH,kBAfW,MAAM,WACN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAkCjC;IAnBC,0EAA0E;IAC1E,oBAAgB;IAChB,6FAA6F;IAC7F,uCAAoB;IACpB,oFAAoF;IACpF,wBAA4B;IAC5B,+FAA+F;IAC/F,6BAAoB;IACpB,wGAAwG;IACxG,6CAAoC;IACpC,wFAAwF;IACxF,0BAA8B;IAE9B,gGAAgG;IAChG,oBAA4B;IAC5B,2FAA2F;IAC3F,iBAAyB;IACzB,oEAAoE;IACpE,0BAA0B;IAG5B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,mBAdW,WAAW;;QAET,KAAK,CAiBjB;IAED;;;;;;;;;;;;;;OAcG;IACH,uBAVW,MAAM,cACN,mBAAmB,GACjB,KAAK,CAYjB;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,wBAdW,WAAW,YACX,MAAM,GAAC,mBAAmB;;QAExB,OAAO,CAAC,WAAW,CAAC,CAkKhC;IAED;;;;;;;;;OASG;IACH,uBA2BC;IAED;;;;;;;;;;OAUG;IACH,sBAkBC;IAED;;;;;;;;;;;OAWG;IACH,sBAeC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,yBAcC;CACF;;;;;oBAlfsB,gBAAgB,KAAG,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;;;;cAEtF,CAAC,CAAS,IAAgB,EAAhB,gBAAgB,KAAG,MAAM,GAAC,OAAO,CAAC,MAAM,CAAC,CAAC;;;;6BAE1C,gBAAgB,KAAG,MAAM;;;;;;;;;;WAQnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;aAEvB,OAAO;;;;;;;;;4BAIE,oBAAoB,KAAG,OAAO,CAAC,IAAI,CAAC;;;;sBAEpC,oBAAoB,KAAG,OAAO,CAAC,IAAI,CAAC;;;;6BAEpC,oBAAoB,KAAG,OAAO,CAAC,IAAI,CAAC;;;;uBAEpC,oBAAoB,KAAG,OAAO,CAAC,IAAI,CAAC;;;;wBAEpC,kBAAkB,KAAG,OAAO,CAAC,IAAI,CAAC;;;;;;eAM3C,WAAW;;;;aAEX,gBAAgB;;;;;;eAMhB,WAAW;;;;aAEX,gBAAgB;;;;aAEhB;QACT,QAAQ,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QAC5B,SAAS,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QAC7B,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAA;KAC7B;;;;;;eAMU,WAAW;;;;UAEX,gBAAgB;;;;aAEhB,MAAY,OAAO,CAAC,IAAI,CAAC;;;;;;aAMzB,CAAS,IAAK,EAAL,KAAK,EAAE,IAAuB,EAAvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;;;;UAE9C,MAAM;;wBAvEI,uBAAuB;uBADxB,sBAAsB;+BADd,8BAA8B;yBAGpC,wBAAwB"}

package/types/plugins/Store.d.ts

@@ -0,0 +1,86 @@
+export namespace StorePlugin {
+    let name: string;
+    let version: string;
+    let description: string;
+    /**
+     * Installs the plugin into the Eleva instance
+     *
+     * @param {Object} eleva - The Eleva instance
+     * @param {Object} options - Plugin configuration options
+     * @param {Object} [options.state={}] - Initial state object
+     * @param {Object} [options.actions={}] - Action functions for state mutations
+     * @param {Object} [options.namespaces={}] - Namespaced modules for organizing store
+     * @param {Object} [options.persistence] - Persistence configuration
+     * @param {boolean} [options.persistence.enabled=false] - Enable state persistence
+     * @param {string} [options.persistence.key="eleva-store"] - Storage key
+     * @param {"localStorage" | "sessionStorage"} [options.persistence.storage="localStorage"] - Storage type
+     * @param {Array<string>} [options.persistence.include] - State keys to persist (if not provided, all state is persisted)
+     * @param {Array<string>} [options.persistence.exclude] - State keys to exclude from persistence
+     * @param {boolean} [options.devTools=false] - Enable development tools integration
+     * @param {Function} [options.onError=null] - Error handler function
+     *
+     * @example
+     * // Basic installation
+     * app.use(StorePlugin, {
+     *   state: { count: 0, user: null },
+     *   actions: {
+     *     increment: (state) => state.count.value++,
+     *     setUser: (state, user) => state.user.value = user
+     *   }
+     * });
+     *
+     * // Advanced installation with persistence and namespaces
+     * app.use(StorePlugin, {
+     *   state: { theme: "light" },
+     *   namespaces: {
+     *     auth: {
+     *       state: { user: null, token: null },
+     *       actions: {
+     *         login: (state, { user, token }) => {
+     *           state.user.value = user;
+     *           state.token.value = token;
+     *         },
+     *         logout: (state) => {
+     *           state.user.value = null;
+     *           state.token.value = null;
+     *         }
+     *       }
+     *     }
+     *   },
+     *   persistence: {
+     *     enabled: true,
+     *     include: ["theme", "auth.user"]
+     *   }
+     * });
+     */
+    function install(eleva: Object, options?: {
+        state?: Object | undefined;
+        actions?: Object | undefined;
+        namespaces?: Object | undefined;
+        persistence?: {
+            enabled?: boolean | undefined;
+            key?: string | undefined;
+            storage?: "localStorage" | "sessionStorage" | undefined;
+            include?: string[] | undefined;
+            exclude?: string[] | undefined;
+        } | undefined;
+        devTools?: boolean | undefined;
+        onError?: Function | undefined;
+    }): void;
+    /**
+     * Uninstalls the plugin from the Eleva instance
+     *
+     * @param {Object} eleva - The Eleva instance
+     *
+     * @description
+     * Restores the original Eleva methods and removes all plugin-specific
+     * functionality. This method should be called when the plugin is no
+     * longer needed.
+     *
+     * @example
+     * // Uninstall the plugin
+     * StorePlugin.uninstall(app);
+     */
+    function uninstall(eleva: Object): void;
+}
+//# sourceMappingURL=Store.d.ts.map

package/types/plugins/Store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Store.d.ts","sourceRoot":"","sources":["../../src/plugins/Store.js"],"names":[],"mappings":";cA4DY,MAAM;iBAMN,MAAM;qBAMN,MAAM;IAKhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkDG;IACH,wBAhDW,MAAM,YAEd;QAAyB,KAAK;QACL,OAAO;QACP,UAAU;QACV,WAAW;;;;;;;QAMV,QAAQ;QACP,OAAO;KAElC,QAwlBF;IAED;;;;;;;;;;;;;OAaG;IACH,0BAXW,MAAM,QAwChB"}

package/types/plugins/index.d.ts

@@ -1,4 +1,5 @@
 export { AttrPlugin as Attr } from "./Attr.js";
 export { RouterPlugin as Router } from "./Router.js";
 export { PropsPlugin as Props } from "./Props.js";
+export { StorePlugin as Store } from "./Store.js";
 //# sourceMappingURL=index.d.ts.map