cardbuddy 0.9.0 → 0.10.0

package/dist/preview-editor/index.html

@@ -8,8 +8,8 @@
     <link rel="icon" type="image/png" sizes="16x16" href="/assets/favicon-16-Cg6Nrosk.png" />
     <link rel="icon" type="image/png" sizes="32x32" href="/assets/favicon-32-B_1744sp.png" />
     <link rel="apple-touch-icon" sizes="180x180" href="/assets/apple-touch-icon-BQcES9QK.png" />
-    <script type="module" crossorigin src="/assets/index-DnpHHKWl.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-CrcrVs4F.css">
+    <script type="module" crossorigin src="/assets/index-D1iIJ4sl.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-C_UKS0NF.css">
   </head>
   <body>
     <div id="app"></div>

package/dist/server-core/assetProxy.js

@@ -87,13 +87,9 @@ async function fetchUpstream(pathname, upstream) {
 }
 
 /**
- * 资源代理 + 落盘缓存（回源地址从传入的 upstream 取）。
- * @param {{ root: string, upstream: string }} opts
- */
-/**
- * 资源代理 + 落盘缓存中间件（与 Express / Vite middleware 容器解耦）。
- * 既可由 Vite 插件 configureServer 挂载，也可由 server/core 的 mountCoreMiddlewares
- * 直接挂载到 cardbuddy（8787），实现「Vite 零后端插件、8787 是唯一后端」。
+ * 资源代理 + 落盘缓存中间件（回源地址从传入的 upstream 取；与 Express / Vite middleware 容器解耦）。
+ * 由 server/core 的 mountCoreMiddlewares 挂载到 cardbuddy（8787），
+ * 实现「Vite 零后端插件、8787 是唯一后端」。
  * @param {{ root: string, upstream: string }} opts
  * @returns {(req: import('http').IncomingMessage, res: import('http').ServerResponse, next: Function) => void}
  */
@@ -137,18 +133,3 @@ export function createAssetProxyMiddleware({ root, upstream }) {
     return res.end(PLACEHOLDER)
   }
 }
-
-/**
- * Vite 插件适配层（保留以兼容纯 vite dev 场景）：configureServer 阶段把
- * createAssetProxyMiddleware 挂到 server.middlewares。前后分离架构下已由 server/core
- * 的 mountCoreMiddlewares 挂载到 cardbuddy（8787），Vite 不再需要此插件。
- * @param {{ root: string, upstream: string }} opts
- */
-export function createAssetProxyPlugin({ root, upstream }) {
-  return {
-    name: 'finmall-asset-proxy',
-    configureServer(server) {
-      server.middlewares.use(createAssetProxyMiddleware({ root, upstream }))
-    },
-  }
-}

package/dist/server-core/buildDataFromSchema.js

@@ -8,13 +8,21 @@
  *   仅当 defaultValue 为空 / 空对象 / 未定义时，回退到 param.desc 里的 JSON 兜底
  *   （desc 以 '{' 开头且解析后含该 key 时生效）。
  *
+ * mock 覆盖（dictionary.mocks）：
+ *   平台变量面板的「配置变量 mock」把设计期覆盖值写在 dictionary.mocks（key → 值），
+ *   与「默认值」inputParams[].defaultValue 分仓：defaultValue 是随卡发布的缺省数据，
+ *   mocks 仅供设计期预览覆盖（编辑器画布），不进入 data.json。故默认（options.includeMocks
+ *    falsy）只按 defaultValue 派生 —— 服务端写盘 / 同步落盘走这条；编辑器预览态传
+ *   { includeMocks: true }，在 defaultValue 之上按 key 叠加非空 mock 值。
+ *
  * 本文件是纯 ESM（无任何 node / 浏览器专有依赖），因此既能被服务端（Node）import，
  * 也能被预览前端（Vite 打包）直接 import，避免逻辑漂移。
  */
