@rollipop/plugin-module-federation 1.0.0-beta.1 → 1.0.0-beta.2

package/README.md

@@ -1,28 +1,19 @@
 # @rollipop/plugin-module-federation
 
-Module Federation for Rollipop. Wires `@module-federation/runtime` into the host bundle and registers each remote's container on `globalThis`, with shared dependencies resolved through a host-owned global registry.
+Share modules and dependencies between React Native bundles.
 
 ## Status
 
-> **Initial implementation.** This plugin is an early-stage feature. The public
-> API and the bundle layout may change, and the role model is intentionally
-> narrower than standard Module Federation — see [Roles](#roles) and
-> [Constraints](#constraints).
->
-> Notably, a single config takes exactly one role (host **or** remote). Standard
-> (web) Module Federation lets one build both `expose` modules and `consume`
-> remotes; that bidirectional / chained-federation model is **not supported
-> yet**. Lifting it requires emitting the federation container as a separate
-> artifact from the app bundle, which is not implemented at this stage.
+> Experimental: the API and bundle layout may change. A config cannot both consume and expose remotes.
 
 ## Roles
 
 A single Rollipop config takes one role. Defining both `remotes` and `exposes` throws.
 
-| Role   | Has       | Bundle output                                                 |
-| ------ | --------- | ------------------------------------------------------------- |
-| Host   | `remotes` | Normal Rollipop bundle that consumes remotes at runtime.      |
-| Remote | `exposes` | IIFE for static builds; Rollipop format with HMR when served. |
+| Role   | Option    | Purpose                                                |
+| ------ | --------- | ------------------------------------------------------ |
+| Host   | `remotes` | Loads remote modules and provides shared dependencies. |
+| Remote | `exposes` | Exposes modules to hosts.                              |
 
 ## Host
 
@@ -36,7 +27,7 @@ import { federation } from '@rollipop/plugin-module-federation';
 import { defineConfig } from 'rollipop';
 
 export default defineConfig({
-  entry: 'src/host/index.js',
+  entry: 'src/host/index.ts',
   plugins: [
     federation({
       name: 'host_app',
@@ -48,8 +39,6 @@ export default defineConfig({
         'react-native': { singleton: true, eager: true, requiredVersion: '0.84.1' },
       },
       runtime: {
-        // Register a `ModuleFederationScriptLoader` on `globalThis.__rollipop_script_loader__`.
-        // Typically delegates to a native TurboModule that does fetch + JSI evaluate.
         implement: `
           const NativeScriptManager = globalThis.nativeModuleProxy.ScriptManager;
           globalThis.__rollipop_script_loader__ = {
@@ -74,9 +63,7 @@ const RemoteNavigator = React.lazy(() =>
 );
 ```
 
-The imported module's default export is a React component proxy. Rendering it loads the remote
-through the federation runtime and suspends while the request is pending, so render it inside a
-React `Suspense` boundary. The bundled code does not use native `import()` to fetch the remote.
+Render the imported component inside a React `Suspense` boundary while it loads.
 
 Failed remote loads are thrown to the nearest React Error Boundary. From its retry action,
 reload the remote before resetting the boundary:
@@ -88,8 +75,7 @@ await retryRemote('remote_app/RemoteNavigator');
 resetErrorBoundary();
 ```
 
-Concurrent loads share one request. If a retry fails, the promise rejects and the boundary
-can keep showing its fallback until the user retries again.
+Pass the import alias and exposed path to `retryRemote`. Failed retries reject.
 
 ## Remote
 
@@ -99,7 +85,7 @@ import { federation } from '@rollipop/plugin-module-federation';
 import { defineConfig } from 'rollipop';
 
 export default defineConfig({
-  entry: 'src/remote/index.js',
+  entry: 'src/remote/index.ts',
   plugins: [
     federation({
       name: 'remote_app',
@@ -115,11 +101,7 @@ export default defineConfig({
 });
 ```
 
-Static builds emit an IIFE; the dev server uses Rollipop's format so each remote has its own HMR
-runtime. Each shared dependency import (e.g. `import RN from 'react-native'`) is replaced with a
-stub that reads from the host's `globalThis.__rollipop_shared__` registry and throws if the
-dependency is not registered. Rollipop's prelude and polyfills are skipped because the host has
-already initialized the React Native runtime.
+Remotes support HMR when served by the development server.
 
 ## Script loader contract
 
@@ -131,26 +113,14 @@ export interface ModuleFederationScriptLoader {
 }
 ```
 
-The host registers an implementation on `globalThis.__rollipop_script_loader__`. The plugin's MF runtime adapter delegates `loadEntry` to it. After the script is evaluated the container is read back from `globalThis[<entryGlobalName>]`.
-
-## Globals exposed at runtime
-
-| Global                                 | Owner  | Purpose                                                                              |
-| -------------------------------------- | ------ | ------------------------------------------------------------------------------------ |
-| `__rollipop_script_loader__`           | user   | `ModuleFederationScriptLoader` implementation.                                       |
-| `__rollipop_shared__`                  | host   | Shared dependency registry populated during host initialization; missing keys throw. |
-| `__rollipop_module_federation_cache__` | plugin | Internal cache of loaded modules, pending requests, and load errors.                 |
-
-Use `retryRemote` from `@rollipop/plugin-module-federation/runtime` to retry a failed request.
+Register a loader on `globalThis.__rollipop_script_loader__`. Its `loadScript` method must download and evaluate the bundle before resolving.
 
 ## Constraints
 
-- A single config cannot define both `remotes` and `exposes` — this is a
-  current-implementation limitation, not an inherent Module Federation rule.
-  Split a host and a remote into two configs and run them as separate Rollipop
-  processes. See [Status](#status).
-- Remote imports expose a default React component proxy. Dynamic `import('<remote>/<expose>')`
-  returns that proxy, rather than the remote module's namespace directly.
-- Subpath imports of shared deps (`react/jsx-dev-runtime`, etc.) are bundled into the remote and consume the parent shared instance through `__rollipop_shared__`.
+- A config cannot define both `remotes` and `exposes`. Run hosts and remotes as separate Rollipop processes.
+- Remote imports support default React component exports.
+- Shared dependency subpaths (such as `react/jsx-dev-runtime`) are bundled separately in each remote.
+
+See `examples/module-federation` for a working RN 0.84 host + remote setup with a Kotlin/JNI and Obj-C++ script loader.
 
-See `examples/module-federation` for a working RN 0.84 host + remote setup with a Pure C++/Obj-C++ TurboModule script loader.
+See [Configuration](https://rollipop.dev/docs/features/module-federation#configuration) for remote syntax, shared dependencies, and `shareStrategy`.

package/dist/index.js

@@ -361,11 +361,11 @@ function moduleFederationPlugin(config) {
 		load: {
 			filter: [include(id(prefixRegex(VIRTUAL_PREFIX)))],
 			handler(id) {
-				if (id.startsWith(VIRTUAL_SHARED_SHIM_PREFIX)) return {
+				if (id.startsWith("\0rollipop:module-federation:shared:")) return {
 					code: generateSharedShimCode(id.slice(VIRTUAL_SHARED_SHIM_PREFIX.length)),
 					moduleType: "js"
 				};
-				if (id.startsWith(VIRTUAL_REMOTE_PROXY_PREFIX)) return {
+				if (id.startsWith("\0rollipop:module-federation:remote:")) return {
 					code: generateRemoteProxyCode({ remoteId: id.slice(VIRTUAL_REMOTE_PROXY_PREFIX.length) }),
 					moduleType: "js"
 				};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rollipop/plugin-module-federation",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.2",
   "homepage": "https://github.com/rollipop-dev/rollipop#readme",
   "bugs": {
     "url": "https://github.com/rollipop-dev/rollipop/issues"
@@ -36,21 +36,22 @@
     "build": "vp pack"
   },
   "dependencies": {
-    "@module-federation/runtime": "2.9.1",
+    "@module-federation/runtime": "2.9.2",
     "dedent": "1.7.2",
     "es-toolkit": "1.52.0"
   },
   "devDependencies": {
     "@types/react": "19.2.14",
-    "@vitest/coverage-v8": "4.1.11",
+    "@vitest/coverage-v8": "5.0.5",
     "react": "19.2.3",
-    "rollipop": "1.0.0-beta.1",
+    "rollipop": "1.0.0-beta.2",
     "typescript": "7.0.2",
-    "vite-plus": "0.3.3",
-    "vitest": "4.1.11"
+    "vite": "@voidzero-dev/vite-plus-core@1.3.0",
+    "vite-plus": "1.3.0",
+    "vitest": "5.0.5"
   },
   "peerDependencies": {
-    "rollipop": "1.0.0-beta.1"
+    "rollipop": "1.0.0-beta.2"
   },
   "installConfig": {
     "hoistingLimits": "none"