@foxford/den 3.0.0 → 3.1.1

package/serve/index.d.ts

@@ -0,0 +1,60 @@
+import { I as IslandDescriptor } from '../descriptor-DQ6Gi7A_.js';
+import { A as AppRoute } from '../routes-0uXJ0fux.js';
+import { FastifyPluginAsync, FastifyInstance } from 'fastify';
+import '../define-slot-Cngzae6i.js';
+import '../types-Dx5qGiwk.js';
+import '@foxford/ioc';
+
+/** Приложение, которое можно поднять сервисом: остров плюс его заявка на адреса. */
+type ServableApp = IslandDescriptor & {
+    routes?: ReadonlyArray<AppRoute>;
+};
+/** Настройки плагина. */
+interface AppPluginOptions {
+    app: ServableApp;
+    /** Порог, выше которого рендер считается медленным и уходит в `warn`, мс. */
+    slowRenderMs?: number;
+}
+/**
+ * Регистрирует ручки приложения на инстансе fastify: `/_render`, `/_routes`, `/_health`.
+ *
+ * Плагином, поэтому монтируется и в свой сервер, и в чужой — под префиксом, рядом с ручками
+ * потребителя, вместе с его плагинами.
+ *
+ * @param instance - Инстанс fastify
+ * @param options - Приложение и порог медленного рендера
+ */
+declare const appPlugin: FastifyPluginAsync<AppPluginOptions>;
+
+/** Настройки инстанса. */
+interface ServeAppOptions {
+    /** Порт; `0` — свободный, фактический смотри в `server.addresses()`. */
+    port?: number;
+    /** Интерфейс прослушивания. */
+    host?: string;
+    /** Порог, выше которого рендер считается медленным и уходит в `warn`, мс. */
+    slowRenderMs?: number;
+    /**
+     * Расширение инстанса ДО прослушивания: сюда потребитель регистрирует свои плагины.
+     * Вызывается после ручек приложения, поэтому хуки видят и их.
+     */
+    configure?: (instance: FastifyInstance) => void | Promise<void>;
+    /**
+     * Закрывать инстанс по `SIGTERM`/`SIGINT`. По умолчанию да: сервис живёт в оркестраторе,
+     * который именно так и просит его уйти, а незакрытый инстанс рвёт запросы на середине.
+     */
+    gracefulShutdown?: boolean;
+}
+/**
+ * Поднимает приложение отдельным сервисом.
+ *
+ * Сахар над {@link appPlugin}: если сервер нужен свой (общий порт с чужими ручками, свой
+ * порядок плагинов), бери плагин и регистрируй сам.
+ *
+ * @param app - Дескриптор приложения вместе с его заявкой на адреса
+ * @param options - Порт, расширение инстанса, поведение при остановке
+ * @returns Слушающий инстанс fastify
+ */
+declare function serveApp(app: ServableApp, options?: ServeAppOptions): Promise<FastifyInstance>;
+
+export { type AppPluginOptions, type ServableApp, type ServeAppOptions, appPlugin, serveApp };

package/serve/index.js

