@foxford/den 1.0.2 → 2.0.0

package/island/index.cjs

@@ -0,0 +1,137 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+var _chunkLJE7K7VDcjs = require('../chunk-LJE7K7VD.cjs');
+
+
+
+
+var _chunkA6ZPAM6Zcjs = require('../chunk-A6ZPAM6Z.cjs');
+
+
+var _chunkXHYR3SGGcjs = require('../chunk-XHYR3SGG.cjs');
+
+// src/island/lifecycle.ts
+var _logger = require('@foxford/logger');
+
+// 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
+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(container, descriptor) {
+  var _a, _b;
+  for (const vm of (_a = descriptor.viewModels) != null ? _a : []) {
+    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 (\u0431\u0435\u0437 \u0441\u0435\u0440\u0432\u0435\u0440\u043D\u043E\u0433\u043E denState)");
+    void ((_b = instance.activate) == null ? void 0 : _b.call(instance));
+  }
+}
+
+// src/island/slot-address.ts
+function slotAddress(app, slot) {
+  return `${app}:${slot}`;
+}
+
+// src/island/registry.ts
+var nextId = 1;
+var islands = /* @__PURE__ */ new Map();
+var listeners = /* @__PURE__ */ new Set();
+var snapshot = [];
+function notify() {
+  snapshot = [...islands.values()];
+  for (const listener of listeners) {
+    listener();
+  }
+}
+function registerIsland(record) {
+  const id = nextId++;
+  islands.set(id, _chunkXHYR3SGGcjs.__spreadValues.call(void 0, { id }, record));
+  notify();
+  return () => {
+    islands.delete(id);
+    notify();
+  };
+}
+function getIslandsSnapshot() {
+  return snapshot;
+}
+function subscribeIslands(listener) {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}
+function describeIsland(descriptor, denState) {
+  var _a, _b;
+  return {
+    denStateKeys: Object.keys(denState != null ? denState : {}),
+    name: descriptor.name,
+    // Адресами, а не локальными ключами: панель показывает острова разных приложений разом,
+    // и `aside` без префикса в этом списке ничего не значит.
+    slots: Object.keys((_a = descriptor.slots) != null ? _a : {}).map((slot) => slotAddress(descriptor.name, slot)),
+    units: descriptor.units.map((unit) => unit.token.description),
+    viewModels: ((_b = descriptor.viewModels) != null ? _b : []).map((vm) => vm.token.description)
+  };
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.ViewLayerToken = _chunkLJE7K7VDcjs.ViewLayerToken; exports.activateIslandViewModels = activateIslandViewModels; exports.createIslandContainer = createIslandContainer; exports.describeIsland = describeIsland; exports.getAppContainer = getAppContainer; exports.getIslandsSnapshot = getIslandsSnapshot; exports.hydrateIslandState = hydrateIslandState; exports.registerIsland = registerIsland; exports.resolveViewAdapter = _chunkLJE7K7VDcjs.resolveViewAdapter; exports.slotAddress = slotAddress; exports.subscribeIslands = subscribeIslands; exports.viewAdapterOf = _chunkLJE7K7VDcjs.viewAdapterOf;

package/island/index.d.cts

@@ -0,0 +1,158 @@
+import { I as IslandDescriptor } from '../view-adapter-vwO-7b1t.cjs';
+export { V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken, r as resolveViewAdapter, v as viewAdapterOf } from '../view-adapter-vwO-7b1t.cjs';
+import { Container } from '@foxford/ioc';
+import '../define-slot-RfgqKa6n.cjs';
+import '../types-Deyolj1-.cjs';
+
+/** Опции сборки контейнера острова. */
+interface CreateIslandContainerOptions {
+    /**
+     * Родитель контейнера острова. По умолчанию — app-scope контейнер федерации.
+     *
+     * Через него остров и получает всё, что настроил хост: конфиг HTTP, транспорт, общие
+     * сервисы. Хост биндит их один раз в app-контейнер, а резолв поднимается по parent-chain.
+     */
+    parent?: Container;
+}
+/**
+ * Собирает контейнер острова: scope-логгер, биндинги хоста, регистрация units + VM + слотов.
+ *
+ * Сборка идёт в песочнице: там, где хост рендерит остров на сервере (renderToString),
+ * error boundary view-фреймворка не работает, и неперехваченный сбой (например, потребителю
+ * отказали в обязательной возможности) уронил бы весь HTML-ответ. При падении возвращается
+ * `null` — адаптер рисует плашку вместо острова, страница живёт, а сервер и клиент приходят
+ * к одному результату (тот же отказ → та же плашка, без mismatch).
+ *
+ * @param descriptor - Дескриптор острова
+ * @param options - Родительский контейнер и биндинги хоста
+ * @returns Контейнер острова либо `null`, если сборка упала
+ */
+declare function createIslandContainer(descriptor: IslandDescriptor, options?: CreateIslandContainerOptions): Container | null;
+/**
+ * Сидит VM острова значениями из denState (ключ записи = `token.description`).
+ *
+ * Зовётся на КАЖДУЮ смену payload, а не однократно при сборке: при клиентской навигации
+ * хост обновляет данные страницы, не размонтируя дерево, и новое состояние приходит в
+ * живой остров. Отсекать повторный сидинг одного и того же значения — забота адаптера:
+ * он один знает, менялся ли payload с прошлого прохода.
+ *
+ * @param container - Контейнер острова
+ * @param descriptor - Дескриптор острова
+ * @param denState - Серверное состояние (ключ = `token.description` VM)
+ */
+declare function hydrateIslandState(container: Container, descriptor: IslandDescriptor, denState: Record<string, unknown>): void;
+/**
+ * Активирует VM острова самостоятельно — когда серверного denState нет (ремоунт острова
+ * без данных, чисто клиентский переход). С denState активация не нужна: состояние уже
+ * приехало готовым.
+ *
+ * @param container - Контейнер острова
+ * @param descriptor - Дескриптор острова
+ */
+declare function activateIslandViewModels(container: Container, descriptor: IslandDescriptor): void;
+
+/** Запись живого острова: имя + фактический состав его контейнера. */
+interface IslandRecord {
+    /** Уникальный id инстанса острова (островов одного приложения может быть несколько). */
+    id: number;
+    /** Имя приложения из дескриптора (`market-app`) либо fallback-имя. */
+    name: string;
+    /** Data/Business единицы, зарегистрированные в контейнере острова (token.description). */
+    units: string[];
+    /** VM-единицы острова (token.description). */
+    viewModels: string[];
+    /** Слоты, задекларированные страницей острова (имена). */
+    slots: string[];
+    /** Ключи denState, из которых гидрированы VM (пусто — VM активировались сами). */
+    denStateKeys: string[];
+}
+/**
+ * Регистрирует живой остров. Вызывается island-рантаймом при монтировании.
+ * @param record - Состав острова (без id — его выдаёт реестр)
+ * @returns Функция снятия с учёта (вызвать при размонтировании)
+ */
+declare function registerIsland(record: Omit<IslandRecord, 'id'>): () => void;
+/** Текущий снапшот живых островов (стабильная ссылка до следующего изменения). */
+declare function getIslandsSnapshot(): IslandRecord[];
+/** Подписка на изменения реестра (для useSyncExternalStore и его аналогов). */
+declare function subscribeIslands(listener: () => void): () => void;
+/**
+ * Состав острова для реестра — то же самое, что увидит dev-панель.
+ *
+ * Считается ядром, а не адаптером: это пересказ дескриптора и denState, во view-фреймворк
+ * он не заглядывает.
+ *
+ * @param descriptor - Дескриптор острова
+ * @param denState - Серверное состояние острова (может отсутствовать)
+ * @returns Запись без id — её выдаст {@link registerIsland}
+ */
+declare function describeIsland(descriptor: IslandDescriptor, denState?: Record<string, unknown>): Omit<IslandRecord, 'id'>;
+
+/** App-scope контейнер федерации (создаётся при первом обращении). */
+declare function getAppContainer(): Container;
+
+/**
+ * Глобальный адрес слота — `market-app:aside`.
+ *
+ * Внутри острова слоты зовутся локально (ключ из карты `slots` дескриптора): реестр живёт в
+ * контейнере острова, и пересечься там не с кем. Адрес нужен там, где приложения встречаются:
+ * `mountsInto` одного указывает на место другого, и хост сводит их по этой строке.
+ *
+ * Пространство имён даёт имя приложения, а не автор слота, поэтому увести чужой адрес нечем —
+ * префикс не в руках объявляющего. Правило живёт здесь, чтобы приложение, хост и dev-панель
+ * считали адрес одинаково, а не по трём совпадающим шаблонным строкам.
+ *
+ * @param app - Имя приложения из дескриптора (`market-app`)
+ * @param slot - Локальное имя слота — ключ в карте `slots`
+ * @returns Адрес вида `app:slot`
+ */
+declare function slotAddress(app: string, slot: string): string;
+
+/** Что приложение отдало серверным рендером. */
+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 CreateIslandContainerOptions, IslandDescriptor, type IslandRecord, type RenderTree, type ServerRender, type ServerRenderResult, activateIslandViewModels, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, registerIsland, slotAddress, subscribeIslands };

