cardbuddy 0.23.0 → 0.24.0

package/dist/vendored/server/core/flameCompile/clientElements.js

@@ -0,0 +1,372 @@
+/**
+ * 客户端（GaiaX / pmb-ios-flame）元素映射与样式转换
+ *
+ * 1:1 迁移自 flame-release-mange（Java）：
+ *   client/convert/element/*.java            → ELEMENTS 映射表
+ *   client/convert/element/utils/StyleConstTransformer  → styleConst
+ *   client/convert/element/utils/StyleVarTransformer    → styleVar
+ *
+ * 与 Java 版的差异（均为防御性收敛，不改变正常输入的产物）：
+ *   1. 未知 className 兜底为 `view`（Java 侧 ElementFactory 返回 null 会 NPE）；
+ *   2. 圆角/图片裁剪等分组在值为空时跳过（Java 侧无条件 put，会写出 `border-radius:null`）。
+ */
+
+import { hasText } from './common.js'
+
+/** 尺寸：数字补 px，`auto` / 百分号 / 空值原样 */
+export function doSize(num) {
+  if (num === null || num === undefined) return num
+  const s = String(num).trim()
+  if (s === '') return num
+  if (s === 'auto' || s.includes('%')) return s
+  return `${s}px`
+}
+
+export function doColor(color) {
+  return color
+}
+
+/** 颜色/尺寸之外的直通字段 */
+const raw = (v) => v
+
+/* ----------------------------- 元素映射表 ------------------------------ */
+
+/**
+ * @typedef {Object} ElementDesc
+ * @property {string} type            GaiaX 节点类型
+ * @property {boolean} [isNewTemplate] 是否拆分独立子模板（列表/网格）
+ * @property {Object} [styleDefault]  样式默认值（先于用户样式写入）
+ * @property {string[]} [styleConstAppend] 追加在用户样式之后的强制规则（Root 的尺寸兜底）
+ * @property {Function} [newTemplatePropsConst] 子模板顶层 const 属性改写
+ * @property {Function} [itemStyleConst] 子模板（_item）的 css 规则
+ * @property {boolean} [twoWayBinding] 是否需要 value 双向绑定事件
+ */
+export const ELEMENTS = {
+  Root: {
+    type: 'view',
+    styleConstAppend: [
+      // 注意：这 5 条在 Java 侧（RootTransfer）是硬编码字面量，冒号后**带空格**，
+      // 与 StyleConstTransformer 产出的 `key:value` 拼接口径不同 —— 平台产物天然混用两种写法。
+      // 这里照抄原文，否则生成的 index.css 与线上产物字节不一致、对拍必然报差异。
+      'width: 100%',
+      'flex-direction: column',
+      'color: #000000',
+      'font-size: 14px',
+      'line-height: 150%',
+    ],
+  },
+  Text: { type: 'text' },
+  MultiText: { type: 'multitext' },
+  Image: { type: 'image' },
+  Divider: { type: 'view' },
+  Input: { type: 'input', twoWayBinding: true },
+  Button: { type: 'button' },
+  Icon: { type: 'icon' },
+  Map: { type: 'map' },
+  Row: { type: 'view' },
+  Column: { type: 'view', styleDefault: { 'flex-direction': 'column' } },
+  SingleColumn: { type: 'view' },
+  MultiColumn: { type: 'view' },
+  ListLayout: {
+    type: 'grid',
+    isNewTemplate: true,
+    // 列表默认单列（平台侧同款：column 恒为 1）
+    newTemplatePropsConst: (props) => ({ ...props, column: 1 }),
+    itemStyleConst: (constProps) =>
+      constProps && constProps.direction === 'horizontal' ? ['width: auto'] : ['width: 100%'],
+  },
+  GridLayout: {
+    type: 'grid',
+    isNewTemplate: true,
+    itemStyleConst: () => ['width: 100%'],
+  },
+  AbsoluteLayout: { type: 'absolute' },
+  ScrollLayout: { type: 'scroll' },
+  Canvas: { type: 'canvas' },
+  CheckGroup: { type: 'checkgroup', twoWayBinding: true },
+  RadioButton: { type: 'radiobutton', twoWayBinding: true },
+  ProgressSlider: { type: 'progressslider', twoWayBinding: true },
+  Video: { type: 'video' },
+  ViewContainer: { type: 'viewcontainer' },
+}
+
+export function elementOf(className) {
+  return ELEMENTS[className] || { type: 'view', unknown: true }
+}
+
+/* ------------------------------ 静态样式 ------------------------------- */
+
+/**
+ * 样式分组 → CSS 规则数组（`prop:value`）
+ * @param {string} className 组件类型（决定是否有额外默认规则）
+ * @param {Object} props     样式 const 域（分组对象）
+ */
+export function styleConst(className, props = {}) {
+  const out = {}
+  const desc = elementOf(className)
+
+  // 组件级默认（如 Column 的纵向排列）
+  if (desc.styleDefault) Object.assign(out, desc.styleDefault)
+
+  // 平台默认：不放大、可压缩
+  out['flex-grow'] = '0'
+  out['flex-shrink'] = '1'
+
+  parseFont(props.font, out)
+  parseImage(props.image, out)
+  parsePosition(props.position, out)
+  parseRect(props.rect, out)
+  parseFlex(props.flex, out)
+  parseBackground(props.background, out)
+  parsePadding(props.padding, out)
+  parseMargin(props.margin, out)
+  parseBorderRadius(props.borderRadius, out)
+  parseBorder(props.border, out)
+  parseShadow(props.shadow, out)
+  parseTransform(props.transform, out)
+  parseOther(props.other, out)
+
+  const list = Object.entries(out).map(([k, v]) => `${k}:${v}`)
+  // 追加规则必须排在最后，才能覆盖上面按 schema 写出的同名声明
+  if (desc.styleConstAppend) list.push(...desc.styleConstAppend)
+  return list
+}
+
+function parseFont(p, out) {
+  if (!p) return
+  out.color = '#000'
+  out['font-size'] = doSize('14')
+  out['line-height'] = '150%'
+
+  if (hasText(p.color)) out.color = doColor(p.color)
+  if (hasText(p.fontSize)) out['font-size'] = doSize(p.fontSize)
+  if (hasText(p.lineHeight)) out['line-height'] = doSize(p.lineHeight)
+  if (hasText(p.textAlign)) out['text-align'] = p.textAlign
+  if (hasText(p.fontWeight)) out['font-weight'] = p.fontWeight
+  if (hasText(p.fontStyle)) out['font-style'] = p.fontStyle
+  if (hasText(p.textDecoration)) out['text-decoration'] = p.textDecoration
+  if (String(p.isMaxLine) === '1') {
+    out['max-lines'] = hasText(p.maxLine) ? p.maxLine : '1'
+    out['text-overflow'] = 'ellipsis'
+  }
+}
+
+function parseImage(p, out) {
+  if (!p) return
+  // 只有 Image 组件的 meta 会带 image 分组，这里保持平台侧「裁剪模式二选一」语义
+  if (p.cropMode === '01') {
+    out.mode = 'cover'
+    out['aspect-ratio'] = '1/1'
+  } else {
+    out.mode = 'contain'
+    out['aspect-ratio'] = '16/9'
+  }
+}
+
+function parsePosition(p, out) {
+  if (!p) return
+  for (const k of ['left', 'top', 'right', 'bottom']) {
+    if (hasText(p[k])) out[k] = doSize(p[k])
+  }
+}
+
+function parseRect(p, out) {
+  if (!p) return
+  const map = {
+    width: 'width',
+    height: 'height',
+    maxWidth: 'max-width',
+    maxHeight: 'max-height',
+    minWidth: 'min-width',
+    minHeight: 'min-height',
+  }
+  for (const [src, dest] of Object.entries(map)) {
+    if (hasText(p[src])) out[dest] = doSize(p[src])
+  }
+}
+
+function parseFlex(p, out) {
+  if (!p) return
+  if (hasText(p.flexDirection)) out['flex-direction'] = p.flexDirection
+  if (hasText(p.justifyContent)) out['justify-content'] = p.justifyContent
+  if (hasText(p.alignItems)) out['align-items'] = p.alignItems
+  if (hasText(p.flexWrap)) out['flex-wrap'] = p.flexWrap
+  if (hasText(p.flexShrink)) out['flex-shrink'] = p.flexShrink
+  if (hasText(p.gap)) out.gap = doSize(p.gap)
+}
+
+function parseBackground(p, out) {
+  if (!p) return
+  if (p.backgroundType === '01') {
+    if (hasText(p.backgroundColor)) out['background-color'] = p.backgroundColor
+  } else if (p.backgroundType === '02') {
+    if (hasText(p.backgroundImage)) out['background-image'] = `url('${p.backgroundImage}')`
+    out['background-size'] = hasText(p.backgroundSize) ? p.backgroundSize : 'cover'
+    out['background-position'] = hasText(p.backgroundPosition) ? p.backgroundPosition : '50% 50%'
+    out['background-repeat'] = hasText(p.backgroundRepeat) ? p.backgroundRepeat : 'no-repeat'
+  } else if (p.backgroundType === '03') {
+    if (hasText(p.backgroundGradient)) out['background-image'] = p.backgroundGradient
+  }
+}
+
+function parsePadding(p, out) {
+  if (!p) return
+  if (p.paddingType === '0') {
+    if (hasText(p.padding)) {
+      const v = doSize(p.padding)
+      out['padding-left'] = v
+      out['padding-top'] = v
+      out['padding-right'] = v
+      out['padding-bottom'] = v
+    }
+  } else if (p.paddingType === '1') {
+    for (const side of ['left', 'top', 'right', 'bottom']) {
+      const key = `padding${side[0].toUpperCase()}${side.slice(1)}`
+      if (hasText(p[key])) out[`padding-${side}`] = doSize(p[key])
+    }
+  }
+}
+
+function parseMargin(p, out) {
+  if (!p) return
+  if (p.marginType === '0') {
+    if (hasText(p.margin)) {
+      const v = doSize(p.margin)
+      out['margin-left'] = v
+      out['margin-top'] = v
+      out['margin-right'] = v
+      out['margin-bottom'] = v
+    }
+  } else if (p.marginType === '1') {
+    for (const side of ['left', 'top', 'right', 'bottom']) {
+      const key = `margin${side[0].toUpperCase()}${side.slice(1)}`
+      if (hasText(p[key])) out[`margin-${side}`] = doSize(p[key])
+    }
+  }
+}
+
+function parseBorderRadius(p, out) {
+  if (!p) return
+  if (p.borderRadiusType === '0') {
+    if (hasText(p.borderRadius)) out['border-radius'] = doSize(p.borderRadius)
+  } else if (p.borderRadiusType === '1') {
+    const map = {
+      borderTopLeftRadius: 'border-top-left-radius',
+      borderTopRightRadius: 'border-top-right-radius',
+      borderBottomRightRadius: 'border-bottom-right-radius',
+      borderBottomLeftRadius: 'border-bottom-left-radius',
+    }
+    for (const [src, dest] of Object.entries(map)) {
+      if (hasText(p[src])) out[dest] = doSize(p[src])
+    }
+  }
+}
+
+function parseBorder(p, out) {
+  if (!p) return
+  if (String(p.isBorder) !== '1') return
+  out['border-width'] = doSize(hasText(p.borderWidth) ? p.borderWidth : '1')
+  out['border-style'] = hasText(p.borderStyle) ? p.borderStyle : 'solid'
+  out['border-color'] = doColor(hasText(p.borderColor) ? p.borderColor : '#e7e7ee')
+}
+
+function parseShadow(p, out) {
+  if (!p) return
+  if (String(p.isShadow) !== '1') return
+  const parts = [doSize(hasText(p.shadowX) ? p.shadowX : '0'), doSize(hasText(p.shadowY) ? p.shadowY : '0')]
+  if (hasText(p.shadowBlur)) parts.push(doSize(p.shadowBlur))
+  if (hasText(p.shadowSpread)) parts.push(doSize(p.shadowSpread))
+  parts.push(doColor(hasText(p.shadowColor) ? p.shadowColor : '#e7e7ee'))
+  out['box-shadow'] = parts.join(' ')
+}
+
+function parseTransform(p, out) {
+  if (!p) return
+  if (hasText(p.rotate)) out.transform = `rotate(${p.rotate}deg)`
+}
+
+function parseOther(p, out) {
+  if (!p) return
+  if (hasText(p.overflow) && p.overflow !== 'hidden') out.overflow = p.overflow
+  if (hasText(p.opacity)) out.opacity = (Number(p.opacity) / 100).toFixed(2)
+}
+
+/* ------------------------------ 动态样式 ------------------------------- */
+
+/**
+ * 样式分组（动态域）→ databinding 的 `extend` 映射
+ * 与静态样式的差异：值本身已是表达式，不补 px、不填默认值；
+ * shadow / transform / position / opacity 平台侧不导出，这里保持一致。
+ */
+export function styleVar(props = {}) {
+  const out = {}
+  const font = props.font || {}
+  if (hasText(font.color)) out.color = raw(font.color)
+  if (hasText(font.fontSize)) out['font-size'] = raw(font.fontSize)
+  if (hasText(font.lineHeight)) out['line-height'] = raw(font.lineHeight)
+  if (hasText(font.textAlign)) out['text-align'] = raw(font.textAlign)
+  if (hasText(font.fontWeight)) out['font-weight'] = raw(font.fontWeight)
+  if (hasText(font.fontStyle)) out['font-style'] = raw(font.fontStyle)
+  if (hasText(font.textDecoration)) out['text-decoration'] = raw(font.textDecoration)
+  if (hasText(font.maxLine)) out['max-lines'] = raw(font.maxLine)
+
+  const rect = props.rect || {}
+  const rectMap = {
+    width: 'width',
+    height: 'height',
+    maxWidth: 'max-width',
+    maxHeight: 'max-height',
+    minWidth: 'min-width',
+    minHeight: 'min-height',
+  }
+  for (const [src, dest] of Object.entries(rectMap)) {
+    if (hasText(rect[src])) out[dest] = raw(rect[src])
+  }
+
+  const flex = props.flex || {}
+  if (hasText(flex.flexDirection)) out['flex-direction'] = raw(flex.flexDirection)
+  if (hasText(flex.justifyContent)) out['justify-content'] = raw(flex.justifyContent)
+  if (hasText(flex.alignItems)) out['align-items'] = raw(flex.alignItems)
+  if (hasText(flex.flexWrap)) out['flex-wrap'] = raw(flex.flexWrap)
+  if (hasText(flex.gap)) out.gap = raw(flex.gap)
+
+  const bg = props.background || {}
+  if (hasText(bg.backgroundColor)) out['background-color'] = raw(bg.backgroundColor)
+  if (hasText(bg.backgroundImage)) out['background-image'] = `'url('+(${bg.backgroundImage})+')'`
+  if (hasText(bg.backgroundSize)) out['background-size'] = raw(bg.backgroundSize)
+  if (hasText(bg.backgroundPosition)) out['background-position'] = raw(bg.backgroundPosition)
+  if (hasText(bg.backgroundRepeat)) out['background-repeat'] = raw(bg.backgroundRepeat)
+  if (!hasText(bg.backgroundImage) && hasText(bg.backgroundGradient)) {
+    out['background-image'] = raw(bg.backgroundGradient)
+  }
+
+  const padding = props.padding || {}
+  if (hasText(padding.padding)) out.padding = raw(padding.padding)
+  for (const side of ['left', 'top', 'right', 'bottom']) {
+    const key = `padding${side[0].toUpperCase()}${side.slice(1)}`
+    if (hasText(padding[key])) out[`padding-${side}`] = raw(padding[key])
+  }
+
+  const margin = props.margin || {}
+  if (hasText(margin.margin)) out.margin = raw(margin.margin)
+  for (const side of ['left', 'top', 'right', 'bottom']) {
+    const key = `margin${side[0].toUpperCase()}${side.slice(1)}`
+    if (hasText(margin[key])) out[`margin-${side}`] = raw(margin[key])
+  }
+
+  const radius = props.borderRadius || {}
+  if (hasText(radius.borderRadius)) out['border-radius'] = raw(radius.borderRadius)
+  for (const corner of ['TopLeft', 'TopRight', 'BottomRight', 'BottomLeft']) {
+    const key = `border${corner}Radius`
+    if (hasText(radius[key])) {
+      out[`border-${corner.replace(/([A-Z])/g, '-$1').toLowerCase()}-radius`] = raw(radius[key])
+    }
+  }
+
+  const border = props.border || {}
+  if (hasText(border.borderWidth)) out['border-width'] = raw(border.borderWidth)
+  if (hasText(border.borderStyle)) out['border-style'] = raw(border.borderStyle)
+  if (hasText(border.borderColor)) out['border-color'] = raw(border.borderColor)
+
+  return out
+}

