wu-framework 1.1.7 → 1.1.9

package/integrations/astro/README.md

@@ -0,0 +1,127 @@
+# @wu-framework/astro
+
+Astro integration for **wu-framework** microfrontends. Mount wu micro-apps inside any Astro site with zero runtime overhead at build time.
+
+## Installation
+
+```bash
+npm install @wu-framework/astro wu-framework
+```
+
+## Quick Start
+
+### 1. Add the integration
+
+```js
+// astro.config.mjs
+import { defineConfig } from 'astro/config';
+import wu from '@wu-framework/astro';
+
+export default defineConfig({
+  integrations: [
+    wu({
+      apps: [
+        { name: 'header', url: '/apps/header', strategy: 'eager' },
+        { name: 'dashboard', url: '/apps/dashboard' }
+      ]
+    })
+  ]
+});
+```
+
+The integration injects the wu-framework runtime and auto-calls `wu.init()` with your apps config.
+
+### 2. Mount micro-apps in pages
+
+```astro
+---
+import WuApp from '@wu-framework/astro/WuApp.astro';
+---
+
+<WuApp name="header" />
+<WuApp name="dashboard" lazy />
+```
+
+The `lazy` prop defers mounting until the element scrolls into view (uses `IntersectionObserver` with a 200px root margin).
+
+## Components
+
+### `WuApp`
+
+Renders a mount point and calls `wu.mount()` on the client.
+
+| Prop    | Type      | Default | Description                              |
+| ------- | --------- | ------- | ---------------------------------------- |
+| `name`  | `string`  | —       | Name of the registered micro-app         |
+| `lazy`  | `boolean` | `false` | Defer mount until visible                |
+| `class` | `string`  | —       | CSS class(es) for the container          |
+| `style` | `string`  | —       | Inline styles for the container          |
+
+### `WuShell`
+
+Layout wrapper that calls `wu.init()` on the client. Useful when you want page-level control instead of the global integration.
+
+```astro
+---
+import WuShell from '@wu-framework/astro/WuShell.astro';
+---
+
+<WuShell apps={[{ name: 'header', url: '/apps/header' }]}>
+  <main>Page content here</main>
+</WuShell>
+```
+
+| Prop      | Type           | Default | Description                 |
+| --------- | -------------- | ------- | --------------------------- |
+| `apps`    | `WuAppConfig[]`| —       | Micro-app definitions       |
+| `sandbox` | `string`       | —       | Sandbox mode                |
+| `debug`   | `boolean`      | `false` | Enable debug logging        |
+
+## Integration Options
+
+| Option    | Type            | Default | Description                                     |
+| --------- | --------------- | ------- | ----------------------------------------------- |
+| `apps`    | `WuAppConfig[]` | `[]`    | Auto-register apps via `wu.init()`              |
+| `sandbox` | `string`        | —       | Global sandbox mode (`module`/`strict`/`eval`)  |
+| `cdn`     | `string`        | —       | CDN URL for wu-framework UMD bundle             |
+| `debug`   | `boolean`       | `false` | Enable debug logging                            |
+
+## Usage Patterns
+
+### Integration only (auto-init)
+
+Use the integration in `astro.config.mjs` to auto-init, then mount with `WuApp`:
+
+```astro
+---
+import WuApp from '@wu-framework/astro/WuApp.astro';
+---
+<WuApp name="header" />
+```
+
+### Shell layout (page-level init)
+
+Skip the integration's `apps` option and use `WuShell` for per-page control:
+
+```astro
+---
+import WuShell from '@wu-framework/astro/WuShell.astro';
+import WuApp from '@wu-framework/astro/WuApp.astro';
+---
+<WuShell apps={[{ name: 'nav', url: '/apps/nav' }]}>
+  <WuApp name="nav" />
+  <slot />
+</WuShell>
+```
+
+### CDN mode
+
+Load wu-framework from a CDN instead of bundling it:
+
+```js
+wu({ cdn: 'https://cdn.example.com/wu-framework@1.1.8/dist/wu-framework.umd.js' })
+```
+
+## License
+
+MIT

package/integrations/astro/WuApp.astro

