eleva 1.0.0 → 1.0.1

package/README.md

@@ -1,6 +1,6 @@
 # Eleva.js 🚀
 
-> **Version:** `1.0.0` | **Size:** ~6KB min (~2.3KB gzip) | **Dependencies:** Zero | **TypeScript:** Yes
+> **Version:** `1.0.1` | **Size:** ~6KB min (~2.3KB gzip) | **Dependencies:** Zero | **TypeScript:** Yes
 
 **Best DX for Building the Best UX** — Pure JavaScript, Pure Performance, Simply Elegant.
 
@@ -17,7 +17,7 @@
 <br>
 
 <p align="center">
-  <a href="https://tarekraafat.github.io/eleva/"><img src="./docs/imgs/eleva.js Full Logo.png" alt="Eleva.js - Lightweight JavaScript Framework Logo" width="50%"></a>
+  <a href="https://elevajs.com/"><img src="./docs/imgs/eleva.js Full Logo.png" alt="Eleva.js Logo - A minimalist, lightweight pure vanilla JavaScript frontend framework" width="50%"></a>
 </p>
 
 <p align="center">
@@ -31,7 +31,7 @@
 **A minimalist, lightweight, pure vanilla JavaScript frontend runtime framework.**
 _Designed for the best Developer Experience (DX) to help you build exceptional User Experiences (UX). Built with love for native JavaScript and a minimal core that can be extended through a powerful plugin system — because sometimes, less really is more!_ 😊
 
-> **Stable Release**: This is `v1.0.0` - The first official stable release of Eleva.js!
+> **Stable Release**: This is `v1.0.1` - The latest stable release of Eleva.js!
 
 
 
@@ -49,8 +49,9 @@ Unlike React, Vue, or Angular, Eleva:
 - **Uses real DOM** - No virtual DOM overhead for simple apps
 - **Provides signal-based reactivity** - Fine-grained updates like Solid.js
 - **Includes TypeScript support** - Built-in type declarations
+- **Is just JavaScript** - If it works in vanilla JS, it works in Eleva
 
-Eleva is ideal for developers building lightweight web applications, prototypes, micro-frontends, or anyone seeking a simpler alternative to React, Vue, or Angular.
+Eleva is ideal for developers building performance-critical applications, data-intensive dashboards (10K+ rows), micro-frontends, or anyone seeking a simpler alternative to React, Vue, or Angular.
 
 ---
 
@@ -149,6 +150,7 @@ The idea behind Eleva comes from a deep appreciation for native JavaScript. I wa
 - **🔌 Extensibility:** Extend functionality by plugging in your own ideas, such as custom state management, routing, and more.
 - **🚀 Performance:** Fast, efficient, and designed with modern browsers in mind.
 - **🍦 Pure Vanilla:** No dependencies, no magic-just plain JavaScript.
+- **🔍 Transparent:** No hidden layers or abstractions — if it works in vanilla JS, it works in Eleva.
 
 ---
 
@@ -162,8 +164,13 @@ Unlike monolithic frameworks that include everything out-of-the-box, Eleva inten
 - **🎯 Native JavaScript:** Built using pure vanilla JavaScript, Eleva integrates seamlessly with your existing code without unfamiliar syntax.
 - **⚙️ Configurability:** Extend Eleva's functionality with a simple API and optional plugins.
 - **🆓 Freedom:** Decide the best way to implement features without unnecessary constraints.
+- **🔍 Transparent:** No magic, no hidden abstractions — what you write is what runs.
 
-This unopinionated approach makes Eleva versatile and ideal for developers who want full control over their application's design.
+### Core Philosophy
+
+> **💡 Vanilla JavaScript. Elevated.**
+
+Eleva takes plain vanilla JavaScript to the next level. Signals for reactivity. Components for structure. Your JS knowledge stays front and center, not hidden behind abstractions. **If it works in vanilla JS, it works in Eleva.**
 
 ---
 
@@ -212,11 +219,11 @@ Eleva is built on a simple principle: **great DX leads to great UX**. When devel
 
 Eleva is ideal for developers seeking a lightweight, flexible, and high-performance solution for building frontend applications. Here are some scenarios where Eleva shines:
 
-- **🚀 Small to Medium Projects:** Perfect for web apps or websites that don't require the overhead of a full-fledged framework.
-- **⚡ Performance-Critical Applications:** Optimized reactivity and DOM diffing ensure smooth performance without bloat.
+- **⚡ Performance-Critical Applications:** 240fps-capable rendering handles everything from simple counters to 10K+ row dashboards (via virtual scrolling).
+- **📦 Bundle-Sensitive Projects:** At ~6KB with zero dependencies, ideal for embedded widgets, micro-frontends, and mobile-first apps.
 - **🔄 Unopinionated & Flexible:** Architect your application your way with a straightforward API and plugin system.
 - **🎯 Developer-Friendly:** Stick to pure vanilla JavaScript with familiar syntax and built-in TypeScript support.
