npm - @foxford/den - Versions diffs - 2.0.0 → 3.0.0 - Mend

@foxford/den 2.0.0 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (23) hide show

package/adapter.d.cts +1 -1
package/adapter.d.ts +1 -1
package/{chunk-TCYGDT2A.js → chunk-E23E2VUC.js} +2 -2
package/{chunk-LJE7K7VD.cjs → chunk-XOJ2VWX4.cjs} +2 -2
package/{define-repository-DZg34Tb3.d.ts → define-repository-Ca62_YCy.d.ts} +1 -1
package/{define-repository-OpMj-Q9O.d.cts → define-repository-MDEWHqM7.d.cts} +1 -1
package/{define-slot-RfgqKa6n.d.cts → define-slot-BKvArA02.d.cts} +1 -1
package/{define-slot-ESU7FR9O.d.ts → define-slot-Dil8Kr1A.d.ts} +1 -1
package/define.d.cts +3 -3
package/define.d.ts +3 -3
package/index.cjs +2 -25
package/index.d.cts +6 -27
package/index.d.ts +6 -27
package/index.js +1 -24
package/island/index.cjs +104 -5
package/island/index.d.cts +160 -49
package/island/index.d.ts +160 -49
package/island/index.js +103 -4
package/package.json +12 -12
package/{types-Deyolj1-.d.cts → types-COwVwgzE.d.cts} +18 -43
package/{types-Deyolj1-.d.ts → types-COwVwgzE.d.ts} +18 -43
package/{view-adapter-vwO-7b1t.d.cts → view-adapter-BvDC5O4y.d.cts} +81 -3
package/{view-adapter-CL0vZ-rv.d.ts → view-adapter-DtNgyjIf.d.ts} +81 -3

package/island/index.d.cts CHANGED Viewed

@@ -1,9 +1,62 @@
-import { I as IslandDescriptor } from '../view-adapter-vwO-7b1t.cjs';
-export { V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken, r as resolveViewAdapter, v as viewAdapterOf } from '../view-adapter-vwO-7b1t.cjs';
+import { I as IslandDescriptor } from '../view-adapter-BvDC5O4y.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-BvDC5O4y.cjs';
 import { Container } from '@foxford/ioc';