package/island/index.d.ts

@@ -0,0 +1,158 @@
+import { I as IslandDescriptor } from '../view-adapter-CL0vZ-rv.js';
+export { V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken, r as resolveViewAdapter, v as viewAdapterOf } from '../view-adapter-CL0vZ-rv.js';
+import { Container } from '@foxford/ioc';
+import '../define-slot-ESU7FR9O.js';
+import '../types-Deyolj1-.js';
+
+/** Опции сборки контейнера острова. */
+interface CreateIslandContainerOptions {
+    /**
+     * Родитель контейнера острова. По умолчанию — app-scope контейнер федерации.
+     *
+     * Через него остров и получает всё, что настроил хост: конфиг HTTP, транспорт, общие
+     * сервисы. Хост биндит их один раз в app-контейнер, а резолв поднимается по parent-chain.
+     */
+    parent?: Container;
+}
+/**
+ * Собирает контейнер острова: scope-логгер, биндинги хоста, регистрация units + VM + слотов.
+ *
+ * Сборка идёт в песочнице: там, где хост рендерит остров на сервере (renderToString),
+ * error boundary view-фреймворка не работает, и неперехваченный сбой (например, потребителю
+ * отказали в обязательной возможности) уронил бы весь HTML-ответ. При падении возвращается
+ * `null` — адаптер рисует плашку вместо острова, страница живёт, а сервер и клиент приходят
+ * к одному результату (тот же отказ → та же плашка, без mismatch).
+ *
+ * @param descriptor - Дескриптор острова
+ * @param options - Родительский контейнер и биндинги хоста
+ * @returns Контейнер острова либо `null`, если сборка упала
+ */
+declare function createIslandContainer(descriptor: IslandDescriptor, options?: CreateIslandContainerOptions): Container | null;
+/**
+ * Сидит VM острова значениями из denState (ключ записи = `token.description`).
+ *
+ * Зовётся на КАЖДУЮ смену payload, а не однократно при сборке: при клиентской навигации
+ * хост обновляет данные страницы, не размонтируя дерево, и новое состояние приходит в
+ * живой остров. Отсекать повторный сидинг одного и того же значения — забота адаптера:
+ * он один знает, менялся ли payload с прошлого прохода.
+ *
+ * @param container - Контейнер острова
+ * @param descriptor - Дескриптор острова
+ * @param denState - Серверное состояние (ключ = `token.description` VM)
+ */
+declare function hydrateIslandState(container: Container, descriptor: IslandDescriptor, denState: Record<string, unknown>): void;
+/**
+ * Активирует VM острова самостоятельно — когда серверного denState нет (ремоунт острова
+ * без данных, чисто клиентский переход). С denState активация не нужна: состояние уже
+ * приехало готовым.
+ *
+ * @param container - Контейнер острова
+ * @param descriptor - Дескриптор острова
+ */
+declare function activateIslandViewModels(container: Container, descriptor: IslandDescriptor): void;
+
+/** Запись живого острова: имя + фактический состав его контейнера. */
+interface IslandRecord {
+    /** Уникальный id инстанса острова (островов одного приложения может быть несколько). */
+    id: number;
+    /** Имя приложения из дескриптора (`market-app`) либо fallback-имя. */
+    name: string;
+    /** Data/Business единицы, зарегистрированные в контейнере острова (token.description). */
+    units: string[];
+    /** VM-единицы острова (token.description). */
+    viewModels: string[];
+    /** Слоты, задекларированные страницей острова (имена). */
+    slots: string[];
+    /** Ключи denState, из которых гидрированы VM (пусто — VM активировались сами). */
+    denStateKeys: string[];
+}
+/**
+ * Регистрирует живой остров. Вызывается island-рантаймом при монтировании.
+ * @param record - Состав острова (без id — его выдаёт реестр)
+ * @returns Функция снятия с учёта (вызвать при размонтировании)
+ */
+declare function registerIsland(record: Omit<IslandRecord, 'id'>): () => void;
+/** Текущий снапшот живых островов (стабильная ссылка до следующего изменения). */
+declare function getIslandsSnapshot(): IslandRecord[];
+/** Подписка на изменения реестра (для useSyncExternalStore и его аналогов). */
+declare function subscribeIslands(listener: () => void): () => void;
+/**
+ * Состав острова для реестра — то же самое, что увидит dev-панель.
+ *
+ * Считается ядром, а не адаптером: это пересказ дескриптора и denState, во view-фреймворк
+ * он не заглядывает.
+ *
+ * @param descriptor - Дескриптор острова
+ * @param denState - Серверное состояние острова (может отсутствовать)
+ * @returns Запись без id — её выдаст {@link registerIsland}
+ */
+declare function describeIsland(descriptor: IslandDescriptor, denState?: Record<string, unknown>): Omit<IslandRecord, 'id'>;
+
+/** App-scope контейнер федерации (создаётся при первом обращении). */
+declare function getAppContainer(): Container;
+
+/**
+ * Глобальный адрес слота — `market-app:aside`.
+ *
+ * Внутри острова слоты зовутся локально (ключ из карты `slots` дескриптора): реестр живёт в
+ * контейнере острова, и пересечься там не с кем. Адрес нужен там, где приложения встречаются:
+ * `mountsInto` одного указывает на место другого, и хост сводит их по этой строке.
+ *
+ * Пространство имён даёт имя приложения, а не автор слота, поэтому увести чужой адрес нечем —
+ * префикс не в руках объявляющего. Правило живёт здесь, чтобы приложение, хост и dev-панель
+ * считали адрес одинаково, а не по трём совпадающим шаблонным строкам.
+ *
+ * @param app - Имя приложения из дескриптора (`market-app`)
+ * @param slot - Локальное имя слота — ключ в карте `slots`
+ * @returns Адрес вида `app:slot`
+ */
+declare function slotAddress(app: string, slot: string): string;
+
+/** Что приложение отдало серверным рендером. */
+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 CreateIslandContainerOptions, IslandDescriptor, type IslandRecord, type RenderTree, type ServerRender, type ServerRenderResult, activateIslandViewModels, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, registerIsland, slotAddress, subscribeIslands };

