@dckj-npm/dc-material 0.1.372 → 0.1.374

package/lowcode/teletext-list/meta.ts

@@ -27,25 +27,6 @@ const parsePxNumber = (value: any): number | undefined => {
   return undefined
 }
 
-const getSchemaChildren = (target: any): any[] => {
-  const nodeSchema = target?.node?.schema
-  return Array.isArray(nodeSchema?.children) ? nodeSchema.children : []
-}
-
-const findImageChildSchema = (target: any): any | undefined => {
-  const schemaChildren = getSchemaChildren(target)
-  return schemaChildren.find((child: any) => {
-    const keyFromProps = normalizeNodeKey(child?.props?.key)
-    const keyFromNode = normalizeNodeKey(child?.key)
-    return keyFromProps === IMAGE_KEY || keyFromNode === IMAGE_KEY
-  })
-}
-
-/**
- * 通过引擎的 IPublicModelNode API 查找 key='image' 的子节点。
- * 相比直接读 node.schema.children，这里使用的是引擎可感知的公共 API，
- * 保证后续 setPropValue/getPropValue 操作能被引擎正确追踪（触发响应式更新）。
- */
 const findImageChildNode = (target: any): any | undefined => {
   const children = target?.node?.children
   if (!children) return undefined
@@ -58,118 +39,34 @@ const findImageChildNode = (target: any): any | undefined => {
 }
 
 const getImageStyleNumber = (target: any, styleKey: 'width' | 'height'): number | undefined => {
-  // 优先通过引擎 API 读取，保证与 syncImageStyleValue 写入来源一致
   const imageChildNode = findImageChildNode(target)
   if (imageChildNode) {
     return parsePxNumber(imageChildNode.getPropValue?.('style')?.[styleKey])
   }
-  // 降级：从 schema 快照读取
-  const imageChildSchema = findImageChildSchema(target)
-  return parsePxNumber(imageChildSchema?.props?.style?.[styleKey])
+  return undefined
 }
 
 /**
- * 异步写入 Image 子节点的 style，避免在 imgWidth/imgHeight.setValue 的同步执行栈内
- * 触发引擎重评估 dataList.initialValue（会先清空 dataList prop，导致默认图覆盖绑定数据）。
- * 通过 Promise.resolve().then() 将写入推迟到当前 settings 重评估完成后执行，
- * 此时 dataList 已稳定为正确的 JSExpression，重评估无副作用。
+ * 同步 Image 子节点的 style.width / style.height。
+ * 使用 Promise.resolve().then() 异步执行，避免在父节点 setPropValue
+ * 的 MobX 同步响应链中触发子节点变更（可能导致 SettingField 重建）。
  */
 const syncImageStyleValue = (target: any, styleKey: 'width' | 'height', value: number): void => {
   Promise.resolve().then(() => {
-    // 优先通过引擎节点 API 更新子节点 style，确保引擎感知变化（布局面板读取时可见）
     const imageChildNode = findImageChildNode(target)
-    if (imageChildNode) {
-      const currentStyle = imageChildNode.getPropValue?.('style') || {}
-      // 同时确保 width/height 都存在于子节点 style 中，防止布局面板 replace 时丢失其中一个
-      const updatedStyle: Record<string, any> = { ...currentStyle, [styleKey]: `${value}px` }
-      // 如果另一轴尺寸在子节点 style 中不存在，则从父级 prop 补充，保证两轴都写入
-      const otherKey = styleKey === 'width' ? 'height' : 'width'
-      if (!updatedStyle[otherKey]) {
-        const otherPropKey = otherKey === 'width' ? 'imgWidth' : 'imgHeight'
-        const otherPropValue = parsePxNumber(target?.getProps?.()?.getPropValue?.(otherPropKey))
-        if (otherPropValue !== undefined) {
-          updatedStyle[otherKey] = `${otherPropValue}px`
-        } else {
-          // 子节点 style 也没有，使用默认值 100
-          updatedStyle[otherKey] = '100px'
-        }
-      }
-      imageChildNode.setPropValue?.('style', updatedStyle)
-      return
-    }
-    // 降级：直接写 schema（引擎无法感知，但保留作为兜底）
-    const imageChildSchema = findImageChildSchema(target)
-    if (!imageChildSchema) {
-      return
-    }
-    if (!imageChildSchema.props) {
-      imageChildSchema.props = {}
-    }
-    const currentStyle = imageChildSchema.props.style || {}
-    imageChildSchema.props.style = {
-      ...currentStyle,
-      [styleKey]: `${value}px`,
+    if (!imageChildNode) return
+    const currentStyle = imageChildNode.getPropValue?.('style') || {}
+    const updatedStyle: Record<string, any> = { ...currentStyle, [styleKey]: `${value}px` }
+    const otherKey = styleKey === 'width' ? 'height' : 'width'
+    if (!updatedStyle[otherKey]) {
+      const otherPropKey = otherKey === 'width' ? 'imgWidth' : 'imgHeight'
+      const otherPropValue = parsePxNumber(target?.getProps?.()?.getPropValue?.(otherPropKey))
+      updatedStyle[otherKey] = `${otherPropValue ?? 100}px`
     }
+    imageChildNode.setPropValue?.('style', updatedStyle)
   })
 }
 
-const syncImageDimensionPropsFromChild = (target: any) => {
-  const widthFromChild = getImageStyleNumber(target, 'width')
-  const heightFromChild = getImageStyleNumber(target, 'height')
-  const propsApi = target?.getProps?.()
-
-  if (propsApi && widthFromChild !== undefined) {
-    const currentWidth = parsePxNumber(propsApi.getPropValue?.('imgWidth'))
-    if (currentWidth !== widthFromChild) {
-      propsApi.setPropValue('imgWidth', widthFromChild)
-    }
-  }
-
-  if (propsApi && heightFromChild !== undefined) {
-    const currentHeight = parsePxNumber(propsApi.getPropValue?.('imgHeight'))
-    if (currentHeight !== heightFromChild) {
-      propsApi.setPropValue('imgHeight', heightFromChild)
-    }
-  }
-}
-
-const isDataListBoundExpression = (target: any): boolean => {
-  const dataListValue = target?.getProps?.()?.getPropValue?.('dataList')
-  return !!(
-    dataListValue &&
-    typeof dataListValue === 'object' &&
-    (dataListValue as any).type === 'JSExpression'
-  )
-}
-
-/**
- * 模块级 WeakMap 缓存：以 IPublicModelNode 对象引用为 key，存储每个 TeletextList 节点
- * 最后一次已知的「非默认」dataList 值。
- *
- * 作用：在 setPropValue 触发的 settings 重评估中，引擎可能先将 node prop 清空再调用
- * dataList.initialValue；此时 node.getPropValue 与 getProps().getPropValue 均返回
- * undefined，导致 initialValue 回退默认数组、覆盖已绑定的 JSExpression 或用户数据。
- * 通过在每次 imgWidth/imgHeight/imagePlacement.setValue 执行任何 setPropValue 之前
- * 将当前 dataList 写入此缓存，initialValue 可从缓存安全恢复，彻底切断引擎中间态影响。
- */
-const _nodeDataListCache = new WeakMap<object, any>()
-
-const _cacheDataList = (target: any): void => {
-  const node = target?.node
-  if (!node) return
-  // 优先从 node 级 API 读取（schema 层，不受 settings 重评估中间态影响）
-  const fromNode = node?.getPropValue?.('dataList')
-  if (fromNode !== undefined) {
-    _nodeDataListCache.set(node, fromNode)
-    return
-  }
-  // 降级：从 settings API 读取
-  const fromProps = target?.getProps?.()?.getPropValue?.('dataList')
-  if (fromProps !== undefined) {
-    _nodeDataListCache.set(node, fromProps)
-  }
-}
-
 const TeletextListMeta: IPublicTypeComponentMetadata = {
   group: '低代码组件',
   componentName: 'TeletextList',
@@ -294,27 +191,8 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
           initialValue: 'left',
         },
         extraProps: {
-          setValue: (target, value) => {
-            const props = target.getProps()
-            // 在任何 setPropValue 之前先写入模块级缓存，确保 dataList.initialValue
-            // 重评估时即使 engine 已清空 node prop 也能从缓存恢复正确值
-            _cacheDataList(target)
-            // 显式快照需要保护的配置，防止引擎某些实现在写入时触发重初始化导致配置丢失
-            const prevDataList = props.getPropValue('dataList')
-            const prevDataListBind = props.getPropValue('dataListBind')
-            const prevTextImgGap = props.getPropValue('textImgGap')
-            const prevImgWidth = props.getPropValue('imgWidth')
-            const prevImgHeight = props.getPropValue('imgHeight')
-            props.setPropValue('imagePlacement', value)
-            // 写回被保护的配置（幂等操作，若引擎未重置则无副作用）
-            if (prevDataList !== undefined) props.setPropValue('dataList', prevDataList)
-            if (prevDataListBind !== undefined) props.setPropValue('dataListBind', prevDataListBind)
-            if (prevTextImgGap !== undefined) props.setPropValue('textImgGap', prevTextImgGap)
-            if (prevImgWidth !== undefined) props.setPropValue('imgWidth', prevImgWidth)
-            if (prevImgHeight !== undefined) props.setPropValue('imgHeight', prevImgHeight)
-            // 切换图片布局时同步一次子图片尺寸，避免面板回退到默认值
-            syncImageDimensionPropsFromChild(target)
-          },
+          // 引擎已自动 setPropValue('imagePlacement', value)，无需再做任何额外写入
+          // 之前的快照-还原逻辑反而触发多余的 MobX 响应链，导致 dataList 被覆盖
         },
       },
       {
@@ -324,60 +202,22 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
         setter: {
           componentName: 'NumberSetter',
           isRequired: false,
-          initialValue: (target) => {
-            const styleWidth = getImageStyleNumber(target, 'width')
-            if (styleWidth !== undefined) {
-              return styleWidth
-            }
-            const propValue = target?.getProps()?.getPropValue?.('imgWidth')
-            const parsedPropValue = parsePxNumber(propValue)
-            if (parsedPropValue !== undefined) return parsedPropValue
-            // 数据源已绑定时，避免回退为 100 触发误写回
-            if (isDataListBoundExpression(target)) {
-              return undefined
-            }
-            return 100
-          },
-          defaultValue: (target) => {
-            const styleWidth = getImageStyleNumber(target, 'width')
-            if (styleWidth !== undefined) {
-              return styleWidth
-            }
-            const propValue = target?.getProps()?.getPropValue?.('imgWidth')
-            const parsedPropValue = parsePxNumber(propValue)
-            if (parsedPropValue !== undefined) return parsedPropValue
-            if (isDataListBoundExpression(target)) {
-              return undefined
-            }
-            return 100
-          },
+          initialValue: 100,
         },
         extraProps: {
-          getValue: (target) => {
-            // getValue 纯读操作，不做任何写入，避免触发引擎重评估其他 setter 的 initialValue
-            // （写操作会导致引擎重初始化 dataList 等 prop，画布图片回退到默认图）
+          getValue: (target, value) => {
+            if (value !== undefined) return parsePxNumber(value) ?? 100
             const styleWidth = getImageStyleNumber(target, 'width')
-            if (styleWidth !== undefined) {
-              return styleWidth
-            }
-            const propValue = target?.getProps()?.getPropValue?.('imgWidth')
-            const parsedPropValue = parsePxNumber(propValue)
-            if (parsedPropValue !== undefined) {
-              return parsedPropValue
-            }
+            if (styleWidth !== undefined) return styleWidth
             return 100
           },
           setValue: (target, value) => {
+            // 引擎已自动 setPropValue('imgWidth', value)
+            // 只需同步到 Image 子节点的 style
             const parsedValue = parsePxNumber(value)
-            if (parsedValue === undefined) {
-              return
+            if (parsedValue !== undefined) {
+              syncImageStyleValue(target, 'width', parsedValue)
             }
-            const props = target.getProps()
-            // 在写入前先更新模块级缓存，确保async syncImageStyleValue触发的重评估时缓存有效
-            _cacheDataList(target)
-            props.setPropValue('imgWidth', parsedValue)
-            // syncImageStyleValue 异步执行，不在当前同步栈内触发 dataList.initialValue 重评估
-            syncImageStyleValue(target, 'width', parsedValue)
           },
         },
       },
@@ -388,59 +228,22 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
         setter: {
           componentName: 'NumberSetter',
           isRequired: false,
-          initialValue: (target) => {
-            const styleHeight = getImageStyleNumber(target, 'height')
-            if (styleHeight !== undefined) {
-              return styleHeight
-            }
-            const propValue = target?.getProps()?.getPropValue?.('imgHeight')
-            const parsedPropValue = parsePxNumber(propValue)
-            if (parsedPropValue !== undefined) return parsedPropValue
-            // 数据源已绑定时，避免回退为 100 触发误写回
-            if (isDataListBoundExpression(target)) {
-              return undefined
-            }
-            return 100
-          },
-          defaultValue: (target) => {
-            const styleHeight = getImageStyleNumber(target, 'height')
-            if (styleHeight !== undefined) {
-              return styleHeight
-            }
-            const propValue = target?.getProps()?.getPropValue?.('imgHeight')
-            const parsedPropValue = parsePxNumber(propValue)
-            if (parsedPropValue !== undefined) return parsedPropValue
-            if (isDataListBoundExpression(target)) {
-              return undefined
-            }
-            return 100
-          },
+          initialValue: 100,
         },
         extraProps: {
-          getValue: (target) => {
-            // getValue 纯读操作，不做任何写入，避免触发引擎重评估其他 setter 的 initialValue
+          getValue: (target, value) => {
+            if (value !== undefined) return parsePxNumber(value) ?? 100
             const styleHeight = getImageStyleNumber(target, 'height')
-            if (styleHeight !== undefined) {
-              return styleHeight
-            }
-            const propValue = target?.getProps()?.getPropValue?.('imgHeight')
-            const parsedPropValue = parsePxNumber(propValue)
-            if (parsedPropValue !== undefined) {
-              return parsedPropValue
-            }
+            if (styleHeight !== undefined) return styleHeight
             return 100
           },
           setValue: (target, value) => {
+            // 引擎已自动 setPropValue('imgHeight', value)
+            // 只需同步到 Image 子节点的 style
             const parsedValue = parsePxNumber(value)
-            if (parsedValue === undefined) {
-              return
+            if (parsedValue !== undefined) {
+              syncImageStyleValue(target, 'height', parsedValue)
             }
-            const props = target.getProps()
-            // 在写入前先更新模块级缓存，确保async syncImageStyleValue触发的重评估时缓存有效
-            _cacheDataList(target)
-            props.setPropValue('imgHeight', parsedValue)
-            // syncImageStyleValue 异步执行，不在当前同步栈内触发 dataList.initialValue 重评估
-            syncImageStyleValue(target, 'height', parsedValue)
           },
         },
       },
@@ -952,112 +755,32 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
             },
           },
           initialValue: (target) => {
-            // 读取顺序（由最可靠到最不可靠）：
-            // 1. node 级 API（schema 层，引擎重评估前通常仍有值）
-            // 2. 模块级 WeakMap 缓存（在任何 setPropValue 之前写入，完全不受引擎清空影响）
-            // 3. settings API（重评估中间态下可能已清空，作为最后手段）
-            // 4. 默认占位数据（仅首次创建组件时触达）
-            //
-            // 关键防御：一旦组件已绑定数据源（缓存或 node 中有值），
-            // 无论是哪种场景的 initialValue 调用，都必须返回已有值而不是默认数组。
-            // syncImageStyleValue 改为异步后，通常 node.getPropValue 已能拿到正确值；
-            // 缓存作为最后一道防线，彻底切断默认数组覆盖绑定表达式的可能。
-            const node = target?.node
-            // 优先读缓存：即使 node.getPropValue 暂时处于中间态，缓存也能提供可靠值
-            const cached = node ? _nodeDataListCache.get(node) : undefined
-            const fromNode = node?.getPropValue?.('dataList')
-            if (fromNode !== undefined) {
-              // 同步更新缓存，为后续可能的重评估提供后备
-              if (node) _nodeDataListCache.set(node, fromNode)
-              return fromNode
-            }
-            // node.getPropValue 返回 undefined：引擎可能已在调用 initialValue 前清空 node prop
-            // → 读取模块级缓存（在 setValue 中任何 setPropValue 之前写入，最可靠的后备）
-            if (cached !== undefined) {
-              return cached
-            }
-            const current = target?.getProps?.()?.getPropValue?.('dataList')
-            if (current !== undefined) {
-              if (node) _nodeDataListCache.set(node, current)
-              return current
-            }
-            return [
-              {
-                image: 'https://img.alicdn.com/tps/TB16TQvOXXXXXbiaFXXXXXXXXXX-120-120.svg',
-                title: '标题名称',
-                description:
-                  '说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字',
-              },
-              {
-                image: 'https://img.alicdn.com/tps/TB16TQvOXXXXXbiaFXXXXXXXXXX-120-120.svg',
-                title: '标题名称',
-                description:
-                  '说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字',
-                tags: [
-                  {
-                    name: '报名火热',
-                    color: 'orange',
-                  },
-                  {
-                    name: '人数众多',
-                    color: 'blue',
-                  },
-                ],
-              },
-            ]
+            // ignoreDefaultValue: () => true 保证此函数在 SettingFieldView remount 时
+            // 永远不会被 initDefaultValue 调用，仅作为安全兜底保留。
+            // 正常的首次创建数据由 snippet.props.dataList 提供。
+            const existing = target?.node?.schema?.props?.dataList
+              ?? target?.getProps?.()?.getPropValue?.('dataList')
+            if (existing !== undefined) return existing
+            return DEFAULT_DATA_LIST
           },
         },
         extraProps: {
           /**
-           * 自定义 getValue：保证引擎重评估期间 field.getValue() 始终返回有效值（非 undefined），
-           * 从而阻止 initDefaultValue 在不应该的时机调用 initialValue 并覆盖为默认图数组。
+           * ignoreDefaultValue: 彻底阻止引擎在 SettingFieldView remount 时
+           * 调用 initDefaultValue → 把 initialValue（默认数据数组）通过 field.setValue
+           * 写入 dataList prop，覆盖已绑定的 JSExpression。
            *
-           * 触发场景：修改 imgWidth/imgHeight 或通过布局面板修改图片 margin 时，
-           * imageChildNode.setPropValue('style', ...) 会触发引擎对父节点 settings 的重评估；
-           * 若此时 dataList Prop 处于 "unset" 中间态，parent.getPropValue 会返回 undefined，
-           * 导致不带 getValue 时 field.getValue() = undefined → initDefaultValue 触发 → 默认图。
-           * 有了此 getValue 后，即使 schema 层暂时返回 undefined，从缓存取值仍可返回用户数据，
-           * field.getValue() 非 undefined → initDefaultValue 永远跳过 → 默认图问题彻底消失。
+           * 这是根本性解决方案：在引擎层面阻断 initDefaultValue 的执行，
+           * 而不是试图在 initialValue/getValue/setValue 中做缓存和还原来补救。
            */
+          ignoreDefaultValue: () => true,
           getValue: (target: any, currentValue: any) => {
-            const node = target?.node
-            if (currentValue !== undefined) {
-              // schema 层有值：同步更新缓存，确保用户最新编辑的数据被记录
-              if (node) _nodeDataListCache.set(node, currentValue)
-              return currentValue
-            }
-            // schema 层暂时无值（引擎重评估中间态）：从缓存恢复，避免 initDefaultValue 触发
-            const cached = node ? _nodeDataListCache.get(node) : undefined
-            return cached // undefined 仅在缓存为空（全新组件首次初始化）时出现，属正常情况
-          },
-          /**
-           * 自定义 setValue：用户每次编辑 dataList 条目时，先更新 WeakMap 缓存，
-           * 再通过 node.setPropValue 将值持久化到 schema。
-           *
-           * ⚠️ 此引擎中 extraProps.setValue 完全接管写入逻辑，引擎不会自动持久化：
-           * 若不在此处显式调用 setPropValue，用户编辑的数据将只存于内存缓存，
-           * 页面刷新后丢失，同时 imgWidth/imgHeight.setValue 的快照–还原机制也因
-           * props.getPropValue('dataList') 返回 undefined 而失效，导致还原跳过，
-           * 进而触发引擎 initDefaultValue，画布回退默认图。
-           *
-           * 写入顺序：先缓存（供 initialValue/getValue 兜底），再写 schema（持久化）。
-           * 写入 schema 会触发引擎对 settings 的重评估，但此时 schema 已有值，
-           * initialValue 不会被调用，不会产生循环。
-           */
-          setValue: (target: any, value: any) => {
-            const node = target?.node
-            if (!node) return
-            if (value !== undefined) {
-              // 先写缓存，确保重评估期间 getValue 可从缓存返回有效值
-              _nodeDataListCache.set(node, value)
-              // 再持久化到 schema（引擎不会自动写入，必须显式调用）
-              target.getProps?.()?.setPropValue?.('dataList', value)
-            } else {
-              // clearValue 场景（value = undefined）：清空缓存，使下次 initDefaultValue
-              // 可正常返回默认数组（仅用于组件被显式清除数据的情况）
-              _nodeDataListCache.delete(node)
-              target.getProps?.()?.setPropValue?.('dataList', undefined)
-            }
+            // currentValue 已有值时直接返回
+            if (currentValue !== undefined) return currentValue
+            // 从 schema 快照兜底读取（最可靠的源头数据，始终反映持久化状态）
+            const fromSchema = target?.node?.schema?.props?.dataList
+            if (fromSchema !== undefined) return fromSchema
+            return undefined
           },
         },
       },
