@granite-js/micro-frontend 2.5.5 → 3.0.0

package/dist/module/runtime/sharedModule.js

@@ -0,0 +1,22 @@
+"use strict";
+
+// Keep this helper self-contained so runtime and generated registrations stay identical.
+export function registerSharedValue(sharedModules, moduleName, module, normalize) {
+  // Preserve original identity across independently bundled runtimes.
+  const sourceKey = Symbol.for('granite.microFrontend.sharedModuleSource');
+  const existingModule = sharedModules[moduleName];
+  if (existingModule != null) {
+    return typeof existingModule === 'object' && typeof existingModule.get === 'function' && typeof existingModule.loaded === 'boolean' && (Object.is(existingModule.get(), module) || Object.prototype.hasOwnProperty.call(existingModule, sourceKey) && Object.is(Reflect.get(existingModule, sourceKey), module));
+  }
+  const value = normalize(module);
+  const entry = {
+    get: () => value,
+    loaded: true
+  };
+  Object.defineProperty(entry, sourceKey, {
+    value: module
+  });
+  sharedModules[moduleName] = entry;
+  return true;
+}
+//# sourceMappingURL=sharedModule.js.map

package/dist/module/runtime/sharedModule.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["registerSharedValue","sharedModules","moduleName","module","normalize","sourceKey","Symbol","for","existingModule","get","loaded","Object","is","prototype","hasOwnProperty","call","Reflect","value","entry","defineProperty"],"sourceRoot":"../../../src","sources":["runtime/sharedModule.ts"],"mappings":";;AAAA;AACA,OAAO,SAASA,mBAAmBA,CACjCC,aAAwF,EACxFC,UAAkB,EAClBC,MAAe,EACfC,SAAsC,EAC7B;EACT;EACA,MAAMC,SAAS,GAAGC,MAAM,CAACC,GAAG,CAAC,0CAA0C,CAAC;EACxE,MAAMC,cAAc,GAAGP,aAAa,CAACC,UAAU,CAAC;EAChD,IAAIM,cAAc,IAAI,IAAI,EAAE;IAC1B,OACE,OAAOA,cAAc,KAAK,QAAQ,IAClC,OAAOA,cAAc,CAACC,GAAG,KAAK,UAAU,IACxC,OAAOD,cAAc,CAACE,MAAM,KAAK,SAAS,KACzCC,MAAM,CAACC,EAAE,CAACJ,cAAc,CAACC,GAAG,CAAC,CAAC,EAAEN,MAAM,CAAC,IACrCQ,MAAM,CAACE,SAAS,CAACC,cAAc,CAACC,IAAI,CAACP,cAAc,EAAEH,SAAS,CAAC,IAC9DM,MAAM,CAACC,EAAE,CAACI,OAAO,CAACP,GAAG,CAACD,cAAc,EAAEH,SAAS,CAAC,EAAEF,MAAM,CAAE,CAAC;EAEnE;EACA,MAAMc,KAAK,GAAGb,SAAS,CAACD,MAAM,CAAC;EAC/B,MAAMe,KAAK,GAAG;IAAET,GAAG,EAAEA,CAAA,KAAMQ,KAAK;IAAEP,MAAM,EAAE;EAAK,CAAC;EAChDC,MAAM,CAACQ,cAAc,CAACD,KAAK,EAAEb,SAAS,EAAE;IAAEY,KAAK,EAAEd;EAAO,CAAC,CAAC;EAC1DF,aAAa,CAACC,UAAU,CAAC,GAAGgB,KAAK;EACjC,OAAO,IAAI;AACb","ignoreList":[]}

package/dist/module/session/MicroFrontendSessionContext.js.map

