@foxford/den 3.0.0 → 3.1.1

package/chunk-ZOU6W6ZQ.cjs

@@ -0,0 +1,230 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkXOJ2VWX4cjs = require('./chunk-XOJ2VWX4.cjs');
+
+
+var _chunk6QV4L6R2cjs = require('./chunk-6QV4L6R2.cjs');
+
+
+
+
+var _chunkA6ZPAM6Zcjs = require('./chunk-A6ZPAM6Z.cjs');
+
+
+
+var _chunkT5QVCXVBcjs = require('./chunk-T5QVCXVB.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 = _chunkA6ZPAM6Zcjs.logger.getLogger("island:runtime")) != null ? _a : _chunkA6ZPAM6Zcjs.logger).debug("app-\u043A\u043E\u043D\u0442\u0435\u0439\u043D\u0435\u0440 \u0441\u043E\u0437\u0434\u0430\u043D");
+  }
+  return appContainer;
+}
+
+// src/island/lifecycle.ts
+var _logger = require('@foxford/logger');
+var EMPTY_ROUTE = { params: {}, pathname: "", search: "" };
+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 : _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(_0, _1) {
+  return _chunkT5QVCXVBcjs.__async.call(void 0, this, arguments, function* (container, descriptor, route = EMPTY_ROUTE) {
+    var _a;
+    yield Promise.all(
+      ((_a = descriptor.viewModels) != null ? _a : []).map((vm) => _chunkT5QVCXVBcjs.__async.call(void 0, null, null, function* () {
+        var _a2;
+        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 (${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 = _chunkT5QVCXVBcjs.__spreadValues.call(void 0, _chunkT5QVCXVBcjs.__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);
+    _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)
+      );
+    }
+  }
+}
+
+// src/island/render.ts
+var STATUS_OK = 200;
+var processSetup = /* @__PURE__ */ new WeakMap();
+function setupOnce(descriptor) {
+  const { setup } = descriptor;
+  if (!setup) {
+    return Promise.resolve();
+  }
+  let started = processSetup.get(descriptor);
+  if (!started) {
+    started = Promise.resolve(setup());
+    processSetup.set(descriptor, started);
+  }
+  return started;
+}
+function renderApp(descriptor, request) {
+  return _chunkT5QVCXVBcjs.__async.call(void 0, this, null, function* () {
+    var _a, _b;
+    yield setupOnce(descriptor);
+    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(_chunk6QV4L6R2cjs.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 { assets: descriptor.assets, 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/{define-repository-MDEWHqM7.d.cts → define-repository-CwAXed2X.d.cts}

@@ -1,4 +1,4 @@
-import { v as DefineServiceOptions, H as ServiceDefinition, w as DefineViewModelOptions, V as ViewModelDefinition, u as DefineRepositoryOptions, B as RepositoryDefinition } from './types-COwVwgzE.cjs';
+import { a as DefineServiceOptions, S as ServiceDefinition, b as DefineViewModelOptions, V as ViewModelDefinition, D as DefineRepositoryOptions, d as RepositoryDefinition } from './types-Dx5qGiwk.cjs';
 import { Token } from '@foxford/ioc';
 
 /**

package/{define-repository-Ca62_YCy.d.ts → define-repository-q_T4hqeP.d.ts}

@@ -1,4 +1,4 @@
-import { v as DefineServiceOptions, H as ServiceDefinition, w as DefineViewModelOptions, V as ViewModelDefinition, u as DefineRepositoryOptions, B as RepositoryDefinition } from './types-COwVwgzE.js';
+import { a as DefineServiceOptions, S as ServiceDefinition, b as DefineViewModelOptions, V as ViewModelDefinition, D as DefineRepositoryOptions, d as RepositoryDefinition } from './types-Dx5qGiwk.js';
 import { Token } from '@foxford/ioc';
 
 /**

package/{define-slot-Dil8Kr1A.d.ts → define-slot-Cngzae6i.d.ts}

@@ -1,4 +1,4 @@
-import { x as Definition, q as LayerDefinition } from './types-COwVwgzE.js';
+import { c as Definition, L as LayerDefinition } from './types-Dx5qGiwk.js';
 import { Container } from '@foxford/ioc';
 
 /**

package/{define-slot-BKvArA02.d.cts → define-slot-DYNCLDJY.d.cts}

@@ -1,4 +1,4 @@
-import { x as Definition, q as LayerDefinition } from './types-COwVwgzE.cjs';
+import { c as Definition, L as LayerDefinition } from './types-Dx5qGiwk.cjs';
 import { Container } from '@foxford/ioc';
 
 /**

package/define.cjs

@@ -4,15 +4,17 @@
 
 
 
-
-var _chunk5DJZZML5cjs = require('./chunk-5DJZZML5.cjs');
+var _chunkZ5BL4DJAcjs = require('./chunk-Z5BL4DJA.cjs');
 require('./chunk-C7BM4DGX.cjs');
 
 
+var _chunk6QV4L6R2cjs = require('./chunk-6QV4L6R2.cjs');
+
+
 
 
 var _chunkA6ZPAM6Zcjs = require('./chunk-A6ZPAM6Z.cjs');
-require('./chunk-XHYR3SGG.cjs');
+require('./chunk-T5QVCXVB.cjs');
 
 
 
@@ -23,4 +25,4 @@ require('./chunk-XHYR3SGG.cjs');
 
 
 
-exports.LoggerToken = _chunkA6ZPAM6Zcjs.LoggerToken; exports.SlotRegistry = _chunk5DJZZML5cjs.SlotRegistry; exports.SlotRegistryToken = _chunk5DJZZML5cjs.SlotRegistryToken; exports.defineRepository = _chunk5DJZZML5cjs.defineRepository; exports.defineService = _chunk5DJZZML5cjs.defineService; exports.defineSlot = _chunk5DJZZML5cjs.defineSlot; exports.defineViewModel = _chunk5DJZZML5cjs.defineViewModel; exports.logger = _chunkA6ZPAM6Zcjs.logger; exports.scopeLogger = _chunkA6ZPAM6Zcjs.scopeLogger;
+exports.LoggerToken = _chunkA6ZPAM6Zcjs.LoggerToken; exports.SlotRegistry = _chunkZ5BL4DJAcjs.SlotRegistry; exports.SlotRegistryToken = _chunk6QV4L6R2cjs.SlotRegistryToken; exports.defineRepository = _chunkZ5BL4DJAcjs.defineRepository; exports.defineService = _chunkZ5BL4DJAcjs.defineService; exports.defineSlot = _chunkZ5BL4DJAcjs.defineSlot; exports.defineViewModel = _chunkZ5BL4DJAcjs.defineViewModel; exports.logger = _chunkA6ZPAM6Zcjs.logger; exports.scopeLogger = _chunkA6ZPAM6Zcjs.scopeLogger;

package/define.d.cts

@@ -1,6 +1,6 @@
-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 { u as DefineRepositoryOptions, v as DefineServiceOptions, w as DefineViewModelOptions, x as Definition, B as RepositoryDefinition, H as ServiceDefinition, I as SlotEntry, J as SlotRegistry, K as SlotRegistryToken, V as ViewModelDefinition } from './types-COwVwgzE.cjs';
+export { d as defineRepository, a as defineService, b as defineViewModel } from './define-repository-CwAXed2X.cjs';
+export { D as DefineSlotOptions, S as SlotDefinition, d as defineSlot } from './define-slot-DYNCLDJY.cjs';
+export { D as DefineRepositoryOptions, a as DefineServiceOptions, b as DefineViewModelOptions, c as Definition, d as RepositoryDefinition, S as ServiceDefinition, e as SlotEntry, f as SlotRegistry, g as SlotRegistryToken, V as ViewModelDefinition } from './types-Dx5qGiwk.cjs';
 import { Token, Container } from '@foxford/ioc';
 import { HierarchicalLogger } from '@foxford/logger';
 

package/define.d.ts

@@ -1,6 +1,6 @@
-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 { u as DefineRepositoryOptions, v as DefineServiceOptions, w as DefineViewModelOptions, x as Definition, B as RepositoryDefinition, H as ServiceDefinition, I as SlotEntry, J as SlotRegistry, K as SlotRegistryToken, V as ViewModelDefinition } from './types-COwVwgzE.js';
+export { d as defineRepository, a as defineService, b as defineViewModel } from './define-repository-q_T4hqeP.js';
+export { D as DefineSlotOptions, S as SlotDefinition, d as defineSlot } from './define-slot-Cngzae6i.js';
+export { D as DefineRepositoryOptions, a as DefineServiceOptions, b as DefineViewModelOptions, c as Definition, d as RepositoryDefinition, S as ServiceDefinition, e as SlotEntry, f as SlotRegistry, g as SlotRegistryToken, V as ViewModelDefinition } from './types-Dx5qGiwk.js';
 import { Token, Container } from '@foxford/ioc';
 import { HierarchicalLogger } from '@foxford/logger';
 

package/define.js

@@ -1,18 +1,20 @@
 import {
   SlotRegistry,
-  SlotRegistryToken,
   defineRepository,
   defineService,
   defineSlot,
   defineViewModel
-} from "./chunk-WRQC6BVJ.js";
+} from "./chunk-MCN4GFEQ.js";
 import "./chunk-WBHHHICS.js";
+import {
+  SlotRegistryToken
+} from "./chunk-3RX2OSUL.js";
 import {
   LoggerToken,
   logger,
   scopeLogger
 } from "./chunk-TPBI6TOU.js";
-import "./chunk-HJO26HIQ.js";
+import "./chunk-6FNC3XMI.js";
 export {
   LoggerToken,
   SlotRegistry,

package/den.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+
+import { spawn } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+// Запускатель команды: выбирает, что исполнять, и больше ничего не делает.
+//
+// Сама команда лежит в `src/bin/den.ts` и проходит гейты пакета — разбор аргументов это код,
+// и типизироваться он обязан. Здесь только развилка, и нужна она потому, что пакет живёт в двух
+// видах: в воркспейсе `exports` ведут на `src/*.ts`, и команде нужен TS-рантайм; в артефакте
+// рядом лежит собранный модуль.
+//
+// Развилка по НАЛИЧИЮ исходника, а не по переменной окружения: спрашивать у человека, в каком
+// виде стоит пакет, незачем — это видно.
+//
+// Шебанг один на оба вида (`node`), TS-рантайм подключается аргументом. Поэтому переписывать
+// шебанг на сборке не нужно: файл уезжает в артефакт как есть.
+//
+// Сигналы пробрасываются вниз, и запуск асинхронный именно ради этого: `den dev` держит поднятым
+// дочерний процесс приложения, а синхронный запуск обработчиков не пускает — сигнал убил бы
+// запускатель, оставив команду и её процесс висеть на порту. В терминале это незаметно (Ctrl+C
+// идёт всей группе), а супервизор шлёт сигнал по одному PID.
+
+const dir = path.dirname(fileURLToPath(import.meta.url))
+const source = path.join(dir, '..', 'src', 'bin', 'den.ts')
+
+const target = existsSync(source)
+  ? ['--import', createRequire(import.meta.url).resolve('tsx'), source]
+  : [path.join(dir, 'bin', 'den.js')]
+
+// `detached` — не для отвязки, а ради ГРУППЫ процессов: ребёнок становится её лидером, и сигнал
+// уходит всей группе, включая внуков. Убивать одного прямого ребёнка недостаточно — между нами
+// и командой может встать ещё один процесс (TS-рантайм), и тогда внук переживает сигнал,
+// продолжая держать наблюдателей файловой системы.
+const child = spawn(process.execPath, [...target, ...process.argv.slice(2)], {
+  detached: true,
+  stdio: 'inherit',
+})
+
+function killGroup(signal) {
+  try {
+    process.kill(-child.pid, signal)
+  } catch {
+    // Группы уже нет — значит и убивать некого
+  }
+}
+
+for (const signal of ['SIGINT', 'SIGTERM']) {
+  process.on(signal, () => killGroup(signal))
+}
+
+// Последняя сетка: выход не по сигналу тоже не должен оставлять группу висеть
+process.on('exit', () => killGroup('SIGTERM'))
+
+child.on('exit', (code, signal) => {
+  process.exit(signal === null ? code ?? 1 : 1)
+})

package/descriptor-DQ6Gi7A_.d.ts

@@ -0,0 +1,98 @@
+import { S as SlotDefinition } from './define-slot-Cngzae6i.js';
+import { L as LayerDefinition, c as Definition } from './types-Dx5qGiwk.js';
+import { Token } from '@foxford/ioc';
+
+/**
+ * Дескриптор острова — что ядру нужно, чтобы остров прожил свой цикл.
+ *
+ * `view` типизирован как `unknown` по той же причине, что и в `defineSlot`: остров не
+ * прибит к React. Ядро собирает контейнер, гидрирует VM и ведёт учёт, ни разу не заглянув
+ * во view; красит его view-адаптер (`ViewAdapter.createIsland`), и он же знает, дерево
+ * какого фреймворка перед ним.
+ *
+ * Дескрипторы страниц у хостов (`PageDescriptor` в `@foxford/den-vike` и `@foxford/den-next`)
+ * шире: у каждого своя часть про оркестрацию — `load`, `routes`, `provides`/`requires`,
+ * вклад в документ. Сводить их в один тип нечем, оркестраторы у хостов разные. Общее
+ * ровно это, и структурная типизация делает остальное: дескриптор хоста подходит сюда как есть.
+ */
+interface IslandDescriptor {
+    /**
+     * Имя мини-приложения (`market-app`).
+     *
+     * Работает дважды: корень именованного иерархического логгера (ядро биндит по нему
+     * scope-логгер в контейнер острова, поэтому регистрация единиц логируется под именем
+     * приложения) и пространство имён для адресов его слотов (см. `slotAddress`). Из-за
+     * второго оно обязательное: без него у мест приложения не было бы адреса.
+     */
+    name: string;
+    /** Непрозрачная ссылка на view острова (компонент view-фреймворка). */
+    view: unknown;
+    /**
+     * View-слой — чем остров рисовать: `defineLayer(ViewLayerToken, { adapter: reactAdapter() })`.
+     *
+     * Обязателен, и дефолта нет ни у ядра, ни у хоста: фреймворк за приложение не выбирают.
+     * Слой регистрируется в контейнере острова, поэтому слоты внутри по умолчанию рисуются
+     * им же; слот перекрывает выбор своим `viewLayer`.
+     */
+    viewLayer: LayerDefinition;
+    /**
+     * Data/Business единицы (repository/service). Регистрируются в контейнере острова.
+     * Не должны импортировать VM.
+     */
+    units: ReadonlyArray<Definition<unknown>>;
+    /**
+     * VM-единицы: регистрируются только в острове — оркестратор их не читает, состояние
+     * ездит через denState.
+     */
+    viewModels?: ReadonlyArray<Definition<unknown>>;
+    /**
+     * Единицы, которые обязаны жить с загрузки, а не с первого резолва.
+     *
+     * Регистрация ленива по природе: не спросили — не создали. Обычно это то, что нужно, но
+     * сервису, который сам на что-то подписывается или греет кэш, ждать первого потребителя
+     * незачем. Токены — из тех же `units`.
+     *
+     * Поднимаются при МОНТИРОВАНИИ острова, а не при сборке контейнера: контейнер строится и на
+     * сервере, а сервер живёт один рендер — открытая там WS-подписка это не «eager», а утечка.
+     * Серверное состояние приложения считает активация VM.
+     */
+    eager?: ReadonlyArray<Token<unknown>>;
+    /**
+     * Места расширения приложения: ключ — локальное имя слота, значение — `defineSlot`.
+     *
+     * Карта, а не массив, потому что имя даёт хозяин места: адрес получается `app:key`
+     * (см. `slotAddress`), занять чужое пространство имён нечем, а руками писать префикс
+     * не нужно. Единицы слотов регистрируются в контейнере острова вместе с его собственными.
+     */
+    slots?: Readonly<Record<string, SlotDefinition>>;
+    /**
+     * Настройка процесса перед первым рендером: разбор разметки, полифиллы, всё, что ставится
+     * один раз и нужно раньше приложения.
+     *
+     * В исходниках приложения этого поля нет — оно объявляется конфигом и вплавляется сборкой
+     * в СЕРВЕРНЫЙ выход, поэтому дескриптор остаётся декларацией. Гарантию даёт движок
+     * ({@link renderApp} зовёт настройку один раз на процесс и дожидается её), а не приложение:
+     * ждать её в активации VM пришлось бы каждому, а у приложения в процессе хоста и вовсе
+     * нет обвязки, которая могла бы дождаться.
+     */
+    setup?: () => void | Promise<void>;
+    /**
+     * Ссылки на клиентские артефакты приложения — их подключает к документу хост.
+     *
+     * Тоже вплавляются сборкой: адреса известны только ей. Байты приложение не отдаёт ни в
+     * одном транспорте — за доставку отвечает CDN.
+     */
+    assets?: AppAssets;
+}
+/**
+ * Клиентские артефакты приложения: только initial-чанки, в порядке подключения.
+ *
+ * Ленивые чанки сюда не попадают — их браузер дотянет сам по мере надобности, а хосту
+ * нужно ровно то, без чего страница не оживёт.
+ */
+interface AppAssets {
+    css: string[];
+    js: string[];
+}
+
+export type { AppAssets as A, IslandDescriptor as I };

package/descriptor-Dujg_1on.d.cts

@@ -0,0 +1,98 @@
+import { S as SlotDefinition } from './define-slot-DYNCLDJY.cjs';
+import { L as LayerDefinition, c as Definition } from './types-Dx5qGiwk.cjs';
+import { Token } from '@foxford/ioc';
+
+/**
+ * Дескриптор острова — что ядру нужно, чтобы остров прожил свой цикл.
+ *
+ * `view` типизирован как `unknown` по той же причине, что и в `defineSlot`: остров не
+ * прибит к React. Ядро собирает контейнер, гидрирует VM и ведёт учёт, ни разу не заглянув
+ * во view; красит его view-адаптер (`ViewAdapter.createIsland`), и он же знает, дерево
+ * какого фреймворка перед ним.
+ *
+ * Дескрипторы страниц у хостов (`PageDescriptor` в `@foxford/den-vike` и `@foxford/den-next`)
+ * шире: у каждого своя часть про оркестрацию — `load`, `routes`, `provides`/`requires`,
+ * вклад в документ. Сводить их в один тип нечем, оркестраторы у хостов разные. Общее
+ * ровно это, и структурная типизация делает остальное: дескриптор хоста подходит сюда как есть.
+ */
+interface IslandDescriptor {
+    /**
+     * Имя мини-приложения (`market-app`).
+     *
+     * Работает дважды: корень именованного иерархического логгера (ядро биндит по нему
+     * scope-логгер в контейнер острова, поэтому регистрация единиц логируется под именем
+     * приложения) и пространство имён для адресов его слотов (см. `slotAddress`). Из-за
+     * второго оно обязательное: без него у мест приложения не было бы адреса.
+     */
+    name: string;
+    /** Непрозрачная ссылка на view острова (компонент view-фреймворка). */
+    view: unknown;
+    /**
+     * View-слой — чем остров рисовать: `defineLayer(ViewLayerToken, { adapter: reactAdapter() })`.
+     *
+     * Обязателен, и дефолта нет ни у ядра, ни у хоста: фреймворк за приложение не выбирают.
+     * Слой регистрируется в контейнере острова, поэтому слоты внутри по умолчанию рисуются
+     * им же; слот перекрывает выбор своим `viewLayer`.
+     */
+    viewLayer: LayerDefinition;
+    /**
+     * Data/Business единицы (repository/service). Регистрируются в контейнере острова.
+     * Не должны импортировать VM.
+     */
+    units: ReadonlyArray<Definition<unknown>>;
+    /**
+     * VM-единицы: регистрируются только в острове — оркестратор их не читает, состояние
+     * ездит через denState.
+     */
+    viewModels?: ReadonlyArray<Definition<unknown>>;
+    /**
+     * Единицы, которые обязаны жить с загрузки, а не с первого резолва.
+     *
+     * Регистрация ленива по природе: не спросили — не создали. Обычно это то, что нужно, но
+     * сервису, который сам на что-то подписывается или греет кэш, ждать первого потребителя
+     * незачем. Токены — из тех же `units`.
+     *
+     * Поднимаются при МОНТИРОВАНИИ острова, а не при сборке контейнера: контейнер строится и на
+     * сервере, а сервер живёт один рендер — открытая там WS-подписка это не «eager», а утечка.
+     * Серверное состояние приложения считает активация VM.
+     */
+    eager?: ReadonlyArray<Token<unknown>>;
+    /**
+     * Места расширения приложения: ключ — локальное имя слота, значение — `defineSlot`.
+     *
+     * Карта, а не массив, потому что имя даёт хозяин места: адрес получается `app:key`
+     * (см. `slotAddress`), занять чужое пространство имён нечем, а руками писать префикс
+     * не нужно. Единицы слотов регистрируются в контейнере острова вместе с его собственными.
+     */
+    slots?: Readonly<Record<string, SlotDefinition>>;
+    /**
+     * Настройка процесса перед первым рендером: разбор разметки, полифиллы, всё, что ставится
+     * один раз и нужно раньше приложения.
+     *
+     * В исходниках приложения этого поля нет — оно объявляется конфигом и вплавляется сборкой
+     * в СЕРВЕРНЫЙ выход, поэтому дескриптор остаётся декларацией. Гарантию даёт движок
+     * ({@link renderApp} зовёт настройку один раз на процесс и дожидается её), а не приложение:
+     * ждать её в активации VM пришлось бы каждому, а у приложения в процессе хоста и вовсе
+     * нет обвязки, которая могла бы дождаться.
+     */
+    setup?: () => void | Promise<void>;
+    /**
+     * Ссылки на клиентские артефакты приложения — их подключает к документу хост.
+     *
+     * Тоже вплавляются сборкой: адреса известны только ей. Байты приложение не отдаёт ни в
+     * одном транспорте — за доставку отвечает CDN.
+     */
+    assets?: AppAssets;
+}
+/**
+ * Клиентские артефакты приложения: только initial-чанки, в порядке подключения.
+ *
+ * Ленивые чанки сюда не попадают — их браузер дотянет сам по мере надобности, а хосту
+ * нужно ровно то, без чего страница не оживёт.
+ */
+interface AppAssets {
+    css: string[];
+    js: string[];
+}
+
+export type { AppAssets as A, IslandDescriptor as I };