cardbuddy 0.6.0

package/dist/server-core/_vendor/finmall-env.mjs

@@ -0,0 +1,96 @@
+/**
+ * FinMall 环境配置统一加载器（优先级：真实环境变量 > .env.finmall.local > .env.finmall）。
+ * 不依赖 Vite loadEnv（serve 期 / node 脚本 / cardbuddy 三处取值一致）。
+ * root 默认 process.cwd()，可传参覆盖；发布态不用 __dirname 反推仓库根。
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+
+function parseEnvFile(file) {
+  const out = {}
+  if (!fs.existsSync(file)) return out
+  for (const raw of fs.readFileSync(file, 'utf8').split('\n')) {
+    const line = raw.trim()
+    if (!line || line.startsWith('#')) continue
+    const i = line.indexOf('=')
+    if (i < 0) continue
+    const key = line.slice(0, i).trim()
+    let val = line.slice(i + 1).trim()
+    if (
+      (val.startsWith('"') && val.endsWith('"')) ||
+      (val.startsWith("'") && val.endsWith("'"))
+    ) {
+      val = val.slice(1, -1)
+    }
+    out[key] = val
+  }
+  return out
+}
+
+/**
+ * 按指定 root 加载 FinMall 环境配置。
+ * @param {string} [root] 项目根（含 .env.finmall）；默认 process.cwd()
+ * @returns {{
+ *   FINMALL_BASE_URL:string, FINMALL_APP_ID:string, FINMALL_WORKSPACE_ID:string,
+ *   FINMALL_CDP_PORT:number, FINMALL_DEV_PORT:number, FINMALL_EDITOR_PATH:string
+ * }}
+ */
+export function loadFinmallEnv(root = process.cwd()) {
+  const fromFile = parseEnvFile(path.join(root, '.env.finmall'))
+  const fromLocal = parseEnvFile(path.join(root, '.env.finmall.local'))
+  // 真实环境变量优先级最高；但只关心 FINMALL_ 前缀与已存在的覆盖变量
+  const env = { ...fromFile, ...fromLocal, ...process.env }
+  return {
+    /** 远端站点基址（如 https://uat-pkg.finmall.com） */
+    FINMALL_BASE_URL: env.FINMALL_BASE_URL || 'https://uat-pkg.finmall.com',
+    /** 应用标识 */
+    FINMALL_APP_ID: env.FINMALL_APP_ID || '100042',
+    /** 工作空间标识 */
+    FINMALL_WORKSPACE_ID: env.FINMALL_WORKSPACE_ID || 'dev',
+    /** Chrome 远程调试端口（connectOverCDP 用） */
+    FINMALL_CDP_PORT: Number(env.FINMALL_CDP_PORT || 9222),
+    /** 本地 dev server 监听端口（vite / 截图 / MCP / 各类工具默认连此端口） */
+    FINMALL_DEV_PORT: Number(env.FINMALL_DEV_PORT || 5180),
+    /** 远端编辑器 Web 访问别名（站点下挂载路径，部署到别的目录时改这里） */
+    FINMALL_EDITOR_PATH: (env.FINMALL_EDITOR_PATH || '/ubomp-h5-sub').replace(/\/+$/, ''),
+  }
+}
+
+// 向后兼容：直接命名导出（默认取 cwd 为项目根，与「默认项目根 = cwd」约定一致）。
+// 注意：这些常量在模块加载时按 cwd 计算一次；若需按其他 root 取值，请改用 loadFinmallEnv(root)。
+const d = loadFinmallEnv(process.cwd())
+export const FINMALL_BASE_URL = d.FINMALL_BASE_URL
+export const FINMALL_APP_ID = d.FINMALL_APP_ID
+export const FINMALL_WORKSPACE_ID = d.FINMALL_WORKSPACE_ID
+export const FINMALL_CDP_PORT = d.FINMALL_CDP_PORT
+export const FINMALL_DEV_PORT = d.FINMALL_DEV_PORT
+export const FINMALL_EDITOR_PATH = d.FINMALL_EDITOR_PATH
+
+/**
+ * 本地 dev server 的 HTTP 基址。host 默认 127.0.0.1；
+ * 仍可用各自的覆盖环境变量（CARD_SCREENSHOT_BASE / CARD_API_BASE / CARD_CHECK_BASE）兜底。
+ * @param {string} [host]
+ * @returns {string}
+ */
+export function devApiBase(host = '127.0.0.1') {
+  return `http://${host}:${FINMALL_DEV_PORT}`
+}
+
+/**
+ * 构造远端编辑器访问 URL（线上属性面板比对 / 真机预览用）。
+ * @param {string|number} pageId 数字型 cardId（pageId）
+ * @returns {string}
+ */
+export function remoteEditorUrl(pageId) {
+  return (
+    `${FINMALL_BASE_URL}${FINMALL_EDITOR_PATH}/` +
+    `?platform=flame&appId=${FINMALL_APP_ID}&workspaceId=${FINMALL_WORKSPACE_ID}` +
+    `#/inner_card/editor/design?id=${pageId}&showType=view`
+  )
+}
+
+export default {
+  ...d,
+  devApiBase,
+  remoteEditorUrl,
+}

