@foxford/den 3.2.0 → 3.2.2

package/README.mdx

@@ -125,6 +125,41 @@ export class ContentPageVM extends ViewModel<State> {
 
 Редирект объявляется там же: `{ redirect: '/user/login' }` — без статуса это `302`.
 
+### Приложение без рендера
+
+`view` и `viewLayer` объявляются парой либо не объявляются вовсе. Приложение без них сообщает
+документу данные, а свой кусок страницы рисует кто-то другой — например, клиент монолита.
+
+```ts
+export default {
+  name: 'spa-portal',
+  units: [],
+  viewModels: [shellVm], // describeDocument отдаёт данные документа и артефакты адреса
+}
+```
+
+```ts
+describeDocument(): DocumentContribution {
+  const { shell } = this.state.get()
+
+  return {
+    // состав знает шаблон документа хоста, ядру перечислять его нечем
+    data: { containerId: shell.containerId, manifest: shell.manifest },
+    // чанки зависят от адреса, поэтому их знает рендер, а не сборка
+    assets: { css: shell.css, js: shell.js, scripts: 'classic' },
+  }
+}
+```
+
+Жизненный цикл у такого приложения тот же — контейнер, единицы, активация VM, вклад в документ, —
+укорачивается ровно отрисовка: `html` в ответе пустой, `state` посчитан как обычно. `den build`
+собирает его так же: `den.config.ts` без пресета означает, что клиентского выхода не бывает,
+и остаются серверный дескриптор с точкой входа процесса.
+
+`scripts: 'classic'` нужен там, где чанки собраны не ES-модулями: вид скрипта знает сборка, а
+теги печатает хост, и выбрать между `type="module"` и обычным `defer` он может только по этому
+признаку.
+
 ## Сетевой транспорт: то же самое по HTTP
 
 Приложение поднимается отдельным сервисом **без единой строки своего серверного кода** —

package/bin/den.cjs

@@ -1,7 +1,8 @@
 "use strict";
 
 
-var _chunkRRR2DJMNcjs = require('../chunk-RRR2DJMN.cjs');
+var _chunk3X4WVHUUcjs = require('../chunk-3X4WVHUU.cjs');
+require('../chunk-KQAB6C6Q.cjs');
 require('../chunk-A6ZPAM6Z.cjs');
 
 
@@ -69,11 +70,11 @@ function run(argv) {
     }
     const target = { base: options["base"], root: (_a = options["root"]) != null ? _a : process.cwd() };
     if (command === "build") {
-      yield _chunkRRR2DJMNcjs.buildApp.call(void 0, target);
+      yield _chunk3X4WVHUUcjs.buildApp.call(void 0, target);
       return;
     }
     if (command === "dev") {
-      yield _chunkRRR2DJMNcjs.devApp.call(void 0, target);
+      yield _chunk3X4WVHUUcjs.devApp.call(void 0, target);
       return;
     }
     fail(`\u043D\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043D\u0430\u044F \u043A\u043E\u043C\u0430\u043D\u0434\u0430 \xAB${command}\xBB`);

package/bin/den.js

@@ -1,7 +1,8 @@
 import {
   buildApp,
   devApp
-} from "../chunk-BMI5HNGE.js";
+} from "../chunk-XU5HUIPK.js";
+import "../chunk-RG7ZV5BD.js";
 import "../chunk-TPBI6TOU.js";
 import {
   __async

package/builder/index.cjs

@@ -2,11 +2,12 @@
 
 
 
-var _chunkRRR2DJMNcjs = require('../chunk-RRR2DJMN.cjs');
+var _chunk3X4WVHUUcjs = require('../chunk-3X4WVHUU.cjs');
+require('../chunk-KQAB6C6Q.cjs');
 require('../chunk-A6ZPAM6Z.cjs');
 require('../chunk-T5QVCXVB.cjs');
 
 
 
 
-exports.buildApp = _chunkRRR2DJMNcjs.buildApp; exports.defineAppConfig = _chunkRRR2DJMNcjs.defineAppConfig; exports.devApp = _chunkRRR2DJMNcjs.devApp;
+exports.buildApp = _chunk3X4WVHUUcjs.buildApp; exports.defineAppConfig = _chunk3X4WVHUUcjs.defineAppConfig; exports.devApp = _chunk3X4WVHUUcjs.devApp;

package/builder/index.d.cts

@@ -80,13 +80,18 @@ interface AppServerConfig {
 interface AppConfig {
     /** Модуль дескриптора; по умолчанию `src/index.ts`. */
     entry?: string;
-    /** Пресет фреймворка — из пакета адаптера. */
-    preset: AppBuildPreset;
+    /**
+     * Пресет фреймворка — из пакета адаптера.
+     *
+     * Не объявлен — приложение своего фрагмента не рисует (дескриптор без `view`), и клиентского
+     * выхода у него не бывает: собирать нечем и оживлять нечего.
+     */
+    preset?: AppBuildPreset;
     server?: AppServerConfig;
     /**
      * Последнее слово за приложением: правит собранный конфиг сборщика перед запуском.
      *
-     * Щель на случай, когда коробки не хватило. Зовётся отдельно для каждого выхода, поэтому
+     * Щель на случай, когда умолчаний сборки не хватило. Зовётся отдельно для каждого выхода, поэтому
      * правка адресуется тому, кому предназначена.
      */
     vite?: (config: Record<string, unknown>, target: 'server' | 'client') => Record<string, unknown>;

package/builder/index.d.ts

@@ -80,13 +80,18 @@ interface AppServerConfig {
 interface AppConfig {
     /** Модуль дескриптора; по умолчанию `src/index.ts`. */
     entry?: string;
-    /** Пресет фреймворка — из пакета адаптера. */
-    preset: AppBuildPreset;
+    /**
+     * Пресет фреймворка — из пакета адаптера.
+     *
+     * Не объявлен — приложение своего фрагмента не рисует (дескриптор без `view`), и клиентского
+     * выхода у него не бывает: собирать нечем и оживлять нечего.
+     */
+    preset?: AppBuildPreset;
     server?: AppServerConfig;
     /**
      * Последнее слово за приложением: правит собранный конфиг сборщика перед запуском.
      *
-     * Щель на случай, когда коробки не хватило. Зовётся отдельно для каждого выхода, поэтому
+     * Щель на случай, когда умолчаний сборки не хватило. Зовётся отдельно для каждого выхода, поэтому
      * правка адресуется тому, кому предназначена.
      */
     vite?: (config: Record<string, unknown>, target: 'server' | 'client') => Record<string, unknown>;

package/builder/index.js

@@ -2,7 +2,8 @@ import {
   buildApp,
   defineAppConfig,
   devApp
-} from "../chunk-BMI5HNGE.js";
+} from "../chunk-XU5HUIPK.js";
+import "../chunk-RG7ZV5BD.js";
 import "../chunk-TPBI6TOU.js";
 import "../chunk-6FNC3XMI.js";
 export {

package/{chunk-RRR2DJMN.cjs → chunk-3X4WVHUU.cjs}

@@ -1,5 +1,8 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
+var _chunkKQAB6C6Qcjs = require('./chunk-KQAB6C6Q.cjs');
+
+
 var _chunkA6ZPAM6Zcjs = require('./chunk-A6ZPAM6Z.cjs');
 
 
@@ -92,7 +95,9 @@ import config from ${JSON.stringify(configPath)}
 const server = config.server ?? {}
 
 async function setup() {
-  viewAdapterOf(app.viewLayer).installResolver()
+  if (app.viewLayer) {
+    viewAdapterOf(app.viewLayer).installResolver()
+  }
   server.container?.(getAppContainer())
   await server.setup?.()
 }
@@ -109,11 +114,16 @@ export default descriptor
 function generateServerProcess(configPath, base, mode) {
   const assets = mode === "development" ? `  assets: { base: ${JSON.stringify(base)}, dir: fileURLToPath(new URL('./client', import.meta.url)) },
 ` : "";
-  return `${mode === "development" ? "import { fileURLToPath } from 'node:url'\n\n" : ""}import { serveApp } from '@foxford/den/serve'
+  return `import { fileURLToPath } from 'node:url'
+
+import { loadAppEnv, serveApp } from '@foxford/den/serve'
 
 import app from ${JSON.stringify(VIRTUAL_SERVER_APP)}
 import config from ${JSON.stringify(configPath)}
 
+// \u0423\u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044F \u043E\u043A\u0440\u0443\u0436\u0435\u043D\u0438\u044F \u2014 \u0434\u043E \u043F\u0435\u0440\u0432\u043E\u0433\u043E \u0447\u0442\u0435\u043D\u0438\u044F: \u043F\u043E\u0440\u0442 \u0438 \u0430\u0434\u0440\u0435\u0441\u0430 \u0447\u0438\u0442\u0430\u044E\u0442\u0441\u044F \u043D\u0438\u0436\u0435
+loadAppEnv(fileURLToPath(new URL('..', import.meta.url)))
+
 await serveApp(app, {
 ${assets}  configure: config.server?.configure,
   host: process.env.HOST,
@@ -126,7 +136,14 @@ ${assets}  configure: config.server?.configure,
 function denAppModules(options) {
   const { assets, base, config, configPath, entry, mode } = options;
   const sources = {
-    [VIRTUAL_CLIENT]: () => generateClientEntry(entry, config.preset.clientEntry),
+    // Клиентский вход спрашивают только у клиентского выхода, а его без пресета не собирают.
+    // Отказ здесь означает, что выход всё-таки запустили, — это ошибка команд, а не приложения
+    [VIRTUAL_CLIENT]: () => {
+      if (!config.preset) {
+        throw new Error("den: \u043A\u043B\u0438\u0435\u043D\u0442\u0441\u043A\u0438\u0439 \u0432\u0445\u043E\u0434 \u0437\u0430\u043F\u0440\u043E\u0448\u0435\u043D, \u043D\u043E \u043F\u0440\u0435\u0441\u0435\u0442 \u043D\u0435 \u043E\u0431\u044A\u044F\u0432\u043B\u0435\u043D \u2014 \u043E\u0436\u0438\u0432\u043B\u044F\u0442\u044C \u043D\u0435\u0447\u0435\u043C");
+      }
+      return generateClientEntry(entry, config.preset.clientEntry);
+    },
     [VIRTUAL_SERVER_APP]: () => generateServerApp(entry, configPath, assets),
     [VIRTUAL_SERVER_PROCESS]: () => generateServerProcess(configPath, base, mode)
   };
@@ -167,8 +184,8 @@ function loadAppConfig(root) {
     try {
       const loaded = yield server.ssrLoadModule(configPath);
       const config = loaded.default;
-      if (!(config == null ? void 0 : config.preset)) {
-        throw new Error(`den: ${CONFIG_FILE} \u043D\u0435 \u043E\u0431\u044A\u044F\u0432\u043B\u044F\u0435\u0442 \u043F\u0440\u0435\u0441\u0435\u0442 \u0444\u0440\u0435\u0439\u043C\u0432\u043E\u0440\u043A\u0430 \u2014 \u0441\u043E\u0431\u0438\u0440\u0430\u0442\u044C \u043D\u0435\u0447\u0435\u043C`);
+      if (!config) {
+        throw new Error(`den: ${CONFIG_FILE} \u043D\u0435 \u043E\u0442\u0434\u0430\u0451\u0442 \u043A\u043E\u043D\u0444\u0438\u0433 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u044F \u2014 \u0441\u043E\u0431\u0438\u0440\u0430\u0442\u044C \u043D\u0435\u0447\u0435\u043C`);
       }
       return { config, configPath };
     } finally {
@@ -186,7 +203,7 @@ function dependenciesOf(root) {
   return [...Object.keys((_a = manifest.dependencies) != null ? _a : {}), ...Object.keys((_b = manifest.devDependencies) != null ? _b : {})];
 }
 function viteConfigFor(options) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d, _e;
   const { assets, base, config, configPath, entryFileNames, input, mode, outDir, root, target } = options;
   const entry = (_a = config.entry) != null ? _a : "src/index.ts";
   const composed = {
@@ -211,34 +228,43 @@ function viteConfigFor(options) {
     // программный вызов он иначе не доедет.
     mode,
     plugins: [
-      ...config.preset.plugins,
+      ...(_c = (_b = config.preset) == null ? void 0 : _b.plugins) != null ? _c : [],
       denAppModules({ assets, base, config, configPath, entry: _path2.default.join(root, entry), mode })
     ],
     root,
-    ssr: { noExternal: (_c = (_b = config.server) == null ? void 0 : _b.noExternal) != null ? _c : [] }
+    ssr: { noExternal: (_e = (_d = config.server) == null ? void 0 : _d.noExternal) != null ? _e : [] }
   };
   return config.vite ? config.vite(composed, target) : composed;
 }
 function buildApp(options) {
   return _chunkT5QVCXVBcjs.__async.call(void 0, this, null, function* () {
-    var _a, _b, _c, _d;
+    var _a, _b, _c;
     const { mode = "production" } = options;
     process.env["NODE_ENV"] = mode;
     const root = _path2.default.resolve(options.root);
+    _chunkKQAB6C6Qcjs.loadAppEnv.call(void 0, root);
     const { config, configPath } = yield loadAppConfig(root);
     const port = resolvePort((_a = config.server) == null ? void 0 : _a.port);
     const base = (_b = options.base) != null ? _b : "";
-    const refusal = (_d = (_c = config.preset).validate) == null ? void 0 : _d.call(_c, dependenciesOf(root));
+    const { preset } = config;
+    const refusal = (_c = preset == null ? void 0 : preset.validate) == null ? void 0 : _c.call(preset, dependenciesOf(root));
     if (refusal !== void 0 && refusal !== null) {
       throw new Error(`den: ${refusal}`);
     }
     const { build } = yield Promise.resolve().then(() => _interopRequireWildcard(require("vite")));
     const shared = { base, config, configPath, mode, root };
     const empty = { css: [], js: [] };
-    _chunkA6ZPAM6Zcjs.logger.info(`\u0441\u0431\u043E\u0440\u043A\u0430 \u043A\u043B\u0438\u0435\u043D\u0442\u0441\u043A\u043E\u0433\u043E \u0432\u044B\u0445\u043E\u0434\u0430 (${config.preset.view})`);
-    yield build(viteConfigFor(_chunkT5QVCXVBcjs.__spreadProps.call(void 0, _chunkT5QVCXVBcjs.__spreadValues.call(void 0, {}, shared), { assets: empty, input: VIRTUAL_CLIENT, outDir: OUT_CLIENT, target: "client" })));
-    const assets = collectAssets(_path2.default.join(root, OUT_CLIENT), base);
-    _chunkA6ZPAM6Zcjs.logger.info(`\u0430\u0440\u0442\u0435\u0444\u0430\u043A\u0442\u044B: ${String(assets.js.length)} js, ${String(assets.css.length)} css`);
+    let assets = empty;
+    if (preset) {
+      _chunkA6ZPAM6Zcjs.logger.info(`\u0441\u0431\u043E\u0440\u043A\u0430 \u043A\u043B\u0438\u0435\u043D\u0442\u0441\u043A\u043E\u0433\u043E \u0432\u044B\u0445\u043E\u0434\u0430 (${preset.view})`);
+      yield build(
+        viteConfigFor(_chunkT5QVCXVBcjs.__spreadProps.call(void 0, _chunkT5QVCXVBcjs.__spreadValues.call(void 0, {}, shared), { assets: empty, input: VIRTUAL_CLIENT, outDir: OUT_CLIENT, target: "client" }))
+      );
+      assets = collectAssets(_path2.default.join(root, OUT_CLIENT), base);
+      _chunkA6ZPAM6Zcjs.logger.info(`\u0430\u0440\u0442\u0435\u0444\u0430\u043A\u0442\u044B: ${String(assets.js.length)} js, ${String(assets.css.length)} css`);
+    } else {
+      _chunkA6ZPAM6Zcjs.logger.info("\u043A\u043B\u0438\u0435\u043D\u0442\u0441\u043A\u043E\u0433\u043E \u0432\u044B\u0445\u043E\u0434\u0430 \u043D\u0435\u0442: \u043F\u0440\u0435\u0441\u0435\u0442 \u043D\u0435 \u043E\u0431\u044A\u044F\u0432\u043B\u0435\u043D, \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u0435 \u0441\u0432\u043E\u0435\u0433\u043E \u0444\u0440\u0430\u0433\u043C\u0435\u043D\u0442\u0430 \u043D\u0435 \u0440\u0438\u0441\u0443\u0435\u0442");
+    }
     _chunkA6ZPAM6Zcjs.logger.info("\u0441\u0431\u043E\u0440\u043A\u0430 \u0441\u0435\u0440\u0432\u0435\u0440\u043D\u043E\u0433\u043E \u0434\u0435\u0441\u043A\u0440\u0438\u043F\u0442\u043E\u0440\u0430");
     yield build(
       viteConfigFor(_chunkT5QVCXVBcjs.__spreadProps.call(void 0, _chunkT5QVCXVBcjs.__spreadValues.call(void 0, {}, shared), {
@@ -309,7 +335,9 @@ function bannerLines(facts2) {
     `${label("\u043B\u043E\u043A\u0430\u043B\u044C\u043D\u043E")}http://localhost:${port}`,
     ...network === void 0 ? [] : [`${label("\u0432 \u0441\u0435\u0442\u0438")}http://${network}:${port}`],
     `${label("\u0440\u0443\u0447\u043A\u0438")}${ENDPOINTS.join("   ")}`,
-    ...facts2.base === void 0 ? [] : [`${label("\u0430\u0440\u0442\u0435\u0444\u0430\u043A\u0442\u044B")}${facts2.base}`],
+    // Префикс печатается, только когда он есть: при относительной сборке артефакты идут с
+    // адреса самого приложения, а он уже назван строкой выше
+    ...facts2.base === void 0 || facts2.base === "" ? [] : [`${label("\u043F\u0440\u0435\u0444\u0438\u043A\u0441")}${facts2.base}`],
     `${label("\u0447\u0430\u043D\u043A\u0438")}${assetsSummary(facts2.assets)}`,
     `${label("\u0432\u044B\u0445\u043E\u0434\u044B")}${OUTPUTS.join(", ")}`,
     `${label("\u043F\u0440\u0430\u0432\u043A\u0438")}${facts2.watched.join(", ")}`,

package/chunk-KQAB6C6Q.cjs

@@ -0,0 +1,15 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }// src/serve/env.ts
+var _fs = require('fs'); var _fs2 = _interopRequireDefault(_fs);
+var _path = require('path'); var _path2 = _interopRequireDefault(_path);
+var ENV_FILE = ".env";
+function loadAppEnv(root) {
+  const file = _path2.default.join(root, ENV_FILE);
+  if (!_fs2.default.existsSync(file)) {
+    return;
+  }
+  process.loadEnvFile(file);
+}
+
+
+
+exports.loadAppEnv = loadAppEnv;

package/chunk-RG7ZV5BD.js

@@ -0,0 +1,15 @@
+// src/serve/env.ts
+import fs from "fs";
+import path from "path";
+var ENV_FILE = ".env";
+function loadAppEnv(root) {
+  const file = path.join(root, ENV_FILE);
+  if (!fs.existsSync(file)) {
+    return;
+  }
+  process.loadEnvFile(file);
+}
+
+export {
+  loadAppEnv
+};

package/{chunk-TPHJUDHG.js → chunk-SOH2TL2N.js}

@@ -35,29 +35,33 @@ function getAppContainer() {
 import { log } from "@foxford/logger";
 var EMPTY_ROUTE = { params: {}, pathname: "", search: "" };
 var REDIRECT_FOUND = 302;
+function registerIslandParts(container, descriptor, islandLog) {
+  var _a, _b, _c;
+  (_a = descriptor.viewLayer) == null ? void 0 : _a.register(container);
+  const viewModels = (_b = descriptor.viewModels) != null ? _b : [];
+  const slots = Object.entries((_c = descriptor.slots) != null ? _c : {});
+  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);
+  }
+}
 function createIslandContainer(descriptor, options = {}) {
-  var _a, _b, _c, _d, _e;
+  var _a, _b, _c;
   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);
-    }
+    registerIslandParts(container, descriptor, islandLog);
     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);
@@ -111,6 +115,12 @@ function collectDocumentContribution(container, descriptor) {
     if (part.head) {
       contribution.head = __spreadValues(__spreadValues({}, contribution.head), part.head);
     }
+    if (part.data) {
+      contribution.data = __spreadValues(__spreadValues({}, contribution.data), part.data);
+    }
+    if (part.assets && contribution.assets === void 0) {
+      contribution.assets = part.assets;
+    }
     const declared = part.status !== void 0 || part.redirect !== void 0;
     if (declared && contribution.status === void 0) {
       contribution.status = (_b = part.status) != null ? _b : REDIRECT_FOUND;
@@ -149,7 +159,7 @@ function setupOnce(descriptor) {
 }
 function renderApp(descriptor, request) {
   return __async(this, null, function* () {
-    var _a, _b;
+    var _a, _b, _c;
     yield setupOnce(descriptor);
     const route = {
       params: (_a = request.params) != null ? _a : {},
@@ -165,16 +175,21 @@ function renderApp(descriptor, request) {
         container.bind(RequestContextToken).toValue(request.context);
       }
       yield activateIslandViewModels(container, descriptor, route);
-      const { head, redirect, status = STATUS_OK } = collectDocumentContribution(container, descriptor);
+      const contribution = collectDocumentContribution(container, descriptor);
+      const { data, head, redirect, status = STATUS_OK } = contribution;
       if (status !== STATUS_OK) {
-        return { head, html: "", redirect, state: {}, status };
+        return { data, head, html: "", redirect, state: {}, status };
       }
+      const assets = (_c = contribution.assets) != null ? _c : descriptor.assets;
       const state = collectIslandState(container, descriptor);
+      if (descriptor.view === void 0 || descriptor.viewLayer === void 0) {
+        return { assets, data, head, html: "", state, status };
+      }
       const rendered = resolveViewAdapter(container).renderIsland(descriptor, {
         container,
         slots: request.slots
       });
-      return { assets: descriptor.assets, head, headHtml: rendered.head, html: rendered.html, state, status };
+      return { assets, data, head, headHtml: rendered.head, html: rendered.html, state, status };
     } finally {
       yield container.dispose();
     }

package/{chunk-ZOU6W6ZQ.cjs → chunk-XDM6J4LJ.cjs}

@@ -35,29 +35,33 @@ function getAppContainer() {
 var _logger = require('@foxford/logger');
 var EMPTY_ROUTE = { params: {}, pathname: "", search: "" };
 var REDIRECT_FOUND = 302;
+function registerIslandParts(container, descriptor, islandLog) {
+  var _a, _b, _c;
+  (_a = descriptor.viewLayer) == null ? void 0 : _a.register(container);
+  const viewModels = (_b = descriptor.viewModels) != null ? _b : [];
+  const slots = Object.entries((_c = descriptor.slots) != null ? _c : {});
+  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);
+  }
+}
 function createIslandContainer(descriptor, options = {}) {
-  var _a, _b, _c, _d, _e;
+  var _a, _b, _c;
   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);
-    }
+    registerIslandParts(container, descriptor, islandLog);
     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);
@@ -111,6 +115,12 @@ function collectDocumentContribution(container, descriptor) {
     if (part.head) {
       contribution.head = _chunkT5QVCXVBcjs.__spreadValues.call(void 0, _chunkT5QVCXVBcjs.__spreadValues.call(void 0, {}, contribution.head), part.head);
     }
+    if (part.data) {
+      contribution.data = _chunkT5QVCXVBcjs.__spreadValues.call(void 0, _chunkT5QVCXVBcjs.__spreadValues.call(void 0, {}, contribution.data), part.data);
+    }
+    if (part.assets && contribution.assets === void 0) {
+      contribution.assets = part.assets;
+    }
     const declared = part.status !== void 0 || part.redirect !== void 0;
     if (declared && contribution.status === void 0) {
       contribution.status = (_b = part.status) != null ? _b : REDIRECT_FOUND;
@@ -149,7 +159,7 @@ function setupOnce(descriptor) {
 }
 function renderApp(descriptor, request) {
   return _chunkT5QVCXVBcjs.__async.call(void 0, this, null, function* () {
-    var _a, _b;
+    var _a, _b, _c;
     yield setupOnce(descriptor);
     const route = {
       params: (_a = request.params) != null ? _a : {},
@@ -165,16 +175,21 @@ function renderApp(descriptor, request) {
         container.bind(_chunk6QV4L6R2cjs.RequestContextToken).toValue(request.context);
       }
       yield activateIslandViewModels(container, descriptor, route);
-      const { head, redirect, status = STATUS_OK } = collectDocumentContribution(container, descriptor);
+      const contribution = collectDocumentContribution(container, descriptor);
+      const { data, head, redirect, status = STATUS_OK } = contribution;
       if (status !== STATUS_OK) {
-        return { head, html: "", redirect, state: {}, status };
+        return { data, head, html: "", redirect, state: {}, status };
       }
+      const assets = (_c = contribution.assets) != null ? _c : descriptor.assets;
       const state = collectIslandState(container, descriptor);
+      if (descriptor.view === void 0 || descriptor.viewLayer === void 0) {
+        return { assets, data, head, html: "", state, status };
+      }
       const rendered = _chunkXOJ2VWX4cjs.resolveViewAdapter.call(void 0, container).renderIsland(descriptor, {
         container,
         slots: request.slots
       });
-      return { assets: descriptor.assets, head, headHtml: rendered.head, html: rendered.html, state, status };
+      return { assets, data, head, headHtml: rendered.head, html: rendered.html, state, status };
     } finally {
       yield container.dispose();
     }

package/{chunk-BMI5HNGE.js → chunk-XU5HUIPK.js}

@@ -1,3 +1,6 @@
+import {
+  loadAppEnv
+} from "./chunk-RG7ZV5BD.js";
 import {
   logger
 } from "./chunk-TPBI6TOU.js";
@@ -92,7 +95,9 @@ import config from ${JSON.stringify(configPath)}
 const server = config.server ?? {}
 
 async function setup() {
-  viewAdapterOf(app.viewLayer).installResolver()
+  if (app.viewLayer) {
+    viewAdapterOf(app.viewLayer).installResolver()
+  }
   server.container?.(getAppContainer())
   await server.setup?.()
 }
@@ -109,11 +114,16 @@ export default descriptor
 function generateServerProcess(configPath, base, mode) {
   const assets = mode === "development" ? `  assets: { base: ${JSON.stringify(base)}, dir: fileURLToPath(new URL('./client', import.meta.url)) },
 ` : "";
-  return `${mode === "development" ? "import { fileURLToPath } from 'node:url'\n\n" : ""}import { serveApp } from '@foxford/den/serve'
+  return `import { fileURLToPath } from 'node:url'
+
+import { loadAppEnv, serveApp } from '@foxford/den/serve'
 
 import app from ${JSON.stringify(VIRTUAL_SERVER_APP)}
 import config from ${JSON.stringify(configPath)}
 
+// \u0423\u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044F \u043E\u043A\u0440\u0443\u0436\u0435\u043D\u0438\u044F \u2014 \u0434\u043E \u043F\u0435\u0440\u0432\u043E\u0433\u043E \u0447\u0442\u0435\u043D\u0438\u044F: \u043F\u043E\u0440\u0442 \u0438 \u0430\u0434\u0440\u0435\u0441\u0430 \u0447\u0438\u0442\u0430\u044E\u0442\u0441\u044F \u043D\u0438\u0436\u0435
+loadAppEnv(fileURLToPath(new URL('..', import.meta.url)))
+
 await serveApp(app, {
 ${assets}  configure: config.server?.configure,
   host: process.env.HOST,
@@ -126,7 +136,14 @@ ${assets}  configure: config.server?.configure,
 function denAppModules(options) {
   const { assets, base, config, configPath, entry, mode } = options;
   const sources = {
-    [VIRTUAL_CLIENT]: () => generateClientEntry(entry, config.preset.clientEntry),
+    // Клиентский вход спрашивают только у клиентского выхода, а его без пресета не собирают.
+    // Отказ здесь означает, что выход всё-таки запустили, — это ошибка команд, а не приложения
+    [VIRTUAL_CLIENT]: () => {
+      if (!config.preset) {
+        throw new Error("den: \u043A\u043B\u0438\u0435\u043D\u0442\u0441\u043A\u0438\u0439 \u0432\u0445\u043E\u0434 \u0437\u0430\u043F\u0440\u043E\u0448\u0435\u043D, \u043D\u043E \u043F\u0440\u0435\u0441\u0435\u0442 \u043D\u0435 \u043E\u0431\u044A\u044F\u0432\u043B\u0435\u043D \u2014 \u043E\u0436\u0438\u0432\u043B\u044F\u0442\u044C \u043D\u0435\u0447\u0435\u043C");
+      }
+      return generateClientEntry(entry, config.preset.clientEntry);
+    },
     [VIRTUAL_SERVER_APP]: () => generateServerApp(entry, configPath, assets),
     [VIRTUAL_SERVER_PROCESS]: () => generateServerProcess(configPath, base, mode)
   };
@@ -167,8 +184,8 @@ function loadAppConfig(root) {
     try {
       const loaded = yield server.ssrLoadModule(configPath);
       const config = loaded.default;
-      if (!(config == null ? void 0 : config.preset)) {
-        throw new Error(`den: ${CONFIG_FILE} \u043D\u0435 \u043E\u0431\u044A\u044F\u0432\u043B\u044F\u0435\u0442 \u043F\u0440\u0435\u0441\u0435\u0442 \u0444\u0440\u0435\u0439\u043C\u0432\u043E\u0440\u043A\u0430 \u2014 \u0441\u043E\u0431\u0438\u0440\u0430\u0442\u044C \u043D\u0435\u0447\u0435\u043C`);
+      if (!config) {
+        throw new Error(`den: ${CONFIG_FILE} \u043D\u0435 \u043E\u0442\u0434\u0430\u0451\u0442 \u043A\u043E\u043D\u0444\u0438\u0433 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u044F \u2014 \u0441\u043E\u0431\u0438\u0440\u0430\u0442\u044C \u043D\u0435\u0447\u0435\u043C`);
       }
       return { config, configPath };
     } finally {
@@ -186,7 +203,7 @@ function dependenciesOf(root) {
   return [...Object.keys((_a = manifest.dependencies) != null ? _a : {}), ...Object.keys((_b = manifest.devDependencies) != null ? _b : {})];
 }
 function viteConfigFor(options) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d, _e;
   const { assets, base, config, configPath, entryFileNames, input, mode, outDir, root, target } = options;
   const entry = (_a = config.entry) != null ? _a : "src/index.ts";
   const composed = {
@@ -211,34 +228,43 @@ function viteConfigFor(options) {
     // программный вызов он иначе не доедет.
     mode,
     plugins: [
-      ...config.preset.plugins,
+      ...(_c = (_b = config.preset) == null ? void 0 : _b.plugins) != null ? _c : [],
       denAppModules({ assets, base, config, configPath, entry: path2.join(root, entry), mode })
     ],
     root,
-    ssr: { noExternal: (_c = (_b = config.server) == null ? void 0 : _b.noExternal) != null ? _c : [] }
+    ssr: { noExternal: (_e = (_d = config.server) == null ? void 0 : _d.noExternal) != null ? _e : [] }
   };
   return config.vite ? config.vite(composed, target) : composed;
 }
 function buildApp(options) {
   return __async(this, null, function* () {
-    var _a, _b, _c, _d;
+    var _a, _b, _c;
     const { mode = "production" } = options;
     process.env["NODE_ENV"] = mode;
     const root = path2.resolve(options.root);
+    loadAppEnv(root);
     const { config, configPath } = yield loadAppConfig(root);
     const port = resolvePort((_a = config.server) == null ? void 0 : _a.port);
     const base = (_b = options.base) != null ? _b : "";
-    const refusal = (_d = (_c = config.preset).validate) == null ? void 0 : _d.call(_c, dependenciesOf(root));
+    const { preset } = config;
+    const refusal = (_c = preset == null ? void 0 : preset.validate) == null ? void 0 : _c.call(preset, dependenciesOf(root));
     if (refusal !== void 0 && refusal !== null) {
       throw new Error(`den: ${refusal}`);
     }
     const { build } = yield import("vite");
     const shared = { base, config, configPath, mode, root };
     const empty = { css: [], js: [] };
-    logger.info(`\u0441\u0431\u043E\u0440\u043A\u0430 \u043A\u043B\u0438\u0435\u043D\u0442\u0441\u043A\u043E\u0433\u043E \u0432\u044B\u0445\u043E\u0434\u0430 (${config.preset.view})`);
-    yield build(viteConfigFor(__spreadProps(__spreadValues({}, shared), { assets: empty, input: VIRTUAL_CLIENT, outDir: OUT_CLIENT, target: "client" })));
-    const assets = collectAssets(path2.join(root, OUT_CLIENT), base);
-    logger.info(`\u0430\u0440\u0442\u0435\u0444\u0430\u043A\u0442\u044B: ${String(assets.js.length)} js, ${String(assets.css.length)} css`);
+    let assets = empty;
+    if (preset) {
+      logger.info(`\u0441\u0431\u043E\u0440\u043A\u0430 \u043A\u043B\u0438\u0435\u043D\u0442\u0441\u043A\u043E\u0433\u043E \u0432\u044B\u0445\u043E\u0434\u0430 (${preset.view})`);
+      yield build(
+        viteConfigFor(__spreadProps(__spreadValues({}, shared), { assets: empty, input: VIRTUAL_CLIENT, outDir: OUT_CLIENT, target: "client" }))
+      );
+      assets = collectAssets(path2.join(root, OUT_CLIENT), base);
+      logger.info(`\u0430\u0440\u0442\u0435\u0444\u0430\u043A\u0442\u044B: ${String(assets.js.length)} js, ${String(assets.css.length)} css`);
+    } else {
+      logger.info("\u043A\u043B\u0438\u0435\u043D\u0442\u0441\u043A\u043E\u0433\u043E \u0432\u044B\u0445\u043E\u0434\u0430 \u043D\u0435\u0442: \u043F\u0440\u0435\u0441\u0435\u0442 \u043D\u0435 \u043E\u0431\u044A\u044F\u0432\u043B\u0435\u043D, \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u0435 \u0441\u0432\u043E\u0435\u0433\u043E \u0444\u0440\u0430\u0433\u043C\u0435\u043D\u0442\u0430 \u043D\u0435 \u0440\u0438\u0441\u0443\u0435\u0442");
+    }
     logger.info("\u0441\u0431\u043E\u0440\u043A\u0430 \u0441\u0435\u0440\u0432\u0435\u0440\u043D\u043E\u0433\u043E \u0434\u0435\u0441\u043A\u0440\u0438\u043F\u0442\u043E\u0440\u0430");
     yield build(
       viteConfigFor(__spreadProps(__spreadValues({}, shared), {
@@ -309,7 +335,9 @@ function bannerLines(facts2) {
     `${label("\u043B\u043E\u043A\u0430\u043B\u044C\u043D\u043E")}http://localhost:${port}`,
     ...network === void 0 ? [] : [`${label("\u0432 \u0441\u0435\u0442\u0438")}http://${network}:${port}`],
     `${label("\u0440\u0443\u0447\u043A\u0438")}${ENDPOINTS.join("   ")}`,
-    ...facts2.base === void 0 ? [] : [`${label("\u0430\u0440\u0442\u0435\u0444\u0430\u043A\u0442\u044B")}${facts2.base}`],
+    // Префикс печатается, только когда он есть: при относительной сборке артефакты идут с
+    // адреса самого приложения, а он уже назван строкой выше
+    ...facts2.base === void 0 || facts2.base === "" ? [] : [`${label("\u043F\u0440\u0435\u0444\u0438\u043A\u0441")}${facts2.base}`],
     `${label("\u0447\u0430\u043D\u043A\u0438")}${assetsSummary(facts2.assets)}`,
     `${label("\u0432\u044B\u0445\u043E\u0434\u044B")}${OUTPUTS.join(", ")}`,
     `${label("\u043F\u0440\u0430\u0432\u043A\u0438")}${facts2.watched.join(", ")}`,

package/{descriptor-Dujg_1on.d.cts → descriptor-BfsBDME1.d.cts}

@@ -14,6 +14,11 @@ import { Token } from '@foxford/ioc';
  * шире: у каждого своя часть про оркестрацию — `load`, `routes`, `provides`/`requires`,
  * вклад в документ. Сводить их в один тип нечем, оркестраторы у хостов разные. Общее
  * ровно это, и структурная типизация делает остальное: дескриптор хоста подходит сюда как есть.
+ *
+ * `view` и `viewLayer` объявляются ПАРОЙ либо не объявляются вовсе. Приложение без них —
+ * законный случай: оно сообщает документу данные (`describeDocument`), а рисует его кусок
+ * кто-то другой, например клиент монолита. Жизненный цикл у такого приложения тот же —
+ * контейнер, единицы, активация VM, — поэтому второго вида дескриптора нет.
  */
 interface IslandDescriptor {
     /**
@@ -25,16 +30,16 @@ interface IslandDescriptor {
      * второго оно обязательное: без него у мест приложения не было бы адреса.
      */
     name: string;
-    /** Непрозрачная ссылка на view острова (компонент view-фреймворка). */
-    view: unknown;
+    /** Непрозрачная ссылка на view острова (компонент view-фреймворка); нет — приложение не рисует. */
+    view?: unknown;
     /**
      * View-слой — чем остров рисовать: `defineLayer(ViewLayerToken, { adapter: reactAdapter() })`.
      *
-     * Обязателен, и дефолта нет ни у ядра, ни у хоста: фреймворк за приложение не выбирают.
-     * Слой регистрируется в контейнере острова, поэтому слоты внутри по умолчанию рисуются
-     * им же; слот перекрывает выбор своим `viewLayer`.
+     * Дефолта нет ни у ядра, ни у хоста: фреймворк за приложение не выбирают. Слой
+     * регистрируется в контейнере острова, поэтому слоты внутри по умолчанию рисуются им же;
+     * слот перекрывает выбор своим `viewLayer`.
      */
-    viewLayer: LayerDefinition;
+    viewLayer?: LayerDefinition;
     /**
      * Data/Business единицы (repository/service). Регистрируются в контейнере острова.
      * Не должны импортировать VM.
@@ -89,10 +94,15 @@ interface IslandDescriptor {
  *
  * Ленивые чанки сюда не попадают — их браузер дотянет сам по мере надобности, а хосту
  * нужно ровно то, без чего страница не оживёт.
+ *
+ * Вид скриптов объявлен здесь же, потому что знает его СБОРКА: теги печатает хост, но выбрать
+ * между `type="module"` и классическим `defer` он может, только зная, чем приложение собрано.
  */
 interface AppAssets {
     css: string[];
     js: string[];
+    /** Чем подключать `js`; не объявлен — `module`. */
+    scripts?: 'module' | 'classic';
 }
 
 export type { AppAssets as A, IslandDescriptor as I };

package/{descriptor-DQ6Gi7A_.d.ts → descriptor-D8ocBnTb.d.ts}

@@ -14,6 +14,11 @@ import { Token } from '@foxford/ioc';
  * шире: у каждого своя часть про оркестрацию — `load`, `routes`, `provides`/`requires`,
  * вклад в документ. Сводить их в один тип нечем, оркестраторы у хостов разные. Общее
  * ровно это, и структурная типизация делает остальное: дескриптор хоста подходит сюда как есть.
+ *
+ * `view` и `viewLayer` объявляются ПАРОЙ либо не объявляются вовсе. Приложение без них —
+ * законный случай: оно сообщает документу данные (`describeDocument`), а рисует его кусок
+ * кто-то другой, например клиент монолита. Жизненный цикл у такого приложения тот же —
+ * контейнер, единицы, активация VM, — поэтому второго вида дескриптора нет.
  */
 interface IslandDescriptor {
     /**
@@ -25,16 +30,16 @@ interface IslandDescriptor {
      * второго оно обязательное: без него у мест приложения не было бы адреса.
      */
     name: string;
-    /** Непрозрачная ссылка на view острова (компонент view-фреймворка). */
-    view: unknown;
+    /** Непрозрачная ссылка на view острова (компонент view-фреймворка); нет — приложение не рисует. */
+    view?: unknown;
     /**
      * View-слой — чем остров рисовать: `defineLayer(ViewLayerToken, { adapter: reactAdapter() })`.
      *
-     * Обязателен, и дефолта нет ни у ядра, ни у хоста: фреймворк за приложение не выбирают.
-     * Слой регистрируется в контейнере острова, поэтому слоты внутри по умолчанию рисуются
-     * им же; слот перекрывает выбор своим `viewLayer`.
+     * Дефолта нет ни у ядра, ни у хоста: фреймворк за приложение не выбирают. Слой
+     * регистрируется в контейнере острова, поэтому слоты внутри по умолчанию рисуются им же;
+     * слот перекрывает выбор своим `viewLayer`.
      */
-    viewLayer: LayerDefinition;
+    viewLayer?: LayerDefinition;
     /**
      * Data/Business единицы (repository/service). Регистрируются в контейнере острова.
      * Не должны импортировать VM.
@@ -89,10 +94,15 @@ interface IslandDescriptor {
  *
  * Ленивые чанки сюда не попадают — их браузер дотянет сам по мере надобности, а хосту
  * нужно ровно то, без чего страница не оживёт.
+ *
+ * Вид скриптов объявлен здесь же, потому что знает его СБОРКА: теги печатает хост, но выбрать
+ * между `type="module"` и классическим `defer` он может, только зная, чем приложение собрано.
  */
 interface AppAssets {
     css: string[];
     js: string[];
+    /** Чем подключать `js`; не объявлен — `module`. */
+    scripts?: 'module' | 'classic';
 }
 
 export type { AppAssets as A, IslandDescriptor as I };

package/index.d.cts

@@ -4,8 +4,8 @@ import { Container, Token } from '@foxford/ioc';
 import { DefinitionResolver } from './adapter.cjs';
 export { d as defineRepository, a as defineService, b as defineViewModel } from './define-repository-CwAXed2X.cjs';
 export { D as DefineSlotOptions, S as SlotDefinition, d as defineSlot } from './define-slot-DYNCLDJY.cjs';
-export { V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken } from './view-adapter-DJ7yB6Ml.cjs';
-import './descriptor-Dujg_1on.cjs';
+export { V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken } from './view-adapter-Cia9blgH.cjs';
+import './descriptor-BfsBDME1.cjs';
 import './server-render-CocWXQKC.cjs';
 
 /**

package/index.d.ts

@@ -4,8 +4,8 @@ import { Container, Token } from '@foxford/ioc';
 import { DefinitionResolver } from './adapter.js';
 export { d as defineRepository, a as defineService, b as defineViewModel } from './define-repository-q_T4hqeP.js';
 export { D as DefineSlotOptions, S as SlotDefinition, d as defineSlot } from './define-slot-Cngzae6i.js';
-export { V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken } from './view-adapter-B4gEb-ms.js';
-import './descriptor-DQ6Gi7A_.js';
+export { V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken } from './view-adapter-Bzcjotsn.js';
+import './descriptor-D8ocBnTb.js';
 import './server-render-CocWXQKC.js';
 
 /**

package/island/index.cjs

@@ -11,7 +11,7 @@
 
 
 
-var _chunkZOU6W6ZQcjs = require('../chunk-ZOU6W6ZQ.cjs');
+var _chunkXDM6J4LJcjs = require('../chunk-XDM6J4LJ.cjs');
 
 
 
@@ -122,4 +122,4 @@ function describeIsland(descriptor, denState) {
 
 
 
-exports.DOCUMENT_EVENT = DOCUMENT_EVENT; exports.NAVIGATE_EVENT = NAVIGATE_EVENT; exports.ViewLayerToken = _chunkXOJ2VWX4cjs.ViewLayerToken; exports.activateIslandViewModels = _chunkZOU6W6ZQcjs.activateIslandViewModels; exports.collectDocumentContribution = _chunkZOU6W6ZQcjs.collectDocumentContribution; exports.collectIslandState = _chunkZOU6W6ZQcjs.collectIslandState; exports.createIslandContainer = _chunkZOU6W6ZQcjs.createIslandContainer; exports.describeIsland = describeIsland; exports.getAppContainer = _chunkZOU6W6ZQcjs.getAppContainer; exports.getIslandsSnapshot = getIslandsSnapshot; exports.hydrateIslandState = _chunkZOU6W6ZQcjs.hydrateIslandState; exports.isDocumentSource = _chunkZOU6W6ZQcjs.isDocumentSource; exports.matchRoute = _chunkZOU6W6ZQcjs.matchRoute; exports.navigateIsland = navigateIsland; exports.normalizeRoutes = _chunkZOU6W6ZQcjs.normalizeRoutes; exports.onIslandDocument = onIslandDocument; exports.onIslandNavigate = onIslandNavigate; exports.pathPattern = _chunkZOU6W6ZQcjs.pathPattern; exports.publishIslandDocument = publishIslandDocument; exports.registerIsland = registerIsland; exports.renderApp = _chunkZOU6W6ZQcjs.renderApp; exports.resolveEagerUnits = _chunkZOU6W6ZQcjs.resolveEagerUnits; exports.resolveViewAdapter = _chunkXOJ2VWX4cjs.resolveViewAdapter; exports.slotAddress = slotAddress; exports.subscribeIslands = subscribeIslands; exports.viewAdapterOf = _chunkXOJ2VWX4cjs.viewAdapterOf;
+exports.DOCUMENT_EVENT = DOCUMENT_EVENT; exports.NAVIGATE_EVENT = NAVIGATE_EVENT; exports.ViewLayerToken = _chunkXOJ2VWX4cjs.ViewLayerToken; exports.activateIslandViewModels = _chunkXDM6J4LJcjs.activateIslandViewModels; exports.collectDocumentContribution = _chunkXDM6J4LJcjs.collectDocumentContribution; exports.collectIslandState = _chunkXDM6J4LJcjs.collectIslandState; exports.createIslandContainer = _chunkXDM6J4LJcjs.createIslandContainer; exports.describeIsland = describeIsland; exports.getAppContainer = _chunkXDM6J4LJcjs.getAppContainer; exports.getIslandsSnapshot = getIslandsSnapshot; exports.hydrateIslandState = _chunkXDM6J4LJcjs.hydrateIslandState; exports.isDocumentSource = _chunkXDM6J4LJcjs.isDocumentSource; exports.matchRoute = _chunkXDM6J4LJcjs.matchRoute; exports.navigateIsland = navigateIsland; exports.normalizeRoutes = _chunkXDM6J4LJcjs.normalizeRoutes; exports.onIslandDocument = onIslandDocument; exports.onIslandNavigate = onIslandNavigate; exports.pathPattern = _chunkXDM6J4LJcjs.pathPattern; exports.publishIslandDocument = publishIslandDocument; exports.registerIsland = registerIsland; exports.renderApp = _chunkXDM6J4LJcjs.renderApp; exports.resolveEagerUnits = _chunkXDM6J4LJcjs.resolveEagerUnits; exports.resolveViewAdapter = _chunkXOJ2VWX4cjs.resolveViewAdapter; exports.slotAddress = slotAddress; exports.subscribeIslands = subscribeIslands; exports.viewAdapterOf = _chunkXOJ2VWX4cjs.viewAdapterOf;

package/island/index.d.cts

@@ -1,9 +1,9 @@
-import { I as IslandDescriptor, A as AppAssets } from '../descriptor-Dujg_1on.cjs';
+import { A as AppAssets, I as IslandDescriptor } from '../descriptor-BfsBDME1.cjs';
 import { Container } from '@foxford/ioc';
 import { R as RequestContext } from '../types-Dx5qGiwk.cjs';
 export { A as AppRoute, R as RouteDeclaration, a as RouteMatch, m as matchRoute, n as normalizeRoutes, p as pathPattern } from '../routes-B0hDrkiF.cjs';
 export { R as RenderTree, a as ServerRender, S as ServerRenderResult } from '../server-render-CocWXQKC.cjs';
-export { R as RenderIslandOptions, V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken, r as resolveViewAdapter, v as viewAdapterOf } from '../view-adapter-DJ7yB6Ml.cjs';
+export { R as RenderIslandOptions, V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken, r as resolveViewAdapter, v as viewAdapterOf } from '../view-adapter-Cia9blgH.cjs';
 import '../define-slot-DYNCLDJY.cjs';
 
 /** Вклад приложения в `<head>` документа. */
@@ -33,6 +33,10 @@ interface DocumentContribution {
     status?: number;
     /** Адрес для 3xx. Объявлен без статуса — исход `302`. */
     redirect?: string;
+    /** Данные документа, состав которых знает только шаблон хоста. */
+    data?: Record<string, unknown>;
+    /** Артефакты этого адреса; не объявлены — берутся вплавленные сборкой. */
+    assets?: AppAssets;
 }
 /**
  * VM, которой есть что сказать про документ.
@@ -138,10 +142,11 @@ declare function collectIslandState(container: Container, descriptor: IslandDesc
 /**
  * Собирает вклад острова в документ по всем его VM.
  *
- * Правила слияния два, и они следуют из смысла полей. `head` — набор полей, поэтому
- * объявленное позже уточняет объявленное раньше. Исход (`status` вместе с `redirect`) —
- * ОДНО решение, а не набор: побеждает первое объявленное, и берётся оно целиком, иначе
- * статус одной VM склеился бы с адресом другой.
+ * Правила слияния два, и они следуют из смысла полей. `head` и `data` — наборы полей, поэтому
+ * объявленное позже уточняет объявленное раньше. Исход (`status` вместе с `redirect`) и
+ * артефакты — ОДНО решение каждое, а не набор: побеждает первое объявленное, и берётся оно
+ * целиком. Иначе статус одной VM склеился бы с адресом другой, а списки чанков двух VM —
+ * в набор, который не грузил ни один клиент.
  *
  * @param container - Контейнер острова
  * @param descriptor - Дескриптор острова
@@ -241,6 +246,8 @@ interface RenderAppResult {
     head?: DocumentHead;
     /** Вклад в `<head>` готовой разметкой — стили, собранные во время рендера. */
     headHtml?: string;
+    /** Данные документа, состав которых знает шаблон хоста. */
+    data?: Record<string, unknown>;
     /** Адрес для 3xx. */
     redirect?: string;
     /**

package/island/index.d.ts

@@ -1,9 +1,9 @@
-import { I as IslandDescriptor, A as AppAssets } from '../descriptor-DQ6Gi7A_.js';
+import { A as AppAssets, I as IslandDescriptor } from '../descriptor-D8ocBnTb.js';
 import { Container } from '@foxford/ioc';
 import { R as RequestContext } from '../types-Dx5qGiwk.js';
 export { A as AppRoute, R as RouteDeclaration, a as RouteMatch, m as matchRoute, n as normalizeRoutes, p as pathPattern } from '../routes-0uXJ0fux.js';
 export { R as RenderTree, a as ServerRender, S as ServerRenderResult } from '../server-render-CocWXQKC.js';
-export { R as RenderIslandOptions, V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken, r as resolveViewAdapter, v as viewAdapterOf } from '../view-adapter-B4gEb-ms.js';
+export { R as RenderIslandOptions, V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken, r as resolveViewAdapter, v as viewAdapterOf } from '../view-adapter-Bzcjotsn.js';
 import '../define-slot-Cngzae6i.js';
 
 /** Вклад приложения в `<head>` документа. */
@@ -33,6 +33,10 @@ interface DocumentContribution {
     status?: number;
     /** Адрес для 3xx. Объявлен без статуса — исход `302`. */
     redirect?: string;
+    /** Данные документа, состав которых знает только шаблон хоста. */
+    data?: Record<string, unknown>;
+    /** Артефакты этого адреса; не объявлены — берутся вплавленные сборкой. */
+    assets?: AppAssets;
 }
 /**
  * VM, которой есть что сказать про документ.
@@ -138,10 +142,11 @@ declare function collectIslandState(container: Container, descriptor: IslandDesc
 /**
  * Собирает вклад острова в документ по всем его VM.
  *
- * Правила слияния два, и они следуют из смысла полей. `head` — набор полей, поэтому
- * объявленное позже уточняет объявленное раньше. Исход (`status` вместе с `redirect`) —
- * ОДНО решение, а не набор: побеждает первое объявленное, и берётся оно целиком, иначе
- * статус одной VM склеился бы с адресом другой.
+ * Правила слияния два, и они следуют из смысла полей. `head` и `data` — наборы полей, поэтому
+ * объявленное позже уточняет объявленное раньше. Исход (`status` вместе с `redirect`) и
+ * артефакты — ОДНО решение каждое, а не набор: побеждает первое объявленное, и берётся оно
+ * целиком. Иначе статус одной VM склеился бы с адресом другой, а списки чанков двух VM —
+ * в набор, который не грузил ни один клиент.
  *
  * @param container - Контейнер острова
  * @param descriptor - Дескриптор острова
@@ -241,6 +246,8 @@ interface RenderAppResult {
     head?: DocumentHead;
     /** Вклад в `<head>` готовой разметкой — стили, собранные во время рендера. */
     headHtml?: string;
+    /** Данные документа, состав которых знает шаблон хоста. */
+    data?: Record<string, unknown>;
     /** Адрес для 3xx. */
     redirect?: string;
     /**

package/island/index.js

@@ -11,7 +11,7 @@ import {
   pathPattern,
   renderApp,
   resolveEagerUnits
-} from "../chunk-TPHJUDHG.js";
+} from "../chunk-SOH2TL2N.js";
 import {
   ViewLayerToken,
   resolveViewAdapter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxford/den",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "description": "Den — декларативный метафреймворк Foxford (core runtime)",
   "keywords": [
     "foxford",
@@ -24,8 +24,8 @@
   },
   "dependencies": {
     "fastify": "^5.11.2",
-    "@foxford/logger": "^1.2.2",
-    "@foxford/ioc": "^1.1.2"
+    "@foxford/ioc": "^1.1.2",
+    "@foxford/logger": "^1.2.2"
   },
   "peerDependencies": {
     "vite": ">=5.0.0"
@@ -83,21 +83,23 @@
     "bin",
     "builder",
     "chunk-3RX2OSUL.js",
+    "chunk-3X4WVHUU.cjs",
     "chunk-6FNC3XMI.js",
     "chunk-6QV4L6R2.cjs",
     "chunk-A6ZPAM6Z.cjs",
-    "chunk-BMI5HNGE.js",
     "chunk-C7BM4DGX.cjs",
     "chunk-E23E2VUC.js",
+    "chunk-KQAB6C6Q.cjs",
     "chunk-MCN4GFEQ.js",
-    "chunk-RRR2DJMN.cjs",
+    "chunk-RG7ZV5BD.js",
+    "chunk-SOH2TL2N.js",
     "chunk-T5QVCXVB.cjs",
     "chunk-TPBI6TOU.js",
-    "chunk-TPHJUDHG.js",
     "chunk-WBHHHICS.js",
+    "chunk-XDM6J4LJ.cjs",
     "chunk-XOJ2VWX4.cjs",
+    "chunk-XU5HUIPK.js",
     "chunk-Z5BL4DJA.cjs",
-    "chunk-ZOU6W6ZQ.cjs",
     "define-repository-CwAXed2X.d.cts",
     "define-repository-q_T4hqeP.d.ts",
     "define-slot-Cngzae6i.d.ts",
@@ -107,8 +109,8 @@
     "define.d.ts",
     "define.js",
     "den.js",
-    "descriptor-DQ6Gi7A_.d.ts",
-    "descriptor-Dujg_1on.d.cts",
+    "descriptor-BfsBDME1.d.cts",
+    "descriptor-D8ocBnTb.d.ts",
     "index.cjs",
     "index.d.cts",
     "index.d.ts",
@@ -122,9 +124,9 @@
     "server-render-CocWXQKC.d.ts",
     "types-Dx5qGiwk.d.cts",
     "types-Dx5qGiwk.d.ts",
-    "view-adapter-B4gEb-ms.d.ts",
-    "view-adapter-DJ7yB6Ml.d.cts"
+    "view-adapter-Bzcjotsn.d.ts",
+    "view-adapter-Cia9blgH.d.cts"
   ],
-  "sha": "c382a3d",
+  "sha": "7fa6f3e",
   "scripts": {}
 }

package/serve/index.cjs

@@ -1,8 +1,11 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
+var _chunkKQAB6C6Qcjs = require('../chunk-KQAB6C6Q.cjs');
 
 
-var _chunkZOU6W6ZQcjs = require('../chunk-ZOU6W6ZQ.cjs');
+
+
+var _chunkXDM6J4LJcjs = require('../chunk-XDM6J4LJ.cjs');
 require('../chunk-XOJ2VWX4.cjs');
 require('../chunk-6QV4L6R2.cjs');
 
@@ -66,14 +69,14 @@ function registerAssets(instance, source) {
 
 var DEFAULT_SLOW_RENDER_MS = 1e3;
 function claim(app) {
-  return _chunkZOU6W6ZQcjs.normalizeRoutes.call(void 0, app.routes).map((route) => route.source);
+  return _chunkXDM6J4LJcjs.normalizeRoutes.call(void 0, app.routes).map((route) => route.source);
 }
 function matchClaim(app, pathname) {
   var _a, _b;
   if (claim(app).length === 0) {
     return {};
   }
-  return (_b = (_a = _chunkZOU6W6ZQcjs.matchRoute.call(void 0, app.routes, pathname)) == null ? void 0 : _a.params) != null ? _b : null;
+  return (_b = (_a = _chunkXDM6J4LJcjs.matchRoute.call(void 0, app.routes, pathname)) == null ? void 0 : _a.params) != null ? _b : null;
 }
 function parseCookies(header) {
   const cookies = {};
@@ -129,7 +132,7 @@ var appPlugin = (instance, options) => {
     }
     const startedAt = Date.now();
     try {
-      const result = yield _chunkZOU6W6ZQcjs.renderApp.call(void 0, app, { context: browserContext(req), params, pathname, search });
+      const result = yield _chunkXDM6J4LJcjs.renderApp.call(void 0, app, { context: browserContext(req), params, pathname, search });
       const elapsed = Date.now() - startedAt;
       if (elapsed >= slowRenderMs) {
         serveLog.warn(`\u043C\u0435\u0434\u043B\u0435\u043D\u043D\u044B\u0439 \u0440\u0435\u043D\u0434\u0435\u0440 \xAB${pathname}\xBB: ${String(elapsed)}\u043C\u0441`);
@@ -184,4 +187,5 @@ function serveApp(_0) {
 
 
 
-exports.appPlugin = appPlugin; exports.registerAssets = registerAssets; exports.serveApp = serveApp;
+
+exports.appPlugin = appPlugin; exports.loadAppEnv = _chunkKQAB6C6Qcjs.loadAppEnv; exports.registerAssets = registerAssets; exports.serveApp = serveApp;

package/serve/index.d.cts

@@ -1,5 +1,5 @@
 import { FastifyInstance, FastifyPluginAsync } from 'fastify';
-import { I as IslandDescriptor } from '../descriptor-Dujg_1on.cjs';
+import { I as IslandDescriptor } from '../descriptor-BfsBDME1.cjs';
 import { A as AppRoute } from '../routes-B0hDrkiF.cjs';
 import '../define-slot-DYNCLDJY.cjs';
 import '../types-Dx5qGiwk.cjs';
@@ -41,6 +41,15 @@ interface AppPluginOptions {
  */
 declare const appPlugin: FastifyPluginAsync<AppPluginOptions>;
 
+/**
+ * Кладёт умолчания из `<root>/.env` в окружение процесса.
+ *
+ * Отсутствие файла — норма, а не отказ: он локальный и в репозиторий не попадает.
+ *
+ * @param root - Корень приложения
+ */
+declare function loadAppEnv(root: string): void;
+
 /** Настройки инстанса. */
 interface ServeAppOptions {
     /** Порт; `0` — свободный, фактический смотри в `server.addresses()`. */
@@ -79,4 +88,4 @@ interface ServeAppOptions {
  */
 declare function serveApp(app: ServableApp, options?: ServeAppOptions): Promise<FastifyInstance>;
 
-export { type AppAssetsSource, type AppPluginOptions, type ServableApp, type ServeAppOptions, appPlugin, registerAssets, serveApp };
+export { type AppAssetsSource, type AppPluginOptions, type ServableApp, type ServeAppOptions, appPlugin, loadAppEnv, registerAssets, serveApp };

package/serve/index.d.ts

@@ -1,5 +1,5 @@
 import { FastifyInstance, FastifyPluginAsync } from 'fastify';
-import { I as IslandDescriptor } from '../descriptor-DQ6Gi7A_.js';
+import { I as IslandDescriptor } from '../descriptor-D8ocBnTb.js';
 import { A as AppRoute } from '../routes-0uXJ0fux.js';
 import '../define-slot-Cngzae6i.js';
 import '../types-Dx5qGiwk.js';
@@ -41,6 +41,15 @@ interface AppPluginOptions {
  */
 declare const appPlugin: FastifyPluginAsync<AppPluginOptions>;
 
+/**
+ * Кладёт умолчания из `<root>/.env` в окружение процесса.
+ *
+ * Отсутствие файла — норма, а не отказ: он локальный и в репозиторий не попадает.
+ *
+ * @param root - Корень приложения
+ */
+declare function loadAppEnv(root: string): void;
+
 /** Настройки инстанса. */
 interface ServeAppOptions {
     /** Порт; `0` — свободный, фактический смотри в `server.addresses()`. */
@@ -79,4 +88,4 @@ interface ServeAppOptions {
  */
 declare function serveApp(app: ServableApp, options?: ServeAppOptions): Promise<FastifyInstance>;
 
-export { type AppAssetsSource, type AppPluginOptions, type ServableApp, type ServeAppOptions, appPlugin, registerAssets, serveApp };
+export { type AppAssetsSource, type AppPluginOptions, type ServableApp, type ServeAppOptions, appPlugin, loadAppEnv, registerAssets, serveApp };

package/serve/index.js

@@ -1,8 +1,11 @@
+import {
+  loadAppEnv
+} from "../chunk-RG7ZV5BD.js";
 import {
   matchRoute,
   normalizeRoutes,
   renderApp
-} from "../chunk-TPHJUDHG.js";
+} from "../chunk-SOH2TL2N.js";
 import "../chunk-E23E2VUC.js";
 import "../chunk-3RX2OSUL.js";
 import {
@@ -182,6 +185,7 @@ function serveApp(_0) {
 }
 export {
   appPlugin,
+  loadAppEnv,
   registerAssets,
   serveApp
 };

package/{view-adapter-B4gEb-ms.d.ts → view-adapter-Bzcjotsn.d.ts}

@@ -1,4 +1,4 @@
-import { I as IslandDescriptor } from './descriptor-DQ6Gi7A_.js';
+import { I as IslandDescriptor } from './descriptor-D8ocBnTb.js';
 import { S as ServerRenderResult } from './server-render-CocWXQKC.js';
 import { L as LayerDefinition, h as LayerConfig } from './types-Dx5qGiwk.js';
 import { Container, Token } from '@foxford/ioc';

package/{view-adapter-DJ7yB6Ml.d.cts → view-adapter-Cia9blgH.d.cts}

@@ -1,4 +1,4 @@
-import { I as IslandDescriptor } from './descriptor-Dujg_1on.cjs';
+import { I as IslandDescriptor } from './descriptor-BfsBDME1.cjs';
 import { S as ServerRenderResult } from './server-render-CocWXQKC.cjs';
 import { L as LayerDefinition, h as LayerConfig } from './types-Dx5qGiwk.cjs';
 import { Container, Token } from '@foxford/ioc';