@foxford/den 1.0.1 → 2.0.0

package/chunk-WRQC6BVJ.js

@@ -0,0 +1,224 @@
+import {
+  resolveDefinition
+} from "./chunk-WBHHHICS.js";
+import {
+  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");
+
+// src/core/slot-registry.ts
+var SlotRegistry = class {
+  constructor() {
+    /** Слоты по имени. Повторная регистрация с тем же именем перезаписывает. */
+    this.slots = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Регистрирует слот.
+   * @param entry - Запись слота (имя + непрозрачный view)
+   */
+  add(entry) {
+    this.slots.set(entry.name, entry);
+  }
+  /**
+   * Возвращает слот по имени.
+   * @param name - Имя слота
+   */
+  get(name) {
+    return this.slots.get(name);
+  }
+  /**
+   * Возвращает все зарегистрированные слоты.
+   */
+  all() {
+    return [...this.slots.values()];
+  }
+};
+
+// src/define-service.ts
+import { inject, Lifecycle } from "@foxford/ioc";
+function defineService(token, options) {
+  const { requires, create, activate, deactivate, serialize, deserialize, scope } = options;
+  const requireTokens = requires != null ? requires : [];
+  const participatesInState = serialize !== void 0 || deserialize !== void 0;
+  return {
+    __meta: { requires: requireTokens, scope: scope != null ? scope : "app" },
+    __type: "service",
+    /**
+     * Регистрирует сервис в IoC-контейнере как Singleton.
+     * Если передана create — биндит экземпляр класса напрямую.
+     * Иначе — биндит Activatable-обёртку с хуками lifecycle.
+     * Если объявлены serialize/deserialize — при создании экземпляра сервис
+     * регистрируется участником в StateRegistry этого контейнера.
+     * @param container - Контейнер для регистрации
+     */
+    register(container) {
+      const unitLog = unitLogger(container, token.description);
+      const factory = inject(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;
+        if (create) {
+          instance = create(args);
+        } else {
+          const service = {
+            activate(params) {
+              return activate == null ? void 0 : activate(args, params);
+            },
+            deactivate() {
+              return deactivate == null ? void 0 : deactivate(args);
+            }
+          };
+          instance = service;
+        }
+        if (participatesInState) {
+          unitLog.debug("\u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u044F \u0443\u0447\u0430\u0441\u0442\u043D\u0438\u043A\u043E\u043C StateRegistry (serialize/deserialize)");
+          registerStateParticipant(container, token, instance, args, serialize, deserialize);
+        }
+        return instance;
+      });
+      container.bind(token).toFactory(factory, { lifecycle: Lifecycle.Singleton });
+      unitLog.debug(`\u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u044F \u0441\u0435\u0440\u0432\u0438\u0441\u0430 (scope=${scope != null ? scope : "app"}, requires=${requireTokens.length})`);
+    },
+    token
+  };
+}
+function registerStateParticipant(container, token, instance, deps, serialize, deserialize) {
+  if (!container.has(StateRegistryToken)) {
+    return;
+  }
+  const resolved = container.resolve(StateRegistryToken);
+  if (resolved instanceof Promise) {
+    return;
+  }
+  ;
+  resolved.add(token.description, {
+    activate: (params) => {
+      var _a;
+      return (_a = instance.activate) == null ? void 0 : _a.call(instance, params);
+    },
+    fromJSON: deserialize ? (data) => deserialize(deps, data) : void 0,
+    toJSON: serialize ? () => serialize(deps) : void 0
+  });
+}
+
+// src/define-view-model.ts
+import { inject as inject2, Lifecycle as Lifecycle2 } from "@foxford/ioc";
+function defineViewModel(token, options) {
+  const { requires, create } = options;
+  const requireTokens = requires != null ? requires : [];
+  return {
+    __meta: { requires: requireTokens },
+    __type: "view-model",
+    /**
+     * Регистрирует VM в IoC-контейнере как Singleton.
+     * Зависимости из requires резолвятся автоматически через inject.
+     * @param container - Контейнер для регистрации
+     */
+    register(container) {
+      const unitLog = unitLogger(container, token.description);
+      const factory = inject2(requireTokens, (...args) => {
+        unitLog.debug("\u0441\u043E\u0437\u0434\u0430\u043D\u0438\u0435 view-model");
+        return create(args);
+      });
+      container.bind(token).toFactory(factory, { lifecycle: Lifecycle2.Singleton });
+      unitLog.debug(`\u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u044F view-model (requires=${requireTokens.length})`);
+    },
+    /**
+     * Резолвит VM через стратегию активного host-адаптера.
+     * Вызывайте когда контейнер уже инициализирован (в render-контексте).
+     *
+     * Дескриптор не знает, откуда берётся инстанс — стратегию ставит адаптер
+     * через `installResolver()` (см. `@foxford/den/adapter`):
+     * - Vike (дефолт) — async/global: подъём по parent-chain, pending Promise при промахе;
+     * - Next — sync/island: контейнер острова из React-контекста.
+     *
+     * @returns Экземпляр VM или Promise с экземпляром
+     */
+    resolve() {
+      return resolveDefinition(token);
+    },
+    token,
+    /**
+     * Псевдоним для resolve(). Резолвит VM через стратегию активного адаптера.
+     * @returns Экземпляр VM или Promise с экземпляром
+     */
+    use() {
+      return this.resolve();
+    }
+  };
+}
+
+// src/define-repository.ts
+import { inject as inject3, Lifecycle as Lifecycle3 } from "@foxford/ioc";
+function defineRepository(token, options) {
+  const { requires, create, scope } = options;
+  const requireTokens = requires != null ? requires : [];
+  return {
+    __meta: { requires: requireTokens, scope: scope != null ? scope : "app" },
+    __type: "repository",
+    /**
+     * Регистрирует репозиторий в IoC-контейнере как Singleton.
+     * Зависимости из requires резолвятся автоматически через inject.
+     * @param container - Контейнер для регистрации
+     */
+    register(container) {
+      const unitLog = unitLogger(container, token.description);
+      const factory = inject3(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);
+      });
+      container.bind(token).toFactory(factory, { lifecycle: Lifecycle3.Singleton });
+      unitLog.debug(`\u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u044F \u0440\u0435\u043F\u043E\u0437\u0438\u0442\u043E\u0440\u0438\u044F (scope=${scope != null ? scope : "app"}, requires=${requireTokens.length})`);
+    },
+    token
+  };
+}
+
+// src/define-slot.ts
+function defineSlot({ view, units = [], viewLayer } = {}) {
+  return {
+    __type: "slot",
+    register(container, name) {
+      const slotLog = unitLogger(container, `slot:${name}`);
+      for (const unit of units) {
+        unit.register(container);
+      }
+      const registry = container.has(SlotRegistryToken) ? container.resolve(SlotRegistryToken) : (() => {
+        const created = new SlotRegistry();
+        container.bind(SlotRegistryToken).toValue(created);
+        slotLog.debug("\u0441\u043E\u0437\u0434\u0430\u043D SlotRegistry \u043A\u043E\u043D\u0442\u0435\u0439\u043D\u0435\u0440\u0430");
+        return created;
+      })();
+      registry.add({ name, view, viewLayer });
+      slotLog.debug(`\u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u044F \u0441\u043B\u043E\u0442\u0430 (units=${units.length})`);
+    },
+    units,
+    view,
+    viewLayer
+  };
+}
+
+export {
+  ContainerManagerToken,
+  GuardRunnerToken,
+  NavigationManagerToken,
+  StateSerializerToken,
+  StateRegistryToken,
+  SlotRegistryToken,
+  ActivatableToken,
+  RequestContextToken,
+  SlotRegistry,
+  defineService,
+  defineViewModel,
+  defineRepository,
+  defineSlot
+};

