@foxford/den 3.0.0 → 3.1.0

package/chunk-CZVYVNLI.cjs

@@ -0,0 +1,45 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/core/types.ts
+var _ioc = require('@foxford/ioc');
+var ContainerManagerToken = _ioc.createToken.call(void 0, "core:ContainerManager");
+var GuardRunnerToken = _ioc.createToken.call(void 0, "core:GuardRunner");
+var NavigationManagerToken = _ioc.createToken.call(void 0, "core:NavigationManager");
+var StateSerializerToken = _ioc.createToken.call(void 0, "core:StateSerializer");
+var StateRegistryToken = _ioc.createToken.call(void 0, "core:StateRegistry");
+var SlotRegistryToken = _ioc.createToken.call(void 0, "core:SlotRegistry");
+var ActivatableToken = _ioc.createToken.call(void 0, "core:Activatable");
+var RequestContextToken = _ioc.createToken.call(void 0, "core:RequestContext");
+
+// src/logger.ts
+
+var _logger = require('@foxford/logger');
+var logger = _logger.log.getLogger("@foxford/den");
+var LoggerToken = _ioc.createToken.call(void 0, "den:Logger");
+function scopeLogger(container) {
+  if (container.has(LoggerToken)) {
+    const resolved = container.resolve(LoggerToken);
+    if (!(resolved instanceof Promise)) {
+      return resolved;
+    }
+  }
+  return logger;
+}
+function unitLogger(container, name) {
+  var _a;
+  const base = scopeLogger(container);
+  return (_a = base.getLogger(name)) != null ? _a : base;
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.ContainerManagerToken = ContainerManagerToken; exports.GuardRunnerToken = GuardRunnerToken; exports.NavigationManagerToken = NavigationManagerToken; exports.StateSerializerToken = StateSerializerToken; exports.StateRegistryToken = StateRegistryToken; exports.SlotRegistryToken = SlotRegistryToken; exports.ActivatableToken = ActivatableToken; exports.RequestContextToken = RequestContextToken; exports.logger = logger; exports.LoggerToken = LoggerToken; exports.scopeLogger = scopeLogger; exports.unitLogger = unitLogger;

package/chunk-KJ6NDOOL.js

@@ -0,0 +1,45 @@
+// src/core/types.ts
+import { createToken } from "@foxford/ioc";
+var ContainerManagerToken = createToken("core:ContainerManager");
+var GuardRunnerToken = createToken("core:GuardRunner");
+var NavigationManagerToken = createToken("core:NavigationManager");
+var StateSerializerToken = createToken("core:StateSerializer");
+var StateRegistryToken = createToken("core:StateRegistry");
+var SlotRegistryToken = createToken("core:SlotRegistry");
+var ActivatableToken = createToken("core:Activatable");
+var RequestContextToken = createToken("core:RequestContext");
+
+// src/logger.ts
+import { createToken as createToken2 } from "@foxford/ioc";
+import { log } from "@foxford/logger";
+var logger = log.getLogger("@foxford/den");
+var LoggerToken = createToken2("den:Logger");
+function scopeLogger(container) {
+  if (container.has(LoggerToken)) {
+    const resolved = container.resolve(LoggerToken);
+    if (!(resolved instanceof Promise)) {
+      return resolved;
+    }
+  }
+  return logger;
+}
+function unitLogger(container, name) {
+  var _a;
+  const base = scopeLogger(container);
+  return (_a = base.getLogger(name)) != null ? _a : base;
+}
+
+export {
+  ContainerManagerToken,
+  GuardRunnerToken,
+  NavigationManagerToken,
+  StateSerializerToken,
+  StateRegistryToken,
+  SlotRegistryToken,
+  ActivatableToken,
+  RequestContextToken,
+  logger,
+  LoggerToken,
+  scopeLogger,
+  unitLogger
+};

package/{chunk-5DJZZML5.cjs → chunk-P4QJCHMM.cjs}

@@ -3,18 +3,9 @@
 var _chunkC7BM4DGXcjs = require('./chunk-C7BM4DGX.cjs');
 
 
-var _chunkA6ZPAM6Zcjs = require('./chunk-A6ZPAM6Z.cjs');
 
-// src/core/types.ts
-var _ioc = require('@foxford/ioc');
-var ContainerManagerToken = _ioc.createToken.call(void 0, "core:ContainerManager");
-var GuardRunnerToken = _ioc.createToken.call(void 0, "core:GuardRunner");
-var NavigationManagerToken = _ioc.createToken.call(void 0, "core:NavigationManager");
-var StateSerializerToken = _ioc.createToken.call(void 0, "core:StateSerializer");
-var StateRegistryToken = _ioc.createToken.call(void 0, "core:StateRegistry");
-var SlotRegistryToken = _ioc.createToken.call(void 0, "core:SlotRegistry");
-var ActivatableToken = _ioc.createToken.call(void 0, "core:Activatable");
-var RequestContextToken = _ioc.createToken.call(void 0, "core:RequestContext");
+
+var _chunkCZVYVNLIcjs = require('./chunk-CZVYVNLI.cjs');
 
 // src/core/slot-registry.ts
 var SlotRegistry = class {
@@ -45,7 +36,7 @@ var SlotRegistry = class {
 };
 
 // src/define-service.ts
-
+var _ioc = require('@foxford/ioc');
 function defineService(token, options) {
   const { requires, create, activate, deactivate, serialize, deserialize, scope } = options;
   const requireTokens = requires != null ? requires : [];
@@ -62,7 +53,7 @@ function defineService(token, options) {
      * @param container - Контейнер для регистрации
      */
     register(container) {
-      const unitLog = _chunkA6ZPAM6Zcjs.unitLogger.call(void 0, container, token.description);
+      const unitLog = _chunkCZVYVNLIcjs.unitLogger.call(void 0, container, token.description);
       const factory = _ioc.inject.call(void 0, requireTokens, (...args) => {
         unitLog.debug(`\u0441\u043E\u0437\u0434\u0430\u043D\u0438\u0435 \u0441\u0435\u0440\u0432\u0438\u0441\u0430 (${create ? "\u0444\u0430\u0431\u0440\u0438\u043A\u0430" : "lifecycle-\u043E\u0431\u0451\u0440\u0442\u043A\u0430"})`);
         let instance;
@@ -92,10 +83,10 @@ function defineService(token, options) {
   };
 }
 function registerStateParticipant(container, token, instance, deps, serialize, deserialize) {
-  if (!container.has(StateRegistryToken)) {
+  if (!container.has(_chunkCZVYVNLIcjs.StateRegistryToken)) {
     return;
   }
-  const resolved = container.resolve(StateRegistryToken);
+  const resolved = container.resolve(_chunkCZVYVNLIcjs.StateRegistryToken);
   if (resolved instanceof Promise) {
     return;
   }
@@ -124,7 +115,7 @@ function defineViewModel(token, options) {
      * @param container - Контейнер для регистрации
      */
     register(container) {
-      const unitLog = _chunkA6ZPAM6Zcjs.unitLogger.call(void 0, container, token.description);
+      const unitLog = _chunkCZVYVNLIcjs.unitLogger.call(void 0, container, token.description);
       const factory = _ioc.inject.call(void 0, requireTokens, (...args) => {
         unitLog.debug("\u0441\u043E\u0437\u0434\u0430\u043D\u0438\u0435 view-model");
         return create(args);
@@ -171,7 +162,7 @@ function defineRepository(token, options) {
      * @param container - Контейнер для регистрации
      */
     register(container) {
-      const unitLog = _chunkA6ZPAM6Zcjs.unitLogger.call(void 0, container, token.description);
+      const unitLog = _chunkCZVYVNLIcjs.unitLogger.call(void 0, container, token.description);
       const factory = _ioc.inject.call(void 0, requireTokens, (...args) => {
         unitLog.debug("\u0441\u043E\u0437\u0434\u0430\u043D\u0438\u0435 \u0440\u0435\u043F\u043E\u0437\u0438\u0442\u043E\u0440\u0438\u044F");
         return create(args);
@@ -188,13 +179,13 @@ function defineSlot({ view, units = [], viewLayer } = {}) {
   return {
     __type: "slot",
     register(container, name) {
-      const slotLog = _chunkA6ZPAM6Zcjs.unitLogger.call(void 0, container, `slot:${name}`);
+      const slotLog = _chunkCZVYVNLIcjs.unitLogger.call(void 0, container, `slot:${name}`);
       for (const unit of units) {
         unit.register(container);
       }
-      const registry = container.has(SlotRegistryToken) ? container.resolve(SlotRegistryToken) : (() => {
+      const registry = container.has(_chunkCZVYVNLIcjs.SlotRegistryToken) ? container.resolve(_chunkCZVYVNLIcjs.SlotRegistryToken) : (() => {
         const created = new SlotRegistry();
-        container.bind(SlotRegistryToken).toValue(created);
+        container.bind(_chunkCZVYVNLIcjs.SlotRegistryToken).toValue(created);
         slotLog.debug("\u0441\u043E\u0437\u0434\u0430\u043D SlotRegistry \u043A\u043E\u043D\u0442\u0435\u0439\u043D\u0435\u0440\u0430");
         return created;
       })();
@@ -213,12 +204,4 @@ function defineSlot({ view, units = [], viewLayer } = {}) {
 
 
 
-
-
-
-
-
-
-
-
-exports.ContainerManagerToken = ContainerManagerToken; exports.GuardRunnerToken = GuardRunnerToken; exports.NavigationManagerToken = NavigationManagerToken; exports.StateSerializerToken = StateSerializerToken; exports.StateRegistryToken = StateRegistryToken; exports.SlotRegistryToken = SlotRegistryToken; exports.ActivatableToken = ActivatableToken; exports.RequestContextToken = RequestContextToken; exports.SlotRegistry = SlotRegistry; exports.defineService = defineService; exports.defineViewModel = defineViewModel; exports.defineRepository = defineRepository; exports.defineSlot = defineSlot;
+exports.SlotRegistry = SlotRegistry; exports.defineService = defineService; exports.defineViewModel = defineViewModel; exports.defineRepository = defineRepository; exports.defineSlot = defineSlot;

package/{chunk-WRQC6BVJ.js → chunk-PZVUKTZG.js}

@@ -2,19 +2,10 @@ import {
   resolveDefinition
 } from "./chunk-WBHHHICS.js";
 import {
+  SlotRegistryToken,
+  StateRegistryToken,
   unitLogger
-} from "./chunk-TPBI6TOU.js";
-
-// src/core/types.ts
-import { createToken } from "@foxford/ioc";
-var ContainerManagerToken = createToken("core:ContainerManager");
-var GuardRunnerToken = createToken("core:GuardRunner");
-var NavigationManagerToken = createToken("core:NavigationManager");
-var StateSerializerToken = createToken("core:StateSerializer");
-var StateRegistryToken = createToken("core:StateRegistry");
-var SlotRegistryToken = createToken("core:SlotRegistry");
-var ActivatableToken = createToken("core:Activatable");
-var RequestContextToken = createToken("core:RequestContext");
+} from "./chunk-KJ6NDOOL.js";
 
 // src/core/slot-registry.ts
 var SlotRegistry = class {
@@ -208,14 +199,6 @@ function defineSlot({ view, units = [], viewLayer } = {}) {
 }
 
 export {
-  ContainerManagerToken,
-  GuardRunnerToken,
-  NavigationManagerToken,
-  StateSerializerToken,
-  StateRegistryToken,
-  SlotRegistryToken,
-  ActivatableToken,
-  RequestContextToken,
   SlotRegistry,
   defineService,
   defineViewModel,

package/define.cjs

@@ -4,14 +4,14 @@
 
 
 
-
-var _chunk5DJZZML5cjs = require('./chunk-5DJZZML5.cjs');
+var _chunkP4QJCHMMcjs = require('./chunk-P4QJCHMM.cjs');
 require('./chunk-C7BM4DGX.cjs');
 
 
 
 
-var _chunkA6ZPAM6Zcjs = require('./chunk-A6ZPAM6Z.cjs');
+
+var _chunkCZVYVNLIcjs = require('./chunk-CZVYVNLI.cjs');
 require('./chunk-XHYR3SGG.cjs');
 
 
@@ -23,4 +23,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 = _chunkCZVYVNLIcjs.LoggerToken; exports.SlotRegistry = _chunkP4QJCHMMcjs.SlotRegistry; exports.SlotRegistryToken = _chunkCZVYVNLIcjs.SlotRegistryToken; exports.defineRepository = _chunkP4QJCHMMcjs.defineRepository; exports.defineService = _chunkP4QJCHMMcjs.defineService; exports.defineSlot = _chunkP4QJCHMMcjs.defineSlot; exports.defineViewModel = _chunkP4QJCHMMcjs.defineViewModel; exports.logger = _chunkCZVYVNLIcjs.logger; exports.scopeLogger = _chunkCZVYVNLIcjs.scopeLogger;

package/define.js

@@ -1,17 +1,17 @@
 import {
   SlotRegistry,
-  SlotRegistryToken,
   defineRepository,
   defineService,
   defineSlot,
   defineViewModel
-} from "./chunk-WRQC6BVJ.js";
+} from "./chunk-PZVUKTZG.js";
 import "./chunk-WBHHHICS.js";
 import {
   LoggerToken,
+  SlotRegistryToken,
   logger,
   scopeLogger
-} from "./chunk-TPBI6TOU.js";
+} from "./chunk-KJ6NDOOL.js";
 import "./chunk-HJO26HIQ.js";
 export {
   LoggerToken,

package/den-serve.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+
+import { resolve } from 'node:path'
+import { pathToFileURL } from 'node:url'
+
+// Команда, поднимающая приложение сервисом. Ради неё потребителю не нужен свой серверный файл:
+// он объявляет дескриптор через `defineApp` и запускает `den-serve` — сервер внутрь дескриптора
+// при этом не заезжает.
+//
+// Внутрь его класть нельзя: `defineApp` импортирует ХОСТ, чтобы поднять приложение у себя в
+// процессе, и вместе с дескриптором к нему приехали бы fastify и `node:http` — в серверный
+// бандл и в браузерный. Дескриптор к тому же перестал бы быть данными, а инвариант
+// «приложение не знает своего класса» сломался бы: дескриптор, поднимающий сервер, знает,
+// что он сетевой.
+//
+// Watch внутри команды нет намеренно: приложение всё равно собирается сборщиком потребителя,
+// и он же умеет перезапускать (`tsup --watch --onSuccess "den-serve build/index.js"`). Второй
+// сторож поверх первого только путал бы.
+//
+// Обычный `.js`, а не собираемый исходник: команда должна работать одинаково из воркспейса и
+// из опубликованного пакета, а `@foxford/den/serve` — self-reference по имени пакета, поэтому
+// в обоих случаях резолвится своим `exports`.
+//
+// Shebang здесь — `tsx`, потому что в воркспейсе `exports` ведут на `src/*.ts`. В артефакт
+// файл кладётся сборкой с заменой на `node`: там те же `exports` ведут уже на собранный js
+// (см. `installCli` в tsup.config.ts).
+
+const USAGE = `den-serve <модуль> [опции]
+
+  <модуль>              путь к модулю, чей дефолтный экспорт — дескриптор приложения
+
+  --port <порт>         порт (по умолчанию PORT из окружения либо 3000)
+  --host <адрес>        интерфейс прослушивания (по умолчанию HOST либо 0.0.0.0)
+  --slow <мс>           порог медленного рендера для лога (по умолчанию 1000)
+  --configure <модуль>  модуль, чей дефолтный экспорт получает инстанс fastify до
+                        прослушивания: Sentry, метрики, cors — сюда
+  -h, --help            эта справка
+`
+
+function parseArgs(argv) {
+  const options = {}
+  let entry
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i]
+    switch (arg) {
+      case '-h':
+      case '--help':
+        return { help: true }
+      case '--port':
+      case '--host':
+      case '--slow':
+      case '--configure':
+        i += 1
+        options[arg.slice(2)] = argv[i]
+        break
+      default:
+        if (arg.startsWith('-')) {
+          throw new Error(`неизвестная опция ${arg}`)
+        }
+        if (entry !== undefined) {
+          throw new Error('модуль указывается один')
+        }
+        entry = arg
+    }
+  }
+
+  return { entry, options }
+}
+
+function fail(message) {
+  process.stderr.write(`den-serve: ${message}\n\n${USAGE}`)
+  process.exit(1)
+}
+
+/**
+ * Достаёт дескриптор из указанного модуля.
+ *
+ * Форма проверяется ДО подъёма сервера: иначе первая же ошибка вылезла бы на запросе, из
+ * середины рендера, и выглядела бы как проблема приложения, а не запуска.
+ */
+async function loadApp(entry) {
+  const module = await import(pathToFileURL(resolve(process.cwd(), entry)).href)
+  const app = module.default
+
+  if (typeof app !== 'object' || app === null || typeof app.name !== 'string') {
+    fail(`дефолтный экспорт «${entry}» не похож на дескриптор приложения`)
+  }
+
+  return app
+}
+
+/**
+ * Достаёт расширение инстанса из указанного модуля.
+ *
+ * Отдельной опцией, а не соглашением об имени файла: команда не должна угадывать, что в
+ * проекте считается конфигом. Без неё «серверного файла не нужно» и «расширяется снаружи»
+ * не сходились бы — за первым же плагином потребитель писал бы свою точку входа.
+ */
+async function loadConfigure(entry) {
+  const module = await import(pathToFileURL(resolve(process.cwd(), entry)).href)
+
+  if (typeof module.default !== 'function') {
+    fail(`дефолтный экспорт «${entry}» не функция — расширять инстанс нечем`)
+  }
+
+  return module.default
+}
+
+async function main() {
+  // Разбор аргументов — единственное место, где ошибка означает «человек опечатался»,
+  // поэтому она показывается подсказкой, а не стектрейсом
+  let parsed
+  try {
+    parsed = parseArgs(process.argv.slice(2))
+  } catch (error) {
+    fail(error.message)
+  }
+
+  const { entry, help, options = {} } = parsed
+
+  if (help) {
+    process.stdout.write(USAGE)
+    return
+  }
+
+  if (entry === undefined) {
+    fail('не указан модуль с дескриптором')
+  }
+
+  // Рантайм грузится ПОСЛЕ разбора аргументов: `--help` и опечатка в опции не должны тянуть
+  // fastify и весь серверный граф
+  const { serveApp } = await import('@foxford/den/serve')
+
+  await serveApp(await loadApp(entry), {
+    configure: options.configure === undefined ? undefined : await loadConfigure(options.configure),
+    host: options.host ?? process.env.HOST ?? '0.0.0.0',
+    port: Number(options.port ?? process.env.PORT ?? 3000),
+    slowRenderMs: options.slow === undefined ? undefined : Number(options.slow),
+  })
+}
+
+main().catch((error) => {
+  process.stderr.write(`den-serve: ${error instanceof Error ? error.message : String(error)}\n`)
+  process.exit(1)
+})

package/descriptor-DZDNH7R5.d.ts

@@ -0,0 +1,70 @@
+import { S as SlotDefinition } from './define-slot-Dil8Kr1A.js';
+import { q as LayerDefinition, x as Definition } from './types-COwVwgzE.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>>;
+}
+
+export type { IslandDescriptor as I };

package/descriptor-h0JE9jFx.d.cts

@@ -0,0 +1,70 @@
+import { S as SlotDefinition } from './define-slot-BKvArA02.cjs';
+import { q as LayerDefinition, x as Definition } from './types-COwVwgzE.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>>;
+}
+
+export type { IslandDescriptor as I };

package/index.cjs

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