@foxford/den 2.1.0 → 3.1.0

package/index.cjs

@@ -4,20 +4,21 @@
 
 
 
+var _chunkP4QJCHMMcjs = require('./chunk-P4QJCHMM.cjs');
+require('./chunk-C7BM4DGX.cjs');
 
 
+var _chunkXOJ2VWX4cjs = require('./chunk-XOJ2VWX4.cjs');
+
 
 
 
 
 
 
-var _chunk5DJZZML5cjs = require('./chunk-5DJZZML5.cjs');
-require('./chunk-C7BM4DGX.cjs');
 
 
-var _chunkLJE7K7VDcjs = require('./chunk-LJE7K7VD.cjs');
-require('./chunk-A6ZPAM6Z.cjs');
+var _chunkCZVYVNLIcjs = require('./chunk-CZVYVNLI.cjs');
 
 
 var _chunkXHYR3SGGcjs = require('./chunk-XHYR3SGG.cjs');
@@ -83,7 +84,7 @@ var ContainerManagerImpl = class {
       return existing;
     }
     const child = this.appContainer.createChild();
-    child.bind(_chunk5DJZZML5cjs.StateRegistryToken).toValue(new StateRegistry());
+    child.bind(_chunkCZVYVNLIcjs.StateRegistryToken).toValue(new StateRegistry());
     this.pageContainers.set(routeId, child);
     return child;
   }
@@ -114,8 +115,8 @@ var ContainerManagerImpl = class {
       return existing;
     }
     const child = this.appContainer.createChild();
-    child.bind(_chunk5DJZZML5cjs.RequestContextToken).toValue(context);
-    child.bind(_chunk5DJZZML5cjs.StateRegistryToken).toValue(new StateRegistry());
+    child.bind(_chunkCZVYVNLIcjs.RequestContextToken).toValue(context);
+    child.bind(_chunkCZVYVNLIcjs.StateRegistryToken).toValue(new StateRegistry());
     this.requestContainers.set(requestId, child);
     return child;
   }
@@ -154,7 +155,7 @@ var ContainerManagerImpl = class {
       return existing;
     }
     const child = parent.createChild();
-    child.bind(_chunk5DJZZML5cjs.StateRegistryToken).toValue(new StateRegistry());
+    child.bind(_chunkCZVYVNLIcjs.StateRegistryToken).toValue(new StateRegistry());
     this.ssrPageContainers.set(requestId, child);
     return child;
   }