package/chunk-XHYR3SGG.cjs

@@ -0,0 +1,41 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+
+
+
+
+exports.__spreadValues = __spreadValues; exports.__async = __async;

package/define-repository-DZg34Tb3.d.ts

@@ -0,0 +1,83 @@
+import { x as DefineServiceOptions, K as ServiceDefinition, y as DefineViewModelOptions, X as ViewModelDefinition, w as DefineRepositoryOptions, I as RepositoryDefinition } from './types-Deyolj1-.js';
+import { Token } from '@foxford/ioc';
+
+/**
+ * Определяет сервис с IoC-биндингом и опциональными lifecycle-хуками activate/deactivate.
+ * Если передана опция create — регистрирует экземпляр класса напрямую (как Singleton).
+ * Если create не передана — создаёт Activatable-обёртку с хуками activate/deactivate.
+ *
+ * @template T - Тип регистрируемого сервиса
+ * @template Deps - Кортеж токенов зависимостей (по умолчанию пустой кортеж)
+ * @param token - Токен для регистрации сервиса в IoC
+ * @param options - Опции: requires, create, activate, deactivate
+ * @returns ServiceDefinition с методом register(container)
+ *
+ * @example
+ * // С фабрикой create (сервис-класс регистрируется напрямую)
+ * const authService = defineService(AuthServiceToken, {
+ *   create: () => new AuthService(),
+ * })
+ * authService.register(appContainer)
+ *
+ * @example
+ * // С lifecycle-хуками (без create)
+ * const dataService = defineService(DataServiceToken, {
+ *   requires: [RepoToken] as const,
+ *   activate: ([repo], params) => repo.loadData(params.id),
+ *   deactivate: ([repo]) => repo.cleanup(),
+ * })
+ * dataService.register(appContainer)
+ */
+declare function defineService<T, Deps extends readonly Token<unknown>[] = readonly []>(token: Token<T>, options: DefineServiceOptions<Deps, T>): ServiceDefinition<T, Deps>;
+
+/**
+ * Определяет ViewModel с IoC-биндингом и proxy для прямого импорта из view.
+ * Поддерживает deferred resolution — контейнер не нужен на момент импорта модуля.
+ * Метод resolve() делегирует резолв стратегии активного host-адаптера
+ * (см. `@foxford/den/adapter` → `installResolver`).
+ *
+ * @template T - Тип ViewModel
+ * @template Deps - Кортеж токенов зависимостей (по умолчанию пустой кортеж)
+ * @param token - Токен для регистрации VM в IoC
+ * @param options - Опции: requires, create
+ * @returns ViewModelDefinition с методами register(container) и resolve()
+ *
+ * @example
+ * // home.vm.ts — создаётся при импорте модуля
+ * export const homeVm = defineViewModel(HomeVmToken, {
+ *   requires: [UserServiceToken] as const,
+ *   create: ([userService]) => ({
+ *     title: userService.getTitle(),
+ *   }),
+ * })
+ *
+ * // home.view.tsx — контейнер уже инициализирован
+ * const vm = await homeVm.use()
+ */
+declare function defineViewModel<T, Deps extends readonly Token<unknown>[] = readonly []>(token: Token<T>, options: DefineViewModelOptions<Deps, T>): ViewModelDefinition<T, Deps>;
+
+/**
+ * Определяет репозиторий уровня данных с IoC-биндингом.
+ * Регистрирует Singleton-фабрику в IoC-контейнере.
+ * В отличие от defineService, репозиторий не имеет activate/deactivate lifecycle —
+ * он предоставляет методы доступа к данным без управления состоянием страницы.
+ *
+ * @template T - Тип регистрируемого репозитория
+ * @template Deps - Кортеж токенов зависимостей (по умолчанию пустой кортеж)
+ * @param token - Токен для регистрации репозитория в IoC
+ * @param options - Опции: requires, create
+ * @returns RepositoryDefinition с методом register(container)
+ *
+ * @example
+ * const userRepo = defineRepository(UserRepoToken, {
+ *   requires: [HttpServiceToken] as const,
+ *   create: ([http]) => ({
+ *     getUser: (id: string) => http.get(`/users/${id}`),
+ *     saveUser: (data: UserData) => http.post('/users', data),
+ *   }),
+ * })
+ * userRepo.register(appContainer)
+ */
+declare function defineRepository<T, Deps extends readonly Token<unknown>[] = readonly []>(token: Token<T>, options: DefineRepositoryOptions<Deps, T>): RepositoryDefinition<T, Deps>;
+
+export { defineService as a, defineViewModel as b, defineRepository as d };

