wu-framework 1.0.6 → 1.1.0

package/README.md

@@ -9,11 +9,13 @@ Wu Framework es la librería de microfrontends más simple y poderosa del mercad
 | Característica | Module Federation | qiankun | **Wu Framework** |
 |---|---|---|---|
 | **Setup** | Webpack config complejo | Configuración manual | **Zero config** |
-| **Framework Support** | React-first | Multi framework | **Cualquier framework** |
+| **Framework Support** | React-first | Multi framework | **8 frameworks nativos** |
 | **Bundler Required** | Solo Webpack 5 | Agnóstico pero complejo | **Ninguno** |
 | **CSS Isolation** | Básico | CSS hacks | **Shadow DOM nativo** |
+| **JS Isolation** | ❌ | Proxy básico | **Proxy Sandbox completo** |
 | **Runtime Config** | ❌ | Limitado | **✅ Completamente dinámico** |
-| **API Complexity** | Alta | Media | **Súper simple** |
+| **Self-Healing** | ❌ | ❌ | **✅ Auto-recovery** |
+| **API Complexity** | Alta | Media | **1 línea de código** |
 
 ## 🎯 Instalación
 
@@ -23,15 +25,34 @@ npm install wu-framework
 
 **¡Y ya está!** Sin webpack config, sin plugins, sin configuración.
 
-## 🔥 Uso Básico
+---
+
+## 🎨 Frameworks Soportados
+
+Wu Framework incluye **adapters nativos** para los frameworks más populares:
+
+| Framework | Adapter | Registro |
+|-----------|---------|----------|
+| ⚛️ React | `wuReact` | `wuReact.register('app', App)` |
+| 💚 Vue | `wuVue` | `wuVue.register('app', App)` |
+| 🅰️ Angular | `wuAngular` | `wuAngular.register('app', AppModule)` |
+| 🧡 Svelte | `wuSvelte` | `wuSvelte.register('app', App)` |
+| ⚡ Preact | `wuPreact` | `wuPreact.register('app', App)` |
+| 💎 Solid.js | `wuSolid` | `wuSolid.register('app', App)` |
+| 🔥 Lit | `wuLit` | `wuLit.register('app', MyElement)` |
+| 📦 Vanilla JS | `wuVanilla` | `wuVanilla.register('app', config)` |
+
+---
 
-### Container App (Host)
+## 🔥 Quick Start
+
+### 1. Shell (Host Application)
 
 ```js
 import { wu } from 'wu-framework';
 
-// Inicializar con apps
-wu.init({
+// Inicializar y montar microfrontends
+await wu.init({
   apps: [
     { name: 'header', url: 'http://localhost:3001' },
     { name: 'sidebar', url: 'http://localhost:3002' },
@@ -39,521 +60,907 @@ wu.init({
   ]
 });
 
-// Montar en el DOM
-wu.mount('header', '#header-container');
-wu.mount('sidebar', '#sidebar-container');
-wu.mount('content', '#content-container');
+await wu.mount('header', '#header-container');
+await wu.mount('sidebar', '#sidebar-container');
+await wu.mount('content', '#content-container');
 ```
 
-### Micro App (Cualquier Framework)
+### 2. Micro App (1 línea de código)
 
-```js
-import { wu } from 'wu-framework';
+**React:**
+```tsx
+import { wuReact } from 'wu-framework/adapters/react';
+import App from './App';
 
-// React
-wu.define('header', {
-  mount: (container) => {
-    ReactDOM.render(<HeaderApp />, container);
-  },
-  unmount: (container) => {
-    ReactDOM.unmountComponentAtNode(container);
-  }
-});
+wuReact.register('header', App);
+```
 
-// Vue
-wu.define('sidebar', {
-  mount: (container) => {
-    createApp(SidebarApp).mount(container);
-  },
-  unmount: (container) => {
-    // Vue cleanup
-  }
-});
+**Vue:**
+```ts
+import { wuVue } from 'wu-framework/adapters/vue';
+import App from './App.vue';
 
-// Vanilla JS
-wu.define('content', {
-  mount: (container) => {
-    container.innerHTML = `
-      <h1>Content App</h1>
-      <p>Pure vanilla JavaScript!</p>
-    `;
-  },
-  unmount: (container) => {
-    container.innerHTML = '';
-  }
-});
+wuVue.register('sidebar', App);
 ```
 
-## 📋 Wu Manifest (wu.json)
-
-Cada micro-app puede tener un archivo `wu.json` para configuración:
-
-```json
-{
-  "name": "header-app",
-  "entry": "index.js",
-  "wu": {
-    "exports": {
-      "HeaderComponent": "./components/Header",
-      "useAuth": "./hooks/useAuth"
-    },
-    "imports": [
-      "shared.Button",
-      "shared.Theme"
-    ],
-    "routes": ["/header", "/nav"],
-    "permissions": ["localStorage", "eventBus"]
-  }
-}
+**Angular:**
+```ts
+import { wuAngular } from 'wu-framework/adapters/angular';
+import { AppModule } from './app/app.module';
+
+wuAngular.register('content', AppModule);
 ```
 
