@sheinx/hooks 3.10.1-beta.2 → 3.10.1-beta.4

package/cjs/common/use-boundary/index.d.ts

@@ -0,0 +1,41 @@
+/// <reference types="react" />
+export interface UseBoundaryOptions {
+    /**
+     * 延迟清除边界样式的时间（毫秒）
+     * @default 300
+     */
+    clearDelay?: number;
+}
+export interface UseBoundaryResult {
+    /**
+     * 当前的边界样式
+     */
+    boundaryStyle: React.CSSProperties | undefined;
+    /**
+     * 设置边界样式的函数
+     * - 传入 style 对象：立即设置边界样式
+     * - 不传参数或传入 undefined：延迟清除边界样式
+     */
+    setBoundaryStyle: (style?: React.CSSProperties) => void;
+}
+/**
+ * useBoundary Hook
+ *
+ * 用于管理弹出层的边界样式，支持延迟清除功能
+ *
+ * @param options - 配置选项
+ * @returns 包含 boundaryStyle 和 setBoundaryStyle 的对象
+ *
+ * @example
+ * ```tsx
+ * const { boundaryStyle, setBoundaryStyle } = useBoundary({ clearDelay: 300 });
+ *
+ * 设置边界样式
+ * setBoundaryStyle({ maxHeight: 200, overflowY: 'auto' });
+ *
+ * 清除边界样式（延迟执行）
+ * setBoundaryStyle();
+ * ```
+ */
+export declare const useBoundary: (options?: UseBoundaryOptions) => UseBoundaryResult;
+//# sourceMappingURL=index.d.ts.map

package/cjs/common/use-boundary/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.tsx"],"names":[],"mappings":";AAEA,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,aAAa,EAAE,KAAK,CAAC,aAAa,GAAG,SAAS,CAAC;IAC/C;;;;OAIG;IACH,gBAAgB,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC;CACzD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,WAAW,aAAa,kBAAkB,KAAQ,iBAoC9D,CAAC"}

package/cjs/common/use-boundary/index.js

@@ -0,0 +1,72 @@
+"use strict";
+"use client";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useBoundary = void 0;
+var _react = require("react");
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+/**
+ * useBoundary Hook
+ *
+ * 用于管理弹出层的边界样式，支持延迟清除功能
+ *
+ * @param options - 配置选项
+ * @returns 包含 boundaryStyle 和 setBoundaryStyle 的对象
+ *
+ * @example
+ * ```tsx
+ * const { boundaryStyle, setBoundaryStyle } = useBoundary({ clearDelay: 300 });
+ *
+ * 设置边界样式
+ * setBoundaryStyle({ maxHeight: 200, overflowY: 'auto' });
+ *
+ * 清除边界样式（延迟执行）
+ * setBoundaryStyle();
+ * ```
+ */
+var useBoundary = exports.useBoundary = function useBoundary() {
+  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var _options$clearDelay = options.clearDelay,
+    clearDelay = _options$clearDelay === void 0 ? 300 : _options$clearDelay;
+  var _useState = (0, _react.useState)(),
+    _useState2 = _slicedToArray(_useState, 2),
+    boundaryStyle = _useState2[0],
+    _setBoundaryStyle = _useState2[1];
+  var _useRef = (0, _react.useRef)({
+      boundaryTimer: null
+    }),
+    context = _useRef.current;
+  var setBoundaryStyle = function setBoundaryStyle(style) {
+    if (!style) {
+      // 延迟清除边界样式
+      context.boundaryTimer = setTimeout(function () {
+        _setBoundaryStyle(undefined);
+      }, clearDelay);
+    } else {
+      // 立即设置边界样式，取消之前的清除定时器
+      if (context.boundaryTimer) {
+        clearTimeout(context.boundaryTimer);
+        context.boundaryTimer = null;
+      }
+      _setBoundaryStyle(style);
+    }
+  };
+  (0, _react.useEffect)(function () {
+    return function () {
+      if (context.boundaryTimer) {
+        clearTimeout(context.boundaryTimer);
+      }
+    };
+  }, []);
+  return {
+    boundaryStyle: boundaryStyle,
+    setBoundaryStyle: setBoundaryStyle
+  };
+};

package/cjs/common/use-position-style/get-boundary-style.d.ts

@@ -0,0 +1,19 @@
+interface Options {
+    parentRect: DOMRect;
+    boundary: () => HTMLElement | null;
+    popupGap?: number;
+}
+/**
+ * 基于 boundary 容器的可用空间调整弹出方向
+ * 解决 position='auto' 时方向判断基于视口而非 boundary 的问题
+ */
+export declare const adjustPositionByBoundary: (position: string, { boundary, parentRect, popupGap }: Options) => string;
+export declare const getBoundaryStyle: (position: string, { boundary, parentRect, popupGap }: Options) => {
+    maxHeight?: undefined;
+    overflowY?: undefined;
+} | {
+    maxHeight: number;
+    overflowY: "auto";
+};
+export {};
+//# sourceMappingURL=get-boundary-style.d.ts.map

