@pisell/materials 1.8.12 → 1.8.13

package/es/components/Pagination/index.d.ts

@@ -1,14 +1,12 @@
-import React from "react";
-import { PaginationProps } from "antd";
-import "./index.less";
+import { PaginationProps } from 'antd';
+import './index.less';
+declare const Pagination: (props: PaginationProps) => JSX.Element | null;
 export declare const paginationConfig: {
     className: string;
     defaultCurrent: number;
     showTotal: (total: number, range: [number, number]) => string;
-    itemRender: (page: number, type: "page" | "next" | "prev" | "jump-prev" | "jump-next", element: React.ReactNode) => React.ReactNode;
     responsive: boolean;
     size: string;
 };
-declare const Pagination: (props: PaginationProps) => JSX.Element | null;
 export default Pagination;
 export declare const FormPagination: ({ value, onChange, page, pageSize, ...other }: any) => JSX.Element;

package/es/components/Pagination/index.js

@@ -8,74 +8,89 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
-import React, { useEffect, useMemo, useState } from "react";
+import React, { useEffect, useMemo, useState } from 'react';
 // import { ArrowLeft, ArrowRight } from "@pisell/icon/es";
-import ArrowRight from "@pisell/icon/es/ArrowRight";
-import ArrowLeft from "@pisell/icon/es/ArrowLeft";
-import { Pagination as OriginPagination } from "antd";
-import classNames from "classnames";
+import ArrowRight from '@pisell/icon/es/ArrowRight';
+import ArrowLeft from '@pisell/icon/es/ArrowLeft';
+import { Pagination as OriginPagination } from 'antd';
+import classNames from 'classnames';
 import "./index.less";
+import { locales as utilsLocales } from '@pisell/utils';
 import { getText } from "../../locales";
 import useIsMobileTable from "../table/hooks/useIsMobileTable";
-
-/**
- * @title: 自定义渲染
- * @description:
- * @return {*}
- * @Author: zhiwei.Wang
- * @Date: 2023-07-20 17:01
- */
-var itemRender = function itemRender(_, type, originalElement) {
-  if (type === "prev") {
-    return /*#__PURE__*/React.createElement("div", {
-      className: classNames("paginator-page-btn", "left")
-    }, /*#__PURE__*/React.createElement(ArrowLeft, {
-      className: "paginator-page-btn-left-icon"
-    }), /*#__PURE__*/React.createElement("span", {
-      className: "paginator-page-btn-text"
-    }, getText("table-pagination-previous")));
-  }
-  if (type === "next") {
-    return /*#__PURE__*/React.createElement("div", {
-      className: classNames("paginator-page-btn", "right")
-    }, /*#__PURE__*/React.createElement("span", {
-      className: "paginator-page-btn-text"
-    }, getText("table-pagination-next")), /*#__PURE__*/React.createElement(ArrowRight, {
-      className: "paginator-page-btn-right-icon"
-    }));
-  }
-  return originalElement;
-};
-
-// 分页配置
-export var paginationConfig = {
-  className: "materials-grid-paginator",
-  defaultCurrent: 1,
-  showTotal: function showTotal(total, range) {
-    return "Page ".concat(range[0], " of ").concat(range[1]);
-  },
-  itemRender: itemRender,
-  responsive: true,
-  size: "small"
-};
+/** 优先 utils；若 utils 返回 key（未命中）则用 materials RecordBoard 再回退 table-pagination-* */
+function getPaginationText(key) {
+  var _getText;
+  var fullKey = "pisell2.salesManagement.pagination.".concat(key);
+  var fromUtils = utilsLocales.getText(fullKey);
+  if (fromUtils !== fullKey) return fromUtils;
+  return (_getText = getText(fullKey)) !== null && _getText !== void 0 ? _getText : getText("table-pagination-".concat(key));
+}
 var Pagination = function Pagination(props) {
   var show = useMemo(function () {
     return Object.keys(props).length;
   }, [props]);
   var isMiniPagination = useIsMobileTable();
+  var effectiveConfig = useMemo(function () {
+    var prevText = getPaginationText('previous');
+    var nextText = getPaginationText('next');
+    var showTotalFn = getPaginationText('showTotal');
+    var itemRenderFn = function itemRenderFn(_, type, originalElement) {
+      if (type === 'prev') {
+        return /*#__PURE__*/React.createElement("div", {
+          className: classNames('paginator-page-btn', 'left')
+        }, /*#__PURE__*/React.createElement(ArrowLeft, {
+          className: 'paginator-page-btn-left-icon'
+        }), /*#__PURE__*/React.createElement("span", {
+          className: 'paginator-page-btn-text'
+        }, prevText));
+      }
+      if (type === 'next') {
+        return /*#__PURE__*/React.createElement("div", {
+          className: classNames('paginator-page-btn', 'right')
+        }, /*#__PURE__*/React.createElement("span", {
+          className: 'paginator-page-btn-text'
+        }, nextText), /*#__PURE__*/React.createElement(ArrowRight, {
+          className: 'paginator-page-btn-right-icon'
+        }));
+      }
+      return originalElement;
+    };
+    var showTotal = typeof showTotalFn === 'function' ? function (total, range) {
+      return showTotalFn(range[0], range[1]);
+    } : function (total, range) {
+      return "Page ".concat(range[0], " of ").concat(range[1]);
+    };
+    return {
+      className: 'materials-grid-paginator',
+      defaultCurrent: 1,
+      showTotal: showTotal,
+      itemRender: itemRenderFn,
+      responsive: true,
+      size: 'small'
+    };
+  }, []);
   var content = useMemo(function () {
     if (!show) {
       return null;
     }
     var Com = OriginPagination;
-    // 移动端使用简单分页
     if (isMiniPagination) {
       Com = MiniPagination;
     }
-    return /*#__PURE__*/React.createElement(Com, _extends({}, paginationConfig, props));
-  }, [show, paginationConfig, props, isMiniPagination]);
+    return /*#__PURE__*/React.createElement(Com, _extends({}, effectiveConfig, props));
+  }, [show, effectiveConfig, props, isMiniPagination]);
   return content;
 };
