@edynamix/mf-isolation 0.0.2 → 0.0.3

package/README.md

@@ -70,8 +70,33 @@ const providers = provideMfOverlayRoot(mountElement);
 
 The Angular entry point requires `@angular/core` and `@angular/cdk`.
 
+## Host-owned Zone.js
+
+Standalone Angular applications load their own Zone.js runtime as usual:
+
+```ts
+import 'zone.js';
+```
+
+When the application runs as a hosted lifecycle, the host owns the single Zone.js runtime. Check that runtime before dynamically importing any Angular code:
+
+```ts
+import { assertHostZoneRuntime } from '@edynamix/mf-isolation/angular-runtime';
+import type { IShellContext } from './shell-context';
+
+export const mount = async (host: HTMLElement, context: IShellContext): Promise<void> => {
+  assertHostZoneRuntime();
+
+  const lifecycle = await import('./lifecycle-impl');
+  return lifecycle.mount(host, context);
+};
+```
+
+`angular-runtime` is framework-free. It verifies that `globalThis.Zone` is a function; it does not load or modify Zone.js.
+
 ## Exports
 
 - `@edynamix/mf-isolation`
 - `@edynamix/mf-isolation/angular`
+- `@edynamix/mf-isolation/angular-runtime`
 - `@edynamix/mf-isolation/postcss`

package/dist/angular-runtime.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Verifies the host-owned Zone.js runtime before Angular is loaded.
+ *
+ * This check is intentionally framework-free and must run before dynamically
+ * importing an Angular bootstrap module.
+ */
+export declare const assertHostZoneRuntime: () => void;
+//# sourceMappingURL=angular-runtime.d.ts.map

package/dist/angular-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-runtime.d.ts","sourceRoot":"","sources":["../src/angular-runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAO,IAMxC,CAAC"}

package/dist/angular-runtime.js

@@ -0,0 +1,13 @@
+/**
+ * Verifies the host-owned Zone.js runtime before Angular is loaded.
+ *
+ * This check is intentionally framework-free and must run before dynamically
+ * importing an Angular bootstrap module.
+ */
+export const assertHostZoneRuntime = () => {
+    const zoneRuntime = globalThis.Zone;
+    if (typeof zoneRuntime !== 'function') {
+        throw new Error('Host Zone.js runtime is missing. Expected globalThis.Zone to be a function before loading Angular.');
+    }
+};
+//# sourceMappingURL=angular-runtime.js.map

package/dist/angular-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-runtime.js","sourceRoot":"","sources":["../src/angular-runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAS,EAAE;IAC9C,MAAM,WAAW,GAAI,UAAqD,CAAC,IAAI,CAAC;IAEhF,IAAI,OAAO,WAAW,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,oGAAoG,CAAC,CAAC;IACxH,CAAC;AACH,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edynamix/mf-isolation",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "CSS and overlay isolation helpers for eDynamix microfrontends.",
   "license": "UNLICENSED",
   "type": "module",
@@ -20,6 +20,10 @@
       "types": "./dist/angular.d.ts",
       "import": "./dist/angular.js"
     },
+    "./angular-runtime": {
+      "types": "./dist/angular-runtime.d.ts",
+      "import": "./dist/angular-runtime.js"
+    },
     "./postcss": {
       "types": "./dist/postcss.d.ts",
       "import": "./dist/postcss.js"