@dckj-npm/dc-material 0.1.370 → 0.1.372

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) => {
@@ -365,17 +373,11 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
               return
             }
             const props = target.getProps()
-            // 在任何 setPropValue 之前先写入模块级缓存（与 imagePlacement.setValue 同策略）
+            // 在写入前先更新模块级缓存，确保async syncImageStyleValue触发的重评估时缓存有效
             _cacheDataList(target)
-            // 快照需要保护的数据，防止 syncImageStyleValue → imageChildNode.setPropValue
-            // 触发引擎重评估 dataList.initialValue，导致 dataList 被重置为默认图
-            const prevDataList = props.getPropValue('dataList')
-            const prevDataListBind = props.getPropValue('dataListBind')
             props.setPropValue('imgWidth', parsedValue)
+            // syncImageStyleValue 异步执行，不在当前同步栈内触发 dataList.initialValue 重评估
             syncImageStyleValue(target, 'width', parsedValue)
-            // 还原被保护的数据（幂等操作，若引擎未重置则无副作用）
-            if (prevDataList !== undefined) props.setPropValue('dataList', prevDataList)
-            if (prevDataListBind !== undefined) props.setPropValue('dataListBind', prevDataListBind)
           },
         },
       },
@@ -434,17 +436,11 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
               return
             }
             const props = target.getProps()
-            // 在任何 setPropValue 之前先写入模块级缓存（与 imagePlacement.setValue 同策略）
+            // 在写入前先更新模块级缓存，确保async syncImageStyleValue触发的重评估时缓存有效
             _cacheDataList(target)
-            // 快照需要保护的数据，防止 syncImageStyleValue → imageChildNode.setPropValue
-            // 触发引擎重评估 dataList.initialValue，导致 dataList 被重置为默认图
-            const prevDataList = props.getPropValue('dataList')
-            const prevDataListBind = props.getPropValue('dataListBind')
             props.setPropValue('imgHeight', parsedValue)
+            // syncImageStyleValue 异步执行，不在当前同步栈内触发 dataList.initialValue 重评估
             syncImageStyleValue(target, 'height', parsedValue)
-            // 还原被保护的数据（幂等操作，若引擎未重置则无副作用）
-            if (prevDataList !== undefined) props.setPropValue('dataList', prevDataList)
-            if (prevDataListBind !== undefined) props.setPropValue('dataListBind', prevDataListBind)
           },
         },
       },
@@ -961,16 +957,22 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
             // 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
+            // node.getPropValue 返回 undefined：引擎可能已在调用 initialValue 前清空 node prop
             // → 读取模块级缓存（在 setValue 中任何 setPropValue 之前写入，最可靠的后备）
-            const cached = node ? _nodeDataListCache.get(node) : undefined
             if (cached !== undefined) {
               return cached
             }