package/cjs/common/use-position-style/get-boundary-style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-boundary-style.d.ts","sourceRoot":"","sources":["get-boundary-style.ts"],"names":[],"mappings":"AAAA,UAAU,OAAO;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,aAAc,MAAM,sCAAsC,OAAO,KAAG,MAmBxG,CAAC;AAKF,eAAO,MAAO,gBAAgB,aAAc,MAAM,sCAAqC,OAAO;;;;;;CAgB7F,CAAA"}

package/cjs/common/use-position-style/get-boundary-style.js

@@ -0,0 +1,57 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getBoundaryStyle = exports.adjustPositionByBoundary = void 0;
+/**
+ * 基于 boundary 容器的可用空间调整弹出方向
+ * 解决 position='auto' 时方向判断基于视口而非 boundary 的问题
+ */
+var adjustPositionByBoundary = exports.adjustPositionByBoundary = function adjustPositionByBoundary(position, _ref) {
+  var boundary = _ref.boundary,
+    parentRect = _ref.parentRect,
+    popupGap = _ref.popupGap;
+  var boundaryEl = boundary();
+  if (!boundaryEl) return position;
+  var boundaryRect = boundaryEl.getBoundingClientRect();
+  var gap = popupGap || 0;
+  if (position.startsWith('bottom') || position.startsWith('top')) {
+    var spaceBelow = boundaryRect.bottom - parentRect.bottom - gap;
+    var spaceAbove = parentRect.top - boundaryRect.top - gap;
+    if (position.startsWith('bottom') && spaceBelow < spaceAbove) {
+      return position.replace('bottom', 'top');
+    }
+    if (position.startsWith('top') && spaceAbove < spaceBelow) {
+      return position.replace('top', 'bottom');
+    }
+  }
+  return position;
+};
+
+// 第一阶段：支持上下边界的高度限制，为vertical模式的Menu实现的
+// 第二阶段：支持上下边界的高度限制，为Dropdown实现的
+// TODO 后续支持左右边界的宽度限制
+var getBoundaryStyle = exports.getBoundaryStyle = function getBoundaryStyle(position, _ref2) {
+  var _maxHeight;
+  var boundary = _ref2.boundary,
+    parentRect = _ref2.parentRect,
+    popupGap = _ref2.popupGap;
+  var boundaryEl = boundary();
+  if (!boundaryEl) return {};
+  var boundaryRect = boundaryEl.getBoundingClientRect();
+  var maxHeight;
+  if (position.endsWith('-top')) {
+    maxHeight = boundaryRect.bottom - parentRect.top;
+  } else if (position.endsWith('-bottom')) {
+    maxHeight = parentRect.bottom - boundaryRect.top;
+  } else if (position.startsWith('bottom')) {
+    maxHeight = boundaryRect.bottom - parentRect.bottom - (popupGap || 0);
+  } else if (position.startsWith('top')) {
+    maxHeight = parentRect.top - boundaryRect.top - (popupGap || 0);
+  }
+  return {
+    maxHeight: Math.max((_maxHeight = maxHeight) !== null && _maxHeight !== void 0 ? _maxHeight : 0, 0),
+    overflowY: 'auto'
+  };
+};

package/cjs/common/use-position-style/index.d.ts