@@ -0,0 +1,63 @@
+---
+/**
+ * WuApp — Mount point for a wu micro-app.
+ *
+ * Renders a <div> and runs wu.mount() on the client to hydrate
+ * the named micro-app into it.  When `lazy` is true the mount
+ * is deferred until the element scrolls into view.
+ *
+ * @example
+ * ---
+ * import WuApp from '@wu-framework/astro/WuApp.astro';
+ * ---
+ * <WuApp name="header" />
+ * <WuApp name="dashboard" lazy />
+ */
+
+interface Props {
+  /** Name of the registered wu micro-app */
+  name: string;
+  /** Defer mounting until the element is visible */
+  lazy?: boolean;
+  /** CSS class(es) for the container div */
+  class?: string;
+  /** Inline styles for the container div */
+  style?: string;
+}
+
+const { name, lazy = false } = Astro.props;
+const id = `wu-app-${name}`;
+---
+
+<div
+  id={id}
+  class={Astro.props.class}
+  style={Astro.props.style}
+  data-wu-app={name}
+  data-wu-lazy={lazy}
+></div>
+
+<script define:vars={{ id, name, lazy }}>
+  async function mountApp() {
+    const { wu } = await import('wu-framework');
+    await wu.mount(name, `#${id}`);
+  }
+
+  if (lazy) {
+    const el = document.getElementById(id);
+    if (el) {
+      const observer = new IntersectionObserver(
+        (entries) => {
+          if (entries[0].isIntersecting) {
+            observer.disconnect();
+            mountApp();
+          }
+        },
+        { rootMargin: '200px' }
+      );
+      observer.observe(el);
+    }
+  } else {
+    mountApp();
+  }
+</script>

package/integrations/astro/WuShell.astro

@@ -0,0 +1,39 @@
+---
+/**
+ * WuShell — Layout wrapper that initializes wu-framework on the client.
+ *
+ * Wraps page content in a <slot /> and runs wu.init() with the
+ * provided app configuration once the page loads.
+ *
+ * @example
+ * ---
+ * import WuShell from '@wu-framework/astro/WuShell.astro';
+ * ---
+ * <WuShell apps={[{ name: 'header', url: '/apps/header' }]}>
+ *   <main>My page content</main>
+ * </WuShell>
+ */
+
+interface Props {
+  /** Array of micro-app definitions to register with wu.init() */
+  apps: Array<{
+    name: string;
+    url: string;
+    strategy?: 'eager' | 'lazy' | 'manual';
+  }>;
+  /** Sandbox isolation mode */
+  sandbox?: 'module' | 'strict' | 'eval';
+  /** Enable debug logging */
+  debug?: boolean;
+}
+
+const { apps, sandbox, debug = false } = Astro.props;
+---
+
+<slot />
+
+<script define:vars={{ apps, sandbox, debug }}>
+  import('wu-framework').then(({ wu }) => {
+    wu.init({ apps, sandbox, debug });
+  });
+</script>

package/integrations/astro/index.js

@@ -0,0 +1,68 @@
+/**
+ * @wu-framework/astro — Astro integration for wu-framework microfrontends.
+ *
+ * Injects the wu-framework runtime into Astro pages and optionally
+ * auto-initializes registered micro-apps via wu.init().
+ *
+ * @example
+ * // astro.config.mjs
+ * import wu from '@wu-framework/astro';
+ *
+ * export default defineConfig({
+ *   integrations: [
+ *     wu({
+ *       apps: [
+ *         { name: 'header', url: '/apps/header', strategy: 'eager' },
+ *         { name: 'dashboard', url: '/apps/dashboard' }
+ *       ]
+ *     })
+ *   ]
+ * });
+ */
+
+/**
+ * @param {import('./types').WuIntegrationOptions} options
+ * @returns {import('astro').AstroIntegration}
+ */
+export default function wuIntegration(options = {}) {
+  const {
+    apps = [],
+    sandbox,
+    cdn,
+    debug = false,
+  } = options;
+
+  return {
+    name: '@wu-framework/astro',
+    hooks: {
+      'astro:config:setup': ({ injectScript, updateConfig }) => {
+        // 1. Inject wu-framework runtime
+        if (cdn) {
+          // Use external CDN script (client-only)
+          injectScript(
+            'head-inline',
+            `(function(){var s=document.createElement('script');s.src='${cdn}';s.defer=true;document.head.appendChild(s);})()`
+          );
+        }
+
+        // 2. Auto-init if apps are provided (client-only via 'page')
+        if (apps.length > 0) {
+          const initConfig = JSON.stringify({ apps, sandbox, debug });
+          injectScript(
+            'page',
+            `import('wu-framework').then(function(m){m.wu.init(${initConfig});});`
+          );
+        }
+
+        // 3. Ensure Vite resolves wu-framework correctly
+        updateConfig({
+          vite: {
+            optimizeDeps: {
+              include: ['wu-framework'],
+            },
+          },
+        });
+      },
+    },
+  };
+}

