@appshell/react-shell 1.0.0-alpha.14 → 1.0.0-alpha.15

package/dist/dev/mf-manifest.json

@@ -5,7 +5,7 @@
     "name": "Appshell",
     "type": "app",
     "buildInfo": {
-      "buildVersion": "1.0.0-alpha.14",
+      "buildVersion": "1.0.0-alpha.15",
       "buildName": "@appshell/react-shell"
     },
     "remoteEntry": {
@@ -24,6 +24,26 @@
     "publicPath": "auto"
   },
   "shared": [
+    {
+      "id": "Appshell:@appshell/runtime",
+      "name": "@appshell/runtime",
+      "version": "1.0.0-alpha.15",
+      "singleton": true,
+      "requiredVersion": "^1.0.0-alpha.15",
+      "assets": {
+        "js": {
+          "async": [],
+          "sync": [
+            "runtime_src_index_ts.js"
+          ]
+        },
+        "css": {
+          "async": [],
+          "sync": []
+        }
+      },
+      "fallback": ""
+    },
     {
       "id": "Appshell:react-dom",
       "name": "react-dom",

package/dist/dev/mf-stats.json

@@ -5,7 +5,7 @@
     "name": "Appshell",
     "type": "app",
     "buildInfo": {
-      "buildVersion": "1.0.0-alpha.14",
+      "buildVersion": "1.0.0-alpha.15",
       "buildName": "@appshell/react-shell"
     },
     "remoteEntry": {
@@ -24,6 +24,30 @@
     "publicPath": "auto"
   },
   "shared": [
+    {
+      "singleton": true,
+      "requiredVersion": "^1.0.0-alpha.15",
+      "shareScope": "default",
+      "name": "@appshell/runtime",
+      "version": "1.0.0-alpha.15",
+      "eager": false,
+      "id": "Appshell:@appshell/runtime",
+      "assets": {
+        "js": {
+          "async": [],
+          "sync": [
+            "runtime_src_index_ts.js"
+          ]
+        },
+        "css": {
+          "async": [],
+          "sync": []
+        }
+      },
+      "usedIn": [],
+      "usedExports": [],
+      "fallback": ""
+    },
     {
       "singleton": true,
       "requiredVersion": "18.2.0",

package/dist/dev/runtime_src_index_ts.js

@@ -0,0 +1,150 @@
+"use strict";
+(globalThis["webpackChunkappshell_react_shell"] = globalThis["webpackChunkappshell_react_shell"] || []).push([["runtime_src_index_ts"],{
+
+/***/ "../runtime/src/errors.ts"
+/*!********************************!*\
+  !*** ../runtime/src/errors.ts ***!
+  \********************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   MissingVarsError: () => (/* binding */ MissingVarsError),
+/* harmony export */   VarsConflictError: () => (/* binding */ VarsConflictError)
+/* harmony export */ });
+/* eslint-disable max-classes-per-file */
+/**
+ * A package asked for vars that were never delivered.
+ *
+ * Almost always one of three things: the package was loaded outside `remoteLoader`
+ * (a test, a storybook, a direct import), the host and the package resolved separate
+ * copies of `@appshell/runtime` because one of them failed to declare it as a
+ * singleton, or the scope compiled into the package is not the scope the registry
+ * knows it by.
+ */
+class MissingVarsError extends Error {
+  constructor(scope, known) {
+    super(`No vars were delivered for '${scope}'. ${known.length ? `Vars are present for ${known.map(s => `'${s}'`).join(', ')} — check that ` + `'${scope}' matches the module federation name the registry knows this package by.` : `Nothing has delivered vars on this page — check that the host and this package ` + `both declare '@appshell/runtime' as a shared singleton.`}`);
+    this.name = 'MissingVarsError';
+    this.scope = scope;
+  }
+}
+
+/**
+ * Something tried to replace vars that were already delivered for a scope.
+ *
+ * The first write wins and is final. Within one page load a scope has exactly one
+ * vars object — both resolvers read it from the same `composition.vars[scope]` — so a
+ * differing second write is a bug or a package reaching for a scope that is not its own,
+ * and neither should be applied quietly.
+ */
+class VarsConflictError extends Error {
+  constructor(scope) {
+    super(`Vars for '${scope}' were already delivered and cannot be replaced. ` + `A scope receives its vars once per page load.`);
+    this.name = 'VarsConflictError';
+    this.scope = scope;
+  }
+}
+
+/***/ },
+
+/***/ "../runtime/src/index.ts"
+/*!*******************************!*\
+  !*** ../runtime/src/index.ts ***!
+  \*******************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   MissingVarsError: () => (/* reexport safe */ _errors__WEBPACK_IMPORTED_MODULE_0__.MissingVarsError),
+/* harmony export */   VarsConflictError: () => (/* reexport safe */ _errors__WEBPACK_IMPORTED_MODULE_0__.VarsConflictError),
+/* harmony export */   hasVars: () => (/* reexport safe */ _store__WEBPACK_IMPORTED_MODULE_1__.hasVars),
+/* harmony export */   readVars: () => (/* reexport safe */ _store__WEBPACK_IMPORTED_MODULE_1__.readVars),
+/* harmony export */   resetVars: () => (/* reexport safe */ _store__WEBPACK_IMPORTED_MODULE_1__.resetVars),
+/* harmony export */   setVars: () => (/* reexport safe */ _store__WEBPACK_IMPORTED_MODULE_1__.setVars)
+/* harmony export */ });
+/* harmony import */ var _errors__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./errors */ "../runtime/src/errors.ts");
+/* harmony import */ var _store__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./store */ "../runtime/src/store.ts");
+
+
+
+/***/ },
+
+/***/ "../runtime/src/store.ts"
+/*!*******************************!*\
+  !*** ../runtime/src/store.ts ***!
+  \*******************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   hasVars: () => (/* binding */ hasVars),
+/* harmony export */   readVars: () => (/* binding */ readVars),
+/* harmony export */   resetVars: () => (/* binding */ resetVars),
+/* harmony export */   setVars: () => (/* binding */ setVars)
+/* harmony export */ });
+/* harmony import */ var _errors__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./errors */ "../runtime/src/errors.ts");
+
+/**
+ * One map per page, because this module is a shared singleton. Keyed by federation
+ * scope, which is the only identity the host and the package agree on.
+ */
+const delivered = new Map();
+
+/** Order-independent: vars are flat, one level of string/number/undefined. */
+const same = (a, b) => {
+  const keys = new Set([...Object.keys(a), ...Object.keys(b)]);
+  return [...keys].every(key => a[key] === b[key]);
+};
+
+/**
+ * Delivers a scope's vars. Called by `@appshell/loader` immediately before the remote
+ * is loaded, so they are in place before the package's modules evaluate.
+ *
+ * The first write for a scope wins and is frozen. Re-delivering the identical vars is a
+ * no-op — the same remote can be mounted more than once — but replacing them throws.
+ * That is what keeps one package from overwriting another's: by the time any package
+ * evaluates, the host has already written for it.
+ *
+ * It does not make a scope's vars *private*. Any code on the page can still read another
+ * scope by name, and nothing short of a separate realm would change that.
+ */
+const setVars = (scope, vars) => {
+  const existing = delivered.get(scope);
+  if (existing) {
+    if (!same(existing, vars)) {
+      throw new _errors__WEBPACK_IMPORTED_MODULE_0__.VarsConflictError(scope);
+    }
+    return;
+  }
+  delivered.set(scope, Object.freeze({
+    ...vars
+  }));
+};
+
+/**
+ * Reads a scope's vars, throwing rather than handing back an empty object — a package
+ * that silently renders with no configuration is the failure this replaced.
+ *
+ * Prefer `getVars()` from `@appshell/vars`, which supplies the scope for you.
+ */
+const readVars = scope => {
+  const vars = delivered.get(scope);
+  if (!vars) {
+    throw new _errors__WEBPACK_IMPORTED_MODULE_0__.MissingVarsError(scope, [...delivered.keys()]);
+  }
+  return vars;
+};
+
+/** Whether a scope has been delivered, for callers that want to branch instead of catch. */
+const hasVars = scope => delivered.has(scope);
+
+/** Test seam. Not part of the contract a package should build on. */
+const resetVars = () => {
+  delivered.clear();
+};
+
+/***/ }
+
+}]);
+//# sourceMappingURL=runtime_src_index_ts.js.map

