@ynight/cli 0.0.0-stage → 0.0.1

package/dist/commands.js

@@ -0,0 +1,225 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = exports.CLI_VERSION = void 0;
+exports.typeCheck = typeCheck;
+exports.build = build;
+exports.dev = dev;
+const tslib_1 = require("tslib");
+const node_fs_1 = tslib_1.__importDefault(require("node:fs"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const typescript_1 = tslib_1.__importDefault(require("typescript"));
+const generate_types_1 = require("./generate-types");
+const webpack_build_1 = require("./webpack-build");
+const project_config_1 = require("./project-config");
+const output_safety_1 = require("./output-safety");
+const utils_1 = require("./utils");
+/** CLI 自身的版本号，始终以发布包根目录的 package.json 为准。 */
+const packageManifest = JSON.parse(node_fs_1.default.readFileSync(node_path_1.default.resolve(__dirname, '../package.json'), 'utf8'));
+exports.CLI_VERSION = packageManifest.version;
+/**
+ * CLI 帮助文本：列出所有子命令与参数；保持简洁，便于直接打印。
+ *
+ * 注意：每个子命令的实际解析在 `bin.ts::parseArgs` 中。
+ */
+exports.HELP = `Elpis 项目 CLI ${exports.CLI_VERSION}
+
+用法:
+  elpis dev [--root 路径] [--port 端口] [--web-port 端口]
+  elpis build [--root 路径]
+  elpis type-check [--root 路径]
+  elpis generate:types [--check] [--root 路径]
+  elpis --help | --version`;
+/**
+ * 在执行 type-check / dev 等命令前强制校验配置文件存在。
+ *
+ * `loadProjectConfig` 本身已会抛错，这里再包一层只是为了在错误信息中带上更明确的上下文。
+ */
+function requireConfig(root) {
+    (0, project_config_1.loadProjectConfig)(root, 'development');
+}
+/**
+ * 用 `ts` 直接解析并检查 `tsconfig.client.json` 配置是否合法（不实际跑 vue-tsc）。
+ *
+ * 解决的问题：
+ * - vue-tsc 启动较慢，先用 TS API 校验配置，避免在配置错误时仍然走完启动流程；
+ * - 过滤掉 `18003`（"No inputs were found"），零扩展项目允许通过。
+ */
+function runVueTypeCheck(root) {
+    const config = node_path_1.default.resolve(root, 'tsconfig.client.json');
+    if (!node_fs_1.default.existsSync(config)) {
+        return;
+    }
+    const read = typescript_1.default.readConfigFile(config, typescript_1.default.sys.readFile);
+    if (read.error) {
+        throw new Error(typescript_1.default.flattenDiagnosticMessageText(read.error.messageText, '\n'));
+    }
+    // 显式注册 .vue 为"deferred script"以便 TS 解析包含 SFC 的工程。
+    const parsed = typescript_1.default.parseJsonConfigFileContent(read.config, typescript_1.default.sys, root, undefined, config, undefined, [{ extension: '.vue', isMixedContent: true, scriptKind: typescript_1.default.ScriptKind.Deferred }]);
+    const errors = parsed.errors.filter(error => error.code !== 18003);
+    if (errors.length) {
+        throw new Error(errors.map(error => typescript_1.default.flattenDiagnosticMessageText(error.messageText, '\n')).join('\n'));
+    }
+    // 没有客户端源文件是有效的零扩展项目；有输入时始终交给 vue-tsc 检查。
+    if (parsed.fileNames.length === 0) {
+        return;
+    }
+    (0, utils_1.runVueTsc)(root, config);
+}
+/**
+ * 同步执行完整类型检查：
+ * 1. 校验配置文件；
+ * 2. 重新生成业务模块声明文件；
+ * 3. 使用 `tsc --noEmit` 检查服务端代码；
+ * 4. 调用 `vue-tsc` 检查客户端代码。
+ */
+function typeCheck(options) {
+    requireConfig(options.root);
+    (0, generate_types_1.generateTypes)(options.root);
+    (0, utils_1.runTsc)(options.root, node_path_1.default.resolve(options.root, 'tsconfig.server.json'), ['--noEmit']);
+    runVueTypeCheck(options.root);
+    console.log('类型检查通过');
+}
+/**
+ * 计算"编译后"服务端入口的相对路径（`.ts` → `.js`），用于生成 production launcher。
+ *
+ * 与 `configForCompiledModules` 不同，这里返回的是相对路径字符串，便于硬编码进启动器。
+ */
+function compiledEntryRelative(root, config) {
+    const entry = (0, project_config_1.resolveServerEntry)(root, config);
+    const relative = node_path_1.default.relative(root, entry);
+    return (relative
+        .replace(/\.(?:tsx?|mts|cts)$/, '.js')
+        // 统一使用 POSIX 分隔符，方便跨平台 require 路径。
+        .split(node_path_1.default.sep)
+        .join('/'));
+}
+/**
+ * 生成 production launcher `dist/server/index.js`：
+ * 加载编译后的服务端入口、调用框架 `startApplication` 启动服务。
+ *
+ * 注意：运行时配置通过 `JSON.stringify` 内联，避免依赖外部配置文件。
+ */
+function writeProductionLauncher(stagingDist, entryRelative, config) {
+    const runtimeConfig = (0, project_config_1.configForCompiledModules)(config);
+    const launcher = `const path = require('node:path');
+const { startApplication } = require('@ynight/framework/server');
+const serverPath = path.resolve(__dirname, '../app', ${JSON.stringify(entryRelative)});
+const loaded = require(serverPath);
+const server = loaded.default || loaded;
+startApplication({ rootDir: path.resolve(__dirname, '../app'), mode: 'production', moduleExtension: '.js', config: ${JSON.stringify(runtimeConfig)}, server, publicRoot: path.resolve(__dirname, '../public') })
+  .catch(error => { console.error(error instanceof Error ? error.message : error); process.exitCode = 1; });
+`;
+    node_fs_1.default.mkdirSync(node_path_1.default.resolve(stagingDist, 'server'), { recursive: true });
+    node_fs_1.default.writeFileSync(node_path_1.default.resolve(stagingDist, 'server/index.js'), launcher);
+}
+/**
+ * 生产构建主流程：
+ * 1. 校验配置与输出目录安全；
+ * 2. 重新生成类型声明；
+ * 3. 在 `.elpis/build/{buildId}` 下构建 staging 产物；
+ * 4. 校验页面模板齐全；
+ * 5. 写入 manifest；
+ * 6. 原子替换到正式输出目录。
+ *
+ * 任何步骤失败都会在 catch 中打印消息并向上抛出，调用方决定是否回滚。
+ */
+async function build(options) {
+    const config = (0, project_config_1.loadEffectiveConfig)(options.root, 'production');
+    const outputRoot = (0, output_safety_1.safeOutputRoot)(options.root, config);
+    // 生产模式 force generateTypes，无需复用 dev 时可能存在的缓存。
+    (0, generate_types_1.generateTypes)(options.root, false, 'production');
+    // buildId 用于事务记录和备份目录命名，确保唯一可追溯。
+    const buildId = `${Date.now()}-${process.pid}`;
+    const buildRoot = (0, output_safety_1.safeGeneratedPath)(options.root, `.elpis/build/${buildId}`);
+    const compiledApp = node_path_1.default.resolve(buildRoot, 'app');
+    const stagingDist = node_path_1.default.resolve(buildRoot, 'dist');
+    const stagingPublic = node_path_1.default.resolve(stagingDist, 'public');
+    node_fs_1.default.mkdirSync(buildRoot, { recursive: true });
+    try {
+        // 先用 tsc 把服务端 TS 编译到 staging。
+        (0, utils_1.runTsc)(options.root, node_path_1.default.resolve(options.root, 'tsconfig.server.json'), [
+            '--outDir',
+            compiledApp,
+        ]);
+        runVueTypeCheck(options.root);
+        (0, utils_1.copyDirectory)(compiledApp, node_path_1.default.resolve(stagingDist, 'app'));
+        (0, utils_1.copyDirectory)(node_path_1.default.resolve(options.root, 'public'), stagingPublic);
+        // 前端构建产物直接落到 staging/public，Koa 静态根就是 public。
+        await (0, webpack_build_1.buildFrontend)((0, webpack_build_1.createFrontendOptions)(options, 'production', stagingPublic, config));
+        const missingPage = (0, webpack_build_1.pageOutputPaths)(stagingPublic).find(page => !node_fs_1.default.existsSync(page));
+        if (missingPage) {
+            throw new Error(`前端构建缺少页面模板: ${missingPage}`);
+        }
+        // 写入 production launcher 与 manifest。
+        writeProductionLauncher(stagingDist, compiledEntryRelative(options.root, config), config);
+        const manifest = {
+            frameworkVersion: exports.CLI_VERSION,
+            configProtocolVersion: 1,
+            app: 'app',
+            public: 'public',
+            pages: ['project-list', 'dashboard', 'error'],
+            publicAssetPrefix: '/dist/',
+        };
+        node_fs_1.default.writeFileSync(node_path_1.default.resolve(stagingDist, 'elpis-manifest.json'), `${JSON.stringify(manifest, null, 2)}\n`);
+        // 二次校验：避免配置在生成过程中被修改导致 output 不再合法。
+        (0, output_safety_1.safeOutputRoot)(options.root, config);
+        // 原子替换：先把 staging 整体 rename 到 output，失败时 backup 还原。
+        (0, output_safety_1.replaceDirectoryAtomically)(options.root, stagingDist, outputRoot, buildId);
+        console.log(`生产产物已生成: ${outputRoot}`);
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : error);
+        throw error;
+    }
+}
+/**
+ * 开发模式入口（spawn 当前 CLI 重新跑 dev-entry.ts）。
+ *
+ * 这里采用子进程模式的原因：
+ * - dev-entry 维护大量长生命周期资源（koa server / webpack-dev-server / tsc 子进程 / 定时器），
+ *   用独立子进程可借助 OS 进程隔离避免污染父进程；
+ * - 父进程仅负责把 SIGINT / SIGTERM 透传给子进程，简化资源回收。
+ */
+async function dev(options) {
+    requireConfig(options.root);
+    (0, generate_types_1.generateTypes)(options.root);
+    const child = (0, node_child_process_1.spawn)(process.execPath, [
+        // __dirname 指向编译后的目录，因此 dev-entry.js 与 dev-entry.ts 同名。
+        node_path_1.default.resolve(__dirname, 'dev-entry.js'),
+        '--root',
+        options.root,
+        ...(options.port === undefined ? [] : ['--port', String(options.port)]),
+        ...(options.webPort === undefined ? [] : ['--web-port', String(options.webPort)]),
+    ], {
+        cwd: options.root,
+        // stdio: 'inherit'：让子进程日志直接输出到父终端。
+        stdio: 'inherit',
+        env: { ...process.env },
+    });
+    // 把父进程收到的终止信号透传给子进程，由 dev-entry 自行按顺序关停资源。
+    await new Promise((resolve, reject) => {
+        const interrupt = () => child.kill('SIGINT');
+        const terminate = () => child.kill('SIGTERM');
+        const cleanup = () => {
+            process.removeListener('SIGINT', interrupt);
+            process.removeListener('SIGTERM', terminate);
+        };
+        process.on('SIGINT', interrupt);
+        process.on('SIGTERM', terminate);
+        child.once('error', error => {
+            cleanup();
+            reject(error);
+        });
+        child.once('exit', code => {
+            cleanup();
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                reject(new Error(`开发服务退出，退出码: ${code ?? 'unknown'}`));
+            }
+        });
+    });
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"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"}