@@ -1 +1 @@
-{"version":3,"names":["VisibilityChangedProvider","createContext","useContext","useMemo","jsx","_jsx","MicroFrontendSessionContext","MissingMicroFrontendSessionError","Error","constructor","name","MicroFrontendSessionProvider","props","value","sessionId","Provider","children","isVisible","presentationVisibility","useMicroFrontendSession","session"],"sourceRoot":"../../../src","sources":["session/MicroFrontendSessionContext.tsx"],"mappings":";;AAAA,SAASA,yBAAyB,QAAQ,0BAA0B;AACpE,SAASC,aAAa,EAAEC,UAAU,EAAEC,OAAO,QAA2C,OAAO;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAW9F,MAAMC,2BAA2B,gBAAGL,aAAa,CAA8B,IAAI,CAAC;AAEpF,OAAO,MAAMM,gCAAgC,SAASC,KAAK,CAAC;EAC1DC,WAAWA,CAAA,EAAG;IACZ,KAAK,CAAC,0EAA0E,CAAC;IACjF,IAAI,CAACC,IAAI,GAAG,kCAAkC;EAChD;AACF;AAEA,OAAO,SAASC,4BAA4BA,CAACC,KAAwC,EAAgB;EACnG,MAAMC,KAAK,GAAGV,OAAO,CACnB,OAAO;IACLW,SAAS,EAAEF,KAAK,CAACE;EACnB,CAAC,CAAC,EACF,CAACF,KAAK,CAACE,SAAS,CAClB,CAAC;EAED,oBACET,IAAA,CAACC,2BAA2B,CAACS,QAAQ;IAACF,KAAK,EAAEA,KAAM;IAAAG,QAAA,eACjDX,IAAA,CAACL,yBAAyB;MAACiB,SAAS,EAAEL,KAAK,CAACM,sBAAuB;MAAAF,QAAA,EAChEJ,KAAK,CAACI;IAAQ,CACU;EAAC,CACQ,CAAC;AAE3C;AAEA,OAAO,SAASG,uBAAuBA,CAAA,EAAyB;EAC9D,MAAMC,OAAO,GAAGlB,UAAU,CAACI,2BAA2B,CAAC;EACvD,IAAIc,OAAO,IAAI,IAAI,EAAE;IACnB,MAAM,IAAIb,gCAAgC,CAAC,CAAC;EAC9C;EACA,OAAOa,OAAO;AAChB","ignoreList":[]}
+{"version":3,"names":["VisibilityChangedProvider","createContext","useContext","useMemo","jsx","_jsx","MicroFrontendSessionContext","MissingMicroFrontendSessionError","Error","constructor","name","MicroFrontendSessionProvider","props","value","sessionId","Provider","children","isVisible","presentationVisibility","useMicroFrontendSession","session"],"sourceRoot":"../../../src","sources":["session/MicroFrontendSessionContext.tsx"],"mappings":";;AAAA,SAASA,yBAAyB,QAAQ,0BAA0B;AACpE,SAASC,aAAa,EAAEC,UAAU,EAAEC,OAAO,QAA2C,OAAO;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAW9F,MAAMC,2BAA2B,gBAAGL,aAAa,CAA8B,IAAI,CAAC;AAEpF,OAAO,MAAMM,gCAAgC,SAASC,KAAK,CAAC;EAC1DC,WAAWA,CAAA,EAAG;IACZ,KAAK,CAAC,0EAA0E,CAAC;IACjF,IAAI,CAACC,IAAI,GAAG,kCAAkC;EAChD;AACF;AAEA,OAAO,SAASC,4BAA4BA,CAACC,KAAwC,EAAgB;EACnG,MAAMC,KAAK,GAAGV,OAAO,CACnB,OAAO;IACLW,SAAS,EAAEF,KAAK,CAACE;EACnB,CAAC,CAAC,EACF,CAACF,KAAK,CAACE,SAAS,CAClB,CAAC;EAED,oBACET,IAAA,CAACC,2BAA2B,CAACS,QAAQ;IAACF,KAAK,EAAEA,KAAM;IAAAG,QAAA,eACjDX,IAAA,CAACL,yBAAyB;MAACiB,SAAS,EAAEL,KAAK,CAACM,sBAAuB;MAAAF,QAAA,EAAEJ,KAAK,CAACI;IAAQ,CAA4B;EAAC,CAC5E,CAAC;AAE3C;AAEA,OAAO,SAASG,uBAAuBA,CAAA,EAAyB;EAC9D,MAAMC,OAAO,GAAGlB,UAAU,CAACI,2BAA2B,CAAC;EACvD,IAAIc,OAAO,IAAI,IAAI,EAAE;IACnB,MAAM,IAAIb,gCAAgC,CAAC,CAAC;EAC9C;EACA,OAAOa,OAAO;AAChB","ignoreList":[]}

package/dist/module/specs/PortalHostViewNativeComponent.ts

@@ -1,9 +1,9 @@
-import { codegenNativeComponent, type ViewProps } from "react-native";
+import { codegenNativeComponent, type ViewProps } from 'react-native';
 
 interface NativeProps extends ViewProps {
   readonly name?: string;
 }
 