@@ -19,7 +19,7 @@ export interface PositionStyleConfig {
     checkPosition?: boolean;
     offset?: [number, number];
     boundary?: () => HTMLElement | null;
-    setSizingStyle?: (v?: React.CSSProperties) => void;
+    setBoundaryStyle?: (v?: React.CSSProperties) => void;
 }
 export declare const usePositionStyle: (config: PositionStyleConfig) => {
     style: React.CSSProperties;

package/cjs/common/use-position-style/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAC;AAWpE,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,UAAU,GACV,cAAc,GACd,WAAW,GACX,MAAM,GACN,OAAO,CAAC;AACZ,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,cAAc,GACd,UAAU,GACV,WAAW,GACX,KAAK,GACL,QAAQ,CAAC;AAYb,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,OAAO,CAAC;AAC3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IAEd,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAE1C,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAEzC,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC3C,YAAY,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,GAAG,gBAAgB,KAAK,IAAI,CAAC;IAErE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACpC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC;CACpD;AAsBD,eAAO,MAAM,gBAAgB,WAAY,mBAAmB;;CA4W3D,CAAC;AAEF,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAC;AAWpE,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,UAAU,GACV,cAAc,GACd,WAAW,GACX,MAAM,GACN,OAAO,CAAC;AACZ,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,cAAc,GACd,UAAU,GACV,WAAW,GACX,KAAK,GACL,QAAQ,CAAC;AAYb,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,OAAO,CAAC;AAC3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IAEd,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAE1C,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAEzC,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC3C,YAAY,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,GAAG,gBAAgB,KAAK,IAAI,CAAC;IAErE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACpC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC;CACtD;AAsBD,eAAO,MAAM,gBAAgB,WAAY,mBAAmB;;CAmX3D,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/cjs/common/use-position-style/index.js

@@ -8,7 +8,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.usePositionStyle = exports.default = void 0;
 var _react = _interopRequireWildcard(require("react"));
 var _getPositionStyle = require("./get-position-style");
-var _getSizingStyle = require("./get-sizing-style");
+var _getBoundaryStyle = require("./get-boundary-style");
 var _checkPosition = require("./check-position");
 var _checkBorder = require("./check-border");
 var _checkElementSize = require("./check-element-size");
@@ -63,14 +63,12 @@ var usePositionStyle = exports.usePositionStyle = function usePositionStyle(conf
     adjust = _ref.adjust,
     offset = _ref.offset,
     checkPosition = _ref.checkPosition,
-    setSizingStyle = _ref.setSizingStyle;
+    setBoundaryStyle = _ref.setBoundaryStyle;
   // 初次渲染无样式的时候， 隐藏展示
   var _useState = (0, _react.useState)(hideStyle),
     _useState2 = _slicedToArray(_useState, 2),
     style = _useState2[0],
     setStyle = _useState2[1];
-  // const [sizingStyle, setSizingStyle] = useState<React.CSSProperties>();
-
   var _React$useRef = _react.default.useRef({
       containerRect: {
         left: 0,
@@ -91,7 +89,7 @@ var usePositionStyle = exports.usePositionStyle = function usePositionStyle(conf
     context = _React$useRef.current;
   var parentElNewPosition = (0, _checkPosition.useCheckElementPosition)(parentElRef, {
     scrollContainer: scrollElRef === null || scrollElRef === void 0 ? void 0 : scrollElRef.current,
-    enable: show && (adjust || checkPosition)
+    enable: show && (adjust || checkPosition || !!boundary)
   });
   var parentElBorderWidth = (0, _checkBorder.useCheckElementBorderWidth)(parentElRef, {
     direction: 'horizontal',
@@ -376,7 +374,18 @@ var usePositionStyle = exports.usePositionStyle = function usePositionStyle(conf
     };
     context.parentRect = parentElRef.current.getBoundingClientRect();
     var realPosition = position;
-    if (adjust) {
+
+    // 运行时检测 boundary 是否返回有效元素
+    var boundaryAvailable = typeof boundary === 'function' && boundary() !== null;
+    if (boundaryAvailable) {
+      // boundary 模式：基于边界容器的可用空间调整方向
+      realPosition = (0, _getBoundaryStyle.adjustPositionByBoundary)(realPosition, {
+        boundary: boundary,
+        parentRect: context.parentRect,
+        popupGap: popupGap
+      });
+    } else if (adjust) {
+      // 无 boundary 或 boundary 返回 null 时，fallback 到视口调整
       var popupInfo = getPopUpInfo(context.parentRect);
       context.popUpHeight = popupInfo.height;
       context.popUpWidth = popupInfo.width;
@@ -400,14 +409,15 @@ var usePositionStyle = exports.usePositionStyle = function usePositionStyle(conf
     } else if (realPosition.indexOf('bottom') === 0) {
       newStyle.transformOrigin = 'center top';
     }
-    if (boundary && show && popupElRef.current) {
-      var newSizingStyle = (0, _getSizingStyle.getSizingStyle)(realPosition, {
+    if (boundaryAvailable && show && popupElRef.current) {
+      var newBoundaryStyle = (0, _getBoundaryStyle.getBoundaryStyle)(realPosition, {
         boundary: boundary,
-        parentRect: context.parentRect
+        parentRect: context.parentRect,
+        popupGap: popupGap
       });
       return {
         newStyle: newStyle,
-        newSizingStyle: newSizingStyle
+        newBoundaryStyle: newBoundaryStyle
       };
     }
     return {
@@ -417,11 +427,11 @@ var usePositionStyle = exports.usePositionStyle = function usePositionStyle(conf
   var updateStyle = (0, _usePersistFn.default)(function () {
     var _getStyle = getStyle(),
       newStyle = _getStyle.newStyle,
-      newSizingStyle = _getStyle.newSizingStyle;
+      newBoundaryStyle = _getStyle.newBoundaryStyle;
     if (newStyle && !(0, _shallowEqual.default)(style, newStyle)) {
       setStyle(newStyle);
     }
-    setSizingStyle === null || setSizingStyle === void 0 || setSizingStyle(newSizingStyle);
+    setBoundaryStyle === null || setBoundaryStyle === void 0 || setBoundaryStyle(newBoundaryStyle);
 
     // 当父元素的滚动容器滚动时，判断是否需要更新弹出层位置，包括是否隐藏弹出层（通过hideStyle隐藏，不是show状态）
     if (show) {

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;;;;;;;;;;;yBAiDX,MAAM,UAAU,MAAM;;;;;;;CA2R5D,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;;;;;;;;;;;yBAiDX,MAAM,UAAU,MAAM;;;;;;;CAwS5D,CAAC;AAEF,eAAe,cAAc,CAAC"}

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

@@ -288,6 +288,21 @@ var useTableLayout = function useTableLayout(props) {
     for (var i = 0, count = items.length; i < count; i++) {
       _loop();
     }
+
+    // offsetWidth 返回整数（四舍五入），多列累加可能导致总和比表格实际渲染宽度大 1~N px，
+    // 这些多出的像素会让 table-layout:fixed 的表格撑宽，产生不必要的横向滚动条。
+    // 用 <table> 自身的 offsetWidth 作为基准，将取整溢出部分从最后一列减去。
+    if (target.current && newCols.length > 0) {
+      var tableRenderedWidth = target.current.offsetWidth;
+      var measuredSum = newCols.reduce(function (a, b) {
+        return a + b;
+      }, 0);
+      var excess = measuredSum - tableRenderedWidth;
+      // 仅修正取整误差范围内的溢出（最多每列 1px）
+      if (tableRenderedWidth > 0 && excess > 0 && excess <= items.length) {
+        newCols[newCols.length - 1] -= excess;
+      }
+    }
     if (fromDrag && props.columnResizable) {
       var widthArr = _toConsumableArray(newCols);
       if (typeof props.width === 'number') {

package/cjs/index.d.ts

@@ -25,6 +25,7 @@ export * from './common/use-filter';
 export * from './common/use-scrollbar-width';
 export * from './common/use-component-memo';
 export * from './common/use-collapse-animation';
+export * from './common/use-boundary';
 export * from './components/use-input';
 export * from './components/use-textarea';
 export * from './components/use-form';

package/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,UAAU,CAAC;AAEjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,IAAI,EAAE,CAAC;AAGhB,cAAc,eAAe,CAAC;AAE9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAGhD,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;;AAE1C,wBAAkB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,UAAU,CAAC;AAEjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,IAAI,EAAE,CAAC;AAGhB,cAAc,eAAe,CAAC;AAE9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AAGtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;;AAE1C,wBAAkB"}

package/cjs/index.js

@@ -311,6 +311,18 @@ Object.keys(_useCollapseAnimation).forEach(function (key) {
     }
   });
 });
+var _useBoundary = require("./common/use-boundary");
+Object.keys(_useBoundary).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _useBoundary[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _useBoundary[key];
+    }
+  });
+});
 var _useInput = require("./components/use-input");
 Object.keys(_useInput).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/esm/common/use-boundary/index.d.ts

@@ -0,0 +1,41 @@
+/// <reference types="react" />
+export interface UseBoundaryOptions {
+    /**
+     * 延迟清除边界样式的时间（毫秒）
+     * @default 300
+     */
+    clearDelay?: number;
+}
+export interface UseBoundaryResult {
+    /**
+     * 当前的边界样式
+     */
+    boundaryStyle: React.CSSProperties | undefined;
+    /**
+     * 设置边界样式的函数
+     * - 传入 style 对象：立即设置边界样式
+     * - 不传参数或传入 undefined：延迟清除边界样式
+     */
+    setBoundaryStyle: (style?: React.CSSProperties) => void;
+}
+/**
+ * useBoundary Hook
+ *
+ * 用于管理弹出层的边界样式，支持延迟清除功能
+ *
+ * @param options - 配置选项
+ * @returns 包含 boundaryStyle 和 setBoundaryStyle 的对象
+ *
+ * @example
+ * ```tsx
+ * const { boundaryStyle, setBoundaryStyle } = useBoundary({ clearDelay: 300 });
+ *
+ * 设置边界样式
+ * setBoundaryStyle({ maxHeight: 200, overflowY: 'auto' });
+ *
+ * 清除边界样式（延迟执行）
+ * setBoundaryStyle();
+ * ```
+ */
+export declare const useBoundary: (options?: UseBoundaryOptions) => UseBoundaryResult;
+//# sourceMappingURL=index.d.ts.map

package/esm/common/use-boundary/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.tsx"],"names":[],"mappings":";AAEA,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,aAAa,EAAE,KAAK,CAAC,aAAa,GAAG,SAAS,CAAC;IAC/C;;;;OAIG;IACH,gBAAgB,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC;CACzD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,WAAW,aAAa,kBAAkB,KAAQ,iBAoC9D,CAAC"}

package/esm/common/use-boundary/index.js

@@ -0,0 +1,66 @@
+"use client";
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { useState, useRef, useEffect } from 'react';
+/**
+ * useBoundary Hook
+ *
+ * 用于管理弹出层的边界样式，支持延迟清除功能
+ *
+ * @param options - 配置选项
+ * @returns 包含 boundaryStyle 和 setBoundaryStyle 的对象
+ *
+ * @example
+ * ```tsx
+ * const { boundaryStyle, setBoundaryStyle } = useBoundary({ clearDelay: 300 });
+ *
+ * 设置边界样式
+ * setBoundaryStyle({ maxHeight: 200, overflowY: 'auto' });
+ *
+ * 清除边界样式（延迟执行）
+ * setBoundaryStyle();
+ * ```
+ */
+export var useBoundary = function useBoundary() {
+  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var _options$clearDelay = options.clearDelay,
+    clearDelay = _options$clearDelay === void 0 ? 300 : _options$clearDelay;
+  var _useState = useState(),
+    _useState2 = _slicedToArray(_useState, 2),
+    boundaryStyle = _useState2[0],
+    _setBoundaryStyle = _useState2[1];
+  var _useRef = useRef({
+      boundaryTimer: null
+    }),
+    context = _useRef.current;
+  var setBoundaryStyle = function setBoundaryStyle(style) {
+    if (!style) {
+      // 延迟清除边界样式
+      context.boundaryTimer = setTimeout(function () {
+        _setBoundaryStyle(undefined);
+      }, clearDelay);
+    } else {
+      // 立即设置边界样式，取消之前的清除定时器
+      if (context.boundaryTimer) {
+        clearTimeout(context.boundaryTimer);
+        context.boundaryTimer = null;
+      }
+      _setBoundaryStyle(style);
+    }
+  };
+  useEffect(function () {
+    return function () {
+      if (context.boundaryTimer) {
+        clearTimeout(context.boundaryTimer);
+      }
+    };
+  }, []);
+  return {
+    boundaryStyle: boundaryStyle,
+    setBoundaryStyle: setBoundaryStyle
+  };
+};

package/esm/common/use-position-style/get-boundary-style.d.ts

@@ -0,0 +1,19 @@
+interface Options {
+    parentRect: DOMRect;
+    boundary: () => HTMLElement | null;
+    popupGap?: number;
+}
+/**
+ * 基于 boundary 容器的可用空间调整弹出方向
+ * 解决 position='auto' 时方向判断基于视口而非 boundary 的问题
+ */
+export declare const adjustPositionByBoundary: (position: string, { boundary, parentRect, popupGap }: Options) => string;
+export declare const getBoundaryStyle: (position: string, { boundary, parentRect, popupGap }: Options) => {
+    maxHeight?: undefined;
+    overflowY?: undefined;
+} | {
+    maxHeight: number;
+    overflowY: "auto";
+};
+export {};
+//# sourceMappingURL=get-boundary-style.d.ts.map

package/esm/common/use-position-style/get-boundary-style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-boundary-style.d.ts","sourceRoot":"","sources":["get-boundary-style.ts"],"names":[],"mappings":"AAAA,UAAU,OAAO;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,aAAc,MAAM,sCAAsC,OAAO,KAAG,MAmBxG,CAAC;AAKF,eAAO,MAAO,gBAAgB,aAAc,MAAM,sCAAqC,OAAO;;;;;;CAgB7F,CAAA"}

package/esm/common/use-position-style/get-boundary-style.js

@@ -0,0 +1,51 @@
+/**
+ * 基于 boundary 容器的可用空间调整弹出方向
+ * 解决 position='auto' 时方向判断基于视口而非 boundary 的问题
+ */
+export var adjustPositionByBoundary = function adjustPositionByBoundary(position, _ref) {
+  var boundary = _ref.boundary,
+    parentRect = _ref.parentRect,
+    popupGap = _ref.popupGap;
+  var boundaryEl = boundary();
+  if (!boundaryEl) return position;
+  var boundaryRect = boundaryEl.getBoundingClientRect();
+  var gap = popupGap || 0;
+  if (position.startsWith('bottom') || position.startsWith('top')) {
+    var spaceBelow = boundaryRect.bottom - parentRect.bottom - gap;
+    var spaceAbove = parentRect.top - boundaryRect.top - gap;
+    if (position.startsWith('bottom') && spaceBelow < spaceAbove) {
+      return position.replace('bottom', 'top');
+    }
+    if (position.startsWith('top') && spaceAbove < spaceBelow) {
+      return position.replace('top', 'bottom');
+    }
+  }
+  return position;
+};
+
+// 第一阶段：支持上下边界的高度限制，为vertical模式的Menu实现的
+// 第二阶段：支持上下边界的高度限制，为Dropdown实现的
+// TODO 后续支持左右边界的宽度限制
+export var getBoundaryStyle = function getBoundaryStyle(position, _ref2) {
+  var _maxHeight;
+  var boundary = _ref2.boundary,
+    parentRect = _ref2.parentRect,
+    popupGap = _ref2.popupGap;
+  var boundaryEl = boundary();
+  if (!boundaryEl) return {};
+  var boundaryRect = boundaryEl.getBoundingClientRect();
+  var maxHeight;
+  if (position.endsWith('-top')) {
+    maxHeight = boundaryRect.bottom - parentRect.top;
+  } else if (position.endsWith('-bottom')) {
+    maxHeight = parentRect.bottom - boundaryRect.top;
+  } else if (position.startsWith('bottom')) {
+    maxHeight = boundaryRect.bottom - parentRect.bottom - (popupGap || 0);
+  } else if (position.startsWith('top')) {
+    maxHeight = parentRect.top - boundaryRect.top - (popupGap || 0);
+  }
+  return {
+    maxHeight: Math.max((_maxHeight = maxHeight) !== null && _maxHeight !== void 0 ? _maxHeight : 0, 0),
+    overflowY: 'auto'
+  };
+};

package/esm/common/use-position-style/index.d.ts

@@ -19,7 +19,7 @@ export interface PositionStyleConfig {
     checkPosition?: boolean;
     offset?: [number, number];
     boundary?: () => HTMLElement | null;
-    setSizingStyle?: (v?: React.CSSProperties) => void;
+    setBoundaryStyle?: (v?: React.CSSProperties) => void;
 }
 export declare const usePositionStyle: (config: PositionStyleConfig) => {
     style: React.CSSProperties;

package/esm/common/use-position-style/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAC;AAWpE,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,UAAU,GACV,cAAc,GACd,WAAW,GACX,MAAM,GACN,OAAO,CAAC;AACZ,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,cAAc,GACd,UAAU,GACV,WAAW,GACX,KAAK,GACL,QAAQ,CAAC;AAYb,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,OAAO,CAAC;AAC3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IAEd,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAE1C,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAEzC,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC3C,YAAY,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,GAAG,gBAAgB,KAAK,IAAI,CAAC;IAErE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACpC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC;CACpD;AAsBD,eAAO,MAAM,gBAAgB,WAAY,mBAAmB;;CA4W3D,CAAC;AAEF,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAC;AAWpE,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,UAAU,GACV,cAAc,GACd,WAAW,GACX,MAAM,GACN,OAAO,CAAC;AACZ,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,cAAc,GACd,UAAU,GACV,WAAW,GACX,KAAK,GACL,QAAQ,CAAC;AAYb,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,OAAO,CAAC;AAC3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IAEd,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAE1C,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAEzC,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC3C,YAAY,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,GAAG,gBAAgB,KAAK,IAAI,CAAC;IAErE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACpC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC;CACtD;AAsBD,eAAO,MAAM,gBAAgB,WAAY,mBAAmB;;CAmX3D,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/esm/common/use-position-style/index.js

@@ -7,7 +7,7 @@ function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" !=
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 import React, { useEffect, useLayoutEffect, useState } from 'react';
 import { getPositionStyle } from "./get-position-style";
-import { getSizingStyle } from "./get-sizing-style";
+import { getBoundaryStyle, adjustPositionByBoundary } from "./get-boundary-style";
 import { useCheckElementPosition } from "./check-position";
 import { useCheckElementBorderWidth } from "./check-border";
 import { useCheckElementSize } from "./check-element-size";
@@ -54,14 +54,12 @@ export var usePositionStyle = function usePositionStyle(config) {
     adjust = _ref.adjust,
     offset = _ref.offset,
     checkPosition = _ref.checkPosition,
-    setSizingStyle = _ref.setSizingStyle;
+    setBoundaryStyle = _ref.setBoundaryStyle;
   // 初次渲染无样式的时候， 隐藏展示
   var _useState = useState(hideStyle),
     _useState2 = _slicedToArray(_useState, 2),
     style = _useState2[0],
     setStyle = _useState2[1];
-  // const [sizingStyle, setSizingStyle] = useState<React.CSSProperties>();
-
   var _React$useRef = React.useRef({
       containerRect: {
         left: 0,
@@ -82,7 +80,7 @@ export var usePositionStyle = function usePositionStyle(config) {
     context = _React$useRef.current;
   var parentElNewPosition = useCheckElementPosition(parentElRef, {
     scrollContainer: scrollElRef === null || scrollElRef === void 0 ? void 0 : scrollElRef.current,
-    enable: show && (adjust || checkPosition)
+    enable: show && (adjust || checkPosition || !!boundary)
   });
   var parentElBorderWidth = useCheckElementBorderWidth(parentElRef, {
     direction: 'horizontal',
@@ -367,7 +365,18 @@ export var usePositionStyle = function usePositionStyle(config) {
     };
     context.parentRect = parentElRef.current.getBoundingClientRect();
     var realPosition = position;
-    if (adjust) {
+
+    // 运行时检测 boundary 是否返回有效元素
+    var boundaryAvailable = typeof boundary === 'function' && boundary() !== null;
+    if (boundaryAvailable) {
+      // boundary 模式：基于边界容器的可用空间调整方向
+      realPosition = adjustPositionByBoundary(realPosition, {
+        boundary: boundary,
+        parentRect: context.parentRect,
+        popupGap: popupGap
+      });
+    } else if (adjust) {
+      // 无 boundary 或 boundary 返回 null 时，fallback 到视口调整
       var popupInfo = getPopUpInfo(context.parentRect);
       context.popUpHeight = popupInfo.height;
       context.popUpWidth = popupInfo.width;
@@ -391,14 +400,15 @@ export var usePositionStyle = function usePositionStyle(config) {
     } else if (realPosition.indexOf('bottom') === 0) {
       newStyle.transformOrigin = 'center top';
     }
-    if (boundary && show && popupElRef.current) {
-      var newSizingStyle = getSizingStyle(realPosition, {
+    if (boundaryAvailable && show && popupElRef.current) {
+      var newBoundaryStyle = getBoundaryStyle(realPosition, {
         boundary: boundary,
-        parentRect: context.parentRect
+        parentRect: context.parentRect,
+        popupGap: popupGap
       });
       return {
         newStyle: newStyle,
-        newSizingStyle: newSizingStyle
+        newBoundaryStyle: newBoundaryStyle
       };
     }
     return {
@@ -408,11 +418,11 @@ export var usePositionStyle = function usePositionStyle(config) {
   var updateStyle = usePersistFn(function () {
     var _getStyle = getStyle(),
       newStyle = _getStyle.newStyle,
-      newSizingStyle = _getStyle.newSizingStyle;
+      newBoundaryStyle = _getStyle.newBoundaryStyle;
     if (newStyle && !shallowEqual(style, newStyle)) {
       setStyle(newStyle);
     }
-    setSizingStyle === null || setSizingStyle === void 0 || setSizingStyle(newSizingStyle);
+    setBoundaryStyle === null || setBoundaryStyle === void 0 || setBoundaryStyle(newBoundaryStyle);
 
     // 当父元素的滚动容器滚动时，判断是否需要更新弹出层位置，包括是否隐藏弹出层（通过hideStyle隐藏，不是show状态）
     if (show) {

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;;;;;;;;;;;yBAiDX,MAAM,UAAU,MAAM;;;;;;;CA2R5D,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;;;;;;;;;;;yBAiDX,MAAM,UAAU,MAAM;;;;;;;CAwS5D,CAAC;AAEF,eAAe,cAAc,CAAC"}

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

@@ -279,6 +279,21 @@ var useTableLayout = function useTableLayout(props) {
     for (var i = 0, count = items.length; i < count; i++) {
       _loop();
     }
+
+    // offsetWidth 返回整数（四舍五入），多列累加可能导致总和比表格实际渲染宽度大 1~N px，
+    // 这些多出的像素会让 table-layout:fixed 的表格撑宽，产生不必要的横向滚动条。
+    // 用 <table> 自身的 offsetWidth 作为基准，将取整溢出部分从最后一列减去。
+    if (target.current && newCols.length > 0) {
+      var tableRenderedWidth = target.current.offsetWidth;
+      var measuredSum = newCols.reduce(function (a, b) {
+        return a + b;
+      }, 0);
+      var excess = measuredSum - tableRenderedWidth;
+      // 仅修正取整误差范围内的溢出（最多每列 1px）
+      if (tableRenderedWidth > 0 && excess > 0 && excess <= items.length) {
+        newCols[newCols.length - 1] -= excess;
+      }
+    }
     if (fromDrag && props.columnResizable) {
       var widthArr = _toConsumableArray(newCols);
       if (typeof props.width === 'number') {

package/esm/index.d.ts

@@ -25,6 +25,7 @@ export * from './common/use-filter';
 export * from './common/use-scrollbar-width';
 export * from './common/use-component-memo';
 export * from './common/use-collapse-animation';
+export * from './common/use-boundary';
 export * from './components/use-input';
 export * from './components/use-textarea';
 export * from './components/use-form';

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,UAAU,CAAC;AAEjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,IAAI,EAAE,CAAC;AAGhB,cAAc,eAAe,CAAC;AAE9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAGhD,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;;AAE1C,wBAAkB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,UAAU,CAAC;AAEjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,IAAI,EAAE,CAAC;AAGhB,cAAc,eAAe,CAAC;AAE9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AAGtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;;AAE1C,wBAAkB"}

package/esm/index.js

@@ -28,6 +28,7 @@ export * from "./common/use-filter";
 export * from "./common/use-scrollbar-width";
 export * from "./common/use-component-memo";
 export * from "./common/use-collapse-animation";
+export * from "./common/use-boundary";
 
 //components
 export * from "./components/use-input";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sheinx/hooks",
-  "version": "3.10.1-beta.2",
+  "version": "3.10.1-beta.4",
   "description": "",
   "keywords": [],
   "license": "MIT",

package/cjs/common/use-position-style/get-sizing-style.d.ts

@@ -1,13 +0,0 @@
-interface Options {
-    parentRect: DOMRect;
-    boundary: () => HTMLElement | null;
-}
-export declare const getSizingStyle: (position: string, { boundary, parentRect }: Options) => {
-    maxHeight?: undefined;
-    overflowY?: undefined;
-} | {
-    maxHeight: number | undefined;
-    overflowY: "auto";
-};
-export {};
-//# sourceMappingURL=get-sizing-style.d.ts.map

package/cjs/common/use-position-style/get-sizing-style.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-sizing-style.d.ts","sourceRoot":"","sources":["get-sizing-style.ts"],"names":[],"mappings":"AAAA,UAAU,OAAO;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;CACpC;AAID,eAAO,MAAO,cAAc,aAAc,MAAM,4BAA2B,OAAO;;;;;;CAYjF,CAAA"}

package/cjs/common/use-position-style/get-sizing-style.js

@@ -1,25 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getSizingStyle = void 0;
-// 第一阶段：支持上下边界的高度限制，为vertical模式的Menu实现的
-// TODO 后续支持左右边界的宽度限制
-var getSizingStyle = exports.getSizingStyle = function getSizingStyle(position, _ref) {
-  var boundary = _ref.boundary,
-    parentRect = _ref.parentRect;
-  var boundaryEl = boundary();
-  if (!boundaryEl) return {};
-  var boundaryRect = boundaryEl.getBoundingClientRect();
-  var maxHeight;
-  if (position.endsWith('-top')) {
-    maxHeight = boundaryRect.bottom - parentRect.top;
-  } else if (position.endsWith('-bottom')) {
-    maxHeight = parentRect.bottom - boundaryRect.top;
-  }
-  return {
-    maxHeight: maxHeight,
-    overflowY: 'auto'
-  };
-};

package/esm/common/use-position-style/get-sizing-style.d.ts

@@ -1,13 +0,0 @@
-interface Options {
-    parentRect: DOMRect;
-    boundary: () => HTMLElement | null;
-}
-export declare const getSizingStyle: (position: string, { boundary, parentRect }: Options) => {
-    maxHeight?: undefined;
-    overflowY?: undefined;
-} | {
-    maxHeight: number | undefined;
-    overflowY: "auto";
-};
-export {};
-//# sourceMappingURL=get-sizing-style.d.ts.map

package/esm/common/use-position-style/get-sizing-style.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-sizing-style.d.ts","sourceRoot":"","sources":["get-sizing-style.ts"],"names":[],"mappings":"AAAA,UAAU,OAAO;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;CACpC;AAID,eAAO,MAAO,cAAc,aAAc,MAAM,4BAA2B,OAAO;;;;;;CAYjF,CAAA"}

package/esm/common/use-position-style/get-sizing-style.js

@@ -1,19 +0,0 @@
-// 第一阶段：支持上下边界的高度限制，为vertical模式的Menu实现的
-// TODO 后续支持左右边界的宽度限制
-export var getSizingStyle = function getSizingStyle(position, _ref) {
-  var boundary = _ref.boundary,
-    parentRect = _ref.parentRect;
-  var boundaryEl = boundary();
-  if (!boundaryEl) return {};
-  var boundaryRect = boundaryEl.getBoundingClientRect();
-  var maxHeight;
-  if (position.endsWith('-top')) {
-    maxHeight = boundaryRect.bottom - parentRect.top;
-  } else if (position.endsWith('-bottom')) {
-    maxHeight = parentRect.bottom - boundaryRect.top;
-  }
-  return {
-    maxHeight: maxHeight,
-    overflowY: 'auto'
-  };
-};