-export function buildDataFromSchema(schema) {
+export function buildDataFromSchema(schema, options = {}) {
   // 稳健性：schema 缺失 / 非对象（如外部改坏 schema.json）时返回空对象，
   // 不抛错，避免 GET /__card 在损坏卡片上返回 500 堆栈。
   if (!schema || typeof schema !== 'object') return {}
+  const mocks = options.includeMocks ? readMocks(schema) : null
   const data = {}
   for (const param of schema.dictionary?.inputParams || []) {
     const fallback = parseDescFallback(param)
@@ -24,15 +32,39 @@ export function buildDataFromSchema(schema) {
       typeof defaultValue === 'object' &&
       !Array.isArray(defaultValue) &&
       Object.keys(defaultValue).length === 0
-    data[param.key] = clone(
+    let value =
       fallback !== undefined && (defaultValue === undefined || defaultValue === '' || emptyObject)
         ? fallback
-        : defaultValue,
-    )
+        : defaultValue
+    // mock 覆盖优先于默认值；空 mock（未配置）不覆盖，回退 defaultValue / desc 兜底
+    if (mocks && hasMockValue(mocks, param.key)) value = mocks[param.key]
+    data[param.key] = clone(value)
   }
   return data
 }
 
+/**
+ * 读取 dictionary.mocks（key → mock 值）。历史卡 / 同步脚本可能写成数组或缺省，
+ * 一律归一为 null（视为「没有 mock 表」），调用方无需再判形。
+ */
+export function readMocks(schema) {
+  const mocks = schema && schema.dictionary && schema.dictionary.mocks
+  return mocks && typeof mocks === 'object' && !Array.isArray(mocks) ? mocks : null
+}
+
+/**
+ * 某 key 是否「配置了 mock」：undefined / null / 空串 / 空容器 视为未配置
+ * （与变量列表的 m 徽标同一判据，避免空壳 mock 被当成有效覆盖）。
+ */
+export function hasMockValue(mocks, key) {
+  if (!mocks || !Object.prototype.hasOwnProperty.call(mocks, key)) return false
+  const value = mocks[key]
+  if (value === undefined || value === null || value === '') return false
+  if (Array.isArray(value)) return value.length > 0
+  if (typeof value === 'object') return Object.keys(value).length > 0
+  return true
+}
+
 function parseDescFallback(param) {
   if (!param.desc || typeof param.desc !== 'string') return undefined
   const text = param.desc.trim()

package/dist/server-core/cardListCache.js

@@ -13,7 +13,6 @@
  */
 
 const cardIndex = new Map(); // cardId(String) -> { cardId, code, cardName }
-let lastRefreshedAt = 0;
 
 /**
  * 写入/合并卡片列表。
@@ -27,7 +26,6 @@ export function refreshCardList(cards, { full = false } = {}) {
     const id = String(c.cardId);
     cardIndex.set(id, { cardId: id, code: c.code, cardName: c.cardName });
   }
-  lastRefreshedAt = Date.now();
 }
 
 /** 卡片是否存在于缓存列表（按 cardId / pageId 查）。 */
@@ -35,16 +33,6 @@ export function hasCardId(cardId) {
   return cardIndex.has(String(cardId));
 }
 
-/** 取缓存中的卡片元信息，不存在返回 null。 */
-export function getCard(cardId) {
-  return cardIndex.get(String(cardId)) || null;
-}
-
-/** 缓存是否已非空（至少同步过一次全量列表）。 */
-export function cacheSize() {
-  return cardIndex.size;
-}
-
 /**
  * 推送前存在性校验：目标卡片是否确实在远端卡片列表中（按 cardId/pageId 查）。
  * - 缓存为空（本次 dev server 尚未全量同步过）：放行，返回 allowed=true，避免误拦截首推。
@@ -61,8 +49,3 @@ export function checkPushAllowed(pageId) {
     reason: `卡片 pageId=${pageId} 不在远端卡片列表中，疑似已删除或 pageId 错位，请先「远程同步」刷新列表后再推送`,
   };
 }
-
-/** 上次刷新时间戳（ms），未刷新为 0。 */
-export function lastRefreshed() {
-  return lastRefreshedAt;
-}

package/dist/server-core/index.js

@@ -3,11 +3,9 @@
  *
  * 设计：
  *   - 每个端点都是独立 `(req, res, next)` 中间件工厂（见同目录各文件），与 Express / Vite
- *     中间件容器解耦，因此可被两处复用：
- *       1) Vite 插件（server/cardServer.js，编辑器内核开发 same-origin 路径）；
- *       2) 独立本地开发服务（packages/cardbuddy，公网静态编辑器指向本机路径）。
- *   - mountCoreMiddlewares(app, opts) 把全部中间件挂到任意 Connect 风格容器（Vite 的
- *     server.middlewares 或 connect 实例皆可），两处共用、改一处两处同步。
+ *     中间件容器解耦，由本地开发服务 packages/cardbuddy 统一装配（dev 与发布态同一份）。
+ *   - mountCoreMiddlewares(app, opts) 把全部中间件挂到任意 Connect 风格容器（cardbuddy 的
+ *     connect 实例，或 tools/regress-data.mjs 里的临时容器），改一处全链路同步。
  *
  * 注意：renderStatus / nodeModels 需要活着的 vite 实例做 ssrLoadModule，故 mountCoreMiddlewares
  * 接收 viteServer 参数透传；无 SSR 需求的场景可传 null（这两个端点会返回明确错误）。

package/dist/server-core/logStream.js

@@ -166,11 +166,6 @@ export function subscribeLog(cb) {
   return () => subscribers.delete(cb)
 }
 
-/** 当前订阅者数量（诊断用）。 */
-export function logSubscriberCount() {
-  return subscribers.size
-}
-
 let mirrorInstalled = false
 
 /**
@@ -218,7 +213,7 @@ export function installLogMirror() {
 
 /**
  * 日志流 HTTP 端点：GET /__logs（历史/补漏）、POST /__logs/ingest（外部进程注入）。
- * 挂在 mountCoreMiddlewares 里，因此 Vite 插件形态与 cardbuddy 独立服务形态同时可用。
+ * 挂在 mountCoreMiddlewares 里，随 cardbuddy 本地服务一并生效。
  */
 export function createLogMiddleware() {
   const sendJson = (res, status, payload) => {

package/dist/standalone.js

@@ -24,6 +24,7 @@ import chalk from 'chalk'
 
 import { mountCoreMiddlewares, installLogMirror, subscribeLog } from './core.js'
 import { loadConfig } from './config.js'
+import { ensurePortFree } from './portGuard.js'
 
 const MIME_TYPES = {
   '.html': 'text/html; charset=utf-8',
@@ -45,6 +46,13 @@ const MIME_TYPES = {
   '.map': 'application/json; charset=utf-8',
 }
 
+// 被 dev.mjs 拉起时（DSL_LAUNCHER='dev'），来源标签由启动器用带背景色的 chip 标注，
+// 这里让出前缀避免双重来源标签；直接运行 / dev:prod（stdio:inherit）则自带标签。
+const srcTag =
+  process.env.DSL_LAUNCHER === 'dev'
+    ? ''
+    : chalk.magenta('▌ ') + chalk.magenta.bold('cardbuddy') + ' '
+
 function decodePathname(url) {
   if (!url) return '/'
   const raw = url.split('?')[0]
@@ -382,6 +390,21 @@ async function resolveTls(config) {
  */
 export async function startServer(userConfig = {}) {
   const config = { ...loadConfig(), ...userConfig }
+
+  // 日志镜像尽早安装（幂等，CLI 入口已先行装过一次）：让端口接管等启动期日志也能进入
+  // 编辑器底部「服务日志」面板的环形缓冲。
+  installLogMirror()
+
+  // 端口前置检查：被「上一个 cardbuddy 实例」占用时主动结束它再接管（见 src/portGuard.js）。
+  // 放在最前面，避免白跑一遍 TLS / Vite 初始化后才以 EADDRINUSE 失败。
+  await ensurePortFree({
+    port: config.port,
+    tls: config.https,
+    token: config.token,
+    mode: config.portTakeover,
+    log: (msg) => console.log(srcTag + msg),
+  })
+
   const app = connect()
 
   app.use(corsMiddleware)
@@ -403,8 +426,7 @@ export async function startServer(userConfig = {}) {
 
   // 服务日志流：镜像本进程 stdout/stderr（含 chalk ANSI）→ 环形缓冲 → SSE 批量推送。
   // 编辑器底部「服务日志」面板订阅 event: service-log；历史与断线补漏走 GET /__logs。
-  // installLogMirror 幂等，CLI 入口已先行安装，这里兜住以编程方式调用 startServer 的场景。
-  installLogMirror()
+  // 镜像本体在函数开头安装，这里只负责把新增行转推给 SSE 订阅者。
   subscribeLog((lines) => events.notify({ lines }, 'service-log'))
 
   const vite = await createEmbeddedVite(config)
@@ -437,12 +459,6 @@ export async function startServer(userConfig = {}) {
   })
 
   const bind = `${scheme}://127.0.0.1:${config.port}`
-  // 被 dev.mjs 拉起时（DSL_LAUNCHER='dev'），来源标签由启动器用带背景色的 chip 标注，
-  // 这里让出前缀避免双重来源标签；直接运行 / dev:prod（stdio:inherit）则自带标签。
-  const srcTag =
-    process.env.DSL_LAUNCHER === 'dev'
-      ? ''
-      : chalk.magenta('▌ ') + chalk.magenta.bold('cardbuddy') + ' '
   console.log(
     srcTag +
       chalk.green(`本地开发服务已启动：${bind}`) +