package/define-repository-OpMj-Q9O.d.cts

@@ -0,0 +1,83 @@
+import { x as DefineServiceOptions, K as ServiceDefinition, y as DefineViewModelOptions, X as ViewModelDefinition, w as DefineRepositoryOptions, I as RepositoryDefinition } from './types-Deyolj1-.cjs';
+import { Token } from '@foxford/ioc';
+
+/**
+ * Определяет сервис с IoC-биндингом и опциональными lifecycle-хуками activate/deactivate.
+ * Если передана опция create — регистрирует экземпляр класса напрямую (как Singleton).
+ * Если create не передана — создаёт Activatable-обёртку с хуками activate/deactivate.
+ *
+ * @template T - Тип регистрируемого сервиса
+ * @template Deps - Кортеж токенов зависимостей (по умолчанию пустой кортеж)
+ * @param token - Токен для регистрации сервиса в IoC
+ * @param options - Опции: requires, create, activate, deactivate
+ * @returns ServiceDefinition с методом register(container)
+ *
+ * @example
+ * // С фабрикой create (сервис-класс регистрируется напрямую)
+ * const authService = defineService(AuthServiceToken, {
+ *   create: () => new AuthService(),
+ * })
+ * authService.register(appContainer)
+ *
+ * @example
+ * // С lifecycle-хуками (без create)
+ * const dataService = defineService(DataServiceToken, {
+ *   requires: [RepoToken] as const,
+ *   activate: ([repo], params) => repo.loadData(params.id),
+ *   deactivate: ([repo]) => repo.cleanup(),
+ * })
+ * dataService.register(appContainer)
+ */
+declare function defineService<T, Deps extends readonly Token<unknown>[] = readonly []>(token: Token<T>, options: DefineServiceOptions<Deps, T>): ServiceDefinition<T, Deps>;
+
+/**
+ * Определяет ViewModel с IoC-биндингом и proxy для прямого импорта из view.
+ * Поддерживает deferred resolution — контейнер не нужен на момент импорта модуля.
+ * Метод resolve() делегирует резолв стратегии активного host-адаптера
+ * (см. `@foxford/den/adapter` → `installResolver`).
+ *
+ * @template T - Тип ViewModel
+ * @template Deps - Кортеж токенов зависимостей (по умолчанию пустой кортеж)
+ * @param token - Токен для регистрации VM в IoC
+ * @param options - Опции: requires, create
+ * @returns ViewModelDefinition с методами register(container) и resolve()
+ *
+ * @example
+ * // home.vm.ts — создаётся при импорте модуля
+ * export const homeVm = defineViewModel(HomeVmToken, {
+ *   requires: [UserServiceToken] as const,
+ *   create: ([userService]) => ({
+ *     title: userService.getTitle(),
+ *   }),
+ * })
+ *
+ * // home.view.tsx — контейнер уже инициализирован
+ * const vm = await homeVm.use()
+ */
+declare function defineViewModel<T, Deps extends readonly Token<unknown>[] = readonly []>(token: Token<T>, options: DefineViewModelOptions<Deps, T>): ViewModelDefinition<T, Deps>;
+
+/**
+ * Определяет репозиторий уровня данных с IoC-биндингом.
+ * Регистрирует Singleton-фабрику в IoC-контейнере.
+ * В отличие от defineService, репозиторий не имеет activate/deactivate lifecycle —
+ * он предоставляет методы доступа к данным без управления состоянием страницы.
+ *
+ * @template T - Тип регистрируемого репозитория
+ * @template Deps - Кортеж токенов зависимостей (по умолчанию пустой кортеж)
+ * @param token - Токен для регистрации репозитория в IoC
+ * @param options - Опции: requires, create
+ * @returns RepositoryDefinition с методом register(container)
+ *
+ * @example
+ * const userRepo = defineRepository(UserRepoToken, {
+ *   requires: [HttpServiceToken] as const,
+ *   create: ([http]) => ({
+ *     getUser: (id: string) => http.get(`/users/${id}`),
+ *     saveUser: (data: UserData) => http.post('/users', data),
+ *   }),
+ * })
+ * userRepo.register(appContainer)
+ */
+declare function defineRepository<T, Deps extends readonly Token<unknown>[] = readonly []>(token: Token<T>, options: DefineRepositoryOptions<Deps, T>): RepositoryDefinition<T, Deps>;
+
+export { defineService as a, defineViewModel as b, defineRepository as d };

