@dckj-npm/dc-material 0.1.368 → 0.1.370

package/lowcode/teletext-list/meta.ts

@@ -134,6 +134,34 @@ 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 可从缓存安全恢复，彻底切断引擎中间态影响。
+ */
+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',
@@ -260,6 +288,9 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
         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')
@@ -334,8 +365,10 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
               return
             }
             const props = target.getProps()
+            // 在任何 setPropValue 之前先写入模块级缓存（与 imagePlacement.setValue 同策略）
+            _cacheDataList(target)
             // 快照需要保护的数据，防止 syncImageStyleValue → imageChildNode.setPropValue
-            // 触发引擎重评估 dataList.initialValue，导致 dataList 被重置为默认图（与 imagePlacement.setValue 同策略）
+            // 触发引擎重评估 dataList.initialValue，导致 dataList 被重置为默认图
             const prevDataList = props.getPropValue('dataList')
             const prevDataListBind = props.getPropValue('dataListBind')
             props.setPropValue('imgWidth', parsedValue)
@@ -401,6 +434,8 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
               return
             }
             const props = target.getProps()
+            // 在任何 setPropValue 之前先写入模块级缓存（与 imagePlacement.setValue 同策略）
+            _cacheDataList(target)
             // 快照需要保护的数据，防止 syncImageStyleValue → imageChildNode.setPropValue
             // 触发引擎重评估 dataList.initialValue，导致 dataList 被重置为默认图
             const prevDataList = props.getPropValue('dataList')