@@ -0,0 +1,137 @@
+import {
+  matchRoute,
+  normalizeRoutes,
+  renderApp
+} from "../chunk-TPHJUDHG.js";
+import "../chunk-E23E2VUC.js";
+import "../chunk-3RX2OSUL.js";
+import {
+  logger
+} from "../chunk-TPBI6TOU.js";
+import {
+  __async
+} from "../chunk-6FNC3XMI.js";
+
+// src/serve/index.ts
+import Fastify from "fastify";
+import { log as log2 } from "@foxford/logger";
+
+// src/serve/plugin.ts
+import { log } from "@foxford/logger";
+var DEFAULT_SLOW_RENDER_MS = 1e3;
+function claim(app) {
+  return normalizeRoutes(app.routes).map((route) => route.source);
+}
+function matchClaim(app, pathname) {
+  var _a, _b;
+  if (claim(app).length === 0) {
+    return {};
+  }
+  return (_b = (_a = matchRoute(app.routes, pathname)) == null ? void 0 : _a.params) != null ? _b : null;
+}
+function parseCookies(header) {
+  const cookies = {};
+  for (const part of (header != null ? header : "").split(";")) {
+    const eq = part.indexOf("=");
+    if (eq < 1) {
+      continue;
+    }
+    const name = part.slice(0, eq).trim();
+    if (name && !(name in cookies)) {
+      cookies[name] = part.slice(eq + 1).trim();
+    }
+  }
+  return cookies;
+}
+function browserContext(req) {
+  const headers = {};
+  const forwarded = {
+    "accept-language": req.headers["x-forwarded-accept-language"],
+    host: req.headers["x-forwarded-host"]
+  };
+  for (const [name, value] of Object.entries(forwarded)) {
+    if (typeof value === "string" && value !== "") {
+      headers[name] = value;
+    }
+  }
+  const cookie = req.headers.cookie;
+  if (typeof cookie === "string" && cookie !== "") {
+    headers.cookie = cookie;
+  }
+  return { cookies: parseCookies(cookie), headers };
+}
+var appPlugin = (instance, options) => {
+  var _a, _b;
+  const { app, slowRenderMs = DEFAULT_SLOW_RENDER_MS } = options;
+  const appLog = (_a = log.getLogger(app.name)) != null ? _a : logger;
+  const serveLog = (_b = appLog.getLogger("serve")) != null ? _b : appLog;
+  instance.get("/_health", () => "ok");
+  instance.get("/_routes", (_req, reply) => {
+    void reply.header("cache-control", "no-store");
+    return claim(app);
+  });
+  instance.get("/_render", (req, reply) => __async(null, null, function* () {
+    const target = req.query.url;
+    if (typeof target !== "string" || !target.startsWith("/")) {
+      return reply.code(400).send({ error: "\u043D\u0435 \u043F\u0435\u0440\u0435\u0434\u0430\u043D \u0438\u043B\u0438 \u043D\u0435\u0432\u0430\u043B\u0438\u0434\u0435\u043D \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440 url" });
+    }
+    const { pathname, search } = new URL(target, "http://localhost");
+    const params = matchClaim(app, pathname);
+    if (params === null) {
+      serveLog.error(`\u043F\u0443\u0442\u044C \xAB${pathname}\xBB \u0432\u043D\u0435 \u0437\u0430\u044F\u0432\u043A\u0438 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u044F`);
+      return reply.code(404).send({ error: `\u043F\u0443\u0442\u044C \xAB${pathname}\xBB \u0432\u043D\u0435 \u0437\u0430\u044F\u0432\u043A\u0438 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u044F` });
+    }
+    const startedAt = Date.now();
+    try {
+      const result = yield renderApp(app, { context: browserContext(req), params, pathname, search });
+      const elapsed = Date.now() - startedAt;
+      if (elapsed >= slowRenderMs) {
+        serveLog.warn(`\u043C\u0435\u0434\u043B\u0435\u043D\u043D\u044B\u0439 \u0440\u0435\u043D\u0434\u0435\u0440 \xAB${pathname}\xBB: ${String(elapsed)}\u043C\u0441`);
+      }
+      return result;
+    } catch (error) {
+      serveLog.error(`\u0440\u0435\u043D\u0434\u0435\u0440 \xAB${pathname}\xBB \u0443\u043F\u0430\u043B \u0437\u0430 ${String(Date.now() - startedAt)}\u043C\u0441`, error);
+      return reply.code(500).send({ error: error instanceof Error ? error.message : String(error) });
+    }
+  }));
+  return Promise.resolve();
+};
+
+// src/serve/index.ts
+var SHUTDOWN_SIGNALS = ["SIGTERM", "SIGINT"];
+function serveApp(_0) {
+  return __async(this, arguments, function* (app, options = {}) {
+    var _a, _b, _c, _d;
+    const appLog = (_a = log2.getLogger(app.name)) != null ? _a : logger;
+    const serveLog = (_b = appLog.getLogger("serve")) != null ? _b : appLog;
+    const instance = Fastify({ logger: false });
+    yield instance.register(appPlugin, { app, slowRenderMs: options.slowRenderMs });
+    instance.addHook("onRequest", (req, _reply, done) => {
+      serveLog.debug(`\u2192 ${req.method} ${req.url}`);
+      done();
+    });
+    instance.addHook("onResponse", (req, reply, done) => {
+      const elapsed = reply.elapsedTime.toFixed(1);
+      serveLog.info(`\u2190 ${String(reply.statusCode)} ${req.method} ${req.url} ${elapsed}\u043C\u0441`);
+      done();
+    });
+    yield (_c = options.configure) == null ? void 0 : _c.call(options, instance);
+    yield instance.listen({ host: options.host, port: (_d = options.port) != null ? _d : 0 });
+    if (options.gracefulShutdown !== false) {
+      for (const signal of SHUTDOWN_SIGNALS) {
+        process.once(signal, () => {
+          serveLog.info(`${signal}: \u0437\u0430\u043A\u0440\u044B\u0432\u0430\u044E \u0438\u043D\u0441\u0442\u0430\u043D\u0441`);
+          void instance.close();
+        });
+      }
+    }
+    serveLog.info(
+      `\u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u0435 \xAB${app.name}\xBB \u0441\u043B\u0443\u0448\u0430\u0435\u0442 ${instance.addresses().map((a) => String(a.port)).join(", ")}`
+    );
+    return instance;
+  });
+}
+export {
+  appPlugin,
+  serveApp
+};