package/integrations/astro/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@wu-framework/astro",
+  "version": "1.0.0",
+  "description": "Astro integration for wu-framework microfrontends",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./WuApp.astro": "./WuApp.astro",
+    "./WuShell.astro": "./WuShell.astro"
+  },
+  "files": [
+    "index.js",
+    "WuApp.astro",
+    "WuShell.astro",
+    "types.d.ts",
+    "README.md"
+  ],
+  "keywords": [
+    "astro",
+    "astro-integration",
+    "wu-framework",
+    "microfrontends",
+    "micro-frontends"
+  ],
+  "author": "Wu Framework Team",
+  "license": "MIT",
+  "peerDependencies": {
+    "astro": ">=4.0.0",
+    "wu-framework": ">=1.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wu-framework/wu-framework.git",
+    "directory": "integrations/astro"
+  },
+  "homepage": "https://wu-framework.dev/docs/integrations/astro"
+}

package/integrations/astro/types.d.ts

@@ -0,0 +1,53 @@
+import type { AstroIntegration } from 'astro';
+
+/** Configuration for a single wu micro-app. */
+export interface WuAppConfig {
+  /** Unique name used to reference this micro-app. */
+  name: string;
+  /** URL or path from which the micro-app is loaded. */
+  url: string;
+  /** Loading strategy. Defaults to the framework default. */
+  strategy?: 'eager' | 'lazy' | 'manual';
+}
+
+/** Options accepted by the wu Astro integration. */
+export interface WuIntegrationOptions {
+  /** Micro-apps to auto-register via wu.init(). */
+  apps?: WuAppConfig[];
+  /** Global sandbox isolation mode. */
+  sandbox?: 'module' | 'strict' | 'eval';
+  /** CDN URL for the wu-framework UMD bundle. When omitted the local package is used. */
+  cdn?: string;
+  /** Enable debug logging. */
+  debug?: boolean;
+}
+
+/**
+ * Astro integration factory for wu-framework.
+ *
+ * @example
+ * import wu from '@wu-framework/astro';
+ * export default defineConfig({ integrations: [wu({ apps: [...] })] });
+ */
+export default function wuIntegration(
+  options?: WuIntegrationOptions
+): AstroIntegration;
+
+/** Props for the WuShell.astro layout component. */
+export interface WuShellProps {
+  apps: WuAppConfig[];
+  sandbox?: 'module' | 'strict' | 'eval';
+  debug?: boolean;
+}
+
+/** Props for the WuApp.astro mount component. */
+export interface WuAppProps {
+  /** Name of the registered wu micro-app. */
+  name: string;
+  /** Defer mounting until the element is visible (IntersectionObserver). */
+  lazy?: boolean;
+  /** CSS class(es) for the container div. */
+  class?: string;
+  /** Inline styles for the container div. */
+  style?: string;
+}

package/package.json