package/dist/dev/runtime_src_index_ts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime_src_index_ts.js","mappings":";;;;;;;;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,gBAAgB,SAASC,KAAK,CAAC;EAG1CC,WAAWA,CAACC,KAAa,EAAEC,KAAe,EAAE;IAC1C,KAAK,CACH,+BAA+BD,KAAK,MAClCC,KAAK,CAACC,MAAM,GACR,wBAAwBD,KAAK,CAACE,GAAG,CAAEC,CAAC,IAAK,IAAIA,CAAC,GAAG,CAAC,CAACC,IAAI,CAAC,IAAI,CAAC,gBAAgB,GAC7E,IAAIL,KAAK,0EAA0E,GACnF,iFAAiF,GACjF,yDAAyD,EAEjE,CAAC;IAED,IAAI,CAACM,IAAI,GAAG,kBAAkB;IAC9B,IAAI,CAACN,KAAK,GAAGA,KAAK;EACpB;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMO,iBAAiB,SAAST,KAAK,CAAC;EAG3CC,WAAWA,CAACC,KAAa,EAAE;IACzB,KAAK,CACH,aAAaA,KAAK,mDAAmD,GACnE,+CACJ,CAAC;IAED,IAAI,CAACM,IAAI,GAAG,mBAAmB;IAC/B,IAAI,CAACN,KAAK,GAAGA,KAAK;EACpB;AACF,C;;;;;;;;;;;;;;;;;;;;;ACjD+D;;;;;;;;;;;;;;;;;;;ACAA;AAG/D;AACA;AACA;AACA;AACA,MAAMY,SAAS,GAAG,IAAIC,GAAG,CAAyB,CAAC;;AAEnD;AACA,MAAMC,IAAI,GAAGA,CAACC,CAAO,EAAEC,CAAO,KAAK;EACjC,MAAMC,IAAI,GAAG,IAAIC,GAAG,CAAC,CAAC,GAAGC,MAAM,CAACF,IAAI,CAACF,CAAC,CAAC,EAAE,GAAGI,MAAM,CAACF,IAAI,CAACD,CAAC,CAAC,CAAC,CAAC;EAE5D,OAAO,CAAC,GAAGC,IAAI,CAAC,CAACG,KAAK,CAAEC,GAAG,IAAKN,CAAC,CAACM,GAAG,CAAC,KAAKL,CAAC,CAACK,GAAG,CAAC,CAAC;AACpD,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMV,OAAO,GAAGA,CAACX,KAAa,EAAEsB,IAAU,KAAW;EAC1D,MAAMC,QAAQ,GAAGX,SAAS,CAACY,GAAG,CAACxB,KAAK,CAAC;EAErC,IAAIuB,QAAQ,EAAE;IACZ,IAAI,CAACT,IAAI,CAACS,QAAQ,EAAED,IAAI,CAAC,EAAE;MACzB,MAAM,IAAIf,sDAAiB,CAACP,KAAK,CAAC;IACpC;IAEA;EACF;EAEAY,SAAS,CAACa,GAAG,CAACzB,KAAK,EAAEmB,MAAM,CAACO,MAAM,CAAC;IAAE,GAAGJ;EAAK,CAAC,CAAC,CAAC;AAClD,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACO,MAAMb,QAAQ,GAA+BT,KAAa,IAAY;EAC3E,MAAMsB,IAAI,GAAGV,SAAS,CAACY,GAAG,CAACxB,KAAK,CAAC;EAEjC,IAAI,CAACsB,IAAI,EAAE;IACT,MAAM,IAAIzB,qDAAgB,CAACG,KAAK,EAAE,CAAC,GAAGY,SAAS,CAACK,IAAI,CAAC,CAAC,CAAC,CAAC;EAC1D;EAEA,OAAOK,IAAI;AACb,CAAC;;AAED;AACO,MAAMd,OAAO,GAAIR,KAAa,IAAcY,SAAS,CAACe,GAAG,CAAC3B,KAAK,CAAC;;AAEvE;AACO,MAAMU,SAAS,GAAGA,CAAA,KAAY;EACnCE,SAAS,CAACgB,KAAK,CAAC,CAAC;AACnB,CAAC,C","sources":["webpack://appshell-react-shell/../runtime/src/errors.ts","webpack://appshell-react-shell/../runtime/src/index.ts","webpack://appshell-react-shell/../runtime/src/store.ts"],"sourcesContent":["/* eslint-disable max-classes-per-file */\n/**\n * A package asked for vars that were never delivered.\n *\n * Almost always one of three things: the package was loaded outside `remoteLoader`\n * (a test, a storybook, a direct import), the host and the package resolved separate\n * copies of `@appshell/runtime` because one of them failed to declare it as a\n * singleton, or the scope compiled into the package is not the scope the registry\n * knows it by.\n */\nexport class MissingVarsError extends Error {\n  readonly scope: string;\n\n  constructor(scope: string, known: string[]) {\n    super(\n      `No vars were delivered for '${scope}'. ${\n        known.length\n          ? `Vars are present for ${known.map((s) => `'${s}'`).join(', ')} — check that ` +\n            `'${scope}' matches the module federation name the registry knows this package by.`\n          : `Nothing has delivered vars on this page — check that the host and this package ` +\n            `both declare '@appshell/runtime' as a shared singleton.`\n      }`,\n    );\n\n    this.name = 'MissingVarsError';\n    this.scope = scope;\n  }\n}\n\n/**\n * Something tried to replace vars that were already delivered for a scope.\n *\n * The first write wins and is final. Within one page load a scope has exactly one\n * vars object — both resolvers read it from the same `composition.vars[scope]` — so a\n * differing second write is a bug or a package reaching for a scope that is not its own,\n * and neither should be applied quietly.\n */\nexport class VarsConflictError extends Error {\n  readonly scope: string;\n\n  constructor(scope: string) {\n    super(\n      `Vars for '${scope}' were already delivered and cannot be replaced. ` +\n        `A scope receives its vars once per page load.`,\n    );\n\n    this.name = 'VarsConflictError';\n    this.scope = scope;\n  }\n}\n","export { MissingVarsError, VarsConflictError } from './errors';\nexport { hasVars, readVars, resetVars, setVars } from './store';\nexport type { Vars } from './types';\n","import { MissingVarsError, VarsConflictError } from './errors';\nimport type { Vars } from './types';\n\n/**\n * One map per page, because this module is a shared singleton. Keyed by federation\n * scope, which is the only identity the host and the package agree on.\n */\nconst delivered = new Map<string, Readonly<Vars>>();\n\n/** Order-independent: vars are flat, one level of string/number/undefined. */\nconst same = (a: Vars, b: Vars) => {\n  const keys = new Set([...Object.keys(a), ...Object.keys(b)]);\n\n  return [...keys].every((key) => a[key] === b[key]);\n};\n\n/**\n * Delivers a scope's vars. Called by `@appshell/loader` immediately before the remote\n * is loaded, so they are in place before the package's modules evaluate.\n *\n * The first write for a scope wins and is frozen. Re-delivering the identical vars is a\n * no-op — the same remote can be mounted more than once — but replacing them throws.\n * That is what keeps one package from overwriting another's: by the time any package\n * evaluates, the host has already written for it.\n *\n * It does not make a scope's vars *private*. Any code on the page can still read another\n * scope by name, and nothing short of a separate realm would change that.\n */\nexport const setVars = (scope: string, vars: Vars): void => {\n  const existing = delivered.get(scope);\n\n  if (existing) {\n    if (!same(existing, vars)) {\n      throw new VarsConflictError(scope);\n    }\n\n    return;\n  }\n\n  delivered.set(scope, Object.freeze({ ...vars }));\n};\n\n/**\n * Reads a scope's vars, throwing rather than handing back an empty object — a package\n * that silently renders with no configuration is the failure this replaced.\n *\n * Prefer `getVars()` from `@appshell/vars`, which supplies the scope for you.\n */\nexport const readVars = <TVars extends Vars = Vars>(scope: string): TVars => {\n  const vars = delivered.get(scope);\n\n  if (!vars) {\n    throw new MissingVarsError(scope, [...delivered.keys()]);\n  }\n\n  return vars as TVars;\n};\n\n/** Whether a scope has been delivered, for callers that want to branch instead of catch. */\nexport const hasVars = (scope: string): boolean => delivered.has(scope);\n\n/** Test seam. Not part of the contract a package should build on. */\nexport const resetVars = (): void => {\n  delivered.clear();\n};\n"],"names":["MissingVarsError","Error","constructor","scope","known","length","map","s","join","name","VarsConflictError","hasVars","readVars","resetVars","setVars","delivered","Map","same","a","b","keys","Set","Object","every","key","vars","existing","get","set","freeze","has","clear"],"sourceRoot":""}