package/island/index.js

@@ -0,0 +1,137 @@
+import {
+  ViewLayerToken,
+  resolveViewAdapter,
+  viewAdapterOf
+} from "../chunk-TCYGDT2A.js";
+import {
+  LoggerToken,
+  logger,
+  unitLogger
+} from "../chunk-TPBI6TOU.js";
+import {
+  __spreadValues
+} from "../chunk-HJO26HIQ.js";
+
+// src/island/lifecycle.ts
+import { log } from "@foxford/logger";
+
+// 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
+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(container, descriptor) {
+  var _a, _b;
+  for (const vm of (_a = descriptor.viewModels) != null ? _a : []) {
+    const instance = container.resolve(vm.token);
+    unitLogger(container, vm.token.description).debug("\u0430\u043A\u0442\u0438\u0432\u0430\u0446\u0438\u044F VM (\u0431\u0435\u0437 \u0441\u0435\u0440\u0432\u0435\u0440\u043D\u043E\u0433\u043E denState)");
+    void ((_b = instance.activate) == null ? void 0 : _b.call(instance));
+  }
+}
+
+// src/island/slot-address.ts
+function slotAddress(app, slot) {
+  return `${app}:${slot}`;
+}
+
+// src/island/registry.ts
+var nextId = 1;
+var islands = /* @__PURE__ */ new Map();
+var listeners = /* @__PURE__ */ new Set();
+var snapshot = [];
+function notify() {
+  snapshot = [...islands.values()];
+  for (const listener of listeners) {
+    listener();
+  }
+}
+function registerIsland(record) {
+  const id = nextId++;
+  islands.set(id, __spreadValues({ id }, record));
+  notify();
+  return () => {
+    islands.delete(id);
+    notify();
+  };
+}
+function getIslandsSnapshot() {
+  return snapshot;
+}
+function subscribeIslands(listener) {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}
+function describeIsland(descriptor, denState) {
+  var _a, _b;
+  return {
+    denStateKeys: Object.keys(denState != null ? denState : {}),
+    name: descriptor.name,
+    // Адресами, а не локальными ключами: панель показывает острова разных приложений разом,
+    // и `aside` без префикса в этом списке ничего не значит.
+    slots: Object.keys((_a = descriptor.slots) != null ? _a : {}).map((slot) => slotAddress(descriptor.name, slot)),
+    units: descriptor.units.map((unit) => unit.token.description),
+    viewModels: ((_b = descriptor.viewModels) != null ? _b : []).map((vm) => vm.token.description)
+  };
+}
+export {
+  ViewLayerToken,
+  activateIslandViewModels,
+  createIslandContainer,
+  describeIsland,
+  getAppContainer,
+  getIslandsSnapshot,
+  hydrateIslandState,
+  registerIsland,
+  resolveViewAdapter,
+  slotAddress,
+  subscribeIslands,
+  viewAdapterOf
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxford/den",
-  "version": "1.0.2",
+  "version": "2.0.0",
   "description": "Den — декларативный метафреймворк Foxford (core runtime)",
   "keywords": [
     "foxford",
@@ -40,6 +40,11 @@
       "import": "./define.js",
       "require": "./define.cjs",
       "types": "./define.d.ts"
+    },
+    "./island": {
+      "import": "./island/index.js",
+      "require": "./island/index.cjs",
+      "types": "./island/index.d.ts"
     }
   },
   "files": [
@@ -48,12 +53,20 @@
     "adapter.d.cts",
     "adapter.d.ts",
     "adapter.js",
-    "chunk-4FPCRHSM.cjs",
-    "chunk-E7HG2NXO.js",
-    "chunk-NRE6DV6O.cjs",
-    "chunk-S5KTWI6P.js",
-    "define-slot--HM6B232.d.ts",
-    "define-slot-es1K6_-L.d.cts",
+    "chunk-5DJZZML5.cjs",
+    "chunk-A6ZPAM6Z.cjs",
+    "chunk-C7BM4DGX.cjs",
+    "chunk-HJO26HIQ.js",
+    "chunk-LJE7K7VD.cjs",
+    "chunk-TCYGDT2A.js",
+    "chunk-TPBI6TOU.js",
+    "chunk-WBHHHICS.js",
+    "chunk-WRQC6BVJ.js",
+    "chunk-XHYR3SGG.cjs",
+    "define-repository-DZg34Tb3.d.ts",
+    "define-repository-OpMj-Q9O.d.cts",
+    "define-slot-ESU7FR9O.d.ts",
+    "define-slot-RfgqKa6n.d.cts",
     "define.cjs",
     "define.d.cts",
     "define.d.ts",
@@ -62,10 +75,13 @@
     "index.d.cts",
     "index.d.ts",
     "index.js",
+    "island",
     "package.json",
-    "types-B4Arep3V.d.cts",
-    "types-B4Arep3V.d.ts"
+    "types-Deyolj1-.d.cts",
+    "types-Deyolj1-.d.ts",
+    "view-adapter-CL0vZ-rv.d.ts",
+    "view-adapter-vwO-7b1t.d.cts"
   ],
-  "sha": "c4ff474",
+  "sha": "d3153b1",
   "scripts": {}
 }