package/server-render-CocWXQKC.d.cts

@@ -0,0 +1,48 @@
+/** Что приложение отдало серверным рендером. */
+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 { RenderTree as R, ServerRenderResult as S, ServerRender as a };

package/server-render-CocWXQKC.d.ts

@@ -0,0 +1,48 @@
+/** Что приложение отдало серверным рендером. */
+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 { RenderTree as R, ServerRenderResult as S, ServerRender as a };

package/{types-COwVwgzE.d.cts → types-Dx5qGiwk.d.cts}

@@ -774,4 +774,4 @@ declare const ActivatableToken: Token<Activatable>;
  */
 declare const RequestContextToken: Token<RequestContext>;
 
-export { type ActionGuard as A, type RepositoryDefinition as B, type Core as C, type Disposable as D, type ExtensionConfig as E, RequestContextToken as F, type GuardRunner as G, type ServiceDefinition as H, type SlotEntry as I, SlotRegistry as J, SlotRegistryToken as K, type LeaveGuardResult as L, StateCache as M, type NavigationManager as N, type StateParticipant as O, StateRegistry as P, StateRegistryToken as Q, type RequestContext as R, type StateSerializer as S, StateSerializerToken as T, type ViewModelDefinition as V, type ContainerManager as a, type Guard as b, type GuardResult as c, type NavigationEntry as d, type NavigationInterceptor as e, type DefineGuardOptions as f, type GuardDefinition as g, type DefineExtensionOptions as h, type ExtensionDefinition as i, type DefineActionGuardOptions as j, type ActionGuardDefinition as k, type LayoutConfig as l, type DefineLayoutOptions as m, type LayoutDefinition as n, type LayerConfig as o, type DefineLayerOptions as p, type LayerDefinition as q, type Activatable as r, ActivatableToken as s, ContainerManagerToken as t, type DefineRepositoryOptions as u, type DefineServiceOptions as v, type DefineViewModelOptions as w, type Definition as x, GuardRunnerToken as y, NavigationManagerToken as z };
+export { type ActionGuard as A, type Activatable as B, type Core as C, type DefineRepositoryOptions as D, type ExtensionConfig as E, ActivatableToken as F, type GuardDefinition as G, ContainerManagerToken as H, GuardRunnerToken as I, NavigationManagerToken as J, RequestContextToken as K, type LayerDefinition as L, StateCache as M, type NavigationManager as N, type StateParticipant as O, StateRegistry as P, StateRegistryToken as Q, type RequestContext as R, type ServiceDefinition as S, StateSerializerToken as T, type ViewModelDefinition as V, type DefineServiceOptions as a, type DefineViewModelOptions as b, type Definition as c, type RepositoryDefinition as d, type SlotEntry as e, SlotRegistry as f, SlotRegistryToken as g, type LayerConfig as h, type ContainerManager as i, type GuardRunner as j, type Guard as k, type GuardResult as l, type NavigationEntry as m, type NavigationInterceptor as n, type Disposable as o, type LeaveGuardResult as p, type StateSerializer as q, type DefineGuardOptions as r, type DefineExtensionOptions as s, type ExtensionDefinition as t, type DefineActionGuardOptions as u, type ActionGuardDefinition as v, type LayoutConfig as w, type DefineLayoutOptions as x, type LayoutDefinition as y, type DefineLayerOptions as z };