package/dist/server-core/assetProxy.js

@@ -0,0 +1,154 @@
+import fs from 'node:fs'
+import crypto from 'node:crypto'
+import path from 'node:path'
+
+/**
+ * 远端资源代理：把预览里引用的站内资源路径（@filestore / /minio / /fastdfs …）
+ * 回源到 FinMall 上游站点并落盘缓存。所有跨网络回源逻辑集中在本模块维护。
+ */
+
+/**
+ * adapter.doReplaceUrl 产出的是站内绝对路径（例如 `@filestore/x` -> `/minio/x`）。
+ * 这里把站内路径还原成上游真实地址；同一前缀可能有多个候选，按序回退。
+ */
+const PREFIX_UPSTREAM = {
+  '/minio/': ['/filestore/', '/minio/'],
+  '/filestore/': ['/filestore/'],
+  '/fastdfs/': ['/fastdfs/', '/filestore/'],
+  '/floorstatic/': ['/floorstatic/', '/filestore/'],
+}
+
+const PROXY_PREFIXES = Object.keys(PREFIX_UPSTREAM)
+
+const MIME = {
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.jpeg': 'image/jpeg',
+  '.gif': 'image/gif',
+  '.webp': 'image/webp',
+  '.svg': 'image/svg+xml',
+  '.ico': 'image/x-icon',
+  '.json': 'application/json',
+  '.css': 'text/css',
+  '.js': 'text/javascript',
+  '.woff': 'font/woff',
+  '.woff2': 'font/woff2',
+  '.ttf': 'font/ttf',
+}
+
+/** 上游拿不到时的占位图，避免整卡渲染被一张图阻塞 */
+const PLACEHOLDER = Buffer.from(
+  `<svg xmlns="http://www.w3.org/2000/svg" width="120" height="120" viewBox="0 0 120 120">
+  <rect width="120" height="120" fill="#f0f1f5"/>
+  <path d="M30 78l22-26 16 19 12-13 10 20z" fill="#c8ccd8"/>
+  <circle cx="44" cy="42" r="8" fill="#c8ccd8"/>
+  <text x="60" y="106" font-size="10" fill="#9aa0b0" text-anchor="middle" font-family="sans-serif">asset missing</text>
+</svg>`,
+  'utf8'
+)
+
+/** URL 里的中文/空格等需要转义后才能发请求，但缓存 key 用原始 pathname */
+function encodePath(p) {
+  return p
+    .split('/')
+    .map((seg) => (/%[0-9a-fA-F]{2}/.test(seg) ? seg : encodeURIComponent(seg)))
+    .join('/')
+}
+
+function cachePathFor(pathname, cacheDir) {
+  const hash = crypto.createHash('md5').update(pathname).digest('hex').slice(0, 16)
+  const ext = path.extname(pathname.split('?')[0]) || '.bin'
+  return path.join(cacheDir, `${hash}${ext}`)
+}
+
+async function fetchUpstream(pathname, upstream) {
+  const prefix = PROXY_PREFIXES.find((p) => pathname.startsWith(p))
+  if (!prefix) return null
+  const rest = pathname.slice(prefix.length)
+  for (const upPrefix of PREFIX_UPSTREAM[prefix]) {
+    const url = upstream + encodePath(upPrefix + rest)
+    try {
+      const res = await fetch(url, {
+        headers: { 'User-Agent': 'Mozilla/5.0', Referer: upstream + '/' },
+        signal: AbortSignal.timeout(12000),
+      })
+      if (!res.ok) continue
+      const buf = Buffer.from(await res.arrayBuffer())
+      if (!buf.length) continue
+      // 上游 404 页可能返回 200 + html，做一次内容嗅探
+      const ct = res.headers.get('content-type') || ''
+      if (ct.includes('text/html')) continue
+      return buf
+    } catch {
+      /* 换下一个候选 */
+    }
+  }
+  return null
+}
+
+/**
+ * 资源代理 + 落盘缓存（回源地址从传入的 upstream 取）。
+ * @param {{ root: string, upstream: string }} opts
+ */
+/**
+ * 资源代理 + 落盘缓存中间件（与 Express / Vite middleware 容器解耦）。
+ * 既可由 Vite 插件 configureServer 挂载，也可由 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}
+ */
+export function createAssetProxyMiddleware({ root, upstream }) {
+  const CACHE_DIR = path.join(root, '.cache', 'assets')
+  fs.mkdirSync(CACHE_DIR, { recursive: true })
+  return async (req, res, next) => {
+    const pathname = decodeURIComponent((req.url || '').split('?')[0])
+    if (!PROXY_PREFIXES.some((p) => pathname.startsWith(p))) return next()
+
+    const ext = path.extname(pathname) || '.bin'
+    const mime = MIME[ext.toLowerCase()] || 'application/octet-stream'
+    const cacheFile = cachePathFor(pathname, CACHE_DIR)
+
+    // 1) 命中缓存
+    if (fs.existsSync(cacheFile)) {
+      res.setHeader('Content-Type', mime)
+      res.setHeader('X-Asset-Cache', 'HIT')
+      res.setHeader('Cache-Control', 'public, max-age=31536000')
+      return res.end(fs.readFileSync(cacheFile))
+    }
+
+    // 2) 回源
+    const buf = await fetchUpstream(pathname, upstream)
+    if (buf) {
+      try {
+        fs.writeFileSync(cacheFile, buf)
+      } catch {
+        /* 缓存写失败不影响响应 */
+      }
+      res.setHeader('Content-Type', mime)
+      res.setHeader('X-Asset-Cache', 'MISS')
+      res.setHeader('Cache-Control', 'public, max-age=31536000')
+      return res.end(buf)
+    }
+
+    // 3) 占位图兜底
+    res.statusCode = 200
+    res.setHeader('Content-Type', 'image/svg+xml')
+    res.setHeader('X-Asset-Cache', 'FALLBACK')
+    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/bbox.js

@@ -0,0 +1,153 @@
+import path from 'node:path'
+import fs from 'node:fs'
+import { getBrowser, serialize, openCardScreen, MAX_QUEUED } from './browser.js'
+
+/**
+ * 渲染几何度量端点（UI 还原度对拍闭环 P0）：GET /__bbox/<id>?width=390
+ *
+ * 与 /__screenshot 互补：截图只给「整卡像素」，本端点输出「逐元素 bbox」，
+ * 供 fidelity_report.mjs（或任何对拍器）与设计稿 spec 的 rect 逐元素比对，
+ * 回答"差在哪里、差多少、疑似改哪个属性"。
+ *
+ * 输出结构（相对 .phone__screen 左上角的卡内坐标，CSS 像素）：
+ *   { id, viewportWidth, elements: [{ cid, className, text, rect: {x,y,width,height}, visible }] }
+ *
+ * 实现要点：
+ *   - 复用 ./browser.js 的单例浏览器 + 串行队列 + [data-card-ready] 等待（与截图同源，
+ *     保证"度量到的东西 = 截图里画出来的东西"）。
+ *   - 遍历 .phone__screen 内所有 [data-cid] 元素（RenderTree 在每个组件根挂
+ *     data-cid=node.componentId||node.id、data-class=node.className），叶子与容器都输出，
+ *     由对拍器按 className/层级过滤——这里只做纯度量，不做业务判断。
+ *   - text 为 textContent 归一化快照（截 80 字符），供对拍器做"文本匹配"（spec 无稳定 id）。
+ *   - visible 标记：宽高为 0 或 display/visibility 隐藏的元素不参与对拍。
+ *   - 失败一律结构化响应（429/500/503/504），不抛未捕获异常。
+ */
+
+/** 保留 1 位小数（deviceScaleFactor=2 下 CSS 像素可能为小数） */
+function r1(n) {
+  return Math.round(n * 10) / 10
+}
+
+/**
+ * 对单卡度量全部 [data-cid] 元素 bbox。纯函数、无 HTTP。
+ * @param {string} id 卡片 id
+ * @param {number} width 视口宽度（卡片框固定 375px，这里给外层留白）
+ */
+async function takeBboxes(id, width) {
+  let browser
+  try {
+    browser = await getBrowser()
+  } catch (e) {
+    return {
+      error: 'browser-launch-failed',
+      code: 503,
+      message: String((e && e.message) || e),
+      fix: '系统 Chrome 未找到或未启动。请安装 Google Chrome，并确保 playwright 以 channel:"chrome" 启动（本端点固定使用该通道）。',
+    }
+  }
+
+  let context
+  try {
+    context = await browser.newContext({
+      viewport: { width: width + 80, height: 800 },
+      deviceScaleFactor: 2,
+    })
+    const { page, screen } = await openCardScreen(context, id)
+    try {
+      if (!screen) {
+        return { error: 'capture-target-not-found', code: 500, message: '.phone__screen 元素未找到' }
+      }
+
+      const elements = await page.evaluate(() => {
+        // 注意：evaluate 回调在浏览器上下文执行，不能引用 Node 侧函数（如 r1），需内联。
+        const r1 = (n) => Math.round(n * 10) / 10
+        const s = document.querySelector('.phone__screen')
+        if (!s) return []
+        const sr = s.getBoundingClientRect()
+        const out = []
+        s.querySelectorAll('[data-cid]').forEach((el) => {
+          const r = el.getBoundingClientRect()
+          const cs = getComputedStyle(el)
+          const text = (el.textContent || '').replace(/\s+/g, ' ').trim().slice(0, 120)
+          out.push({
+            cid: el.getAttribute('data-cid'),
+            className: el.getAttribute('data-class'),
+            text,
+            rect: {
+              x: r1(r.x - sr.x),
+              y: r1(r.y - sr.y),
+              width: r1(r.width),
+              height: r1(r.height),
+            },
+            visible: !!(r.width > 0 && r.height > 0) && cs.visibility !== 'hidden' && cs.display !== 'none',
+          })
+        })
+        return out
+      })
+
+      // screen 尺寸供对拍器判断「spec 整屏稿 vs 渲染卡主体」的 chrome 裁剪
+      // （变量名避开第 55 行解构出的 screen ElementHandle）
+      const screenInfo = await page.evaluate(() => {
+        const s = document.querySelector('.phone__screen')
+        if (!s) return null
+        const sr = s.getBoundingClientRect()
+        return { width: Math.round(sr.width), height: Math.round(sr.height) }
+      })
+
+      return { json: { id, viewportWidth: width, screen: screenInfo, elements } }
+    } finally {
+      await page.close().catch(() => {})
+    }
+  } catch (e) {
+    const isTimeout = /Timeout\s*\d+ms exceeded/.test(String((e && e.message) || e))
+    return {
+      error: isTimeout ? 'render-wait-timeout' : 'bbox-failed',
+      code: isTimeout ? 504 : 500,
+      message: String((e && e.message) || e),
+      fix: isTimeout
+        ? '卡片首帧未在限定时间内挂载（data-card-ready 未出现）。检查该卡是否在 chrome=off 模式下渲染报错，或卡片依赖真实运行时数据（customAction/RPC）而无法在纯渲染模式落定。'
+        : undefined,
+    }
+  } finally {
+    if (context) await context.close().catch(() => {})
+  }
+}
+
+export function createBboxMiddleware({ root }) {
+  return async function bboxMiddleware(req, res, next) {
+    const pathname = decodeURIComponent((req.url || '').split('?')[0])
+    const m = pathname.match(/^\/__bbox\/([^/]+)$/)
+    if (!m) return next()
+    const id = decodeURIComponent(m[1])
+
+    const dir = path.join(root, 'src', 'cards', id)
+    if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) {
+      res.statusCode = 404
+      res.setHeader('Content-Type', 'application/json')
+      return res.end(JSON.stringify({ error: 'card not found', id }))
+    }
+
+    const url = new URL(req.url, 'http://localhost')
+    const width = parseInt(url.searchParams.get('width') || '390', 10) || 390
+
+    const result = await serialize(() => takeBboxes(id, width))
+    if (result.tooBusy) {
+      res.statusCode = 429
+      res.setHeader('Content-Type', 'application/json')
+      return res.end(
+        JSON.stringify({ error: 'too-busy', message: '度量队列已满（并发上限 ' + MAX_QUEUED + '），请稍后重试' }),
+      )
+    }
+    if (result.error) {
+      const code = result.code || 503
+      res.statusCode = code
+      res.setHeader('Content-Type', 'application/json')
+      return res.end(JSON.stringify({ error: result.error, message: result.message, fix: result.fix }))
+    }
+
+    res.statusCode = 200
+    res.setHeader('Content-Type', 'application/json')
+    res.setHeader('Cache-Control', 'no-store')
+    return res.end(JSON.stringify(result.json))
+  }
+}

package/dist/server-core/browser.js

@@ -0,0 +1,108 @@
+import { devApiBase } from './_vendor/finmall-env.mjs'
+
+/**
+ * 共享浏览器单例 + 卡片页面加载（screenshot.js / bbox.js 共用）。
+ *
+ * 设计要点（与 screenshot.js 历史实现保持一致，避免回归）：
+ *   - playwright 不在此处静态 import，统一在 getBrowser() 内动态 import：
+ *     否则它会被卷进 vite.config 的加载图，导致「未装 devDependencies 的机器上
+ *     npm run build 因解析不到 playwright 而失败」。缺失时端点运行时返回 503 + 修复指引。
+ *   - 单例浏览器（channel:'chrome' 系统 Chrome）+ 串行队列（>MAX_QUEUED 在途返回 tooBusy）
+ *     + 惰性启动 + 空闲 5 分钟自动关闭。
+ *   - openCardScreen()：打开 /?card=<id>&chrome=off，等 [data-card-ready] 出现（而非
+ *     networkidle），再稳定一拍 SETTLE_MS，返回 { page, screen }（screen 为 .phone__screen
+ *     的 ElementHandle，不存在时为 null）。
+ */
+
+const BASE_URL = process.env.CARD_SCREENSHOT_BASE || devApiBase()
+const IDLE_CLOSE_MS = 5 * 60 * 1000
+const MAX_QUEUED = 10
+const NAV_TIMEOUT_MS = 30000
+const SETTLE_MS = 400
+
+let browserPromise = null
+let idleTimer = null
+let chromiumMod = null
+
+/** 取（惰性启动的）单例浏览器；启动失败会把 browserPromise 复位并抛出 */
+async function getBrowser() {
+  // 动态 import playwright：避免其进入 vite.config 加载图（见文件头注释）
+  if (!chromiumMod) chromiumMod = await import('playwright')
+  if (!browserPromise) {
+    browserPromise = chromiumMod.chromium
+      .launch({ channel: 'chrome', headless: true })
+      .catch((e) => {
+        browserPromise = null
+        throw e
+      })
+  }
+  resetIdleTimer()
+  return browserPromise
+}
+
+function resetIdleTimer() {
+  if (idleTimer) clearTimeout(idleTimer)
+  idleTimer = setTimeout(async () => {
+    idleTimer = null
+    const p = browserPromise
+    browserPromise = null
+    // 注意：browserPromise 是 launch 的 Promise，不是浏览器实例本身；
+    // 必须先 await 拿到实例再 close，否则 b.close is not a function 会抛未捕获异常拖垮进程。
+    if (p) {
+      try {
+        const b = await p
+        if (b && typeof b.close === 'function') await b.close()
+      } catch (_) { /* 关闭失败忽略 */ }
+    }
+  }, IDLE_CLOSE_MS)
+}
+
+/** 串行化所有浏览器任务，超过 MAX_QUEUED 在途则返回 { tooBusy: true } */
+let chain = Promise.resolve()
+let inflight = 0
+function serialize(task) {
+  if (inflight >= MAX_QUEUED) return Promise.resolve({ tooBusy: true })
+  inflight += 1
+  const p = chain.then(() => task()).finally(() => {
+    inflight -= 1
+  })
+  // 保持链存活（吞掉错误，避免后续任务被牵连拒绝）
+  chain = p.catch(() => {})
+  return p
+}
+
+/**
+ * 打开卡片渲染页（chrome=off 纯净模式）并等待首帧稳定。
+ * @param {import('playwright').BrowserContext} context
+ * @param {string} id 卡片 id
+ * @returns {Promise<{ page: import('playwright').Page, screen: import('playwright').ElementHandle | null }>}
+ */
+async function openCardScreen(context, id) {
+  const page = await context.newPage()
+  const target = `${BASE_URL}/?card=${encodeURIComponent(id)}&chrome=off`
+  await page.goto(target, { waitUntil: 'domcontentloaded', timeout: NAV_TIMEOUT_MS })
+  // 等卡片首帧挂载（App.vue 置 data-card-ready=1）。用 waitForFunction 精确判断属性出现，
+  // 而非等待「元素可见」（避免卡片有但属性未置位时误判）。
+  await page.waitForFunction(
+    () => {
+      const el = document.querySelector('.phone__screen')
+      return !!el && el.hasAttribute('data-card-ready')
+    },
+    { timeout: NAV_TIMEOUT_MS },
+  )
+  // 再稳定一拍：让 created/mounted 里可能触发的重渲染（如补数据）落定
+  await page.waitForTimeout(SETTLE_MS)
+  const screen = await page.$('.phone__screen')
+  return { page, screen }
+}
+
+export {
+  BASE_URL,
+  IDLE_CLOSE_MS,
+  MAX_QUEUED,
+  NAV_TIMEOUT_MS,
+  SETTLE_MS,
+  getBrowser,
+  serialize,
+  openCardScreen,
+}

package/dist/server-core/buildDataFromSchema.js

@@ -0,0 +1,50 @@
+/**
+ * 由 schema 派生 data 的「单一真相」实现 —— 服务端写盘 / 同步落盘 / 预览渲染注入 /
+ * 历史快照还原 三处共用，保证任意环节看到的 data 都严格等于 buildDataFromSchema(schema)。
+ *
+ * 架构前提（「schema 唯一真值、data 单向派生」）：
+ *   data.json 文件是 schema.json 的纯投影，绝不被读回作为数据源。每次写盘或远端同步
+ *   后都由本函数依据 schema.dictionary.inputParams[].defaultValue 重算 data.json。
+ *   仅当 defaultValue 为空 / 空对象 / 未定义时，回退到 param.desc 里的 JSON 兜底
+ *   （desc 以 '{' 开头且解析后含该 key 时生效）。
+ *
+ * 本文件是纯 ESM（无任何 node / 浏览器专有依赖），因此既能被服务端（Node）import，
+ * 也能被预览前端（Vite 打包）直接 import，避免逻辑漂移。
+ */
+export function buildDataFromSchema(schema) {
+  // 稳健性：schema 缺失 / 非对象（如外部改坏 schema.json）时返回空对象，
+  // 不抛错，避免 GET /__card 在损坏卡片上返回 500 堆栈。
+  if (!schema || typeof schema !== 'object') return {}
+  const data = {}
+  for (const param of schema.dictionary?.inputParams || []) {
+    const fallback = parseDescFallback(param)
+    const defaultValue = param.defaultValue
+    const emptyObject =
+      defaultValue &&
+      typeof defaultValue === 'object' &&
+      !Array.isArray(defaultValue) &&
+      Object.keys(defaultValue).length === 0
+    data[param.key] = clone(
+      fallback !== undefined && (defaultValue === undefined || defaultValue === '' || emptyObject)
+        ? fallback
+        : defaultValue,
+    )
+  }
+  return data
+}
+
+function parseDescFallback(param) {
+  if (!param.desc || typeof param.desc !== 'string') return undefined
+  const text = param.desc.trim()
+  if (!text.startsWith('{')) return undefined
+  try {
+    const parsed = JSON.parse(text)
+    return Object.prototype.hasOwnProperty.call(parsed, param.key) ? parsed[param.key] : undefined
+  } catch {
+    return undefined
+  }
+}
+
+function clone(value) {
+  return value == null ? value : JSON.parse(JSON.stringify(value))
+}