-- **🧪 Rapid Prototyping:** Quickly prototype ideas with a minimal and extendable framework.
+- **🧪 Rapid Prototyping:** Start building immediately—no build tooling required.
 - **🔌 Extensible:** Easily add features like routing or state management through plugins.
 - **🚀 Built-in Routing:** Advanced client-side routing with navigation guards and reactive state via Router plugin.
 - **🎯 Advanced Attributes:** Sophisticated attribute handling with ARIA support via Attr plugin.
@@ -278,10 +285,10 @@ Benchmarks using [js-framework-benchmark](https://krausest.github.io/js-framewor
 **Performance Tips:**
 - Use `key` attribute on list items for optimal diffing
 - Eleva excels at initial renders and memory efficiency
-- For large lists (10K+ rows), use [virtual scrolling](./docs/examples/patterns/lists.md#virtual-scrolling) for **5.5x less memory** and **10x faster creation**
-- See [Large List Performance](./docs/examples/patterns/best-practices.md#large-list-performance) for detailed patterns and benchmarks
+- For large lists (10K+ rows), use [virtual scrolling](https://elevajs.com/examples/patterns/lists/virtual-scrolling.html) for **5.5x less memory** and **10x faster creation**
+- See [Large List Performance](https://elevajs.com/examples/patterns/best-practices/performance.html#large-list-performance) for detailed patterns and benchmarks
 
-> 💡 **Run benchmarks yourself:** `bun run test:benchmark` | [Detailed benchmark results](./test/__results__/performance/BENCHMARKS.md)
+> 💡 **Run benchmarks yourself:** `bun run test:benchmark` | [Detailed benchmark results](https://github.com/TarekRaafat/eleva/blob/master/test/__results__/performance/BENCHMARKS.md)
 
 ---
 
@@ -494,7 +501,7 @@ Eleva's plugin system allows you to extend functionality as needed. Plugins are
 | **Core Plugins** | Bundled with Eleva | `import { X } from "eleva/plugins"` |
 | **External Plugins** | Community/Ecosystem | `npm install eleva-plugin-x` |
 
-> **Core plugins** (Attr, Router, Store) are official, tested, and documented. **External plugins** are community-created and installed separately. See [Plugin Documentation](docs/plugins/index.md) for details.
+> **Core plugins** (Attr, Router, Store) are official, tested, and documented. **External plugins** are community-created and installed separately. See [Plugin Documentation](https://elevajs.com/plugins/) for details.
 
 #### Core Framework Only (Lightweight)
 
@@ -536,7 +543,7 @@ app.component("myComponent", {
 });
 ```
 
-📚 **[Full Attr Documentation →](docs/plugins/attr.md)** - Comprehensive guide with ARIA attributes, data attributes, boolean handling, and dynamic properties.
+📚 **[Full Attr Documentation →](https://elevajs.com/plugins/attr/)** - Comprehensive guide with ARIA attributes, data attributes, boolean handling, and dynamic properties.
 
 #### Router Plugin
 
@@ -551,8 +558,8 @@ const app = new Eleva("myApp");
 // Define components
 const HomePage = { template: () => `<h1>Home</h1>` };
 const AboutPage = { template: () => `<h1>About</h1>` };
-const UserPage = { 
-    template: (ctx) => `<h1>User: ${ctx.router.params.id}</h1>` 
+const UserPage = {
+    template: (ctx) => `<h1>User: ${ctx.router.currentParams.value.id}</h1>`
 };
 
 // Install router with advanced configuration
@@ -589,7 +596,7 @@ const router = app.use(Router, {
 });
 
 // Access reactive router state
-router.currentRoute.subscribe(route => {
+router.currentRoute.watch(route => {
     console.log('Route changed:', route);
 });
 
@@ -597,7 +604,7 @@ router.currentRoute.subscribe(route => {
 router.navigate('/users/123', { replace: true });
 ```
 
-📚 **[Full Router Documentation →](docs/plugins/router.md)** - Comprehensive guide with 13 events, 7 reactive signals, navigation guards, scroll management, and more.
+📚 **[Full Router Documentation →](https://elevajs.com/plugins/router/)** - Comprehensive guide with 13 events, 7 reactive signals, navigation guards, scroll management, and more.
 
 #### Store Plugin
 
@@ -681,11 +688,11 @@ app.component("TodoManager", {
             state: { items: [], filter: "all" },
             actions: {
                 addTodo: (state, text) => {
-                    state.todos.items.value.push({
+                    state.todos.items.value = [...state.todos.items.value, {
                         id: Date.now(),
                         text,
                         completed: false
-                    });
+                    }];
                 },
                 toggleTodo: (state, id) => {
                     const todo = state.todos.items.value.find(t => t.id === id);
@@ -722,14 +729,14 @@ console.log(app.store.getState()); // Get current state values
 app.dispatch("increment");          // Dispatch actions globally
 ```
 
-📚 **[Full Store Documentation →](docs/plugins/store.md)** - Comprehensive guide with 10 API methods, persistence options, namespaces, subscriptions, and migration guides.
+📚 **[Full Store Documentation →](https://elevajs.com/plugins/store/)** - Comprehensive guide with 10 API methods, persistence options, namespaces, subscriptions, and migration guides.
 
 **Bundle Sizes:**
 - Core framework only: ~6KB (minified)
 - Core + Attr: ~8KB (minified)
 - Core + Router: ~21KB (minified)
 - Core + Store: ~12KB (minified)
-- Core + All plugins: ~21KB (minified)
+- Core + All plugins: ~29KB (minified)
 
 **Individual Plugin Sizes:**
 - Attr: ~2.2KB (minified)
@@ -748,7 +755,7 @@ app.dispatch("increment");          // Dispatch actions globally
 - UMD: `<script src="https://cdn.jsdelivr.net/npm/eleva@latest/dist/plugins/router.umd.min.js"></script>`
 - UMD: `<script src="https://cdn.jsdelivr.net/npm/eleva@latest/dist/plugins/store.umd.min.js"></script>`
 
-**Individual Plugin Imports (Best for Tree-Shaking):**
+**Individual Plugin Imports (Smaller Bundle Size):**
 - ESM: `import { Attr } from 'eleva/plugins/attr'`
 - ESM: `import { Router } from 'eleva/plugins/router'`
 - ESM: `import { Store } from 'eleva/plugins/store'`
@@ -756,7 +763,7 @@ app.dispatch("increment");          // Dispatch actions globally
 - CJS: `const { Router } = require('eleva/plugins/router')`
 - CJS: `const { Store } = require('eleva/plugins/store')`
 
-For detailed API documentation, please check the [docs](docs/index.md) folder.
+For detailed API documentation, please check the [docs](https://elevajs.com) folder.
 
 ---
 
@@ -828,13 +835,13 @@ Contributions to tests are very welcome! 🧪
 
 ## Contributing
 
-I'd love to have you onboard as a contributor! Whether you're adding new features, squashing bugs, or sharing ideas, your input is invaluable. Please check out [CONTRIBUTING](CONTRIBUTING.md) for guidelines on getting started.
+I'd love to have you onboard as a contributor! Whether you're adding new features, squashing bugs, or sharing ideas, your input is invaluable. Please check out [CONTRIBUTING](https://github.com/TarekRaafat/eleva/blob/master/CONTRIBUTING.md) for guidelines on getting started.
 
 ---
 
 ## License
 
-Eleva is open-source and available under the [MIT License](LICENSE).
+Eleva is open-source and available under the [MIT License](https://github.com/TarekRaafat/eleva/blob/master/LICENSE).
 
 ---
 
@@ -854,7 +861,7 @@ Eleva is open-source and available under the [MIT License](LICENSE).
 
 ---
 
-[Documentation](/docs/index.md) |
-[Examples](/examples) |
-[Changelog](/CHANGELOG.md) |
+[Documentation](https://elevajs.com) |
+[Examples](https://elevajs.com/examples) |
+[Changelog](https://github.com/TarekRaafat/eleva/blob/master/CHANGELOG.md) |
 [GitHub Discussions](https://github.com/TarekRaafat/eleva/discussions)

package/dist/eleva-plugins.cjs.js

@@ -1,4 +1,4 @@
-/*! Eleva Plugins v1.0.0 | MIT License | https://elevajs.com */
+/*! Eleva Plugins v1.0.1 | MIT License | https://elevajs.com */
 'use strict';
 
 /**
@@ -1565,7 +1565,7 @@
         /** @type {RouterOptions} The merged router options. */ this.options = {
             mode: "hash",
             queryParam: "view",
-            viewSelector: "root",
+            viewSelector: "view",
             ...options
         };
         /** @private @type {RouteDefinition[]} The processed list of route definitions. */ this.routes = this._processRoutes(options.routes || []);
@@ -1641,7 +1641,7 @@
     /**
    * Plugin version
    * @type {string}
-   */ version: "1.0.0",
+   */ version: "1.0.1",
     /**
    * Plugin description
    * @type {string}