@granite-js/micro-frontend 2.3.1 → 2.4.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @granite-js/micro-frontend
 
+## 2.4.0
+
+### Minor Changes
+
+- d1f3f02: Add `getSessions()` and `onSessionsChanged()` for observing ordered session snapshots outside React. Snapshots include session identity, app name, scheme, and native presentation visibility, and update as native events arrive without waiting for React commits or app disposal.
+
+  Keep session tracking active between consumer subscriptions and let `useMicroFrontendSessions()` read the same runtime-owned state, including sessions opened before it mounts. Existing lifecycle callbacks retain their commit and disposal timing.
+
+### Patch Changes
+
+- 9c09be7: Prevent iOS Portal hosts from dispatching duplicate Fabric touch events when another React Native root owns the touched view. Preserve touch handling for plain hosted content and nested Portal hosts.
+- d0a4bf4: Mount teleported iOS Portal content under an `RCTRootComponentView` anchor so react-native-screens treats hosted screens as root-mounted and stops attaching a second `RCTSurfaceTouchHandler` per screen. Hosted content now gets a single touch handler and container-relative page coordinates, like content under a regular React Native root.
+  - @granite-js/utils@2.4.0
+
+## 2.3.2
+
+### Patch Changes
+
+- f92bbc7: Register pending host components with the configured app scheme so route evaluation works before an initial URL is available and does not inherit another app's scheme.
+  - @granite-js/utils@2.3.2
+
 ## 2.3.1
 
 ### Patch Changes

package/README.md

@@ -217,12 +217,48 @@ route best-effort native preload failures to its observability provider.
 
 The public runtime API is:
 
-| API                        | Responsibility                                                  |
-| -------------------------- | --------------------------------------------------------------- |
-| `preloadApp(appName)`      | Load and evaluate one app without importing an exposed module.  |
-| `importApp(request)`       | Ensure the app is evaluated and import `appName/exposedModule`. |
-| `evaluateScript(filePath)` | Evaluate a local file or Android packaged asset in the retained runtime. |
-| `onEvent(listener)`        | Subscribe to native open, close, and visibility events.         |
+| API                           | Responsibility                                                           |
+| ----------------------------- | ------------------------------------------------------------------------ |
+| `preloadApp(appName)`         | Load and evaluate one app without importing an exposed module.           |
+| `importApp(request)`          | Ensure the app is evaluated and import `appName/exposedModule`.          |
+| `evaluateScript(filePath)`    | Evaluate a local file or Android packaged asset in the retained runtime. |
+| `onEvent(listener)`           | Subscribe to native open, close, and visibility events.                  |
+| `getSessions()`               | Read the current immutable session snapshot.                             |
+| `onSessionsChanged(listener)` | Subscribe to session snapshot changes.                                   |
+
+Session snapshots contain `sessionId`, `appName`, `scheme`, and `isVisible`.
+Sessions remain in opening order, including separate entries when the same app
+has multiple sessions. A newly opened session starts with `isVisible: false`;
+native visibility events update it, and `closeApp` removes it. Preloading an app
+does not create a session.
+
+```ts
+const subscription = runtime.onSessionsChanged((sessions) => {
+  updateSessionStatus(sessions);
+});
+updateSessionStatus(runtime.getSessions());
+
+// Stop observing when the integration is no longer needed.
+subscription.remove();
+```
+
+`getSessions()` only reads state. The first `onEvent` or `onSessionsChanged`
+subscription starts native event delivery after installing the runtime's
+listener. This can synchronously deliver queued events to the new subscriber.
+Subscriptions do not replay the current snapshot; subscribe first, then read
+`getSessions()` to initialize an observer without missing changes.
+
+The runtime retains one native subscription for its lifetime, even while all
+consumer subscriptions are removed. Later observers and React hosts can read
+the current sessions without reconstructing past events. Native session events
+update the snapshot before either kind of observer is notified, independently
+of React commits and app disposal. A failing observer is reported without
+preventing other observers from receiving the event.
+
+Snapshots and their session objects are frozen. A real change creates a new
+array while preserving unchanged session objects. Duplicate opens, unknown
+session IDs, and repeated visibility values retain the same snapshot and do not
+notify `onSessionsChanged` subscribers.
 
 The host can provide `onLifecycleEvent` when creating the runtime for logging
 and other observability integrations. Each event contains `session.id`,