package/dist/dev-entry.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dev-entry.d.ts.map

package/dist/dev-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-entry.d.ts","sourceRoot":"","sources":["../src/dev-entry.ts"],"names":[],"mappings":""}

package/dist/dev-entry.js

@@ -0,0 +1,348 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const node_fs_1 = tslib_1.__importDefault(require("node:fs"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const server_1 = require("@ynight/framework/server");
+const generate_types_1 = require("./generate-types");
+const webpack_build_1 = require("./webpack-build");
+const project_config_1 = require("./project-config");
+const output_safety_1 = require("./output-safety");
+const dev_proxy_1 = require("./dev-proxy");
+const utils_1 = require("./utils");
+const dev_watcher_1 = require("./dev-watcher");
+/**
+ * 从 `process.argv` 中读取 `--name value` 形式的命令行参数。
+ *
+ * 相比 `process.argv.slice` 解析，这种按名查找更鲁棒，能正确跳过无关参数。
+ * @returns 找到时返回参数值（字符串），否则返回 `undefined`。
+ */
+function argument(name) {
+    const index = process.argv.indexOf(name);
+    return index === -1 ? undefined : process.argv[index + 1];
+}
+/**
+ * 清空 Node `require.cache` 中所有属于业务工程的缓存模块。
+ *
+ * 设计要点：
+ * - 仅清除项目根目录下且不在 `node_modules` 中的缓存文件；
+ * - 这样在重启循环里 `require(entry)` 就能加载到最新的编译产物；
+ * - 注意：开发期引入业务模块应经过编译目录（`.elpis/dev/app`），原文件缓存由 webpack 处理。
+ */
+function clearProjectModuleCache(root) {
+    const prefix = node_path_1.default.resolve(root) + node_path_1.default.sep;
+    for (const file of Object.keys(require.cache)) {
+        if (file.startsWith(prefix) && !file.includes(node_path_1.default.sep + 'node_modules' + node_path_1.default.sep)) {
+            delete require.cache[file];
+        }
+    }
+}
+/**
+ * 开发子进程主入口：
+ * 1. 解析 CLI 参数（根目录、端口覆盖）；
+ * 2. 准备生成目录（public / app）；
+ * 3. 启动 koa + 前端 dev server + dev-proxy；
+ * 4. 启动文件监听循环，业务代码变更时热重启；
+ * 5. 接收 SIGINT / SIGTERM 时按顺序安全关停所有资源。
+ */
+async function main() {
+    // 使用 realpathSync 处理工程目录本身就是符号链接的情况。
+    const root = node_fs_1.default.realpathSync(node_path_1.default.resolve(argument('--root') ?? process.cwd()));
+    const port = argument('--port');
+    const webPort = argument('--web-port');
+    const overrides = {
+        ...(port === undefined ? {} : { port: Number(port) }),
+        ...(webPort === undefined ? {} : { webPort: Number(webPort) }),
+    };
+    // 通过白名单环境变量传递端口覆盖，让框架 onReady 等也能读取到 CLI 优先级。
+    if (overrides.port !== undefined) {
+        process.env.ELPIS_PORT = String(overrides.port);
+    }
+    if (overrides.webPort !== undefined) {
+        process.env.ELPIS_WEB_DEV_PORT = String(overrides.webPort);
+    }
+    // 公共生成目录与编译后应用目录；都位于 `.elpis/dev/`，便于一次性清理。
+    const publicRoot = (0, output_safety_1.safeGeneratedPath)(root, '.elpis/dev/public');
+    const appRoot = (0, output_safety_1.safeGeneratedPath)(root, '.elpis/dev/app');
+    // 开发服务与生产构建保持相同的 public 语义：
+    // 仅清理 CLI 自有的生成目录，再叠加业务静态文件，最后由 webpack 写入页面模板与 HMR 资源。
+    node_fs_1.default.rmSync(publicRoot, { recursive: true, force: true });
+    node_fs_1.default.mkdirSync(publicRoot, { recursive: true });
+    (0, utils_1.copyDirectory)(node_path_1.default.resolve(root, 'public'), publicRoot);
+    let config = (0, project_config_1.loadEffectiveConfig)(root, 'development', overrides);
+    // 进程级状态：以下变量在重启 / 停止流程中共享，需要按闭包访问。
+    let managed;
+    let closeProxy;
+    let frontend;
+    let compiling;
+    let stopping = false;
+    let stopPromise;
+    let restarting;
+    let watcher;
+    let changeTimer;
+    const pendingChanges = new Set();
+    /**
+     * 编译业务工程到 staging 目录，返回 staging 路径。
+     *
+     * 使用一次性目录（带时间戳 + pid）实现"原子替换"，避免热重启期间读写冲突。
+     * 同时禁用 incremental 与 emitOnError，确保每次都得到完整且无错误的产物。
+     */
+    const compileServer = async () => {
+        const staging = (0, output_safety_1.safeGeneratedPath)(root, '.elpis/dev/compilations/' + Date.now() + '-' + process.pid + '/app');
+        node_fs_1.default.mkdirSync(staging, { recursive: true });
+        await new Promise((resolve, reject) => {
+            const child = (0, node_child_process_1.spawn)(process.execPath, [
+                (0, utils_1.resolveTsc)(),
+                '-p',
+                node_path_1.default.resolve(root, 'tsconfig.server.json'),
+                '--outDir',
+                staging,
+                '--rootDir',
+                root,
+                '--incremental',
+                'false',
+                '--noEmitOnError',
+            ], { cwd: root, stdio: 'inherit' });
+            compiling = child;
+            child.once('error', reject);
+            child.once('exit', code => {
+                compiling = undefined;
+                if (code === 0) {
+                    resolve();
+                }
+                else {
+                    reject(new Error('TypeScript 编译失败，退出码: ' + (code ?? 'unknown')));
+                }
+            });
+        });
+        return staging;
+    };
+    /**
+     * 根据最新配置创建 Koa `ManagedApplication`。
+     *
+     * 处理流程：
+     * - 把 TS 源码入口路径映射到编译产物（`.ts` → `.js`）；
+     * - 清空 require 缓存后 `require` 编译产物；
+     * - 调用框架 `createApplication` 构造应用实例。
+     */
+    const create = async (next) => {
+        const sourceEntry = (0, project_config_1.resolveServerEntry)(root, next);
+        const entry = node_path_1.default.join(appRoot, node_path_1.default.relative(root, sourceEntry).replace(/\.(?:tsx?|mts|cts)$/, '.js'));
+        if (!node_fs_1.default.existsSync(entry)) {
+            throw new Error('编译后的 server.entry 不存在: ' + entry);
+        }
+        clearProjectModuleCache(appRoot);
+        const loaded = require(entry);
+        const created = await (0, server_1.createApplication)({
+            rootDir: root,
+            sourceRoot: root,
+            moduleRoot: appRoot,
+            moduleExtension: '.js',
+            mode: 'development',
+            config: (0, project_config_1.configForCompiledModules)(next),
+            server: loaded.default ?? loaded,
+            publicRoot,
+        });
+        return created;
+    };
+    /**
+     * 把一次"重启"完整执行：编译 → 替换 → 启动新实例 → 关停旧实例。
+     *
+     * 关键策略：
+     * - 备份旧 `app` 目录，便于新实例失败时回滚；
+     * - 必须先让新实例成功 `listen`，再关闭旧实例，期间请求仍由旧实例处理；
+     * - 新实例启动期间代理中间件保持不变；
+     * - 失败时把失败目录保留，并把旧版本恢复回 appRoot。
+     *
+     * @param next 最新的 `ElpisConfig`。
+     * @param restartFrontend 是否需要重启前端（仅在配置文件变化时为 true）。
+     */
+    const apply = async (next, restartFrontend) => {
+        (0, generate_types_1.generateTypes)(root);
+        const staging = await compileServer();
+        // 编译期间若收到停止信号，则直接放弃此次重启。
+        if (stopping) {
+            return;
+        }
+        (0, output_safety_1.safeGeneratedPath)(root, '.elpis/dev/app');
+        // 备份路径：保留上一次成功版本，新版本失败时可回滚。
+        const backup = (0, output_safety_1.safeGeneratedPath)(root, '.elpis/dev/previous/' + Date.now() + '-' + process.pid + '/app');
+        node_fs_1.default.mkdirSync(node_path_1.default.dirname(backup), { recursive: true });
+        if (node_fs_1.default.existsSync(appRoot)) {
+            node_fs_1.default.renameSync(appRoot, backup);
+        }
+        node_fs_1.default.renameSync(staging, appRoot);
+        let candidate;
+        let switched = false;
+        let frontendChanged = false;
+        try {
+            // 仅在首次启动或配置变化时重启前端，业务代码变更可热更新。
+            if (!frontend || restartFrontend) {
+                frontendChanged = true;
+                await frontend?.close();
+                frontend = (0, webpack_build_1.startDevFrontend)((0, webpack_build_1.createFrontendOptions)({ root }, 'development', publicRoot, next));
+                await frontend.result;
+            }
+            // 初次启动必须先交付真实 HTML，框架初始化会验证模板；
+            // 编译、模型验证和 onReady 成功前，旧后端继续监听并处理请求。
+            candidate = await create(next);
+            if (stopping) {
+                await candidate.close();
+                return;
+            }
+            closeProxy?.();
+            await managed?.close();
+            switched = true;
+            const candidateCloseProxy = (0, dev_proxy_1.installDevProxy)(candidate, next.dev?.webPort ?? 8000);
+            try {
+                await candidate.listen(next.server);
+            }
+            catch (error) {
+                candidateCloseProxy();
+                throw error;
+            }
+            managed = candidate;
+            closeProxy = candidateCloseProxy;
+            config = next;
+        }
+        catch (error) {
+            await candidate?.close();
+            // 把失败目录单独保留供诊断，恢复旧模块目录后再恢复必要的监听。
+            const failed = (0, output_safety_1.safeGeneratedPath)(root, '.elpis/dev/failed/' + Date.now() + '-' + process.pid + '/app');
+            node_fs_1.default.mkdirSync(node_path_1.default.dirname(failed), { recursive: true });
+            node_fs_1.default.renameSync(appRoot, failed);
+            if (node_fs_1.default.existsSync(backup)) {
+                node_fs_1.default.renameSync(backup, appRoot);
+            }
+            // 前端只在被本次重启影响时才需要回滚，避免无谓重启。
+            if (frontendChanged && managed && !stopping) {
+                await frontend?.close();
+                frontend = (0, webpack_build_1.startDevFrontend)((0, webpack_build_1.createFrontendOptions)({ root }, 'development', publicRoot, config));
+                await frontend.result;
+            }
+            // 后端也需要回滚到上一个 working 版本。
+            if (switched && managed && !stopping) {
+                managed = await create(config);
+                closeProxy = (0, dev_proxy_1.installDevProxy)(managed, config.dev?.webPort ?? 8000);
+                await managed.listen(config.server);
+            }
+            throw error;
+        }
+    };
+    /**
+     * 幂等地停止整个开发服务。
+     *
+     * 顺序：
+     * 1. 停掉定时器、tsc 子进程；
+     * 2. 等待上一次重启结束；
+     * 3. 先关 HMR，再关 dev-proxy，最后关后端；
+     *    倒序是为了避免 SSE 长连接阻塞 server.close。
+     */
+    const stop = () => {
+        if (stopPromise) {
+            return stopPromise;
+        }
+        stopping = true;
+        if (changeTimer) {
+            clearTimeout(changeTimer);
+        }
+        // 终止正在运行的 tsc 子进程，否则它会一直占用文件句柄。
+        compiling?.kill('SIGTERM');
+        stopPromise = (async () => {
+            await restarting?.catch(() => undefined);
+            await watcher?.close();
+            // 先结束 HMR，再释放同源转发和后端监听，避免 SSE 阻塞 close。
+            await frontend?.close();
+            closeProxy?.();
+            await managed?.close();
+        })();
+        return stopPromise;
+    };
+    // SIGINT / SIGTERM 触发统一关停流程，失败时仅记录错误并标记非零退出码。
+    const shutdown = () => {
+        void stop().catch(error => {
+            console.error(error);
+            process.exitCode = 1;
+        });
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    try {
+        // 首次启动：不需要重启前端（没有旧实例）。
+        restarting = apply(config, false);
+        await restarting;
+        restarting = undefined;
+        if (stopping) {
+            return;
+        }
+        console.log('Elpis 开发服务已就绪: http://' +
+            config.server?.host +
+            ':' +
+            config.server?.port +
+            '（前端 HMR 端口 ' +
+            config.dev?.webPort +
+            '，同源 /__webpack_hmr）');
+        const restart = async () => {
+            if (stopping || restarting) {
+                return;
+            }
+            restarting = (async () => {
+                while (pendingChanges.size > 0 && !stopping) {
+                    const changes = [...pendingChanges];
+                    pendingChanges.clear();
+                    const configChanged = changes.some(file => ['elpis.config.ts', 'elpis.config.js', 'elpis.config.cjs'].includes(node_path_1.default.relative(root, file)));
+                    try {
+                        clearProjectModuleCache(root);
+                        const next = (0, project_config_1.loadEffectiveConfig)(root, 'development', overrides);
+                        await apply(next, configChanged);
+                        if (configChanged) {
+                            await watcher?.refresh(next);
+                        }
+                        if (!stopping) {
+                            console.log('业务服务已根据源码或配置变更重启');
+                        }
+                    }
+                    catch (error) {
+                        console.error('业务服务重启失败，保留上一可用版本: ' +
+                            (error instanceof Error ? error.message : error));
+                    }
+                }
+            })().finally(() => {
+                restarting = undefined;
+                if (pendingChanges.size > 0 && !stopping) {
+                    scheduleRestart();
+                }
+            });
+            await restarting;
+        };
+        const scheduleRestart = () => {
+            if (stopping) {
+                return;
+            }
+            if (changeTimer) {
+                clearTimeout(changeTimer);
+            }
+            changeTimer = setTimeout(() => {
+                changeTimer = undefined;
+                void restart();
+            }, 200);
+        };
+        const handleChange = (event) => {
+            pendingChanges.add(event.path);
+            scheduleRestart();
+        };
+        watcher = await (0, dev_watcher_1.watchProject)(root, config, handleChange, error => console.error('项目文件监听失败: ' + (error instanceof Error ? error.message : error)));
+    }
+    catch (error) {
+        restarting = undefined;
+        await stop();
+        throw error;
+    }
+}
+// 顶层错误处理：打印友好提示并设置非零退出码。
+main().catch(error => {
+    console.error('开发服务启动失败: ' + (error instanceof Error ? error.message : error));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=dev-entry.js.map

package/dist/dev-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-entry.js","sourceRoot":"","sources":["../src/dev-entry.ts"],"names":[],"mappings":"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"}

package/dist/dev-proxy.d.ts

@@ -0,0 +1,21 @@
+import type { ManagedApplication } from '@ynight/framework/server';
+/**
+ * 在开发模式下，仅把前端 HMR 与开发产物相关的请求代理到 Webpack Dev Server，
+ * 其余请求（业务 API、页面 HTML、静态资源中需鉴权的部分）继续交给 Koa 框架处理。
+ *
+ * 路由策略（仅放行下列请求方法与路径前缀）：
+ * - 仅处理 `GET` / `HEAD`；
+ * - `/__webpack_hmr`            webpack-hot-middleware 长连接（SSE）；
+ * - `/dist/dev/...`             开发模式下的 js/css/asset 产物；
+ * - `/assets/...`               静态资源（虽然通常会经过框架校验，但开发期以原始
+ *                                文件形式由 webpack-dev-middleware 接管更高效）。
+ *
+ * 设计动机：保持单一域名，便于在登录态 Cookie / CSRF 等安全约束下做 HMR；
+ * 仅放行最关键的几个前缀，避免暴露完整 webpack-dev-server。
+ *
+ * @param managed 当前被管理的 Koa 应用（带 `app.middleware`）。
+ * @param port Webpack Dev Server 监听端口（来自 `config.dev.webPort`）。
+ * @returns 卸载代理中间件的清理函数；通常在切换前后端实例时调用。
+ */
+export declare function installDevProxy(managed: ManagedApplication, port: number): () => void;
+//# sourceMappingURL=dev-proxy.d.ts.map

package/dist/dev-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-proxy.d.ts","sourceRoot":"","sources":["../src/dev-proxy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,IAAI,CAkFrF"}