@sheinx/hooks 3.9.13 → 3.9.14-beta.10

package/cjs/common/use-click-away/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAa,MAAM,OAAO,CAAC;AAI7C,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAElD,MAAM,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;AACnD,wBAAgB,YAAY,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,EAAE,MAAM,EAAE;IAE5D,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAE9B,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;CAC/B,QAqCA;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAa,MAAM,OAAO,CAAC;AAI7C,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAElD,MAAM,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;AACnD,wBAAgB,YAAY,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,EAAE,MAAM,EAAE;IAE5D,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAE9B,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;CAC/B,QAsCA;AAED,eAAe,YAAY,CAAC"}

package/cjs/common/use-click-away/index.js

@@ -22,10 +22,13 @@ function useClickAway(params) {
   });
   var target = Array.isArray(t) ? t : [t];
   var handleClickAway = (0, _usePersistFn.default)(function (event) {
-    // @ts-ignore
+    var _composedPath, _composedPath2, _ref;
+    // composedPath() 兼容 Shadow DOM，包含事件传播路径上的所有元素
+    var path = (_composedPath = (_composedPath2 = (_ref = event).composedPath) === null || _composedPath2 === void 0 ? void 0 : _composedPath2.call(_ref)) !== null && _composedPath !== void 0 ? _composedPath : [event.target];
     if (target.findIndex(function (t) {
-      var _t$current;
-      return (_t$current = t.current) === null || _t$current === void 0 ? void 0 : _t$current.contains(event.target);
+      return t.current && path.some(function (n) {
+        return n instanceof Node && t.current.contains(n);
+      });
     }) > -1) {
       return;
     }

package/cjs/common/use-list-select/use-list-select-multiple.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-list-select-multiple.d.ts","sourceRoot":"","sources":["use-list-select-multiple.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAMtE,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;sDA6MK;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;;;;4BAjNzB,GAAG;;qCA6PqB,MAAM;;CAoC5D,CAAC;AAEF,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"use-list-select-multiple.d.ts","sourceRoot":"","sources":["use-list-select-multiple.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAMtE,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;sDA6MK;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;;;;4BAjNzB,GAAG;;qCAwQqB,MAAM;;CAoC5D,CAAC;AAEF,eAAe,qBAAqB,CAAC"}

package/cjs/common/use-list-select/use-list-select-multiple.js

@@ -241,11 +241,22 @@ var useListSelectMultiple = function useListSelectMultiple(props) {
         for (var j = 0; j < raws.length; j++) {
           var _item2 = raws[j];
           if (props.prediction(values[_i], _item2)) {
+            if (props.keepCache) context.valueDataCache.set(values[_i], _item2);
             result.push(_item2);
             raws.splice(j, 1);
             continue outer;
           }
         }
+        // 当前 data 找不到，从 valueDataCache 中回退匹配
+        if (props.keepCache && context.valueDataCache) {
+          var cacheValues = Array.from(context.valueDataCache.values());
+          for (var k = 0; k < cacheValues.length; k++) {
+            if (props.prediction(values[_i], cacheValues[k])) {
+              result.push(cacheValues[k]);
+              continue outer;
+            }
+          }
+        }
         result.push({
           IS_NOT_MATCHED_VALUE: true,
           value: values[_i]

package/cjs/components/use-form/use-form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-form.d.ts","sourceRoot":"","sources":["use-form.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AA4BtE,OAAO,EAEL,aAAa,EACb,YAAY,EACZ,gBAAgB,EAGhB,gBAAgB,EAEjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAe,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAI5D,QAAA,MAAM,OAAO;;;;;;;;;wBAuTC;gBAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;gBAAC,WAAW,CAAC,EAAE,OAAO,CAAA;aAAE;8BArQnB,MAAM;oCAoVD,OAAO,aAAoB,MAAM,IAAI;;6BAf3C,MAAM,KAAK,KAAK,GAAG,SAAS;;oCAdrB,MAAM,EAAE;sCA/SxC,MAAM,GAAG,MAAM,EAAE,WAAU,gBAAgB;qCA+WvB,MAAM,WAAW,gBAAgB;gCA7CzB,MAAM,SAAS,MAAM,UAAU,KAAK;gCAKpC,MAAM,SAAS,MAAM;kCAzJpD,MAAM,0BAAyB,qBAAqB;;;;;;;;oBA+EjD;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,WAAW,CAAC,EAAE,OAAO,CAAA;SAAE;0BArQnB,MAAM;gCAoVD,OAAO,aAAoB,MAAM,IAAI;;yBAf3C,MAAM,KAAK,KAAK,GAAG,SAAS;;gCAdrB,MAAM,EAAE;kCA/SxC,MAAM,GAAG,MAAM,EAAE,WAAU,gBAAgB;iCA+WvB,MAAM,WAAW,gBAAgB;4BA7CzB,MAAM,SAAS,MAAM,UAAU,KAAK;4BAKpC,MAAM,SAAS,MAAM;8BAzJpD,MAAM,0BAAyB,qBAAqB;;;CA+b9D,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"use-form.d.ts","sourceRoot":"","sources":["use-form.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AA6BtE,OAAO,EAEL,aAAa,EACb,YAAY,EACZ,gBAAgB,EAGhB,gBAAgB,EAEjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAe,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAI5D,QAAA,MAAM,OAAO;;;;;;;;;wBAuTC;gBAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;gBAAC,WAAW,CAAC,EAAE,OAAO,CAAA;aAAE;8BArQnB,MAAM;oCAsVD,OAAO,aAAoB,MAAM,IAAI;;6BAf3C,MAAM,KAAK,KAAK,GAAG,SAAS;;oCAdrB,MAAM,EAAE;sCAjTxC,MAAM,GAAG,MAAM,EAAE,WAAU,gBAAgB;qCAiXvB,MAAM,WAAW,gBAAgB;gCA7CzB,MAAM,SAAS,MAAM,UAAU,KAAK;gCAKpC,MAAM,SAAS,MAAM;kCA3JpD,MAAM,0BAAyB,qBAAqB;;;;;;;;oBA+EjD;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,WAAW,CAAC,EAAE,OAAO,CAAA;SAAE;0BArQnB,MAAM;gCAsVD,OAAO,aAAoB,MAAM,IAAI;;yBAf3C,MAAM,KAAK,KAAK,GAAG,SAAS;;gCAdrB,MAAM,EAAE;kCAjTxC,MAAM,GAAG,MAAM,EAAE,WAAU,gBAAgB;iCAiXvB,MAAM,WAAW,gBAAgB;4BA7CzB,MAAM,SAAS,MAAM,UAAU,KAAK;4BAKpC,MAAM,SAAS,MAAM;8BA3JpD,MAAM,0BAAyB,qBAAqB;;;CAic9D,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/cjs/components/use-form/use-form.js

@@ -28,6 +28,7 @@ function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol"
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 var globalKey = '__global__&&@@';
 var SUBMIT_TIMEOUT = 10;
+var RESET_TIMEOUT = 500;
 var emptyObj = {};
 var useForm = function useForm(props) {
   var _props$defaultValue = props.defaultValue,
@@ -324,6 +325,8 @@ var useForm = function useForm(props) {
     var option = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {
       validate: false
     };
+    // 重置保护期内（500ms），忽略子组件延迟 onChange 写回的旧值
+    if (context.resetTime && Date.now() - context.resetTime < RESET_TIMEOUT) return;
     onChange(function (draft) {
       var values = Object.keys(vals);
       // 针对 name 为数组模式，如 datepicker 的 name={['startTime', 'endTime']} 时，前者校验可能需要依赖后者，因此需要提前将后者数据整合至 draft 用于多字段整合校验
@@ -491,7 +494,7 @@ var useForm = function useForm(props) {
       onChange(getDefaultValue());
       clearValidate();
       update();
-      context.resetTime = 1;
+      context.resetTime = Date.now();
       (_props$onReset = props.onReset) === null || _props$onReset === void 0 || _props$onReset.call(props);
       other === null || other === void 0 || (_other$onReset = other.onReset) === null || _other$onReset === void 0 || _other$onReset.call(other, e);
     };

package/cjs/components/use-input/use-input-number.d.ts

@@ -3,6 +3,7 @@ import { InputNumberProps } from './use-input-number.type';
 declare const useNumberFormat: (props: InputNumberProps) => {
     onPlus: () => void;
     onMinus: () => void;
+    onClear: () => void;
     onChange: (v: string | undefined) => void;
     onBlur: (e: React.FocusEvent<HTMLInputElement, Element>) => void;
     onFocus: (e: React.FocusEvent<HTMLInputElement, Element>) => void;

package/cjs/components/use-input/use-input-number.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-input-number.d.ts","sourceRoot":"","sources":["use-input-number.ts"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAK3D,QAAA,MAAM,eAAe,UAAW,gBAAgB;;;;;;;;CA2L/C,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"use-input-number.d.ts","sourceRoot":"","sources":["use-input-number.ts"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAK3D,QAAA,MAAM,eAAe,UAAW,gBAAgB;;;;;;;;;CAiM/C,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/cjs/components/use-input/use-input-number.js

@@ -34,6 +34,7 @@ var useNumberFormat = function useNumberFormat(props) {
     min = props.min,
     max = props.max,
     allowNull = props.allowNull,
+    clearToUndefined = props.clearToUndefined,
     _props$step = props.step,
     step = _props$step === void 0 ? 1 : _props$step,
     cancelBlurChange = props.cancelBlurChange,
@@ -54,10 +55,9 @@ var useNumberFormat = function useNumberFormat(props) {
     setInternalInputValue = _React$useState2[1];
   var focusedRef = _react.default.useRef(false);
   (0, _react.useEffect)(function () {
-    // 聚焦编辑期间不同步外部值，避免 form 回填 defaultValue 覆盖用户输入
-    // 但当外部值被清空时(如 clearable 触发)，即使聚焦也需要同步
-    if (props.value !== inernalInputValue && (!focusedRef.current || props.value == null || props.value === '')) {
-      setInternalInputValue(getStringValue(props.value));
+    var stringValue = getStringValue(props.value);
+    if (stringValue !== inernalInputValue && (!focusedRef.current || props.value == null)) {
+      setInternalInputValue(stringValue);
     }
   }, [props.value]);
   var getNumberValue = function getNumberValue(value) {
@@ -183,6 +183,10 @@ var useNumberFormat = function useNumberFormat(props) {
     var num = changeValue(-step);
     if (num !== undefined) setInternalInputValue(getStringValue(num));
   });
+  var handleClear = (0, _usePersistFn.default)(function () {
+    setInternalInputValue('');
+    onChange === null || onChange === void 0 || onChange(clearToUndefined ? undefined : allowNull ? null : '');
+  });
   return _objectSpread(_objectSpread({}, (0, _useInputFormat.default)({
     value: inernalInputValue,
     type: 'number',
@@ -196,7 +200,8 @@ var useNumberFormat = function useNumberFormat(props) {
     cancelBlurChange: true
   })), {}, {
     onPlus: handlePlus,
-    onMinus: handleMinus
+    onMinus: handleMinus,
+    onClear: handleClear
   });
 };
 var _default = exports.default = useNumberFormat;

package/cjs/components/use-input/use-input-number.type.d.ts

@@ -23,6 +23,7 @@ export interface InputNumberProps extends Omit<InputFormatProps, 'value' | 'onCh
      * @cn 清空后值为 null
      */
     allowNull?: boolean;
+    clearToUndefined?: boolean;
     /**
      * @en Change the digital span. It can be decimal
      * @cn 改变数字跨度，可为小数

package/cjs/components/use-input/use-input-number.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-input-number.type.d.ts","sourceRoot":"","sources":["use-input-number.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;AAC7D,MAAM,WAAW,gBACf,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAClF,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,SAAS,CAAC;IACnD;;;OAGG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}
+{"version":3,"file":"use-input-number.type.d.ts","sourceRoot":"","sources":["use-input-number.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;AAC7D,MAAM,WAAW,gBACf,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAClF,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,SAAS,CAAC;IACnD;;;OAGG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/cjs/components/use-table/use-table-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-table-layout.d.ts","sourceRoot":"","sources":["use-table-layout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAKlE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA0CrE,MAAM,WAAW,mBACf,SAAQ,IAAI,CACV,cAAc,CAAC,GAAG,CAAC,EACnB,MAAM,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,OAAO,CAC7E;IACD,OAAO,EAAE,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;IAClC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACvC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACvC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,QAAA,MAAM,cAAc,UAAW,mBAAmB;;;;;;;;;;;yBA+CX,MAAM,UAAU,MAAM;;;;;;;CA+O5D,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"use-table-layout.d.ts","sourceRoot":"","sources":["use-table-layout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAKlE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA0CrE,MAAM,WAAW,mBACf,SAAQ,IAAI,CACV,cAAc,CAAC,GAAG,CAAC,EACnB,MAAM,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,OAAO,CAC7E;IACD,OAAO,EAAE,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;IAClC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACvC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACvC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,QAAA,MAAM,cAAc,UAAW,mBAAmB;;;;;;;;;;;yBA+CX,MAAM,UAAU,MAAM;;;;;;;CA2R5D,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/cjs/components/use-table/use-table-layout.js

@@ -180,7 +180,20 @@ var useTableLayout = function useTableLayout(props) {
     if (cols && cols.every(function (v) {
       return v === 0;
     })) return;
-    setColgroup(shiftDecimalToLastColumn(cols));
+    var shifted = shiftDecimalToLastColumn(cols);
+    // 当 colgroup 中存在 undefined（说明从未被成功测量过），跳过相等判断，强制触发重新测量
+    // 场景：Table 在 display:none 容器中挂载时 getColgroup 测量失败，
+    // 后续 resetColGroup 产出值与初始值相同会被跳过，导致未设 width 的列永远无法获得实际宽度
+    var hasUndefined = shifted.some(function (v) {
+      return v === undefined;
+    });
+    // 值未变化时跳过，避免触发不必要的 useLayoutEffect
+    if (!hasUndefined && colgroup && shifted.length === colgroup.length && shifted.every(function (v, i) {
+      return v === colgroup[i];
+    })) {
+      return;
+    }
+    setColgroup(shifted);
     setAdjust(adjust);
     if (!adjust) {
       updateResizeFlag();
@@ -234,8 +247,7 @@ var useTableLayout = function useTableLayout(props) {
     var index = 0;
     var sum = 0;
     var _loop = function _loop() {
-      var _items$i$getBoundingC = items[i].getBoundingClientRect(),
-        width = _items$i$getBoundingC.width;
+      var width = items[i].offsetWidth;
       sum += width;
       var colspan = items[i].getAttribute('colspan');
       var colspanNum = parseInt(colspan || '1', 10);
@@ -363,6 +375,32 @@ var useTableLayout = function useTableLayout(props) {
       (_cancelFunc = cancelFunc) === null || _cancelFunc === void 0 || _cancelFunc();
     };
   }, [scrollRef.current]);
+
+  // 当祖先元素的 CSS 动画结束时（如 Modal 入场动画），重新测量列宽
+  // 解决 Table 在动画容器（如 Modal）中渲染时，动画期间测量的列宽不准确导致 sticky 表头与表体列宽错位的问题
+  (0, _react.useEffect)(function () {
+    var scrollEl = scrollRef.current;
+    if (!scrollEl) return;
+
+    // 查找最近的 fixed 定位祖先（如 Modal wrapper），仅在该元素上监听动画结束
+    var fixedAncestor = null;
+    var parent = scrollEl.parentElement;
+    while (parent) {
+      if (window.getComputedStyle(parent).position === 'fixed') {
+        fixedAncestor = parent;
+        break;
+      }
+      parent = parent.parentElement;
+    }
+    if (!fixedAncestor) return;
+    var handleAnimationEnd = function handleAnimationEnd() {
+      getColgroup(false);
+    };
+    fixedAncestor.addEventListener('animationend', handleAnimationEnd);
+    return function () {
+      fixedAncestor.removeEventListener('animationend', handleAnimationEnd);
+    };
+  }, [scrollRef.current]);
   (0, _react.useLayoutEffect)(function () {
     if (adjust) {
       getColgroup(adjust === 'drag');

package/esm/common/use-click-away/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAa,MAAM,OAAO,CAAC;AAI7C,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAElD,MAAM,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;AACnD,wBAAgB,YAAY,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,EAAE,MAAM,EAAE;IAE5D,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAE9B,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;CAC/B,QAqCA;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAa,MAAM,OAAO,CAAC;AAI7C,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAElD,MAAM,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;AACnD,wBAAgB,YAAY,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,EAAE,MAAM,EAAE;IAE5D,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAE9B,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;CAC/B,QAsCA;AAED,eAAe,YAAY,CAAC"}

package/esm/common/use-click-away/index.js

@@ -14,10 +14,13 @@ export function useClickAway(params) {
   });
   var target = Array.isArray(t) ? t : [t];
   var handleClickAway = usePersistFn(function (event) {
-    // @ts-ignore
+    var _composedPath, _composedPath2, _ref;
+    // composedPath() 兼容 Shadow DOM，包含事件传播路径上的所有元素
+    var path = (_composedPath = (_composedPath2 = (_ref = event).composedPath) === null || _composedPath2 === void 0 ? void 0 : _composedPath2.call(_ref)) !== null && _composedPath !== void 0 ? _composedPath : [event.target];
     if (target.findIndex(function (t) {
-      var _t$current;
-      return (_t$current = t.current) === null || _t$current === void 0 ? void 0 : _t$current.contains(event.target);
+      return t.current && path.some(function (n) {
+        return n instanceof Node && t.current.contains(n);
+      });
     }) > -1) {
       return;
     }

package/esm/common/use-list-select/use-list-select-multiple.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-list-select-multiple.d.ts","sourceRoot":"","sources":["use-list-select-multiple.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAMtE,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;sDA6MK;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;;;;4BAjNzB,GAAG;;qCA6PqB,MAAM;;CAoC5D,CAAC;AAEF,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"use-list-select-multiple.d.ts","sourceRoot":"","sources":["use-list-select-multiple.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAMtE,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;sDA6MK;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;;;;4BAjNzB,GAAG;;qCAwQqB,MAAM;;CAoC5D,CAAC;AAEF,eAAe,qBAAqB,CAAC"}

package/esm/common/use-list-select/use-list-select-multiple.js

@@ -231,11 +231,22 @@ var useListSelectMultiple = function useListSelectMultiple(props) {
         for (var j = 0; j < raws.length; j++) {
           var _item2 = raws[j];
           if (props.prediction(values[_i], _item2)) {
+            if (props.keepCache) context.valueDataCache.set(values[_i], _item2);
             result.push(_item2);
             raws.splice(j, 1);
             continue outer;
           }
         }
+        // 当前 data 找不到，从 valueDataCache 中回退匹配
+        if (props.keepCache && context.valueDataCache) {
+          var cacheValues = Array.from(context.valueDataCache.values());
+          for (var k = 0; k < cacheValues.length; k++) {
+            if (props.prediction(values[_i], cacheValues[k])) {
+              result.push(cacheValues[k]);
+              continue outer;
+            }
+          }
+        }
         result.push({
           IS_NOT_MATCHED_VALUE: true,
           value: values[_i]

package/esm/components/use-form/use-form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-form.d.ts","sourceRoot":"","sources":["use-form.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AA4BtE,OAAO,EAEL,aAAa,EACb,YAAY,EACZ,gBAAgB,EAGhB,gBAAgB,EAEjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAe,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAI5D,QAAA,MAAM,OAAO;;;;;;;;;wBAuTC;gBAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;gBAAC,WAAW,CAAC,EAAE,OAAO,CAAA;aAAE;8BArQnB,MAAM;oCAoVD,OAAO,aAAoB,MAAM,IAAI;;6BAf3C,MAAM,KAAK,KAAK,GAAG,SAAS;;oCAdrB,MAAM,EAAE;sCA/SxC,MAAM,GAAG,MAAM,EAAE,WAAU,gBAAgB;qCA+WvB,MAAM,WAAW,gBAAgB;gCA7CzB,MAAM,SAAS,MAAM,UAAU,KAAK;gCAKpC,MAAM,SAAS,MAAM;kCAzJpD,MAAM,0BAAyB,qBAAqB;;;;;;;;oBA+EjD;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,WAAW,CAAC,EAAE,OAAO,CAAA;SAAE;0BArQnB,MAAM;gCAoVD,OAAO,aAAoB,MAAM,IAAI;;yBAf3C,MAAM,KAAK,KAAK,GAAG,SAAS;;gCAdrB,MAAM,EAAE;kCA/SxC,MAAM,GAAG,MAAM,EAAE,WAAU,gBAAgB;iCA+WvB,MAAM,WAAW,gBAAgB;4BA7CzB,MAAM,SAAS,MAAM,UAAU,KAAK;4BAKpC,MAAM,SAAS,MAAM;8BAzJpD,MAAM,0BAAyB,qBAAqB;;;CA+b9D,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"use-form.d.ts","sourceRoot":"","sources":["use-form.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AA6BtE,OAAO,EAEL,aAAa,EACb,YAAY,EACZ,gBAAgB,EAGhB,gBAAgB,EAEjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAe,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAI5D,QAAA,MAAM,OAAO;;;;;;;;;wBAuTC;gBAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;gBAAC,WAAW,CAAC,EAAE,OAAO,CAAA;aAAE;8BArQnB,MAAM;oCAsVD,OAAO,aAAoB,MAAM,IAAI;;6BAf3C,MAAM,KAAK,KAAK,GAAG,SAAS;;oCAdrB,MAAM,EAAE;sCAjTxC,MAAM,GAAG,MAAM,EAAE,WAAU,gBAAgB;qCAiXvB,MAAM,WAAW,gBAAgB;gCA7CzB,MAAM,SAAS,MAAM,UAAU,KAAK;gCAKpC,MAAM,SAAS,MAAM;kCA3JpD,MAAM,0BAAyB,qBAAqB;;;;;;;;oBA+EjD;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,WAAW,CAAC,EAAE,OAAO,CAAA;SAAE;0BArQnB,MAAM;gCAsVD,OAAO,aAAoB,MAAM,IAAI;;yBAf3C,MAAM,KAAK,KAAK,GAAG,SAAS;;gCAdrB,MAAM,EAAE;kCAjTxC,MAAM,GAAG,MAAM,EAAE,WAAU,gBAAgB;iCAiXvB,MAAM,WAAW,gBAAgB;4BA7CzB,MAAM,SAAS,MAAM,UAAU,KAAK;4BAKpC,MAAM,SAAS,MAAM;8BA3JpD,MAAM,0BAAyB,qBAAqB;;;CAic9D,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/esm/components/use-form/use-form.js

@@ -17,6 +17,7 @@ import { usePrevious } from "../../common/use-default-value";
 import { SchemaBuilder } from "./use-form-schema/form-schema-builder";
 var globalKey = '__global__&&@@';
 var SUBMIT_TIMEOUT = 10;
+var RESET_TIMEOUT = 500;
 import { current, produce } from "../../utils/immer";
 import { deepGet, deepRemove, deepSet, docScroll, extractEventHandlers, isArray, isObject, shallowEqual, wrapFormError, deepClone, getAllKeyPaths, getParentKeys, getCompleteFieldKeys, devUseWarning, getFieldId, getClosestScrollContainer } from "../../utils";
 var emptyObj = {};
@@ -315,6 +316,8 @@ var useForm = function useForm(props) {
     var option = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {
       validate: false
     };
+    // 重置保护期内（500ms），忽略子组件延迟 onChange 写回的旧值
+    if (context.resetTime && Date.now() - context.resetTime < RESET_TIMEOUT) return;
     onChange(function (draft) {
       var values = Object.keys(vals);
       // 针对 name 为数组模式，如 datepicker 的 name={['startTime', 'endTime']} 时，前者校验可能需要依赖后者，因此需要提前将后者数据整合至 draft 用于多字段整合校验
@@ -482,7 +485,7 @@ var useForm = function useForm(props) {
       onChange(getDefaultValue());
       clearValidate();
       update();
-      context.resetTime = 1;
+      context.resetTime = Date.now();
       (_props$onReset = props.onReset) === null || _props$onReset === void 0 || _props$onReset.call(props);
       other === null || other === void 0 || (_other$onReset = other.onReset) === null || _other$onReset === void 0 || _other$onReset.call(other, e);
     };

package/esm/components/use-input/use-input-number.d.ts

@@ -3,6 +3,7 @@ import { InputNumberProps } from './use-input-number.type';
 declare const useNumberFormat: (props: InputNumberProps) => {
     onPlus: () => void;
     onMinus: () => void;
+    onClear: () => void;
     onChange: (v: string | undefined) => void;
     onBlur: (e: React.FocusEvent<HTMLInputElement, Element>) => void;
     onFocus: (e: React.FocusEvent<HTMLInputElement, Element>) => void;

package/esm/components/use-input/use-input-number.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-input-number.d.ts","sourceRoot":"","sources":["use-input-number.ts"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAK3D,QAAA,MAAM,eAAe,UAAW,gBAAgB;;;;;;;;CA2L/C,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"use-input-number.d.ts","sourceRoot":"","sources":["use-input-number.ts"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAK3D,QAAA,MAAM,eAAe,UAAW,gBAAgB;;;;;;;;;CAiM/C,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/esm/components/use-input/use-input-number.js

@@ -25,6 +25,7 @@ var useNumberFormat = function useNumberFormat(props) {
     min = props.min,
     max = props.max,
     allowNull = props.allowNull,
+    clearToUndefined = props.clearToUndefined,
     _props$step = props.step,
     step = _props$step === void 0 ? 1 : _props$step,
     cancelBlurChange = props.cancelBlurChange,
@@ -45,10 +46,9 @@ var useNumberFormat = function useNumberFormat(props) {
     setInternalInputValue = _React$useState2[1];
   var focusedRef = React.useRef(false);
   useEffect(function () {
-    // 聚焦编辑期间不同步外部值，避免 form 回填 defaultValue 覆盖用户输入
-    // 但当外部值被清空时(如 clearable 触发)，即使聚焦也需要同步
-    if (props.value !== inernalInputValue && (!focusedRef.current || props.value == null || props.value === '')) {
-      setInternalInputValue(getStringValue(props.value));
+    var stringValue = getStringValue(props.value);
+    if (stringValue !== inernalInputValue && (!focusedRef.current || props.value == null)) {
+      setInternalInputValue(stringValue);
     }
   }, [props.value]);
   var getNumberValue = function getNumberValue(value) {
@@ -174,6 +174,10 @@ var useNumberFormat = function useNumberFormat(props) {
     var num = changeValue(-step);
     if (num !== undefined) setInternalInputValue(getStringValue(num));
   });
+  var handleClear = usePersistFn(function () {
+    setInternalInputValue('');
+    onChange === null || onChange === void 0 || onChange(clearToUndefined ? undefined : allowNull ? null : '');
+  });
   return _objectSpread(_objectSpread({}, useInputFormat({
     value: inernalInputValue,
     type: 'number',
@@ -187,7 +191,8 @@ var useNumberFormat = function useNumberFormat(props) {
     cancelBlurChange: true
   })), {}, {
     onPlus: handlePlus,
-    onMinus: handleMinus
+    onMinus: handleMinus,
+    onClear: handleClear
   });
 };
 export default useNumberFormat;

package/esm/components/use-input/use-input-number.type.d.ts

@@ -23,6 +23,7 @@ export interface InputNumberProps extends Omit<InputFormatProps, 'value' | 'onCh
      * @cn 清空后值为 null
      */
     allowNull?: boolean;
+    clearToUndefined?: boolean;
     /**
      * @en Change the digital span. It can be decimal
      * @cn 改变数字跨度，可为小数

package/esm/components/use-input/use-input-number.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-input-number.type.d.ts","sourceRoot":"","sources":["use-input-number.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;AAC7D,MAAM,WAAW,gBACf,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAClF,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,SAAS,CAAC;IACnD;;;OAGG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}
+{"version":3,"file":"use-input-number.type.d.ts","sourceRoot":"","sources":["use-input-number.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;AAC7D,MAAM,WAAW,gBACf,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAClF,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,SAAS,CAAC;IACnD;;;OAGG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/esm/components/use-table/use-table-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-table-layout.d.ts","sourceRoot":"","sources":["use-table-layout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAKlE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA0CrE,MAAM,WAAW,mBACf,SAAQ,IAAI,CACV,cAAc,CAAC,GAAG,CAAC,EACnB,MAAM,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,OAAO,CAC7E;IACD,OAAO,EAAE,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;IAClC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACvC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACvC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,QAAA,MAAM,cAAc,UAAW,mBAAmB;;;;;;;;;;;yBA+CX,MAAM,UAAU,MAAM;;;;;;;CA+O5D,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"use-table-layout.d.ts","sourceRoot":"","sources":["use-table-layout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAKlE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA0CrE,MAAM,WAAW,mBACf,SAAQ,IAAI,CACV,cAAc,CAAC,GAAG,CAAC,EACnB,MAAM,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,OAAO,CAC7E;IACD,OAAO,EAAE,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;IAClC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACvC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACvC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,QAAA,MAAM,cAAc,UAAW,mBAAmB;;;;;;;;;;;yBA+CX,MAAM,UAAU,MAAM;;;;;;;CA2R5D,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/esm/components/use-table/use-table-layout.js

@@ -171,7 +171,20 @@ var useTableLayout = function useTableLayout(props) {
     if (cols && cols.every(function (v) {
       return v === 0;
     })) return;
-    setColgroup(shiftDecimalToLastColumn(cols));
+    var shifted = shiftDecimalToLastColumn(cols);
+    // 当 colgroup 中存在 undefined（说明从未被成功测量过），跳过相等判断，强制触发重新测量
+    // 场景：Table 在 display:none 容器中挂载时 getColgroup 测量失败，
+    // 后续 resetColGroup 产出值与初始值相同会被跳过，导致未设 width 的列永远无法获得实际宽度
+    var hasUndefined = shifted.some(function (v) {
+      return v === undefined;
+    });
+    // 值未变化时跳过，避免触发不必要的 useLayoutEffect
+    if (!hasUndefined && colgroup && shifted.length === colgroup.length && shifted.every(function (v, i) {
+      return v === colgroup[i];
+    })) {
+      return;
+    }
+    setColgroup(shifted);
     setAdjust(adjust);
     if (!adjust) {
       updateResizeFlag();
@@ -225,8 +238,7 @@ var useTableLayout = function useTableLayout(props) {
     var index = 0;
     var sum = 0;
     var _loop = function _loop() {
-      var _items$i$getBoundingC = items[i].getBoundingClientRect(),
-        width = _items$i$getBoundingC.width;
+      var width = items[i].offsetWidth;
       sum += width;
       var colspan = items[i].getAttribute('colspan');
       var colspanNum = parseInt(colspan || '1', 10);
@@ -354,6 +366,32 @@ var useTableLayout = function useTableLayout(props) {
       (_cancelFunc = cancelFunc) === null || _cancelFunc === void 0 || _cancelFunc();
     };
   }, [scrollRef.current]);
+
+  // 当祖先元素的 CSS 动画结束时（如 Modal 入场动画），重新测量列宽
+  // 解决 Table 在动画容器（如 Modal）中渲染时，动画期间测量的列宽不准确导致 sticky 表头与表体列宽错位的问题
+  useEffect(function () {
+    var scrollEl = scrollRef.current;
+    if (!scrollEl) return;
+
+    // 查找最近的 fixed 定位祖先（如 Modal wrapper），仅在该元素上监听动画结束
+    var fixedAncestor = null;
+    var parent = scrollEl.parentElement;
+    while (parent) {
+      if (window.getComputedStyle(parent).position === 'fixed') {
+        fixedAncestor = parent;
+        break;
+      }
+      parent = parent.parentElement;
+    }
+    if (!fixedAncestor) return;
+    var handleAnimationEnd = function handleAnimationEnd() {
+      getColgroup(false);
+    };
+    fixedAncestor.addEventListener('animationend', handleAnimationEnd);
+    return function () {
+      fixedAncestor.removeEventListener('animationend', handleAnimationEnd);
+    };
+  }, [scrollRef.current]);
   useLayoutEffect(function () {
     if (adjust) {
       getColgroup(adjust === 'drag');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sheinx/hooks",
-  "version": "3.9.13",
+  "version": "3.9.14-beta.10",
   "description": "",
   "keywords": [],
   "license": "MIT",