@@ -1,49 +1,41 @@
 {
   "name": "wu-framework",
-  "version": "1.1.7",
-  "description": "🚀 Universal Microfrontends Framework - 8 frameworks, zero config, Shadow DOM isolation",
-  "main": "dist/wu-framework.min.js",
-  "module": "dist/wu-framework.min.js",
+  "version": "1.1.9",
+  "description": "Universal Microfrontends Framework - 8 frameworks, zero config, Shadow DOM isolation",
+  "main": "dist/wu-framework.cjs.js",
+  "module": "src/index.js",
   "browser": "dist/wu-framework.umd.js",
   "type": "module",
   "exports": {
     ".": {
-      "import": "./dist/wu-framework.min.js",
+      "import": "./src/index.js",
       "require": "./dist/wu-framework.cjs.js",
       "browser": "./dist/wu-framework.umd.js"
     },
-    "./dev": "./dist/wu-framework.dev.js",
-    "./min": "./dist/wu-framework.min.js",
-    "./obf": "./dist/wu-framework.obf.js",
-    "./hex": "./dist/wu-framework.hex.js",
-    "./umd": "./dist/wu-framework.umd.js",
-    "./cjs": "./dist/wu-framework.cjs.js",
+    "./src": "./src/index.js",
     "./adapters": "./src/adapters/index.js",
-    "./adapters/react": "./src/adapters/react.js",
-    "./adapters/vue": "./src/adapters/vue.js",
-    "./adapters/angular": "./src/adapters/angular.js",
-    "./adapters/svelte": "./src/adapters/svelte.js",
-    "./adapters/preact": "./src/adapters/preact.js",
-    "./adapters/solid": "./src/adapters/solid.js",
-    "./adapters/lit": "./src/adapters/lit.js",
-    "./adapters/vanilla": "./src/adapters/vanilla.js"
+    "./adapters/react": "./src/adapters/react/index.js",
+    "./adapters/vue": "./src/adapters/vue/index.js",
+    "./adapters/angular": "./src/adapters/angular/index.js",
+    "./adapters/svelte": "./src/adapters/svelte/index.js",
+    "./adapters/preact": "./src/adapters/preact/index.js",
+    "./adapters/solid": "./src/adapters/solid/index.js",
+    "./adapters/lit": "./src/adapters/lit/index.js",
+    "./adapters/vanilla": "./src/adapters/vanilla/index.js",
+    "./integrations/astro": "./integrations/astro/index.js",
+    "./integrations/astro/WuApp.astro": "./integrations/astro/WuApp.astro",
+    "./integrations/astro/WuShell.astro": "./integrations/astro/WuShell.astro"
   },
   "scripts": {
-    "dev": "node examples/dev-server.js",
-    "start": "npm run dev",
+    "dev": "rollup -c --watch",
     "build": "node scripts/build.js all --clean",
-    "build:dev": "node scripts/build.js dev",
-    "build:prod": "node scripts/build.js prod",
-    "build:obf": "node scripts/build.js obfuscated",
-    "build:hex": "node scripts/build.js hex",
-    "build:umd": "node scripts/build.js umd",
-    "build:cjs": "node scripts/build.js cjs",
+    "build:dev": "rollup -c --environment BUILD_TARGET:dev",
+    "build:prod": "rollup -c --environment BUILD_TARGET:prod",
     "build:all": "node scripts/build.js all --clean",
-    "build:protected": "node scripts/build-protected.js",
-    "build:watch": "node scripts/build.js dev --watch",
     "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
-    "test": "echo 'Tests coming soon'",
-    "lint": "echo 'Linting coming soon'"
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   },
   "keywords": [
     "microfrontends",
@@ -60,10 +52,14 @@
     "shadow-dom",
     "universal",
     "zero-config",
-    "runtime-loading",
-    "component-sharing"
+    "ai",
+    "llm",
+    "webmcp",
+    "mcp",
+    "tool-calling",
+    "byol"
   ],
-  "author": "Wu Framework Team",
+  "author": "Luis Garcia",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -72,9 +68,9 @@
   "bugs": {
     "url": "https://github.com/wu-framework/wu-framework/issues"
   },
-  "homepage": "https://wu-framework.dev",
+  "homepage": "https://www.wu-framework.com",
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=16.0.0"
   },
   "browserslist": [
     "defaults",
@@ -84,54 +80,82 @@
   "files": [
     "src/",
     "dist/",
-    "scripts/",
+    "integrations/",
     "README.md",
     "LICENSE"
   ],
   "typesVersions": {
     "*": {
-      "adapters/react": ["src/adapters/react.d.ts"],
-      "adapters/vue": ["src/adapters/vue.d.ts"],
-      "adapters/angular": ["src/adapters/angular.d.ts"],
-      "adapters/svelte": ["src/adapters/svelte.d.ts"],
-      "adapters/preact": ["src/adapters/preact.d.ts"],
-      "adapters/solid": ["src/adapters/solid.d.ts"],
-      "adapters/lit": ["src/adapters/lit.d.ts"],
-      "adapters/vanilla": ["src/adapters/vanilla.d.ts"]
+      "adapters/react": [
+        "src/adapters/react/index.d.ts"
+      ],
+      "adapters/vue": [
+        "src/adapters/vue/index.d.ts"
+      ],
+      "adapters/angular": [
+        "src/adapters/angular/index.d.ts"
+      ],
+      "adapters/svelte": [
+        "src/adapters/svelte/index.d.ts"
+      ],
+      "adapters/preact": [
+        "src/adapters/preact/index.d.ts"
+      ],
+      "adapters/solid": [
+        "src/adapters/solid/index.d.ts"
+      ],
+      "adapters/lit": [
+        "src/adapters/lit/index.d.ts"
+      ],
+      "adapters/vanilla": [
+        "src/adapters/vanilla/index.d.ts"
+      ]
     }
   },
-  "dependencies": {},
   "devDependencies": {
-    "rollup": "^4.9.0",
-    "@rollup/plugin-node-resolve": "^15.2.3",
     "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-replace": "^5.0.5",
     "@rollup/plugin-terser": "^0.4.4",
-    "terser": "^5.27.0",
-    "rollup-plugin-obfuscator": "^1.1.0",
-    "javascript-obfuscator": "^4.1.0"
+    "@vitest/coverage-v8": "^4.0.18",
+    "jsdom": "^28.0.0",
+    "rollup": "^4.9.0",
+    "vitest": "^4.0.18"
   },
-  "peerDependencies": {},
-  "optionalDependencies": {},
-  "funding": {
-    "type": "github",
-    "url": "https://github.com/sponsors/wu-framework"
+  "peerDependencies": {
+    "@angular/core": ">=14.0.0",
+    "lit": ">=2.0.0",
+    "preact": ">=10.0.0",
+    "react": ">=16.8.0",
+    "react-dom": ">=16.8.0",
+    "solid-js": ">=1.0.0",
+    "svelte": ">=3.0.0",
+    "vue": ">=3.0.0"
   },
-  "wu": {
-    "framework": true,
-    "version": "1.1.0",
-    "features": [
-      "universal-microfrontends",
-      "shadow-dom-isolation",
-      "zero-configuration",
-      "framework-agnostic",
-      "runtime-loading",
-      "component-sharing",
-      "8-framework-adapters"
-    ],
-    "compatibility": {
-      "frameworks": ["react", "vue", "angular", "svelte", "preact", "solid", "lit", "vanilla"],
-      "bundlers": ["vite", "webpack", "rollup", "parcel", "esbuild"],
-      "browsers": ["chrome", "firefox", "safari", "edge"]
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    },
+    "@angular/core": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    },
+    "preact": {
+      "optional": true
+    },
+    "lit": {
+      "optional": true
     }
   }
 }

