@foxford/den 1.0.0

package/README.mdx

@@ -0,0 +1,9 @@
+---
+title: Den
+---
+
+# @foxford/den
+
+Den — декларативный метафреймворк Foxford (core runtime).
+
+Содержит core runtime: define* API, lifecycle, container orchestration, NavigationManager.

package/adapter.cjs

@@ -0,0 +1,43 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapter.ts
+var adapter_exports = {};
+__export(adapter_exports, {
+  installResolver: () => installResolver,
+  resolveDefinition: () => resolveDefinition
+});
+module.exports = __toCommonJS(adapter_exports);
+var activeResolver = null;
+function installResolver(resolver) {
+  activeResolver = resolver;
+}
+function resolveDefinition(token) {
+  if (activeResolver === null) {
+    throw new Error(
+      `den/adapter: \u0440\u0435\u0437\u043E\u043B\u0432\u0435\u0440 \u043D\u0435 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D \u0434\u043B\u044F \xAB${token.description}\xBB \u2014 \u043D\u0438 \u043E\u0434\u0438\u043D host-\u0430\u0434\u0430\u043F\u0442\u0435\u0440 \u043D\u0435 \u0432\u044B\u0437\u0432\u0430\u043B installResolver()`
+    );
+  }
+  return activeResolver(token);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  installResolver,
+  resolveDefinition
+});

package/adapter.d.cts

@@ -0,0 +1,73 @@
+export { R as RequestContext } from './types-B4Arep3V.cjs';
+import { Token } from '@foxford/ioc';
+
+/**
+ * Протокол денстейта — сериализованное состояние участников контейнера для SSR.
+ *
+ * Plain object, ключ записи = `token.description` (см. `StateSerializer`). Протокол
+ * ИДЕНТИЧЕН между Vike- и Next-адаптерами, поэтому состояние обменивается между
+ * ядром и любым хостом без конвертации.
+ */
+type DenState = Record<string, unknown>;
+/**
+ * Инжектируемая стратегия резолва `define*`-дескриптора во view.
+ *
+ * Дескриптор (`defineViewModel` и т.п.) сам НЕ знает, откуда брать инстанс —
+ * стратегию ставит активный адаптер через `installResolver()`. Возврат — union
+ * `T | Promise<T>`, чтобы покрыть оба хоста одним контрактом:
+ *
+ * - **Vike** — async/global: резолвит из глобального контейнера с подъёмом по
+ *   parent-chain; при промахе (page-scope VM ещё не зарегистрирован) отдаёт
+ *   pending `Promise`, а view рендерит `null`.
+ * - **Next** — sync/island: резолвит из контейнера ТЕКУЩЕГО острова через
+ *   React-контекст (сам резолвер — хук). Всегда возвращает `T` синхронно —
+ *   это допустимое подмножество union.
+ */
+type DefinitionResolver = <T>(token: Token<T>) => T | Promise<T>;
+/**
+ * Владелец клиентской навигации (честная граница — навигация per-host).
+ *
+ * - `'den-owned'` — навигацией владеет ядро (SPA-движок `NavigationManager`),
+ *   хост лишь исполняет переход. Режим Vike.
+ * - `'host-owned'` — навигацией владеет хост (роутер Next); ядро в клиент
+ *   `NavigationManager` не тянет. Режим Next.
+ */
+type NavigationOwnership = 'den-owned' | 'host-owned';
+/**
+ * Порт host-адаптера.
+ *
+ * Формализует ДВА пункта, которые у адаптера уникальны и обязаны быть объявлены
+ * явно. Всё остальное расшаривается напрямую через `Core` (контейнеры,
+ * guards, `stateSerializer`) и не требует переабстракции в порту:
+ *
+ * - `navigation` — кто владеет клиентской навигацией (см. `NavigationOwnership`).
+ * - `installResolver()` — как резолвить `define*` во view (см. `DefinitionResolver`).
+ *
+ * Драйвинг (порядок и момент вызова менеджеров ядра) по природе host-специфичен
+ * (Vike — через хуки, Next — через RSC + island-mount) и НЕ входит в порт.
+ */
+interface HostAdapter {
+    /** Владелец клиентской навигации. */
+    readonly navigation: NavigationOwnership;
+    /**
+     * Устанавливает стратегию резолва `define*` во view через `installResolver()`.
+     * Вызывается один раз при инициализации адаптера.
+     */
+    installResolver(): void;
+}
+/**
+ * Устанавливает стратегию резолва `define*`. Вызывает активный адаптер при
+ * инициализации. Единственный механизм резолва — общего «дефолта» нет,
+ * чтобы адаптеры не перезаписывали стратегии друг друга.
+ * @param resolver - Стратегия резолва (см. `DefinitionResolver`)
+ */
+declare function installResolver(resolver: DefinitionResolver): void;
+/**
+ * Резолвит `define*`-дескриптор через стратегию активного адаптера.
+ * Вызывается из `.resolve()`/`.use()` дескриптора во view.
+ * @param token - Токен резолвимой сущности
+ * @throws Если адаптер не вызвал `installResolver()`
+ */
+declare function resolveDefinition<T>(token: Token<T>): T | Promise<T>;
+
+export { type DefinitionResolver, type DenState, type HostAdapter, type NavigationOwnership, installResolver, resolveDefinition };