package/{types-COwVwgzE.d.ts → types-Dx5qGiwk.d.ts}

@@ -774,4 +774,4 @@ declare const ActivatableToken: Token<Activatable>;
  */
 declare const RequestContextToken: Token<RequestContext>;
 
-export { type ActionGuard as A, type RepositoryDefinition as B, type Core as C, type Disposable as D, type ExtensionConfig as E, RequestContextToken as F, type GuardRunner as G, type ServiceDefinition as H, type SlotEntry as I, SlotRegistry as J, SlotRegistryToken as K, type LeaveGuardResult as L, StateCache as M, type NavigationManager as N, type StateParticipant as O, StateRegistry as P, StateRegistryToken as Q, type RequestContext as R, type StateSerializer as S, StateSerializerToken as T, type ViewModelDefinition as V, type ContainerManager as a, type Guard as b, type GuardResult as c, type NavigationEntry as d, type NavigationInterceptor as e, type DefineGuardOptions as f, type GuardDefinition as g, type DefineExtensionOptions as h, type ExtensionDefinition as i, type DefineActionGuardOptions as j, type ActionGuardDefinition as k, type LayoutConfig as l, type DefineLayoutOptions as m, type LayoutDefinition as n, type LayerConfig as o, type DefineLayerOptions as p, type LayerDefinition as q, type Activatable as r, ActivatableToken as s, ContainerManagerToken as t, type DefineRepositoryOptions as u, type DefineServiceOptions as v, type DefineViewModelOptions as w, type Definition as x, GuardRunnerToken as y, NavigationManagerToken as z };
+export { type ActionGuard as A, type Activatable as B, type Core as C, type DefineRepositoryOptions as D, type ExtensionConfig as E, ActivatableToken as F, type GuardDefinition as G, ContainerManagerToken as H, GuardRunnerToken as I, NavigationManagerToken as J, RequestContextToken as K, type LayerDefinition as L, StateCache as M, type NavigationManager as N, type StateParticipant as O, StateRegistry as P, StateRegistryToken as Q, type RequestContext as R, type ServiceDefinition as S, StateSerializerToken as T, type ViewModelDefinition as V, type DefineServiceOptions as a, type DefineViewModelOptions as b, type Definition as c, type RepositoryDefinition as d, type SlotEntry as e, SlotRegistry as f, SlotRegistryToken as g, type LayerConfig as h, type ContainerManager as i, type GuardRunner as j, type Guard as k, type GuardResult as l, type NavigationEntry as m, type NavigationInterceptor as n, type Disposable as o, type LeaveGuardResult as p, type StateSerializer as q, type DefineGuardOptions as r, type DefineExtensionOptions as s, type ExtensionDefinition as t, type DefineActionGuardOptions as u, type ActionGuardDefinition as v, type LayoutConfig as w, type DefineLayoutOptions as x, type LayoutDefinition as y, type DefineLayerOptions as z };

package/view-adapter-B4gEb-ms.d.ts