@@ -291,9 +327,11 @@ function SessionRoot({ session }: { readonly session: MicroFrontendSessionState
 }
 ```
 
-`useMicroFrontendSessions(runtime)` owns the fixed React subscription and folds
-native open, close, and visibility events into session descriptors. The host
-continues to own module selection and the rendered Portal tree.
+`useMicroFrontendSessions(runtime)` subscribes to the runtime's session snapshot
+with `useSyncExternalStore`. It reads the same state as non-React observers,
+including sessions opened before the hook mounted. It continues to report
+committed mount/unmount lifecycle events and run app disposal. The host owns
+module selection and the rendered Portal tree.
 
 The provider exposes the native session identity and combines
 `presentationVisibility` with Granite's existing `VisibilityChangedProvider`.
@@ -535,16 +573,33 @@ Import public APIs from `GraniteMicroFrontendRuntime`.
 
 ### Portal destination APIs
 
-| API                                         | Lifetime / behavior                                                                                               |
-| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
-| `-initWithFrame:`                           | Create and immediately activate a UIKit-owned Portal destination after React has booted.                          |
-| `-initWithFrame:deferredActivation:`        | Create before React boot without reading React feature flags.                                                     |
-| `-setName:`                                 | Register/unregister the destination name. Use `sessionId`.                                                        |
-| `-activateIfNeeded`                         | Create the Fabric host, attach its touch handler, and apply the pending name. Main thread only, after React boot. |
-| `isActivated`                               | Whether the underlying Fabric host exists.                                                                        |
-| `hasAttachedContent`                        | Whether teleported content is currently attached. This is readiness, not presentation visibility.                 |
-| `onContentDidAttach` / `onContentDidDetach` | Main-thread readiness callbacks for the first attach and last detach.                                             |
-| `-invalidate`                               | Unregister the host and clear callbacks during teardown.                                                          |
+| API                                         | Lifetime / behavior                                                                                                                                      |
+| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `-initWithFrame:`                           | Create and immediately activate a UIKit-owned Portal destination after React has booted.                                                                 |
+| `-initWithFrame:deferredActivation:`        | Create before React boot without reading React feature flags.                                                                                            |
+| `-setName:`                                 | Register/unregister the destination name. Use `sessionId`.                                                                                               |
+| `-activateIfNeeded`                         | Create the Fabric host under an `RCTRootComponentView` anchor, attach the touch handler, and apply the pending name. Main thread only, after React boot. |
+| `isActivated`                               | Whether the underlying Fabric host exists.                                                                                                               |
+| `hasAttachedContent`                        | Whether teleported content is currently attached. This is readiness, not presentation visibility.                                                        |
+| `onContentDidAttach` / `onContentDidDetach` | Main-thread readiness callbacks for the first attach and last detach.                                                                                    |
+| `-invalidate`                               | Unregister the host and clear callbacks during teardown.                                                                                                 |
+
+#### Touch handling under a Portal host
+
+`-activateIfNeeded` mounts the Fabric host under an `RCTRootComponentView`
+anchor:
+
+```text
+PortalHostContainerView       <- RCTSurfaceTouchHandler for all hosted content
+└── RCTRootComponentView      <- anchor, never registered with Fabric
+    └── PortalHostView        <- teleported content attaches here
+```
+
+react-native-screens attaches its own touch handler to any screen without an
+`RCTRootComponentView` above it. Without the anchor every hosted screen would add
+a second handler beneath the container's, and one tap would reach JS twice. The
+anchor keeps a single handler and page coordinates relative to the container,
+like content under a regular React Native root.
 
 ### UIViewController example
 

package/dist/module/createRoute.js

@@ -1,6 +1,6 @@
 "use strict";
 
-import { createRoute as createGraniteRoute, getSchemeUri } from '@granite-js/react-native';
+import { createRoute as createGraniteRoute } from '@granite-js/react-native';
 import { registerPendingHostComponentRoute } from "./host/pendingHostComponentStore.js";
 export function createRoute(path, options) {
   const {
@@ -27,10 +27,10 @@ function getCurrentGraniteApp() {
   }
   const host = granite['app']['host'];
   const name = granite['app']['name'];
-  if (typeof host !== 'string' || typeof name !== 'string') {
+  const scheme = granite['app']['scheme'];
+  if (typeof host !== 'string' || typeof name !== 'string' || typeof scheme !== 'string') {
     return null;
   }
-  const scheme = new URL(getSchemeUri()).protocol.replace(/:$/g, '');
   return {
     name,
     scheme,

package/dist/module/createRoute.js.map

@@ -1 +1 @@
-{"version":3,"names":["createRoute","createGraniteRoute","getSchemeUri","registerPendingHostComponentRoute","path","options","hostPendingComponent","routeOptions","app","getCurrentGraniteApp","String","component","parserParams","validateParams","granite","Reflect","get","globalThis","isPropertyMap","host","name","scheme","URL","protocol","replace","value"],"sourceRoot":"../../src","sources":["createRoute.ts"],"mappings":";;AAAA,SACEA,WAAW,IAAIC,kBAAkB,EACjCC,YAAY,QAIP,0BAA0B;AAEjC,SAASC,iCAAiC,QAAQ,qCAAkC;AA+BpF,OAAO,SAASH,WAAWA,CACzBI,IAA+B,EAC/BC,OAA2C,EAC3C;EACA,MAAM;IAAEC,oBAAoB;IAAE,GAAGC;EAAa,CAAC,GAAGF,OAAO;EAEzD,IAAIC,oBAAoB,IAAI,IAAI,EAAE;IAChC,MAAME,GAAG,GAAGC,oBAAoB,CAAC,CAAC;IAClC,IAAID,GAAG,IAAI,IAAI,EAAE;MACfL,iCAAiC,CAACO,MAAM,CAACN,IAAI,CAAC,EAAE;QAC9CI,GAAG;QACHG,SAAS,EAAEL,oBAAoB;QAC/BM,YAAY,EAAEL,YAAY,CAACK,YAAY;QACvCC,cAAc,EAAEN,YAAY,CAACM;MAC/B,CAAC,CAAC;IACJ;EACF;EAEA,OAAOZ,kBAAkB,CAACG,IAAI,EAAEG,YAAY,CAAC;AAC/C;AAEA,SAASE,oBAAoBA,CAAA,EAAyC;EACpE,MAAMK,OAAgB,GAAGC,OAAO,CAACC,GAAG,CAACC,UAAU,EAAE,WAAW,CAAC;EAC7D,IAAI,CAACC,aAAa,CAACJ,OAAO,CAAC,IAAI,CAACI,aAAa,CAACJ,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE;IAC7D,OAAO,IAAI;EACb;EAEA,MAAMK,IAAI,GAAGL,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;EACnC,MAAMM,IAAI,GAAGN,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;EACnC,IAAI,OAAOK,IAAI,KAAK,QAAQ,IAAI,OAAOC,IAAI,KAAK,QAAQ,EAAE;IACxD,OAAO,IAAI;EACb;EAEA,MAAMC,MAAM,GAAG,IAAIC,GAAG,CAACpB,YAAY,CAAC,CAAC,CAAC,CAACqB,QAAQ,CAACC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;EAElE,OAAO;IACLJ,IAAI;IACJC,MAAM;IACNF;EACF,CAAC;AACH;AAEA,SAASD,aAAaA,CAACO,KAAc,EAAmD;EACtF,OAAO,OAAOA,KAAK,KAAK,QAAQ,IAAIA,KAAK,KAAK,IAAI;AACpD","ignoreList":[]}
+{"version":3,"names":["createRoute","createGraniteRoute","registerPendingHostComponentRoute","path","options","hostPendingComponent","routeOptions","app","getCurrentGraniteApp","String","component","parserParams","validateParams","granite","Reflect","get","globalThis","isPropertyMap","host","name","scheme","value"],"sourceRoot":"../../src","sources":["createRoute.ts"],"mappings":";;AAAA,SACEA,WAAW,IAAIC,kBAAkB,QAI5B,0BAA0B;AAEjC,SAASC,iCAAiC,QAAQ,qCAAkC;AA+BpF,OAAO,SAASF,WAAWA,CACzBG,IAA+B,EAC/BC,OAA2C,EAC3C;EACA,MAAM;IAAEC,oBAAoB;IAAE,GAAGC;EAAa,CAAC,GAAGF,OAAO;EAEzD,IAAIC,oBAAoB,IAAI,IAAI,EAAE;IAChC,MAAME,GAAG,GAAGC,oBAAoB,CAAC,CAAC;IAClC,IAAID,GAAG,IAAI,IAAI,EAAE;MACfL,iCAAiC,CAACO,MAAM,CAACN,IAAI,CAAC,EAAE;QAC9CI,GAAG;QACHG,SAAS,EAAEL,oBAAoB;QAC/BM,YAAY,EAAEL,YAAY,CAACK,YAAY;QACvCC,cAAc,EAAEN,YAAY,CAACM;MAC/B,CAAC,CAAC;IACJ;EACF;EAEA,OAAOX,kBAAkB,CAACE,IAAI,EAAEG,YAAY,CAAC;AAC/C;AAEA,SAASE,oBAAoBA,CAAA,EAAyC;EACpE,MAAMK,OAAgB,GAAGC,OAAO,CAACC,GAAG,CAACC,UAAU,EAAE,WAAW,CAAC;EAC7D,IAAI,CAACC,aAAa,CAACJ,OAAO,CAAC,IAAI,CAACI,aAAa,CAACJ,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE;IAC7D,OAAO,IAAI;EACb;EAEA,MAAMK,IAAI,GAAGL,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;EACnC,MAAMM,IAAI,GAAGN,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;EACnC,MAAMO,MAAM,GAAGP,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC;EACvC,IAAI,OAAOK,IAAI,KAAK,QAAQ,IAAI,OAAOC,IAAI,KAAK,QAAQ,IAAI,OAAOC,MAAM,KAAK,QAAQ,EAAE;IACtF,OAAO,IAAI;EACb;EAEA,OAAO;IACLD,IAAI;IACJC,MAAM;IACNF;EACF,CAAC;AACH;AAEA,SAASD,aAAaA,CAACI,KAAc,EAAmD;EACtF,OAAO,OAAOA,KAAK,KAAK,QAAQ,IAAIA,KAAK,KAAK,IAAI;AACpD","ignoreList":[]}

package/dist/module/runtime/createMicroFrontendRuntime.js

@@ -5,9 +5,41 @@ import { getMicroFrontendGlobalContext } from "./globalContext.js";
 import { setMicroFrontendLifecycleCallback } from "./lifecycle.js";
 import { installNativeComponentRegistryCompatibility } from "./nativeComponentRegistryCompatibility.js";
 import { parseAppRequest } from "./parseAppRequest.js";
+import { createSessionStore } from "./sessionStore.js";
 export function createMicroFrontendRuntimeWithDependencies(dependencies) {
   // A fulfilled promise is the evaluated-state cache. Rejected evaluations remove themselves.
   const appEvaluations = new Map();
+  const sessionStore = createSessionStore();
+  const sessionListeners = new Set();
+  const eventListeners = new Set();
+  let nativeSubscription;
+  function startEventDelivery() {
+    if (nativeSubscription != null) {
+      return;
+    }
+    nativeSubscription = dependencies.nativeRuntime.onEvent(event => {
+      const parsedEvent = dependencies.parseEvent(event);
+      switch (parsedEvent.name) {
+        case 'preloadApp':
+          void preloadApp(parsedEvent.params.appName).catch(dependencies.onPreloadError);
+          return;
+        case 'openApp':
+        case 'closeApp':
+        case 'sessionVisibilityChanged':
+          if (sessionStore.applyEvent(parsedEvent)) {
+            notifyListeners(sessionListeners, sessionStore.getSessions());
+          }
+          notifyListeners(eventListeners, parsedEvent);
+          return;
+        default:
+          {
+            const exhaustiveEvent = parsedEvent;
+            return exhaustiveEvent;
+          }
+      }
+    });
+    dependencies.nativeRuntime.startEventDelivery();
+  }
   function resetFailedEvaluation(appName) {
     appEvaluations.delete(appName);
     dependencies.registry.removeContainer(appName);
@@ -58,30 +90,34 @@ export function createMicroFrontendRuntimeWithDependencies(dependencies) {
       await preloadApp(appName);
       return dependencies.registry.importModule(request);
     },
+    getSessions: sessionStore.getSessions,
+    onSessionsChanged(listener) {
+      const callback = sessions => listener(sessions);
+      sessionListeners.add(callback);
+      startEventDelivery();
+      return {
+        remove: () => sessionListeners.delete(callback)
+      };
+    },
     onEvent(listener) {
-      const subscription = dependencies.nativeRuntime.onEvent(event => {
-        const parsedEvent = dependencies.parseEvent(event);
-        switch (parsedEvent.name) {
-          case 'preloadApp':
-            void preloadApp(parsedEvent.params.appName).catch(dependencies.onPreloadError);
-            return;
-          case 'openApp':
-          case 'closeApp':
-          case 'sessionVisibilityChanged':
-            listener(parsedEvent);
-            return;
-          default:
-            {
-              const exhaustiveEvent = parsedEvent;
-              return exhaustiveEvent;
-            }
-        }
-      });
-      dependencies.nativeRuntime.startEventDelivery();
-      return subscription;
+      const callback = event => listener(event);
+      eventListeners.add(callback);
+      startEventDelivery();
+      return {
+        remove: () => eventListeners.delete(callback)
+      };
     }
   };
   setMicroFrontendLifecycleCallback(runtime, dependencies.onLifecycleEvent);
   return runtime;
 }
+function notifyListeners(listeners, event) {
+  listeners.forEach(listener => {
+    try {
+      listener(event);
+    } catch (error) {
+      console.error('Failed to run a micro-frontend runtime listener', error);
+    }
+  });
+}
 //# sourceMappingURL=createMicroFrontendRuntime.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["AppContainerNotFoundError","InvalidAppNameError","getMicroFrontendGlobalContext","setMicroFrontendLifecycleCallback","installNativeComponentRegistryCompatibility","parseAppRequest","createMicroFrontendRuntimeWithDependencies","dependencies","appEvaluations","Map","resetFailedEvaluation","appName","delete","registry","removeContainer","removePendingHostComponentRoutes","preloadApp","length","Promise","reject","existingEvaluation","get","evaluation","evaluateApp","set","evaluateScript","filePath","nativeRuntime","adapter","loadBundle","hasContainer","error","runtime","importApp","request","importModule","onEvent","listener","subscription","event","parsedEvent","parseEvent","name","params","catch","onPreloadError","exhaustiveEvent","startEventDelivery","onLifecycleEvent"],"sourceRoot":"../../../src","sources":["runtime/createMicroFrontendRuntime.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["AppContainerNotFoundError","InvalidAppNameError","getMicroFrontendGlobalContext","setMicroFrontendLifecycleCallback","installNativeComponentRegistryCompatibility","parseAppRequest","createSessionStore","createMicroFrontendRuntimeWithDependencies","dependencies","appEvaluations","Map","sessionStore","sessionListeners","Set","eventListeners","nativeSubscription","startEventDelivery","nativeRuntime","onEvent","event","parsedEvent","parseEvent","name","preloadApp","params","appName","catch","onPreloadError","applyEvent","notifyListeners","getSessions","exhaustiveEvent","resetFailedEvaluation","delete","registry","removeContainer","removePendingHostComponentRoutes","length","Promise","reject","existingEvaluation","get","evaluation","evaluateApp","set","evaluateScript","filePath","adapter","loadBundle","hasContainer","error","runtime","importApp","request","importModule","onSessionsChanged","listener","callback","sessions","add","remove","onLifecycleEvent","listeners","forEach","console"],"sourceRoot":"../../../src","sources":["runtime/createMicroFrontendRuntime.ts"],"mappings":"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","ignoreList":[]}

package/dist/module/runtime/sessionStore.js

@@ -0,0 +1,43 @@
+"use strict";
+
+export function createSessionStore() {
+  let sessions = Object.freeze([]);
+  return {
+    getSessions: () => sessions,
+    applyEvent(event) {
+      const nextSessions = reduceSessions(sessions, event);
+      if (nextSessions === sessions) {
+        return false;
+      }
+      sessions = Object.freeze(nextSessions);
+      return true;
+    }
+  };
+}
+function reduceSessions(sessions, event) {
+  const session = sessions.find(({
+    sessionId
+  }) => sessionId === event.params.sessionId);
+  switch (event.name) {
+    case 'openApp':
+      return session == null ? [...sessions, Object.freeze({
+        ...event.params,
+        isVisible: false
+      })] : sessions;
+    case 'closeApp':
+      return session == null ? sessions : sessions.filter(({
+        sessionId
+      }) => sessionId !== event.params.sessionId);
+    case 'sessionVisibilityChanged':
+      return session == null || session.isVisible === event.params.isVisible ? sessions : sessions.map(current => current === session ? Object.freeze({
+        ...current,
+        isVisible: event.params.isVisible
+      }) : current);
+    default:
+      {
+        const exhaustiveEvent = event;
+        return exhaustiveEvent;
+      }
+  }
+}
+//# sourceMappingURL=sessionStore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["createSessionStore","sessions","Object","freeze","getSessions","applyEvent","event","nextSessions","reduceSessions","session","find","sessionId","params","name","isVisible","filter","map","current","exhaustiveEvent"],"sourceRoot":"../../../src","sources":["runtime/sessionStore.ts"],"mappings":";;AAEA,OAAO,SAASA,kBAAkBA,CAAA,EAAG;EACnC,IAAIC,QAA8C,GAAGC,MAAM,CAACC,MAAM,CAAC,EAAE,CAAC;EAEtE,OAAO;IACLC,WAAW,EAAEA,CAAA,KAAMH,QAAQ;IAC3BI,UAAUA,CAACC,KAAgC,EAAW;MACpD,MAAMC,YAAY,GAAGC,cAAc,CAACP,QAAQ,EAAEK,KAAK,CAAC;MACpD,IAAIC,YAAY,KAAKN,QAAQ,EAAE;QAC7B,OAAO,KAAK;MACd;MACAA,QAAQ,GAAGC,MAAM,CAACC,MAAM,CAACI,YAAY,CAAC;MACtC,OAAO,IAAI;IACb;EACF,CAAC;AACH;AAEA,SAASC,cAAcA,CACrBP,QAA8C,EAC9CK,KAAgC,EACM;EACtC,MAAMG,OAAO,GAAGR,QAAQ,CAACS,IAAI,CAAC,CAAC;IAAEC;EAAU,CAAC,KAAKA,SAAS,KAAKL,KAAK,CAACM,MAAM,CAACD,SAAS,CAAC;EACtF,QAAQL,KAAK,CAACO,IAAI;IAChB,KAAK,SAAS;MACZ,OAAOJ,OAAO,IAAI,IAAI,GAAG,CAAC,GAAGR,QAAQ,EAAEC,MAAM,CAACC,MAAM,CAAC;QAAE,GAAGG,KAAK,CAACM,MAAM;QAAEE,SAAS,EAAE;MAAM,CAAC,CAAC,CAAC,GAAGb,QAAQ;IACzG,KAAK,UAAU;MACb,OAAOQ,OAAO,IAAI,IAAI,GAAGR,QAAQ,GAAGA,QAAQ,CAACc,MAAM,CAAC,CAAC;QAAEJ;MAAU,CAAC,KAAKA,SAAS,KAAKL,KAAK,CAACM,MAAM,CAACD,SAAS,CAAC;IAC9G,KAAK,0BAA0B;MAC7B,OAAOF,OAAO,IAAI,IAAI,IAAIA,OAAO,CAACK,SAAS,KAAKR,KAAK,CAACM,MAAM,CAACE,SAAS,GAClEb,QAAQ,GACRA,QAAQ,CAACe,GAAG,CAAEC,OAAO,IACnBA,OAAO,KAAKR,OAAO,GAAGP,MAAM,CAACC,MAAM,CAAC;QAAE,GAAGc,OAAO;QAAEH,SAAS,EAAER,KAAK,CAACM,MAAM,CAACE;MAAU,CAAC,CAAC,GAAGG,OAC3F,CAAC;IACP;MAAS;QACP,MAAMC,eAAsB,GAAGZ,KAAK;QACpC,OAAOY,eAAe;MACxB;EACF;AACF","ignoreList":[]}

package/dist/module/session/useMicroFrontendSessions.js

@@ -1,40 +1,14 @@
 "use strict";
 
-import { useEffect, useLayoutEffect, useReducer, useRef } from 'react';
+import { useCallback, useEffect, useLayoutEffect, useRef, useSyncExternalStore } from 'react';
 import { installPendingHostComponentBridge, resetPendingHostComponent } from "../host/pendingHostComponentStore.js";
 import { emitMicroFrontendLifecycleEvent } from "../runtime/lifecycle.js";
 import { disposeAppResources } from "../runtime/registry.js";
 const INITIAL_SESSIONS = [];
-function reduceMicroFrontendSessions(sessions, event) {
-  switch (event.name) {
-    case 'openApp':
-      return sessions.some(({
-        sessionId
-      }) => sessionId === event.params.sessionId) ? sessions : [...sessions, {
-        appName: event.params.appName,
-        sessionId: event.params.sessionId,
-        scheme: event.params.scheme,
-        isVisible: false
-      }];
-    case 'closeApp':
-      return sessions.filter(({
-        sessionId
-      }) => sessionId !== event.params.sessionId);
-    case 'sessionVisibilityChanged':
-      return sessions.map(session => session.sessionId === event.params.sessionId ? {
-        ...session,
-        isVisible: event.params.isVisible
-      } : session);
-    default:
-      {
-        const exhaustiveEvent = event;
-        return exhaustiveEvent;
-      }
-  }
-}
 export function useMicroFrontendSessions(runtime) {
-  const [sessions, dispatch] = useReducer(reduceMicroFrontendSessions, INITIAL_SESSIONS);
-  const previousSessionsRef = useRef(sessions);
+  const subscribe = useCallback(listener => runtime.onSessionsChanged(listener).remove, [runtime]);
+  const sessions = useSyncExternalStore(subscribe, runtime.getSessions);
+  const previousSessionsRef = useRef(INITIAL_SESSIONS);
   useEffect(() => {
     const previousSessions = previousSessionsRef.current;
     previousSessionsRef.current = sessions;
@@ -76,7 +50,6 @@ export function useMicroFrontendSessions(runtime) {
       if (event.name === 'openApp') {
         resetPendingHostComponent();
       }
-      dispatch(event);
     });
     return () => subscription.remove();
   }, [runtime]);

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

@@ -1 +1 @@
-{"version":3,"names":["useEffect","useLayoutEffect","useReducer","useRef","installPendingHostComponentBridge","resetPendingHostComponent","emitMicroFrontendLifecycleEvent","disposeAppResources","INITIAL_SESSIONS","reduceMicroFrontendSessions","sessions","event","name","some","sessionId","params","appName","scheme","isVisible","filter","map","session","exhaustiveEvent","useMicroFrontendSessions","runtime","dispatch","previousSessionsRef","previousSessions","current","activeSessionIds","Set","activeAppNames","mountedSessions","previousSession","inactiveSessions","has","inactiveAppNames","forEach","createLifecycleEvent","appDisposals","Map","Array","from","catch","error","console","appDisposal","get","then","subscription","onEvent","remove","phase","activeSessions","toLifecycleSession","id"],"sourceRoot":"../../../src","sources":["session/useMicroFrontendSessions.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["useCallback","useEffect","useLayoutEffect","useRef","useSyncExternalStore","installPendingHostComponentBridge","resetPendingHostComponent","emitMicroFrontendLifecycleEvent","disposeAppResources","INITIAL_SESSIONS","useMicroFrontendSessions","runtime","subscribe","listener","onSessionsChanged","remove","sessions","getSessions","previousSessionsRef","previousSessions","current","activeSessionIds","Set","map","sessionId","activeAppNames","appName","mountedSessions","filter","some","previousSession","inactiveSessions","has","inactiveAppNames","forEach","session","createLifecycleEvent","appDisposals","Map","Array","from","catch","error","console","appDisposal","get","then","subscription","onEvent","event","name","phase","activeSessions","toLifecycleSession","id"],"sourceRoot":"../../../src","sources":["session/useMicroFrontendSessions.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,5 @@
+import type { MicroFrontendSessionEvent, MicroFrontendSessionState } from '../types';
+export declare function createSessionStore(): {
+    getSessions: () => readonly MicroFrontendSessionState[];
+    applyEvent(event: MicroFrontendSessionEvent): boolean;
+};

package/dist/typescript/session/useMicroFrontendSessions.d.ts

@@ -1,8 +1,3 @@
-import type { MicroFrontendRuntimeApi } from '../types';
-export interface MicroFrontendSessionState {
-    readonly appName: string;
-    readonly sessionId: string;
-    readonly scheme: string;
-    readonly isVisible: boolean;
-}
-export declare function useMicroFrontendSessions(runtime: Pick<MicroFrontendRuntimeApi, 'onEvent'>): readonly MicroFrontendSessionState[];
+import type { MicroFrontendRuntimeApi, MicroFrontendSessionState } from '../types';
+export type { MicroFrontendSessionState } from '../types';
+export declare function useMicroFrontendSessions(runtime: Pick<MicroFrontendRuntimeApi, 'onEvent' | 'getSessions' | 'onSessionsChanged'>): readonly MicroFrontendSessionState[];

package/dist/typescript/types.d.ts

@@ -42,6 +42,12 @@ export type MicroFrontendSessionEvent = Exclude<MicroFrontendRuntimeEvent, {
 export interface MicroFrontendRuntimeEventSubscription {
     readonly remove: () => void;
 }
+export interface MicroFrontendSessionState {
+    readonly appName: string;
+    readonly sessionId: string;
+    readonly scheme: string;
+    readonly isVisible: boolean;
+}
 export interface MicroFrontendLifecycleSession {
     readonly appName: string;
     readonly id: string;
@@ -57,5 +63,9 @@ export interface MicroFrontendRuntimeApi {
     readonly evaluateScript: (filePath: string) => Promise<void>;
     readonly preloadApp: (appName: string) => Promise<void>;
     readonly importApp: <TModule>(request: AppRequest) => Promise<TModule>;
+    /** Read the current snapshot without starting event delivery. */
+    readonly getSessions: () => readonly MicroFrontendSessionState[];
+    /** Subscribe to changes and start native delivery if needed; read getSessions() for the initial snapshot. */
+    readonly onSessionsChanged: (listener: (sessions: readonly MicroFrontendSessionState[]) => void) => MicroFrontendRuntimeEventSubscription;
     readonly onEvent: (listener: (event: MicroFrontendSessionEvent) => void) => MicroFrontendRuntimeEventSubscription;
 }

package/ios/PortalHostContainerView.h

@@ -28,9 +28,16 @@ NS_ASSUME_NONNULL_BEGIN
 /// when the host view is created. Pass nil to unregister.
 - (void)setName:(nullable NSString *)name;
 
-/// Creates the underlying Fabric host view, attaches the touch handler, and
-/// applies any pending name. No-op when already activated. Must be called on
-/// the main thread after the React runtime has booted.
+/// Creates the underlying Fabric host view under an `RCTRootComponentView`
+/// anchor, attaches the touch handler, and applies any pending name. No-op when
+/// already activated. Must be called on the main thread after the React runtime
+/// has booted.
+///
+/// The anchor makes hosted screens count as mounted under a React root for
+/// react-native-screens, so they do not attach a second touch handler beneath
+/// the container's. Hosted content therefore gets one handler and page
+/// coordinates relative to this container, like content under a regular React
+/// Native root.
 - (void)activateIfNeeded;
 
 /// Whether the underlying Fabric host view has been created.

package/ios/PortalHostContainerView.mm

@@ -1,9 +1,183 @@
 #import "PortalHostContainerView.h"
 
+#import <React/RCTRootComponentView.h>
 #import <React/RCTSurfaceTouchHandler.h>
 #import "PortalHostView.h"
 
+@interface GranitePortalSurfaceTouchHandler : RCTSurfaceTouchHandler
+@end
+
+static BOOL GraniteIsSurfaceTouchHandler(UIGestureRecognizer *recognizer)
+{
+  return [recognizer isKindOfClass:[RCTSurfaceTouchHandler class]];
+}
+
+static BOOL GraniteIsPortalSurfaceTouchHandler(UIGestureRecognizer *recognizer)
+{
+  return [recognizer isKindOfClass:[GranitePortalSurfaceTouchHandler class]];
+}
+
+/// What a single view contributes to touch ownership. A view installs at most
+/// one meaningful Fabric touch root: none, a Portal one, or a foreign one that
+/// belongs to a plain React Native root and outranks any Portal handler.
+typedef NS_ENUM(NSUInteger, GraniteTouchRootKind) {
+  GraniteTouchRootKindNone = 0,
+  GraniteTouchRootKindPortal,
+  GraniteTouchRootKindForeign,
+};
+
+/// Classifies the Fabric touch root installed on a single view of the touch path.
+///
+/// Takes `view.gestureRecognizers` and ignores everything that is not an enabled
+/// `RCTSurfaceTouchHandler`: disabled handlers never dispatch, and unrelated
+/// recognizers (scroll, pan, and friends) do not own Fabric touch dispatch.
+///
+/// A foreign handler wins over a Portal handler on the same view. A screen mounted
+/// outside a React root can install its own handler beneath the Portal container,
+/// and yielding to it is what stops both handlers from forwarding the same tap.
+///
+/// On `GraniteTouchRootKindPortal` the first matching handler is written to
+/// `outHandler`, which is left untouched for the other kinds.
+static GraniteTouchRootKind GraniteTouchRootOnView(
+    UIView *view,
+    GranitePortalSurfaceTouchHandler *__strong *outHandler)
+{
+  __block GraniteTouchRootKind kind = GraniteTouchRootKindNone;
+  __block GranitePortalSurfaceTouchHandler *portalHandler = nil;
+
+  [view.gestureRecognizers enumerateObjectsUsingBlock:^(
+                               UIGestureRecognizer *recognizer,
+                               __unused NSUInteger index,
+                               BOOL *stop) {
+    if (!recognizer.isEnabled || !GraniteIsSurfaceTouchHandler(recognizer)) {
+      return;
+    }
+    if (!GraniteIsPortalSurfaceTouchHandler(recognizer)) {
+      kind = GraniteTouchRootKindForeign;
+      *stop = YES;
+      return;
+    }
+    if (kind == GraniteTouchRootKindNone) {
+      kind = GraniteTouchRootKindPortal;
+      portalHandler = (GranitePortalSurfaceTouchHandler *)recognizer;
+    }
+  }];
+
+  if (kind == GraniteTouchRootKindPortal) {
+    *outHandler = portalHandler;
+  }
+
+  return kind;
+}
+
+/// Walks the touch path upwards from `view` and reports whether it stays Portal-owned.
+///
+/// Recurses through `view.superview`, classifying each view with
+/// `GraniteTouchRootOnView`. Returns NO as soon as a foreign React Native root
+/// claims the path, and YES once the walk runs past the top without meeting one.
+///
+/// `outOwningPortalHandler` receives the Portal handler whose container hosts the
+/// touched view. It accumulates across the recursion and must start as nil: the
+/// walk runs bottom-up, so the first Portal handler met is the hosting one.
+static BOOL GranitePortalOwnsTouchPath(
+    UIView *view,
+    GranitePortalSurfaceTouchHandler *__strong *outOwningPortalHandler)
+{
+  if (view == nil) {
+    return YES;
+  }
+
+  GranitePortalSurfaceTouchHandler *handlerOnView = nil;
+
+  switch (GraniteTouchRootOnView(view, &handlerOnView)) {
+    case GraniteTouchRootKindForeign:
+      // A React Native root owns this touch path; let it dispatch alone.
+      return NO;
+    case GraniteTouchRootKindPortal:
+      if (*outOwningPortalHandler == nil) {
+        *outOwningPortalHandler = handlerOnView;
+      }
+      break;
+    case GraniteTouchRootKindNone:
+      break;
+  }
+
+  return GranitePortalOwnsTouchPath(view.superview, outOwningPortalHandler);
+}
+
+/// Decides whether `touchHandler` is the single handler allowed to dispatch `touch`.
+///
+/// Takes the handler's own view and the touched view, then hands the actual touch
+/// path — the touched view up through its superviews — to `GranitePortalOwnsTouchPath`.
+/// The handler dispatches only when it is the Portal handler owning that path.
+///
+/// Why this leaves exactly one handler, however many Portals exist:
+///
+/// Sibling Portals never see each other's touches.
+///
+///     screen
+///      ├ portalA  <- handlerA
+///      │   └ leafA
+///      └ portalB  <- handlerB
+///          └ leafB
+///
+/// UIKit only asks `shouldReceiveTouch:` of recognizers on the touched view and its
+/// ancestors, so handlerB is never asked about `leafA`. Even if it were, the
+/// `isDescendantOfView:` guard below rejects a touch outside the handler's own subtree.
+///
+/// Nested Portals are all asked, and all resolve to the same owner.
+///
+///     portalA  <- handlerA
+///      └ portalB  <- handlerB
+///         └ portalC  <- handlerC
+///            └ leaf
+///
+/// A, B and C are all ancestors of `leaf`, so UIKit asks all three. Each one walks
+/// the same path from `leaf` upwards, and the walk direction is fixed, so each one
+/// meets C first. `owningPortalHandler == touchHandler` therefore holds for C alone;
+/// A and B yield. Any nesting depth leaves exactly one handler.
+///
+/// C is also the right owner, not merely the unique one. Portal content is always
+/// mounted inside its own container's subtree, so the first container met is the one
+/// whose surface rendered `leaf`. Fabric resolves the event receiver from the touched
+/// component view regardless of which handler fires, but it computes page coordinates
+/// relative to the firing handler's view — and `leaf` belongs to C's coordinate space.
+///
+/// Plain hosted content installs no touch root of its own and so resolves to the
+/// container hosting it.
+static BOOL GranitePortalSurfaceTouchHandlerShouldReceiveTouch(
+    GranitePortalSurfaceTouchHandler *touchHandler,
+    UITouch *touch)
+{
+  UIView *handlerView = touchHandler.view;
+  UIView *touchView = touch.view;
+
+  // A touch that never entered this container is none of its business.
+  if (handlerView == nil || touchView == nil || ![touchView isDescendantOfView:handlerView]) {
+    return NO;
+  }
+
+  GranitePortalSurfaceTouchHandler *owningPortalHandler = nil;
+  if (!GranitePortalOwnsTouchPath(touchView, &owningPortalHandler)) {
+    return NO;
+  }
+
+  // No Portal handler on the path means this one detached mid-touch: stay
+  // permissive rather than dropping the touch entirely.
+  return owningPortalHandler == nil || owningPortalHandler == touchHandler;
+}
+
+@implementation GranitePortalSurfaceTouchHandler
+
+- (BOOL)gestureRecognizer:(__unused UIGestureRecognizer *)gestureRecognizer shouldReceiveTouch:(UITouch *)touch
+{
+  return GranitePortalSurfaceTouchHandlerShouldReceiveTouch(self, touch);
+}
+
+@end
+
 @implementation PortalHostContainerView {
+  RCTRootComponentView *_reactRootAnchor;
   PortalHostView *_portalHostView;
   RCTSurfaceTouchHandler *_touchHandler;
   NSString *_pendingName;
@@ -49,16 +223,37 @@
     return;
   }
 
-  _portalHostView = [[PortalHostView alloc] initWithFrame:self.bounds];
+  // Hosted content mounts under an RCTRootComponentView anchor so react-native-screens treats
+  // hosted screens as root-mounted. RNSScreenView walks its superview chain for an
+  // RCTRootComponentView (or another RNSScreenView) in -isMountedUnderScreenOrReactRoot and, when
+  // it finds none, attaches its own RCTSurfaceTouchHandler in -didMoveToWindow. Under a Portal
+  // host that second handler would sit beneath this container's handler, every tap would reach JS
+  // twice, and on the second touchStart an ancestor PanResponder could steal the responder from
+  // the tapped Pressable. With the anchor, hosted screens see the same tree shape as content under
+  // a regular RCTSurfaceView: one handler, page coordinates relative to this container.
+  //
+  // The anchor is never registered with Fabric (tag 0, no event emitter, no shadow node); it is
+  // only a superview. The host view joins it through -addSubview:, not
+  // -mountChildComponentView:index:, so the anchor never posts RCTContentDidAppearNotification.
+  // It is created here rather than in -init for the same reason the host view is deferred: an
+  // RCTViewComponentView reads ReactNativeFeatureFlags while it settles into the view hierarchy,
+  // which must not happen before the host's boot-time override (see the header on deferred
+  // activation).
+  _reactRootAnchor = [[RCTRootComponentView alloc] initWithFrame:self.bounds];
+  _reactRootAnchor.autoresizingMask =
+      UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
+  [self addSubview:_reactRootAnchor];
+
+  _portalHostView = [[PortalHostView alloc] initWithFrame:_reactRootAnchor.bounds];
   _portalHostView.autoresizingMask =
       UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
   __weak PortalHostContainerView *weakSelf = self;
   _portalHostView.onSubviewCountChanged = ^{
     [weakSelf handleSubviewCountChanged];
   };
-  [self addSubview:_portalHostView];
+  [_reactRootAnchor addSubview:_portalHostView];
 
-  _touchHandler = [RCTSurfaceTouchHandler new];
+  _touchHandler = [GranitePortalSurfaceTouchHandler new];
   [_touchHandler attachToView:self];
 
   if (_pendingName) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@granite-js/micro-frontend",
-  "version": "2.3.1",
+  "version": "2.4.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",
@@ -56,7 +56,7 @@
   },
   "dependencies": {
     "@babel/core": "7.28.5",
-    "@granite-js/utils": "2.3.1",
+    "@granite-js/utils": "2.4.0",
     "@standard-schema/spec": "^1.0.0"
   },
   "peerDependencies": {
@@ -72,8 +72,8 @@
   },
   "devDependencies": {
     "@babel/types": "7.28.5",
-    "@granite-js/plugin-core": "2.3.1",
-    "@granite-js/react-native": "2.3.1",
+    "@granite-js/plugin-core": "2.4.0",
+    "@granite-js/react-native": "2.4.0",
     "@types/babel__core": "^7.20.5",
     "@types/node": "24.10.12",
     "@types/react": "19.2.0",

package/src/createRoute.ts

@@ -1,6 +1,5 @@
 import {
   createRoute as createGraniteRoute,
-  getSchemeUri,
   type RegisterScreenInput,
   type RouteOptions,
   useNavigation,
@@ -66,12 +65,11 @@ function getCurrentGraniteApp(): PendingHostComponentAppConfig | null {
 
   const host = granite['app']['host'];
   const name = granite['app']['name'];
-  if (typeof host !== 'string' || typeof name !== 'string') {
+  const scheme = granite['app']['scheme'];
+  if (typeof host !== 'string' || typeof name !== 'string' || typeof scheme !== 'string') {
     return null;
   }
 
-  const scheme = new URL(getSchemeUri()).protocol.replace(/:$/g, '');
-
   return {
     name,
     scheme,

package/src/runtime/createMicroFrontendRuntime.ts

@@ -5,12 +5,15 @@ import type {
   MicroFrontendRuntimeApi,
   MicroFrontendRuntimeEvent,
   MicroFrontendRuntimeEventSubscription,
+  MicroFrontendSessionEvent,
+  MicroFrontendSessionState,
 } from '../types';
 import { AppContainerNotFoundError, InvalidAppNameError } from './errors';
 import { getMicroFrontendGlobalContext } from './globalContext';
 import { setMicroFrontendLifecycleCallback } from './lifecycle';
 import { installNativeComponentRegistryCompatibility } from './nativeComponentRegistryCompatibility';
 import { parseAppRequest } from './parseAppRequest';
+import { createSessionStore } from './sessionStore';
 
 export interface NativeMicroFrontendRuntimeEvent {
   readonly name: string;
@@ -51,6 +54,37 @@ export function createMicroFrontendRuntimeWithDependencies(
 ): MicroFrontendRuntimeApi {
   // A fulfilled promise is the evaluated-state cache. Rejected evaluations remove themselves.
   const appEvaluations = new Map<string, Promise<void>>();
+  const sessionStore = createSessionStore();
+  const sessionListeners = new Set<(sessions: readonly MicroFrontendSessionState[]) => void>();
+  const eventListeners = new Set<(event: MicroFrontendSessionEvent) => void>();
+  let nativeSubscription: MicroFrontendRuntimeEventSubscription | undefined;
+
+  function startEventDelivery() {
+    if (nativeSubscription != null) {
+      return;
+    }
+    nativeSubscription = dependencies.nativeRuntime.onEvent((event) => {
+      const parsedEvent = dependencies.parseEvent(event);
+      switch (parsedEvent.name) {
+        case 'preloadApp':
+          void preloadApp(parsedEvent.params.appName).catch(dependencies.onPreloadError);
+          return;
+        case 'openApp':
+        case 'closeApp':
+        case 'sessionVisibilityChanged':
+          if (sessionStore.applyEvent(parsedEvent)) {
+            notifyListeners(sessionListeners, sessionStore.getSessions());
+          }
+          notifyListeners(eventListeners, parsedEvent);
+          return;
+        default: {
+          const exhaustiveEvent: never = parsedEvent;
+          return exhaustiveEvent;
+        }
+      }
+    });
+    dependencies.nativeRuntime.startEventDelivery();
+  }
 
   function resetFailedEvaluation(appName: string) {
     appEvaluations.delete(appName);
@@ -101,26 +135,18 @@ export function createMicroFrontendRuntimeWithDependencies(
       await preloadApp(appName);
       return dependencies.registry.importModule<TModule>(request);
     },
+    getSessions: sessionStore.getSessions,
+    onSessionsChanged(listener) {
+      const callback = (sessions: readonly MicroFrontendSessionState[]) => listener(sessions);
+      sessionListeners.add(callback);
+      startEventDelivery();
+      return { remove: () => sessionListeners.delete(callback) };
+    },
     onEvent(listener) {
-      const subscription = dependencies.nativeRuntime.onEvent((event) => {
-        const parsedEvent = dependencies.parseEvent(event);
-        switch (parsedEvent.name) {
-          case 'preloadApp':
-            void preloadApp(parsedEvent.params.appName).catch(dependencies.onPreloadError);
-            return;
-          case 'openApp':
-          case 'closeApp':
-          case 'sessionVisibilityChanged':
-            listener(parsedEvent);
-            return;
-          default: {
-            const exhaustiveEvent: never = parsedEvent;
-            return exhaustiveEvent;
-          }
-        }
-      });
-      dependencies.nativeRuntime.startEventDelivery();
-      return subscription;
+      const callback = (event: MicroFrontendSessionEvent) => listener(event);
+      eventListeners.add(callback);
+      startEventDelivery();
+      return { remove: () => eventListeners.delete(callback) };
     },
   };
 
@@ -128,3 +154,13 @@ export function createMicroFrontendRuntimeWithDependencies(
 
   return runtime;
 }
+
+function notifyListeners<TEvent>(listeners: ReadonlySet<(event: TEvent) => void>, event: TEvent): void {
+  listeners.forEach((listener) => {
+    try {
+      listener(event);
+    } catch (error) {
+      console.error('Failed to run a micro-frontend runtime listener', error);
+    }
+  });
+}

package/src/runtime/sessionStore.ts

@@ -0,0 +1,40 @@
+import type { MicroFrontendSessionEvent, MicroFrontendSessionState } from '../types';
+
+export function createSessionStore() {
+  let sessions: readonly MicroFrontendSessionState[] = Object.freeze([]);
+
+  return {
+    getSessions: () => sessions,
+    applyEvent(event: MicroFrontendSessionEvent): boolean {
+      const nextSessions = reduceSessions(sessions, event);
+      if (nextSessions === sessions) {
+        return false;
+      }
+      sessions = Object.freeze(nextSessions);
+      return true;
+    },
+  };
+}
+
+function reduceSessions(
+  sessions: readonly MicroFrontendSessionState[],
+  event: MicroFrontendSessionEvent
+): readonly MicroFrontendSessionState[] {
+  const session = sessions.find(({ sessionId }) => sessionId === event.params.sessionId);
+  switch (event.name) {
+    case 'openApp':
+      return session == null ? [...sessions, Object.freeze({ ...event.params, isVisible: false })] : sessions;
+    case 'closeApp':
+      return session == null ? sessions : sessions.filter(({ sessionId }) => sessionId !== event.params.sessionId);
+    case 'sessionVisibilityChanged':
+      return session == null || session.isVisible === event.params.isVisible
+        ? sessions
+        : sessions.map((current) =>
+            current === session ? Object.freeze({ ...current, isVisible: event.params.isVisible }) : current
+          );
+    default: {
+      const exhaustiveEvent: never = event;
+      return exhaustiveEvent;
+    }
+  }
+}

package/src/session/useMicroFrontendSessions.ts

@@ -1,4 +1,4 @@
-import { useEffect, useLayoutEffect, useReducer, useRef } from 'react';
+import { useCallback, useEffect, useLayoutEffect, useRef, useSyncExternalStore } from 'react';
 import { installPendingHostComponentBridge, resetPendingHostComponent } from '../host/pendingHostComponentStore';
 import { emitMicroFrontendLifecycleEvent } from '../runtime/lifecycle';
 import { disposeAppResources } from '../runtime/registry';
@@ -6,53 +6,19 @@ import type {
   MicroFrontendLifecycleEvent,
   MicroFrontendLifecycleSession,
   MicroFrontendRuntimeApi,
-  MicroFrontendSessionEvent,
+  MicroFrontendSessionState,
 } from '../types';
 
-export interface MicroFrontendSessionState {
-  readonly appName: string;
-  readonly sessionId: string;
-  readonly scheme: string;
-  readonly isVisible: boolean;
-}
+export type { MicroFrontendSessionState } from '../types';
 
 const INITIAL_SESSIONS: readonly MicroFrontendSessionState[] = [];
 
-function reduceMicroFrontendSessions(
-  sessions: readonly MicroFrontendSessionState[],
-  event: MicroFrontendSessionEvent
-): readonly MicroFrontendSessionState[] {
-  switch (event.name) {
-    case 'openApp':
-      return sessions.some(({ sessionId }) => sessionId === event.params.sessionId)
-        ? sessions
-        : [
-            ...sessions,
-            {
-              appName: event.params.appName,
-              sessionId: event.params.sessionId,
-              scheme: event.params.scheme,
-              isVisible: false,
-            },
-          ];
-    case 'closeApp':
-      return sessions.filter(({ sessionId }) => sessionId !== event.params.sessionId);
-    case 'sessionVisibilityChanged':
-      return sessions.map((session) =>
-        session.sessionId === event.params.sessionId ? { ...session, isVisible: event.params.isVisible } : session
-      );
-    default: {
-      const exhaustiveEvent: never = event;
-      return exhaustiveEvent;
-    }
-  }
-}
-
 export function useMicroFrontendSessions(
-  runtime: Pick<MicroFrontendRuntimeApi, 'onEvent'>
+  runtime: Pick<MicroFrontendRuntimeApi, 'onEvent' | 'getSessions' | 'onSessionsChanged'>
 ): readonly MicroFrontendSessionState[] {
-  const [sessions, dispatch] = useReducer(reduceMicroFrontendSessions, INITIAL_SESSIONS);
-  const previousSessionsRef = useRef(sessions);
+  const subscribe = useCallback((listener: () => void) => runtime.onSessionsChanged(listener).remove, [runtime]);
+  const sessions = useSyncExternalStore(subscribe, runtime.getSessions);
+  const previousSessionsRef = useRef(INITIAL_SESSIONS);
 
   useEffect(() => {
     const previousSessions = previousSessionsRef.current;
@@ -106,7 +72,6 @@ export function useMicroFrontendSessions(
       if (event.name === 'openApp') {
         resetPendingHostComponent();
       }
-      dispatch(event);
     });
 
     return () => subscription.remove();

package/src/types.ts

@@ -48,6 +48,13 @@ export interface MicroFrontendRuntimeEventSubscription {
   readonly remove: () => void;
 }
 
+export interface MicroFrontendSessionState {
+  readonly appName: string;
+  readonly sessionId: string;
+  readonly scheme: string;
+  readonly isVisible: boolean;
+}
+
 export interface MicroFrontendLifecycleSession {
   readonly appName: string;
   readonly id: string;
@@ -66,5 +73,11 @@ export interface MicroFrontendRuntimeApi {
   readonly evaluateScript: (filePath: string) => Promise<void>;
   readonly preloadApp: (appName: string) => Promise<void>;
   readonly importApp: <TModule>(request: AppRequest) => Promise<TModule>;
+  /** Read the current snapshot without starting event delivery. */
+  readonly getSessions: () => readonly MicroFrontendSessionState[];
+  /** Subscribe to changes and start native delivery if needed; read getSessions() for the initial snapshot. */
+  readonly onSessionsChanged: (
+    listener: (sessions: readonly MicroFrontendSessionState[]) => void
+  ) => MicroFrontendRuntimeEventSubscription;
   readonly onEvent: (listener: (event: MicroFrontendSessionEvent) => void) => MicroFrontendRuntimeEventSubscription;
 }