package/adapter.d.ts

@@ -0,0 +1,73 @@
+export { R as RequestContext } from './types-B4Arep3V.js';
+import { Token } from '@foxford/ioc';
+
+/**
+ * Протокол денстейта — сериализованное состояние участников контейнера для SSR.
+ *
+ * Plain object, ключ записи = `token.description` (см. `StateSerializer`). Протокол
+ * ИДЕНТИЧЕН между Vike- и Next-адаптерами, поэтому состояние обменивается между
+ * ядром и любым хостом без конвертации.
+ */
+type DenState = Record<string, unknown>;
+/**
+ * Инжектируемая стратегия резолва `define*`-дескриптора во view.
+ *
+ * Дескриптор (`defineViewModel` и т.п.) сам НЕ знает, откуда брать инстанс —
+ * стратегию ставит активный адаптер через `installResolver()`. Возврат — union
+ * `T | Promise<T>`, чтобы покрыть оба хоста одним контрактом:
+ *
+ * - **Vike** — async/global: резолвит из глобального контейнера с подъёмом по
+ *   parent-chain; при промахе (page-scope VM ещё не зарегистрирован) отдаёт
+ *   pending `Promise`, а view рендерит `null`.
+ * - **Next** — sync/island: резолвит из контейнера ТЕКУЩЕГО острова через
+ *   React-контекст (сам резолвер — хук). Всегда возвращает `T` синхронно —
+ *   это допустимое подмножество union.
+ */
+type DefinitionResolver = <T>(token: Token<T>) => T | Promise<T>;
+/**
+ * Владелец клиентской навигации (честная граница — навигация per-host).
+ *
+ * - `'den-owned'` — навигацией владеет ядро (SPA-движок `NavigationManager`),
+ *   хост лишь исполняет переход. Режим Vike.
+ * - `'host-owned'` — навигацией владеет хост (роутер Next); ядро в клиент
+ *   `NavigationManager` не тянет. Режим Next.
+ */
+type NavigationOwnership = 'den-owned' | 'host-owned';
+/**
+ * Порт host-адаптера.
+ *
+ * Формализует ДВА пункта, которые у адаптера уникальны и обязаны быть объявлены
+ * явно. Всё остальное расшаривается напрямую через `Core` (контейнеры,
+ * guards, `stateSerializer`) и не требует переабстракции в порту:
+ *
+ * - `navigation` — кто владеет клиентской навигацией (см. `NavigationOwnership`).
+ * - `installResolver()` — как резолвить `define*` во view (см. `DefinitionResolver`).
+ *
+ * Драйвинг (порядок и момент вызова менеджеров ядра) по природе host-специфичен
+ * (Vike — через хуки, Next — через RSC + island-mount) и НЕ входит в порт.
+ */
+interface HostAdapter {
+    /** Владелец клиентской навигации. */
+    readonly navigation: NavigationOwnership;
+    /**
+     * Устанавливает стратегию резолва `define*` во view через `installResolver()`.
+     * Вызывается один раз при инициализации адаптера.
+     */
+    installResolver(): void;
+}
+/**
+ * Устанавливает стратегию резолва `define*`. Вызывает активный адаптер при
+ * инициализации. Единственный механизм резолва — общего «дефолта» нет,
+ * чтобы адаптеры не перезаписывали стратегии друг друга.
+ * @param resolver - Стратегия резолва (см. `DefinitionResolver`)
+ */
+declare function installResolver(resolver: DefinitionResolver): void;
+/**
+ * Резолвит `define*`-дескриптор через стратегию активного адаптера.
+ * Вызывается из `.resolve()`/`.use()` дескриптора во view.
+ * @param token - Токен резолвимой сущности
+ * @throws Если адаптер не вызвал `installResolver()`
+ */
+declare function resolveDefinition<T>(token: Token<T>): T | Promise<T>;
+
+export { type DefinitionResolver, type DenState, type HostAdapter, type NavigationOwnership, installResolver, resolveDefinition };

package/adapter.mjs

@@ -0,0 +1,17 @@
+// src/adapter.ts
+var activeResolver = null;
+function installResolver(resolver) {
+  activeResolver = resolver;
+}
+function resolveDefinition(token) {
+  if (activeResolver === null) {
+    throw new Error(
+      `den/adapter: \u0440\u0435\u0437\u043E\u043B\u0432\u0435\u0440 \u043D\u0435 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D \u0434\u043B\u044F \xAB${token.description}\xBB \u2014 \u043D\u0438 \u043E\u0434\u0438\u043D host-\u0430\u0434\u0430\u043F\u0442\u0435\u0440 \u043D\u0435 \u0432\u044B\u0437\u0432\u0430\u043B installResolver()`
+    );
+  }
+  return activeResolver(token);
+}
+export {
+  installResolver,
+  resolveDefinition
+};