@@ -414,10 +415,10 @@ var StateSerializerImpl = class {
    */
   // eslint-disable-next-line @typescript-eslint/class-methods-use-this
   getRegistry(container) {
-    if (!container.has(_chunk5DJZZML5cjs.StateRegistryToken)) {
+    if (!container.has(_chunkCZVYVNLIcjs.StateRegistryToken)) {
       return void 0;
     }
-    const resolved = container.resolve(_chunk5DJZZML5cjs.StateRegistryToken);
+    const resolved = container.resolve(_chunkCZVYVNLIcjs.StateRegistryToken);
     return resolved instanceof Promise ? void 0 : resolved;
   }
   /**
@@ -531,10 +532,10 @@ function createCore(options = {}) {
   const navigationManager = new NavigationManagerImpl();
   const stateSerializer = new StateSerializerImpl();
   const stateCache = new StateCache();
-  container.bind(_chunk5DJZZML5cjs.ContainerManagerToken).toValue(containerManager);
-  container.bind(_chunk5DJZZML5cjs.GuardRunnerToken).toValue(guardRunner);
-  container.bind(_chunk5DJZZML5cjs.NavigationManagerToken).toValue(navigationManager);
-  container.bind(_chunk5DJZZML5cjs.StateSerializerToken).toValue(stateSerializer);
+  container.bind(_chunkCZVYVNLIcjs.ContainerManagerToken).toValue(containerManager);
+  container.bind(_chunkCZVYVNLIcjs.GuardRunnerToken).toValue(guardRunner);
+  container.bind(_chunkCZVYVNLIcjs.NavigationManagerToken).toValue(navigationManager);
+  container.bind(_chunkCZVYVNLIcjs.StateSerializerToken).toValue(stateSerializer);
   return {
     container,
     containerManager,
@@ -717,4 +718,4 @@ function defineLayer(token, options) {
 
 
 
-exports.ActivatableToken = _chunk5DJZZML5cjs.ActivatableToken; exports.ContainerManagerImpl = ContainerManagerImpl; exports.ContainerManagerToken = _chunk5DJZZML5cjs.ContainerManagerToken; exports.GuardRunnerImpl = GuardRunnerImpl; exports.GuardRunnerToken = _chunk5DJZZML5cjs.GuardRunnerToken; exports.NavigationManagerImpl = NavigationManagerImpl; exports.NavigationManagerToken = _chunk5DJZZML5cjs.NavigationManagerToken; exports.RequestContextToken = _chunk5DJZZML5cjs.RequestContextToken; exports.SlotRegistry = _chunk5DJZZML5cjs.SlotRegistry; exports.SlotRegistryToken = _chunk5DJZZML5cjs.SlotRegistryToken; exports.StateCache = StateCache; exports.StateRegistry = StateRegistry; exports.StateRegistryToken = _chunk5DJZZML5cjs.StateRegistryToken; exports.StateSerializerImpl = StateSerializerImpl; exports.StateSerializerToken = _chunk5DJZZML5cjs.StateSerializerToken; exports.ViewLayerToken = _chunkLJE7K7VDcjs.ViewLayerToken; exports.createCore = createCore; exports.defaultGlobalResolver = defaultGlobalResolver; exports.defineActionGuard = defineActionGuard; exports.defineExtension = defineExtension; exports.defineGuard = defineGuard; exports.defineLayer = defineLayer; exports.defineLayout = defineLayout; exports.defineRepository = _chunk5DJZZML5cjs.defineRepository; exports.defineService = _chunk5DJZZML5cjs.defineService; exports.defineSlot = _chunk5DJZZML5cjs.defineSlot; exports.defineViewModel = _chunk5DJZZML5cjs.defineViewModel;
+exports.ActivatableToken = _chunkCZVYVNLIcjs.ActivatableToken; exports.ContainerManagerImpl = ContainerManagerImpl; exports.ContainerManagerToken = _chunkCZVYVNLIcjs.ContainerManagerToken; exports.GuardRunnerImpl = GuardRunnerImpl; exports.GuardRunnerToken = _chunkCZVYVNLIcjs.GuardRunnerToken; exports.NavigationManagerImpl = NavigationManagerImpl; exports.NavigationManagerToken = _chunkCZVYVNLIcjs.NavigationManagerToken; exports.RequestContextToken = _chunkCZVYVNLIcjs.RequestContextToken; exports.SlotRegistry = _chunkP4QJCHMMcjs.SlotRegistry; exports.SlotRegistryToken = _chunkCZVYVNLIcjs.SlotRegistryToken; exports.StateCache = StateCache; exports.StateRegistry = StateRegistry; exports.StateRegistryToken = _chunkCZVYVNLIcjs.StateRegistryToken; exports.StateSerializerImpl = StateSerializerImpl; exports.StateSerializerToken = _chunkCZVYVNLIcjs.StateSerializerToken; exports.ViewLayerToken = _chunkXOJ2VWX4cjs.ViewLayerToken; exports.createCore = createCore; exports.defaultGlobalResolver = defaultGlobalResolver; exports.defineActionGuard = defineActionGuard; exports.defineExtension = defineExtension; exports.defineGuard = defineGuard; exports.defineLayer = defineLayer; exports.defineLayout = defineLayout; exports.defineRepository = _chunkP4QJCHMMcjs.defineRepository; exports.defineService = _chunkP4QJCHMMcjs.defineService; exports.defineSlot = _chunkP4QJCHMMcjs.defineSlot; exports.defineViewModel = _chunkP4QJCHMMcjs.defineViewModel;

package/index.d.cts

@@ -4,7 +4,8 @@ import { Container, Token } from '@foxford/ioc';
 import { DefinitionResolver } from './adapter.cjs';
 export { d as defineRepository, a as defineService, b as defineViewModel } from './define-repository-MDEWHqM7.cjs';
 export { D as DefineSlotOptions, S as SlotDefinition, d as defineSlot } from './define-slot-BKvArA02.cjs';
-export { V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken } from './view-adapter-zbHBVVqR.cjs';
+export { V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken } from './view-adapter-D2597RJZ.cjs';
+import './descriptor-h0JE9jFx.cjs';
 
 /**
  * Опции для создания Core Runtime.

package/index.d.ts

@@ -4,7 +4,8 @@ import { Container, Token } from '@foxford/ioc';
 import { DefinitionResolver } from './adapter.js';
 export { d as defineRepository, a as defineService, b as defineViewModel } from './define-repository-Ca62_YCy.js';
 export { D as DefineSlotOptions, S as SlotDefinition, d as defineSlot } from './define-slot-Dil8Kr1A.js';
-export { V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken } from './view-adapter-CSPKr2xy.js';
+export { V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken } from './view-adapter-CPI8056c.js';
+import './descriptor-DZDNH7R5.js';
 
 /**
  * Опции для создания Core Runtime.

package/index.js

@@ -1,23 +1,24 @@
 import {
-  ActivatableToken,
-  ContainerManagerToken,
-  GuardRunnerToken,
-  NavigationManagerToken,
-  RequestContextToken,
   SlotRegistry,
-  SlotRegistryToken,
-  StateRegistryToken,
-  StateSerializerToken,
   defineRepository,
   defineService,
   defineSlot,
   defineViewModel
-} from "./chunk-WRQC6BVJ.js";
+} from "./chunk-PZVUKTZG.js";
 import "./chunk-WBHHHICS.js";
 import {
   ViewLayerToken
-} from "./chunk-TCYGDT2A.js";
-import "./chunk-TPBI6TOU.js";
+} from "./chunk-E23E2VUC.js";
+import {
+  ActivatableToken,
+  ContainerManagerToken,
+  GuardRunnerToken,
+  NavigationManagerToken,
+  RequestContextToken,
+  SlotRegistryToken,
+  StateRegistryToken,
+  StateSerializerToken
+} from "./chunk-KJ6NDOOL.js";
 import {
   __async
 } from "./chunk-HJO26HIQ.js";

package/island/index.cjs

@@ -2,92 +2,25 @@
 
 
 
-var _chunkLJE7K7VDcjs = require('../chunk-LJE7K7VD.cjs');
 
 
 
 
-var _chunkA6ZPAM6Zcjs = require('../chunk-A6ZPAM6Z.cjs');
 
 
-var _chunkXHYR3SGGcjs = require('../chunk-XHYR3SGG.cjs');
 
-// src/island/lifecycle.ts
-var _logger = require('@foxford/logger');
-
-// 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
-function createIslandContainer(descriptor, options = {}) {
-  var _a, _b, _c, _d, _e;
-  const { parent = getAppContainer() } = options;
-  const appLog = (_b = _logger.log.getLogger((_a = descriptor.name) != null ? _a : "app")) != null ? _b : _chunkA6ZPAM6Zcjs.logger;
-  const islandLog = (_c = appLog.getLogger("client")) != null ? _c : appLog;
-  try {
-    const container = parent.createChild();
-    container.bind(_chunkA6ZPAM6Zcjs.LoggerToken).toValue(islandLog);
-    descriptor.viewLayer.register(container);
-    const viewModels = (_d = descriptor.viewModels) != null ? _d : [];
-    const slots = Object.entries((_e = descriptor.slots) != null ? _e : {});
-    islandLog.info(
-      `\u043E\u0441\u0442\u0440\u043E\u0432: \u043A\u043E\u043D\u0442\u0435\u0439\u043D\u0435\u0440 \u0441\u043E\u0437\u0434\u0430\u043D (units=${descriptor.units.length}, vms=${viewModels.length}, slots=${slots.length})`
-    );
-    for (const unit of descriptor.units) {
-      unit.register(container);
-    }
-    for (const vm of viewModels) {
-      vm.register(container);
-    }
-    for (const [name, slot] of slots) {
-      slot.register(container, name);
-    }
-    return container;
-  } catch (error) {
-    islandLog.error("\u043E\u0441\u0442\u0440\u043E\u0432: \u0441\u0431\u043E\u0440\u043A\u0430 \u043A\u043E\u043D\u0442\u0435\u0439\u043D\u0435\u0440\u0430 \u0443\u043F\u0430\u043B\u0430", error);
-    return null;
-  }
-}
-function hydrateIslandState(container, descriptor, denState) {
-  var _a, _b;
-  for (const vm of (_a = descriptor.viewModels) != null ? _a : []) {
-    const instance = container.resolve(vm.token);
-    const saved = denState[vm.token.description];
-    if (saved !== void 0 && typeof ((_b = instance.state) == null ? void 0 : _b.set) === "function") {
-      _chunkA6ZPAM6Zcjs.unitLogger.call(void 0, container, vm.token.description).debug("\u0433\u0438\u0434\u0440\u0430\u0446\u0438\u044F VM \u0438\u0437 denState");
-      instance.state.set(saved);
-    }
-  }
-}
-function activateIslandViewModels(container, descriptor) {
-  var _a, _b;
-  for (const vm of (_a = descriptor.viewModels) != null ? _a : []) {
-    const instance = container.resolve(vm.token);
-    _chunkA6ZPAM6Zcjs.unitLogger.call(void 0, container, vm.token.description).debug("\u0430\u043A\u0442\u0438\u0432\u0430\u0446\u0438\u044F VM (\u0431\u0435\u0437 \u0441\u0435\u0440\u0432\u0435\u0440\u043D\u043E\u0433\u043E denState)");
-    void ((_b = instance.activate) == null ? void 0 : _b.call(instance));
-  }
-}
-function resolveEagerUnits(container, descriptor) {
-  var _a;
-  for (const token of (_a = descriptor.eager) != null ? _a : []) {
-    const instance = container.resolve(token);
-    _chunkA6ZPAM6Zcjs.unitLogger.call(void 0, container, token.description).debug("eager: \u0435\u0434\u0438\u043D\u0438\u0446\u0430 \u043F\u043E\u0434\u043D\u044F\u0442\u0430 \u043F\u0440\u0438 \u043C\u043E\u043D\u0442\u0438\u0440\u043E\u0432\u0430\u043D\u0438\u0438");
-    if (instance instanceof Promise) {
-      instance.catch(
-        (error) => _chunkA6ZPAM6Zcjs.unitLogger.call(void 0, container, token.description).error("eager: \u0435\u0434\u0438\u043D\u0438\u0446\u0430 \u043D\u0435 \u043F\u043E\u0434\u043D\u044F\u043B\u0430\u0441\u044C", error)
-      );
-    }
-  }
-}
+
+var _chunk6ZFVV3AVcjs = require('../chunk-6ZFVV3AV.cjs');
+
+
+
+
+var _chunkXOJ2VWX4cjs = require('../chunk-XOJ2VWX4.cjs');
+require('../chunk-CZVYVNLI.cjs');
+
+
+var _chunkXHYR3SGGcjs = require('../chunk-XHYR3SGG.cjs');
 
 // src/island/slot-address.ts
 function slotAddress(app, slot) {
@@ -134,10 +67,6 @@ function describeIsland(descriptor, denState) {
   };
 }
 
-// src/island/routes.ts
-function normalizeRoutes(routes = []) {
-  return routes.map((route) => typeof route === "string" ? { source: route } : route);
-}
 
 
 
@@ -153,4 +82,9 @@ function normalizeRoutes(routes = []) {
 
 
 
-exports.ViewLayerToken = _chunkLJE7K7VDcjs.ViewLayerToken; exports.activateIslandViewModels = activateIslandViewModels; exports.createIslandContainer = createIslandContainer; exports.describeIsland = describeIsland; exports.getAppContainer = getAppContainer; exports.getIslandsSnapshot = getIslandsSnapshot; exports.hydrateIslandState = hydrateIslandState; exports.normalizeRoutes = normalizeRoutes; exports.registerIsland = registerIsland; exports.resolveEagerUnits = resolveEagerUnits; exports.resolveViewAdapter = _chunkLJE7K7VDcjs.resolveViewAdapter; exports.slotAddress = slotAddress; exports.subscribeIslands = subscribeIslands; exports.viewAdapterOf = _chunkLJE7K7VDcjs.viewAdapterOf;
+
+
+
+
+
+exports.ViewLayerToken = _chunkXOJ2VWX4cjs.ViewLayerToken; exports.activateIslandViewModels = _chunk6ZFVV3AVcjs.activateIslandViewModels; exports.collectDocumentContribution = _chunk6ZFVV3AVcjs.collectDocumentContribution; exports.collectIslandState = _chunk6ZFVV3AVcjs.collectIslandState; exports.createIslandContainer = _chunk6ZFVV3AVcjs.createIslandContainer; exports.describeIsland = describeIsland; exports.getAppContainer = _chunk6ZFVV3AVcjs.getAppContainer; exports.getIslandsSnapshot = getIslandsSnapshot; exports.hydrateIslandState = _chunk6ZFVV3AVcjs.hydrateIslandState; exports.isDocumentSource = _chunk6ZFVV3AVcjs.isDocumentSource; exports.matchRoute = _chunk6ZFVV3AVcjs.matchRoute; exports.normalizeRoutes = _chunk6ZFVV3AVcjs.normalizeRoutes; exports.pathPattern = _chunk6ZFVV3AVcjs.pathPattern; exports.registerIsland = registerIsland; exports.renderApp = _chunk6ZFVV3AVcjs.renderApp; exports.resolveEagerUnits = _chunk6ZFVV3AVcjs.resolveEagerUnits; exports.resolveViewAdapter = _chunkXOJ2VWX4cjs.resolveViewAdapter; exports.slotAddress = slotAddress; exports.subscribeIslands = subscribeIslands; exports.viewAdapterOf = _chunkXOJ2VWX4cjs.viewAdapterOf;

package/island/index.d.cts

@@ -1,9 +1,83 @@
-import { I as IslandDescriptor } from '../view-adapter-zbHBVVqR.cjs';
-export { V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken, r as resolveViewAdapter, v as viewAdapterOf } from '../view-adapter-zbHBVVqR.cjs';
+import { I as IslandDescriptor } from '../descriptor-h0JE9jFx.cjs';
 import { Container } from '@foxford/ioc';
-import { g as GuardDefinition } from '../types-COwVwgzE.cjs';
+import { R as RequestContext } from '../types-COwVwgzE.cjs';
+export { A as AppRoute, R as RouteDeclaration, a as RouteMatch, m as matchRoute, n as normalizeRoutes, p as pathPattern } from '../routes-BqIoqbt1.cjs';
+export { R as RenderIslandOptions, c as RenderTree, S as ServerRender, d as ServerRenderResult, V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken, r as resolveViewAdapter, v as viewAdapterOf } from '../view-adapter-D2597RJZ.cjs';
 import '../define-slot-BKvArA02.cjs';
 
+/** Вклад приложения в `<head>` документа. */
+interface DocumentHead {
+    title?: string;
+    description?: string;
+    keywords?: string;
+    /** При отсутствии хост берёт `title`. */
+    ogTitle?: string;
+    /** При отсутствии хост берёт `description`. */
+    ogDescription?: string;
+}
+/** Что приложение сообщает хосту про страницу, которую оно нарисовало. */
+interface DocumentContribution {
+    head?: DocumentHead;
+    /**
+     * Исход запроса статусом HTTP; не объявлен — `200`.
+     *
+     * Статусом, а не набором признаков вроде «страницы нет»: исход у запроса один, а признаки
+     * позволяют объявить сразу два взаимоисключающих. Тем же статусом исход едет по сети,
+     * поэтому у обоих транспортов дискриминатор общий.
+     *
+     * Нужен отдельно от исключения: `throw` означает, что приложение упало, и хост рисует
+     * плашку вместо него. Приложение, занявшее путь по префиксу (`/legal/*`), обязано уметь
+     * сказать `404` про несуществующий адрес внутри своего пространства.
+     */
+    status?: number;
+    /** Адрес для 3xx. Объявлен без статуса — исход `302`. */
+    redirect?: string;
+}
+/**
+ * VM, которой есть что сказать про документ.
+ *
+ * Метод СИНХРОННЫЙ, и это не ограничение, а разделение обязанностей: ходит в ручки активация,
+ * а здесь остаётся проекция уже посчитанного состояния. Приложению, которому «есть ли такая
+ * страница» известно только от бэкенда, второй поход не нужен — активация ждётся ДО сбора
+ * вклада, поэтому к моменту вызова ответ уже лежит в состоянии VM:
+ *
+ * ```ts
+ * async activate(route: IslandRoute) {
+ *   this.state.set(await loadPage(this.service, route.pathname)) // сюда ходим
+ * }
+ *
+ * describeDocument(): DocumentContribution {
+ *   return this.state.get().page === null ? { status: 404 } : { head: … } // здесь только решаем
+ * }
+ * ```
+ *
+ * Разреши мы здесь асинхронность — у рендера появилась бы вторая фаза походов в сеть, а логика
+ * загрузки разъехалась бы по двум местам. Ровно от этого избавлялись, убирая `load`.
+ */
+interface DocumentSource {
+    describeDocument(): DocumentContribution;
+}
+/**
+ * Реализует ли объект {@link DocumentSource}.
+ *
+ * @param value - Проверяемое значение
+ */
+declare function isDocumentSource(value: unknown): value is DocumentSource;
+
+/**
+ * Адрес, по которому рендерится остров.
+ *
+ * Приходит АРГУМЕНТОМ активации, а не через контейнер: контейнер живёт и на клиенте, где
+ * адреса в нём нет, и юнит, потребовавший его через `requires`, упал бы при резолве.
+ */
+interface IslandRoute {
+    /** Путь без search, с ведущим слэшем: `/legal/general`. */
+    pathname: string;
+    /** Строка запроса без `?`; пустая, если её нет. */
+    search: string;
+    /** Параметры, выделенные маршрутом хоста. */
+    params: Record<string, string>;
+}
 /** Опции сборки контейнера острова. */
 interface CreateIslandContainerOptions {
     /**
@@ -42,14 +116,36 @@ declare function createIslandContainer(descriptor: IslandDescriptor, options?: C
  */
 declare function hydrateIslandState(container: Container, descriptor: IslandDescriptor, denState: Record<string, unknown>): void;
 /**
- * Активирует VM острова самостоятельно — когда серверного denState нет (ремоунт острова
- * без данных, чисто клиентский переход). С denState активация не нужна: состояние уже
- * приехало готовым.
+ * Активирует VM острова: каждая считает своё состояние по адресу.
+ *
+ * Параллельно, потому что VM одного острова друг о друге не знают; ждём все — состояние
+ * нужно целиком, а не по частям.
+ *
+ * @param container - Контейнер острова
+ * @param descriptor - Дескриптор острова
+ * @param route - Адрес, по которому рендерится остров
+ */
+declare function activateIslandViewModels(container: Container, descriptor: IslandDescriptor, route?: IslandRoute): Promise<void>;
+/**
+ * Снимает состояние VM острова — операция, обратная {@link hydrateIslandState}.
  *
  * @param container - Контейнер острова
  * @param descriptor - Дескриптор острова
+ * @returns Состояние по ключам `token.description`
  */
-declare function activateIslandViewModels(container: Container, descriptor: IslandDescriptor): void;
+declare function collectIslandState(container: Container, descriptor: IslandDescriptor): Record<string, unknown>;
+/**
+ * Собирает вклад острова в документ по всем его VM.
+ *
+ * Правила слияния два, и они следуют из смысла полей. `head` — набор полей, поэтому
+ * объявленное позже уточняет объявленное раньше. Исход (`status` вместе с `redirect`) —
+ * ОДНО решение, а не набор: побеждает первое объявленное, и берётся оно целиком, иначе
+ * статус одной VM склеился бы с адресом другой.
+ *
+ * @param container - Контейнер острова
+ * @param descriptor - Дескриптор острова
+ */
+declare function collectDocumentContribution(container: Container, descriptor: IslandDescriptor): DocumentContribution;
 /**
  * Поднимает единицы, объявленные `eager`, — те, что обязаны жить с загрузки, а не с первого
  * резолва.
@@ -57,14 +153,65 @@ declare function activateIslandViewModels(container: Container, descriptor: Isla
  * Отдельным шагом, а не внутри сборки контейнера: контейнер строится и на сервере (в vike —
  * прямо в `renderToString`), а сервер живёт один рендер, и поднимать там WS-подписку или
  * прогрев кэша незачем — открытый сокет на каждый рендер это не «eager», это утечка. Зовёт
- * адаптер в точке монтирования, которой на сервере просто нет; серверный прогрев у приложения
- * называется `load`.
+ * адаптер в точке монтирования, которой на сервере просто нет; серверное состояние приложения
+ * считает активация VM.
  *
  * @param container - Контейнер острова
  * @param descriptor - Дескриптор острова
  */
 declare function resolveEagerUnits(container: Container, descriptor: IslandDescriptor): void;
 
+/** Запрос на рендер приложения. */
+interface RenderAppRequest {
+    /** Путь без search, с ведущим слэшем: `/legal/general`. */
+    pathname: string;
+    /** Строка запроса без `?`. */
+    search?: string;
+    /** Параметры, выделенные маршрутом хоста. */
+    params?: Record<string, string>;
+    /**
+     * Реквизиты запроса браузера — заголовки и куки. Кладутся в контейнер под
+     * `RequestContextToken`, поэтому приложение читает их через `requires`, одинаково у обоих
+     * транспортов: в процессе хоста их даёт хост, за сетью — сетевой рантайм из `X-Forwarded-*`.
+     */
+    context?: RequestContext;
+    /**
+     * Родитель контейнера приложения: через него приезжает всё, что настроил исполнитель, —
+     * логгер, конфиг HTTP, выданные возможности. По умолчанию — app-scope контейнер.
+     */
+    parent?: Container;
+    /** Внешние заполнители слотов; для ядра непрозрачны. */
+    slots?: Record<string, unknown>;
+}
+/** Ответ приложения: всё, что хосту нужно, чтобы собрать документ и ответить. */
+interface RenderAppResult {
+    /**
+     * Исход запроса статусом HTTP. `200` — вот страница; всё остальное значит, что страницы
+     * по этому адресу нет, и тело такого ответа выбирает хост: страница ошибки у портала одна
+     * на все приложения.
+     */
+    status: number;
+    /** Разметка приложения; пустая при любом исходе, кроме `200`. */
+    html: string;
+    /** Состояние VM по ключам `token.description` — им гидрируется остров в браузере. */
+    state: Record<string, unknown>;
+    /** Вклад в `<head>` данными. */
+    head?: DocumentHead;
+    /** Вклад в `<head>` готовой разметкой — стили, собранные во время рендера. */
+    headHtml?: string;
+    /** Адрес для 3xx. */
+    redirect?: string;
+}
+/**
+ * Рисует приложение по адресу и отдаёт разметку вместе с состоянием.
+ *
+ * @param descriptor - Дескриптор приложения
+ * @param request - Адрес, родительский контейнер и заполнители слотов
+ * @returns Разметка, состояние и вклад в документ
+ * @throws Если контейнер приложения не собрался — исполнитель решает, чем это показать
+ */
+declare function renderApp(descriptor: IslandDescriptor, request: RenderAppRequest): Promise<RenderAppResult>;
+
 /** Запись живого острова: имя + фактический состав его контейнера. */
 interface IslandRecord {
     /** Уникальный id инстанса острова (островов одного приложения может быть несколько). */
@@ -122,75 +269,4 @@ declare function getAppContainer(): Container;
  */
 declare function slotAddress(app: string, slot: string): string;
 
-/** Маршрут с политикой доступа. */
-interface RouteDeclaration {
-    /** Regex-источник адреса (`'^/cabinet/billing'`, `'.*'`). */
-    source: string;
-    /**
-     * Guard-ы этого маршрута — поверх guard-ов приложения и хоста. Пусто — маршрут открыт
-     * настолько, насколько открыто само приложение.
-     */
-    guards?: ReadonlyArray<GuardDefinition>;
-}
-/**
- * Заявка на адрес: голая строка — публичный маршрут, объект — маршрут со своей политикой.
- * Обе формы лежат в одном массиве, и порядок значим так же, как раньше: хост раздаёт путь
- * первому заявившему, поэтому частные записи ставятся выше общих.
- */
-type AppRoute = string | RouteDeclaration;
-/**
- * Приводит заявки к одной форме — чтобы хост и dev-инструменты не разбирали union каждый сам.
- *
- * @param routes - Заявки приложения (строки и/или записи)
- * @returns Записи маршрутов в порядке объявления
- */
-declare function normalizeRoutes(routes?: ReadonlyArray<AppRoute>): RouteDeclaration[];
-
-/** Что приложение отдало серверным рендером. */
-interface ServerRenderResult {
-    /** Разметка дерева — результат переданного рендера. */
-    html: string;
-    /**
-     * Вклад в `<head>` ГОТОВОЙ разметкой: то, что рождается только во время рендера и
-     * данными не описывается.
-     *
-     * Таковы стили CSS-in-JS: стороннее представление у них одно — тег со служебными
-     * атрибутами, по которым клиентский рантайм узнаёт свои правила. Разобрав его на поля,
-     * потеряешь регидратацию, и стили впрыснутся вторым экземпляром. Поэтому вклад в документ
-     * ДАННЫМИ (`DocumentHead` у хостов) остаётся отдельным каналом, а это — разметка.
-     *
-     * Разметка приезжает в документ хоста ДОСЛОВНО, без экранирования — иначе служебные
-     * атрибуты не пережили бы вставку. Отвечает за содержимое приложение: у сетевого
-     * транспорта строка приходит из чужого процесса, и хост её не разбирает.
-     */
-    head?: string;
-}
-/** Рендер дерева в разметку. Его даёт тот, кто серверный рендер исполняет. */
-type RenderTree<Tree = unknown> = (tree: Tree) => string;
-/**
- * Серверный рендер приложения: приложению дают его дерево и рендер, оно возвращает
- * разметку и свой вклад в документ.
- *
- * Рендер приходит АРГУМЕНТОМ, потому что приложение им не владеет: страницу собирает тот,
- * кто держит документ, и приложений на ней может быть несколько. Отдав рендер аргументом,
- * приложение получает обычную функцию — состояние прохода живёт локальной переменной и
- * между запросами не утекает.
- *
- * Подпись одна на оба транспорта, и в этом смысл: у приложения в процессе хоста рендер
- * передаёт хост, у сетевого — его собственный сервер, а `html` и `head` едут ответом.
- * Перевод приложения между транспортами эту часть не задевает.
- *
- * `Tree` — дерево view-фреймворка, для ядра непрозрачное. View-адаптер сужает параметр
- * до своего типа (`ReactServerRender` в `@foxford/den-react`), и приложение пишет проход
- * в терминах СВОЕГО фреймворка.
- *
- * @example
- * serverRender: (tree, render) => {
- *   const sheet = new ServerStyleSheet()
- *
- *   return { head: sheet.getStyleTags(), html: render(sheet.collectStyles(tree)) }
- * }
- */
-type ServerRender<Tree = unknown> = (tree: Tree, render: RenderTree<Tree>) => ServerRenderResult;
-
-export { type AppRoute, type CreateIslandContainerOptions, IslandDescriptor, type IslandRecord, type RenderTree, type RouteDeclaration, type ServerRender, type ServerRenderResult, activateIslandViewModels, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, normalizeRoutes, registerIsland, resolveEagerUnits, slotAddress, subscribeIslands };
+export { type CreateIslandContainerOptions, type DocumentContribution, type DocumentHead, type DocumentSource, IslandDescriptor, type IslandRecord, type IslandRoute, type RenderAppRequest, type RenderAppResult, activateIslandViewModels, collectDocumentContribution, collectIslandState, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, isDocumentSource, registerIsland, renderApp, resolveEagerUnits, slotAddress, subscribeIslands };