package/dist/vendored/server/core/flameCompile/common.js

@@ -0,0 +1,253 @@
+/**
+ * 编译公共层：属性摊平、表达式改写、条件表达式
+ *
+ * 1:1 迁移自 flame-release-mange（Java）：
+ *   client/convert/PropertyConvert   → convertPropsClient
+ *   h5/convert/PropertyConvert       → convertPropsH5（直接产出 JS 字面量）
+ *   h5/convert/ExpressionConvert     → convertExpression
+ *   client/convert/ConditionConvert  → convertCondition
+ *
+ * 三者的分工是平台侧的既定契约，不要"优化"：
+ *   - 客户端（GaiaX）走 `{const, var}` 双域：const 进 css / index.data，var 进 index.databinding；
+ *   - H5 走单域 JS 字面量，动态属性在生成代码里拼 `s.$xxx`（s = 卡片上下文 state）。
+ */
+
+/** Java StringUtils.hasText 等价 */
+export function hasText(v) {
+  return typeof v === 'string' ? v.trim().length > 0 : v !== undefined && v !== null && String(v).trim().length > 0
+}
+
+/** 资源地址替换（平台侧当前为恒等，保留钩子便于对接 CDN 前缀） */
+export function replaceUrl(url) {
+  return url
+}
+
+/* --------------------------- 客户端：const/var 双域 -------------------------- */
+
+/**
+ * 属性集 → `{ const, var }`
+ * 静态属性进 const（并对动态属性补 itemDefaultValue 作为兜底），动态属性进 var，
+ * 资源地址按静态处理（Java 侧同款）。
+ */
+export function convertPropsClient(properties = []) {
+  const constProps = {}
+  const varProps = {}
+
+  const walk = (props, constOut, varOut) => {
+    for (const prop of props) {
+      const key = prop.itemKey
+      if (!hasText(key)) continue
+      // 缺省按静态处理：平台产出的 schema 一定带 itemValueFrom，
+      // 但手工编辑 / AI 生成的数据可能省略该字段，缺省兜底比丢属性安全。
+      const from = prop.itemValueFrom || '0'
+
+      if (from === '0') {
+        if (prop.children && prop.children.length > 0) {
+          const groupConst = {}
+          const groupVar = {}
+          walk(prop.children, groupConst, groupVar)
+          constOut[key] = groupConst
+          varOut[key] = groupVar
+        } else if (prop.list && prop.list.length > 0) {
+          const listConst = []
+          const listVar = []
+          for (const group of prop.list) {
+            const groupConst = {}
+            const groupVar = {}
+            walk(group, groupConst, groupVar)
+            listConst.push(groupConst)
+            listVar.push(groupVar)
+          }
+          constOut[key] = listConst
+          varOut[key] = listVar
+        } else {
+          constOut[key] = prop.itemValue
+        }
+      } else if (from === '1') {
+        // 动态属性：const 用默认值兜底，var 存表达式
+        constOut[key] = prop.itemDefaultValue
+        varOut[key] = prop.itemValue
+      } else if (from === '2') {
+        constOut[key] = replaceUrl(prop.itemValue)
+      }
+    }
+  }
+
+  walk(properties, constProps, varProps)
+  return { const: constProps, var: varProps }
+}
+
+/** 取动态属性（表达式）映射，供双向绑定事件生成 */
+export function pickVarProps(properties = []) {
+  const out = {}
+  for (const p of properties) {
+    if (p.itemValueFrom === '1' && hasText(p.itemValue)) out[p.itemKey] = p.itemValue
+  }
+  return out
+}
+
+/**
+ * 属性集 → 普通对象（平台 `PropertyConvert.convertProps(List)` 的口径）
+ *
+ * 与 `convertPropsClient` 的区别：动态属性的值**原样保留**（`$keyword` 就是 `$keyword`），
+ * 不换成默认值、也不改写成 `s.$keyword`。H5 的 JSAPI 事件参数走这条路 ——
+ * 平台侧把它交给 JSON 序列化，于是 `$x` 落进 JSON 字符串里由宿主解析，
+ * 若在这里提前改写，参数就从「宿主可识别的占位」变成了「本地变量引用」，行为与线上不同。
+ */
+export function collectProps(properties = []) {
+  const out = {}
+  for (const prop of properties) {
+    if (!hasText(prop.itemKey)) continue
+    const from = prop.itemValueFrom || '0'
+    if (from === '0') {
+      if (prop.children && prop.children.length > 0) out[prop.itemKey] = collectProps(prop.children)
+      else if (prop.list && prop.list.length > 0) out[prop.itemKey] = prop.list.map((g) => collectProps(g))
+      else out[prop.itemKey] = prop.itemValue
+    } else if (from === '1') {
+      out[prop.itemKey] = prop.itemValue
+    } else if (from === '2') {
+      out[prop.itemKey] = replaceUrl(prop.itemValue)
+    }
+  }
+  return out
+}
+
+/* ----------------------------- H5：JS 字面量 ----------------------------- */
+
+const IDENT_RE = /^[A-Za-z0-9_$]+$/
+
+/**
+ * JS 对象字面量的键名写法（平台口径）
+ *
+ * Java 侧 `PropertyConvert.convertProps` 的规则是：键名匹配 `^[a-zA-Z0-9_$]+$` 就裸写，
+ * 不匹配才走 `JSONObject.toJSONString` 加引号。H5 产物的 style / 事件名 / 插槽名都吃这条规则，
+ * 所以统一收敛到这一个函数，避免各处口径漂移。
+ */
+export function jsKey(key) {
+  return IDENT_RE.test(key) ? key : JSON.stringify(key)
+}
+
+/**
+ * 属性集 → JS 对象字面量源码（不含外层花括号以外的东西，返回 `{...}`）
+ * 注意：静态值一律 JSON.stringify（与 Java 侧 fastjson 口径一致）。
+ */
+export function convertPropsH5(properties = []) {
+  const parts = []
+  for (const prop of properties) {
+    if (!hasText(prop.itemKey)) continue
+    const key = IDENT_RE.test(prop.itemKey) ? prop.itemKey : JSON.stringify(prop.itemKey)
+    const from = prop.itemValueFrom || '0'
+
+    if (from === '0') {
+      if (prop.children && prop.children.length > 0) {
+        parts.push(`${key}:${convertPropsH5(prop.children)}`)
+      } else if (prop.list && prop.list.length > 0) {
+        const groups = prop.list.map((g) => convertPropsH5(g))
+        parts.push(`${key}:[${groups.join(',')}]`)
+      } else {
+        parts.push(`${key}:${JSON.stringify(prop.itemValue)}`)
+      }
+    } else if (from === '1') {
+      if (hasText(prop.itemValue)) parts.push(`${key}:${convertExpression(prop.itemValue)}`)
+    } else if (from === '2') {
+      parts.push(`${key}:${JSON.stringify(replaceUrl(prop.itemValue))}`)
+    }
+  }
+  return `{${parts.join(',')}}`
+}
+
+/* ------------------------------ 表达式改写 ------------------------------ */
+
+/**
+ * `$foo` → `s.$foo`
+ *
+ * 平台卡片状态挂在上下文实例的 `state` 上（生成代码里 `var s = c.state`），
+ * 所以表达式里的 `$x` 必须改写为 `s.$x`。
+ * 字符串字面量（'…' / "…" / `…`）内部的 `$` 不得改写。
+ *
+ * 关于 `$$`：Java 版原实现只判断「前一个字符是否为 $」，导致 `$$` 被改写成 `s.$$`
+ * （首字符仍被替换，与其注释意图不符）。这里按意图修正为**整体保留** ——
+ * `$$` 是平台表达式的内建变量（列表项数据入口），加 `s.` 前缀必然取不到值。
+ */
+export function convertExpression(expression) {
+  const text = String(expression ?? '')
+  // 先标出所有字符串字面量覆盖的下标
+  const stringRanges = new Set()
+  const re = /(['"`])(?:\\.|(?!\1).)*?\1/g
+  let m
+  while ((m = re.exec(text)) !== null) {
+    for (let i = m.index; i < m.index + m[0].length; i++) stringRanges.add(i)
+  }
+
+  let out = ''
+  for (let i = 0; i < text.length; i++) {
+    const c = text[i]
+    if (stringRanges.has(i)) {
+      out += c
+      continue
+    }
+    if (c === '$') {
+      // `$$` 内建变量整体保留
+      if (text[i + 1] === '$') {
+        out += '$$'
+        i += 1
+        continue
+      }
+      out += 's.$'
+      continue
+    }
+    out += c
+  }
+  return out
+}
+
+/* ------------------------------ 条件表达式 ------------------------------ */
+
+/**
+ * 结构化条件（v-show 的 condition.group）→ 布尔表达式
+ * 节点形态：`{ logic:'&&'|'||', group:[...] }` 或 `{ logic, condition:{ val1Type,val1Value,operator,val2Type,val2Value } }`
+ * val1Type/val2Type：'1' 表示表达式（原样输出），其它表示字面量（JSON 编码）。
+ */
+export function convertCondition(group) {
+  const parts = []
+  collectGroup(group, parts)
+  return parts.join('')
+}
+
+function collectGroup(group, parts) {
+  if (!Array.isArray(group) || group.length === 0) return
+  const wrapped = group.length > 1
+  if (wrapped) parts.push('(')
+  group.forEach((item, index) => {
+    if (index > 0 && hasText(item.logic)) parts.push(item.logic)
+    if (Array.isArray(item.group)) collectGroup(item.group, parts)
+    else if (item.condition) collectCondition(item.condition, parts)
+  })
+  if (wrapped) parts.push(')')
+}
+
+function collectCondition(condition, parts) {
+  const left = condition.val1Type === '1' ? condition.val1Value : JSON.stringify(condition.val1Value)
+  const right = condition.val2Type === '1' ? condition.val2Value : JSON.stringify(condition.val2Value)
+  parts.push('(')
+  switch (condition.operator) {
+    case '==':
+    case '!=':
+    case '<':
+    case '>':
+    case '<=':
+    case '>=':
+      parts.push(`${left}${condition.operator}${right}`)
+      break
+    case 'blank':
+      parts.push(`!${left}`)
+      break
+    case 'notblank':
+      parts.push(`!!${left}`)
+      break
+    default:
+      // 平台侧同款兜底：未知算子恒真，避免整块被吞掉
+      parts.push('1 == 1')
+  }
+  parts.push(')')
+}