@dckj-npm/dc-material 0.1.371 → 0.1.373

package/lowcode/teletext-list/meta.ts

@@ -68,41 +68,49 @@ const getImageStyleNumber = (target: any, styleKey: 'width' | 'height'): number
   return parsePxNumber(imageChildSchema?.props?.style?.[styleKey])
 }
 
-const syncImageStyleValue = (target: any, styleKey: 'width' | 'height', value: number) => {
-  // 优先通过引擎节点 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'
+/**
+ * 异步写入 Image 子节点的 style，避免在 imgWidth/imgHeight.setValue 的同步执行栈内
+ * 触发引擎重评估 dataList.initialValue（会先清空 dataList prop，导致默认图覆盖绑定数据）。
+ * 通过 Promise.resolve().then() 将写入推迟到当前 settings 重评估完成后执行，
+ * 此时 dataList 已稳定为正确的 JSExpression，重评估无副作用。
+ */
+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
     }
-    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`,
-  }
+    // 降级：直接写 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`,
+    }
+  })
 }
 
 const syncImageDimensionPropsFromChild = (target: any) => {
@@ -135,30 +143,30 @@ const isDataListBoundExpression = (target: any): boolean => {
 }
 
 /**
- * 模块级 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 可从缓存安全恢复，彻底切断引擎中间态影响。
+ * 模块级缓存：使用 node.id（稳定的字符串 ID）作为 key。
+ * 替代 WeakMap 方案：WeakMap 以 target.node 对象引用为 key，
+ * 但引擎可能通过 Proxy/getter 每次返回不同的包装对象，导致缓存命中失败。
+ * 使用 node.id 字符串做 key 彻底消除引用不一致问题。
  */
-const _nodeDataListCache = new WeakMap<object, any>()
+const _dataListCacheById: Record<string, any> = {}
 
 const _cacheDataList = (target: any): void => {
-  const node = target?.node
-  if (!node) return
-  // 优先从 node 级 API 读取（schema 层，不受 settings 重评估中间态影响）
-  const fromNode = node?.getPropValue?.('dataList')
+  const nodeId = target?.node?.id
+  if (!nodeId) return
+  const fromNode = target?.node?.getPropValue?.('dataList')
   if (fromNode !== undefined) {
-    _nodeDataListCache.set(node, fromNode)
+    _dataListCacheById[nodeId] = fromNode
+    return
+  }
+  // schema 序列化快照：源头数据，不受 settings 中间态影响
+  const fromSchema = target?.node?.schema?.props?.dataList
+  if (fromSchema !== undefined) {
+    _dataListCacheById[nodeId] = fromSchema
     return
   }
-  // 降级：从 settings API 读取
   const fromProps = target?.getProps?.()?.getPropValue?.('dataList')
   if (fromProps !== undefined) {
-    _nodeDataListCache.set(node, fromProps)
+    _dataListCacheById[nodeId] = fromProps
   }
 }
 
@@ -365,17 +373,15 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
               return
             }
             const props = target.getProps()
-            // 在任何 setPropValue 之前先写入模块级缓存（与 imagePlacement.setValue 同策略）
             _cacheDataList(target)
-            // 快照需要保护的数据，防止 syncImageStyleValue → imageChildNode.setPropValue
-            // 触发引擎重评估 dataList.initialValue，导致 dataList 被重置为默认图
+            // 快照 dataList：在 setPropValue 前捕获，防止引擎重评估时被默认值覆盖
             const prevDataList = props.getPropValue('dataList')
-            const prevDataListBind = props.getPropValue('dataListBind')
             props.setPropValue('imgWidth', parsedValue)
+            // 还原 dataList（幂等操作，若引擎未覆盖则无副作用）
+            if (prevDataList !== undefined) {
+              props.setPropValue('dataList', prevDataList)
+            }
             syncImageStyleValue(target, 'width', parsedValue)
-            // 还原被保护的数据（幂等操作，若引擎未重置则无副作用）
-            if (prevDataList !== undefined) props.setPropValue('dataList', prevDataList)
-            if (prevDataListBind !== undefined) props.setPropValue('dataListBind', prevDataListBind)
           },
         },
       },
@@ -434,17 +440,15 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
               return
             }
             const props = target.getProps()
-            // 在任何 setPropValue 之前先写入模块级缓存（与 imagePlacement.setValue 同策略）
             _cacheDataList(target)
-            // 快照需要保护的数据，防止 syncImageStyleValue → imageChildNode.setPropValue
-            // 触发引擎重评估 dataList.initialValue，导致 dataList 被重置为默认图
+            // 快照 dataList：在 setPropValue 前捕获，防止引擎重评估时被默认值覆盖
             const prevDataList = props.getPropValue('dataList')
-            const prevDataListBind = props.getPropValue('dataListBind')
             props.setPropValue('imgHeight', parsedValue)
