wu-framework 1.1.15 → 1.1.16

package/integrations/astro/README.md

@@ -1,127 +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
+# @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

@@ -1,63 +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>
+---
+/**
+ * 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

@@ -1,39 +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>
+---
+/**
+ * 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

@@ -1,68 +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'],
-            },
-          },
-        });
-      },
-    },
-  };
-}
+/**
+ * @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

@@ -1,38 +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"
-}
+{
+  "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"
+}