@lark-apaas/coding-template-nestjs-react-fullstack 0.1.23 → 0.1.25-alpha.20260820120346

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/coding-template-nestjs-react-fullstack",
-  "version": "0.1.23",
+  "version": "0.1.25-alpha.20260820120346",
   "description": "NestJS + React fullstack template for miaoda coding",
   "type": "module",
   "files": [

package/template/package-lock.json

@@ -8,7 +8,7 @@
       "name": "fullstack-nestjs-template",
       "version": "2.2.5",
       "dependencies": {
-        "@lark-apaas/fullstack-nestjs-core": "^1.1.57",
+        "@lark-apaas/fullstack-nestjs-core": "^1.1.59",
         "@nestjs/axios": "^4.0.1",
         "@nestjs/cache-manager": "^3.1.3",
         "@nestjs/common": "^10.4.20",
@@ -37,7 +37,7 @@
         "@headlessui/react": "^2.2.9",
         "@heroicons/react": "^2.2.0",
         "@hookform/resolvers": "^5.2.2",
-        "@lark-apaas/client-toolkit": "^1.2.61",
+        "@lark-apaas/client-toolkit": "^1.2.63",
         "@lark-apaas/fullstack-presets": "^1.1.0",
         "@lark-apaas/fullstack-vite-preset": "^1.0.34",
         "@nestjs/cli": "^10.4.9",
@@ -3100,9 +3100,9 @@
       }
     },
     "node_modules/@lark-apaas/client-toolkit": {
-      "version": "1.2.61",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/client-toolkit/-/client-toolkit-1.2.61.tgz",
-      "integrity": "sha512-yPW6jOj6jDGwfLiTW2J8Z3e3f65etRt8acf0eQISTbzSIKjJzP9cqQGTNlFXvCLFrrhT8laGRWLVKe0ZSZKbvA==",
+      "version": "1.2.63",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/client-toolkit/-/client-toolkit-1.2.63.tgz",
+      "integrity": "sha512-/ZtOLOb72bWob1rV950B30C9E9Msda8BdwAFQeMWs7khaVjHBJq/k2vdJksWip14frlsUAPBPcuGe3XafBIcPw==",
       "dev": true,
       "dependencies": {
         "@ant-design/colors": "^7.2.1",
@@ -3251,16 +3251,16 @@
       }
     },
     "node_modules/@lark-apaas/fullstack-nestjs-core": {
-      "version": "1.1.57",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/fullstack-nestjs-core/-/fullstack-nestjs-core-1.1.57.tgz",
-      "integrity": "sha512-KeYUVSS2+ExuvK/xG4AfWLGKs68b6KdlrTIHsXyNJAh7ZOYcQwGy3aFUa50T27PMQ1OUNL0tOSHUvrDQKX7WqQ==",
+      "version": "1.1.59",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/fullstack-nestjs-core/-/fullstack-nestjs-core-1.1.59.tgz",
+      "integrity": "sha512-oJs91O+XrrZ36JPyZLi63KKKIphGKXC8Ima3WM6l5Do7wm+VwtGkZKIKa4y44Y4Xv+0kqSotfS9rxs1FwlRPwg==",
       "license": "MIT",
       "dependencies": {
         "@lark-apaas/cache-service": "^0.1.1",
         "@lark-apaas/file-service": "^0.1.2",
         "@lark-apaas/http-client": "^0.1.7",
-        "@lark-apaas/nestjs-authnpaas": "^1.0.5",
-        "@lark-apaas/nestjs-authzpaas": "^0.1.12",
+        "@lark-apaas/nestjs-authnpaas": "^1.0.7",
+        "@lark-apaas/nestjs-authzpaas": "^0.1.14",
         "@lark-apaas/nestjs-capability": "^0.1.14",
         "@lark-apaas/nestjs-common": "^0.1.9",
         "@lark-apaas/nestjs-datapaas": "^1.0.21",
@@ -3912,9 +3912,9 @@
       }
     },
     "node_modules/@lark-apaas/nestjs-authnpaas": {
-      "version": "1.0.5",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-authnpaas/-/nestjs-authnpaas-1.0.5.tgz",
-      "integrity": "sha512-lC9e5hdHbVdao00K+8LZtIRJwL8uBxrGUyjfGmjQhosnh3Yvr+fwGFzlAfMCEbdZGMtJtv2j0DW115IXPbTpIQ==",
+      "version": "1.0.7",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-authnpaas/-/nestjs-authnpaas-1.0.7.tgz",
+      "integrity": "sha512-MIx73hgunGCPCPmWyBGHc99O275Hi9g2MTe/rr4xkXC4AtCxPVuZco/RqBt1gH1HslDNZKJ54Nuq2D8tJ/hDZA==",
       "license": "MIT",
       "dependencies": {
         "reflect-metadata": "^0.1.13"
@@ -3930,13 +3930,13 @@
       }
     },
     "node_modules/@lark-apaas/nestjs-authzpaas": {
-      "version": "0.1.12",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-authzpaas/-/nestjs-authzpaas-0.1.12.tgz",
-      "integrity": "sha512-nVWjtcncRpjzrapkKgypJYPkOEs8xS3ugkQWF/FXCn9KYEVN2uooAp5uzcbZYjoFbAua7j++iTr8qJ3DuafcRQ==",
+      "version": "0.1.14",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-authzpaas/-/nestjs-authzpaas-0.1.14.tgz",
+      "integrity": "sha512-/FmzjpB1v70EUcKs8VlinM5k4Jw3lvUgNA2+ot2XU3qEFKEiUDfswPKZgj1wIRjvtBxBCpUNaYQ2zm0UjK6Uxw==",
       "license": "MIT",
       "dependencies": {
         "@casl/ability": "^6.7.3",
-        "@lark-apaas/nestjs-authnpaas": "^1.0.5",
+        "@lark-apaas/nestjs-authnpaas": "^1.0.7",
         "@lark-apaas/nestjs-common": "^0.1.9",
         "jsonwebtoken": "^9.0.3",
         "reflect-metadata": "^0.1.13",

package/template/package.json

@@ -33,10 +33,10 @@
     "upgrade": "npx -y @lark-apaas/fullstack-cli sync --disable-gen-openapi"
   },
   "dependencies": {
-    "@lark-apaas/fullstack-nestjs-core": "^1.1.57",
+    "@lark-apaas/fullstack-nestjs-core": "^1.1.59",
     "@nestjs/axios": "^4.0.1",
-    "@nestjs/common": "^10.4.20",
     "@nestjs/cache-manager": "^3.1.3",
+    "@nestjs/common": "^10.4.20",
     "@nestjs/config": "^3.3.0",
     "@nestjs/core": "^10.4.20",
     "@nestjs/platform-express": "^10.4.20",
@@ -62,9 +62,9 @@
     "@headlessui/react": "^2.2.9",
     "@heroicons/react": "^2.2.0",
     "@hookform/resolvers": "^5.2.2",
-    "@lark-apaas/client-toolkit": "^1.2.61",
+    "@lark-apaas/client-toolkit": "^1.2.63",
+    "@lark-apaas/coding-preset-vite-react": "1.0.18-alpha.20260819103004",
     "@lark-apaas/fullstack-presets": "^1.1.0",
-    "@lark-apaas/fullstack-vite-preset": "^1.0.34",
     "@nestjs/cli": "^10.4.9",
     "@nestjs/testing": "^10.4.20",
     "@radix-ui/react-accordion": "^1.2.12",
@@ -181,7 +181,7 @@
     "typescript-eslint": "^8.44.0",
     "uuid": "11.0.5",
     "vaul": "^1.1.2",
-    "vite": "^7.3.1",
+    "vite": "^8",
     "xlsx": "^0.18.5",
     "xlsx-js-style": "^1.2.0",
     "zod": "^3.25.76",

package/template/scripts/dev.js

@@ -59,10 +59,23 @@ function timestamp() {
   );
 }
 
-/** Write to terminal + dev.std.log */
+// Cap pending async stdout writes so a stalled pty consumer can't grow memory unbounded.
+// Each pending fs.write retains ~1.5 KB (msg + libuv/V8 wrappers); 1000 ≈ ~1.5 MB ceiling.
+let _stdoutInFlight = 0;
+const STDOUT_MAX_INFLIGHT = 1000;
+
+/** Write to dev.std.log (sync, guaranteed) + mirror to terminal (async, non-blocking) */
 function writeOutput(msg) {
-  try { process.stdout.write(msg); } catch {}
+  // File first and synchronously — read-logs reads this file; it must never be gated
+  // by the terminal consumer.
   try { fs.writeSync(devStdLogFd, msg); } catch {}
+  // stdout mirror via async fs.write: if process.stdout is a pty/pipe whose consumer
+  // stalls, the block happens on the libuv threadpool, NOT the event loop — so the
+  // synchronous log-FILE writes above (and subsequent readline callbacks) keep running.
+  // Drop overflow when too many writes are already pending (best-effort mirror).
+  if (_stdoutInFlight >= STDOUT_MAX_INFLIGHT) { return; }
+  _stdoutInFlight++;
+  try { fs.write(1, msg, () => { _stdoutInFlight--; }); } catch { _stdoutInFlight--; }
 }
 
 /** Structured event log → terminal + dev.std.log + dev.log */
@@ -239,20 +252,23 @@ process.on('SIGTERM', cleanup);
 process.on('SIGINT', cleanup);
 process.on('SIGHUP', cleanup);
 
-// Stale dist makes nest --watch skip missing files; watcher won't self-heal.
-function cleanStaleDist() {
-  const distPath = path.join(PROJECT_ROOT, 'dist');
-  if (fs.existsSync(distPath)) {
-    fs.rmSync(distPath, { recursive: true, force: true });
-    logEvent('INFO', 'main', 'Cleaned dist/ to force full rebuild');
-  }
-}
+// 定向保留 dist/ 里能复用的部分, 替代之前无脑 rm -rf dist/。
+// 收益: 保留 dist/server 让 nest --watch 从增量编译起点起 (省 8-13s 冷启动),
+// routes JSON 也保留 (build 会覆盖, 无 stale 风险)。dist/client/index.html 按
+// preset 打的 <meta name="miaoda-html-mode"> marker 判定:
+//   marker=dev  → 保留 dist/client/ 整个 (dev cache hit)
+//   marker=prod → agent 跑过 build:client 污染, 定向清 index.html + assets/
+// 具体逻辑抽到 lib/preserve-dev-cache.cjs 便于单测。
+// 降级 escape hatch: FORCE_CLEAN_DIST=true 走原全清路径 (marker 逻辑出 bug 时用)。
+const { preserveDevCache } = require('./lib/preserve-dev-cache.cjs');
 
 // ── Main ──────────────────────────────────────────────────────────────────────
 async function main() {
   logEvent('INFO', 'main', '========== Dev session started ==========');
 
-  cleanStaleDist();
+  preserveDevCache(PROJECT_ROOT, {
+    log: (level, msg) => logEvent(level, 'main', msg),
+  });
 
   // Initialize action plugins
   writeOutput('\n🔌 Initializing action plugins...\n');

package/template/scripts/lib/preserve-dev-cache.cjs

@@ -0,0 +1,123 @@
+'use strict';
+
+// dev.js 启动时替代无脑 rm -rf dist/ 的 lib: 保留 dist/server (nest --watch 增量编译起点)
+// + 按 HTML mode marker 决定 dist/client 是保留还是清污染。
+// 跟 preset 侧 html-output plugin 的 injectHtmlModeMarker / detectHtmlMode 配套:
+// preset 写盘时打 marker (dev 版 vs prod 污染版), 这里读 marker 定去留。
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * 从 HTML 里回读 <meta name="miaoda-html-mode" content="dev|prod"> marker。
+ * 与 packages/tools/fullstack-vite-preset/src/vite-plugins/html-output-plugin.ts
+ * 的 detectHtmlMode 同源, 为了让 dev.js 模板脚本零依赖跑起来这里重复一份。
+ */
+function detectHtmlMode(htmlContent) {
+  const match = htmlContent.match(
+    /<meta\s+name=["']miaoda-html-mode["']\s+content=["'](dev|prod)["'][^>]*>/i
+  );
+  return (match && match[1]) || 'unknown';
+}
+
+/**
+ * 定向清理 dist/ 的可复用副本, 替代 dev.js 之前无脑 `rm -rf dist/` 的 cleanStaleDist。
+ *
+ * 决策规则:
+ *  - FORCE_CLEAN_DIST=true → 走 escape hatch 全清 (preserveDevCache 逻辑 / 保留的
+ *    dist/server 出 stale 时兜底)
+ *  - dist/ 不存在 → 无动作
+ *  - dist/client/index.html 存在且 marker=dev → 整个 dist/client/ 保留 (dev cache hit)
+ *  - 存在但 marker=prod 或缺失 → 只清 dist/client/index.html + dist/client/assets/
+ *    (build 污染部分), dist/server/ 与 routes JSON 保留
+ *  - 不存在 → 无动作, htmlOutputPlugin 稍后会写入
+ *
+ * @param {string} projectRoot 项目根目录
+ * @param {object} [options]
+ * @param {(level: string, msg: string) => void} [options.log] 日志回调, 默认 console.log
+ * @param {boolean} [options.forceClean] 覆盖 FORCE_CLEAN_DIST env var 判断 (给测试用)
+ * @returns {{ action: 'no_dist' | 'force_cleaned' | 'no_index' | 'preserved' | 'cleaned_polluted' | 'read_failed_cleaned' | 'cleanup_failed', mode: string }}
+ */
+function preserveDevCache(projectRoot, options) {
+  const log = (options && options.log) || defaultLogger;
+  const forceClean =
+    options && typeof options.forceClean === 'boolean'
+      ? options.forceClean
+      : process.env.FORCE_CLEAN_DIST === 'true';
+
+  const distPath = path.join(projectRoot, 'dist');
+  if (!fs.existsSync(distPath)) {
+    log('INFO', 'preserveDevCache: no dist/, will be created by vite/nest');
+    return { action: 'no_dist', mode: 'unknown' };
+  }
+
+  if (forceClean) {
+    fs.rmSync(distPath, { recursive: true, force: true });
+    log(
+      'INFO',
+      'preserveDevCache: FORCE_CLEAN_DIST=true, cleaned entire dist/'
+    );
+    return { action: 'force_cleaned', mode: 'unknown' };
+  }
+
+  const clientDir = path.join(distPath, 'client');
+  const indexHtml = path.join(clientDir, 'index.html');
+
+  if (!fs.existsSync(indexHtml)) {
+    log(
+      'INFO',
+      'preserveDevCache: no dist/client/index.html, other artifacts preserved'
+    );
+    return { action: 'no_index', mode: 'unknown' };
+  }
+
+  let mode = 'unknown';
+  let readFailed = false;
+  try {
+    const content = fs.readFileSync(indexHtml, 'utf-8');
+    mode = detectHtmlMode(content);
+  } catch (e) {
+    log(
+      'WARN',
+      `preserveDevCache: read dist/client/index.html failed: ${e.message}, treating as polluted`
+    );
+    readFailed = true;
+    mode = 'unknown';
+  }
+
+  if (mode === 'dev') {
+    log('INFO', 'preserveDevCache: dist/client preserved (dev cache hit)');
+    return { action: 'preserved', mode: 'dev' };
+  }
+
+  // marker=prod 或 unknown → build:client 污染 (或人为放的产物), 定向清 index.html + assets/
+  // dist/server/, dist/*.json 保留
+  try {
+    fs.rmSync(indexHtml, { force: true });
+    const assetsDir = path.join(clientDir, 'assets');
+    if (fs.existsSync(assetsDir)) {
+      fs.rmSync(assetsDir, { recursive: true, force: true });
+    }
+    log(
+      'INFO',
+      `preserveDevCache: dist/client/index.html was ${mode}, cleaned index.html + assets/ (dist/server preserved)`
+    );
+    return {
+      action: readFailed ? 'read_failed_cleaned' : 'cleaned_polluted',
+      mode,
+    };
+  } catch (e) {
+    log(
+      'WARN',
+      `preserveDevCache: cleanup failed: ${e.message}, continuing anyway (index.html / assets may still be polluted)`
+    );
+    return { action: 'cleanup_failed', mode };
+  }
+}
+
+function defaultLogger(level, msg) {
+  // eslint-disable-next-line no-console
+  console.log(`[${level}] [main] ${msg}`);
+}
+
+module.exports = { detectHtmlMode, preserveDevCache };

package/template/scripts/lint.js

@@ -72,20 +72,35 @@ const STYLELINT_CONFIG_FILES = [
 ];
 
 /**
- * 老模板（fullstack-nestjs-template 1.x 时代）的应用没有 stylelint 配置，跑 stylelint 会以
- * "ConfigurationError: No configuration provided" 挂掉、把 pre-commit 卡死。没配置就跳过。
+ * 老模板（fullstack-nestjs-template 1.x 时代）的应用跑不了 stylelint，跑了就挂、把 pre-commit
+ * 卡死。两种形态都实测过：
+ *
+ * - 缺 scripts.stylelint → `npm error Missing script: "stylelint"`
+ * - 缺 .stylelintrc.*    → `ConfigurationError: No configuration provided`
+ *
+ * 注意光判断 stylelint 装没装拦不住：@lark-apaas/fullstack-presets 的 dependencies 里有
+ * stylelint，只要 dep 了 presets 二进制就在。缺任一件就跳过这一步。
  */
-function hasStylelintConfig() {
+function canRunStylelint() {
+  let pkg;
+  try {
+    pkg = JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf8'));
+  } catch {
+    return false;
+  }
+
+  if (!pkg.scripts || !pkg.scripts.stylelint) return false;
+
   return STYLELINT_CONFIG_FILES.some(file => fs.existsSync(path.join(cwd, file)));
 }
 
 async function runDefaultLint() {
   const commands = ['npm run eslint', 'npm run type:check'];
 
-  if (hasStylelintConfig()) {
+  if (canRunStylelint()) {
     commands.push('npm run stylelint');
   } else {
-    console.warn('[lint] Skip stylelint: no stylelint config found');
+    console.warn('[lint] Skip stylelint: missing scripts.stylelint or stylelint config');
   }
 
   const code = await runCommand(getBinName('npx'), ['concurrently', ...commands]);
@@ -126,8 +141,8 @@ async function runSelectiveLint(inputFiles) {
     tasks.push(runCommand(getBinName('npx'), ['eslint', '--quiet', ...eslintFiles]));
   }
 
-  if (stylelintFiles.length > 0 && !hasStylelintConfig()) {
-    console.warn('[lint] Skip stylelint: no stylelint config found');
+  if (stylelintFiles.length > 0 && !canRunStylelint()) {
+    console.warn('[lint] Skip stylelint: missing scripts.stylelint or stylelint config');
   } else if (stylelintFiles.length > 0) {
     tasks.push(runCommand(getBinName('npx'), ['stylelint', '--quiet', ...stylelintFiles]));
   }

package/template/vite.config.ts

@@ -1,5 +1,5 @@
 import path from 'path';
-import { defineConfig } from '@lark-apaas/fullstack-vite-preset';
+import { defineConfig } from '@lark-apaas/coding-preset-vite-react';
 
 export default defineConfig({
   resolve: {