+            // 还原 dataList（幂等操作，若引擎未覆盖则无副作用）
+            if (prevDataList !== undefined) {
+              props.setPropValue('dataList', prevDataList)
+            }
             syncImageStyleValue(target, 'height', parsedValue)
-            // 还原被保护的数据（幂等操作，若引擎未重置则无副作用）
-            if (prevDataList !== undefined) props.setPropValue('dataList', prevDataList)
-            if (prevDataListBind !== undefined) props.setPropValue('dataListBind', prevDataListBind)
           },
         },
       },
@@ -956,29 +960,30 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
             },
           },
           initialValue: (target) => {
-            // 读取顺序（由最可靠到最不可靠）：
-            // 1. node 级 API（schema 层，引擎重评估前通常仍有值）
-            // 2. 模块级 WeakMap 缓存（在任何 setPropValue 之前写入，完全不受引擎清空影响）
-            // 3. settings API（重评估中间态下可能已清空，作为最后手段）
-            // 4. 默认占位数据（仅首次创建组件时触达）
-            const node = target?.node
-            const fromNode = node?.getPropValue?.('dataList')
+            const nodeId = target?.node?.id
+            // 1. node API
+            const fromNode = target?.node?.getPropValue?.('dataList')
             if (fromNode !== undefined) {
-              // 同步更新缓存，为后续可能的重评估提供后备
-              if (node) _nodeDataListCache.set(node, fromNode)
+              if (nodeId) _dataListCacheById[nodeId] = fromNode
               return fromNode
             }
-            // node.getPropValue 返回 undefined：引擎已在调用 initialValue 前清空 node prop
-            // → 读取模块级缓存（在 setValue 中任何 setPropValue 之前写入，最可靠的后备）
-            const cached = node ? _nodeDataListCache.get(node) : undefined
-            if (cached !== undefined) {
-              return cached
+            // 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 (node) _nodeDataListCache.set(node, current)
+              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',
@@ -1007,53 +1012,45 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
         },
         extraProps: {
           /**
-           * 自定义 getValue：保证引擎重评估期间 field.getValue() 始终返回有效值（非 undefined），
-           * 从而阻止 initDefaultValue 在不应该的时机调用 initialValue 并覆盖为默认图数组。
-           *
-           * 触发场景：修改 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 永远跳过 → 默认图问题彻底消失。
+           * 保证引擎重评估期间 field.getValue() 始终返回有效值（非 undefined），
+           * 阻止 initDefaultValue 覆盖已绑定的 JSExpression。
+           * 回退链：currentValue → 缓存(node.id) → schema 快照 → node API。
            */
           getValue: (target: any, currentValue: any) => {
-            const node = target?.node
+            const nodeId = target?.node?.id
             if (currentValue !== undefined) {
-              // schema 层有值：同步更新缓存，确保用户最新编辑的数据被记录
-              if (node) _nodeDataListCache.set(node, currentValue)
+              if (nodeId) _dataListCacheById[nodeId] = currentValue
               return currentValue
             }
-            // schema 层暂时无值（引擎重评估中间态）：从缓存恢复，避免 initDefaultValue 触发
-            const cached = node ? _nodeDataListCache.get(node) : undefined
-            return cached // undefined 仅在缓存为空（全新组件首次初始化）时出现，属正常情况
+            // 引擎 currentValue 为 undefined（重评估中间态），逐级回退：
+            if (nodeId && _dataListCacheById[nodeId] !== undefined) {
+              return _dataListCacheById[nodeId]
+            }
+            // node.schema 序列化快照：不受 settings 中间态影响，是最可靠的源头数据
+            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
+            }
+            return 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 不会被调用，不会产生循环。
+           * 用户编辑 dataList 时同步更新缓存并持久化到 schema。
+           * 引擎 extraProps.setValue 完全接管写入，必须显式 setPropValue。
            */
           setValue: (target: any, value: any) => {
-            const node = target?.node
-            if (!node) return
+            const nodeId = target?.node?.id
+            if (!nodeId) return
             if (value !== undefined) {
-              // 先写缓存，确保重评估期间 getValue 可从缓存返回有效值
-              _nodeDataListCache.set(node, value)
-              // 再持久化到 schema（引擎不会自动写入，必须显式调用）
+              _dataListCacheById[nodeId] = value
               target.getProps?.()?.setPropValue?.('dataList', value)
             } else {
-              // clearValue 场景（value = undefined）：清空缓存，使下次 initDefaultValue
-              // 可正常返回默认数组（仅用于组件被显式清除数据的情况）
-              _nodeDataListCache.delete(node)
+              delete _dataListCacheById[nodeId]
               target.getProps?.()?.setPropValue?.('dataList', undefined)
             }
           },

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.371';
+    version = '0.1.373';
   }
   if (basicLibraryVersion === void 0) {
     basicLibraryVersion = {