@foxford/den 3.0.0 → 3.1.0

package/README.mdx

@@ -4,6 +4,219 @@ title: Den
 
 # @foxford/den
 
-Den — декларативный метафреймворк Foxford (core runtime).
+Декларативный метафреймворк Foxford: приложение объявляет, из чего оно состоит, а исполняет
+это движок. Ядро host-агностично — про Vike и Next знают отдельные пакеты
+(`@foxford/den-vike`, `@foxford/den-next`), про React — `@foxford/den-react`.
 
-Содержит core runtime: define* API, lifecycle, container orchestration, NavigationManager.
+Здесь примеры. Почему устроено именно так — в [SPECIFICATION.md](./SPECIFICATION.md).
+
+## Единицы приложения
+
+Слои объявляются `define*`-функциями и складываются в контейнер. Зависимости приходят через
+`requires` и резолвятся движком, поэтому единица не знает, кто её создаёт.
+
+```ts
+// content-page.repository.ts
+import { defineRepository } from '@foxford/den/define'
+
+export default defineRepository(ContentPageRepositoryToken, {
+  create: () => ({
+    getPage: async (path: string) => fetch(`/api/pages${path}`).then((res) => res.json()),
+  }),
+})
+```
+
+```ts
+// content-page.vm.ts
+import { defineViewModel } from '@foxford/den/define'
+import { ViewModel } from '@foxford/vm'
+
+import type { IslandRoute } from '@foxford/den/island'
+
+export class ContentPageVM extends ViewModel<ReturnType<typeof makeState>> {
+  constructor(private readonly service: ContentPageService) {
+    super(makeState())
+  }
+
+  /** Зовёт движок при рендере страницы — на сервере и в браузере одинаково. */
+  async activate(route: IslandRoute): Promise<void> {
+    this.state.set(await loadContentPage(this.service, route.pathname))
+  }
+}
+
+export default defineViewModel(ContentPageVmToken, {
+  create: ([service]) => new ContentPageVM(service),
+  requires: [ContentPageServiceToken] as const,
+})
+```
+
+## Заявка на адреса и её параметры
+
+Приложение объявляет, какие пути берётся обслуживать. Заявка — **регулярка**: она строго
+выразительнее шаблона (`'.*'` как ловец остатка, префиксы, альтернативы), и порядок в списке
+значим — хост отдаёт путь первому заявившему, поэтому частные записи ставятся выше общих.
+
+Параметры адреса — именованные группы. Писать их руками не нужно, для этого `pathPattern`:
+
+```ts
+import { pathPattern } from '@foxford/den/island'
+
+routes: [
+  pathPattern('/course/:id'), // → '^/course/(?<id>[^/]+)$'
+  '^/legal', // обычная регулярка рядом
+]
+```
+
+Выделяет их `matchRoute` — один матчер на всех: по нему хост решает, кому отдать адрес,
+а рантайм приложения — своё ли это. Разойдись эти два ответа, приложение получало бы запросы
+по путям, которых не заявляло. Значения раскодированы (`/legal/%D0%BE...` → `оферта`).
+
+## Шов рендера: разметка и состояние одним вызовом
+
+`renderApp` — то, чем хост спрашивает у приложения страницу. Внутри движок поднимает контейнер,
+активирует VM по адресу, рисует дерево и снимает состояние; дескриптор при этом остаётся
+декларацией без поведения.
+
+```ts
+import { renderApp } from '@foxford/den/island'
+
+const { status, html, state, head, headHtml, redirect } = await renderApp(app, {
+  pathname: '/legal/general',
+  search: '?from=footer',
+  context: { cookies, headers }, // реквизиты браузерного запроса
+})
+```
+
+`status` — исход запроса: `200` значит «вот страница», всё остальное значит, что страницы по
+этому адресу нет, и тело такого ответа выбирает хост. `state` едет в документ и гидрирует
+остров в браузере, `headHtml` — стили, собранные во время рендера.
+
+### Вклад в документ
+
+Заголовок и исход сообщает VM — необязательным методом `describeDocument`. Полем дескриптора
+это быть не может: после активации только VM знает, нашлась ли страница по адресу.
+
+```ts
+export class ContentPageVM extends ViewModel<State> {
+  /** В ручку ходим ЗДЕСЬ. */
+  async activate(route: IslandRoute): Promise<void> {
+    this.state.set(await loadContentPage(this.service, route.pathname))
+  }
+
+  /** А здесь только решаем по тому, что уже приехало. */
+  describeDocument(): DocumentContribution {
+    const { page } = this.state.get()
+
+    if (page === null) {
+      return { status: 404 } // хост ответит честным 404
+    }
+
+    return { head: { description: page.description, title: page.title } }
+  }
+}
+```
+
+`describeDocument` синхронный намеренно. Приложению, которому «есть ли такая страница» известно
+только от бэкенда, второй поход не нужен: движок ждёт активацию ДО сбора вклада, поэтому к
+моменту вызова ответ уже лежит в состоянии. Разреши мы тут асинхронность — у рендера появилась
+бы вторая фаза походов в сеть, а логика загрузки разъехалась бы по двум местам.
+
+Редирект объявляется там же: `{ redirect: '/user/login' }` — без статуса это `302`.
+
+## Сетевой транспорт: то же самое по HTTP
+
+Приложение поднимается отдельным сервисом **без единой строки своего серверного кода** —
+дескриптор тот же, что и в процессе хоста.
+
+```jsonc
+// package.json приложения
+"scripts": {
+  "dev": "tsup --watch src --onSuccess \"den-serve build/index.js\"",
+  "start": "den-serve build/index.js --port 3342"
+}
+```
+
+`den-serve <модуль>` берёт дефолтный экспорт указанного модуля и поднимает вокруг него рантайм:
+
+| Ручка | Ответ |
+| --- | --- |
+| `GET /_render?url=<path+search>` | `200` + ответ `renderApp` телом |
+| `GET /_routes` | `200` + массив regex-строк заявки на адреса |
+| `GET /_health` | `200 ok` |
+
+**Статус HTTP описывает транспорт, а исход страницы едет полем `status` в теле.** `200` значит
+«приложение ответило» — хоть `404`, хоть редиректом. Всё остальное значит «до приложения не
+дошли»: `400` — сломанный запрос, `404` — неизвестная ручка или путь вне заявки, `500` — рендер
+упал. Так `404` от приложения не путается с `404` от неверно настроенного прокси.
+
+Браузерные заголовки рантайм читает только из `X-Forwarded-*` и кладёт в `RequestContextToken`;
+`Cookie` — обычным именем.
+
+### Расширение снаружи: пример с Sentry
+
+Основа — fastify, и отдаётся она плагином, поэтому Sentry, метрики, cors и трейсинг ставит
+ПОТРЕБИТЕЛЬ. Своих опций под каждую такую потребность пакет не заводит.
+
+Инициализация Sentry должна пройти раньше всего остального кода, поэтому она живёт отдельным
+модулем и грузится флагом `--import`, а не из точки входа:
+
+```ts
+// instrument.js — грузится раньше приложения
+import * as Sentry from '@sentry/node'
+
+Sentry.init({
+  dsn: process.env.SENTRY_DSN,
+  environment: process.env.NODE_ENV,
+  tracesSampleRate: 0.1,
+})
+```
+
+Обработчик ошибок вешается уже на готовый инстанс — это и есть `configure`:
+
+```ts
+// configure.js — дефолтный экспорт получает инстанс fastify до прослушивания
+import * as Sentry from '@sentry/node'
+
+export default (instance) => {
+  Sentry.setupFastifyErrorHandler(instance)
+
+  instance.get('/metrics', () => renderMetrics())
+}
+```
+
+```jsonc
+// package.json приложения — своего серверного кода по-прежнему ноль
+"scripts": {
+  "start": "den-serve build/index.js --configure ./configure.js --port 3342"
+},
+```
+
+Запуск с инструментацией: `NODE_OPTIONS='--import ./instrument.js' pnpm start`.
+
+Если сервер нужен свой — общий порт с чужими ручками, свой порядок плагинов, — берите плагин
+и монтируйте куда угодно, хоть под префиксом:
+
+```ts
+import Fastify from 'fastify'
+import * as Sentry from '@sentry/node'
+import { appPlugin } from '@foxford/den/serve'
+
+const instance = Fastify()
+Sentry.setupFastifyErrorHandler(instance)
+
+await instance.register(appPlugin, { app, prefix: '/den' })
+await instance.listen({ port: 3342 })
+```
+
+`serveApp` поверх плагина добавляет логирование запросов (в терминах `@foxford/logger`, корень —
+имя приложения, рендер дольше порога уходит в `warn`) и закрытие по `SIGTERM`/`SIGINT`.
+
+## Подпути
+
+| Подпуть | Что там |
+| --- | --- |
+| `@foxford/den` | рантайм, `define*`, менеджеры контейнеров и состояния |
+| `@foxford/den/define` | те же `define*` без сайд-эффекта установки резолвера |
+| `@foxford/den/adapter` | шов резолва для адаптеров хостов |
+| `@foxford/den/island` | остров: жизненный цикл, шов `renderApp`, порт `ViewAdapter` |
+| `@foxford/den/serve` | сетевой транспорт: `serveApp`, `appPlugin`, команда `den-serve` |

