@dckj-npm/dc-material 0.1.373 → 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'
-  )
-}
-
-/**
- * 模块级缓存：使用 node.id（稳定的字符串 ID）作为 key。
- * 替代 WeakMap 方案：WeakMap 以 target.node 对象引用为 key，
- * 但引擎可能通过 Proxy/getter 每次返回不同的包装对象，导致缓存命中失败。
- * 使用 node.id 字符串做 key 彻底消除引用不一致问题。
- */
-const _dataListCacheById: Record<string, any> = {}
-
-const _cacheDataList = (target: any): void => {
-  const nodeId = target?.node?.id
-  if (!nodeId) return
-  const fromNode = target?.node?.getPropValue?.('dataList')
-  if (fromNode !== undefined) {
-    _dataListCacheById[nodeId] = fromNode
-    return
-  }
-  // schema 序列化快照：源头数据，不受 settings 中间态影响
-  const fromSchema = target?.node?.schema?.props?.dataList
-  if (fromSchema !== undefined) {
-    _dataListCacheById[nodeId] = fromSchema
-    return
-  }
-  const fromProps = target?.getProps?.()?.getPropValue?.('dataList')
-  if (fromProps !== undefined) {
-    _dataListCacheById[nodeId] = 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,64 +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
-            }
-            const props = target.getProps()
-            _cacheDataList(target)
-            // 快照 dataList：在 setPropValue 前捕获，防止引擎重评估时被默认值覆盖
-            const prevDataList = props.getPropValue('dataList')
-            props.setPropValue('imgWidth', parsedValue)
-            // 还原 dataList（幂等操作，若引擎未覆盖则无副作用）
-            if (prevDataList !== undefined) {
-              props.setPropValue('dataList', prevDataList)
+            if (parsedValue !== undefined) {
+              syncImageStyleValue(target, 'width', parsedValue)
             }
-            syncImageStyleValue(target, 'width', parsedValue)
           },
         },
       },
@@ -392,63 +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
-            }
-            const props = target.getProps()
-            _cacheDataList(target)
-            // 快照 dataList：在 setPropValue 前捕获，防止引擎重评估时被默认值覆盖
-            const prevDataList = props.getPropValue('dataList')
-            props.setPropValue('imgHeight', parsedValue)
-            // 还原 dataList（幂等操作，若引擎未覆盖则无副作用）
-            if (prevDataList !== undefined) {
-              props.setPropValue('dataList', prevDataList)
+            if (parsedValue !== undefined) {
+              syncImageStyleValue(target, 'height', parsedValue)
             }
-            syncImageStyleValue(target, 'height', parsedValue)
           },
         },
       },
@@ -960,100 +755,33 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
             },
           },
           initialValue: (target) => {
-            const nodeId = target?.node?.id
-            // 1. node API
-            const fromNode = target?.node?.getPropValue?.('dataList')
-            if (fromNode !== undefined) {
-              if (nodeId) _dataListCacheById[nodeId] = fromNode
-              return fromNode
-            }
-            // 2. 模块级缓存（node.id 索引，不受 Proxy 引用问题影响）
-            if (nodeId && _dataListCacheById[nodeId] !== undefined) {
-              return _dataListCacheById[nodeId]
-            }
-            // 3. settings API
-            const current = target?.getProps?.()?.getPropValue?.('dataList')
-            if (current !== undefined) {
-              if (nodeId) _dataListCacheById[nodeId] = current
-              return current
-            }
-            // 4. schema 序列化快照（源头数据，不受 settings 中间态影响）
-            const fromSchema = target?.node?.schema?.props?.dataList
-            if (fromSchema !== undefined) {
-              if (nodeId) _dataListCacheById[nodeId] = fromSchema
-              return fromSchema
-            }
-            // 5. 默认数据（仅首次创建组件时触达）
-            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: {
           /**
-           * 保证引擎重评估期间 field.getValue() 始终返回有效值（非 undefined），
-           * 阻止 initDefaultValue 覆盖已绑定的 JSExpression。
-           * 回退链：currentValue → 缓存(node.id) → schema 快照 → node API。
+           * ignoreDefaultValue: 彻底阻止引擎在 SettingFieldView remount 时
+           * 调用 initDefaultValue → 把 initialValue（默认数据数组）通过 field.setValue
+           * 写入 dataList prop，覆盖已绑定的 JSExpression。
+           *
+           * 这是根本性解决方案：在引擎层面阻断 initDefaultValue 的执行，
+           * 而不是试图在 initialValue/getValue/setValue 中做缓存和还原来补救。
            */
+          ignoreDefaultValue: () => true,
           getValue: (target: any, currentValue: any) => {
-            const nodeId = target?.node?.id
-            if (currentValue !== undefined) {
-              if (nodeId) _dataListCacheById[nodeId] = currentValue
-              return currentValue
-            }
-            // 引擎 currentValue 为 undefined（重评估中间态），逐级回退：
-            if (nodeId && _dataListCacheById[nodeId] !== undefined) {
-              return _dataListCacheById[nodeId]
-            }
-            // node.schema 序列化快照：不受 settings 中间态影响，是最可靠的源头数据
+            // currentValue 已有值时直接返回
+            if (currentValue !== undefined) return currentValue
+            // 从 schema 快照兜底读取（最可靠的源头数据，始终反映持久化状态）
             const fromSchema = target?.node?.schema?.props?.dataList
-            if (fromSchema !== undefined) {
-              if (nodeId) _dataListCacheById[nodeId] = fromSchema
-              return fromSchema
-            }
-            const fromNode = target?.node?.getPropValue?.('dataList')
-            if (fromNode !== undefined) {
-              if (nodeId) _dataListCacheById[nodeId] = fromNode
-              return fromNode
-            }
+            if (fromSchema !== undefined) return fromSchema
             return undefined
           },
-          /**
-           * 用户编辑 dataList 时同步更新缓存并持久化到 schema。
-           * 引擎 extraProps.setValue 完全接管写入，必须显式 setPropValue。
-           */
-          setValue: (target: any, value: any) => {
-            const nodeId = target?.node?.id
-            if (!nodeId) return
-            if (value !== undefined) {
-              _dataListCacheById[nodeId] = value
-              target.getProps?.()?.setPropValue?.('dataList', value)
-            } else {
-              delete _dataListCacheById[nodeId]
-              target.getProps?.()?.setPropValue?.('dataList', undefined)
-            }
-          },
         },
       },
     ],
@@ -1076,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.373';
+    version = '0.1.374';
   }
   if (basicLibraryVersion === void 0) {
     basicLibraryVersion = {