package/define-slot-ESU7FR9O.d.ts

@@ -0,0 +1,74 @@
+import { z as Definition, s as LayerDefinition } from './types-Deyolj1-.js';
+import { Container } from '@foxford/ioc';
+
+/**
+ * Дескриптор слота — host-агностичен: непрозрачный `view` + опциональные `units`.
+ *
+ * `view` типизирован как `unknown` — ядро не знает про React/Vue: рендерит его view-адаптер.
+ *
+ * Имени у слота НЕТ: его выдаёт тот, кто слот к себе взял, ключом в карте `slots` своего
+ * дескриптора. Так адрес места принадлежит хозяину места, а не пакету, который написал для
+ * него view, и занять чужое пространство имён нечем — префикс не в руках объявляющего.
+ */
+interface SlotDefinition {
+    /** Дискриминатор типа. */
+    readonly __type: 'slot';
+    /** Непрозрачная ссылка на view слота (компонент view-фреймворка). */
+    readonly view?: unknown;
+    /** Data/Business единицы слота (изолированная секция). */
+    readonly units: readonly Definition<unknown>[];
+    /** View-слой слота, если он переопределён (см. {@link DefineSlotOptions.viewLayer}). */
+    readonly viewLayer?: LayerDefinition;
+    /**
+     * Регистрирует единицы слота и кладёт сам слот в `SlotRegistry` контейнера.
+     * @param container - Контейнер (острова/страницы/запроса)
+     * @param name - Имя слота в этом контейнере — ключ из карты `slots` дескриптора
+     */
+    register(container: Container, name: string): void;
+}
+/** Опции `defineSlot`. */
+interface DefineSlotOptions {
+    /**
+     * Непрозрачная ссылка на view слота. Необязательна: чистое место под чужой контент
+     * своего содержимого не имеет.
+     */
+    view?: unknown;
+    /** Data/Business единицы слота (по умолчанию пусто). */
+    units?: readonly Definition<unknown>[];
+    /**
+     * Переопределение view-слоя ДЛЯ ЭТОГО слота: `defineLayer(ViewLayerToken, { adapter })`.
+     *
+     * По умолчанию слот рисуется адаптером острова, в который попал, — так слот из чужого
+     * пакета встаёт в любое приложение. Указывать стоит там, где слот написан на другом
+     * фреймворке, чем принимающий остров.
+     */
+    viewLayer?: LayerDefinition;
+}
+/**
+ * Объявляет слот — самостоятельную `define*`-единицу расширения.
+ *
+ * `register(container, name)` регистрирует `units` и добавляет `{ name, view }` в
+ * `SlotRegistry` контейнера (get-or-create). Реестр живёт в контейнере ОСТРОВА, поэтому
+ * имена в нём локальные и с соседними приложениями не пересекаются; глобальный адрес для
+ * `mountsInto` собирается из имени приложения (см. `slotAddress` в `@foxford/den/island`).
+ *
+ * Рендерит слот view-адаптер — по умолчанию тот же, что у принимающего острова; свой
+ * адаптер слот получает через `viewLayer`.
+ *
+ * @param options - Непрозрачный `view`, опциональные `units` и `viewLayer`
+ * @returns Дескриптор `SlotDefinition`
+ *
+ * @example
+ * // приложение объявляет место у себя — имя даёт ключ в карте `slots`
+ * export default defineApp({
+ *   name: 'market-app',
+ *   slots: { aside: defineSlot({ view: AsideView }) },
+ * })
+ *
+ * @example
+ * // любой пакет — экспортит слот-юнит, не зная, куда он смонтируется и как будет назван
+ * export const chatSlot = defineSlot({ view: ChatView, units: [chatRepository] })
+ */
+declare function defineSlot({ view, units, viewLayer }?: DefineSlotOptions): SlotDefinition;
+
+export { type DefineSlotOptions as D, type SlotDefinition as S, defineSlot as d };