+export var paginationConfig = {
+  className: 'materials-grid-paginator',
+  defaultCurrent: 1,
+  showTotal: function showTotal(total, range) {
+    return "Page ".concat(range[0], " of ").concat(range[1]);
+  },
+  responsive: true,
+  size: 'small'
+};
 export default Pagination;
 var MiniPagination = function MiniPagination(props) {
   var _props$current = props.current,
@@ -105,44 +120,47 @@ var MiniPagination = function MiniPagination(props) {
    */
   var onChange = function onChange(type) {
     var currentPage = current;
-    if (type === "prev") {
+    if (type === 'prev') {
       currentPage = current - 1;
     }
-    if (type === "next") {
+    if (type === 'next') {
       currentPage = current + 1;
     }
     props.onChange && props.onChange(currentPage, pageSize || 10);
   };
   return /*#__PURE__*/React.createElement("div", {
-    className: "materials-grid-paginator materials-grid-paginator-mini"
+    className: "materials-grid-paginator"
   }, /*#__PURE__*/React.createElement("div", {
     className: "pisell-lowcode-pagination-prev",
     onClick: function onClick() {
       if (current <= MIN) {
         return;
       }
-      onChange("prev");
+      onChange('prev');
     }
   }, /*#__PURE__*/React.createElement("div", {
-    className: classNames("paginator-page-btn", "left")
+    className: classNames('paginator-page-btn', 'left')
   }, /*#__PURE__*/React.createElement(ArrowLeft, {
-    className: "paginator-page-btn-left-icon"
+    className: 'paginator-page-btn-left-icon'
   }))), /*#__PURE__*/React.createElement("div", {
     className: "materials-grid-paginator-center"
   }, /*#__PURE__*/React.createElement("span", {
     className: "materials-grid-paginator-center-text"
-  }, getText("table-pagination-total")(current, MAX))), /*#__PURE__*/React.createElement("div", {
+  }, function () {
+    var totalFn = getPaginationText('total');
+    return typeof totalFn === 'function' ? totalFn(current, MAX) : "".concat(current, " / ").concat(MAX);
+  }())), /*#__PURE__*/React.createElement("div", {
     className: "pisell-lowcode-pagination-next",
     onClick: function onClick() {
       if (current >= MAX) {
         return;
       }
-      onChange("next");
+      onChange('next');
     }
   }, /*#__PURE__*/React.createElement("div", {
-    className: classNames("paginator-page-btn", "right")
+    className: classNames('paginator-page-btn', 'right')
   }, /*#__PURE__*/React.createElement(ArrowRight, {
-    className: "paginator-page-btn-right-icon"
+    className: 'paginator-page-btn-right-icon'
   }))));
 };
 export var FormPagination = function FormPagination(_ref) {

package/es/components/Pagination/index.less

@@ -24,7 +24,6 @@
 
   .pisell-lowcode-pagination-item {
     position: relative;
-    border: none;
     margin: 0;
     border-radius: 0;
     border: 1px solid #D0D5DD;
@@ -36,6 +35,7 @@
     margin: 0;
     border-radius: 0;
     border-right: none;
+    height: 100%;
   }
 
   .pisell-lowcode-pagination-jump-next {
@@ -45,22 +45,28 @@
     border-right: none;
   }
 
-  .pisell-lowcode-pagination-item-link:hover {
-    font-weight: 450 !important;
-    color: rgba(0, 0, 0, 0.88) !important;
+  .pisell-lowcode-pagination-item-link {
+    width: 100%;
 
-    .pisell-lowcode-pagination-item-link-icon {
+    &:hover {
       font-weight: 450 !important;
       color: rgba(0, 0, 0, 0.88) !important;
+
+      .pisell-lowcode-pagination-item-link-icon {
+        font-weight: 450 !important;
+        color: rgba(0, 0, 0, 0.88) !important;
+      }
     }
   }
 
+
   .pisell-lowcode-pagination-disabled {
     cursor: not-allowed;
-    color: rgba(0,0,0,.25);
+    color: rgba(0, 0, 0, .25);
+
     .paginator-page-btn {
       cursor: not-allowed;
-      color: rgba(0,0,0,.25);
+      color: rgba(0, 0, 0, .25);
     }
   }
 

package/es/components/PisellFields/index.d.ts

@@ -16,8 +16,8 @@ declare const PisellFields: {
     Currency: import("react").NamedExoticComponent<import("../pisellCurrency").PisellCurrencyProps>;
     Percent: import("react").NamedExoticComponent<import("../pisellPercent").PisellPercentProps>;
     Phone: import("react").NamedExoticComponent<import("../pisellPhone").PisellPhoneProps>;
-    Email: import("react").FC<import("../pisellEmail").PisellEmailProps>;
-    Url: import("react").FC<import("../pisellUrl").PisellUrlProps>;
+    Email: import("react").NamedExoticComponent<import("../pisellEmail").PisellEmailProps>;
+    Url: import("react").NamedExoticComponent<import("../pisellUrl").PisellUrlProps>;
     Rating: import("react").NamedExoticComponent<import("../pisellRating").PisellRatingProps>;
     SingleSelect: import("react").ForwardRefExoticComponent<import("../pisellSingleSelect").PisellSingleSelectProps<string | number> & import("react").RefAttributes<import("../pisellSingleSelect").SingleSelectRef<string | number>>>;
     MultipleSelect: import("react").ForwardRefExoticComponent<import("../pisellMultipleSelect").PisellMultipleSelectProps<string | number> & import("react").RefAttributes<import("../pisellMultipleSelect").MultipleSelectRef<string | number>>>;

package/es/components/PisellSuperTabs/PisellSuperTabs.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import './PisellSuperTabs.less';
+import type { PisellSuperTabsProps } from './types';
+interface PisellSuperTabsRef {
+    scrollItemByRowKey: (key: string) => void;
+}
+declare const _default: React.ForwardRefExoticComponent<PisellSuperTabsProps<unknown> & React.RefAttributes<PisellSuperTabsRef>>;
+export default _default;

package/es/components/PisellSuperTabs/hooks/useTabsState.d.ts

@@ -0,0 +1,7 @@
+import { UseTabsStateParams, UseTabsStateReturn } from '../types';
+/**
+ * Tabs 状态管理 Hook
+ * @description 处理受控/非受控模式的状态管理
+ * @template T - 数据项类型
+ */
+export declare const useTabsState: <T = any>(params: UseTabsStateParams<T>) => UseTabsStateReturn<T>;

package/es/components/PisellSuperTabs/types.d.ts

@@ -0,0 +1,212 @@
+import { CSSProperties, ReactNode } from 'react';
+import type { PisellBasicGridProps } from '../PisellBasicGrid/types';
+import type { PisellScrollViewProps } from '../PisellScrollView/types';
+import type { PisellBasicCardProps } from '../PisellCards/types';
+/**
+ * useTabsState Hook 参数
+ */
+export interface UseTabsStateParams<T = any> {
+    isControlled: boolean;
+    /**
+     * 当前激活的 Tab key（受控）
+     */
+    value?: string;
+    /**
+     * 默认激活的 Tab key（非受控）
+     */
+    defaultValue?: string;
+    /**
+     * Tab 切换时的回调
+     */
+    onChange?: (key: string, item: T) => void;
+}
+/**
+ * useTabsState Hook 返回值
+ */
+export interface UseTabsStateReturn<T = any> {
+    /**
+     * 当前激活的 Tab key
+     */
+    activeKey: string | undefined;
+    /**
+     * 切换 Tab 的方法
+     */
+    handleTabChange: (key: string, item: T) => void;
+}
+export interface RenderItemProps<T = any> extends PisellBasicCardProps {
+    index: number;
+    tabsState: UseTabsStateReturn<T>;
+    tabsProps: PisellSuperTabsProps<T>;
+}
+/**
+ * PisellSuperTabs 组件 Props
+ * @template T - 数据源项的类型
+ * @description 通用导航框架封装的全能型 Tab 组件
+ */
+export interface PisellSuperTabsProps<T = any> {
+    isControlled?: boolean;
+    /**
+     * 自定义类名
+     * @description 添加到最外层容器的类名
+     */
+    className?: string;
+    tabItemClassName?: string;
+    tabItemStyle?: CSSProperties;
+    /**
+     * 自定义样式
+     * @description 添加到最外层容器的样式
+     */
+    style?: CSSProperties;
+    /**
+     * 唯一标识
+     * @description 必填，用于区分不同的 TabItem
+     */
+    id?: string;
+    /**
+     * 数据源
+     * @description 支持多级嵌套，递归字段为 children
+     * @example
+     * [
+     *   { key: 'home', label: '首页' },
+     *   { key: 'products', label: '产品', children: [...] }
+     * ]
+     */
+    dataSource?: T[];
+    /**
+     * 数据项的唯一标识字段
+     * @default 'key'
+     * @description 可以是字符串（字段名）或函数（自定义获取逻辑）
+     * @example
+     * // 字符串形式
+     * rowKey="id"
+     *
+     * // 函数形式
+     * rowKey={(record, index) => `${record.type}-${index}`}
+     */
+    rowKey?: string | ((record: T, index: number) => string);
+    /**
+     * 当前激活的 Tab key
+     * @description 受控模式，需配合 onChange 使用
+     */
+    value?: string;
+    /**
+     * 默认激活的 Tab key
+     * @description 非受控模式，仅初始化时生效
+     */
+    defaultValue?: string;
+    /**
+     * Tab 切换时的回调
+     * @param key - 切换到的 Tab key
+     * @param item - 切换到的数据项
+     */
+    onChange?: (key: string, item: T) => void;
+    /**
+     * 自定义 TabItem 渲染
+     * @description 支持两种模式：
+     * 1. 函数模式：(item, index, active) => ReactNode
+     * 2. 插槽模式：直接传入 ReactNode
+     * @example
+     * // 函数模式
+     * renderItem={(item, index, active) => (
+     *   <PisellCards.TabCard
+     *     {...item}
+     *     active={{ value: active }}
+     *   />
+     * )}
+     *
+     * // 插槽模式
+     * renderItem={<PisellCards.TabCard />}
+     */
+    renderItem?: ((props: RenderItemProps<T>) => ReactNode) | ReactNode;
+    /**
+     * PisellBasicGrid 组件的配置
+     * @description 透传给 PisellBasicGrid 组件的所有 Props
+     * @see PisellBasicGridProps
+     * @example
+     * gridProps={{
+     *   direction: 'horizontal',
+     *   gap: 16,
+     *   wrap: 'wrap',
+     *   columns: 4,
+     * }}
+     */
+    gridProps?: Omit<PisellBasicGridProps<T>, 'dataSource' | 'renderItem' | 'rowKey' | 'children'>;
+    /**
+     * PisellScrollView 组件的配置
+     * @description 透传给 PisellScrollView 组件的所有 Props
+     * @see PisellScrollViewProps
+     * @example
+     * scrollViewProps={{
+     *   overflow: 'x',
+     *   scrollbarStyle: 'thin',
+     *   scrollActionsConfig: { show: true, type: 'lrArrows' },
+     * }}
+     */
+    scrollViewProps?: Omit<PisellScrollViewProps, 'children'>;
+    children?: ReactNode;
+    /**
+     * 左侧插槽
+     */
+    slotLeft?: ReactNode;
+    slotLeftClassName?: string;
+    slotLeftStyle?: CSSProperties;
+    /**
+     * 右侧插槽
+     */
+    slotRight?: ReactNode;
+    slotRightClassName?: string;
+    slotRightStyle?: CSSProperties;
+    /**
+     * 顶部插槽
+     */
+    slotTop?: ReactNode;
+    slotTopClassName?: string;
+    slotTopStyle?: CSSProperties;
+    /**
+     * 底部插槽
+     */
+    slotBottom?: ReactNode;
+    slotBottomClassName?: string;
+    slotBottomStyle?: CSSProperties;
+    __designMode?: boolean;
+}
+/**
+ * 数据项基础类型
+ * @description 建议数据源中的每一项都包含这些字段
+ */
+export interface TabDataItem {
+    /**
+     * 唯一标识
+     * @description 必填，用于区分不同的 TabItem
+     */
+    key: string;
+    /**
+     * 标签文本
+     */
+    label?: string;
+    /**
+     * 图标
+     */
+    icon?: ReactNode;
+    /**
+     * 徽章配置
+     */
+    badge?: {
+        count?: number;
+        dot?: boolean;
+        text?: string;
+    };
+    /**
+     * 子级数据（多级嵌套）
+     * @description 用于多级导航场景，具体渲染逻辑由 Card 组件实现
+     */
+    children?: TabDataItem[];
+    /**
+     * 是否禁用
+     */
+    disabled?: boolean;
+    /**
+     * 其他自定义字段
+     */
+    [key: string]: any;
+}

package/es/components/PisellTabbar/PisellTabbar.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import './PisellTabbar.less';
+import { PisellTabbarProps } from './types';
+/**
+ * PisellTabbar - 多层级 Tabbar 组件
+ *
+ * 支持最多 3 层级的 Tab 导航，每层级可独立展开/收起
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <PisellTabbar
+ *   dataSource={categoryData}
+ *   value={[1, 10, 100]}
+ *   onChange={(value) => console.log('当前选中:', value)}
+ * />
+ * ```
+ */
+declare const PisellTabbar: React.FC<PisellTabbarProps>;
+export default PisellTabbar;

package/es/components/PisellTabbar/constants.d.ts

@@ -0,0 +1,47 @@
+import { TabbarLevelConfig, ExpandConfig, LevelType } from './types';
+/**
+ * 默认层级配置
+ */
+export declare const DEFAULT_LEVEL_CONFIG: Record<LevelType, TabbarLevelConfig>;
+/**
+ * 获取展开配置
+ */
+export declare const getExpandConfig: () => ExpandConfig;
+/**
+ * 默认数据项配置
+ */
+export declare const DEFAULT_ITEMS: {
+    all: {
+        id: string;
+        shop_id: number;
+        parent_id: number;
+        name: any;
+        slug: string;
+        icon: string;
+    };
+    search: {
+        id: string;
+        shop_id: number;
+        parent_id: number;
+        name: any;
+        text: any;
+        slug: string;
+        key: string;
+        icon: string;
+        customClick: boolean;
+    };
+    expand: {
+        id: string;
+        shop_id: number;
+        parent_id: number;
+        key: string;
+        icon: string;
+        name: string;
+        slug: string;
+        customClick: boolean;
+    };
+};
+/**
+ * 获取层级对应的添加项配置
+ */
+export declare const LEVEL_ADD_ITEMS: Record<LevelType, ('all' | 'search' | 'expand')[]>;

package/es/components/PisellTabbar/hooks/useActiveKey.d.ts

@@ -0,0 +1,55 @@
+/**
+ * useActiveKey Hook 参数
+ */
+interface UseActiveKeyProps {
+    /** 初始激活的 key 数组（对应多层级） */
+    initialActiveKey?: (string | number)[];
+    /** key 变化回调 */
+    onChange?: (value: (string | number)[]) => void;
+}
+/**
+ * useActiveKey Hook 返回值
+ */
+interface UseActiveKeyReturn {
+    /** 当前激活的 key 数组 */
+    activeKey: (string | number)[];
+    /** 设置指定层级的激活 key */
+    setActiveKey: (level: number, key: string | number, cKey?: string | number) => void;
+    /** 获取指定层级的激活 key */
+    getActiveKey: (level: number) => string | number;
+    /** 内部设置方法（用于同步外部值） */
+    _setActiveKey: (value: (string | number)[]) => void;
+    /** 设置缓存key */
+    setCacheActiveKey: (val: (string | number)[]) => void;
+    /** 重置value为缓存key */
+    resetActiveKey: () => void;
+    /** 获取缓存key */
+    getCacheActiveKey: () => (string | number)[];
+}
+/**
+ * Tabbar 激活状态管理 Hook
+ *
+ * 用于管理多层级 Tabbar 的激活状态，支持级联选择
+ *
+ * @param props - Hook 配置参数
+ * @returns 激活状态和操作方法
+ *
+ * @example
+ * ```tsx
+ * const { activeKey, setActiveKey, getActiveKey } = useActiveKey({
+ *   initialActiveKey: [1, 10],
+ *   onChange: (value) => console.log('当前选中:', value)
+ * });
+ *
+ * // 设置第 0 层级的 key，并清除后续层级
+ * setActiveKey(0, '2');
+ *
+ * // 设置第 0 层级的 key，并同时设置第 1 层级
+ * setActiveKey(0, '2', '20');
+ *
+ * // 获取第 0 层级的 key
+ * const level0Key = getActiveKey(0);
+ * ```
+ */
+declare const useActiveKey: (props: UseActiveKeyProps) => UseActiveKeyReturn;
+export default useActiveKey;

package/es/components/PisellTabbar/hooks/useExpand.d.ts

@@ -0,0 +1,42 @@
+import { ExpandState, LevelType } from '../types';
+/**
+ * useExpand Hook 参数
+ */
+interface UseExpandProps {
+    /** 初始展开状态 */
+    initialExpand?: Partial<ExpandState>;
+}
+/**
+ * useExpand Hook 返回值
+ */
+interface UseExpandReturn {
+    /** 展开状态 */
+    expand: ExpandState;
+    /** 设置展开状态 */
+    setExpand: (state: ExpandState) => void;
+    /** 切换指定层级的展开状态 */
+    toggleExpand: (level: LevelType) => void;
+    /** 获取指定层级的展开状态 */
+    getExpand: (level: LevelType) => boolean;
+    closeAll: () => void;
+}
+/**
+ * Tabbar 展开状态管理 Hook
+ * 用于管理多层级的展开/收起状态
+ *
+ * @param props - Hook 配置参数
+ * @returns 展开状态和操作方法
+ *
+ * @example
+ * ```tsx
+ * const { expand, toggleExpand, getExpand } = useExpand({
+ *   initialExpand: { level1: false }
+ * });
+ *
+ * <button onClick={() => toggleExpand('level1')}>
+ *   {getExpand('level1') ? '收起' : '展开'}
+ * </button>
+ * ```
+ */
+declare const useExpand: (props?: UseExpandProps) => UseExpandReturn;
+export default useExpand;