-### Component Sharing
+**¡Eso es todo!** El adapter se encarga de todo: detección de contexto, modo standalone, cleanup automático.
 
-```js
-// Exportar componentes
-wu.define('shared', {
-  mount: (container) => {
-    // App shared con componentes reutilizables
-  }
-});
+---
 
-// Usar componentes compartidos
-const Button = await wu.use('shared.Button');
-const Theme = await wu.use('shared.Theme');
-```
+## ⚛️ React Adapter
 
-## 🏗️ Arquitectura
+### Registro Básico
 
-Wu Framework usa **Shadow DOM nativo** para verdadero aislamiento:
+```tsx
+import { wuReact } from 'wu-framework/adapters/react';
+import App from './App';
 
+wuReact.register('my-app', App);
 ```
-┌─────────────────────────────────────┐
-│           Host Application          │
-├─────────────────────────────────────┤
-│  ┌─────────────┐  ┌─────────────┐   │
-│  │ #shadow-root│  │ #shadow-root│   │
-│  │  ┌─────────┐│  │  ┌─────────┐│   │
-│  │  │Header   ││  │  │Sidebar  ││   │
-│  │  │(React)  ││  │  │(Vue)    ││   │
-│  │  └─────────┘│  │  └─────────┘│   │
-│  └─────────────┘  └─────────────┘   │
-└─────────────────────────────────────┘
+
+### Con Opciones
+
+```tsx
+wuReact.register('my-app', App, {
+  strictMode: true,           // Envolver en React.StrictMode
+  props: { theme: 'dark' },   // Props iniciales
+  standalone: true,           // Ejecutar independiente si Wu no está
+  standaloneContainer: '#root',
+  onMount: (container) => console.log('Mounted!'),
+  onUnmount: (container) => console.log('Unmounted!')
+});
 ```
 
-### Ventajas del Shadow DOM:
+### Hooks para React
 
-- ✅ **CSS completamente aislado** - No hay conflictos de estilos
-- ✅ **JavaScript scope aislado** - Variables globales separadas
-- ✅ **DOM encapsulado** - No hay interferencia entre apps
-- ✅ **Performance nativo** - Sin overhead de hacks CSS
-- ✅ **Debugging fácil** - Cada app en su propio DevTools tree
+```tsx
+import React from 'react';
+import { createUseWuEvents, createUseWuStore } from 'wu-framework/adapters/react';
 
-## 🎨 Ejemplos de Frameworks
+const useWuEvents = createUseWuEvents(React);
+const useWuStore = createUseWuStore(React);
 
-### React + TypeScript
+function MyComponent() {
+  const { emit, on } = useWuEvents();
+  const { state, setState } = useWuStore('user');
+
+  useEffect(() => {
+    const unsub = on('cart:updated', (data) => {
+      console.log('Cart updated:', data);
+    });
+    return unsub;
+  }, [on]);
+
+  return (
+    <button onClick={() => emit('user:logout')}>
+      Logout {state?.name}
+    </button>
+  );
+}
+```
+
+### Cargar Microfrontends en React (Shell)
 
 ```tsx
-// header-app/src/index.tsx
 import React from 'react';
-import ReactDOM from 'react-dom';
-import { wu } from 'wu-framework';
+import { createWuSlot } from 'wu-framework/adapters/react';
+
+const WuSlot = createWuSlot(React);
+
+function Shell() {
+  return (
+    <div>
+      <WuSlot
+        name="header"
+        url="http://localhost:3001"
+        onLoad={() => console.log('Header loaded!')}
+        onError={(err) => console.error(err)}
+      />
+      <WuSlot name="content" url="http://localhost:3002" />
+    </div>
+  );
+}
+```
 
-const HeaderApp: React.FC = () => (
-  <header className="app-header">
-    <h1>Header App (React)</h1>
-  </header>
-);
+---
 
