@cloudtower/eagle 0.0.0-config-rc-7 → 0.0.0-data-testid

package/dist/src/core/SearchInput/__test__/SearchInput.hook.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/core/SearchInput/index.d.ts

@@ -1,4 +1,2 @@
-import { SearchInputComponentType } from "./searchInput.type";
-declare const SearchInput: SearchInputComponentType;
-export default SearchInput;
-export * from "./searchInput.type";
+export * from "./SearchInput";
+export * from "./SearchInput.type";

package/dist/src/core/SearchInput/searchInput.type.d.ts

@@ -1,7 +1,154 @@
 /// <reference types="react" />
 import { InputProps } from "antd/lib/input";
-export type SearchInputProps = Omit<InputProps, "onChange"> & {
-    onChange: (value: string) => void;
+import { SrcType } from "../BaseIcon";
+/**
+ * @description 搜索输入框组件，基于 Input 封装，提供防抖搜索、结果导航（上一个/下一个）和最近搜索历史功能。
+ * 支持受控和非受控两种模式，适用于表格内搜索、页面全局搜索等场景。
+ *
+ * @example
+ * 基础搜索（带防抖）：
+ * ```tsx
+ * import React, { useState } from "react";
+ * import { SearchInput } from "@cloudtower/eagle";
+ *
+ * const App = () => {
+ *   const [keyword, setKeyword] = useState("");
+ *   return (
+ *     <SearchInput
+ *       debounceWait={300}
+ *       onChange={(value) => setKeyword(value)}
+ *     />
+ *   );
+ * };
+ * ```
+ *
+ * @example
+ * 带结果导航（显示匹配数和上下翻页）：
+ * ```tsx
+ * import React from "react";
+ * import { SearchInput } from "@cloudtower/eagle";
+ *
+ * const App = () => (
+ *   <SearchInput
+ *     total={10}
+ *     onChange={(value) => console.log("搜索:", value)}
+ *     onSearchNext={(value, current) => console.log("下一个:", current)}
+ *     onSearchPrev={(value, current) => console.log("上一个:", current)}
+ *   />
+ * );
+ * ```
+ *
+ * @example
+ * 启用最近搜索历史：
+ * ```tsx
+ * import React from "react";
+ * import { SearchInput } from "@cloudtower/eagle";
+ *
+ * const App = () => (
+ *   <SearchInput
+ *     enableRecentSearch
+ *     recentSearchLocalStorageKey="vm-search"
+ *     maxRecentCount={5}
+ *     onChange={(value) => console.log(value)}
+ *   />
+ * );
+ * ```
+ *
+ * @see Input 基础输入框
+ * @see Cascader 级联选择器（内置了 SearchInput 作为搜索区域）
+ */
+export type SearchInputProps = Omit<InputProps, "value" | "onChange"> & {
+    /**
+     * 数据测试 id
+     */
+    "data-testid"?: string;
+    /**
+     * 输入框的值，用于受控模式。
+     * 配置 value 时，需把 debounceWait 设置为 0，否则输入时会有卡顿的问题
+     */
+    value?: InputProps["value"];
+    /**
+     * 防抖延迟时间，单位为毫秒。输入停止后延迟指定时间再触发 onChange
+     * @default 300
+     */
     debounceWait?: number;
+    /**
+     * 搜索结果的总数。设置后，当同时提供 onSearchNext 和 onSearchPrev 时，
+     * 输入框后缀区域将显示 "current/total" 计数器和上下翻页按钮
+     */
+    total?: number;
+    /**
+     * 当前选中的结果索引（从 1 开始），可用于外部控制当前位置。
+     * 如果不提供，组件将内部管理此状态
+     */
+    current?: number;
+    /**
+     * 点击"下一个"按钮或按下 Enter 键时的回调。
+     * 需同时提供 onSearchPrev 才会显示导航按钮
+     * @param value - 当前搜索关键词
+     * @param current - 导航后的结果索引
+     */
+    onSearchNext?: (value: string, current: number) => void;
+    /**
+     * 点击"上一个"按钮时的回调。
+     * 需同时提供 onSearchNext 才会显示导航按钮
+     * @param value - 当前搜索关键词
+     * @param current - 导航后的结果索引
+     */
+    onSearchPrev?: (value: string, current: number) => void;
+    /**
+     * 输入内容改变时的回调函数（经过防抖处理后触发）
+     * @param value - 当前输入的搜索关键词
+     */
+    onChange: (value: string) => void;
+    /**
+     * 自定义搜索图标（输入框前缀），替换默认的放大镜图标
+     */
+    searchIcon?: SrcType;
+    /**
+     * 自定义"上一个"按钮的默认态图标
+     */
+    prefixIcon?: SrcType;
+    /**
+     * 自定义"上一个"按钮的 hover 态图标
+     */
+    prefixHoverIcon?: SrcType;
+    /**
+     * 自定义"下一个"按钮的默认态图标
+     */
+    nextIcon?: SrcType;
+    /**
+     * 自定义"下一个"按钮的 hover 态图标
+     */
+    nextHoverIcon?: SrcType;
+    /**
+     * 自定义清空按钮的默认态图标
+     */
+    clearIcon?: SrcType;
+    /**
+     * 自定义清空按钮的 hover 态图标
+     */
+    clearHoverIcon?: SrcType;
+    /**
+     * 搜索框宽度
+     * @default 276
+     */
+    width?: number | string;
+    /**
+     * 是否开启最近搜索功能。开启后，聚焦空输入框时会显示最近搜索记录的下拉菜单。
+     * 搜索记录通过 localStorage 持久化存储
+     * @default false
+     */
+    enableRecentSearch?: boolean;
+    /**
+     * 最近搜索记录在 localStorage 中的存储键名。
+     * 开启 enableRecentSearch 时必须提供，不同业务场景应使用不同的 key 以隔离数据
+     */
+    recentSearchLocalStorageKey?: string;
+    /**
+     * 最近搜索记录的最大展示条数
+     * @default 5
+     */
+    maxRecentCount?: number;
 };
 export type SearchInputComponentType = React.FC<SearchInputProps>;

package/dist/src/core/SegmentControl/__test__/data-testid.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/core/SegmentControl/segmentControl.type.d.ts

@@ -1,4 +1,6 @@
 import { SegmentedProps as AntdSegmentedProps } from "antd5";
 export interface ISegmentedControlProps extends Omit<AntdSegmentedProps, "ref"> {
     size?: "small" | "middle";
+    /** Test ID for automated testing */
+    "data-testid"?: string;
 }

package/dist/src/core/Select/index.d.ts

@@ -2,3 +2,4 @@ import { SelectComponentType } from "./select.type";
 declare const Select: SelectComponentType<any, HTMLElement>;
 export default Select;
 export * from "./select.type";
+export * from "./select.widgets";

package/dist/src/core/Select/select.style.d.ts

@@ -0,0 +1,4 @@
+export declare const SelectStyle: import("@linaria/core").LinariaClassName;
+export declare const SelectIconStyle: import("@linaria/core").LinariaClassName;
+export declare const SelectSizeStyle: import("@linaria/core").LinariaClassName;
+export declare const PlaceholderTextStyle: import("@linaria/core").LinariaClassName;

package/dist/src/core/Select/select.type.d.ts

@@ -1,32 +1,7 @@
-/// <reference types="react" />
-import { SelectProps as AntdSelectProps } from "antd/lib/select";
-import { FieldRenderProps } from "../Fields/fields.type";
-export type KitSelectProps = {
-    defaultValue?: string;
-    error?: unknown | React.ReactNode;
-    danger?: boolean;
-    multiple?: boolean;
-    scrollBottomBuffer?: number;
-    onScrollBottom?: () => void;
-    selectLimit?: number;
-} & AntdSelectProps<string>;
-interface LooseFieldRenderProps<V, T extends HTMLElement> {
-    input: {
-        name?: FieldRenderProps<V, T>["input"]["name"];
-        value?: FieldRenderProps<V, T>["input"]["value"];
-        onBlur?: FieldRenderProps<V, T>["input"]["onBlur"];
-        onChange?: (value: string | string[], option: {
-            object: V;
-        } | Array<{
-            object: V;
-        }>) => void;
-        onFocus?: FieldRenderProps<V, T>["input"]["onFocus"];
-        type?: FieldRenderProps<V, T>["input"]["type"];
-        checked?: FieldRenderProps<V, T>["input"]["checked"];
-        multiple?: FieldRenderProps<V, T>["input"]["multiple"];
-    };
-    meta?: FieldRenderProps<V, T>["meta"];
-    focusIndicator?: boolean;
-}
+import { KitLegacySelectProps, LooseFieldRenderProps } from "../../core/LegacySelect";
+import React from "react";
+export type KitSelectProps = KitLegacySelectProps & {
+    /** 是否正在加载 Select 组件的值 */
+    isLoadingValue?: boolean;
+};
 export type SelectComponentType<V = any, T extends HTMLElement = HTMLElement> = React.FunctionComponent<LooseFieldRenderProps<V, T> & KitSelectProps>;
-export {};

package/dist/src/core/Select/select.widgets.d.ts

@@ -0,0 +1,7 @@
+import { OptionProps as AntdOptionProps } from "antd/lib/select";
+import React from "react";
+export type OptionProps = AntdOptionProps & {
+    prefix?: React.ReactNode;
+    suffix?: React.ReactNode;
+};
+export declare function getOptions(options: OptionProps[]): React.JSX.Element[];

package/dist/src/core/SimplePagination/simplePagination.type.d.ts

@@ -4,4 +4,5 @@ export interface ISimplePaginationProps {
     count: number;
     size: number;
     onPageChange?: (page: number) => void;
+    "data-testid"?: string;
 }

package/dist/src/core/Skeleton/Content.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+export type SkeletonContentProps = {
+    width?: string;
+    height?: string;
+    className?: string;
+};
+declare const SkeletonContent: React.FC<SkeletonContentProps>;
+export default SkeletonContent;

package/dist/src/core/Skeleton/index.d.ts

@@ -0,0 +1,8 @@
+import SkeletonContent, { type SkeletonContentProps } from "./Content";
+export interface SkeletonType {
+    Content: typeof SkeletonContent;
+}
+declare const Skeleton: SkeletonType;
+export default Skeleton;
+export { Skeleton, SkeletonContent };
+export type { SkeletonContentProps };

package/dist/src/core/SmallDialog/SmallDialog.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+import { SmallDialogProps } from "./SmallDialog.type";
+export declare const SmallDialog: React.FC<SmallDialogProps>;

package/dist/src/core/SmallDialog/SmallDialog.style.d.ts

@@ -0,0 +1,7 @@
+export declare const DialogStyle: import("@linaria/core").LinariaClassName;
+export declare const FooterStyle: import("@linaria/core").LinariaClassName;
+export declare const ErrorTextStyle: import("@linaria/core").LinariaClassName;
+export declare const CloseIconStyle: import("@linaria/core").LinariaClassName;
+export declare const ModelTitleSkeletonStyle: import("@linaria/core").LinariaClassName;
+export declare const ModelContentSkeletonStyle: import("@linaria/core").LinariaClassName;
+export declare const ModelInitializingErrorStyle: import("@linaria/core").LinariaClassName;

package/dist/src/core/SmallDialog/SmallDialog.type.d.ts

@@ -0,0 +1,183 @@
+import { ButtonProps } from "../../core/Button";
+import React from "react";
+/**
+ * @description 小尺寸弹窗组件，固定宽度 492px，适用于确认操作、简短表单、信息提示等场景。
+ * 通过 `usePushModal` 打开弹窗，在 `onOk`/`onCancel` 回调中调用 `popModal()` 关闭弹窗。
+ * 弹窗基于 Redux 模态栈管理（KitStoreProvider），支持多层弹窗嵌套。
+ *
+ * @example 基础确认弹窗
+ * ```tsx
+ * import { SmallDialog } from "@cloudtower/eagle";
+ * import { usePushModal } from "@cloudtower/eagle/lib/core/KitStoreProvider";
+ *
+ * const MyComponent = () => {
+ *   const pushModal = usePushModal();
+ *
+ *   const openDialog = () => {
+ *     pushModal(
+ *       <SmallDialog
+ *         title="确认操作"
+ *         onOk={(popModal) => {
+ *           // 执行确认逻辑
+ *           popModal();
+ *         }}
+ *         onCancel={(popModal) => {
+ *           popModal();
+ *         }}
+ *       >
+ *         确定要执行此操作吗？
+ *       </SmallDialog>
+ *     );
+ *   };
+ *
+ *   return <Button onClick={openDialog}>打开弹窗</Button>;
+ * };
+ * ```
+ *
+ * @example 异步提交弹窗（含 confirmLoading）
+ * ```tsx
+ * const [loading, setLoading] = useState(false);
+ *
+ * pushModal(
+ *   <SmallDialog
+ *     title="删除确认"
+ *     confirmLoading={loading}
+ *     onOk={async (popModal) => {
+ *       setLoading(true);
+ *       try {
+ *         await deleteResource();
+ *         popModal();
+ *       } catch (e) {
+ *         // 处理错误，弹窗保持打开
+ *       } finally {
+ *         setLoading(false);
+ *       }
+ *     }}
+ *     onCancel={(popModal) => popModal()}
+ *   >
+ *     删除后数据将无法恢复，是否继续？
+ *   </SmallDialog>
+ * );
+ * ```
+ *
+ * @see MediumDialog 中等尺寸弹窗（720px），适用于复杂表单
+ * @see ImmersiveDialog 沉浸式全屏弹窗，适用于复杂表单和详情编辑
+ * @see WizardDialog 向导式弹窗，适用于分步操作
+ * @see DeleteDialog 删除确认弹窗，基于 SmallDialog 的业务封装，位于 coreX/Dialogs/
+ * @see RejectDialog 操作拒绝反馈弹窗，基于 SmallDialog 的业务封装，位于 coreX/Dialogs/
+ */
+export interface SmallDialogProps {
+    /**
+     * 弹窗宽度
+     * @default 492
+     */
+    width?: number | string;
+    /** 弹窗标题，支持 ReactNode 自定义渲染 */
+    title: React.ReactNode;
+    /**
+     * 自定义标题渲染组件，替换默认的标题渲染逻辑。
+     * 默认标题使用 `Typo.Display.d2_bold_title` 样式。
+     */
+    TitleRender?: React.FC<{
+        title?: React.ReactNode;
+    }>;
+    /** 取消按钮文案，默认根据 `showOk` 决定：showOk=true 时为"取消"，showOk=false 时为"关闭" */
+    cancelText?: string;
+    /** 确认按钮文案，默认为"确认"；当 `initializingError` 有值时默认为"重试" */
+    okText?: string;
+    /**
+     * 是否显示确认按钮。设为 false 时仅显示取消按钮，
+     * 且取消按钮样式从 `quiet` 变为 `ordinary`，文案默认从"取消"变为"关闭"。
+     * @default true
+     */
+    showOk?: boolean;
+    /**
+     * 点击确认按钮的回调。
+     * @param popModal - 关闭当前弹窗的函数，调用后将弹窗从模态栈中移除。
+     * 在异步操作中，可先执行业务逻辑，成功后再调用 popModal() 关闭弹窗；
+     * 若未提供 onOk，点击确认按钮将直接调用 popModal() 关闭弹窗。
+     *
+     * @example
+     * ```tsx
+     * onOk={async (popModal) => {
+     *   await submitData();
+     *   popModal();
+     * }}
+     * ```
+     */
+    onOk?: (popModal: () => void) => void;
+    /**
+     * 点击取消按钮、右上角关闭按钮或遮罩层时的回调。
+     * @param popModal - 关闭当前弹窗的函数，调用后将弹窗从模态栈中移除。
+     * 若未提供 onCancel，上述关闭操作将直接调用 popModal() 关闭弹窗。
+     *
+     * @example
+     * ```tsx
+     * onCancel={(popModal) => {
+     *   // 可在关闭前执行清理逻辑
+     *   popModal();
+     * }}
+     * ```
+     */
+    onCancel?: (popModal: () => void) => void;
+    /**
+     * 是否可点击遮罩层关闭弹窗，点击遮罩层会触发 onCancel 回调
+     * @default true
+     */
+    maskClosable?: boolean;
+    /**
+     * 是否显示右上角关闭按钮，点击关闭按钮会触发 onCancel 回调
+     * @default true
+     */
+    closable?: boolean;
+    /** 自定义弹窗容器类名 */
+    className?: string;
+    /** 自定义 footer 区域类名 */
+    footerClassName?: string;
+    /** 确认按钮的额外属性，会透传给 Button 组件。若同时设置了 okText，okText 优先 */
+    okButtonProps?: ButtonProps;
+    /** 取消按钮的额外属性，会透传给 Button 组件。若同时设置了 cancelText，cancelText 优先 */
+    cancelButtonProps?: ButtonProps;
+    /** 弹窗主体内容，当 `initializing` 为 true 时显示骨架屏，当 `initializingError` 有值时显示错误状态 */
+    children?: React.ReactNode;
+    /** 展示在 footer 区域的错误文案，支持 ReactNode。最多显示 3 行，超出后 tooltip 展示完整内容 */
+    error?: React.ReactNode;
+    /**
+     * 是否隐藏 footer 区域（包括确认/取消按钮和错误信息）
+     * @default false
+     */
+    hideFooter?: boolean;
+    /**
+     * 是否在 footer 错误文案前展示错误图标
+     * @default true
+     */
+    showFooterErrorIcon?: boolean;
+    /**
+     * 确认按钮加载状态，为 true 时确认按钮显示 loading 动画且不可重复点击
+     * @default false
+     */
+    confirmLoading?: boolean;
+    /**
+     * 是否处于初始化加载中状态。为 true 时，标题显示骨架屏、
+     * 内容区域显示骨架屏（行数由 `initializingSkeletonRows` 控制）、footer 隐藏。
+     * 初始化完成后设为 false，若加载失败可设置 `initializingError` 展示错误状态。
+     */
+    initializing?: boolean;
+    /**
+     * 初始化错误内容。有值时弹窗进入错误状态：标题变为"加载失败"，
+     * 内容区域显示错误详情，确认按钮文案变为"重试"。
+     * 与 `initializing` 配合使用：先设 initializing=true 加载，
+     * 失败时设 initializing=false 且 initializingError="错误信息"。
+     */
+    initializingError?: string | React.ReactNode;
+    /**
+     * 初始化骨架屏行数，仅在 `initializing` 为 true 时生效
+     * @default 2
+     */
+    initializingSkeletonRows?: number;
+    /**
+     * 测试标识符前缀，用于自动化测试定位元素。
+     * 派生子 testid：`${testId}-cancel`（取消按钮）、`${testId}-ok`（确认按钮）、`${testId}-close`（关闭按钮）
+     */
+    "data-testid"?: string;
+}

package/dist/src/core/SmallDialog/SmallDialog.widget.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+export declare const ModelTitleSkeleton: React.FC;
+export declare const ModelContentSkeleton: React.FC<{
+    num?: number;
+}>;
+export declare const ModelInitializingError: React.FC<{
+    error?: string | React.ReactNode;
+}>;

package/dist/src/core/SmallDialog/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./SmallDialog";
+export * from "./SmallDialog.style";
+export * from "./SmallDialog.type";

package/dist/src/core/StepProgress/stepProgress.type.d.ts

@@ -2,4 +2,5 @@ export interface ICircleProgressProps {
     percent: number;
     color?: string;
     className?: string;
+    "data-testid"?: string;
 }

package/dist/src/core/Steps/steps.type.d.ts

@@ -5,6 +5,7 @@ export type StepProps = {
     title: string;
     style?: React.CSSProperties;
     disabled?: boolean;
+    "data-testid"?: string;
 };
 export type IStepsProps = {
     className?: string;

package/dist/src/core/Styled/index.d.ts

@@ -19,6 +19,12 @@ export declare const TagSpan: import("@linaria/react").StyledComponent<import("r
 export declare const FullView: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & Record<never, unknown>>;
 export declare const NameTag: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement> & Record<never, unknown>>;
 export declare const FormItemDiv: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & Record<never, unknown>>;
+/**
+ * FieldTitle 组件
+ * 使用场景：用于表单字段的标题展示
+ * 使用地方：主要在 Modal 等表单容器中使用
+ * 注意：默认字体大小为 12px，可通过 --field-title-font-size CSS 变量覆盖
+ */
 export declare const FieldTitle: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & Record<never, unknown>>;
 export declare const ExpandArrow: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLElement> & import("react").HTMLAttributes<HTMLElement> & Record<never, unknown>>;
 export declare const WarningAlert: import("@linaria/core").LinariaClassName;
@@ -45,4 +51,5 @@ export declare const RadioDesc: import("@linaria/react").StyledMeta & import("re
 }>;
 export declare const radioStyle: import("@linaria/core").LinariaClassName;
 export declare const CannotOperationInfo: import("@linaria/core").LinariaClassName;
+export declare const UnitStyle: import("@linaria/core").LinariaClassName;
 export {};

package/dist/src/core/Switch/switch.type.d.ts

@@ -1,4 +1,5 @@
 import { SwitchProps as AntdSwitchProps } from "antd/lib/switch";
 export type SwitchProps = Omit<AntdSwitchProps, "size"> & {
     size?: "small" | "default" | "large";
+    "data-testid"?: string;
 };

package/dist/src/core/Tab/Tab.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+import { TabProps } from "./Tab.type";
+export declare const Tab: (props: TabProps) => React.JSX.Element;

package/dist/src/core/Tab/Tab.style.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="react" />
+export declare const TabMenuWrapper: import("@linaria/react").StyledComponent<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & Record<never, unknown>>;
+export declare const TabTitleElStyle: import("@linaria/core").LinariaClassName;
+export declare const MoreThanTooltipStyle: import("@linaria/core").LinariaClassName;
+export declare const IconStyle: import("@linaria/core").LinariaClassName;

package/dist/src/core/Tab/Tab.type.d.ts

@@ -0,0 +1,46 @@
+import React from "react";
+/**
+ * Tab 项的数据结构
+ */
+export type TabItem = {
+    /** Tab 的唯一标识符 */
+    key: string;
+    /** Tab 的标题，可以是字符串、ReactNode 或函数 */
+    title: string | React.ReactNode | ((props: {
+        isActive: boolean;
+    }) => React.ReactNode);
+    /** Tab 的内容 */
+    children: React.ReactNode;
+    /** 测试标识，挂在 tab 标题的点击目标上 */
+    "data-testid"?: string;
+};
+/**
+ * Tab 组件的属性
+ */
+export type TabProps = {
+    /** 外层容器的类名 */
+    className?: string;
+    /** 测试标识 */
+    "data-testid"?: string;
+    /** 内容区域的类名 */
+    contentClassName?: string;
+    /** 当前选中的 Tab 的 key */
+    selectedKey: string;
+    /** Tab 列表 */
+    tabs: TabItem[];
+    /** Tab 切换时的回调 */
+    onChange?: (key: string) => void;
+    /** 额外的插槽内容，显示在 tab bar 的右侧 */
+    extraSlot?: React.ReactNode;
+    /** Tab 的大小 */
+    size?: "small" | "medium";
+};
+/**
+ * 激活 Tab 的类型枚举
+ */
+export declare enum ActiveTabType {
+    /** 普通类型的 Tab */
+    Common = 0,
+    /** 在更多菜单中的 Tab */
+    More = 1
+}

package/dist/src/core/Tab/index.d.ts

@@ -0,0 +1 @@
+export * from "./Tab";

package/dist/src/core/Tab/useTabAdaptiveLayout.d.ts

@@ -0,0 +1,23 @@
+import { TabItem } from "../../core/Tab/Tab.type";
+import { RefObject } from "react";
+/**
+ * Tab 自适应布局 Hook
+ *
+ * 根据可用空间自动计算哪些 tab 需要隐藏到"更多"菜单中。
+ * 当容器尺寸变化、tabs 列表变化或 selectedKey 变化时，会自动重新计算布局。
+ *
+ * @param tabs - Tab 列表
+ * @param tabsRef - Tab 容器的 ref
+ * @param extraSlotRef - 额外插槽的 ref（用于计算可用宽度）
+ * @param selectedKey - 当前选中的 tab key（用于触发重新计算，当选中项在"更多"菜单中时会影响按钮宽度）
+ *
+ * @returns moreTabs - 需要隐藏到"更多"菜单的 tabs 列表
+ *
+ * @example
+ * ```tsx
+ * const tabsRef = useRef<HTMLDivElement>(null);
+ * const extraSlotRef = useRef<HTMLDivElement>(null);
+ * const moreTabs = useTabAdaptiveLayout(tabs, tabsRef, extraSlotRef, selectedKey);
+ * ```
+ */
+export declare const useTabAdaptiveLayout: (tabs: TabItem[], tabsRef: RefObject<HTMLDivElement>, extraSlotRef: RefObject<HTMLDivElement>, selectedKey?: string) => TabItem[];