-import '../define-slot-RfgqKa6n.cjs';
-import '../types-Deyolj1-.cjs';
+import { g as GuardDefinition } from '../types-COwVwgzE.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, которой есть что сказать про документ. */
+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 +95,95 @@ 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 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`, — те, что обязаны жить с загрузки, а не с первого
+ * резолва.
+ *
+ * Отдельным шагом, а не внутри сборки контейнера: контейнер строится и на сервере (в vike —
+ * прямо в `renderToString`), а сервер живёт один рендер, и поднимать там WS-подписку или
+ * прогрев кэша незачем — открытый сокет на каждый рендер это не «eager», это утечка. Зовёт
+ * адаптер в точке монтирования, которой на сервере просто нет; серверное состояние приложения
+ * считает активация VM.
  *
  * @param container - Контейнер острова
  * @param descriptor - Дескриптор острова
  */
-declare function activateIslandViewModels(container: Container, descriptor: IslandDescriptor): void;
+declare function resolveEagerUnits(container: Container, descriptor: IslandDescriptor): void;
+/** Запрос на рендер приложения. */
+interface RenderAppRequest {
+    /** Путь без search, с ведущим слэшем: `/legal/general`. */
+    pathname: string;
+    /** Строка запроса без `?`. */
+    search?: string;
+    /** Параметры, выделенные маршрутом хоста. */
+    params?: Record<string, string>;
+    /**
+     * Родитель контейнера приложения: через него приезжает всё, что настроил исполнитель, —
+     * логгер, конфиг 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 {
@@ -108,51 +242,28 @@ declare function getAppContainer(): Container;
  */
 declare function slotAddress(app: string, slot: string): string;
-/** Что приложение отдало серверным рендером. */
-interface ServerRenderResult {
-    /** Разметка дерева — результат переданного рендера. */
-    html: string;
+/** Маршрут с политикой доступа. */
+interface RouteDeclaration {
+    /** Regex-источник адреса (`'^/cabinet/billing'`, `'.*'`). */
+    source: string;
     /**
-     * Вклад в `<head>` ГОТОВОЙ разметкой: то, что рождается только во время рендера и
-     * данными не описывается.
-     *
-     * Таковы стили CSS-in-JS: стороннее представление у них одно — тег со служебными
-     * атрибутами, по которым клиентский рантайм узнаёт свои правила. Разобрав его на поля,
-     * потеряешь регидратацию, и стили впрыснутся вторым экземпляром. Поэтому вклад в документ
-     * ДАННЫМИ (`DocumentHead` у хостов) остаётся отдельным каналом, а это — разметка.
-     *
-     * Разметка приезжает в документ хоста ДОСЛОВНО, без экранирования — иначе служебные
-     * атрибуты не пережили бы вставку. Отвечает за содержимое приложение: у сетевого
-     * транспорта строка приходит из чужого процесса, и хост её не разбирает.
+     * Guard-ы этого маршрута — поверх guard-ов приложения и хоста. Пусто — маршрут открыт
+     * настолько, насколько открыто само приложение.
      */
-    head?: string;
+    guards?: ReadonlyArray<GuardDefinition>;
 }
-/** Рендер дерева в разметку. Его даёт тот, кто серверный рендер исполняет. */
-type RenderTree<Tree = unknown> = (tree: Tree) => string;
 /**
- * Серверный рендер приложения: приложению дают его дерево и рендер, оно возвращает
- * разметку и свой вклад в документ.
- *
- * Рендер приходит АРГУМЕНТОМ, потому что приложение им не владеет: страницу собирает тот,
- * кто держит документ, и приложений на ней может быть несколько. Отдав рендер аргументом,
- * приложение получает обычную функцию — состояние прохода живёт локальной переменной и
- * между запросами не утекает.
- *
- * Подпись одна на оба транспорта, и в этом смысл: у приложения в процессе хоста рендер
- * передаёт хост, у сетевого — его собственный сервер, а `html` и `head` едут ответом.
- * Перевод приложения между транспортами эту часть не задевает.
- *
- * `Tree` — дерево view-фреймворка, для ядра непрозрачное. View-адаптер сужает параметр
- * до своего типа (`ReactServerRender` в `@foxford/den-react`), и приложение пишет проход
- * в терминах СВОЕГО фреймворка.
- *
- * @example
- * serverRender: (tree, render) => {
- *   const sheet = new ServerStyleSheet()
+ * Заявка на адрес: голая строка — публичный маршрут, объект — маршрут со своей политикой.
+ * Обе формы лежат в одном массиве, и порядок значим так же, как раньше: хост раздаёт путь
+ * первому заявившему, поэтому частные записи ставятся выше общих.
+ */
+type AppRoute = string | RouteDeclaration;
+/**
+ * Приводит заявки к одной форме — чтобы хост и dev-инструменты не разбирали union каждый сам.
  *
- *   return { head: sheet.getStyleTags(), html: render(sheet.collectStyles(tree)) }
- * }
+ * @param routes - Заявки приложения (строки и/или записи)
+ * @returns Записи маршрутов в порядке объявления
  */
-type ServerRender<Tree = unknown> = (tree: Tree, render: RenderTree<Tree>) => ServerRenderResult;
+declare function normalizeRoutes(routes?: ReadonlyArray<AppRoute>): RouteDeclaration[];
-export { type CreateIslandContainerOptions, IslandDescriptor, type IslandRecord, type RenderTree, type ServerRender, type ServerRenderResult, activateIslandViewModels, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, registerIsland, slotAddress, subscribeIslands };
+export { type AppRoute, type CreateIslandContainerOptions, type DocumentContribution, type DocumentHead, type DocumentSource, IslandDescriptor, type IslandRecord, type IslandRoute, type RenderAppRequest, type RenderAppResult, type RouteDeclaration, activateIslandViewModels, collectDocumentContribution, collectIslandState, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, isDocumentSource, normalizeRoutes, registerIsland, renderApp, resolveEagerUnits, slotAddress, subscribeIslands };

package/island/index.d.ts CHANGED Viewed

@@ -1,9 +1,62 @@
-import { I as IslandDescriptor } from '../view-adapter-CL0vZ-rv.js';
-export { V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken, r as resolveViewAdapter, v as viewAdapterOf } from '../view-adapter-CL0vZ-rv.js';
+import { I as IslandDescriptor } from '../view-adapter-DtNgyjIf.js';
+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-DtNgyjIf.js';
 import { Container } from '@foxford/ioc';
-import '../define-slot-ESU7FR9O.js';
-import '../types-Deyolj1-.js';
+import { g as GuardDefinition } from '../types-COwVwgzE.js';
+import '../define-slot-Dil8Kr1A.js';
+/** Вклад приложения в `<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, которой есть что сказать про документ. */
+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 +95,95 @@ 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 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`, — те, что обязаны жить с загрузки, а не с первого
+ * резолва.
+ *
+ * Отдельным шагом, а не внутри сборки контейнера: контейнер строится и на сервере (в vike —
+ * прямо в `renderToString`), а сервер живёт один рендер, и поднимать там WS-подписку или
+ * прогрев кэша незачем — открытый сокет на каждый рендер это не «eager», это утечка. Зовёт
+ * адаптер в точке монтирования, которой на сервере просто нет; серверное состояние приложения
+ * считает активация VM.
  *
  * @param container - Контейнер острова
  * @param descriptor - Дескриптор острова
  */
-declare function activateIslandViewModels(container: Container, descriptor: IslandDescriptor): void;
+declare function resolveEagerUnits(container: Container, descriptor: IslandDescriptor): void;
+/** Запрос на рендер приложения. */
+interface RenderAppRequest {
+    /** Путь без search, с ведущим слэшем: `/legal/general`. */
+    pathname: string;
+    /** Строка запроса без `?`. */
+    search?: string;
+    /** Параметры, выделенные маршрутом хоста. */
+    params?: Record<string, string>;
+    /**
+     * Родитель контейнера приложения: через него приезжает всё, что настроил исполнитель, —
+     * логгер, конфиг 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 {
@@ -108,51 +242,28 @@ declare function getAppContainer(): Container;
  */
 declare function slotAddress(app: string, slot: string): string;
-/** Что приложение отдало серверным рендером. */
-interface ServerRenderResult {
-    /** Разметка дерева — результат переданного рендера. */
-    html: string;
+/** Маршрут с политикой доступа. */
+interface RouteDeclaration {
+    /** Regex-источник адреса (`'^/cabinet/billing'`, `'.*'`). */
+    source: string;
     /**
-     * Вклад в `<head>` ГОТОВОЙ разметкой: то, что рождается только во время рендера и
-     * данными не описывается.
-     *
-     * Таковы стили CSS-in-JS: стороннее представление у них одно — тег со служебными
-     * атрибутами, по которым клиентский рантайм узнаёт свои правила. Разобрав его на поля,
-     * потеряешь регидратацию, и стили впрыснутся вторым экземпляром. Поэтому вклад в документ
-     * ДАННЫМИ (`DocumentHead` у хостов) остаётся отдельным каналом, а это — разметка.
-     *
-     * Разметка приезжает в документ хоста ДОСЛОВНО, без экранирования — иначе служебные
-     * атрибуты не пережили бы вставку. Отвечает за содержимое приложение: у сетевого
-     * транспорта строка приходит из чужого процесса, и хост её не разбирает.
+     * Guard-ы этого маршрута — поверх guard-ов приложения и хоста. Пусто — маршрут открыт
+     * настолько, насколько открыто само приложение.
      */
-    head?: string;
+    guards?: ReadonlyArray<GuardDefinition>;
 }
-/** Рендер дерева в разметку. Его даёт тот, кто серверный рендер исполняет. */
-type RenderTree<Tree = unknown> = (tree: Tree) => string;
 /**
- * Серверный рендер приложения: приложению дают его дерево и рендер, оно возвращает
- * разметку и свой вклад в документ.
- *
- * Рендер приходит АРГУМЕНТОМ, потому что приложение им не владеет: страницу собирает тот,
- * кто держит документ, и приложений на ней может быть несколько. Отдав рендер аргументом,
- * приложение получает обычную функцию — состояние прохода живёт локальной переменной и
- * между запросами не утекает.
- *
- * Подпись одна на оба транспорта, и в этом смысл: у приложения в процессе хоста рендер
- * передаёт хост, у сетевого — его собственный сервер, а `html` и `head` едут ответом.
- * Перевод приложения между транспортами эту часть не задевает.
- *
- * `Tree` — дерево view-фреймворка, для ядра непрозрачное. View-адаптер сужает параметр
- * до своего типа (`ReactServerRender` в `@foxford/den-react`), и приложение пишет проход
- * в терминах СВОЕГО фреймворка.
- *
- * @example
- * serverRender: (tree, render) => {
- *   const sheet = new ServerStyleSheet()
+ * Заявка на адрес: голая строка — публичный маршрут, объект — маршрут со своей политикой.
+ * Обе формы лежат в одном массиве, и порядок значим так же, как раньше: хост раздаёт путь
+ * первому заявившему, поэтому частные записи ставятся выше общих.
+ */
+type AppRoute = string | RouteDeclaration;
+/**
+ * Приводит заявки к одной форме — чтобы хост и dev-инструменты не разбирали union каждый сам.
  *
- *   return { head: sheet.getStyleTags(), html: render(sheet.collectStyles(tree)) }
- * }
+ * @param routes - Заявки приложения (строки и/или записи)
+ * @returns Записи маршрутов в порядке объявления
  */
-type ServerRender<Tree = unknown> = (tree: Tree, render: RenderTree<Tree>) => ServerRenderResult;
+declare function normalizeRoutes(routes?: ReadonlyArray<AppRoute>): RouteDeclaration[];
-export { type CreateIslandContainerOptions, IslandDescriptor, type IslandRecord, type RenderTree, type ServerRender, type ServerRenderResult, activateIslandViewModels, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, registerIsland, slotAddress, subscribeIslands };
+export { type AppRoute, type CreateIslandContainerOptions, type DocumentContribution, type DocumentHead, type DocumentSource, IslandDescriptor, type IslandRecord, type IslandRoute, type RenderAppRequest, type RenderAppResult, type RouteDeclaration, activateIslandViewModels, collectDocumentContribution, collectIslandState, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, isDocumentSource, normalizeRoutes, registerIsland, renderApp, resolveEagerUnits, slotAddress, subscribeIslands };

package/island/index.js CHANGED Viewed

@@ -2,16 +2,22 @@ import {
   ViewLayerToken,
   resolveViewAdapter,
   viewAdapterOf
-} from "../chunk-TCYGDT2A.js";
+} from "../chunk-E23E2VUC.js";
 import {
   LoggerToken,
   logger,
   unitLogger
 } from "../chunk-TPBI6TOU.js";
 import {
+  __async,
   __spreadValues
 } from "../chunk-HJO26HIQ.js";
+// src/island/document.ts
+function isDocumentSource(value) {
+  return typeof value === "object" && value !== null && typeof value.describeDocument === "function";
+}
 // src/island/lifecycle.ts
 import { log } from "@foxford/logger";
@@ -28,6 +34,8 @@ function getAppContainer() {
 }
 // src/island/lifecycle.ts
+var EMPTY_ROUTE = { params: {}, pathname: "", search: "" };
+var REDIRECT_FOUND = 302;
 function createIslandContainer(descriptor, options = {}) {
   var _a, _b, _c, _d, _e;
   const { parent = getAppContainer() } = options;
@@ -68,15 +76,95 @@ function hydrateIslandState(container, descriptor, denState) {
     }
   }
 }
-function activateIslandViewModels(container, descriptor) {
+function activateIslandViewModels(_0, _1) {
+  return __async(this, arguments, function* (container, descriptor, route = EMPTY_ROUTE) {
+    var _a;
+    yield Promise.all(
+      ((_a = descriptor.viewModels) != null ? _a : []).map((vm) => __async(null, null, function* () {
+        var _a2;
+        const instance = container.resolve(vm.token);
+        unitLogger(container, vm.token.description).debug(`\u0430\u043A\u0442\u0438\u0432\u0430\u0446\u0438\u044F VM (${route.pathname || "\u2014"})`);
+        yield (_a2 = instance.activate) == null ? void 0 : _a2.call(instance, route);
+      }))
+    );
+  });
+}
+function collectIslandState(container, descriptor) {
   var _a, _b;
+  const state = {};
   for (const vm of (_a = descriptor.viewModels) != null ? _a : []) {
     const instance = container.resolve(vm.token);
-    unitLogger(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));
+    if (typeof ((_b = instance.state) == null ? void 0 : _b.get) === "function") {
+      state[vm.token.description] = instance.state.get();
+    }
+  }
+  return state;
+}
+function collectDocumentContribution(container, descriptor) {
+  var _a, _b;
+  const contribution = {};
+  for (const vm of (_a = descriptor.viewModels) != null ? _a : []) {
+    const instance = container.resolve(vm.token);
+    if (!isDocumentSource(instance)) {
+      continue;
+    }
+    const part = instance.describeDocument();
+    if (part.head) {
+      contribution.head = __spreadValues(__spreadValues({}, contribution.head), part.head);
+    }
+    const declared = part.status !== void 0 || part.redirect !== void 0;
+    if (declared && contribution.status === void 0) {
+      contribution.status = (_b = part.status) != null ? _b : REDIRECT_FOUND;
+      contribution.redirect = part.redirect;
+    }
+  }
+  return contribution;
+}
+function resolveEagerUnits(container, descriptor) {
+  var _a;
+  for (const token of (_a = descriptor.eager) != null ? _a : []) {
+    const instance = container.resolve(token);
+    unitLogger(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) => unitLogger(container, token.description).error("eager: \u0435\u0434\u0438\u043D\u0438\u0446\u0430 \u043D\u0435 \u043F\u043E\u0434\u043D\u044F\u043B\u0430\u0441\u044C", error)
+      );
+    }
   }
 }
+// src/island/render.ts
+var STATUS_OK = 200;
+function renderApp(descriptor, request) {
+  return __async(this, null, function* () {
+    var _a, _b;
+    const route = {
+      params: (_a = request.params) != null ? _a : {},
+      pathname: request.pathname,
+      search: (_b = request.search) != null ? _b : ""
+    };
+    const container = createIslandContainer(descriptor, { parent: request.parent });
+    if (container === null) {
+      throw new Error(`den/island: \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u0435 \xAB${descriptor.name}\xBB \u043D\u0435 \u0441\u043E\u0431\u0440\u0430\u043B\u043E\u0441\u044C \u2014 \u0440\u0435\u043D\u0434\u0435\u0440 \u043D\u0435\u0432\u043E\u0437\u043C\u043E\u0436\u0435\u043D`);
+    }
+    try {
+      yield activateIslandViewModels(container, descriptor, route);
+      const { head, redirect, status = STATUS_OK } = collectDocumentContribution(container, descriptor);
+      if (status !== STATUS_OK) {
+        return { head, html: "", redirect, state: {}, status };
+      }
+      const state = collectIslandState(container, descriptor);
+      const rendered = resolveViewAdapter(container).renderIsland(descriptor, {
+        container,
+        slots: request.slots
+      });
+      return { head, headHtml: rendered.head, html: rendered.html, state, status };
+    } finally {
+      yield container.dispose();
+    }
+  });
+}
 // src/island/slot-address.ts
 function slotAddress(app, slot) {
   return `${app}:${slot}`;
@@ -121,15 +209,26 @@ function describeIsland(descriptor, denState) {
     viewModels: ((_b = descriptor.viewModels) != null ? _b : []).map((vm) => vm.token.description)
   };
 }
+// src/island/routes.ts
+function normalizeRoutes(routes = []) {
+  return routes.map((route) => typeof route === "string" ? { source: route } : route);
+}
 export {
   ViewLayerToken,
   activateIslandViewModels,
+  collectDocumentContribution,
+  collectIslandState,
   createIslandContainer,
   describeIsland,
   getAppContainer,
   getIslandsSnapshot,
   hydrateIslandState,
+  isDocumentSource,
+  normalizeRoutes,
   registerIsland,
+  renderApp,
+  resolveEagerUnits,
   resolveViewAdapter,
   slotAddress,
   subscribeIslands,