@@ -0,0 +1,77 @@
+import { I as IslandDescriptor } from './descriptor-DQ6Gi7A_.js';
+import { S as ServerRenderResult } from './server-render-CocWXQKC.js';
+import { L as LayerDefinition, h as LayerConfig } from './types-Dx5qGiwk.js';
+import { Container, Token } from '@foxford/ioc';
+
+/** Что нужно адаптеру, чтобы отрисовать остров на сервере. */
+interface RenderIslandOptions {
+    /** Контейнер острова — уже собранный, с активированными VM. */
+    container: Container;
+    /** Внешние заполнители слотов; для ядра непрозрачны, как и само дерево. */
+    slots?: Record<string, unknown>;
+}
+/**
+ * Порт view-адаптера. Реализуется пакетом фреймворка (`@foxford/den-react` и его аналоги),
+ * объявляется приложением через `defineLayer(ViewLayerToken, { adapter })`.
+ */
+interface ViewAdapter {
+    /** Имя фреймворка (`react`, `vue`) — для диагностики и сообщений об ошибках. */
+    readonly type: string;
+    /**
+     * Компонент острова для этого фреймворка: драйвит жизненный цикл ядра своими средствами
+     * (у React — хуки, у Vue — `setup`) и рисует `descriptor.view`.
+     *
+     * @param descriptor - Дескриптор острова
+     * @returns Компонент фреймворка — для ядра непрозрачен
+     */
+    createIsland(descriptor: IslandDescriptor): unknown;
+    /**
+     * Отрисовывает остров в разметку на сервере.
+     *
+     * Единственная операция острова, которую ядро не может сделать само: `renderToString` —
+     * функция конкретного фреймворка, а ядро view-агностично. Здесь же адаптер исполняет
+     * `serverRender` приложения, если тот объявлен, — тип дерева известен только адаптеру.
+     *
+     * @param descriptor - Дескриптор острова
+     * @param options - Контейнер острова и заполнители слотов
+     * @returns Разметка и вклад в `<head>` готовой разметкой
+     */
+    renderIsland(descriptor: IslandDescriptor, options: RenderIslandOptions): ServerRenderResult;
+    /**
+     * Ставит стратегию резолва `define*` во view (`installResolver` из `@foxford/den/adapter`).
+     * У каждого фреймворка она своя: у React — хук поверх контекста контейнера, у Vue —
+     * `inject`. Зовёт хост при инициализации трека.
+     */
+    installResolver(): void;
+}
+/**
+ * Канонический токен view-слоя.
+ *
+ * Живёт в ядре именно потому, что «мы знаем, что зарегистрировано» работает лишь тогда,
+ * когда токен один на всех: заведи его каждое приложение у себя — и движок не найдёт
+ * чужую регистрацию.
+ */
+declare const ViewLayerToken: Token<LayerConfig>;
+/** View-слой приложения — результат `defineLayer(ViewLayerToken, { adapter })`. */
+type ViewLayerDefinition = LayerDefinition;
+/**
+ * Достаёт адаптер из объявленного приложением view-слоя.
+ *
+ * @param layer - View-слой (`defineLayer(ViewLayerToken, { adapter })`)
+ * @returns Адаптер view-фреймворка
+ * @throws Если слой объявлен без адаптера или адаптер не закрывает порт
+ */
+declare function viewAdapterOf(layer: ViewLayerDefinition): ViewAdapter;
+/**
+ * Достаёт адаптер из контейнера — с подъёмом по parent-chain, как это делает резолв во view.
+ *
+ * Нужен там, где на руках только контейнер (например, отрисовка слота внутри острова).
+ * Дефолта нет намеренно: фреймворк за приложение ядро не выбирает.
+ *
+ * @param container - Контейнер острова/страницы
+ * @returns Адаптер view-фреймворка
+ * @throws Если приложение не объявило view-слой
+ */
+declare function resolveViewAdapter(container: Container): ViewAdapter;
+
+export { type RenderIslandOptions as R, type ViewAdapter as V, type ViewLayerDefinition as a, ViewLayerToken as b, resolveViewAdapter as r, viewAdapterOf as v };

package/view-adapter-DJ7yB6Ml.d.cts