@@ -921,19 +956,27 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
             },
           },
           initialValue: (target) => {
-            // 若 dataList prop 已有值（用户自定义数组、JSExpression 数据源绑定等），
-            // 直接返回当前值，防止引擎在任意 setPropValue 触发重评估时用静态默认数组
-            // 覆盖已设置的 dataList，导致画布图片回退为默认图（问题 12.4 残留路径）。
-            // 优先使用 node 级 API（读取 schema 层数据，不受引擎 settings 重评估中间态影响）；
-            // settings API (getProps) 在引擎重评估时可能处于已清空的中间状态，
-            // 而 node.getPropValue 始终反映最后一次持久化写入的值。
-            // 仅当两者均为 undefined（首次创建组件）时才注入默认占位数据。
-            const fromNode = target?.node?.getPropValue?.('dataList')
+            // 读取顺序（由最可靠到最不可靠）：
+            // 1. node 级 API（schema 层，引擎重评估前通常仍有值）
+            // 2. 模块级 WeakMap 缓存（在任何 setPropValue 之前写入，完全不受引擎清空影响）
+            // 3. settings API（重评估中间态下可能已清空，作为最后手段）
+            // 4. 默认占位数据（仅首次创建组件时触达）
+            const node = target?.node
+            const fromNode = node?.getPropValue?.('dataList')
             if (fromNode !== undefined) {
+              // 同步更新缓存，为后续可能的重评估提供后备
+              if (node) _nodeDataListCache.set(node, fromNode)
               return fromNode
             }
+            // node.getPropValue 返回 undefined：引擎已在调用 initialValue 前清空 node prop
+            // → 读取模块级缓存（在 setValue 中任何 setPropValue 之前写入，最可靠的后备）
+            const cached = node ? _nodeDataListCache.get(node) : undefined
+            if (cached !== undefined) {
+              return cached
+            }
             const current = target?.getProps?.()?.getPropValue?.('dataList')
             if (current !== undefined) {
+              if (node) _nodeDataListCache.set(node, current)
               return current
             }
             return [
@@ -962,6 +1005,47 @@ 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 永远跳过 → 默认图问题彻底消失。
+           */
+          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 缓存。
+           * 这是保证缓存与用户实际数据保持同步的关键——之前缓存只在
+           * imgWidth/imgHeight/imagePlacement.setValue 中写入，用户直接编辑 dataList
+           * 时缓存一直停留在初始默认值，导致 margin 修改时从缓存取出默认图数组。
+           */
+          setValue: (target: any, value: any) => {
+            const node = target?.node
+            if (!node) return
+            if (value !== undefined) {
+              _nodeDataListCache.set(node, value)
+            } else {
+              // clearValue 场景（value = undefined）：清空缓存，使下次 initDefaultValue
+              // 可正常返回默认数组（仅用于组件被显式清除数据的情况）
+              _nodeDataListCache.delete(node)
+            }
+          },
+        },
       },
     ],
     supports: {

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

package/lowcode_es/teletext-list/meta.js

@@ -125,6 +125,34 @@ var isDataListBoundExpression = function isDataListBoundExpression(target) {
   var dataListValue = target === null || target === void 0 ? void 0 : (_target$getProps3 = target.getProps) === null || _target$getProps3 === void 0 ? void 0 : (_target$getProps3$cal = _target$getProps3.call(target)) === null || _target$getProps3$cal === void 0 ? void 0 : (_target$getProps3$cal2 = _target$getProps3$cal.getPropValue) === null || _target$getProps3$cal2 === void 0 ? void 0 : _target$getProps3$cal2.call(_target$getProps3$cal, 'dataList');
   return !!(dataListValue && typeof dataListValue === 'object' && dataListValue.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 可从缓存安全恢复，彻底切断引擎中间态影响。
+ */
+var _nodeDataListCache = new WeakMap();
+var _cacheDataList = function _cacheDataList(target) {
+  var _node$getPropValue, _target$getProps4, _target$getProps4$cal, _target$getProps4$cal2;
+  var node = target === null || target === void 0 ? void 0 : target.node;
+  if (!node) return;
+  // 优先从 node 级 API 读取（schema 层，不受 settings 重评估中间态影响）
+  var fromNode = node === null || node === void 0 ? void 0 : (_node$getPropValue = node.getPropValue) === null || _node$getPropValue === void 0 ? void 0 : _node$getPropValue.call(node, 'dataList');
+  if (fromNode !== undefined) {
+    _nodeDataListCache.set(node, fromNode);
+    return;
+  }
+  // 降级：从 settings API 读取
+  var fromProps = target === null || target === void 0 ? void 0 : (_target$getProps4 = target.getProps) === null || _target$getProps4 === void 0 ? void 0 : (_target$getProps4$cal = _target$getProps4.call(target)) === null || _target$getProps4$cal === void 0 ? void 0 : (_target$getProps4$cal2 = _target$getProps4$cal.getPropValue) === null || _target$getProps4$cal2 === void 0 ? void 0 : _target$getProps4$cal2.call(_target$getProps4$cal, 'dataList');
+  if (fromProps !== undefined) {
+    _nodeDataListCache.set(node, fromProps);
+  }
+};
 var TeletextListMeta = {
   group: '低代码组件',
   componentName: 'TeletextList',
@@ -229,6 +257,9 @@ var TeletextListMeta = {
       extraProps: {
         setValue: function setValue(target, value) {
           var props = target.getProps();
+          // 在任何 setPropValue 之前先写入模块级缓存，确保 dataList.initialValue
+          // 重评估时即使 engine 已清空 node prop 也能从缓存恢复正确值
+          _cacheDataList(target);
           // 显式快照需要保护的配置，防止引擎某些实现在写入时触发重初始化导致配置丢失
           var prevDataList = props.getPropValue('dataList');
           var prevDataListBind = props.getPropValue('dataListBind');
@@ -254,12 +285,12 @@ var TeletextListMeta = {
         componentName: 'NumberSetter',
         isRequired: false,
         initialValue: function initialValue(target) {
-          var _target$getProps4, _target$getProps4$get;
+          var _target$getProps5, _target$getProps5$get;
           var styleWidth = getImageStyleNumber(target, 'width');
           if (styleWidth !== undefined) {
             return styleWidth;
           }
-          var propValue = target === null || target === void 0 ? void 0 : (_target$getProps4 = target.getProps()) === null || _target$getProps4 === void 0 ? void 0 : (_target$getProps4$get = _target$getProps4.getPropValue) === null || _target$getProps4$get === void 0 ? void 0 : _target$getProps4$get.call(_target$getProps4, 'imgWidth');
+          var propValue = target === null || target === void 0 ? void 0 : (_target$getProps5 = target.getProps()) === null || _target$getProps5 === void 0 ? void 0 : (_target$getProps5$get = _target$getProps5.getPropValue) === null || _target$getProps5$get === void 0 ? void 0 : _target$getProps5$get.call(_target$getProps5, 'imgWidth');
           var parsedPropValue = parsePxNumber(propValue);
           if (parsedPropValue !== undefined) return parsedPropValue;
           // 数据源已绑定时，避免回退为 100 触发误写回
@@ -269,12 +300,12 @@ var TeletextListMeta = {
           return 100;
         },
         defaultValue: function defaultValue(target) {
-          var _target$getProps5, _target$getProps5$get;
+          var _target$getProps6, _target$getProps6$get;
           var styleWidth = getImageStyleNumber(target, 'width');
           if (styleWidth !== undefined) {
             return styleWidth;
           }
-          var propValue = target === null || target === void 0 ? void 0 : (_target$getProps5 = target.getProps()) === null || _target$getProps5 === void 0 ? void 0 : (_target$getProps5$get = _target$getProps5.getPropValue) === null || _target$getProps5$get === void 0 ? void 0 : _target$getProps5$get.call(_target$getProps5, 'imgWidth');
+          var propValue = target === null || target === void 0 ? void 0 : (_target$getProps6 = target.getProps()) === null || _target$getProps6 === void 0 ? void 0 : (_target$getProps6$get = _target$getProps6.getPropValue) === null || _target$getProps6$get === void 0 ? void 0 : _target$getProps6$get.call(_target$getProps6, 'imgWidth');
           var parsedPropValue = parsePxNumber(propValue);
           if (parsedPropValue !== undefined) return parsedPropValue;
           if (isDataListBoundExpression(target)) {
@@ -285,14 +316,14 @@ var TeletextListMeta = {
       },
       extraProps: {
         getValue: function getValue(target) {
-          var _target$getProps6, _target$getProps6$get;
+          var _target$getProps7, _target$getProps7$get;
           // getValue 纯读操作，不做任何写入，避免触发引擎重评估其他 setter 的 initialValue
           // （写操作会导致引擎重初始化 dataList 等 prop，画布图片回退到默认图）
           var styleWidth = getImageStyleNumber(target, 'width');
           if (styleWidth !== undefined) {
             return styleWidth;
           }
-          var propValue = target === null || target === void 0 ? void 0 : (_target$getProps6 = target.getProps()) === null || _target$getProps6 === void 0 ? void 0 : (_target$getProps6$get = _target$getProps6.getPropValue) === null || _target$getProps6$get === void 0 ? void 0 : _target$getProps6$get.call(_target$getProps6, 'imgWidth');
+          var propValue = target === null || target === void 0 ? void 0 : (_target$getProps7 = target.getProps()) === null || _target$getProps7 === void 0 ? void 0 : (_target$getProps7$get = _target$getProps7.getPropValue) === null || _target$getProps7$get === void 0 ? void 0 : _target$getProps7$get.call(_target$getProps7, 'imgWidth');
           var parsedPropValue = parsePxNumber(propValue);
           if (parsedPropValue !== undefined) {
             return parsedPropValue;
@@ -305,8 +336,10 @@ var TeletextListMeta = {
             return;
           }
           var props = target.getProps();
+          // 在任何 setPropValue 之前先写入模块级缓存（与 imagePlacement.setValue 同策略）
+          _cacheDataList(target);
           // 快照需要保护的数据，防止 syncImageStyleValue → imageChildNode.setPropValue
-          // 触发引擎重评估 dataList.initialValue，导致 dataList 被重置为默认图（与 imagePlacement.setValue 同策略）
+          // 触发引擎重评估 dataList.initialValue，导致 dataList 被重置为默认图
           var prevDataList = props.getPropValue('dataList');
           var prevDataListBind = props.getPropValue('dataListBind');
           props.setPropValue('imgWidth', parsedValue);
@@ -324,12 +357,12 @@ var TeletextListMeta = {
         componentName: 'NumberSetter',
         isRequired: false,
         initialValue: function initialValue(target) {
-          var _target$getProps7, _target$getProps7$get;
+          var _target$getProps8, _target$getProps8$get;
           var styleHeight = getImageStyleNumber(target, 'height');
           if (styleHeight !== undefined) {
             return styleHeight;
           }
-          var propValue = target === null || target === void 0 ? void 0 : (_target$getProps7 = target.getProps()) === null || _target$getProps7 === void 0 ? void 0 : (_target$getProps7$get = _target$getProps7.getPropValue) === null || _target$getProps7$get === void 0 ? void 0 : _target$getProps7$get.call(_target$getProps7, 'imgHeight');
+          var propValue = target === null || target === void 0 ? void 0 : (_target$getProps8 = target.getProps()) === null || _target$getProps8 === void 0 ? void 0 : (_target$getProps8$get = _target$getProps8.getPropValue) === null || _target$getProps8$get === void 0 ? void 0 : _target$getProps8$get.call(_target$getProps8, 'imgHeight');
           var parsedPropValue = parsePxNumber(propValue);
           if (parsedPropValue !== undefined) return parsedPropValue;
           // 数据源已绑定时，避免回退为 100 触发误写回
@@ -339,12 +372,12 @@ var TeletextListMeta = {
           return 100;
         },
         defaultValue: function defaultValue(target) {
-          var _target$getProps8, _target$getProps8$get;
+          var _target$getProps9, _target$getProps9$get;
           var styleHeight = getImageStyleNumber(target, 'height');
           if (styleHeight !== undefined) {
             return styleHeight;
           }
-          var propValue = target === null || target === void 0 ? void 0 : (_target$getProps8 = target.getProps()) === null || _target$getProps8 === void 0 ? void 0 : (_target$getProps8$get = _target$getProps8.getPropValue) === null || _target$getProps8$get === void 0 ? void 0 : _target$getProps8$get.call(_target$getProps8, 'imgHeight');
+          var propValue = target === null || target === void 0 ? void 0 : (_target$getProps9 = target.getProps()) === null || _target$getProps9 === void 0 ? void 0 : (_target$getProps9$get = _target$getProps9.getPropValue) === null || _target$getProps9$get === void 0 ? void 0 : _target$getProps9$get.call(_target$getProps9, 'imgHeight');
           var parsedPropValue = parsePxNumber(propValue);
           if (parsedPropValue !== undefined) return parsedPropValue;
           if (isDataListBoundExpression(target)) {
@@ -355,13 +388,13 @@ var TeletextListMeta = {
       },
       extraProps: {
         getValue: function getValue(target) {
-          var _target$getProps9, _target$getProps9$get;
+          var _target$getProps0, _target$getProps0$get;
           // getValue 纯读操作，不做任何写入，避免触发引擎重评估其他 setter 的 initialValue
           var styleHeight = getImageStyleNumber(target, 'height');
           if (styleHeight !== undefined) {
             return styleHeight;
           }
-          var propValue = target === null || target === void 0 ? void 0 : (_target$getProps9 = target.getProps()) === null || _target$getProps9 === void 0 ? void 0 : (_target$getProps9$get = _target$getProps9.getPropValue) === null || _target$getProps9$get === void 0 ? void 0 : _target$getProps9$get.call(_target$getProps9, 'imgHeight');
+          var propValue = target === null || target === void 0 ? void 0 : (_target$getProps0 = target.getProps()) === null || _target$getProps0 === void 0 ? void 0 : (_target$getProps0$get = _target$getProps0.getPropValue) === null || _target$getProps0$get === void 0 ? void 0 : _target$getProps0$get.call(_target$getProps0, 'imgHeight');
           var parsedPropValue = parsePxNumber(propValue);
           if (parsedPropValue !== undefined) {
             return parsedPropValue;
@@ -374,6 +407,8 @@ var TeletextListMeta = {
             return;
           }
           var props = target.getProps();
+          // 在任何 setPropValue 之前先写入模块级缓存（与 imagePlacement.setValue 同策略）
+          _cacheDataList(target);
           // 快照需要保护的数据，防止 syncImageStyleValue → imageChildNode.setPropValue
           // 触发引擎重评估 dataList.initialValue，导致 dataList 被重置为默认图
           var prevDataList = props.getPropValue('dataList');
@@ -852,20 +887,28 @@ var TeletextListMeta = {
           }
         },
         initialValue: function initialValue(target) {
-          var _target$node4, _target$node4$getProp, _target$getProps0, _target$getProps0$cal, _target$getProps0$cal2;
-          // 若 dataList prop 已有值（用户自定义数组、JSExpression 数据源绑定等），
-          // 直接返回当前值，防止引擎在任意 setPropValue 触发重评估时用静态默认数组
-          // 覆盖已设置的 dataList，导致画布图片回退为默认图（问题 12.4 残留路径）。
-          // 优先使用 node 级 API（读取 schema 层数据，不受引擎 settings 重评估中间态影响）；
-          // settings API (getProps) 在引擎重评估时可能处于已清空的中间状态，
-          // 而 node.getPropValue 始终反映最后一次持久化写入的值。
-          // 仅当两者均为 undefined（首次创建组件）时才注入默认占位数据。
-          var fromNode = target === null || target === void 0 ? void 0 : (_target$node4 = target.node) === null || _target$node4 === void 0 ? void 0 : (_target$node4$getProp = _target$node4.getPropValue) === null || _target$node4$getProp === void 0 ? void 0 : _target$node4$getProp.call(_target$node4, 'dataList');
+          var _node$getPropValue2, _target$getProps1, _target$getProps1$cal, _target$getProps1$cal2;
+          // 读取顺序（由最可靠到最不可靠）：
+          // 1. node 级 API（schema 层，引擎重评估前通常仍有值）
+          // 2. 模块级 WeakMap 缓存（在任何 setPropValue 之前写入，完全不受引擎清空影响）
+          // 3. settings API（重评估中间态下可能已清空，作为最后手段）
+          // 4. 默认占位数据（仅首次创建组件时触达）
+          var node = target === null || target === void 0 ? void 0 : target.node;
+          var fromNode = node === null || node === void 0 ? void 0 : (_node$getPropValue2 = node.getPropValue) === null || _node$getPropValue2 === void 0 ? void 0 : _node$getPropValue2.call(node, 'dataList');
           if (fromNode !== undefined) {
+            // 同步更新缓存，为后续可能的重评估提供后备
+            if (node) _nodeDataListCache.set(node, fromNode);
             return fromNode;
           }
-          var current = target === null || target === void 0 ? void 0 : (_target$getProps0 = target.getProps) === null || _target$getProps0 === void 0 ? void 0 : (_target$getProps0$cal = _target$getProps0.call(target)) === null || _target$getProps0$cal === void 0 ? void 0 : (_target$getProps0$cal2 = _target$getProps0$cal.getPropValue) === null || _target$getProps0$cal2 === void 0 ? void 0 : _target$getProps0$cal2.call(_target$getProps0$cal, 'dataList');
+          // node.getPropValue 返回 undefined：引擎已在调用 initialValue 前清空 node prop
+          // → 读取模块级缓存（在 setValue 中任何 setPropValue 之前写入，最可靠的后备）
+          var cached = node ? _nodeDataListCache.get(node) : undefined;
+          if (cached !== undefined) {
+            return cached;
+          }
+          var current = target === null || target === void 0 ? void 0 : (_target$getProps1 = target.getProps) === null || _target$getProps1 === void 0 ? void 0 : (_target$getProps1$cal = _target$getProps1.call(target)) === null || _target$getProps1$cal === void 0 ? void 0 : (_target$getProps1$cal2 = _target$getProps1$cal.getPropValue) === null || _target$getProps1$cal2 === void 0 ? void 0 : _target$getProps1$cal2.call(_target$getProps1$cal, 'dataList');
           if (current !== undefined) {
+            if (node) _nodeDataListCache.set(node, current);
             return current;
           }
           return [{
@@ -885,6 +928,47 @@ var TeletextListMeta = {
             }]
           }];
         }
+      },
+      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 永远跳过 → 默认图问题彻底消失。
+         */
+        getValue: function getValue(target, currentValue) {
+          var node = target === null || target === void 0 ? void 0 : target.node;
+          if (currentValue !== undefined) {
+            // schema 层有值：同步更新缓存，确保用户最新编辑的数据被记录
+            if (node) _nodeDataListCache.set(node, currentValue);
+            return currentValue;
+          }
+          // schema 层暂时无值（引擎重评估中间态）：从缓存恢复，避免 initDefaultValue 触发
+          var cached = node ? _nodeDataListCache.get(node) : undefined;
+          return cached; // undefined 仅在缓存为空（全新组件首次初始化）时出现，属正常情况
+        },
+        /**
+         * 自定义 setValue：用户每次编辑 dataList 条目时即时更新 WeakMap 缓存。
+         * 这是保证缓存与用户实际数据保持同步的关键——之前缓存只在
+         * imgWidth/imgHeight/imagePlacement.setValue 中写入，用户直接编辑 dataList
+         * 时缓存一直停留在初始默认值，导致 margin 修改时从缓存取出默认图数组。
+         */
+        setValue: function setValue(target, value) {
+          var node = target === null || target === void 0 ? void 0 : target.node;
+          if (!node) return;
+          if (value !== undefined) {
+            _nodeDataListCache.set(node, value);
+          } else {
+            // clearValue 场景（value = undefined）：清空缓存，使下次 initDefaultValue
+            // 可正常返回默认数组（仅用于组件被显式清除数据的情况）
+            _nodeDataListCache["delete"](node);
+          }
+        }
       }
     }],
     supports: {

package/lowcode_lib/meta.js

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