package/define-slot-RfgqKa6n.d.cts

@@ -0,0 +1,74 @@
+import { z as Definition, s as LayerDefinition } from './types-Deyolj1-.cjs';
+import { Container } from '@foxford/ioc';
+
+/**
+ * Дескриптор слота — host-агностичен: непрозрачный `view` + опциональные `units`.
+ *
+ * `view` типизирован как `unknown` — ядро не знает про React/Vue: рендерит его view-адаптер.
+ *
+ * Имени у слота НЕТ: его выдаёт тот, кто слот к себе взял, ключом в карте `slots` своего
+ * дескриптора. Так адрес места принадлежит хозяину места, а не пакету, который написал для
+ * него view, и занять чужое пространство имён нечем — префикс не в руках объявляющего.
+ */
+interface SlotDefinition {
+    /** Дискриминатор типа. */
+    readonly __type: 'slot';
+    /** Непрозрачная ссылка на view слота (компонент view-фреймворка). */
+    readonly view?: unknown;
+    /** Data/Business единицы слота (изолированная секция). */
+    readonly units: readonly Definition<unknown>[];
+    /** View-слой слота, если он переопределён (см. {@link DefineSlotOptions.viewLayer}). */
+    readonly viewLayer?: LayerDefinition;
+    /**
+     * Регистрирует единицы слота и кладёт сам слот в `SlotRegistry` контейнера.
+     * @param container - Контейнер (острова/страницы/запроса)
+     * @param name - Имя слота в этом контейнере — ключ из карты `slots` дескриптора
+     */
+    register(container: Container, name: string): void;
+}
+/** Опции `defineSlot`. */
+interface DefineSlotOptions {
+    /**
+     * Непрозрачная ссылка на view слота. Необязательна: чистое место под чужой контент
+     * своего содержимого не имеет.
+     */
+    view?: unknown;
+    /** Data/Business единицы слота (по умолчанию пусто). */
+    units?: readonly Definition<unknown>[];
+    /**
+     * Переопределение view-слоя ДЛЯ ЭТОГО слота: `defineLayer(ViewLayerToken, { adapter })`.
+     *
+     * По умолчанию слот рисуется адаптером острова, в который попал, — так слот из чужого
+     * пакета встаёт в любое приложение. Указывать стоит там, где слот написан на другом
+     * фреймворке, чем принимающий остров.
+     */
+    viewLayer?: LayerDefinition;
+}
+/**
+ * Объявляет слот — самостоятельную `define*`-единицу расширения.
+ *
+ * `register(container, name)` регистрирует `units` и добавляет `{ name, view }` в
+ * `SlotRegistry` контейнера (get-or-create). Реестр живёт в контейнере ОСТРОВА, поэтому
+ * имена в нём локальные и с соседними приложениями не пересекаются; глобальный адрес для
+ * `mountsInto` собирается из имени приложения (см. `slotAddress` в `@foxford/den/island`).
+ *
+ * Рендерит слот view-адаптер — по умолчанию тот же, что у принимающего острова; свой
+ * адаптер слот получает через `viewLayer`.
+ *
+ * @param options - Непрозрачный `view`, опциональные `units` и `viewLayer`
+ * @returns Дескриптор `SlotDefinition`
+ *
+ * @example
+ * // приложение объявляет место у себя — имя даёт ключ в карте `slots`
+ * export default defineApp({
+ *   name: 'market-app',
+ *   slots: { aside: defineSlot({ view: AsideView }) },
+ * })
+ *
+ * @example
+ * // любой пакет — экспортит слот-юнит, не зная, куда он смонтируется и как будет назван
+ * export const chatSlot = defineSlot({ view: ChatView, units: [chatRepository] })
+ */
+declare function defineSlot({ view, units, viewLayer }?: DefineSlotOptions): SlotDefinition;
+
+export { type DefineSlotOptions as D, type SlotDefinition as S, defineSlot as d };