@@ -0,0 +1,77 @@
+import { I as IslandDescriptor } from './descriptor-Dujg_1on.cjs';
+import { S as ServerRenderResult } from './server-render-CocWXQKC.cjs';
+import { L as LayerDefinition, h as LayerConfig } from './types-Dx5qGiwk.cjs';
+import { Container, Token } from '@foxford/ioc';
+
+/** Что нужно адаптеру, чтобы отрисовать остров на сервере. */
+interface RenderIslandOptions {
+    /** Контейнер острова — уже собранный, с активированными VM. */
+    container: Container;
+    /** Внешние заполнители слотов; для ядра непрозрачны, как и само дерево. */
+    slots?: Record<string, unknown>;
+}
+/**
+ * Порт view-адаптера. Реализуется пакетом фреймворка (`@foxford/den-react` и его аналоги),
+ * объявляется приложением через `defineLayer(ViewLayerToken, { adapter })`.
+ */
+interface ViewAdapter {
+    /** Имя фреймворка (`react`, `vue`) — для диагностики и сообщений об ошибках. */
+    readonly type: string;
+    /**
+     * Компонент острова для этого фреймворка: драйвит жизненный цикл ядра своими средствами
+     * (у React — хуки, у Vue — `setup`) и рисует `descriptor.view`.
+     *
+     * @param descriptor - Дескриптор острова
+     * @returns Компонент фреймворка — для ядра непрозрачен
+     */
+    createIsland(descriptor: IslandDescriptor): unknown;
+    /**
+     * Отрисовывает остров в разметку на сервере.
+     *
+     * Единственная операция острова, которую ядро не может сделать само: `renderToString` —
+     * функция конкретного фреймворка, а ядро view-агностично. Здесь же адаптер исполняет
+     * `serverRender` приложения, если тот объявлен, — тип дерева известен только адаптеру.
+     *
+     * @param descriptor - Дескриптор острова
+     * @param options - Контейнер острова и заполнители слотов
+     * @returns Разметка и вклад в `<head>` готовой разметкой
+     */
+    renderIsland(descriptor: IslandDescriptor, options: RenderIslandOptions): ServerRenderResult;
+    /**
+     * Ставит стратегию резолва `define*` во view (`installResolver` из `@foxford/den/adapter`).
+     * У каждого фреймворка она своя: у React — хук поверх контекста контейнера, у Vue —
+     * `inject`. Зовёт хост при инициализации трека.
+     */
+    installResolver(): void;
+}
+/**
+ * Канонический токен view-слоя.
+ *
+ * Живёт в ядре именно потому, что «мы знаем, что зарегистрировано» работает лишь тогда,
+ * когда токен один на всех: заведи его каждое приложение у себя — и движок не найдёт
+ * чужую регистрацию.
+ */
+declare const ViewLayerToken: Token<LayerConfig>;
+/** View-слой приложения — результат `defineLayer(ViewLayerToken, { adapter })`. */
+type ViewLayerDefinition = LayerDefinition;
+/**
+ * Достаёт адаптер из объявленного приложением view-слоя.
+ *
+ * @param layer - View-слой (`defineLayer(ViewLayerToken, { adapter })`)
+ * @returns Адаптер view-фреймворка
+ * @throws Если слой объявлен без адаптера или адаптер не закрывает порт
+ */
+declare function viewAdapterOf(layer: ViewLayerDefinition): ViewAdapter;
+/**
+ * Достаёт адаптер из контейнера — с подъёмом по parent-chain, как это делает резолв во view.
+ *
+ * Нужен там, где на руках только контейнер (например, отрисовка слота внутри острова).
+ * Дефолта нет намеренно: фреймворк за приложение ядро не выбирает.
+ *
+ * @param container - Контейнер острова/страницы
+ * @returns Адаптер view-фреймворка
+ * @throws Если приложение не объявило view-слой
+ */
+declare function resolveViewAdapter(container: Container): ViewAdapter;
+
+export { type RenderIslandOptions as R, type ViewAdapter as V, type ViewLayerDefinition as a, ViewLayerToken as b, resolveViewAdapter as r, viewAdapterOf as v };