package/src/adapters/angular/ai.js

@@ -0,0 +1,30 @@
+/**
+ * WU-FRAMEWORK ANGULAR AI INTEGRATION
+ */
+function getWuInstance() {
+  if (typeof window === 'undefined') return null;
+  return window.wu || window.parent?.wu || window.top?.wu || null;
+}
+
+export function createWuAIService(options = {}) {
+  const { namespace = 'default' } = options;
+  const state = { messages: [], isStreaming: false, error: null };
+  return {
+    get messages() { return [...state.messages]; },
+    get isStreaming() { return state.isStreaming; },
+    get error() { return state.error; },
+    async send(text) {
+      if (!text?.trim()) return null;
+      const wu = getWuInstance();
+      if (!wu?.ai) { state.error = 'Wu AI not available'; return null; }
+      state.messages.push({ id: `user-${Date.now()}`, role: 'user', content: text, timestamp: Date.now() });
+      state.isStreaming = true; state.error = null;
+      try {
+        const res = await wu.ai.send(text, { namespace });
+        state.messages.push({ id: `assistant-${Date.now()}`, role: 'assistant', content: res.content, timestamp: Date.now() });
+        state.isStreaming = false; return res;
+      } catch (err) { state.error = err.message; state.isStreaming = false; return null; }
+    },
+    clear() { state.messages.length = 0; state.error = null; },
+  };
+}