@@ -1029,20 +1031,32 @@ const TeletextListMeta: IPublicTypeComponentMetadata = {
             return cached // undefined 仅在缓存为空（全新组件首次初始化）时出现，属正常情况
           },
           /**
-           * 自定义 setValue：用户每次编辑 dataList 条目时即时更新 WeakMap 缓存。
-           * 这是保证缓存与用户实际数据保持同步的关键——之前缓存只在
-           * imgWidth/imgHeight/imagePlacement.setValue 中写入，用户直接编辑 dataList
-           * 时缓存一直停留在初始默认值，导致 margin 修改时从缓存取出默认图数组。
+           * 自定义 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)
             }
           },
         },

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

package/lowcode_es/teletext-list/meta.js

@@ -64,41 +64,50 @@ var getImageStyleNumber = function getImageStyleNumber(target, styleKey) {
   var imageChildSchema = findImageChildSchema(target);
   return parsePxNumber(imageChildSchema === null || imageChildSchema === void 0 ? void 0 : (_imageChildSchema$pro = imageChildSchema.props) === null || _imageChildSchema$pro === void 0 ? void 0 : (_imageChildSchema$pro2 = _imageChildSchema$pro.style) === null || _imageChildSchema$pro2 === void 0 ? void 0 : _imageChildSchema$pro2[styleKey]);
 };
+
+/**
+ * 异步写入 Image 子节点的 style，避免在 imgWidth/imgHeight.setValue 的同步执行栈内
+ * 触发引擎重评估 dataList.initialValue（会先清空 dataList prop，导致默认图覆盖绑定数据）。
+ * 通过 Promise.resolve().then() 将写入推迟到当前 settings 重评估完成后执行，
+ * 此时 dataList 已稳定为正确的 JSExpression，重评估无副作用。
+ */
 var syncImageStyleValue = function syncImageStyleValue(target, styleKey, value) {
-  var _extends3;
-  // 优先通过引擎节点 API 更新子节点 style，确保引擎感知变化（布局面板读取时可见）
-  var imageChildNode = findImageChildNode(target);
-  if (imageChildNode) {
-    var _imageChildNode$getPr3, _extends2, _imageChildNode$setPr;
-    var _currentStyle = ((_imageChildNode$getPr3 = imageChildNode.getPropValue) === null || _imageChildNode$getPr3 === void 0 ? void 0 : _imageChildNode$getPr3.call(imageChildNode, 'style')) || {};
-    // 同时确保 width/height 都存在于子节点 style 中，防止布局面板 replace 时丢失其中一个
-    var updatedStyle = _extends({}, _currentStyle, (_extends2 = {}, _extends2[styleKey] = value + "px", _extends2));
-    // 如果另一轴尺寸在子节点 style 中不存在，则从父级 prop 补充，保证两轴都写入
-    var otherKey = styleKey === 'width' ? 'height' : 'width';
-    if (!updatedStyle[otherKey]) {
-      var _target$getProps, _target$getProps$call, _target$getProps$call2;
-      var otherPropKey = otherKey === 'width' ? 'imgWidth' : 'imgHeight';
-      var otherPropValue = parsePxNumber(target === null || target === void 0 ? void 0 : (_target$getProps = target.getProps) === null || _target$getProps === void 0 ? void 0 : (_target$getProps$call = _target$getProps.call(target)) === null || _target$getProps$call === void 0 ? void 0 : (_target$getProps$call2 = _target$getProps$call.getPropValue) === null || _target$getProps$call2 === void 0 ? void 0 : _target$getProps$call2.call(_target$getProps$call, otherPropKey));
-      if (otherPropValue !== undefined) {
-        updatedStyle[otherKey] = otherPropValue + "px";
-      } else {
-        // 子节点 style 也没有，使用默认值 100
-        updatedStyle[otherKey] = '100px';
+  Promise.resolve().then(function () {
+    var _extends3;
+    // 优先通过引擎节点 API 更新子节点 style，确保引擎感知变化（布局面板读取时可见）
+    var imageChildNode = findImageChildNode(target);
+    if (imageChildNode) {
+      var _imageChildNode$getPr3, _extends2, _imageChildNode$setPr;
+      var _currentStyle = ((_imageChildNode$getPr3 = imageChildNode.getPropValue) === null || _imageChildNode$getPr3 === void 0 ? void 0 : _imageChildNode$getPr3.call(imageChildNode, 'style')) || {};
+      // 同时确保 width/height 都存在于子节点 style 中，防止布局面板 replace 时丢失其中一个
+      var updatedStyle = _extends({}, _currentStyle, (_extends2 = {}, _extends2[styleKey] = value + "px", _extends2));
+      // 如果另一轴尺寸在子节点 style 中不存在，则从父级 prop 补充，保证两轴都写入
+      var otherKey = styleKey === 'width' ? 'height' : 'width';
+      if (!updatedStyle[otherKey]) {
+        var _target$getProps, _target$getProps$call, _target$getProps$call2;
+        var otherPropKey = otherKey === 'width' ? 'imgWidth' : 'imgHeight';
+        var otherPropValue = parsePxNumber(target === null || target === void 0 ? void 0 : (_target$getProps = target.getProps) === null || _target$getProps === void 0 ? void 0 : (_target$getProps$call = _target$getProps.call(target)) === null || _target$getProps$call === void 0 ? void 0 : (_target$getProps$call2 = _target$getProps$call.getPropValue) === null || _target$getProps$call2 === void 0 ? void 0 : _target$getProps$call2.call(_target$getProps$call, otherPropKey));
+        if (otherPropValue !== undefined) {
+          updatedStyle[otherKey] = otherPropValue + "px";
+        } else {
+          // 子节点 style 也没有，使用默认值 100
+          updatedStyle[otherKey] = '100px';
+        }
       }
+      (_imageChildNode$setPr = imageChildNode.setPropValue) === null || _imageChildNode$setPr === void 0 ? void 0 : _imageChildNode$setPr.call(imageChildNode, 'style', updatedStyle);
+      return;
     }
-    (_imageChildNode$setPr = imageChildNode.setPropValue) === null || _imageChildNode$setPr === void 0 ? void 0 : _imageChildNode$setPr.call(imageChildNode, 'style', updatedStyle);
-    return;
-  }
-  // 降级：直接写 schema（引擎无法感知，但保留作为兜底）
-  var imageChildSchema = findImageChildSchema(target);
-  if (!imageChildSchema) {
-    return;
-  }
-  if (!imageChildSchema.props) {
-    imageChildSchema.props = {};
-  }
-  var currentStyle = imageChildSchema.props.style || {};
-  imageChildSchema.props.style = _extends({}, currentStyle, (_extends3 = {}, _extends3[styleKey] = value + "px", _extends3));
+    // 降级：直接写 schema（引擎无法感知，但保留作为兜底）
+    var imageChildSchema = findImageChildSchema(target);
+    if (!imageChildSchema) {
+      return;
+    }
+    if (!imageChildSchema.props) {
+      imageChildSchema.props = {};
+    }
+    var currentStyle = imageChildSchema.props.style || {};
+    imageChildSchema.props.style = _extends({}, currentStyle, (_extends3 = {}, _extends3[styleKey] = value + "px", _extends3));
+  });
 };
 var syncImageDimensionPropsFromChild = function syncImageDimensionPropsFromChild(target) {
   var _target$getProps2;
@@ -336,17 +345,11 @@ var TeletextListMeta = {
             return;
           }
           var props = target.getProps();
-          // 在任何 setPropValue 之前先写入模块级缓存（与 imagePlacement.setValue 同策略）
+          // 在写入前先更新模块级缓存，确保async syncImageStyleValue触发的重评估时缓存有效
           _cacheDataList(target);
-          // 快照需要保护的数据，防止 syncImageStyleValue → imageChildNode.setPropValue
-          // 触发引擎重评估 dataList.initialValue，导致 dataList 被重置为默认图
-          var prevDataList = props.getPropValue('dataList');
-          var prevDataListBind = props.getPropValue('dataListBind');
           props.setPropValue('imgWidth', parsedValue);
+          // syncImageStyleValue 异步执行，不在当前同步栈内触发 dataList.initialValue 重评估
           syncImageStyleValue(target, 'width', parsedValue);
-          // 还原被保护的数据（幂等操作，若引擎未重置则无副作用）
-          if (prevDataList !== undefined) props.setPropValue('dataList', prevDataList);
-          if (prevDataListBind !== undefined) props.setPropValue('dataListBind', prevDataListBind);
         }
       }
     }, {
@@ -407,17 +410,11 @@ var TeletextListMeta = {
             return;
           }
           var props = target.getProps();
-          // 在任何 setPropValue 之前先写入模块级缓存（与 imagePlacement.setValue 同策略）
+          // 在写入前先更新模块级缓存，确保async syncImageStyleValue触发的重评估时缓存有效
           _cacheDataList(target);
-          // 快照需要保护的数据，防止 syncImageStyleValue → imageChildNode.setPropValue
-          // 触发引擎重评估 dataList.initialValue，导致 dataList 被重置为默认图
-          var prevDataList = props.getPropValue('dataList');
-          var prevDataListBind = props.getPropValue('dataListBind');
           props.setPropValue('imgHeight', parsedValue);
+          // syncImageStyleValue 异步执行，不在当前同步栈内触发 dataList.initialValue 重评估
           syncImageStyleValue(target, 'height', parsedValue);
-          // 还原被保护的数据（幂等操作，若引擎未重置则无副作用）
-          if (prevDataList !== undefined) props.setPropValue('dataList', prevDataList);
-          if (prevDataListBind !== undefined) props.setPropValue('dataListBind', prevDataListBind);
         }
       }
     }, {
@@ -893,16 +890,22 @@ var TeletextListMeta = {
           // 2. 模块级 WeakMap 缓存（在任何 setPropValue 之前写入，完全不受引擎清空影响）
           // 3. settings API（重评估中间态下可能已清空，作为最后手段）
           // 4. 默认占位数据（仅首次创建组件时触达）
+          //
+          // 关键防御：一旦组件已绑定数据源（缓存或 node 中有值），
+          // 无论是哪种场景的 initialValue 调用，都必须返回已有值而不是默认数组。
+          // syncImageStyleValue 改为异步后，通常 node.getPropValue 已能拿到正确值；
+          // 缓存作为最后一道防线，彻底切断默认数组覆盖绑定表达式的可能。
           var node = target === null || target === void 0 ? void 0 : target.node;
+          // 优先读缓存：即使 node.getPropValue 暂时处于中间态，缓存也能提供可靠值
+          var cached = node ? _nodeDataListCache.get(node) : undefined;
           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;
           }
-          // node.getPropValue 返回 undefined：引擎已在调用 initialValue 前清空 node prop
+          // node.getPropValue 返回 undefined：引擎可能已在调用 initialValue 前清空 node prop
           // → 读取模块级缓存（在 setValue 中任何 setPropValue 之前写入，最可靠的后备）
-          var cached = node ? _nodeDataListCache.get(node) : undefined;
           if (cached !== undefined) {
             return cached;
           }
@@ -953,20 +956,34 @@ var TeletextListMeta = {
           return cached; // undefined 仅在缓存为空（全新组件首次初始化）时出现，属正常情况
         },
         /**
-         * 自定义 setValue：用户每次编辑 dataList 条目时即时更新 WeakMap 缓存。
-         * 这是保证缓存与用户实际数据保持同步的关键——之前缓存只在
-         * imgWidth/imgHeight/imagePlacement.setValue 中写入，用户直接编辑 dataList
-         * 时缓存一直停留在初始默认值，导致 margin 修改时从缓存取出默认图数组。
+         * 自定义 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: function setValue(target, value) {
           var node = target === null || target === void 0 ? void 0 : target.node;
           if (!node) return;
           if (value !== undefined) {
+            var _target$getProps10, _target$getProps10$ca, _target$getProps10$ca2;
+            // 先写缓存，确保重评估期间 getValue 可从缓存返回有效值
             _nodeDataListCache.set(node, value);
+            // 再持久化到 schema（引擎不会自动写入，必须显式调用）
+            (_target$getProps10 = target.getProps) === null || _target$getProps10 === void 0 ? void 0 : (_target$getProps10$ca = _target$getProps10.call(target)) === null || _target$getProps10$ca === void 0 ? void 0 : (_target$getProps10$ca2 = _target$getProps10$ca.setPropValue) === null || _target$getProps10$ca2 === void 0 ? void 0 : _target$getProps10$ca2.call(_target$getProps10$ca, 'dataList', value);
           } else {
+            var _target$getProps11, _target$getProps11$ca, _target$getProps11$ca2;
             // clearValue 场景（value = undefined）：清空缓存，使下次 initDefaultValue
             // 可正常返回默认数组（仅用于组件被显式清除数据的情况）
             _nodeDataListCache["delete"](node);
+            (_target$getProps11 = target.getProps) === null || _target$getProps11 === void 0 ? void 0 : (_target$getProps11$ca = _target$getProps11.call(target)) === null || _target$getProps11$ca === void 0 ? void 0 : (_target$getProps11$ca2 = _target$getProps11$ca.setPropValue) === null || _target$getProps11$ca2 === void 0 ? void 0 : _target$getProps11$ca2.call(_target$getProps11$ca, 'dataList', undefined);
           }
         }
       }

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

package/lowcode_lib/teletext-list/meta.js

@@ -69,41 +69,50 @@ var getImageStyleNumber = function getImageStyleNumber(target, styleKey) {
   var imageChildSchema = findImageChildSchema(target);
   return parsePxNumber(imageChildSchema === null || imageChildSchema === void 0 ? void 0 : (_imageChildSchema$pro = imageChildSchema.props) === null || _imageChildSchema$pro === void 0 ? void 0 : (_imageChildSchema$pro2 = _imageChildSchema$pro.style) === null || _imageChildSchema$pro2 === void 0 ? void 0 : _imageChildSchema$pro2[styleKey]);
 };
+
+/**
+ * 异步写入 Image 子节点的 style，避免在 imgWidth/imgHeight.setValue 的同步执行栈内
+ * 触发引擎重评估 dataList.initialValue（会先清空 dataList prop，导致默认图覆盖绑定数据）。
+ * 通过 Promise.resolve().then() 将写入推迟到当前 settings 重评估完成后执行，
+ * 此时 dataList 已稳定为正确的 JSExpression，重评估无副作用。
+ */
 var syncImageStyleValue = function syncImageStyleValue(target, styleKey, value) {
-  var _extends3;
-  // 优先通过引擎节点 API 更新子节点 style，确保引擎感知变化（布局面板读取时可见）
-  var imageChildNode = findImageChildNode(target);
-  if (imageChildNode) {
-    var _imageChildNode$getPr3, _extends2, _imageChildNode$setPr;
-    var _currentStyle = ((_imageChildNode$getPr3 = imageChildNode.getPropValue) === null || _imageChildNode$getPr3 === void 0 ? void 0 : _imageChildNode$getPr3.call(imageChildNode, 'style')) || {};
-    // 同时确保 width/height 都存在于子节点 style 中，防止布局面板 replace 时丢失其中一个
-    var updatedStyle = (0, _extends4["default"])({}, _currentStyle, (_extends2 = {}, _extends2[styleKey] = value + "px", _extends2));
-    // 如果另一轴尺寸在子节点 style 中不存在，则从父级 prop 补充，保证两轴都写入
-    var otherKey = styleKey === 'width' ? 'height' : 'width';
-    if (!updatedStyle[otherKey]) {
-      var _target$getProps, _target$getProps$call, _target$getProps$call2;
-      var otherPropKey = otherKey === 'width' ? 'imgWidth' : 'imgHeight';
-      var otherPropValue = parsePxNumber(target === null || target === void 0 ? void 0 : (_target$getProps = target.getProps) === null || _target$getProps === void 0 ? void 0 : (_target$getProps$call = _target$getProps.call(target)) === null || _target$getProps$call === void 0 ? void 0 : (_target$getProps$call2 = _target$getProps$call.getPropValue) === null || _target$getProps$call2 === void 0 ? void 0 : _target$getProps$call2.call(_target$getProps$call, otherPropKey));
-      if (otherPropValue !== undefined) {
-        updatedStyle[otherKey] = otherPropValue + "px";
-      } else {
-        // 子节点 style 也没有，使用默认值 100
-        updatedStyle[otherKey] = '100px';
+  Promise.resolve().then(function () {
+    var _extends3;
+    // 优先通过引擎节点 API 更新子节点 style，确保引擎感知变化（布局面板读取时可见）
+    var imageChildNode = findImageChildNode(target);
+    if (imageChildNode) {
+      var _imageChildNode$getPr3, _extends2, _imageChildNode$setPr;
+      var _currentStyle = ((_imageChildNode$getPr3 = imageChildNode.getPropValue) === null || _imageChildNode$getPr3 === void 0 ? void 0 : _imageChildNode$getPr3.call(imageChildNode, 'style')) || {};
+      // 同时确保 width/height 都存在于子节点 style 中，防止布局面板 replace 时丢失其中一个
+      var updatedStyle = (0, _extends4["default"])({}, _currentStyle, (_extends2 = {}, _extends2[styleKey] = value + "px", _extends2));
+      // 如果另一轴尺寸在子节点 style 中不存在，则从父级 prop 补充，保证两轴都写入
+      var otherKey = styleKey === 'width' ? 'height' : 'width';
+      if (!updatedStyle[otherKey]) {
+        var _target$getProps, _target$getProps$call, _target$getProps$call2;
+        var otherPropKey = otherKey === 'width' ? 'imgWidth' : 'imgHeight';
+        var otherPropValue = parsePxNumber(target === null || target === void 0 ? void 0 : (_target$getProps = target.getProps) === null || _target$getProps === void 0 ? void 0 : (_target$getProps$call = _target$getProps.call(target)) === null || _target$getProps$call === void 0 ? void 0 : (_target$getProps$call2 = _target$getProps$call.getPropValue) === null || _target$getProps$call2 === void 0 ? void 0 : _target$getProps$call2.call(_target$getProps$call, otherPropKey));
+        if (otherPropValue !== undefined) {
+          updatedStyle[otherKey] = otherPropValue + "px";
+        } else {
+          // 子节点 style 也没有，使用默认值 100
+          updatedStyle[otherKey] = '100px';
+        }
       }
+      (_imageChildNode$setPr = imageChildNode.setPropValue) === null || _imageChildNode$setPr === void 0 ? void 0 : _imageChildNode$setPr.call(imageChildNode, 'style', updatedStyle);
+      return;
     }
-    (_imageChildNode$setPr = imageChildNode.setPropValue) === null || _imageChildNode$setPr === void 0 ? void 0 : _imageChildNode$setPr.call(imageChildNode, 'style', updatedStyle);
-    return;
-  }
-  // 降级：直接写 schema（引擎无法感知，但保留作为兜底）
-  var imageChildSchema = findImageChildSchema(target);
-  if (!imageChildSchema) {
-    return;
-  }
-  if (!imageChildSchema.props) {
-    imageChildSchema.props = {};
-  }
-  var currentStyle = imageChildSchema.props.style || {};
-  imageChildSchema.props.style = (0, _extends4["default"])({}, currentStyle, (_extends3 = {}, _extends3[styleKey] = value + "px", _extends3));
+    // 降级：直接写 schema（引擎无法感知，但保留作为兜底）
+    var imageChildSchema = findImageChildSchema(target);
+    if (!imageChildSchema) {
+      return;
+    }
+    if (!imageChildSchema.props) {
+      imageChildSchema.props = {};
+    }
+    var currentStyle = imageChildSchema.props.style || {};
+    imageChildSchema.props.style = (0, _extends4["default"])({}, currentStyle, (_extends3 = {}, _extends3[styleKey] = value + "px", _extends3));
+  });
 };
 var syncImageDimensionPropsFromChild = function syncImageDimensionPropsFromChild(target) {
   var _target$getProps2;
@@ -341,17 +350,11 @@ var TeletextListMeta = {
             return;
           }
           var props = target.getProps();
-          // 在任何 setPropValue 之前先写入模块级缓存（与 imagePlacement.setValue 同策略）
+          // 在写入前先更新模块级缓存，确保async syncImageStyleValue触发的重评估时缓存有效
           _cacheDataList(target);
-          // 快照需要保护的数据，防止 syncImageStyleValue → imageChildNode.setPropValue
-          // 触发引擎重评估 dataList.initialValue，导致 dataList 被重置为默认图
-          var prevDataList = props.getPropValue('dataList');
-          var prevDataListBind = props.getPropValue('dataListBind');
           props.setPropValue('imgWidth', parsedValue);
+          // syncImageStyleValue 异步执行，不在当前同步栈内触发 dataList.initialValue 重评估
           syncImageStyleValue(target, 'width', parsedValue);
-          // 还原被保护的数据（幂等操作，若引擎未重置则无副作用）
-          if (prevDataList !== undefined) props.setPropValue('dataList', prevDataList);
-          if (prevDataListBind !== undefined) props.setPropValue('dataListBind', prevDataListBind);
         }
       }
     }, {
@@ -412,17 +415,11 @@ var TeletextListMeta = {
             return;
           }
           var props = target.getProps();
-          // 在任何 setPropValue 之前先写入模块级缓存（与 imagePlacement.setValue 同策略）
+          // 在写入前先更新模块级缓存，确保async syncImageStyleValue触发的重评估时缓存有效
           _cacheDataList(target);
-          // 快照需要保护的数据，防止 syncImageStyleValue → imageChildNode.setPropValue
-          // 触发引擎重评估 dataList.initialValue，导致 dataList 被重置为默认图
-          var prevDataList = props.getPropValue('dataList');
-          var prevDataListBind = props.getPropValue('dataListBind');
           props.setPropValue('imgHeight', parsedValue);
+          // syncImageStyleValue 异步执行，不在当前同步栈内触发 dataList.initialValue 重评估
           syncImageStyleValue(target, 'height', parsedValue);
-          // 还原被保护的数据（幂等操作，若引擎未重置则无副作用）
-          if (prevDataList !== undefined) props.setPropValue('dataList', prevDataList);
-          if (prevDataListBind !== undefined) props.setPropValue('dataListBind', prevDataListBind);
         }
       }
     }, {
@@ -898,16 +895,22 @@ var TeletextListMeta = {
           // 2. 模块级 WeakMap 缓存（在任何 setPropValue 之前写入，完全不受引擎清空影响）
           // 3. settings API（重评估中间态下可能已清空，作为最后手段）
           // 4. 默认占位数据（仅首次创建组件时触达）
+          //
+          // 关键防御：一旦组件已绑定数据源（缓存或 node 中有值），
+          // 无论是哪种场景的 initialValue 调用，都必须返回已有值而不是默认数组。
+          // syncImageStyleValue 改为异步后，通常 node.getPropValue 已能拿到正确值；
+          // 缓存作为最后一道防线，彻底切断默认数组覆盖绑定表达式的可能。
           var node = target === null || target === void 0 ? void 0 : target.node;
+          // 优先读缓存：即使 node.getPropValue 暂时处于中间态，缓存也能提供可靠值
+          var cached = node ? _nodeDataListCache.get(node) : undefined;
           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;
           }
-          // node.getPropValue 返回 undefined：引擎已在调用 initialValue 前清空 node prop
+          // node.getPropValue 返回 undefined：引擎可能已在调用 initialValue 前清空 node prop
           // → 读取模块级缓存（在 setValue 中任何 setPropValue 之前写入，最可靠的后备）
-          var cached = node ? _nodeDataListCache.get(node) : undefined;
           if (cached !== undefined) {
             return cached;
           }
@@ -958,20 +961,34 @@ var TeletextListMeta = {
           return cached; // undefined 仅在缓存为空（全新组件首次初始化）时出现，属正常情况
         },
         /**
-         * 自定义 setValue：用户每次编辑 dataList 条目时即时更新 WeakMap 缓存。
-         * 这是保证缓存与用户实际数据保持同步的关键——之前缓存只在
-         * imgWidth/imgHeight/imagePlacement.setValue 中写入，用户直接编辑 dataList
-         * 时缓存一直停留在初始默认值，导致 margin 修改时从缓存取出默认图数组。
+         * 自定义 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: function setValue(target, value) {
           var node = target === null || target === void 0 ? void 0 : target.node;
           if (!node) return;
           if (value !== undefined) {
+            var _target$getProps10, _target$getProps10$ca, _target$getProps10$ca2;
+            // 先写缓存，确保重评估期间 getValue 可从缓存返回有效值
             _nodeDataListCache.set(node, value);
+            // 再持久化到 schema（引擎不会自动写入，必须显式调用）
+            (_target$getProps10 = target.getProps) === null || _target$getProps10 === void 0 ? void 0 : (_target$getProps10$ca = _target$getProps10.call(target)) === null || _target$getProps10$ca === void 0 ? void 0 : (_target$getProps10$ca2 = _target$getProps10$ca.setPropValue) === null || _target$getProps10$ca2 === void 0 ? void 0 : _target$getProps10$ca2.call(_target$getProps10$ca, 'dataList', value);
           } else {
+            var _target$getProps11, _target$getProps11$ca, _target$getProps11$ca2;
             // clearValue 场景（value = undefined）：清空缓存，使下次 initDefaultValue
             // 可正常返回默认数组（仅用于组件被显式清除数据的情况）
             _nodeDataListCache["delete"](node);
+            (_target$getProps11 = target.getProps) === null || _target$getProps11 === void 0 ? void 0 : (_target$getProps11$ca = _target$getProps11.call(target)) === null || _target$getProps11$ca === void 0 ? void 0 : (_target$getProps11$ca2 = _target$getProps11$ca.setPropValue) === null || _target$getProps11$ca2 === void 0 ? void 0 : _target$getProps11$ca2.call(_target$getProps11$ca, 'dataList', undefined);
           }
         }
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dckj-npm/dc-material",
-  "version": "0.1.370",
+  "version": "0.1.372",
   "description": "dc低代码物料",
   "main": "lib/index.js",
   "module": "es/index.js",
@@ -114,10 +114,10 @@
   },
   "componentConfig": {
     "isComponentLibrary": true,
-    "materialSchema": "https://unpkg.com/@dckj-npm/dc-material@0.1.370/build/lowcode/assets-prod.json"
+    "materialSchema": "https://unpkg.com/@dckj-npm/dc-material@0.1.372/build/lowcode/assets-prod.json"
   },
   "lcMeta": {
     "type": "component"
   },
-  "homepage": "https://unpkg.com/@dckj-npm/dc-material@0.1.370/build/index.html"
+  "homepage": "https://unpkg.com/@dckj-npm/dc-material@0.1.372/build/index.html"
 }