-export default codegenNativeComponent<NativeProps>("PortalHostView", {
+export default codegenNativeComponent<NativeProps>('PortalHostView', {
   interfaceOnly: true,
 });

package/dist/module/specs/PortalViewNativeComponent.ts

@@ -1,9 +1,9 @@
-import { codegenNativeComponent, type ViewProps } from "react-native";
+import { codegenNativeComponent, type ViewProps } from 'react-native';
 
 interface NativeProps extends ViewProps {
   readonly hostName: string;
 }
 
-export default codegenNativeComponent<NativeProps>("PortalView", {
+export default codegenNativeComponent<NativeProps>('PortalView', {
   interfaceOnly: true,
 });

package/dist/typescript/host/index.d.ts

@@ -1,5 +1,5 @@
 export type { PendingHostComponentController, PendingHostComponentProps } from './PendingHostComponent';
 export { PendingHostComponent, usePendingHostComponentController, useIsPendingHostComponentHidden, useResolvedPendingHostComponent, } from './PendingHostComponent';
 export type { PendingHostComponentAppConfig, PendingHostComponentRenderer, PendingHostComponentParams, PendingHostComponentRouteRequest, RegisterPendingHostComponentRouteOptions, ResolvedPendingHostComponent, } from './types';
-export { createPendingHostComponentRoutePrefix, normalizeRoutePath, } from './routeMatcher';
+export { createPendingHostComponentRoutePrefix, normalizeRoutePath } from './routeMatcher';
 export { hidePendingHostComponent, installPendingHostComponentBridge, registerPendingHostComponentRoute, resetPendingHostComponent, resolvePendingHostComponent, } from './pendingHostComponentStore';

package/dist/typescript/index.d.ts

@@ -6,7 +6,7 @@ export { findAppNameBySourceURL, getAppName } from './runtime/getAppName';
 export type { PendingHostComponentController, PendingHostComponentProps } from './host/PendingHostComponent';
 export { PendingHostComponent, usePendingHostComponentController, useIsPendingHostComponentHidden, useResolvedPendingHostComponent, } from './host/PendingHostComponent';
 export type { PendingHostComponentAppConfig, PendingHostComponentRenderer, PendingHostComponentParams, PendingHostComponentRouteRequest, RegisterPendingHostComponentRouteOptions, ResolvedPendingHostComponent, } from './host/types';
-export { createPendingHostComponentRoutePrefix, normalizeRoutePath, } from './host/routeMatcher';
+export { createPendingHostComponentRoutePrefix, normalizeRoutePath } from './host/routeMatcher';
 export { hidePendingHostComponent, installPendingHostComponentBridge, registerPendingHostComponentRoute, resetPendingHostComponent, resolvePendingHostComponent, } from './host/pendingHostComponentStore';
 export { MicroFrontendSessionProvider, MissingMicroFrontendSessionError, useMicroFrontendSession, } from './session/MicroFrontendSessionContext';
 export type { MicroFrontendSession, MicroFrontendSessionProviderProps } from './session/MicroFrontendSessionContext';

package/dist/typescript/next/index.d.ts

@@ -0,0 +1,4 @@
+import type { PluginOption } from 'rollipop';
+import type { MicroFrontendPluginOptions } from './types';
+export declare function microFrontend(options: MicroFrontendPluginOptions): PluginOption;
+export type { MicroFrontendPluginOptions } from './types';

package/dist/typescript/next/types.d.ts

@@ -0,0 +1,6 @@
+import type { SharedConfig } from '../runtime/registry';
+export interface MicroFrontendPluginOptions {
+    appName: string;
+    shared?: SharedConfig | readonly string[];
+    exposes?: Readonly<Record<string, string>>;
+}

package/dist/typescript/plugin-utils/intoShared.d.ts

@@ -0,0 +1,2 @@
+import type { SharedConfig } from '../runtime/registry';
+export declare function intoShared(shared: SharedConfig | readonly string[] | undefined): SharedConfig | undefined;

package/dist/typescript/plugin-utils/prelude.d.ts

@@ -0,0 +1,11 @@
+import type { SharedConfig } from '../runtime/registry';
+interface MicroFrontendPreludeOptions {
+    readonly shared?: SharedConfig | readonly string[];
+    readonly exposes?: Readonly<Record<string, string>>;
+}
+export interface MicroFrontendPreludeConfig {
+    readonly banner: string;
+    readonly preludeScript: string;
+}
+export declare function getPreludeConfig(options: MicroFrontendPreludeOptions, appName?: string): MicroFrontendPreludeConfig;
+export {};

package/dist/typescript/runtime/legacyEsm.d.ts

@@ -0,0 +1 @@
+export declare function toLegacyEsm(module: unknown): unknown;

package/dist/typescript/runtime/sharedModule.d.ts

@@ -0,0 +1,4 @@
+export declare function registerSharedValue(sharedModules: Record<string, {
+    readonly get: () => unknown;
+    readonly loaded: boolean;
+}>, moduleName: string, module: unknown, normalize: (value: unknown) => unknown): boolean;

package/dist/typescript/specs/PortalHostViewNativeComponent.d.ts

@@ -1,4 +1,4 @@
-import { type ViewProps } from "react-native";
+import { type ViewProps } from 'react-native';
 interface NativeProps extends ViewProps {
     readonly name?: string;
 }

package/dist/typescript/specs/PortalViewNativeComponent.d.ts

@@ -1,4 +1,4 @@
-import { type ViewProps } from "react-native";
+import { type ViewProps } from 'react-native';
 interface NativeProps extends ViewProps {
     readonly hostName: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@granite-js/micro-frontend",
-  "version": "2.5.5",
+  "version": "3.0.0",
   "description": "Micro-frontend build, runtime, session, and Portal contracts for Granite brownfield applications",
   "main": "./dist/module/index.js",
   "types": "./dist/typescript/index.d.ts",
@@ -12,6 +12,10 @@
       "default": "./dist/module/index.js"
     },
     "./plugin": {
+      "types": "./dist/typescript/next/index.d.ts",
+      "default": "./dist/module/next/index.js"
+    },
+    "./plugin-mpack": {
       "types": "./dist/typescript/plugin/index.d.ts",
       "default": "./dist/module/plugin/index.js"
     },
@@ -56,24 +60,28 @@
   },
   "dependencies": {
     "@babel/core": "7.28.5",
-    "@granite-js/utils": "2.5.5",
+    "@granite-js/utils": "3.0.0",
     "@standard-schema/spec": "^1.0.0"
   },
   "peerDependencies": {
     "@granite-js/plugin-core": "*",
     "@granite-js/react-native": "*",
     "react": "*",
-    "react-native": "*"
+    "react-native": "*",
+    "rollipop": "*"
   },
   "peerDependenciesMeta": {
     "@granite-js/plugin-core": {
       "optional": true
+    },
+    "rollipop": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@babel/types": "7.28.5",
-    "@granite-js/plugin-core": "2.5.5",
-    "@granite-js/react-native": "2.5.5",
+    "@granite-js/plugin-core": "3.0.0",
+    "@granite-js/react-native": "3.0.0",
     "@types/babel__core": "^7.20.5",
     "@types/node": "24.10.12",
     "@types/react": "19.2.0",
@@ -82,6 +90,7 @@
     "react-native": "0.84.0",
     "react-native-builder-bob": "0.40.17",
     "react-test-renderer": "19.2.3",
+    "rollipop": "1.0.0-alpha.32",
     "typescript": "5.9.3",
     "vitest": "^4.0.12"
   },

package/react-native.config.js

@@ -2,10 +2,7 @@ module.exports = {
   dependency: {
     platforms: {
       android: {
-        componentDescriptors: [
-          'PortalViewComponentDescriptor',
-          'PortalHostViewComponentDescriptor',
-        ],
+        componentDescriptors: ['PortalViewComponentDescriptor', 'PortalHostViewComponentDescriptor'],
         cmakeListsPath: '../android/src/main/jni/CMakeLists.txt',
       },
     },

package/src/host/PendingHostComponent.tsx

@@ -21,11 +21,19 @@ export interface PendingHostComponentController {
 }
 
 export function useIsPendingHostComponentHidden() {
-  return useSyncExternalStore(subscribePendingHostComponentStore, getIsPendingHostComponentHidden, getIsPendingHostComponentHidden);
+  return useSyncExternalStore(
+    subscribePendingHostComponentStore,
+    getIsPendingHostComponentHidden,
+    getIsPendingHostComponentHidden
+  );
 }
 
 function usePendingHostComponentStoreVersion() {
-  return useSyncExternalStore(subscribePendingHostComponentStore, getPendingHostComponentStoreVersion, getPendingHostComponentStoreVersion);
+  return useSyncExternalStore(
+    subscribePendingHostComponentStore,
+    getPendingHostComponentStoreVersion,
+    getPendingHostComponentStoreVersion
+  );
 }
 
 export function useResolvedPendingHostComponent(url: string | null | undefined) {

package/src/host/index.ts

@@ -13,10 +13,7 @@ export type {
   RegisterPendingHostComponentRouteOptions,
   ResolvedPendingHostComponent,
 } from './types';
-export {
-  createPendingHostComponentRoutePrefix,
-  normalizeRoutePath,
-} from './routeMatcher';
+export { createPendingHostComponentRoutePrefix, normalizeRoutePath } from './routeMatcher';
 export {
   hidePendingHostComponent,
   installPendingHostComponentBridge,

package/src/host/resolveParams.ts

@@ -27,7 +27,7 @@ export function resolvePendingHostComponentParams(
       if (result.issues != null) {
         return {
           status: 'invalid',
-          cause: new Error(result.issues.map(issue => issue.message).join(', ')),
+          cause: new Error(result.issues.map((issue) => issue.message).join(', ')),
         };
       }
 

package/src/host/types.ts

@@ -20,9 +20,7 @@ export interface PendingHostComponentAppConfig {
   readonly host?: string | null;
 }
 
-export interface RegisterPendingHostComponentRouteOptions<
-  TParams extends Readonly<object> | undefined = undefined,
-> {
+export interface RegisterPendingHostComponentRouteOptions<TParams extends Readonly<object> | undefined = undefined> {
   readonly component: PendingHostComponentRenderer<TParams>;
   readonly parserParams?: ParserParams;
   readonly validateParams?: ValidateParams<TParams>;

package/src/index.ts

@@ -18,10 +18,7 @@ export type {
   RegisterPendingHostComponentRouteOptions,
   ResolvedPendingHostComponent,
 } from './host/types';
-export {
-  createPendingHostComponentRoutePrefix,
-  normalizeRoutePath,
-} from './host/routeMatcher';
+export { createPendingHostComponentRoutePrefix, normalizeRoutePath } from './host/routeMatcher';
 export {
   hidePendingHostComponent,
   installPendingHostComponentBridge,

package/src/next/README.md

@@ -0,0 +1,15 @@
+# Rollipop
+
+```ts
+import { microFrontend } from '@granite-js/micro-frontend/plugin';
+
+const plugins = [
+  microFrontend({
+    appName: 'my-service',
+    shared: ['react', 'react-native'],
+    exposes: { './App': './src/App.tsx' },
+  }),
+];
+```
+
+Hosts use `shared: { react: { eager: true } }` to register bundled modules. Remotes resolve non-eager modules from the shared registry. Shared exports remain live, and disposal callbacks are scoped to the application.

package/src/next/index.ts

@@ -0,0 +1,107 @@
+import * as path from 'node:path';
+import type { Plugin, PluginOption } from 'rollipop';
+import { code, include } from 'rollipop/filter';
+import type { MicroFrontendPluginOptions } from './types';
+import { transformDisposeOwnership } from '../plugin-utils/disposeTransform';
+import { intoShared } from '../plugin-utils/intoShared';
+import { getPreludeConfig } from '../plugin-utils/prelude';
+import type { SharedConfig } from '../runtime/registry';
+
+const PRELUDE = '\0granite:micro-frontend';
+const SHARED = '\0granite:shared:';
+
+export function microFrontend(options: MicroFrontendPluginOptions): PluginOption {
+  const shared = intoShared(options.shared);
+  const external = new Set(
+    Object.entries(shared ?? {})
+      .filter(([, value]) => value.eager !== true)
+      .map(([name]) => name)
+  );
+  return [prelude(options, shared), external.size > 0 && sharedModules(external), dispose(options.appName)];
+}
+
+function prelude(options: MicroFrontendPluginOptions, shared: SharedConfig | undefined): Plugin {
+  let prelude = '';
+
+  return {
+    name: 'granite:micro-frontend:prelude',
+    config(config) {
+      const root = config.root ?? process.cwd();
+      const exposes = Object.fromEntries(
+        Object.entries(options.exposes ?? {}).map(([name, file]) => [name, path.resolve(root, file)])
+      );
+      const generated = getPreludeConfig({ ...options, shared, exposes }, options.appName);
+      prelude = generated.preludeScript;
+      // Must run before the native-module proxy and before any exposed app module.
+      config.polyfills = [
+        { type: 'plain', code: `var global = globalThis;\n${generated.banner}` },
+        ...(config.polyfills ?? []),
+      ];
+      return { prelude: [PRELUDE] };
+    },
+    resolveId: {
+      filter: { id: /^\0granite:micro-frontend$/ },
+      handler() {
+        return PRELUDE;
+      },
+    },
+    load: {
+      filter: { id: /^\0granite:micro-frontend$/ },
+      handler() {
+        return prelude;
+      },
+    },
+  };
+}
+
+function sharedModules(external: ReadonlySet<string>): Plugin {
+  const externalPattern = new RegExp(
+    `^(?:${[...external].map((value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')).join('|')})$`
+  );
+
+  return {
+    name: 'granite:micro-frontend:shared-modules',
+    resolveId: {
+      filter: { id: externalPattern },
+      handler(source) {
+        return external.has(source) ? `${SHARED}${source}` : undefined;
+      },
+    },
+    load: {
+      filter: { id: /^\0granite:shared:/ },
+      handler(id) {
+        const name = JSON.stringify(id.slice(SHARED.length));
+        return `
+          var shared = globalThis.__MICRO_FRONTEND__.__SHARED__[${name}];
+          if (!shared) throw new Error('Shared module ' + ${name} + ' is not registered');
+          var original = shared.get();
+          var facade = {};
+          if (original != null) for (const key of Reflect.ownKeys(original)) {
+            if (key === '__esModule' || !Object.getOwnPropertyDescriptor(original, key)?.enumerable) continue;
+            Object.defineProperty(facade, key, { enumerable: true, configurable: true,
+              get() { return original[key]; },
+              set(value) { Object.defineProperty(facade, key, { value, writable: true, enumerable: true, configurable: true }); }
+            });
+          }
+          Object.defineProperty(facade, '__esModule', { value: true, writable: true, enumerable: true, configurable: true });
+          module.exports = facade;
+        `;
+      },
+    },
+  };
+}
+
+function dispose(appName: string): Plugin {
+  return {
+    name: 'granite:micro-frontend:dispose',
+    transform: {
+      filter: [include(code(/(?:global|globalThis)\.__MICRO_FRONTEND__\.dispose/))],
+      handler(source, id) {
+        const transformed = transformDisposeOwnership(id, source, { appName });
+        return source === transformed ? null : { code: transformed, map: null };
+      },
+    },
+  };
+}
+
+export type { MicroFrontendPluginOptions } from './types';

package/src/next/types.ts

@@ -0,0 +1,7 @@
+import type { SharedConfig } from '../runtime/registry';
+
+export interface MicroFrontendPluginOptions {
+  appName: string;
+  shared?: SharedConfig | readonly string[];
+  exposes?: Readonly<Record<string, string>>;
+}

package/src/plugin/microFrontendPlugin.ts

@@ -2,12 +2,12 @@ import * as fs from 'fs';
 import * as path from 'path';
 import type { GranitePluginCore } from '@granite-js/plugin-core';
 import { prepareLocalDirectory } from '@granite-js/utils';
-import type { DisposeOwnershipPluginOptions } from './disposeBabelPlugin';
-import { transformDisposeOwnership } from './disposeTransform';
-import { intoShared } from './intoShared';
-import { getPreludeConfig } from './prelude';
 import { createSharedResolverConfig } from './resolver';
 import type { MicroFrontendPluginOptions } from './types';
+import type { DisposeOwnershipPluginOptions } from '../plugin-utils/disposeBabelPlugin';
+import { transformDisposeOwnership } from '../plugin-utils/disposeTransform';
+import { intoShared } from '../plugin-utils/intoShared';
+import { getPreludeConfig } from '../plugin-utils/prelude';
 
 export async function microFrontend(options: MicroFrontendPluginOptions = {}): Promise<GranitePluginCore> {
   const shared = intoShared(options.shared);
@@ -18,8 +18,7 @@ export async function microFrontend(options: MicroFrontendPluginOptions = {}): P
   const nonEagerEntries = Object.entries(shared ?? {}).filter(([, config]) => config.eager !== true);
   const localDirectory = prepareLocalDirectory(process.cwd());
   // Keep this path distinct from @granite-js/plugin-micro-frontend's generated prelude.
-  // Both plugins can coexist while consumers migrate, and sharing a path makes the
-  // later plugin overwrite the earlier plugin's runtime registrations.
+  // Sharing a path would let one plugin overwrite the other's runtime registrations.
   const preludePath = path.join(localDirectory, 'granite-micro-frontend-runtime.js');
   const prelude = getPreludeConfig(normalizedOptions);
   const resolver = createSharedResolverConfig(nonEagerEntries);

package/src/{plugin → plugin-utils}/intoShared.ts

@@ -1,4 +1,3 @@
-import type { MicroFrontendPluginOptions } from './types';
 import type { SharedConfig, SharedModuleConfig } from '../runtime/registry';
 
 const SHARED_PRESETS = {
@@ -21,7 +20,7 @@ const SHARED_PRESETS = {
   ],
 } as const;
 
-export function intoShared(shared: MicroFrontendPluginOptions['shared']): SharedConfig | undefined {
+export function intoShared(shared: SharedConfig | readonly string[] | undefined): SharedConfig | undefined {
   if (shared == null) {
     return undefined;
   }

package/src/{plugin → plugin-utils}/prelude.ts

@@ -1,15 +1,22 @@
-import path from 'path';
+import * as path from 'node:path';
 import { globalContextScript } from './globalContextScript';
-import type { MicroFrontendPluginOptions } from './types';
 import { CONTAINER_PAIRING_KEY } from '../runtime/containerPairing';
+import { toLegacyEsm } from '../runtime/legacyEsm';
+import type { SharedConfig } from '../runtime/registry';
 import { captureStackFrames, resolveCurrentSourceURL } from '../runtime/runtimeSourceURL';
+import { registerSharedValue } from '../runtime/sharedModule';
+
+interface MicroFrontendPreludeOptions {
+  readonly shared?: SharedConfig | readonly string[];
+  readonly exposes?: Readonly<Record<string, string>>;
+}
 
 export interface MicroFrontendPreludeConfig {
   readonly banner: string;
   readonly preludeScript: string;
 }
 
-export function getPreludeConfig(options: MicroFrontendPluginOptions, appName?: string): MicroFrontendPreludeConfig {
+export function getPreludeConfig(options: MicroFrontendPreludeOptions, appName?: string): MicroFrontendPreludeConfig {
   const eagerSharedModules = Object.entries(options.shared ?? {}).filter(
     ([, config]) => !Array.isArray(options.shared) && config.eager === true
   );
@@ -140,41 +147,7 @@ export function getPreludeConfig(options: MicroFrontendPluginOptions, appName?:
       '    global.__MICRO_FRONTEND__.__CONTAINERS__[container.appName],',
       '    container',
       '  );',
-      '  let legacyModuleValue = moduleValue;',
-      '  if (legacyContainer != null &&',
-      '      ((typeof moduleValue === "object" && moduleValue != null) || typeof moduleValue === "function") &&',
-      '      moduleValue.__esModule !== true) {',
-      '    legacyModuleValue = typeof moduleValue === "function"',
-      '      ? function (...args) { return Reflect.apply(moduleValue, this, args); }',
-      '      : {};',
-      '    for (const exportName of Reflect.ownKeys(moduleValue)) {',
-      '      if (exportName === "__esModule" || exportName === "default") {',
-      '        continue;',
-      '      }',
-      '      const sourceDescriptor = Reflect.getOwnPropertyDescriptor(moduleValue, exportName);',
-      '      const facadeDescriptor = Reflect.getOwnPropertyDescriptor(legacyModuleValue, exportName);',
-      '      if (sourceDescriptor == null || (facadeDescriptor != null && facadeDescriptor.configurable === false)) {',
-      '        // Callable facades keep intrinsic non-configurable slots such as prototype.',
-      '        continue;',
-      '      }',
-      '      if (!Reflect.defineProperty(legacyModuleValue, exportName, {',
-      '        enumerable: sourceDescriptor.enumerable,',
-      '        get: function () { return Reflect.get(moduleValue, exportName); },',
-      '      })) {',
-      '        throw new Error("Cannot establish the micro-frontend global context: registry-is-not-extensible");',
-      '      }',
-      '    }',
-      '    const hasDefaultExport = Reflect.getOwnPropertyDescriptor(moduleValue, "default") != null;',
-      '    Object.defineProperties(legacyModuleValue, {',
-      '      __esModule: { value: true },',
-      '      default: {',
-      '        enumerable: true,',
-      '        get: hasDefaultExport',
-      '          ? function () { return Reflect.get(moduleValue, "default"); }',
-      '          : function () { return moduleValue; },',
-      '      },',
-      '    });',
-      '  }',
+      '  const legacyModuleValue = legacyContainer == null ? moduleValue : toLegacyEsm(moduleValue);',
       '  try {',
       '    if (ownsModernContainer && !Reflect.set(container.exposedModules, normalizedModule, moduleValue)) {',
       '      throw new Error("Cannot establish the micro-frontend global context: registry-is-not-extensible");',
@@ -196,19 +169,13 @@ export function getPreludeConfig(options: MicroFrontendPluginOptions, appName?:
       '    throw error;',
       '  }',
       '}',
+      `const toLegacyEsm = ${toLegacyEsm.toString()};`,
+      `const registerSharedValue = ${registerSharedValue.toString()};`,
       'function registerShared(moduleName, moduleValue) {',
       '  const sharedModules = global.__MICRO_FRONTEND__.__SHARED__;',
-      '  const existingModule = sharedModules[moduleName];',
-      '  if (existingModule != null) {',
-      '    if (typeof existingModule === "object" &&',
-      '        typeof existingModule.get === "function" &&',
-      '        typeof existingModule.loaded === "boolean" &&',
-      '        Object.is(existingModule.get(), moduleValue)) {',
-      '      return;',
-      '    }',
+      '  if (!registerSharedValue(sharedModules, moduleName, moduleValue, toLegacyEsm)) {',
       "    throw new Error(`Shared module '${moduleName}' is already registered`);",
       '  }',
-      '  sharedModules[moduleName] = { get: () => moduleValue, loaded: true };',
       '}',
       `const __container = createContainer(${containerName}, ${containerConfig});`,
       ...registerStatements,

package/src/runtime/containerModuleExposure.ts

@@ -1,6 +1,7 @@
 import { getLegacyContainerPair } from './containerPairing';
 import { ExposedModuleAlreadyRegisteredError } from './errors';
 import { getMicroFrontendGlobalContext, MicroFrontendGlobalContextCompatibilityError } from './globalContext';
+import { toLegacyEsm } from './legacyEsm';
 import type { AppContainer } from './registry';
 
 export function exposeContainerModule(container: AppContainer, exposedModule: string, module: unknown): void {
@@ -44,45 +45,6 @@ export function exposeContainerModule(container: AppContainer, exposedModule: st
   }
 }
 
-function toLegacyEsm(module: unknown): unknown {
-  if ((typeof module !== 'object' || module == null) && typeof module !== 'function') {
-    return module;
-  }
-  if (Reflect.get(module, '__esModule') === true) {
-    return module;
-  }
-  const legacyModule =
-    typeof module === 'function'
-      ? function (this: unknown, ...args: unknown[]): unknown {
-          return Reflect.apply(module, this, args);
-        }
-      : {};
-  for (const exportName of Reflect.ownKeys(module)) {
-    if (exportName === '__esModule' || exportName === 'default') {
-      continue;
-    }
-    const sourceDescriptor = Reflect.getOwnPropertyDescriptor(module, exportName);
-    const facadeDescriptor = Reflect.getOwnPropertyDescriptor(legacyModule, exportName);
-    if (sourceDescriptor == null || facadeDescriptor?.configurable === false) {
-      // Callable facades keep intrinsic non-configurable slots such as prototype.
-      continue;
-    }
-    Reflect.defineProperty(legacyModule, exportName, {
-      enumerable: sourceDescriptor.enumerable,
-      get: () => Reflect.get(module, exportName),
-    });
-  }
-  const hasDefaultExport = Reflect.getOwnPropertyDescriptor(module, 'default') != null;
-  Object.defineProperties(legacyModule, {
-    __esModule: { value: true },
-    default: {
-      enumerable: true,
-      get: hasDefaultExport ? () => Reflect.get(module, 'default') : () => module,
-    },
-  });
-  return legacyModule;
-}
-
 function normalizeExposedModule(exposedModule: string): string {
   return exposedModule.startsWith('./') ? exposedModule : `./${exposedModule}`;
 }

package/src/runtime/legacyEsm.ts

@@ -0,0 +1,39 @@
+// Keep this helper self-contained: the build plugin serializes it into the prelude.
+export function toLegacyEsm(module: unknown): unknown {
+  if ((typeof module !== 'object' || module == null) && typeof module !== 'function') {
+    return module;
+  }
+  if (Reflect.get(module, '__esModule') === true) {
+    return module;
+  }
+  const legacyModule =
+    typeof module === 'function'
+      ? function (this: unknown, ...args: unknown[]): unknown {
+          return Reflect.apply(module, this, args);
+        }
+      : {};
+  for (const exportName of Reflect.ownKeys(module)) {
+    if (exportName === '__esModule' || exportName === 'default') {
+      continue;
+    }
+    const sourceDescriptor = Reflect.getOwnPropertyDescriptor(module, exportName);
+    const facadeDescriptor = Reflect.getOwnPropertyDescriptor(legacyModule, exportName);
+    if (sourceDescriptor == null || facadeDescriptor?.configurable === false) {
+      // Callable facades keep intrinsic non-configurable slots such as prototype.
+      continue;
+    }
+    Reflect.defineProperty(legacyModule, exportName, {
+      enumerable: sourceDescriptor.enumerable,
+      get: () => Reflect.get(module, exportName),
+    });
+  }
+  const hasDefaultExport = Reflect.getOwnPropertyDescriptor(module, 'default') != null;
+  Object.defineProperties(legacyModule, {
+    __esModule: { value: true },
+    default: {
+      enumerable: true,
+      get: hasDefaultExport ? () => Reflect.get(module, 'default') : () => module,
+    },
+  });
+  return legacyModule;
+}