-wu.define('header', {
-  mount: (container: HTMLElement) => {
-    ReactDOM.render(<HeaderApp />, container);
-  },
-  unmount: (container: HTMLElement) => {
-    ReactDOM.unmountComponentAtNode(container);
+## 💚 Vue Adapter
+
+### Registro Básico
+
+```ts
+import { wuVue } from 'wu-framework/adapters/vue';
+import App from './App.vue';
+
+wuVue.register('my-app', App);
+```
+
+### Con Plugins (Pinia, Router, etc.)
+
+```ts
+import { wuVue } from 'wu-framework/adapters/vue';
+import { createPinia } from 'pinia';
+import router from './router';
+import App from './App.vue';
+
+wuVue.register('my-app', App, {
+  setup: (app) => {
+    app.use(createPinia());
+    app.use(router);
   }
 });
 ```
 
-### Vue 3 + Composition API
+### Composables para Vue
 
 ```vue
-<!-- sidebar-app/src/App.vue -->
+<script setup>
+import { onMounted, onUnmounted } from 'vue';
+import { useWuEvents, useWuStore } from 'wu-framework/adapters/vue';
+
+const { emit, on, cleanup } = useWuEvents();
+const { state, setState } = useWuStore('cart');
+
+onMounted(() => {
+  on('user:login', (data) => console.log('Login:', data));
+});
+
+onUnmounted(() => cleanup());
+</script>
+
 <template>
-  <aside class="app-sidebar">
-    <h2>Sidebar App (Vue)</h2>
-    <nav>
-      <ul>
-        <li v-for="item in items" :key="item.id">
-          {{ item.name }}
-        </li>
-      </ul>
-    </nav>
-  </aside>
+  <div>
+    <p>Items: {{ state?.items?.length }}</p>
+    <button @click="emit('cart:clear')">Clear Cart</button>
+  </div>
 </template>
+```
 
-<script setup>
-import { ref } from 'vue';
+### Cargar Microfrontends en Vue (Shell)
 
-const items = ref([
-  { id: 1, name: 'Home' },
-  { id: 2, name: 'About' },
-  { id: 3, name: 'Contact' }
-]);
+```vue
+<script setup>
+import { WuSlot } from 'wu-framework/adapters/vue';
 </script>
+
+<template>
+  <div>
+    <WuSlot
+      name="header"
+      url="http://localhost:3001"
+      @load="onLoad"
+      @error="onError"
+    />
+    <WuSlot name="sidebar" url="http://localhost:3002" />
+  </div>
+</template>
 ```
 
-```js
-// sidebar-app/src/index.js
+### Plugin Global
+
+```ts
 import { createApp } from 'vue';
-import { wu } from 'wu-framework';
-import App from './App.vue';
+import { wuVuePlugin } from 'wu-framework/adapters/vue';
 
-let app;
+const app = createApp(App);
+app.use(wuVuePlugin); // Registra <WuSlot> globalmente
+```
 
-wu.define('sidebar', {
-  mount: (container) => {
-    app = createApp(App);
-    app.mount(container);
-  },
-  unmount: (container) => {
-    if (app) {
-      app.unmount();
-      app = null;
-    }
-  }
+---
+
+## 🅰️ Angular Adapter
+
+### Registro con NgModule
+
+```ts
+import { wuAngular } from 'wu-framework/adapters/angular';
+import { AppModule } from './app/app.module';
+
+wuAngular.register('my-app', AppModule);
+```
+
+### Registro con Standalone Components (Angular 14+)
+
+```ts
+import { wuAngular } from 'wu-framework/adapters/angular';
+import { AppComponent } from './app/app.component';
+import { appConfig } from './app/app.config';
+
+wuAngular.registerStandalone('my-app', AppComponent, {
+  appConfig
 });
 ```
 
-### Angular
+### Servicio para Componentes
 
-```typescript
-// content-app/src/main.ts
-import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
-import { wu } from 'wu-framework';
-import { AppModule } from './app/app.module';
+```ts
+import { Component, OnInit, OnDestroy } from '@angular/core';
+import { createWuService } from 'wu-framework/adapters/angular';
+
+@Component({
+  selector: 'app-root',
+  template: `<button (click)="sendEvent()">Send Event</button>`
+})
+export class AppComponent implements OnInit, OnDestroy {
+  private wuService = createWuService();
 
-let platformRef: any;
+  ngOnInit() {
+    this.wuService.on('user:login', (data) => {
+      console.log('User logged in:', data);
+    });
+  }
 
-wu.define('content', {
-  mount: async (container: HTMLElement) => {
-    // Crear elemento para Angular
-    const appElement = document.createElement('app-root');
-    container.appendChild(appElement);
+  sendEvent() {
+    this.wuService.emit('app:ready', { timestamp: Date.now() });
+  }
 
-    // Bootstrap Angular
-    platformRef = await platformBrowserDynamic().bootstrapModule(AppModule);
-  },
-  unmount: (container: HTMLElement) => {
-    if (platformRef) {
-      platformRef.destroy();
-      platformRef = null;
-    }
-    container.innerHTML = '';
+  ngOnDestroy() {
+    this.wuService.destroy();
   }
-});
+}
 ```
 
-### Svelte
+---
+
+## 🧡 Svelte Adapter
+
+### Registro Básico
 
 ```js
-// footer-app/src/index.js
-import { wu } from 'wu-framework';
+import { wuSvelte } from 'wu-framework/adapters/svelte';
 import App from './App.svelte';
 
-let app;
+wuSvelte.register('my-app', App);
+```
 
-wu.define('footer', {
-  mount: (container) => {
-    app = new App({
-      target: container,
-      props: {
-        name: 'Footer App'
-      }
-    });
-  },
-  unmount: (container) => {
-    if (app) {
-      app.$destroy();
-      app = null;
-    }
+### Svelte 5 (con runes)
+
+```js
+import { wuSvelte } from 'wu-framework/adapters/svelte';
+import App from './App.svelte';
+
+wuSvelte.registerSvelte5('my-app', App);
+```
+
+### Stores Reactivos
+
+```svelte
+<script>
+  import { createWuStore, useWuEvents } from 'wu-framework/adapters/svelte';
+  import { onDestroy } from 'svelte';
+
+  // Store reactivo (compatible con $store)
+  const userStore = createWuStore('user');
+
+  // Eventos
+  const { emit, on, cleanup } = useWuEvents();
+
+  on('cart:updated', (data) => {
+    console.log('Cart updated:', data);
+  });
+
+  onDestroy(cleanup);
+</script>
+
+<p>Hello, {$userStore?.name}</p>
+<button on:click={() => emit('user:logout')}>Logout</button>
+```
+
+---
+
+## ⚡ Preact Adapter
+
+### Registro Básico
+
+```jsx
+import { wuPreact } from 'wu-framework/adapters/preact';
+import App from './App';
+
+wuPreact.register('my-app', App);
+```
+
+### Compatible con React (preact/compat)
+
+```jsx
+import { wuPreact } from 'wu-framework/adapters/preact';
+import App from './App'; // Componente estilo React
+
+wuPreact.registerCompat('my-app', App);
+```
+
+### Hooks
+
+```jsx
+import { h } from 'preact';
+import { useState, useEffect, useCallback, useRef } from 'preact/hooks';
+import { createUseWuEvents, createUseWuStore } from 'wu-framework/adapters/preact';
+
+const useWuEvents = createUseWuEvents({ useCallback, useEffect, useRef });
+const useWuStore = createUseWuStore({ useState, useCallback, useEffect });
+
+function MyComponent() {
+  const { emit, on } = useWuEvents();
+  const { state } = useWuStore('user');
+
+  return <div>Hello {state?.name}</div>;
+}
+```
+
+---
+
+## 💎 Solid.js Adapter
+
+### Registro Básico
+
+```jsx
+import { wuSolid } from 'wu-framework/adapters/solid';
+import App from './App';
+
+wuSolid.register('my-app', App);
+```
+
+### Stores Reactivos
+
+```jsx
+import { createWuStore, createWuEvent } from 'wu-framework/adapters/solid';
+
+function MyComponent() {
+  // Store reactivo
+  const [user, setUser] = createWuStore('user');
+
+  // Eventos reactivos
+  const lastEvent = createWuEvent('notification:*');
+
+  return (
+    <div>
+      <p>Hello, {user()?.name}</p>
+      <Show when={lastEvent()}>
+        <p>Last notification: {lastEvent()?.data}</p>
+      </Show>
+      <button onClick={() => setUser('name', 'John')}>
+        Set Name
+      </button>
+    </div>
+  );
+}
+```
+
+---
+
+## 🔥 Lit Adapter (Web Components)
+
+### Registro con LitElement
+
+```js
+import { LitElement, html, css } from 'lit';
+import { wuLit } from 'wu-framework/adapters/lit';
+
+class MyApp extends LitElement {
+  static styles = css`
+    :host { display: block; padding: 16px; }
+  `;
+
+  render() {
+    return html`<h1>Hello from Lit!</h1>`;
   }
-});
+}
+
+wuLit.register('my-app', MyApp);
 ```
 
-## 🛠️ API Reference
+### Con WuMixin
 
-### Core API
+```js
+import { LitElement, html } from 'lit';
+import { WuMixin } from 'wu-framework/adapters/lit';
+
+class MyApp extends WuMixin(LitElement) {
+  connectedCallback() {
+    super.connectedCallback();
+
+    // Usar eventos de Wu
+    this.wuOn('user:login', (data) => {
+      console.log('User logged in:', data);
+    });
+  }
+
+  handleClick() {
+    this.wuEmit('button:clicked', { id: 'my-button' });
+  }
+
+  render() {
+    return html`
+      <button @click=${this.handleClick}>Click me</button>
+    `;
+  }
+}
+
+wuLit.register('my-app', MyApp);
+```
+
+### Web Component Vanilla (sin Lit)
 
 ```js
-import { wu } from 'wu-framework';
+import { wuLit } from 'wu-framework/adapters/lit';
+
+class MyComponent extends HTMLElement {
+  connectedCallback() {
+    this.attachShadow({ mode: 'open' });
+    this.shadowRoot.innerHTML = '<h1>Hello Web Component!</h1>';
+  }
+}
 
-// Inicializar framework
-await wu.init({ apps: [...] });
+wuLit.registerWebComponent('my-component', MyComponent);
+```
+
+---
 
-// Montar app
-await wu.mount('appName', '#container');
+## 📦 Vanilla JS Adapter
 
-// Desmontar app
-await wu.unmount('appName');
+### Registro con Objeto
 
-// Definir lifecycle
-wu.define('appName', { mount, unmount });
+```js
+import { wuVanilla } from 'wu-framework/adapters/vanilla';
 
-// Usar componente compartido
-const Component = await wu.use('app.Component');
+wuVanilla.register('my-app', {
+  state: { count: 0 },
 
-// Obtener información
-const info = wu.getAppInfo('appName');
-const stats = wu.getStats();
+  render: (container, state) => {
+    container.innerHTML = `
+      <div>
+        <h1>Count: ${state.count}</h1>
+        <button id="increment">+</button>
+      </div>
+    `;
+    container.querySelector('#increment').onclick = () => {
+      state.count++;
+      // Re-render manual
+    };
+  },
 
-// Limpiar framework
-await wu.destroy();
+  destroy: (container) => {
+    container.innerHTML = '';
+  }
+});
 ```
 
-### Utils API
+### Registro con Clase
 
 ```js
-import { init, mount, define, use } from 'wu-framework';
+import { wuVanilla } from 'wu-framework/adapters/vanilla';
 
-// API de conveniencia
-await init([{ name: 'app', url: 'http://localhost:3000' }]);
-await mount('app', '#container');
-define('app', { mount, unmount });
-const Component = await use('shared.Button');
+class TodoApp {
+  constructor(container) {
+    this.container = container;
+    this.todos = [];
+  }
+
+  render() {
+    this.container.innerHTML = `
+      <ul>
+        ${this.todos.map(t => `<li>${t}</li>`).join('')}
+      </ul>
+      <input type="text" id="input" />
+      <button id="add">Add</button>
+    `;
+
+    this.container.querySelector('#add').onclick = () => {
+      const input = this.container.querySelector('#input');
+      this.todos.push(input.value);
+      this.render();
+    };
+  }
+
+  destroy() {
+    this.container.innerHTML = '';
+  }
+}
+
+wuVanilla.registerClass('todo-app', TodoApp);
 ```
 
-### Development API
+### Registro con Template
 
 ```js
-import { dev } from 'wu-framework';
+import { wuVanilla } from 'wu-framework/adapters/vanilla';
 
-// Debugging
-dev.enableDebug();
-dev.inspect();
+wuVanilla.registerTemplate('header', `
+  <header>
+    <h1>My Header</h1>
+    <nav>
+      <a href="/">Home</a>
+      <a href="/about">About</a>
+    </nav>
+  </header>
+`);
+
+// Template dinámico
+wuVanilla.registerTemplate('greeting',
+  (data) => `<h1>Hello, ${data.name}!</h1>`,
+  { data: { name: 'World' } }
+);
+```
+
+### Componente Reactivo
+
+```js
+import { wuVanilla } from 'wu-framework/adapters/vanilla';
+
+const Counter = wuVanilla.createComponent({
+  state: { count: 0 },
+
+  template: (state) => `
+    <div>
+      <h1>Count: ${state.count}</h1>
+      <button data-action="increment">+</button>
+      <button data-action="decrement">-</button>
+    </div>
+  `,
+
+  actions: {
+    increment: (state) => ({ count: state.count + 1 }),
+    decrement: (state) => ({ count: state.count - 1 })
+  }
+});
 
-// Hot reload (desarrollo)
-await dev.reload('appName');
+wuVanilla.register('counter', Counter);
 ```
 
-## 🔧 Configuración Avanzada
+---
+
+## 📡 Event Bus
 
-### Presets
+Sistema de eventos para comunicación entre microfrontends con soporte para wildcards y replay.
 
 ```js
-import { wu, presets } from 'wu-framework';
+import { emit, on, once, off, replayEvents } from 'wu-framework';
+
+// Emitir evento
+emit('user:login', { userId: 123, name: 'John' });
+
+// Suscribirse a evento
+const unsubscribe = on('user:login', (event) => {
+  console.log('User logged in:', event.data);
+});
+
+// Suscribirse con wildcards
+on('user:*', (event) => {
+  console.log('User event:', event.name, event.data);
+});
+
+// Suscribirse una sola vez
+once('app:ready', (event) => {
+  console.log('App is ready!');
+});
 
-// Desarrollo
-await wu.init(presets.development([
-  { name: 'header', port: 3001 },
-  { name: 'sidebar', port: 3002 }
-]));
+// Desuscribirse
+off('user:login', callback);
+unsubscribe(); // También funciona
 
-// Producción
-await wu.init(presets.production([
-  { name: 'header', url: 'https://header.myapp.com' },
-  { name: 'sidebar', url: 'https://sidebar.myapp.com' }
-]));
+// Replay eventos del historial
+replayEvents('user:*', (event) => {
+  console.log('Past event:', event);
+});
 ```
 
-### Eventos
+---
+
+## 🗄️ Store (State Management)
+
+Store de alto rendimiento con pattern matching.
 
 ```js
-import { events } from 'wu-framework';
+import {
+  getState,
+  setState,
+  onStateChange,
+  batchState,
+  clearState,
+  getStoreMetrics
+} from 'wu-framework';
+
+// Establecer estado (dot notation)
+setState('user.name', 'John');
+setState('user.preferences.theme', 'dark');
+
+// Obtener estado
+const name = getState('user.name'); // 'John'
+const user = getState('user');      // { name: 'John', preferences: { theme: 'dark' } }
+
+// Suscribirse a cambios
+const unsubscribe = onStateChange('user.name', (value, path) => {
+  console.log(`${path} changed to:`, value);
+});
 
-// Escuchar eventos del ciclo de vida
-events.onAppMounted((event) => {
-  console.log('App mounted:', event.detail.appName);
+// Suscribirse con wildcards
+onStateChange('user.*', (value, path) => {
+  console.log(`User property changed: ${path} =`, value);
 });
 
-events.onAppError((event) => {
-  console.error('App error:', event.detail);
+// Batch updates (más eficiente)
+batchState({
+  'user.name': 'Jane',
+  'user.email': 'jane@example.com',
+  'settings.notifications': true
 });
+
+// Métricas de performance
+const metrics = getStoreMetrics();
 ```
 
-## 🌟 Ventajas Competitivas
+---
 
-### vs Module Federation
+## 🔌 Sistema de Plugins
 
-- ✅ **No requiere Webpack 5** - Funciona con cualquier bundler
-- ✅ **Runtime configuration** - No necesita build-time config
-- ✅ **Framework agnostic real** - No solo React
-- ✅ **API más simple** - Menos boilerplate
+```js
+import { usePlugin, createPlugin, uninstallPlugin } from 'wu-framework';
 
-### vs qiankun
+const analyticsPlugin = createPlugin({
+  name: 'analytics',
+  permissions: ['events', 'store'],
 
-- ✅ **Shadow DOM nativo** - No hacks CSS
-- ✅ **Mejor DX** - DevTools integration
-- ✅ **Sandbox más ligero** - Menos overhead
-- ✅ **Component sharing** - Sistema declarativo
+  install: (api, options) => {
+    api.on('app:mounted', (event) => {
+      trackEvent('mount', event.data.appName);
+    });
+  },
 
-### vs single-spa
+  beforeMount: async (context) => {
+    console.log('Before mount:', context.appName);
+  },
 
-- ✅ **Zero config** - Sin setup complejo
-- ✅ **Shadow DOM** - Aislamiento real
-- ✅ **Manifest system** - Configuración declarativa
-- ✅ **API moderna** - ES modules nativo
+  afterMount: async (context) => {
+    console.log('Mounted in', context.mountTime, 'ms');
+  }
+});
 
-## 📦 Bundler Support
+usePlugin(analyticsPlugin, { trackingId: 'UA-123456' });
+```
 
-Wu Framework funciona con **cualquier bundler** o sin bundler:
+---
 
-### Vite
+## 🪝 Lifecycle Hooks
 
 ```js
-// vite.config.js
-export default {
-  // Wu Framework funciona out-of-the-box con Vite
-  // No necesita configuración especial
-}
+import { useHook, createGuardHook, createTimedHook } from 'wu-framework';
+
+// Hook básico
+useHook('beforeMount', async (context, next) => {
+  console.log('Before mounting:', context.appName);
+  await next();
+}, { name: 'my-hook', priority: 10 });
+
+// Guard hook (puede cancelar)
+const authGuard = createGuardHook(async (ctx) => {
+  return await isUserAuthenticated();
+});
+useHook('beforeMount', authGuard);
+
+// Hook con timeout
+const timedHook = createTimedHook(async (ctx) => {
+  await slowOperation();
+}, 5000);
 ```
 
-### Webpack
+### Fases Disponibles
+
+| Fase | Descripción |
+|------|-------------|
+| `beforeInit` | Antes de inicializar framework |
+| `afterInit` | Después de inicializar |
+| `beforeLoad` | Antes de cargar una app |
+| `afterLoad` | Después de cargar |
+| `beforeMount` | Antes de montar |
+| `afterMount` | Después de montar |
+| `beforeUnmount` | Antes de desmontar |
+| `afterUnmount` | Después de desmontar |
+
+---
+
+## 🎯 Loading Strategies
 
 ```js
-// webpack.config.js
-module.exports = {
-  // Wu Framework funciona con cualquier versión de Webpack
-  // Sin plugins especiales requeridos
-}
+await wu.init({
+  apps: [
+    { name: 'header', url: '...', strategy: 'lazy' },     // Default
+    { name: 'sidebar', url: '...', strategy: 'eager' },   // Precarga
+    { name: 'footer', url: '...', strategy: 'preload' },  // <link prefetch>
+    { name: 'analytics', url: '...', strategy: 'idle' }   // requestIdleCallback
+  ]
+});
 ```
 
-### Sin Bundler (ES Modules)
+---
 
-```html
-<!-- Funciona directamente en el browser -->
-<script type="module">
-  import { wu } from './node_modules/wu-framework/src/index.js';
+## ⚡ Performance Monitoring
 
-  wu.init({
-    apps: [{ name: 'app', url: './my-app' }]
-  });
-</script>
+```js
+import {
+  startMeasure,
+  endMeasure,
+  getPerformanceMetrics,
+  generatePerformanceReport
+} from 'wu-framework';
+
+// Medición personalizada
+startMeasure('data-fetch', 'my-app');
+await fetchData();
+const duration = endMeasure('data-fetch', 'my-app');
+
+// Reporte completo
+const report = generatePerformanceReport();
 ```
 
-## 🚀 Getting Started
+---
 
-### 1. Crear Container App
+## 🛡️ Error Handling
 
-```bash
-mkdir my-container-app
-cd my-container-app
-npm init -y
-npm install wu-framework
+```js
+import { registerErrorHandler, configureErrorBoundary } from 'wu-framework';
+
+registerErrorHandler({
+  name: 'api-error',
+  canHandle: (error) => error.message.includes('API'),
+  handle: async (error, context) => {
+    if (context.retryCount < 3) {
+      return { recovered: true, action: 'retry' };
+    }
+    return { recovered: false, action: 'fallback' };
+  }
+});
+
+configureErrorBoundary({
+  maxRetries: 3,
+  retryDelay: 1000,
+  showErrorUI: true
+});
 ```
 
+---
+
+## 🎯 API Simplificada (wu.app)
+
 ```js
-// index.js
 import { wu } from 'wu-framework';
 
-wu.init({
-  apps: [
-    { name: 'header', url: 'http://localhost:3001' },
-    { name: 'content', url: 'http://localhost:3002' }
-  ]
+const header = wu.app('header', {
+  url: 'http://localhost:3001',
+  container: '#header-container'
 });
 
-wu.mount('header', '#header');
-wu.mount('content', '#content');
+await header.mount();
+console.log(header.isMounted); // true
+
+await header.unmount();
+await header.remount();
+await header.reload();  // Limpia cache
+
+const health = await header.verify();
+await header.destroy();
 ```
 
-```html
-<!-- index.html -->
-<!DOCTYPE html>
-<html>
-<head>
-  <title>Wu Framework Container</title>
-</head>
-<body>
-  <div id="header"></div>
-  <div id="content"></div>
+---
+
+## 🏗️ Arquitectura
 
-  <script type="module" src="index.js"></script>
-</body>
-</html>
+```
+┌─────────────────────────────────────────────────────────────┐
+│                     HOST APPLICATION                         │
+├─────────────────────────────────────────────────────────────┤
+│  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────┐  │
+│  │  #shadow-root   │  │  #shadow-root   │  │ #shadow-root│  │
+│  │  ┌───────────┐  │  │  ┌───────────┐  │  │ ┌─────────┐ │  │
+│  │  │  Header   │  │  │  │  Sidebar  │  │  │ │ Content │ │  │
+│  │  │  (React)  │  │  │  │  (Vue)    │  │  │ │(Angular)│ │  │
+│  │  └───────────┘  │  │  └───────────┘  │  │ └─────────┘ │  │
+│  │  CSS Isolated   │  │  CSS Isolated   │  │ CSS Isolated│  │
+│  │  JS Sandboxed   │  │  JS Sandboxed   │  │ JS Sandboxed│  │
+│  └─────────────────┘  └─────────────────┘  └─────────────┘  │
+├─────────────────────────────────────────────────────────────┤
+│                      WU FRAMEWORK CORE                       │
+│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────────────┐  │
+│  │ EventBus │ │  Store   │ │ Plugins  │ │ Sandbox Pool   │  │
+│  └──────────┘ └──────────┘ └──────────┘ └────────────────┘  │
+└─────────────────────────────────────────────────────────────┘
 ```
 
-### 2. Crear Micro App
+---
 
-```bash
-mkdir header-app
-cd header-app
-npm init -y
-npm install wu-framework react react-dom
+## 📋 API Reference
+
+### Core
+
+```js
+import { wu, init, mount, unmount, destroy, getStats } from 'wu-framework';
 ```
 
+### Event Bus
+
 ```js
-// index.js
-import React from 'react';
-import ReactDOM from 'react-dom';
-import { wu } from 'wu-framework';
+import { emit, on, once, off, replayEvents, getEventBusStats } from 'wu-framework';
+```
 
-const HeaderApp = () => (
-  <header style={{ background: '#f0f0f0', padding: '1rem' }}>
-    <h1>My Header App</h1>
-  </header>
-);
+### Store
 
-wu.define('header', {
-  mount: (container) => {
-    ReactDOM.render(<HeaderApp />, container);
-  },
-  unmount: (container) => {
-    ReactDOM.unmountComponentAtNode(container);
-  }
-});
+```js
+import { getState, setState, onStateChange, batchState, clearState } from 'wu-framework';
 ```
 
-```json
-// wu.json
-{
-  "name": "header-app",
-  "entry": "index.js",
-  "wu": {
-    "exports": {
-      "HeaderComponent": "./components/Header"
-    },
-    "imports": [],
-    "routes": ["/header"]
-  }
-}
+### Plugins & Hooks
+
+```js
+import { usePlugin, createPlugin, useHook, removeHook } from 'wu-framework';
 ```
 
-### 3. Servir Apps
+### Performance & Errors
 
-```bash
-# Terminal 1 - Container
-cd my-container-app
-npx serve -p 3000
+```js
+import { startMeasure, endMeasure, generatePerformanceReport } from 'wu-framework';
+import { registerErrorHandler, configureErrorBoundary } from 'wu-framework';
+```
 
-# Terminal 2 - Header App
-cd header-app
-npx serve -p 3001
+### Adapters
 
-# Abrir http://localhost:3000
+```js
+import { wuReact } from 'wu-framework/adapters/react';
+import { wuVue } from 'wu-framework/adapters/vue';
+import { wuAngular } from 'wu-framework/adapters/angular';
+import { wuSvelte } from 'wu-framework/adapters/svelte';
+import { wuPreact } from 'wu-framework/adapters/preact';
+import { wuSolid } from 'wu-framework/adapters/solid';
+import { wuLit } from 'wu-framework/adapters/lit';
+import { wuVanilla } from 'wu-framework/adapters/vanilla';
 ```
 
-## 🤝 Contributing
+### Utilities
 
-Wu Framework es open source. ¡Contribuciones bienvenidas!
+```js
+import { presets, dev, events } from 'wu-framework';
 
-1. Fork el repositorio
-2. Crear feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit cambios (`git commit -m 'Add amazing feature'`)
-4. Push branch (`git push origin feature/amazing-feature`)
-5. Abrir Pull Request
+// Presets
+await wu.init(presets.development([{ name: 'app', port: 3001 }]));
+await wu.init(presets.production([{ name: 'app', url: 'https://...' }]));
 
-## 📄 License
+// Dev tools
+dev.enableDebug();
+dev.inspect();
+await dev.reload('app');
+
+// Silenciar logs
+wu.silence();
+wu.verbose();
+```
+
+---
 
-MIT License - ver [LICENSE](LICENSE) para detalles.
+## 🤝 Contributing
 
-## 🙏 Acknowledgments
+¡Las contribuciones son bienvenidas!
 
-- Inspirado por qiankun, single-spa, y Module Federation
-- Construido con amor para la comunidad de microfrontends
-- Gracias a todos los contributors
+1. **Fork** el repositorio
+2. **Crear** branch (`git checkout -b feature/amazing-feature`)
+3. **Commit** tus cambios (`git commit -m 'Add amazing feature'`)
+4. **Push** al branch (`git push origin feature/amazing-feature`)
+5. **Abrir** un Pull Request
 
 ---
 
-**🚀 Wu Framework - Universal Microfrontends Made Simple**
+## 📄 License
+
+MIT License - Copyright (c) 2025 Wu Framework Team
+
+---
 
-*Framework agnostic • Zero config • Shadow DOM • Runtime loading*
+<p align="center">
+  <b>🚀 Wu Framework - Universal Microfrontends Made Simple</b>
+  <br><br>
+  <i>Zero dependencies • 8 Frameworks • Shadow DOM • Proxy Sandbox • Self-Healing</i>
+</p>