package/chunk-6ZFVV3AV.cjs

@@ -0,0 +1,214 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkXOJ2VWX4cjs = require('./chunk-XOJ2VWX4.cjs');
+
+
+
+
+
+var _chunkCZVYVNLIcjs = require('./chunk-CZVYVNLI.cjs');
+
+
+
+var _chunkXHYR3SGGcjs = require('./chunk-XHYR3SGG.cjs');
+
+// src/island/document.ts
+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 = _chunkCZVYVNLIcjs.logger.getLogger("island:runtime")) != null ? _a : _chunkCZVYVNLIcjs.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: "" };
+var REDIRECT_FOUND = 302;
+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 : _chunkCZVYVNLIcjs.logger;
+  const islandLog = (_c = appLog.getLogger("client")) != null ? _c : appLog;
+  try {
+    const container = parent.createChild();
+    container.bind(_chunkCZVYVNLIcjs.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") {
+      _chunkCZVYVNLIcjs.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(_0, _1) {
+  return _chunkXHYR3SGGcjs.__async.call(void 0, this, arguments, function* (container, descriptor, route = EMPTY_ROUTE) {
+    var _a;
+    yield Promise.all(
+      ((_a = descriptor.viewModels) != null ? _a : []).map((vm) => _chunkXHYR3SGGcjs.__async.call(void 0, null, null, function* () {
+        var _a2;
+        const instance = container.resolve(vm.token);
+        _chunkCZVYVNLIcjs.unitLogger.call(void 0, 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);
+    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 = _chunkXHYR3SGGcjs.__spreadValues.call(void 0, _chunkXHYR3SGGcjs.__spreadValues.call(void 0, {}, 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);
+    _chunkCZVYVNLIcjs.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) => _chunkCZVYVNLIcjs.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)
+      );
+    }
+  }
+}
+
+// src/island/render.ts
+var STATUS_OK = 200;
+function renderApp(descriptor, request) {
+  return _chunkXHYR3SGGcjs.__async.call(void 0, 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 {
+      if (request.context) {
+        container.bind(_chunkCZVYVNLIcjs.RequestContextToken).toValue(request.context);
+      }
+      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 = _chunkXOJ2VWX4cjs.resolveViewAdapter.call(void 0, container).renderIsland(descriptor, {
+        container,
+        slots: request.slots
+      });
+      return { head, headHtml: rendered.head, html: rendered.html, state, status };
+    } finally {
+      yield container.dispose();
+    }
+  });
+}
+
+// src/island/routes.ts
+function normalizeRoutes(routes = []) {
+  return routes.map((route) => typeof route === "string" ? { source: route } : route);
+}
+function matchRoute(routes = [], pathname) {
+  for (const route of normalizeRoutes(routes)) {
+    const found = new RegExp(route.source).exec(pathname);
+    if (found !== null) {
+      return { params: decodeParams(found.groups), route };
+    }
+  }
+  return null;
+}
+function decodeParams(groups) {
+  const params = {};
+  for (const [name, value] of Object.entries(groups != null ? groups : {})) {
+    if (value === void 0) {
+      continue;
+    }
+    try {
+      params[name] = decodeURIComponent(value);
+    } catch (e) {
+      params[name] = value;
+    }
+  }
+  return params;
+}
+var REGEXP_SPECIALS = /[.*+?^${}()|[\]\\]/g;
+var PARAM_SEGMENT = /\/:([A-Za-z_$][\w$]*)/g;
+function pathPattern(pattern) {
+  return `^${pattern.replace(REGEXP_SPECIALS, "\\$&").replace(PARAM_SEGMENT, "/(?<$1>[^/]+)")}$`;
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.isDocumentSource = isDocumentSource; 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;

package/chunk-7M5OAOQ4.js

@@ -0,0 +1,214 @@
+import {
+  resolveViewAdapter
+} from "./chunk-E23E2VUC.js";
+import {
+  LoggerToken,
+  RequestContextToken,
+  logger,
+  unitLogger
+} from "./chunk-KJ6NDOOL.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/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: "" };
+var REDIRECT_FOUND = 302;
+function createIslandContainer(descriptor, options = {}) {
+  var _a, _b, _c, _d, _e;
+  const { parent = getAppContainer() } = options;
+  const appLog = (_b = log.getLogger((_a = descriptor.name) != null ? _a : "app")) != null ? _b : logger;
+  const islandLog = (_c = appLog.getLogger("client")) != null ? _c : appLog;
+  try {
+    const container = parent.createChild();
+    container.bind(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") {
+      unitLogger(container, vm.token.description).debug("\u0433\u0438\u0434\u0440\u0430\u0446\u0438\u044F VM \u0438\u0437 denState");
+      instance.state.set(saved);
+    }
+  }
+}
+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);
+    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 {
+      if (request.context) {
+        container.bind(RequestContextToken).toValue(request.context);
+      }
+      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/routes.ts
+function normalizeRoutes(routes = []) {
+  return routes.map((route) => typeof route === "string" ? { source: route } : route);
+}
+function matchRoute(routes = [], pathname) {
+  for (const route of normalizeRoutes(routes)) {
+    const found = new RegExp(route.source).exec(pathname);
+    if (found !== null) {
+      return { params: decodeParams(found.groups), route };
+    }
+  }
+  return null;
+}
+function decodeParams(groups) {
+  const params = {};
+  for (const [name, value] of Object.entries(groups != null ? groups : {})) {
+    if (value === void 0) {
+      continue;
+    }
+    try {
+      params[name] = decodeURIComponent(value);
+    } catch (e) {
+      params[name] = value;
+    }
+  }
+  return params;
+}
+var REGEXP_SPECIALS = /[.*+?^${}()|[\]\\]/g;
+var PARAM_SEGMENT = /\/:([A-Za-z_$][\w$]*)/g;
+function pathPattern(pattern) {
+  return `^${pattern.replace(REGEXP_SPECIALS, "\\$&").replace(PARAM_SEGMENT, "/(?<$1>[^/]+)")}$`;
+}
+
+export {
+  isDocumentSource,
+  getAppContainer,
+  createIslandContainer,
+  hydrateIslandState,
+  activateIslandViewModels,
+  collectIslandState,
+  collectDocumentContribution,
+  resolveEagerUnits,
+  renderApp,
+  normalizeRoutes,
+  matchRoute,
+  pathPattern
+};