@foxford/den 3.1.1 → 3.1.3

package/bin/den.cjs

@@ -1,7 +1,7 @@
 "use strict";
 
 
-var _chunkOKRO4G4Lcjs = require('../chunk-OKRO4G4L.cjs');
+var _chunkZBB5SBEVcjs = require('../chunk-ZBB5SBEV.cjs');
 require('../chunk-A6ZPAM6Z.cjs');
 
 
@@ -69,11 +69,11 @@ function run(argv) {
     }
     const target = { base: options["base"], root: (_a = options["root"]) != null ? _a : process.cwd() };
     if (command === "build") {
-      yield _chunkOKRO4G4Lcjs.buildApp.call(void 0, target);
+      yield _chunkZBB5SBEVcjs.buildApp.call(void 0, target);
       return;
     }
     if (command === "dev") {
-      yield _chunkOKRO4G4Lcjs.devApp.call(void 0, target);
+      yield _chunkZBB5SBEVcjs.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,7 @@
 import {
   buildApp,
   devApp
-} from "../chunk-REFU7UMG.js";
+} from "../chunk-YECHY3NR.js";
 import "../chunk-TPBI6TOU.js";
 import {
   __async

package/builder/index.cjs

@@ -2,11 +2,11 @@
 
 
 
-var _chunkOKRO4G4Lcjs = require('../chunk-OKRO4G4L.cjs');
+var _chunkZBB5SBEVcjs = require('../chunk-ZBB5SBEV.cjs');
 require('../chunk-A6ZPAM6Z.cjs');
 require('../chunk-T5QVCXVB.cjs');
 
 
 
 
-exports.buildApp = _chunkOKRO4G4Lcjs.buildApp; exports.defineAppConfig = _chunkOKRO4G4Lcjs.defineAppConfig; exports.devApp = _chunkOKRO4G4Lcjs.devApp;
+exports.buildApp = _chunkZBB5SBEVcjs.buildApp; exports.defineAppConfig = _chunkZBB5SBEVcjs.defineAppConfig; exports.devApp = _chunkZBB5SBEVcjs.devApp;

package/builder/index.d.cts

@@ -93,12 +93,16 @@ interface AppConfig {
  */
 declare function defineAppConfig(config: AppConfig): AppConfig;
 
+/** Режим сборки: им плагины выбирают рантайм фреймворка. */
+type BuildMode = 'production' | 'development';
 /** Что нужно собрать. */
 interface BuildAppOptions {
     /** Корень приложения. */
     root: string;
     /** Префикс адресов артефактов: в проде CDN, в разработке развязка у хоста. */
     base?: string;
+    /** Режим сборки; по умолчанию `production`. */
+    mode?: BuildMode;
 }
 /**
  * Собирает приложение целиком.

package/builder/index.d.ts

@@ -93,12 +93,16 @@ interface AppConfig {
  */
 declare function defineAppConfig(config: AppConfig): AppConfig;
 
+/** Режим сборки: им плагины выбирают рантайм фреймворка. */
+type BuildMode = 'production' | 'development';
 /** Что нужно собрать. */
 interface BuildAppOptions {
     /** Корень приложения. */
     root: string;
     /** Префикс адресов артефактов: в проде CDN, в разработке развязка у хоста. */
     base?: string;
+    /** Режим сборки; по умолчанию `production`. */
+    mode?: BuildMode;
 }
 /**
  * Собирает приложение целиком.

package/builder/index.js

@@ -2,7 +2,7 @@ import {
   buildApp,
   defineAppConfig,
   devApp
-} from "../chunk-REFU7UMG.js";
+} from "../chunk-YECHY3NR.js";
 import "../chunk-TPBI6TOU.js";
 import "../chunk-6FNC3XMI.js";
 export {

package/{chunk-REFU7UMG.js → chunk-YECHY3NR.js}

@@ -62,11 +62,13 @@ function collectAssets(outDir, base) {
   return { css, js };
 }
 
+// src/serve/port.ts
+var DEFAULT_PORT = 3e3;
+
 // src/builder/entries.ts
 var VIRTUAL_CLIENT = "virtual:den/client";
 var VIRTUAL_SERVER_APP = "virtual:den/server-app";
 var VIRTUAL_SERVER_PROCESS = "virtual:den/server-process";
-var DEFAULT_PORT = 3e3;
 function toResolvedId(id) {
   return `\0${id}`;
 }
@@ -179,7 +181,7 @@ function dependenciesOf(root) {
 }
 function viteConfigFor(options) {
   var _a, _b, _c;
-  const { assets, base, config, configPath, entryFileNames, input, outDir, root, target } = options;
+  const { assets, base, config, configPath, entryFileNames, input, mode, outDir, root, target } = options;
   const entry = (_a = config.entry) != null ? _a : "src/index.ts";
   const composed = {
     base,
@@ -197,6 +199,9 @@ function viteConfigFor(options) {
       ssr: target === "server"
     },
     configFile: false,
+    // Режим объявляем явно: плагины сборщика выбирают по нему рантайм фреймворка, а через
+    // программный вызов он иначе не доедет.
+    mode,
     plugins: [...config.preset.plugins, denAppModules({ assets, config, configPath, entry: path2.join(root, entry) })],
     root,
     ssr: { noExternal: (_c = (_b = config.server) == null ? void 0 : _b.noExternal) != null ? _c : [] }
@@ -206,7 +211,8 @@ function viteConfigFor(options) {
 function buildApp(options) {
   return __async(this, null, function* () {
     var _a, _b;
-    const { base = "/" } = options;
+    const { base = "/", mode = "production" } = options;
+    process.env["NODE_ENV"] = mode;
     const root = path2.resolve(options.root);
     const { config, configPath } = yield loadAppConfig(root);
     const refusal = (_b = (_a = config.preset).validate) == null ? void 0 : _b.call(_a, dependenciesOf(root));
@@ -214,7 +220,7 @@ function buildApp(options) {
       throw new Error(`den: ${refusal}`);
     }
     const { build } = yield import("vite");
-    const shared = { base, config, configPath, root };
+    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" })));
@@ -247,18 +253,97 @@ function buildApp(options) {
 import { spawn } from "child_process";
 import fs3 from "fs";
 import path3 from "path";
+import { pathToFileURL } from "url";
+
+// src/builder/banner.ts
+import os from "os";
+var TOOL = "den";
+var PAD = 11;
+var ENDPOINTS = ["/_render?url=<\u043F\u0443\u0442\u044C>", "/_routes", "/_health"];
+var OUTPUTS = ["build/client", "build/server", "build/server.mjs"];
+var SHORTCUTS = [
+  { key: "r", title: "\u043F\u0435\u0440\u0435\u0441\u043E\u0431\u0440\u0430\u0442\u044C" },
+  { key: "h", title: "\u0441\u043F\u0440\u0430\u0432\u043A\u0430" },
+  { key: "q", title: "\u0432\u044B\u0439\u0442\u0438" }
+];
+function networkAddress() {
+  for (const addresses of Object.values(os.networkInterfaces())) {
+    for (const address of addresses != null ? addresses : []) {
+      if (address.family === "IPv4" && !address.internal) {
+        return address.address;
+      }
+    }
+  }
+  return void 0;
+}
+function assetsSummary(assets) {
+  if (!assets) {
+    return "\u043D\u0435 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u044B";
+  }
+  return `${String(assets.js.length)} js, ${String(assets.css.length)} css`;
+}
+function bannerLines(facts2) {
+  var _a;
+  const port = (_a = process.env["PORT"]) != null ? _a : String(DEFAULT_PORT);
+  const network = networkAddress();
+  const label = (title) => `  \u2192  ${title.padEnd(PAD)}`;
+  return [
+    "",
+    `  ${TOOL}  ${facts2.mode}  \u0441\u043E\u0431\u0440\u0430\u043D\u043E \u0437\u0430 ${String(facts2.elapsedMs)}\u043C\u0441`,
+    "",
+    ...facts2.name === void 0 ? [] : [`${label("\u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u0435")}${facts2.name}`],
+    ...facts2.routes === void 0 ? [] : [`${label("\u0430\u0434\u0440\u0435\u0441\u0430")}${facts2.routes.join("  ")}`],
+    `${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("   ")}`,
+    `${label("\u0430\u0440\u0442\u0435\u0444\u0430\u043A\u0442\u044B")}${assetsSummary(facts2.assets)}`,
+    `${label("\u0432\u044B\u0445\u043E\u0434\u044B")}${OUTPUTS.join(", ")}`,
+    `${label("\u043F\u0440\u0430\u0432\u043A\u0438")}${facts2.watched.join(", ")}`,
+    `${label("\u043A\u043B\u0430\u0432\u0438\u0448\u0438")}${SHORTCUTS.map(({ key, title }) => `${key} \u2014 ${title}`).join(", ")}`,
+    ""
+  ];
+}
+function helpLines() {
+  return ["", "  \u043A\u043B\u0430\u0432\u0438\u0448\u0430 + enter:", ...SHORTCUTS.map(({ key, title }) => `    ${key}  ${title}`), ""];
+}
+
+// src/builder/dev.ts
 var SERVER_ENTRY = "build/server.mjs";
 var WATCHED = ["src", "den.config.ts"];
+var DEBUG_SCOPES = ["@foxford/den:*"];
+function debugPattern(name) {
+  return (name === void 0 ? DEBUG_SCOPES : [`${name}:*`, ...DEBUG_SCOPES]).join(",");
+}
 var DEBOUNCE_MS = 150;
 var SHUTDOWN_TIMEOUT_MS = 5e3;
+function facts(root) {
+  return __async(this, null, function* () {
+    try {
+      const loaded = yield import(pathToFileURL(path3.join(root, "build/server/index.mjs")).href);
+      const app = loaded.default;
+      return { assets: app == null ? void 0 : app.assets, name: app == null ? void 0 : app.name, routes: app == null ? void 0 : app.routes };
+    } catch (e) {
+      return {};
+    }
+  });
+}
+function describer(root) {
+  let described = null;
+  return () => __async(null, null, function* () {
+    described != null ? described : described = yield facts(root);
+    return described;
+  });
+}
 function devApp(options) {
   return __async(this, null, function* () {
+    logger.setDebug(true);
     const root = path3.resolve(options.root);
     const entry = path3.join(root, SERVER_ENTRY);
     let child = null;
     let pending = null;
     let building = false;
     let dirty = false;
+    const describe = describer(root);
     function signalGroup(pid, signal) {
       try {
         process.kill(-pid, signal);
@@ -283,9 +368,11 @@ function devApp(options) {
         });
       });
     }
-    function start() {
+    function start(name) {
+      var _a;
       const started = spawn(process.execPath, [...process.execArgv, entry], {
         detached: true,
+        env: __spreadProps(__spreadValues({}, process.env), { DEBUG: (_a = process.env["DEBUG"]) != null ? _a : debugPattern(name) }),
         stdio: "inherit"
       });
       child = started;
@@ -297,30 +384,57 @@ function devApp(options) {
         logger.error(`\u043F\u0440\u043E\u0446\u0435\u0441\u0441 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u044F \u0437\u0430\u0432\u0435\u0440\u0448\u0438\u043B\u0441\u044F \u0441\u0430\u043C (\u043A\u043E\u0434 ${String(code)}, \u0441\u0438\u0433\u043D\u0430\u043B ${String(signal)})`);
       });
     }
+    function show(lines) {
+      process.stdout.write(`${lines.join("\n")}
+`);
+    }
+    function listenForKeys() {
+      if (!process.stdin.isTTY) {
+        return;
+      }
+      process.stdin.setEncoding("utf8");
+      process.stdin.on("data", (chunk) => {
+        const key = chunk.trim().toLowerCase();
+        if (key === "r") {
+          void rebuild();
+        }
+        if (key === "h") {
+          show(helpLines());
+        }
+        if (key === "q") {
+          void stop().then(() => process.exit(0));
+        }
+      });
+    }
     function rebuild() {
       return __async(this, null, function* () {
         if (building) {
           dirty = true;
-          return;
+          return false;
         }
         building = true;
+        let built2 = false;
         try {
           do {
             dirty = false;
             yield stop();
             try {
-              yield buildApp(options);
-              start();
+              yield buildApp(__spreadProps(__spreadValues({}, options), { mode: "development" }));
+              start((yield describe()).name);
+              built2 = true;
             } catch (error) {
-              logger.error("\u0441\u0431\u043E\u0440\u043A\u0430 \u043D\u0435 \u043F\u0440\u043E\u0448\u043B\u0430, \u0436\u0434\u0443 \u043F\u0440\u0430\u0432\u043A\u0438:", error);
+              logger.error("\u0441\u0431\u043E\u0440\u043A\u0430 \u043D\u0435 \u043F\u0440\u043E\u0448\u043B\u0430 \u2014 \u0441\u0435\u0440\u0432\u0438\u0441 \u041D\u0415 \u041F\u041E\u0414\u041D\u042F\u0422, \u0436\u0434\u0443 \u043F\u0440\u0430\u0432\u043A\u0438:", error);
             }
           } while (dirty);
         } finally {
           building = false;
         }
+        return built2;
       });
     }
-    yield rebuild();
+    const startedAt = Date.now();
+    const built = yield rebuild();
+    const elapsed = Date.now() - startedAt;
     for (const target of WATCHED) {
       const watched = path3.join(root, target);
       if (!fs3.existsSync(watched)) {
@@ -333,7 +447,10 @@ function devApp(options) {
         pending = setTimeout(() => void rebuild(), DEBOUNCE_MS);
       });
     }
-    logger.info(`\u0436\u0434\u0443 \u0438\u0437\u043C\u0435\u043D\u0435\u043D\u0438\u0439 \u0432 ${WATCHED.join(", ")}`);
+    if (built) {
+      show(bannerLines(__spreadValues({ elapsedMs: elapsed, mode: "development", watched: WATCHED }, yield describe())));
+    }
+    listenForKeys();
     for (const signal of ["SIGINT", "SIGTERM"]) {
       process.once(signal, () => {
         void stop().then(() => process.exit(0));

package/{chunk-OKRO4G4L.cjs → chunk-ZBB5SBEV.cjs}

@@ -62,11 +62,13 @@ function collectAssets(outDir, base) {
   return { css, js };
 }
 
+// src/serve/port.ts
+var DEFAULT_PORT = 3e3;
+
 // src/builder/entries.ts
 var VIRTUAL_CLIENT = "virtual:den/client";
 var VIRTUAL_SERVER_APP = "virtual:den/server-app";
 var VIRTUAL_SERVER_PROCESS = "virtual:den/server-process";
-var DEFAULT_PORT = 3e3;
 function toResolvedId(id) {
   return `\0${id}`;
 }
@@ -179,7 +181,7 @@ function dependenciesOf(root) {
 }
 function viteConfigFor(options) {
   var _a, _b, _c;
-  const { assets, base, config, configPath, entryFileNames, input, outDir, root, target } = options;
+  const { assets, base, config, configPath, entryFileNames, input, mode, outDir, root, target } = options;
   const entry = (_a = config.entry) != null ? _a : "src/index.ts";
   const composed = {
     base,
@@ -197,6 +199,9 @@ function viteConfigFor(options) {
       ssr: target === "server"
     },
     configFile: false,
+    // Режим объявляем явно: плагины сборщика выбирают по нему рантайм фреймворка, а через
+    // программный вызов он иначе не доедет.
+    mode,
     plugins: [...config.preset.plugins, denAppModules({ assets, config, configPath, entry: _path2.default.join(root, entry) })],
     root,
     ssr: { noExternal: (_c = (_b = config.server) == null ? void 0 : _b.noExternal) != null ? _c : [] }
@@ -206,7 +211,8 @@ function viteConfigFor(options) {
 function buildApp(options) {
   return _chunkT5QVCXVBcjs.__async.call(void 0, this, null, function* () {
     var _a, _b;
-    const { base = "/" } = options;
+    const { base = "/", mode = "production" } = options;
+    process.env["NODE_ENV"] = mode;
     const root = _path2.default.resolve(options.root);
     const { config, configPath } = yield loadAppConfig(root);
     const refusal = (_b = (_a = config.preset).validate) == null ? void 0 : _b.call(_a, dependenciesOf(root));
@@ -214,7 +220,7 @@ function buildApp(options) {
       throw new Error(`den: ${refusal}`);
     }
     const { build } = yield Promise.resolve().then(() => _interopRequireWildcard(require("vite")));
-    const shared = { base, config, configPath, root };
+    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" })));
@@ -247,18 +253,97 @@ function buildApp(options) {
 var _child_process = require('child_process');
 
 
+var _url = require('url');
+
+// src/builder/banner.ts
+var _os = require('os'); var _os2 = _interopRequireDefault(_os);
+var TOOL = "den";
+var PAD = 11;
+var ENDPOINTS = ["/_render?url=<\u043F\u0443\u0442\u044C>", "/_routes", "/_health"];
+var OUTPUTS = ["build/client", "build/server", "build/server.mjs"];
+var SHORTCUTS = [
+  { key: "r", title: "\u043F\u0435\u0440\u0435\u0441\u043E\u0431\u0440\u0430\u0442\u044C" },
+  { key: "h", title: "\u0441\u043F\u0440\u0430\u0432\u043A\u0430" },
+  { key: "q", title: "\u0432\u044B\u0439\u0442\u0438" }
+];
+function networkAddress() {
+  for (const addresses of Object.values(_os2.default.networkInterfaces())) {
+    for (const address of addresses != null ? addresses : []) {
+      if (address.family === "IPv4" && !address.internal) {
+        return address.address;
+      }
+    }
+  }
+  return void 0;
+}
+function assetsSummary(assets) {
+  if (!assets) {
+    return "\u043D\u0435 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u044B";
+  }
+  return `${String(assets.js.length)} js, ${String(assets.css.length)} css`;
+}
+function bannerLines(facts2) {
+  var _a;
+  const port = (_a = process.env["PORT"]) != null ? _a : String(DEFAULT_PORT);
+  const network = networkAddress();
+  const label = (title) => `  \u2192  ${title.padEnd(PAD)}`;
+  return [
+    "",
+    `  ${TOOL}  ${facts2.mode}  \u0441\u043E\u0431\u0440\u0430\u043D\u043E \u0437\u0430 ${String(facts2.elapsedMs)}\u043C\u0441`,
+    "",
+    ...facts2.name === void 0 ? [] : [`${label("\u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u0435")}${facts2.name}`],
+    ...facts2.routes === void 0 ? [] : [`${label("\u0430\u0434\u0440\u0435\u0441\u0430")}${facts2.routes.join("  ")}`],
+    `${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("   ")}`,
+    `${label("\u0430\u0440\u0442\u0435\u0444\u0430\u043A\u0442\u044B")}${assetsSummary(facts2.assets)}`,
+    `${label("\u0432\u044B\u0445\u043E\u0434\u044B")}${OUTPUTS.join(", ")}`,
+    `${label("\u043F\u0440\u0430\u0432\u043A\u0438")}${facts2.watched.join(", ")}`,
+    `${label("\u043A\u043B\u0430\u0432\u0438\u0448\u0438")}${SHORTCUTS.map(({ key, title }) => `${key} \u2014 ${title}`).join(", ")}`,
+    ""
+  ];
+}
+function helpLines() {
+  return ["", "  \u043A\u043B\u0430\u0432\u0438\u0448\u0430 + enter:", ...SHORTCUTS.map(({ key, title }) => `    ${key}  ${title}`), ""];
+}
+
+// src/builder/dev.ts
 var SERVER_ENTRY = "build/server.mjs";
 var WATCHED = ["src", "den.config.ts"];
+var DEBUG_SCOPES = ["@foxford/den:*"];
+function debugPattern(name) {
+  return (name === void 0 ? DEBUG_SCOPES : [`${name}:*`, ...DEBUG_SCOPES]).join(",");
+}
 var DEBOUNCE_MS = 150;
 var SHUTDOWN_TIMEOUT_MS = 5e3;
+function facts(root) {
+  return _chunkT5QVCXVBcjs.__async.call(void 0, this, null, function* () {
+    try {
+      const loaded = yield Promise.resolve().then(() => _interopRequireWildcard(require(_url.pathToFileURL.call(void 0, _path2.default.join(root, "build/server/index.mjs")).href)));
+      const app = loaded.default;
+      return { assets: app == null ? void 0 : app.assets, name: app == null ? void 0 : app.name, routes: app == null ? void 0 : app.routes };
+    } catch (e) {
+      return {};
+    }
+  });
+}
+function describer(root) {
+  let described = null;
+  return () => _chunkT5QVCXVBcjs.__async.call(void 0, null, null, function* () {
+    described != null ? described : described = yield facts(root);
+    return described;
+  });
+}
 function devApp(options) {
   return _chunkT5QVCXVBcjs.__async.call(void 0, this, null, function* () {
+    _chunkA6ZPAM6Zcjs.logger.setDebug(true);
     const root = _path2.default.resolve(options.root);
     const entry = _path2.default.join(root, SERVER_ENTRY);
     let child = null;
     let pending = null;
     let building = false;
     let dirty = false;
+    const describe = describer(root);
     function signalGroup(pid, signal) {
       try {
         process.kill(-pid, signal);
@@ -283,9 +368,11 @@ function devApp(options) {
         });
       });
     }
-    function start() {
+    function start(name) {
+      var _a;
       const started = _child_process.spawn.call(void 0, process.execPath, [...process.execArgv, entry], {
         detached: true,
+        env: _chunkT5QVCXVBcjs.__spreadProps.call(void 0, _chunkT5QVCXVBcjs.__spreadValues.call(void 0, {}, process.env), { DEBUG: (_a = process.env["DEBUG"]) != null ? _a : debugPattern(name) }),
         stdio: "inherit"
       });
       child = started;
@@ -297,30 +384,57 @@ function devApp(options) {
         _chunkA6ZPAM6Zcjs.logger.error(`\u043F\u0440\u043E\u0446\u0435\u0441\u0441 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u044F \u0437\u0430\u0432\u0435\u0440\u0448\u0438\u043B\u0441\u044F \u0441\u0430\u043C (\u043A\u043E\u0434 ${String(code)}, \u0441\u0438\u0433\u043D\u0430\u043B ${String(signal)})`);
       });
     }
+    function show(lines) {
+      process.stdout.write(`${lines.join("\n")}
+`);
+    }
+    function listenForKeys() {
+      if (!process.stdin.isTTY) {
+        return;
+      }
+      process.stdin.setEncoding("utf8");
+      process.stdin.on("data", (chunk) => {
+        const key = chunk.trim().toLowerCase();
+        if (key === "r") {
+          void rebuild();
+        }
+        if (key === "h") {
+          show(helpLines());
+        }
+        if (key === "q") {
+          void stop().then(() => process.exit(0));
+        }
+      });
+    }
     function rebuild() {
       return _chunkT5QVCXVBcjs.__async.call(void 0, this, null, function* () {
         if (building) {
           dirty = true;
-          return;
+          return false;
         }
         building = true;
+        let built2 = false;
         try {
           do {
             dirty = false;
             yield stop();
             try {
-              yield buildApp(options);
-              start();
+              yield buildApp(_chunkT5QVCXVBcjs.__spreadProps.call(void 0, _chunkT5QVCXVBcjs.__spreadValues.call(void 0, {}, options), { mode: "development" }));
+              start((yield describe()).name);
+              built2 = true;
             } catch (error) {
-              _chunkA6ZPAM6Zcjs.logger.error("\u0441\u0431\u043E\u0440\u043A\u0430 \u043D\u0435 \u043F\u0440\u043E\u0448\u043B\u0430, \u0436\u0434\u0443 \u043F\u0440\u0430\u0432\u043A\u0438:", error);
+              _chunkA6ZPAM6Zcjs.logger.error("\u0441\u0431\u043E\u0440\u043A\u0430 \u043D\u0435 \u043F\u0440\u043E\u0448\u043B\u0430 \u2014 \u0441\u0435\u0440\u0432\u0438\u0441 \u041D\u0415 \u041F\u041E\u0414\u041D\u042F\u0422, \u0436\u0434\u0443 \u043F\u0440\u0430\u0432\u043A\u0438:", error);
             }
           } while (dirty);
         } finally {
           building = false;
         }
+        return built2;
       });
     }
-    yield rebuild();
+    const startedAt = Date.now();
+    const built = yield rebuild();
+    const elapsed = Date.now() - startedAt;
     for (const target of WATCHED) {
       const watched = _path2.default.join(root, target);
       if (!_fs2.default.existsSync(watched)) {
@@ -333,7 +447,10 @@ function devApp(options) {
         pending = setTimeout(() => void rebuild(), DEBOUNCE_MS);
       });
     }
-    _chunkA6ZPAM6Zcjs.logger.info(`\u0436\u0434\u0443 \u0438\u0437\u043C\u0435\u043D\u0435\u043D\u0438\u0439 \u0432 ${WATCHED.join(", ")}`);
+    if (built) {
+      show(bannerLines(_chunkT5QVCXVBcjs.__spreadValues.call(void 0, { elapsedMs: elapsed, mode: "development", watched: WATCHED }, yield describe())));
+    }
+    listenForKeys();
     for (const signal of ["SIGINT", "SIGTERM"]) {
       process.once(signal, () => {
         void stop().then(() => process.exit(0));

package/island/index.cjs

@@ -23,6 +23,21 @@ require('../chunk-A6ZPAM6Z.cjs');
 
 var _chunkT5QVCXVBcjs = require('../chunk-T5QVCXVB.cjs');
 
+// src/island/navigate.ts
+var NAVIGATE_EVENT = "den:navigate";
+function navigateIsland(node, route) {
+  node.dispatchEvent(new CustomEvent(NAVIGATE_EVENT, { detail: route }));
+}
+function onIslandNavigate(node, onNavigate) {
+  const listener = (event) => {
+    onNavigate(event.detail);
+  };
+  node.addEventListener(NAVIGATE_EVENT, listener);
+  return () => {
+    node.removeEventListener(NAVIGATE_EVENT, listener);
+  };
+}
+
 // src/island/slot-address.ts
 function slotAddress(app, slot) {
   return `${app}:${slot}`;
@@ -88,4 +103,7 @@ function describeIsland(descriptor, denState) {
 
 
 
-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.normalizeRoutes = _chunkZOU6W6ZQcjs.normalizeRoutes; exports.pathPattern = _chunkZOU6W6ZQcjs.pathPattern; 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.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.onIslandNavigate = onIslandNavigate; exports.pathPattern = _chunkZOU6W6ZQcjs.pathPattern; 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;

package/island/index.d.cts

@@ -162,6 +162,27 @@ declare function collectDocumentContribution(container: Container, descriptor: I
  */
 declare function resolveEagerUnits(container: Container, descriptor: IslandDescriptor): void;
 
+/** Имя события перехода. Одно на обе стороны — иначе сторона молча не услышит. */
+declare const NAVIGATE_EVENT = "den:navigate";
+/**
+ * Сообщает приложению новый адрес.
+ *
+ * Состояние с адресом НЕ едет: на клиентском переходе его никто не считал — хост чужой
+ * жизненный цикл не исполняет, — и приложение считает его само, активацией своих VM.
+ *
+ * @param node - Узел приложения (его граница в документе)
+ * @param route - Адрес, на который переходим
+ */
+declare function navigateIsland(node: EventTarget, route: IslandRoute): void;
+/**
+ * Подписывает приложение на переходы, о которых сообщает хост.
+ *
+ * @param node - Узел приложения
+ * @param onNavigate - Что делать с новым адресом
+ * @returns Отписка
+ */
+declare function onIslandNavigate(node: EventTarget, onNavigate: (route: IslandRoute) => void): () => void;
+
 /** Запрос на рендер приложения. */
 interface RenderAppRequest {
     /** Путь без search, с ведущим слэшем: `/legal/general`. */
@@ -276,4 +297,4 @@ declare function getAppContainer(): Container;
  */
 declare function slotAddress(app: string, slot: string): string;
 
-export { AppAssets, type CreateIslandContainerOptions, type DocumentContribution, type DocumentHead, type DocumentSource, IslandDescriptor, type IslandRecord, type IslandRoute, type RenderAppRequest, type RenderAppResult, activateIslandViewModels, collectDocumentContribution, collectIslandState, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, isDocumentSource, registerIsland, renderApp, resolveEagerUnits, slotAddress, subscribeIslands };
+export { AppAssets, type CreateIslandContainerOptions, type DocumentContribution, type DocumentHead, type DocumentSource, IslandDescriptor, type IslandRecord, type IslandRoute, NAVIGATE_EVENT, type RenderAppRequest, type RenderAppResult, activateIslandViewModels, collectDocumentContribution, collectIslandState, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, isDocumentSource, navigateIsland, onIslandNavigate, registerIsland, renderApp, resolveEagerUnits, slotAddress, subscribeIslands };

package/island/index.d.ts

@@ -162,6 +162,27 @@ declare function collectDocumentContribution(container: Container, descriptor: I
  */
 declare function resolveEagerUnits(container: Container, descriptor: IslandDescriptor): void;
 
+/** Имя события перехода. Одно на обе стороны — иначе сторона молча не услышит. */
+declare const NAVIGATE_EVENT = "den:navigate";
+/**
+ * Сообщает приложению новый адрес.
+ *
+ * Состояние с адресом НЕ едет: на клиентском переходе его никто не считал — хост чужой
+ * жизненный цикл не исполняет, — и приложение считает его само, активацией своих VM.
+ *
+ * @param node - Узел приложения (его граница в документе)
+ * @param route - Адрес, на который переходим
+ */
+declare function navigateIsland(node: EventTarget, route: IslandRoute): void;
+/**
+ * Подписывает приложение на переходы, о которых сообщает хост.
+ *
+ * @param node - Узел приложения
+ * @param onNavigate - Что делать с новым адресом
+ * @returns Отписка
+ */
+declare function onIslandNavigate(node: EventTarget, onNavigate: (route: IslandRoute) => void): () => void;
+
 /** Запрос на рендер приложения. */
 interface RenderAppRequest {
     /** Путь без search, с ведущим слэшем: `/legal/general`. */
@@ -276,4 +297,4 @@ declare function getAppContainer(): Container;
  */
 declare function slotAddress(app: string, slot: string): string;
 
-export { AppAssets, type CreateIslandContainerOptions, type DocumentContribution, type DocumentHead, type DocumentSource, IslandDescriptor, type IslandRecord, type IslandRoute, type RenderAppRequest, type RenderAppResult, activateIslandViewModels, collectDocumentContribution, collectIslandState, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, isDocumentSource, registerIsland, renderApp, resolveEagerUnits, slotAddress, subscribeIslands };
+export { AppAssets, type CreateIslandContainerOptions, type DocumentContribution, type DocumentHead, type DocumentSource, IslandDescriptor, type IslandRecord, type IslandRoute, NAVIGATE_EVENT, type RenderAppRequest, type RenderAppResult, activateIslandViewModels, collectDocumentContribution, collectIslandState, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, isDocumentSource, navigateIsland, onIslandNavigate, registerIsland, renderApp, resolveEagerUnits, slotAddress, subscribeIslands };

package/island/index.js

@@ -23,6 +23,21 @@ import {
   __spreadValues
 } from "../chunk-6FNC3XMI.js";
 
+// src/island/navigate.ts
+var NAVIGATE_EVENT = "den:navigate";
+function navigateIsland(node, route) {
+  node.dispatchEvent(new CustomEvent(NAVIGATE_EVENT, { detail: route }));
+}
+function onIslandNavigate(node, onNavigate) {
+  const listener = (event) => {
+    onNavigate(event.detail);
+  };
+  node.addEventListener(NAVIGATE_EVENT, listener);
+  return () => {
+    node.removeEventListener(NAVIGATE_EVENT, listener);
+  };
+}
+
 // src/island/slot-address.ts
 function slotAddress(app, slot) {
   return `${app}:${slot}`;
@@ -68,6 +83,7 @@ function describeIsland(descriptor, denState) {
   };
 }
 export {
+  NAVIGATE_EVENT,
   ViewLayerToken,
   activateIslandViewModels,
   collectDocumentContribution,
@@ -79,7 +95,9 @@ export {
   hydrateIslandState,
   isDocumentSource,
   matchRoute,
+  navigateIsland,
   normalizeRoutes,
+  onIslandNavigate,
   pathPattern,
   registerIsland,
   renderApp,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxford/den",
-  "version": "3.1.1",
+  "version": "3.1.3",
   "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"
@@ -89,14 +89,14 @@
     "chunk-C7BM4DGX.cjs",
     "chunk-E23E2VUC.js",
     "chunk-MCN4GFEQ.js",
-    "chunk-OKRO4G4L.cjs",
-    "chunk-REFU7UMG.js",
     "chunk-T5QVCXVB.cjs",
     "chunk-TPBI6TOU.js",
     "chunk-TPHJUDHG.js",
     "chunk-WBHHHICS.js",
     "chunk-XOJ2VWX4.cjs",
+    "chunk-YECHY3NR.js",
     "chunk-Z5BL4DJA.cjs",
+    "chunk-ZBB5SBEV.cjs",
     "chunk-ZOU6W6ZQ.cjs",
     "define-repository-CwAXed2X.d.cts",
     "define-repository-q_T4hqeP.d.ts",
@@ -125,6 +125,6 @@
     "view-adapter-B4gEb-ms.d.ts",
     "view-adapter-DJ7yB6Ml.d.cts"
   ],
-  "sha": "dd4b7ca",
+  "sha": "c633e3b",
   "scripts": {}
 }