@@ -1081,13 +804,34 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
   },
 }
 
+const DEFAULT_DATA_LIST = [
+  {
+    image: 'https://img.alicdn.com/tps/TB16TQvOXXXXXbiaFXXXXXXXXXX-120-120.svg',
+    title: '标题名称',
+    description:
+      '说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字',
+  },
+  {
+    image: 'https://img.alicdn.com/tps/TB16TQvOXXXXXbiaFXXXXXXXXXX-120-120.svg',
+    title: '标题名称',
+    description:
+      '说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字说明文字',
+  },
+]
+
 const getSnippets = (textLines = 2): IPublicTypeSnippet[] => [
   {
     title: '图文列表',
     screenshot: '',
     schema: {
       componentName: 'TeletextList',
-      props: {},
+      props: {
+        // 将默认数据放到 snippet props 中，而非依赖 setter.initialValue。
+        // 因为 dataList 使用了 ignoreDefaultValue:()=>true 来阻止引擎在
+        // SettingFieldView remount 时覆盖已绑定的 JSExpression，
+        // 所以 initDefaultValue 永远不会运行，首次拖入的初始数据必须由 snippet 提供。
+        dataList: DEFAULT_DATA_LIST,
+      },
       children: [
         {
           componentName: 'NextText',

package/lowcode_es/meta.js

@@ -117,7 +117,7 @@ function fillRealVersion(meta, packageName, version, basicLibraryVersion) {
     packageName = '@dckj-npm/dc-material';
   }
   if (version === void 0) {
-    version = '0.1.372';
+    version = '0.1.374';
   }
   if (basicLibraryVersion === void 0) {
     basicLibraryVersion = {