@foxford/den 3.5.0 → 3.7.0

package/bin/den.cjs

@@ -1,7 +1,7 @@
 "use strict";
 
 
-var _chunkG6RT4EBOcjs = require('../chunk-G6RT4EBO.cjs');
+var _chunkP4J4M2WZcjs = require('../chunk-P4J4M2WZ.cjs');
 require('../chunk-KQAB6C6Q.cjs');
 require('../chunk-A6ZPAM6Z.cjs');
 
@@ -70,11 +70,11 @@ function run(argv) {
     }
     const target = { base: options["base"], root: (_a = options["root"]) != null ? _a : process.cwd() };
     if (command === "build") {
-      yield _chunkG6RT4EBOcjs.buildApp.call(void 0, target);
+      yield _chunkP4J4M2WZcjs.buildApp.call(void 0, target);
       return;
     }
     if (command === "dev") {
-      yield _chunkG6RT4EBOcjs.devApp.call(void 0, target);
+      yield _chunkP4J4M2WZcjs.devApp.call(void 0, target);
       return;
     }
     fail(`\u043D\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043D\u0430\u044F \u043A\u043E\u043C\u0430\u043D\u0434\u0430 \xAB${command}\xBB`);

package/bin/den.js

@@ -1,7 +1,7 @@
 import {
   buildApp,
   devApp
-} from "../chunk-4XR6EUOW.js";
+} from "../chunk-2GTQK2PZ.js";
 import "../chunk-RG7ZV5BD.js";
 import "../chunk-TPBI6TOU.js";
 import {

package/builder/index.cjs

@@ -2,7 +2,7 @@
 
 
 
-var _chunkG6RT4EBOcjs = require('../chunk-G6RT4EBO.cjs');
+var _chunkP4J4M2WZcjs = require('../chunk-P4J4M2WZ.cjs');
 require('../chunk-KQAB6C6Q.cjs');
 require('../chunk-A6ZPAM6Z.cjs');
 require('../chunk-T5QVCXVB.cjs');
@@ -10,4 +10,4 @@ require('../chunk-T5QVCXVB.cjs');
 
 
 
-exports.buildApp = _chunkG6RT4EBOcjs.buildApp; exports.defineAppConfig = _chunkG6RT4EBOcjs.defineAppConfig; exports.devApp = _chunkG6RT4EBOcjs.devApp;
+exports.buildApp = _chunkP4J4M2WZcjs.buildApp; exports.defineAppConfig = _chunkP4J4M2WZcjs.defineAppConfig; exports.devApp = _chunkP4J4M2WZcjs.devApp;

package/builder/index.d.cts

@@ -98,6 +98,15 @@ interface AppConfig {
      */
     preset?: AppBuildPreset;
     server?: AppServerConfig;
+    /**
+     * Расширения рантайма — модули, чей default-экспорт это `RuntimeExtension` из
+     * `@foxford/den/island`: `['@foxford/den-sdk/runtime']`.
+     *
+     * Именами, а не значениями, по той же причине, что и `clientEntry`: расширение ставится и
+     * в браузере, и на сервере, а конфиг живёт в процессе сборки и в бандл не переезжает.
+     * Обвязка обоих выходов импортирует их и ставит в контейнер приложения до первого острова.
+     */
+    runtime?: string[];
     /**
      * Последнее слово за приложением: правит собранный конфиг сборщика перед запуском.
      *

package/builder/index.d.ts

@@ -98,6 +98,15 @@ interface AppConfig {
      */
     preset?: AppBuildPreset;
     server?: AppServerConfig;
+    /**
+     * Расширения рантайма — модули, чей default-экспорт это `RuntimeExtension` из
+     * `@foxford/den/island`: `['@foxford/den-sdk/runtime']`.
+     *
+     * Именами, а не значениями, по той же причине, что и `clientEntry`: расширение ставится и
+     * в браузере, и на сервере, а конфиг живёт в процессе сборки и в бандл не переезжает.
+     * Обвязка обоих выходов импортирует их и ставит в контейнер приложения до первого острова.
+     */
+    runtime?: string[];
     /**
      * Последнее слово за приложением: правит собранный конфиг сборщика перед запуском.
      *

package/builder/index.js

@@ -2,7 +2,7 @@ import {
   buildApp,
   defineAppConfig,
   devApp
-} from "../chunk-4XR6EUOW.js";
+} from "../chunk-2GTQK2PZ.js";
 import "../chunk-RG7ZV5BD.js";
 import "../chunk-TPBI6TOU.js";
 import "../chunk-6FNC3XMI.js";

package/{chunk-4XR6EUOW.js → chunk-2GTQK2PZ.js}

@@ -79,26 +79,44 @@ var VIRTUAL_SERVER_PROCESS = "virtual:den/server-process";
 function toResolvedId(id) {
   return `\0${id}`;
 }
-function generateClientEntry(entry, clientEntry) {
-  return `import app from ${JSON.stringify(entry)}
+function generateClientEntry(entry, clientEntry, runtime = []) {
+  return `${runtimeImports(runtime)}import app from ${JSON.stringify(entry)}
 import { hydrateApp } from ${JSON.stringify(clientEntry)}
 
-hydrateApp(app)
+${runtimeInstall(runtime)}hydrateApp(app)
 `;
 }
-function generateServerApp(entry, configPath, assets) {
-  return `import { getAppContainer, viewAdapterOf } from '@foxford/den/island'
+function runtimeImports(runtime) {
+  if (runtime.length === 0) {
+    return "";
+  }
+  return `import { getAppContainer, installRuntime } from '@foxford/den/island'
+${runtime.map((specifier, index) => `import runtime${String(index)} from ${JSON.stringify(specifier)}`).join("\n")}
+`;
+}
+function runtimeInstall(runtime) {
+  if (runtime.length === 0) {
+    return "";
+  }
+  return `installRuntime(getAppContainer(), [${runtime.map((_, index) => `runtime${String(index)}`).join(", ")}])
+`;
+}
+function generateServerApp(entry, configPath, assets, runtime = []) {
+  const imports = runtime.map((specifier, index) => `import runtime${String(index)} from ${JSON.stringify(specifier)}
+`).join("");
+  const install = runtime.length === 0 ? "" : `  ${runtimeInstall(runtime)}`;
+  return `import { getAppContainer, installRuntime, viewAdapterOf } from '@foxford/den/island'
 
 import app from ${JSON.stringify(entry)}
 import config from ${JSON.stringify(configPath)}
-
+${imports}
 const server = config.server ?? {}
 
 async function setup() {
   if (app.viewLayer) {
     viewAdapterOf(app.viewLayer).installResolver()
   }
-  server.container?.(getAppContainer())
+${install}  server.container?.(getAppContainer())
   await server.setup?.()
 }
 
@@ -139,12 +157,16 @@ function denAppModules(options) {
     // Клиентский вход спрашивают только у клиентского выхода, а его без пресета не собирают.
     // Отказ здесь означает, что выход всё-таки запустили, — это ошибка команд, а не приложения
     [VIRTUAL_CLIENT]: () => {
+      var _a;
       if (!config.preset) {
         throw new Error("den: \u043A\u043B\u0438\u0435\u043D\u0442\u0441\u043A\u0438\u0439 \u0432\u0445\u043E\u0434 \u0437\u0430\u043F\u0440\u043E\u0448\u0435\u043D, \u043D\u043E \u043F\u0440\u0435\u0441\u0435\u0442 \u043D\u0435 \u043E\u0431\u044A\u044F\u0432\u043B\u0435\u043D \u2014 \u043E\u0436\u0438\u0432\u043B\u044F\u0442\u044C \u043D\u0435\u0447\u0435\u043C");
       }
-      return generateClientEntry(entry, config.preset.clientEntry);
+      return generateClientEntry(entry, config.preset.clientEntry, (_a = config.runtime) != null ? _a : []);
+    },
+    [VIRTUAL_SERVER_APP]: () => {
+      var _a;
+      return generateServerApp(entry, configPath, assets, (_a = config.runtime) != null ? _a : []);
     },
-    [VIRTUAL_SERVER_APP]: () => generateServerApp(entry, configPath, assets),
     [VIRTUAL_SERVER_PROCESS]: () => generateServerProcess(configPath, base, mode)
   };
   return {

package/{chunk-G6RT4EBO.cjs → chunk-P4J4M2WZ.cjs}

@@ -79,26 +79,44 @@ var VIRTUAL_SERVER_PROCESS = "virtual:den/server-process";
 function toResolvedId(id) {
   return `\0${id}`;
 }
-function generateClientEntry(entry, clientEntry) {
-  return `import app from ${JSON.stringify(entry)}
+function generateClientEntry(entry, clientEntry, runtime = []) {
+  return `${runtimeImports(runtime)}import app from ${JSON.stringify(entry)}
 import { hydrateApp } from ${JSON.stringify(clientEntry)}
 
-hydrateApp(app)
+${runtimeInstall(runtime)}hydrateApp(app)
 `;
 }
-function generateServerApp(entry, configPath, assets) {
-  return `import { getAppContainer, viewAdapterOf } from '@foxford/den/island'
+function runtimeImports(runtime) {
+  if (runtime.length === 0) {
+    return "";
+  }
+  return `import { getAppContainer, installRuntime } from '@foxford/den/island'
+${runtime.map((specifier, index) => `import runtime${String(index)} from ${JSON.stringify(specifier)}`).join("\n")}
+`;
+}
+function runtimeInstall(runtime) {
+  if (runtime.length === 0) {
+    return "";
+  }
+  return `installRuntime(getAppContainer(), [${runtime.map((_, index) => `runtime${String(index)}`).join(", ")}])
+`;
+}
+function generateServerApp(entry, configPath, assets, runtime = []) {
+  const imports = runtime.map((specifier, index) => `import runtime${String(index)} from ${JSON.stringify(specifier)}
+`).join("");
+  const install = runtime.length === 0 ? "" : `  ${runtimeInstall(runtime)}`;
+  return `import { getAppContainer, installRuntime, viewAdapterOf } from '@foxford/den/island'
 
 import app from ${JSON.stringify(entry)}
 import config from ${JSON.stringify(configPath)}
-
+${imports}
 const server = config.server ?? {}
 
 async function setup() {
   if (app.viewLayer) {
     viewAdapterOf(app.viewLayer).installResolver()
   }
-  server.container?.(getAppContainer())
+${install}  server.container?.(getAppContainer())
   await server.setup?.()
 }
 
@@ -139,12 +157,16 @@ function denAppModules(options) {
     // Клиентский вход спрашивают только у клиентского выхода, а его без пресета не собирают.
     // Отказ здесь означает, что выход всё-таки запустили, — это ошибка команд, а не приложения
     [VIRTUAL_CLIENT]: () => {
+      var _a;
       if (!config.preset) {
         throw new Error("den: \u043A\u043B\u0438\u0435\u043D\u0442\u0441\u043A\u0438\u0439 \u0432\u0445\u043E\u0434 \u0437\u0430\u043F\u0440\u043E\u0448\u0435\u043D, \u043D\u043E \u043F\u0440\u0435\u0441\u0435\u0442 \u043D\u0435 \u043E\u0431\u044A\u044F\u0432\u043B\u0435\u043D \u2014 \u043E\u0436\u0438\u0432\u043B\u044F\u0442\u044C \u043D\u0435\u0447\u0435\u043C");
       }
-      return generateClientEntry(entry, config.preset.clientEntry);
+      return generateClientEntry(entry, config.preset.clientEntry, (_a = config.runtime) != null ? _a : []);
+    },
+    [VIRTUAL_SERVER_APP]: () => {
+      var _a;
+      return generateServerApp(entry, configPath, assets, (_a = config.runtime) != null ? _a : []);
     },
-    [VIRTUAL_SERVER_APP]: () => generateServerApp(entry, configPath, assets),
     [VIRTUAL_SERVER_PROCESS]: () => generateServerProcess(configPath, base, mode)
   };
   return {

package/{chunk-JMRHLOBD.cjs → chunk-QTWJTYZW.cjs}

@@ -19,14 +19,55 @@ function isDocumentSource(value) {
   return typeof value === "object" && value !== null && typeof value.describeDocument === "function";
 }
 
+// src/island/runtime.ts
+var _ioc = require('@foxford/ioc');
+var appContainer = null;
+function getAppContainer() {
+  var _a;
+  if (appContainer === null) {
+    appContainer = new (0, _ioc.Container)();
+    ((_a = _chunkA6ZPAM6Zcjs.logger.getLogger("island:runtime")) != null ? _a : _chunkA6ZPAM6Zcjs.logger).debug("app-\u043A\u043E\u043D\u0442\u0435\u0439\u043D\u0435\u0440 \u0441\u043E\u0437\u0434\u0430\u043D");
+  }
+  return appContainer;
+}
+var RuntimeExtensionsToken = _ioc.createToken.call(void 0, "den:RuntimeExtensions");
+function installRuntime(container, extensions) {
+  var _a;
+  const installed = container.has(RuntimeExtensionsToken) ? container.resolve(RuntimeExtensionsToken) : bindInstalled(container);
+  for (const extension of extensions) {
+    for (const unit of extension.units) {
+      unit.register(container);
+    }
+    installed.push(extension);
+    ((_a = _chunkA6ZPAM6Zcjs.logger.getLogger("island:runtime")) != null ? _a : _chunkA6ZPAM6Zcjs.logger).debug(`\u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043D\u0438\u0435 \u0440\u0430\u043D\u0442\u0430\u0439\u043C\u0430 \xAB${extension.name}\xBB \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043E`);
+  }
+}
+function bindInstalled(container) {
+  const installed = [];
+  container.bind(RuntimeExtensionsToken).toValue(installed);
+  return installed;
+}
+function runtimeRequiresOf(container) {
+  if (!container.has(RuntimeExtensionsToken)) {
+    return [];
+  }
+  return container.resolve(RuntimeExtensionsToken).flatMap((extension) => {
+    var _a;
+    return (_a = extension.requires) != null ? _a : [];
+  });
+}
+
 // src/island/inputs.ts
-function islandInputsOf(descriptor, source) {
+function requiredTokens(descriptor, container) {
   var _a;
+  return [...(_a = descriptor.requires) != null ? _a : [], ...runtimeRequiresOf(container)];
+}
+function islandInputsOf(descriptor, source, container = getAppContainer()) {
   const inputs = {};
   if (source === void 0) {
     return inputs;
   }
-  for (const token of (_a = descriptor.requires) != null ? _a : []) {
+  for (const token of requiredTokens(descriptor, container)) {
     const value = source[token.description];
     if (value !== void 0) {
       inputs[token.description] = value;
@@ -35,11 +76,10 @@ function islandInputsOf(descriptor, source) {
   return inputs;
 }
 function bindIslandInputs(container, descriptor, inputs) {
-  var _a;
   if (inputs === void 0) {
     return;
   }
-  for (const token of (_a = descriptor.requires) != null ? _a : []) {
+  for (const token of requiredTokens(descriptor, container)) {
     const value = inputs[token.description];
     if (value !== void 0) {
       container.bind(token).toValue(value);
@@ -70,18 +110,6 @@ function bindRequestContext(container, context) {
   }
 }
 
-// src/island/runtime.ts
-var _ioc = require('@foxford/ioc');
-var appContainer = null;
-function getAppContainer() {
-  var _a;
-  if (appContainer === null) {
-    appContainer = new (0, _ioc.Container)();
-    ((_a = _chunkA6ZPAM6Zcjs.logger.getLogger("island:runtime")) != null ? _a : _chunkA6ZPAM6Zcjs.logger).debug("app-\u043A\u043E\u043D\u0442\u0435\u0439\u043D\u0435\u0440 \u0441\u043E\u0437\u0434\u0430\u043D");
-  }
-  return appContainer;
-}
-
 // src/island/lifecycle.ts
 var _logger = require('@foxford/logger');
 var EMPTY_ROUTE = { params: {}, pathname: "", search: "" };
@@ -298,4 +326,7 @@ function pathPattern(pattern) {
 
 
 
-exports.isDocumentSource = isDocumentSource; exports.islandInputsOf = islandInputsOf; exports.bindIslandInputs = bindIslandInputs; exports.parseCookieHeader = parseCookieHeader; exports.browserRequestContext = browserRequestContext; exports.bindRequestContext = bindRequestContext; exports.getAppContainer = getAppContainer; exports.createIslandContainer = createIslandContainer; exports.hydrateIslandState = hydrateIslandState; exports.activateIslandViewModels = activateIslandViewModels; exports.collectIslandState = collectIslandState; exports.collectDocumentContribution = collectDocumentContribution; exports.resolveEagerUnits = resolveEagerUnits; exports.renderApp = renderApp; exports.normalizeRoutes = normalizeRoutes; exports.matchRoute = matchRoute; exports.pathPattern = pathPattern;
+
+
+
+exports.isDocumentSource = isDocumentSource; exports.getAppContainer = getAppContainer; exports.RuntimeExtensionsToken = RuntimeExtensionsToken; exports.installRuntime = installRuntime; exports.runtimeRequiresOf = runtimeRequiresOf; exports.islandInputsOf = islandInputsOf; exports.bindIslandInputs = bindIslandInputs; exports.parseCookieHeader = parseCookieHeader; exports.browserRequestContext = browserRequestContext; exports.bindRequestContext = bindRequestContext; exports.createIslandContainer = createIslandContainer; exports.hydrateIslandState = hydrateIslandState; exports.activateIslandViewModels = activateIslandViewModels; exports.collectIslandState = collectIslandState; exports.collectDocumentContribution = collectDocumentContribution; exports.resolveEagerUnits = resolveEagerUnits; exports.renderApp = renderApp; exports.normalizeRoutes = normalizeRoutes; exports.matchRoute = matchRoute; exports.pathPattern = pathPattern;

package/{chunk-VO3ORM7Z.js → chunk-XQ7EHXHG.js}

@@ -19,14 +19,55 @@ function isDocumentSource(value) {
   return typeof value === "object" && value !== null && typeof value.describeDocument === "function";
 }
 
+// src/island/runtime.ts
+import { Container, createToken } from "@foxford/ioc";
+var appContainer = null;
+function getAppContainer() {
+  var _a;
+  if (appContainer === null) {
+    appContainer = new Container();
+    ((_a = logger.getLogger("island:runtime")) != null ? _a : logger).debug("app-\u043A\u043E\u043D\u0442\u0435\u0439\u043D\u0435\u0440 \u0441\u043E\u0437\u0434\u0430\u043D");
+  }
+  return appContainer;
+}
+var RuntimeExtensionsToken = createToken("den:RuntimeExtensions");
+function installRuntime(container, extensions) {
+  var _a;
+  const installed = container.has(RuntimeExtensionsToken) ? container.resolve(RuntimeExtensionsToken) : bindInstalled(container);
+  for (const extension of extensions) {
+    for (const unit of extension.units) {
+      unit.register(container);
+    }
+    installed.push(extension);
+    ((_a = logger.getLogger("island:runtime")) != null ? _a : logger).debug(`\u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043D\u0438\u0435 \u0440\u0430\u043D\u0442\u0430\u0439\u043C\u0430 \xAB${extension.name}\xBB \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043E`);
+  }
+}
+function bindInstalled(container) {
+  const installed = [];
+  container.bind(RuntimeExtensionsToken).toValue(installed);
+  return installed;
+}
+function runtimeRequiresOf(container) {
+  if (!container.has(RuntimeExtensionsToken)) {
+    return [];
+  }
+  return container.resolve(RuntimeExtensionsToken).flatMap((extension) => {
+    var _a;
+    return (_a = extension.requires) != null ? _a : [];
+  });
+}
+
 // src/island/inputs.ts
-function islandInputsOf(descriptor, source) {
+function requiredTokens(descriptor, container) {
   var _a;
+  return [...(_a = descriptor.requires) != null ? _a : [], ...runtimeRequiresOf(container)];
+}
+function islandInputsOf(descriptor, source, container = getAppContainer()) {
   const inputs = {};
   if (source === void 0) {
     return inputs;
   }
-  for (const token of (_a = descriptor.requires) != null ? _a : []) {
+  for (const token of requiredTokens(descriptor, container)) {
     const value = source[token.description];
     if (value !== void 0) {
       inputs[token.description] = value;
@@ -35,11 +76,10 @@ function islandInputsOf(descriptor, source) {
   return inputs;
 }
 function bindIslandInputs(container, descriptor, inputs) {
-  var _a;
   if (inputs === void 0) {
     return;
   }
-  for (const token of (_a = descriptor.requires) != null ? _a : []) {
+  for (const token of requiredTokens(descriptor, container)) {
     const value = inputs[token.description];
     if (value !== void 0) {
       container.bind(token).toValue(value);
@@ -70,18 +110,6 @@ function bindRequestContext(container, context) {
   }
 }
 
-// src/island/runtime.ts
-import { Container } from "@foxford/ioc";
-var appContainer = null;
-function getAppContainer() {
-  var _a;
-  if (appContainer === null) {
-    appContainer = new Container();
-    ((_a = logger.getLogger("island:runtime")) != null ? _a : logger).debug("app-\u043A\u043E\u043D\u0442\u0435\u0439\u043D\u0435\u0440 \u0441\u043E\u0437\u0434\u0430\u043D");
-  }
-  return appContainer;
-}
-
 // src/island/lifecycle.ts
 import { log } from "@foxford/logger";
 var EMPTY_ROUTE = { params: {}, pathname: "", search: "" };
@@ -282,12 +310,15 @@ function pathPattern(pattern) {
 
 export {
   isDocumentSource,
+  getAppContainer,
+  RuntimeExtensionsToken,
+  installRuntime,
+  runtimeRequiresOf,
   islandInputsOf,
   bindIslandInputs,
   parseCookieHeader,
   browserRequestContext,
   bindRequestContext,
-  getAppContainer,
   createIslandContainer,
   hydrateIslandState,
   activateIslandViewModels,

package/island/index.cjs

@@ -16,7 +16,10 @@
 
 
 
-var _chunkJMRHLOBDcjs = require('../chunk-JMRHLOBD.cjs');
+
+
+
+var _chunkQTWJTYZWcjs = require('../chunk-QTWJTYZW.cjs');
 
 
 
@@ -118,6 +121,31 @@ function describeIsland(descriptor, denState) {
   };
 }
 
+// src/island/remount.ts
+var generation = 0;
+var listeners2 = /* @__PURE__ */ new Set();
+function remountIslands() {
+  generation += 1;
+  for (const listener of listeners2) {
+    listener();
+  }
+}
+function getIslandsGeneration() {
+  return generation;
+}
+function subscribeIslandsGeneration(listener) {
+  listeners2.add(listener);
+  return () => {
+    listeners2.delete(listener);
+  };
+}
+
+
+
+
+
+
+
 
 
 
@@ -152,4 +180,4 @@ function describeIsland(descriptor, denState) {
 
 
 
-exports.DOCUMENT_EVENT = DOCUMENT_EVENT; exports.ISLAND_ERRORS_KEY = ISLAND_ERRORS_KEY; exports.NAVIGATE_EVENT = NAVIGATE_EVENT; exports.RequestContextToken = _chunk6QV4L6R2cjs.RequestContextToken; exports.ViewLayerToken = _chunkXOJ2VWX4cjs.ViewLayerToken; exports.activateIslandViewModels = _chunkJMRHLOBDcjs.activateIslandViewModels; exports.bindIslandInputs = _chunkJMRHLOBDcjs.bindIslandInputs; exports.bindRequestContext = _chunkJMRHLOBDcjs.bindRequestContext; exports.browserRequestContext = _chunkJMRHLOBDcjs.browserRequestContext; exports.collectDocumentContribution = _chunkJMRHLOBDcjs.collectDocumentContribution; exports.collectIslandState = _chunkJMRHLOBDcjs.collectIslandState; exports.createIslandContainer = _chunkJMRHLOBDcjs.createIslandContainer; exports.describeIsland = describeIsland; exports.getAppContainer = _chunkJMRHLOBDcjs.getAppContainer; exports.getIslandsSnapshot = getIslandsSnapshot; exports.hydrateIslandState = _chunkJMRHLOBDcjs.hydrateIslandState; exports.isDocumentSource = _chunkJMRHLOBDcjs.isDocumentSource; exports.islandInputsOf = _chunkJMRHLOBDcjs.islandInputsOf; exports.matchRoute = _chunkJMRHLOBDcjs.matchRoute; exports.navigateIsland = navigateIsland; exports.normalizeRoutes = _chunkJMRHLOBDcjs.normalizeRoutes; exports.onIslandDocument = onIslandDocument; exports.onIslandNavigate = onIslandNavigate; exports.parseCookieHeader = _chunkJMRHLOBDcjs.parseCookieHeader; exports.pathPattern = _chunkJMRHLOBDcjs.pathPattern; exports.publishIslandDocument = publishIslandDocument; exports.registerIsland = registerIsland; exports.renderApp = _chunkJMRHLOBDcjs.renderApp; exports.reportIslandError = reportIslandError; exports.resolveEagerUnits = _chunkJMRHLOBDcjs.resolveEagerUnits; exports.resolveViewAdapter = _chunkXOJ2VWX4cjs.resolveViewAdapter; exports.slotAddress = slotAddress; exports.subscribeIslands = subscribeIslands; exports.viewAdapterOf = _chunkXOJ2VWX4cjs.viewAdapterOf;
+exports.DOCUMENT_EVENT = DOCUMENT_EVENT; exports.ISLAND_ERRORS_KEY = ISLAND_ERRORS_KEY; exports.NAVIGATE_EVENT = NAVIGATE_EVENT; exports.RequestContextToken = _chunk6QV4L6R2cjs.RequestContextToken; exports.RuntimeExtensionsToken = _chunkQTWJTYZWcjs.RuntimeExtensionsToken; exports.ViewLayerToken = _chunkXOJ2VWX4cjs.ViewLayerToken; exports.activateIslandViewModels = _chunkQTWJTYZWcjs.activateIslandViewModels; exports.bindIslandInputs = _chunkQTWJTYZWcjs.bindIslandInputs; exports.bindRequestContext = _chunkQTWJTYZWcjs.bindRequestContext; exports.browserRequestContext = _chunkQTWJTYZWcjs.browserRequestContext; exports.collectDocumentContribution = _chunkQTWJTYZWcjs.collectDocumentContribution; exports.collectIslandState = _chunkQTWJTYZWcjs.collectIslandState; exports.createIslandContainer = _chunkQTWJTYZWcjs.createIslandContainer; exports.describeIsland = describeIsland; exports.getAppContainer = _chunkQTWJTYZWcjs.getAppContainer; exports.getIslandsGeneration = getIslandsGeneration; exports.getIslandsSnapshot = getIslandsSnapshot; exports.hydrateIslandState = _chunkQTWJTYZWcjs.hydrateIslandState; exports.installRuntime = _chunkQTWJTYZWcjs.installRuntime; exports.isDocumentSource = _chunkQTWJTYZWcjs.isDocumentSource; exports.islandInputsOf = _chunkQTWJTYZWcjs.islandInputsOf; exports.matchRoute = _chunkQTWJTYZWcjs.matchRoute; exports.navigateIsland = navigateIsland; exports.normalizeRoutes = _chunkQTWJTYZWcjs.normalizeRoutes; exports.onIslandDocument = onIslandDocument; exports.onIslandNavigate = onIslandNavigate; exports.parseCookieHeader = _chunkQTWJTYZWcjs.parseCookieHeader; exports.pathPattern = _chunkQTWJTYZWcjs.pathPattern; exports.publishIslandDocument = publishIslandDocument; exports.registerIsland = registerIsland; exports.remountIslands = remountIslands; exports.renderApp = _chunkQTWJTYZWcjs.renderApp; exports.reportIslandError = reportIslandError; exports.resolveEagerUnits = _chunkQTWJTYZWcjs.resolveEagerUnits; exports.resolveViewAdapter = _chunkXOJ2VWX4cjs.resolveViewAdapter; exports.runtimeRequiresOf = _chunkQTWJTYZWcjs.runtimeRequiresOf; exports.slotAddress = slotAddress; exports.subscribeIslands = subscribeIslands; exports.subscribeIslandsGeneration = subscribeIslandsGeneration; exports.viewAdapterOf = _chunkXOJ2VWX4cjs.viewAdapterOf;

package/island/index.d.cts

@@ -1,7 +1,7 @@
 import { A as AppAssets, I as IslandDescriptor } from '../descriptor-C2j6Zz6c.cjs';
-import { R as RequestContext } from '../types-BxMQ-VOd.cjs';
+import { R as RequestContext, c as Definition } from '../types-BxMQ-VOd.cjs';
 export { i as RequestContextToken } from '../types-BxMQ-VOd.cjs';
-import { Container } from '@foxford/ioc';
+import { Container, Token } from '@foxford/ioc';
 export { A as AppRoute, R as RouteDeclaration, a as RouteMatch, m as matchRoute, n as normalizeRoutes, p as pathPattern } from '../routes-BvV405k4.cjs';
 export { R as RenderTree, a as ServerRender, S as ServerRenderResult } from '../server-render-CocWXQKC.cjs';
 export { R as RenderIslandOptions, V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken, r as resolveViewAdapter, v as viewAdapterOf } from '../view-adapter-DMLlp3Iu.cjs';
@@ -254,13 +254,14 @@ declare function publishIslandDocument(node: EventTarget, contribution: Document
 declare function onIslandDocument(node: EventTarget, onDocument: (contribution: DocumentContribution) => void): () => void;
 
 /**
- * Входные данные, объявленные дескриптором, из переданного набора.
+ * Входные данные, объявленные дескриптором и расширениями рантайма, из переданного набора.
  *
  * @param descriptor - Дескриптор острова
  * @param source - Набор по ключу `token.description`: тело запроса либо состояние документа
+ * @param container - Контейнер с расширениями; по умолчанию контейнер приложения
  * @returns Только объявленные и присутствующие ключи
  */
-declare function islandInputsOf(descriptor: IslandDescriptor, source: Record<string, unknown> | undefined): Record<string, unknown>;
+declare function islandInputsOf(descriptor: IslandDescriptor, source: Record<string, unknown> | undefined, container?: Container): Record<string, unknown>;
 /**
  * Биндит входные данные в контейнер острова под объявленными токенами.
  *
@@ -392,8 +393,52 @@ declare function subscribeIslands(listener: () => void): () => void;
  */
 declare function describeIsland(descriptor: IslandDescriptor, denState?: Record<string, unknown>): Omit<IslandRecord, 'id'>;
 
+/** Пересобрать все острова вкладки: следующее поколение, подписчики перемонтируют. */
+declare function remountIslands(): void;
+/** Текущее поколение островов — ключ монтирования у адаптера. */
+declare function getIslandsGeneration(): number;
+/** Подписка на смену поколения (совместима с `useSyncExternalStore`). */
+declare function subscribeIslandsGeneration(listener: () => void): () => void;
+
 /** App-scope контейнер федерации (создаётся при первом обращении). */
 declare function getAppContainer(): Container;
+/**
+ * Расширение рантайма: то, что приложение получает от платформы, а не пишет само, — клиенты
+ * бэкенда, метки, всё, что закрывает заявку дескриптора живым кодом одинаково у любого
+ * приложения.
+ *
+ * Ставится один раз на процесс и на вкладку, в контейнер уровня приложения: единицы
+ * расширения резолвятся из любого острова по parent-chain, а фабрика исполняется с
+ * контейнером острова, поэтому экземпляр получается свой на остров и на запрос. Заявка
+ * расширения (`requires`) добавляется к заявке каждого острова: данные, которые нужны
+ * расширению, хост отдаёт, хотя приложение их не называет.
+ */
+interface RuntimeExtension {
+    /** Имя — для логов и панели. */
+    name: string;
+    /** Что расширение просит у хоста данными. */
+    requires?: ReadonlyArray<Token<unknown>>;
+    /** Что расширение отдаёт: единицы в контейнер уровня приложения. */
+    units: ReadonlyArray<Definition<unknown>>;
+}
+/** Установленные расширения — по ним остров дополняет свою заявку. */
+declare const RuntimeExtensionsToken: Token<readonly RuntimeExtension[]>;
+/**
+ * Ставит расширения рантайма в контейнер уровня приложения.
+ *
+ * Повторный вызов дополняет список, а не заменяет: хост и сетевой процесс ставят свои
+ * расширения независимо, и порядок установки им знать незачем.
+ *
+ * @param container - Контейнер уровня приложения (`getAppContainer()`)
+ * @param extensions - Расширения
+ */
+declare function installRuntime(container: Container, extensions: ReadonlyArray<RuntimeExtension>): void;
+/**
+ * Заявка установленных расширений — токены, которые хост закрывает данными.
+ *
+ * @param container - Любой контейнер цепочки: остров, запрос либо сам контейнер приложения
+ */
+declare function runtimeRequiresOf(container: Container): ReadonlyArray<Token<unknown>>;
 
 /**
  * Глобальный адрес слота — `market-app:aside`.
@@ -412,4 +457,4 @@ declare function getAppContainer(): Container;
  */
 declare function slotAddress(app: string, slot: string): string;
 
-export { AppAssets, type CreateIslandContainerOptions, DOCUMENT_EVENT, type DocumentContribution, type DocumentHead, type DocumentSource, ISLAND_ERRORS_KEY, IslandDescriptor, type IslandErrorContext, type IslandErrorPhase, type IslandErrorReport, type IslandRecord, type IslandRoute, NAVIGATE_EVENT, type RenderAppRequest, type RenderAppResult, RequestContext, activateIslandViewModels, bindIslandInputs, bindRequestContext, browserRequestContext, collectDocumentContribution, collectIslandState, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, isDocumentSource, islandInputsOf, navigateIsland, onIslandDocument, onIslandNavigate, parseCookieHeader, publishIslandDocument, registerIsland, renderApp, reportIslandError, resolveEagerUnits, slotAddress, subscribeIslands };
+export { AppAssets, type CreateIslandContainerOptions, DOCUMENT_EVENT, type DocumentContribution, type DocumentHead, type DocumentSource, ISLAND_ERRORS_KEY, IslandDescriptor, type IslandErrorContext, type IslandErrorPhase, type IslandErrorReport, type IslandRecord, type IslandRoute, NAVIGATE_EVENT, type RenderAppRequest, type RenderAppResult, RequestContext, type RuntimeExtension, RuntimeExtensionsToken, activateIslandViewModels, bindIslandInputs, bindRequestContext, browserRequestContext, collectDocumentContribution, collectIslandState, createIslandContainer, describeIsland, getAppContainer, getIslandsGeneration, getIslandsSnapshot, hydrateIslandState, installRuntime, isDocumentSource, islandInputsOf, navigateIsland, onIslandDocument, onIslandNavigate, parseCookieHeader, publishIslandDocument, registerIsland, remountIslands, renderApp, reportIslandError, resolveEagerUnits, runtimeRequiresOf, slotAddress, subscribeIslands, subscribeIslandsGeneration };

package/island/index.d.ts

@@ -1,7 +1,7 @@
 import { A as AppAssets, I as IslandDescriptor } from '../descriptor-BSaHM5B4.js';
-import { R as RequestContext } from '../types-BxMQ-VOd.js';
+import { R as RequestContext, c as Definition } from '../types-BxMQ-VOd.js';
 export { i as RequestContextToken } from '../types-BxMQ-VOd.js';
-import { Container } from '@foxford/ioc';
+import { Container, Token } from '@foxford/ioc';
 export { A as AppRoute, R as RouteDeclaration, a as RouteMatch, m as matchRoute, n as normalizeRoutes, p as pathPattern } from '../routes-Di3K_0uQ.js';
 export { R as RenderTree, a as ServerRender, S as ServerRenderResult } from '../server-render-CocWXQKC.js';
 export { R as RenderIslandOptions, V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken, r as resolveViewAdapter, v as viewAdapterOf } from '../view-adapter-DNLRSFka.js';
@@ -254,13 +254,14 @@ declare function publishIslandDocument(node: EventTarget, contribution: Document
 declare function onIslandDocument(node: EventTarget, onDocument: (contribution: DocumentContribution) => void): () => void;
 
 /**
- * Входные данные, объявленные дескриптором, из переданного набора.
+ * Входные данные, объявленные дескриптором и расширениями рантайма, из переданного набора.
  *
  * @param descriptor - Дескриптор острова
  * @param source - Набор по ключу `token.description`: тело запроса либо состояние документа
+ * @param container - Контейнер с расширениями; по умолчанию контейнер приложения
  * @returns Только объявленные и присутствующие ключи
  */
-declare function islandInputsOf(descriptor: IslandDescriptor, source: Record<string, unknown> | undefined): Record<string, unknown>;
+declare function islandInputsOf(descriptor: IslandDescriptor, source: Record<string, unknown> | undefined, container?: Container): Record<string, unknown>;
 /**
  * Биндит входные данные в контейнер острова под объявленными токенами.
  *
@@ -392,8 +393,52 @@ declare function subscribeIslands(listener: () => void): () => void;
  */
 declare function describeIsland(descriptor: IslandDescriptor, denState?: Record<string, unknown>): Omit<IslandRecord, 'id'>;
 
+/** Пересобрать все острова вкладки: следующее поколение, подписчики перемонтируют. */
+declare function remountIslands(): void;
+/** Текущее поколение островов — ключ монтирования у адаптера. */
+declare function getIslandsGeneration(): number;
+/** Подписка на смену поколения (совместима с `useSyncExternalStore`). */
+declare function subscribeIslandsGeneration(listener: () => void): () => void;
+
 /** App-scope контейнер федерации (создаётся при первом обращении). */
 declare function getAppContainer(): Container;
+/**
+ * Расширение рантайма: то, что приложение получает от платформы, а не пишет само, — клиенты
+ * бэкенда, метки, всё, что закрывает заявку дескриптора живым кодом одинаково у любого
+ * приложения.
+ *
+ * Ставится один раз на процесс и на вкладку, в контейнер уровня приложения: единицы
+ * расширения резолвятся из любого острова по parent-chain, а фабрика исполняется с
+ * контейнером острова, поэтому экземпляр получается свой на остров и на запрос. Заявка
+ * расширения (`requires`) добавляется к заявке каждого острова: данные, которые нужны
+ * расширению, хост отдаёт, хотя приложение их не называет.
+ */
+interface RuntimeExtension {
+    /** Имя — для логов и панели. */
+    name: string;
+    /** Что расширение просит у хоста данными. */
+    requires?: ReadonlyArray<Token<unknown>>;
+    /** Что расширение отдаёт: единицы в контейнер уровня приложения. */
+    units: ReadonlyArray<Definition<unknown>>;
+}
+/** Установленные расширения — по ним остров дополняет свою заявку. */
+declare const RuntimeExtensionsToken: Token<readonly RuntimeExtension[]>;
+/**
+ * Ставит расширения рантайма в контейнер уровня приложения.
+ *
+ * Повторный вызов дополняет список, а не заменяет: хост и сетевой процесс ставят свои
+ * расширения независимо, и порядок установки им знать незачем.
+ *
+ * @param container - Контейнер уровня приложения (`getAppContainer()`)
+ * @param extensions - Расширения
+ */
+declare function installRuntime(container: Container, extensions: ReadonlyArray<RuntimeExtension>): void;
+/**
+ * Заявка установленных расширений — токены, которые хост закрывает данными.
+ *
+ * @param container - Любой контейнер цепочки: остров, запрос либо сам контейнер приложения
+ */
+declare function runtimeRequiresOf(container: Container): ReadonlyArray<Token<unknown>>;
 
 /**
  * Глобальный адрес слота — `market-app:aside`.
@@ -412,4 +457,4 @@ declare function getAppContainer(): Container;
  */
 declare function slotAddress(app: string, slot: string): string;
 
-export { AppAssets, type CreateIslandContainerOptions, DOCUMENT_EVENT, type DocumentContribution, type DocumentHead, type DocumentSource, ISLAND_ERRORS_KEY, IslandDescriptor, type IslandErrorContext, type IslandErrorPhase, type IslandErrorReport, type IslandRecord, type IslandRoute, NAVIGATE_EVENT, type RenderAppRequest, type RenderAppResult, RequestContext, activateIslandViewModels, bindIslandInputs, bindRequestContext, browserRequestContext, collectDocumentContribution, collectIslandState, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, isDocumentSource, islandInputsOf, navigateIsland, onIslandDocument, onIslandNavigate, parseCookieHeader, publishIslandDocument, registerIsland, renderApp, reportIslandError, resolveEagerUnits, slotAddress, subscribeIslands };
+export { AppAssets, type CreateIslandContainerOptions, DOCUMENT_EVENT, type DocumentContribution, type DocumentHead, type DocumentSource, ISLAND_ERRORS_KEY, IslandDescriptor, type IslandErrorContext, type IslandErrorPhase, type IslandErrorReport, type IslandRecord, type IslandRoute, NAVIGATE_EVENT, type RenderAppRequest, type RenderAppResult, RequestContext, type RuntimeExtension, RuntimeExtensionsToken, activateIslandViewModels, bindIslandInputs, bindRequestContext, browserRequestContext, collectDocumentContribution, collectIslandState, createIslandContainer, describeIsland, getAppContainer, getIslandsGeneration, getIslandsSnapshot, hydrateIslandState, installRuntime, isDocumentSource, islandInputsOf, navigateIsland, onIslandDocument, onIslandNavigate, parseCookieHeader, publishIslandDocument, registerIsland, remountIslands, renderApp, reportIslandError, resolveEagerUnits, runtimeRequiresOf, slotAddress, subscribeIslands, subscribeIslandsGeneration };

package/island/index.js

@@ -1,4 +1,5 @@
 import {
+  RuntimeExtensionsToken,
   activateIslandViewModels,
   bindIslandInputs,
   bindRequestContext,
@@ -8,6 +9,7 @@ import {
   createIslandContainer,
   getAppContainer,
   hydrateIslandState,
+  installRuntime,
   isDocumentSource,
   islandInputsOf,
   matchRoute,
@@ -15,8 +17,9 @@ import {
   parseCookieHeader,
   pathPattern,
   renderApp,
-  resolveEagerUnits
-} from "../chunk-VO3ORM7Z.js";
+  resolveEagerUnits,
+  runtimeRequiresOf
+} from "../chunk-XQ7EHXHG.js";
 import {
   ViewLayerToken,
   resolveViewAdapter,
@@ -117,11 +120,31 @@ function describeIsland(descriptor, denState) {
     viewModels: ((_b = descriptor.viewModels) != null ? _b : []).map((vm) => vm.token.description)
   };
 }
+
+// src/island/remount.ts
+var generation = 0;
+var listeners2 = /* @__PURE__ */ new Set();
+function remountIslands() {
+  generation += 1;
+  for (const listener of listeners2) {
+    listener();
+  }
+}
+function getIslandsGeneration() {
+  return generation;
+}
+function subscribeIslandsGeneration(listener) {
+  listeners2.add(listener);
+  return () => {
+    listeners2.delete(listener);
+  };
+}
 export {
   DOCUMENT_EVENT,
   ISLAND_ERRORS_KEY,
   NAVIGATE_EVENT,
   RequestContextToken,
+  RuntimeExtensionsToken,
   ViewLayerToken,
   activateIslandViewModels,
   bindIslandInputs,
@@ -132,8 +155,10 @@ export {
   createIslandContainer,
   describeIsland,
   getAppContainer,
+  getIslandsGeneration,
   getIslandsSnapshot,
   hydrateIslandState,
+  installRuntime,
   isDocumentSource,
   islandInputsOf,
   matchRoute,
@@ -145,11 +170,14 @@ export {
   pathPattern,
   publishIslandDocument,
   registerIsland,
+  remountIslands,
   renderApp,
   reportIslandError,
   resolveEagerUnits,
   resolveViewAdapter,
+  runtimeRequiresOf,
   slotAddress,
   subscribeIslands,
+  subscribeIslandsGeneration,
   viewAdapterOf
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxford/den",
-  "version": "3.5.0",
+  "version": "3.7.0",
   "description": "Den — декларативный метафреймворк Foxford (core runtime)",
   "keywords": [
     "foxford",
@@ -89,24 +89,24 @@
     "adapter.js",
     "bin",
     "builder",
+    "chunk-2GTQK2PZ.js",
     "chunk-3RX2OSUL.js",
-    "chunk-4XR6EUOW.js",
     "chunk-6FNC3XMI.js",
     "chunk-6QV4L6R2.cjs",
     "chunk-A6ZPAM6Z.cjs",
     "chunk-C7BM4DGX.cjs",
     "chunk-E23E2VUC.js",
     "chunk-E56BKBQZ.js",
-    "chunk-G6RT4EBO.cjs",
     "chunk-H5DKRHHQ.cjs",
-    "chunk-JMRHLOBD.cjs",
     "chunk-KQAB6C6Q.cjs",
+    "chunk-P4J4M2WZ.cjs",
+    "chunk-QTWJTYZW.cjs",
     "chunk-RG7ZV5BD.js",
     "chunk-T5QVCXVB.cjs",
     "chunk-TPBI6TOU.js",
-    "chunk-VO3ORM7Z.js",
     "chunk-WBHHHICS.js",
     "chunk-XOJ2VWX4.cjs",
+    "chunk-XQ7EHXHG.js",
     "define-repository-AO7JI6Cb.d.ts",
     "define-repository-C0MI-J32.d.cts",
     "define-slot-BEeHNEph.d.cts",
@@ -134,6 +134,6 @@
     "view-adapter-DMLlp3Iu.d.cts",
     "view-adapter-DNLRSFka.d.ts"
   ],
-  "sha": "a0e9213",
+  "sha": "c642307",
   "scripts": {}
 }

package/serve/index.cjs

@@ -6,7 +6,7 @@ var _chunkKQAB6C6Qcjs = require('../chunk-KQAB6C6Q.cjs');
 
 
 
-var _chunkJMRHLOBDcjs = require('../chunk-JMRHLOBD.cjs');
+var _chunkQTWJTYZWcjs = require('../chunk-QTWJTYZW.cjs');
 require('../chunk-XOJ2VWX4.cjs');
 require('../chunk-6QV4L6R2.cjs');
 
@@ -70,14 +70,14 @@ function registerAssets(instance, source) {
 
 var DEFAULT_SLOW_RENDER_MS = 1e3;
 function claim(app) {
-  return _chunkJMRHLOBDcjs.normalizeRoutes.call(void 0, app.routes).map((route) => route.source);
+  return _chunkQTWJTYZWcjs.normalizeRoutes.call(void 0, app.routes).map((route) => route.source);
 }
 function matchClaim(app, pathname) {
   var _a, _b;
   if (claim(app).length === 0) {
     return {};
   }
-  return (_b = (_a = _chunkJMRHLOBDcjs.matchRoute.call(void 0, app.routes, pathname)) == null ? void 0 : _a.params) != null ? _b : null;
+  return (_b = (_a = _chunkQTWJTYZWcjs.matchRoute.call(void 0, app.routes, pathname)) == null ? void 0 : _a.params) != null ? _b : null;
 }
 function browserContext(req) {
   const headers = {};
@@ -94,7 +94,7 @@ function browserContext(req) {
   if (typeof cookie === "string" && cookie !== "") {
     headers.cookie = cookie;
   }
-  return { cookies: _chunkJMRHLOBDcjs.parseCookieHeader.call(void 0, cookie), headers };
+  return { cookies: _chunkQTWJTYZWcjs.parseCookieHeader.call(void 0, cookie), headers };
 }
 var appPlugin = (instance, options) => {
   var _a, _b;
@@ -122,7 +122,7 @@ var appPlugin = (instance, options) => {
       }
       const startedAt = Date.now();
       try {
-        const result = yield _chunkJMRHLOBDcjs.renderApp.call(void 0, app, {
+        const result = yield _chunkQTWJTYZWcjs.renderApp.call(void 0, app, {
           context: browserContext(req),
           inputs,
           params,

package/serve/index.js

@@ -6,7 +6,7 @@ import {
   normalizeRoutes,
   parseCookieHeader,
   renderApp
-} from "../chunk-VO3ORM7Z.js";
+} from "../chunk-XQ7EHXHG.js";
 import "../chunk-E23E2VUC.js";
 import "../chunk-3RX2OSUL.js";
 import {