@zscloud/design 0.2.0

package/dist/components/primitive/tree/tree.d.ts

@@ -0,0 +1,24 @@
+import { TreeApi } from 'react-arborist';
+import { TreeProps, TreeNode } from './types';
+/**
+ * Tree 组件
+ *
+ * 基于 react-arborist 封装的高性能树组件，支持：
+ * - 虚拟滚动（可处理上万节点）
+ * - 拖拽排序
+ * - 搜索过滤
+ * - 键盘导航
+ * - 完全自定义节点渲染
+ *
+ * @example
+ * ```tsx
+ * <Tree
+ *   data={treeData}
+ *   height={400}
+ *   onSelect={(nodes) => console.log('selected:', nodes)}
+ * />
+ * ```
+ */
+export declare function Tree<T = unknown>({ data, height, width, indent, rowHeight, overscanCount, selection, onSelect, disableMultiSelection, disableDrag, disableDrop, onMove, canDrop, searchTerm, searchMatch, openByDefault, initialOpenState, children, className, }: TreeProps<T>): import("react/jsx-runtime").JSX.Element;
+export type TreeRef<T = unknown> = TreeApi<TreeNode<T>>;
+export default Tree;

package/dist/components/primitive/tree/types.d.ts

@@ -0,0 +1,123 @@
+import { NodeApi, NodeRendererProps } from 'react-arborist';
+/**
+ * 树节点数据结构
+ * @template T 节点附加数据类型
+ */
+export interface TreeNode<T = unknown> {
+    /** 节点唯一标识 */
+    id: string;
+    /** 节点名称（用于搜索匹配） */
+    name: string;
+    /** 子节点 */
+    children?: TreeNode<T>[];
+    /** 节点是否禁用 */
+    disabled?: boolean;
+    /** 节点附加数据 */
+    data?: T;
+}
+/**
+ * 拖拽移动事件参数
+ */
+export interface TreeMoveEvent {
+    /** 被拖拽的节点ID数组 */
+    dragIds: string[];
+    /** 目标父节点ID，null表示根级别 */
+    parentId: string | null;
+    /** 目标索引位置 */
+    index: number;
+}
+/**
+ * Tree 组件属性
+ * @template T 节点附加数据类型
+ */
+export interface TreeProps<T = unknown> {
+    /** 树数据 */
+    data: TreeNode<T>[];
+    /** 树高度（用于虚拟滚动） */
+    height?: number;
+    /** 树宽度 */
+    width?: string | number;
+    /** 缩进宽度（默认24px） */
+    indent?: number;
+    /** 行高（默认32px） */
+    rowHeight?: number;
+    /** 超出渲染数量（虚拟滚动优化） */
+    overscanCount?: number;
+    /** 当前选中的节点ID（单选时为string，多选时为string[]） */
+    selection?: string | string[];
+    /** 选择变化回调 */
+    onSelect?: (nodes: NodeApi<TreeNode<T>>[]) => void;
+    /** 是否禁用选择 */
+    disableMultiSelection?: boolean;
+    /** 是否禁用拖拽 */
+    disableDrag?: boolean;
+    /** 是否禁用放置 */
+    disableDrop?: boolean;
+    /** 拖拽移动回调 */
+    onMove?: (event: TreeMoveEvent) => void;
+    /** 自定义禁用放置判断 */
+    canDrop?: (args: {
+        parentNode: NodeApi<TreeNode<T>> | null;
+        dragNodes: NodeApi<TreeNode<T>>[];
+        index: number;
+    }) => boolean;
+    /** 搜索关键词 */
+    searchTerm?: string;
+    /** 自定义搜索匹配函数 */
+    searchMatch?: (node: NodeApi<TreeNode<T>>, term: string) => boolean;
+    /** 默认是否全部展开 */
+    openByDefault?: boolean;
+    /** 初始展开状态 */
+    initialOpenState?: Record<string, boolean>;
+    /** 自定义节点渲染 */
+    children?: (props: NodeRendererProps<TreeNode<T>>) => React.ReactNode;
+    /** 自定义类名 */
+    className?: string;
+}
+/**
+ * TreeSelect 组件属性
+ * @template T 节点附加数据类型
+ */
+export interface TreeSelectProps<T = unknown> {
+    /** 当前选中的节点ID */
+    value?: string;
+    /** 选择变化回调 */
+    onChange?: (value: string, node: TreeNode<T> | undefined) => void;
+    /** 树数据 */
+    data: TreeNode<T>[];
+    /** 占位符文本 */
+    placeholder?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 选择框宽度 */
+    width?: number | string;
+    /** 下拉面板宽度 */
+    dropdownWidth?: number | string;
+    /** 树高度 */
+    treeHeight?: number;
+    /** 是否显示搜索框 */
+    showSearch?: boolean;
+    /** 搜索框占位符 */
+    searchPlaceholder?: string;
+    /** 自定义类名 */
+    className?: string;
+    /** 空数据时的提示文本 */
+    emptyText?: string;
+    /** 是否允许清除 */
+    allowClear?: boolean;
+    /** 清除回调 */
+    onClear?: () => void;
+    /** 缩进宽度 */
+    indent?: number;
+    /** 行高 */
+    rowHeight?: number;
+    /** 是否默认展开所有节点 */
+    openByDefault?: boolean;
+    /** 自定义渲染选中值 */
+    renderValue?: (node: TreeNode<T> | undefined) => React.ReactNode;
+    /** 自定义节点渲染 */
+    renderNode?: (props: NodeRendererProps<TreeNode<T>>) => React.ReactNode;
+    /** Popover 的 portal 容器 */
+    portalContainer?: HTMLElement | null;
+}
+export type { NodeApi, NodeRendererProps };

package/dist/i18n/locales/en-US.json.d.ts

@@ -0,0 +1,76 @@
+declare const _default: {
+  "backup.prevPage": "Go Back",
+  "batchAction": "Bulk Action",
+  "cancel": "Cancel",
+  "cancel.selection": "Unselect",
+  "colon": ":",
+  "comma": ",",
+  "confirm": "OK",
+  "confirm.cancel": "Cancel",
+  "confirm.delete.new": "Confirm to Delete",
+  "confirm.ok": "OK",
+  "copy": "Copy",
+  "copy.successfully": "Copy Succeeded",
+  "customColumnItem": "Custom Column Item",
+  "dataTable.available": "Available: {available}",
+  "datatable.pagination": "{order}-{orderAll} Item. Total {count} Items.",
+  "datatable.pagination.empty": "Total 0 Items",
+  "datatable.search.no.results": "No results found.",
+  "date.end": "End Date",
+  "date.start": "Start Date",
+  "description": "Description",
+  "dialog.deletion.have.confirm.above.info.full": "I acknowledge the risks. Enter {confirmWord} to continue the action.",
+  "dialog.deletion.have.confirm.above.info.password": "Login Password",
+  "dialog.deletion.have.confirm.above.info.password.full": "I acknowledge the risks. Enter the {loginPassword} of the current user ({username}) to continue the action.",
+  "error.boundary.back": "Back",
+  "error.boundary.detail": "An unknown exception has occurred, please try to refresh the page or contact our customer service for assistance.",
+  "error.boundary.reload": "Reload",
+  "error.boundary.title": "Something went wrong.",
+  "export.action.all": "Export All",
+  "export.action.currentPage": "Export Current Page",
+  "export.all": "All",
+  "export.currentPage": "Current Page",
+  "filter": "Filter",
+  "fuzzy.search": "Automatic",
+  "has.selectedCount": "Selected Items:  {selectedCount}",
+  "have.selected": "Selected",
+  "have.selected.item": " Item",
+  "i.have.acknowledged.above.risk": "I acknowledge",
+  "imageReader.adapt": "Fit to window",
+  "imageReader.zoomIn": "Zoom in",
+  "imageReader.zoomOut": "Zoom out",
+  "more.action": "Actions",
+  "multiSelect.clear": "Clear",
+  "multiSelect.selectAll": "Select All",
+  "multiSelect.selected": "Selected ({count})",
+  "name": "Name",
+  "no.data": "No data available.",
+  "no.resource.detail": "The resource does not exist or has been deleted. Refresh the page or contact the administrator.",
+  "no.resource.title": "Resource Not Found",
+  "noAccess": "Unauthorized Field",
+  "none": "None",
+  "ok": "OK",
+  "owner": "Owner",
+  "pagination.item.page": "Item/Page",
+  "pagination.jump.to": "Jump to",
+  "pagination.page": "Page",
+  "please.check.to.confirm.delete": "Acknowledge the risk.",
+  "please.enter.delete.confirm.delete": "Please enter \"delete\" to continue the action.",
+  "please.enter.right.password": "Enter the correct password to continue the action.",
+  "reset": "Reset",
+  "saveCustomColumnItem": "Save Custom Column Items",
+  "select.empty": "No data.",
+  "status": "State",
+  "table.custom.column.all": "All Columns ({count}/{all})",
+  "table.custom.column.selected": "Selected ({count})",
+  "table.export.cancelSelection": "Unselect",
+  "table.export.item": "Exported Items",
+  "table.export.selectAll": "Select All",
+  "temporarilyNoDescription": "No description",
+  "understandMore": "Learn more.",
+  "unknown.user": "Unknown User",
+  "uuid": "UUID"
+}
+;
+
+export default _default;

package/dist/i18n/locales/zh-CN.json.d.ts

@@ -0,0 +1,76 @@
+declare const _default: {
+  "backup.prevPage": "返回上一页",
+  "batchAction": "批量操作",
+  "cancel": "取消",
+  "cancel.selection": "取消选择",
+  "colon": "：",
+  "comma": "，",
+  "confirm": "确定",
+  "confirm.cancel": "取消",
+  "confirm.delete.new": "确定删除",
+  "confirm.ok": "确定",
+  "copy": "复制",
+  "copy.successfully": "复制成功",
+  "customColumnItem": "自定义列表项",
+  "dataTable.available": "可用：{available}",
+  "datatable.pagination": "第 {order}-{orderAll} 项，共 {count} 项",
+  "datatable.pagination.empty": "共 0 项",
+  "datatable.search.no.results": "未找到相关内容",
+  "date.end": "结束日期",
+  "date.start": "开始日期",
+  "description": "简介",
+  "dialog.deletion.have.confirm.above.info.full": "我已知晓以上风险。输入{confirmWord}确认删除。",
+  "dialog.deletion.have.confirm.above.info.password": "登录密码",
+  "dialog.deletion.have.confirm.above.info.password.full": "我已知晓以上风险。请输入当前账号（{username}）的{loginPassword}确认删除。",
+  "error.boundary.back": "返回上一页",
+  "error.boundary.detail": "发生了一个未知异常，请尝试刷新页面，或者联系我们的客服人员以获取帮助",
+  "error.boundary.reload": "重新加载",
+  "error.boundary.title": "出错了",
+  "export.action.all": "导出全部",
+  "export.action.currentPage": "导出当前页",
+  "export.all": "全部",
+  "export.currentPage": "当前页",
+  "filter": "筛选",
+  "fuzzy.search": "自动识别",
+  "has.selectedCount": "已选择 {selectedCount} 项",
+  "have.selected": "已选择",
+  "have.selected.item": "项",
+  "i.have.acknowledged.above.risk": "我已知晓上述风险",
+  "imageReader.adapt": "适应窗口",
+  "imageReader.zoomIn": "放大",
+  "imageReader.zoomOut": "缩小",
+  "more.action": "更多操作",
+  "multiSelect.clear": "清空",
+  "multiSelect.selectAll": "全选",
+  "multiSelect.selected": "已选({count})",
+  "name": "名称",
+  "no.data": "暂无数据",
+  "no.resource.detail": "访问的资源不存在或已删除。请刷新页面，或联系管理员。",
+  "no.resource.title": "资源不存在或已删除",
+  "noAccess": "无权限字段",
+  "none": "无",
+  "ok": "确定",
+  "owner": "所有者",
+  "pagination.item.page": "项/页",
+  "pagination.jump.to": "跳至",
+  "pagination.page": "页",
+  "please.check.to.confirm.delete": "请先勾选风险提示",
+  "please.enter.delete.confirm.delete": "请输入delete确认删除",
+  "please.enter.right.password": "请输入正确的登录密码确认删除",
+  "reset": "重置",
+  "saveCustomColumnItem": "保存自定义列表项",
+  "select.empty": "暂无数据",
+  "status": "状态",
+  "table.custom.column.all": "全部列({count}/{all})",
+  "table.custom.column.selected": "已选({count})",
+  "table.export.cancelSelection": "取消选择",
+  "table.export.item": "导出项",
+  "table.export.selectAll": "全选",
+  "temporarilyNoDescription": "暂无简介",
+  "understandMore": "了解更多",
+  "unknown.user": "未知用户",
+  "uuid": "UUID"
+}
+;
+
+export default _default;

package/dist/index.d.ts

@@ -0,0 +1,113 @@
+/**
+ * @description 在这里进行模块重导
+ */
+export { Button, buttonVariants, type ButtonProps, } from './components/primitive/button';
+export { Checkbox } from './components/primitive/checkbox';
+export { Dialog, DialogPortal, DialogOverlay, DialogClose, DialogTrigger, DialogContent, DialogHeader, DialogHeaderLarge, DialogFooter, DialogTitle, DialogDescription, DialogBanner, DialogDivider, DialogBody, DialogScrollArea, } from './components/primitive/dialog';
+export { AlertDialog, AlertDialogTrigger, AlertDialogPortal, AlertDialogOverlay, AlertDialogContent, AlertDialogHeader, AlertDialogFooter, AlertDialogTitle, AlertDialogDescription, AlertDialogAction, AlertDialogCancel, } from './components/primitive/alert-dialog';
+export { Icon } from './_icon/index';
+export { LocaleContainer } from './components/biz/locale-container';
+export { useFormField, Form, FormItem, FormLabel, FormControl, FormDescription, FormMessage, FormField, FormRequiredIndicator, FormRowContainer, FormHint, FormNestedContainer, } from './components/primitive/form';
+export { Switch } from './components/primitive/switch';
+export { Label } from './components/primitive/label';
+export { Input } from './components/primitive/input';
+export { RadioGroup, RadioGroupRoot, RadioGroupItem, } from './components/primitive/radio-group';
+export { type RadioOption, type RadioOptionGeneric, type RadioValue, type RadioGroupProps, } from './components/primitive/radio-group';
+export { Markdown, DocMarkdown, MarkdownWithHtml, GithubMarkdown, } from './components/primitive/markdown';
+export { Tabs, TabsRoot, TabsList, TabsTrigger, TabsContent, } from './components/primitive/tabs/tabs';
+export type { TabsProps, TabsPrimitiveProps, TabsListProps, TabsListItem, TabsTriggerProps, } from './components/primitive/tabs/tabs';
+export { AppBase } from './components/biz/app-base';
+export { Pagination } from './components/primitive/pagination';
+export { PaginationRoot, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, } from './components/primitive/pagination/pagination';
+export { Select, SelectRoot, SelectGroup, SelectValue, SelectTrigger, SelectContent, SelectLabel, SelectItem, SelectSeparator, SelectScrollUpButton, SelectScrollDownButton, } from './components/primitive/select';
+export { type SelectOptions } from './components/primitive/select';
+export { Tag } from './components/primitive/tag';
+export { Badge, BadgeDot } from './components/primitive/badge';
+export type { BadgeProps } from './components/primitive/badge';
+export { StatusBadge } from './components/primitive/status-badge';
+export type { StatusBadgeProps } from './components/primitive/status-badge';
+export { State } from './components/biz/state';
+export type { IStateProps } from './components/biz/state';
+export { Constant, useConstant } from './components/biz/constant';
+export { Text } from './components/primitive/text';
+export type { TextProps } from './components/primitive/text';
+export { Link } from './components/primitive/link';
+export type { LinkProps } from './components/primitive/link';
+export { Tooltip, TooltipArrow, TooltipContent, TooltipPortal, TooltipTrigger, TooltipProvider, TooltipRoot, type TooltipProps, } from './components/primitive/tooltip/index';
+export { Drawer, DrawerRoot, DrawerTrigger, DrawerPortal, DrawerOverlay, DrawerContent, DrawerHeader, DrawerFooter, DrawerBody, } from './components/primitive/drawer';
+export { ImageReader } from './components/primitive/image-reader/index';
+export { Dropdown, DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuGroup, DropdownMenuPortal, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuRadioGroup, type DropDownProps, type DropdownItem, } from './components/primitive/dropdown-menu';
+export { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuCheckboxItem, ContextMenuRadioItem, ContextMenuLabel, ContextMenuSeparator, ContextMenuShortcut, ContextMenuGroup, ContextMenuPortal, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuRadioGroup, ContextMenuSimple, type ContextMenuSimpleProps, type ContextMenuItemType, } from './components/primitive/context-menu';
+export { Textarea } from './components/primitive/textarea';
+export { Field, FieldValue, FieldPlaceholderDash, FieldPlaceholderNone, type FieldProps, } from './components/biz/field/index';
+export { FieldOperations, type FieldOperation, type FieldOperationFunc, type FieldOperationType, } from './components/biz/field/field-operations';
+export { InputNumber } from './components/primitive/input-number';
+export { Card, cardVariants, CardHeader, CardFooter, CardTitle, CardDescription, CardContent, cardContentVariants, CardCollapseIndicator, } from './components/primitive/card';
+export type { CardProps, CardContentProps } from './components/primitive/card';
+export { NoData, NoDataCommonLabel, NoDataIndicatorLarge, } from './components/biz/no-data/index';
+export { UploadFile } from './components/biz/file-upload/index';
+export { Slider } from './components/primitive/slider';
+export { Progress } from './components/primitive/progress';
+export type { ProgressProps } from './components/primitive/progress';
+export { type ToastProps, type ToastActionElement, ToastProvider, ToastViewport, Toast, ToastTitle, ToastDescription, ToastClose, ToastAction, } from './components/primitive/toast/toast';
+export { useToast, toast } from './components/primitive/toast/use-toast';
+export { Toaster } from './components/primitive/toast/toaster';
+export { SearchInput } from './components/primitive/search-input';
+export { Info } from './components/biz/info/index';
+export { CheckboxGroup } from './components/primitive/checkbox-group';
+export { type CheckboxGroupItem } from './components/primitive/checkbox-group';
+export { Copy } from './components/biz/copy';
+export { Breadcrumb, BreadcrumbItem, BreadcrumbLink, BreadcrumbBackLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, BreadcrumbDivider, } from './components/primitive/breadcrumb';
+export { Show } from './components/primitive/show';
+export type { Message } from './components/biz/locale-container/type';
+export type { IConstantMap } from './components/biz/config/index';
+export { Loader } from './components/primitive/loader';
+export { Spin, spinIndicatorVariants, spinContainerVariants, } from './components/primitive/spin';
+export type { SpinProps } from './components/primitive/spin';
+export { SelectionCancellation } from './components/primitive/selection-cancellation';
+export { ChartContainer, ChartTooltip, ChartTooltipContent, ChartLegend, ChartLegendContent, ChartStyle, } from './components/primitive/chart';
+export { InputPassword } from './components/primitive/input-password';
+export type { InputPasswordProps } from './components/primitive/input-password';
+export { DateValue } from './components/biz/date-value';
+export { TagList } from './components/primitive/tag-list';
+export * from './components/primitive/popover';
+export { PopoverConfirm, type PopoverConfirmProps, } from './components/primitive/popover-confirm';
+export * from './components/primitive/multi-select';
+export * from './components/primitive/calendar';
+export { RangePicker } from './components/primitive/range-picker';
+export { TimePicker } from './components/primitive/time-picker';
+export type { TimePickerProps, TimeValue } from './components/primitive/time-picker';
+export { DatePicker } from './components/primitive/date-picker';
+export type { DatePickerProps, DisabledTimeConfig, } from './components/primitive/date-picker';
+export * from './components/primitive/collapse';
+export { Alert } from './components/primitive/alert';
+export type { AlertProps } from './components/primitive/alert';
+export { CodeEditor, useCodeEditor } from './components/primitive/code-editor';
+export type { CodeEditorProps, SupportedLanguage, } from './components/primitive/code-editor';
+export { PanicFallback } from './components/biz/panic-fallback';
+export { AutoComplete } from './components/primitive/auto-complete';
+export type { AutoCompleteOption } from './components/primitive/auto-complete';
+export { FileUploadSingle } from './components/primitive/file-upload';
+export { HeaderPage, HeaderDetail, HeaderBreadcrumb, } from './components/biz/header';
+export { HelperDoc } from './components/biz/helper-doc';
+export { InfoPopover } from './components/biz/info-popover';
+export type { InfoPopoverProps } from './components/biz/info-popover';
+export { SmartTip } from './components/biz/smart-tip';
+export type { SmartTipProps, ContentThresholds, } from './components/biz/smart-tip';
+export { useId } from './utils/use-id';
+export { OverlayProvider, useOverlayContext } from './utils/overlay-context';
+export { useOverlay } from './utils/use-overlay';
+export { useContainer } from './utils/use-container';
+export { ConfigProvider } from './components/biz/config';
+export { Divider } from './components/primitive/divider';
+export type { DividerProps } from './components/primitive/divider';
+export { Steps } from './components/primitive/steps';
+export type { StepsProps, StepItem } from './components/primitive/steps';
+export { ResizablePanelGroup, ResizablePanel, ResizableHandle, } from './components/primitive/resizable';
+export type { ResizableHandleProps } from './components/primitive/resizable';
+export { Tree, TreeSelect, DefaultTreeNode } from './components/primitive/tree';
+export type { TreeRef, TreeNode, TreeProps, TreeSelectProps, TreeMoveEvent, NodeApi as TreeNodeApi, NodeRendererProps as TreeNodeRendererProps, } from './components/primitive/tree';
+export { JsonViewer } from './components/primitive/json-viewer';
+export type { JsonViewerProps } from './components/primitive/json-viewer';
+export { Cascader } from './components/primitive/cascader';
+export type { CascaderOption, CascaderProps, CascaderFieldNames, CascaderBaseProps, CascaderSingleProps, CascaderMultipleProps, } from './components/primitive/cascader';

package/dist/style.css

@@ -0,0 +1,2 @@
+.markdown-body{--lightningcss-light:initial;--lightningcss-dark: ;color-scheme:light;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%;color:#1f2328;word-wrap:break-word;background-color:#fff;margin:0;font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Noto Sans,Helvetica,Arial,sans-serif,Apple Color Emoji,Segoe UI Emoji;font-size:16px;line-height:1.5;scroll-behavior:auto!important}.markdown-body .octicon{fill:currentColor;vertical-align:text-bottom;display:inline-block}.markdown-body h1:hover .anchor .octicon-link:before,.markdown-body h2:hover .anchor .octicon-link:before,.markdown-body h3:hover .anchor .octicon-link:before,.markdown-body h4:hover .anchor .octicon-link:before,.markdown-body h5:hover .anchor .octicon-link:before,.markdown-body h6:hover .anchor .octicon-link:before{content:" ";background-color:currentColor;width:16px;height:16px;display:inline-block;-webkit-mask-image:url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' version='1.1' aria-hidden='true'><path fill-rule='evenodd' d='M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z'></path></svg>");mask-image:url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' version='1.1' aria-hidden='true'><path fill-rule='evenodd' d='M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z'></path></svg>")}.markdown-body details,.markdown-body figcaption,.markdown-body figure{display:block}.markdown-body summary{display:list-item}.markdown-body [hidden]{display:none!important}.markdown-body a{color:#0969da;background-color:transparent;text-decoration:none}.markdown-body abbr[title]{border-bottom:none;text-decoration:underline dotted}.markdown-body b,.markdown-body strong{font-weight:600}.markdown-body dfn{font-style:italic}.markdown-body h1{border-bottom:1px solid rgba(209,217,224,.7);margin:.67em 0;padding-bottom:.3em;font-size:2em;font-weight:600}.markdown-body mark{color:#1f2328;background-color:#fff8c5}.markdown-body small{font-size:90%}.markdown-body sub,.markdown-body sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}.markdown-body sub{bottom:-.25em}.markdown-body sup{top:-.5em}.markdown-body img{box-sizing:content-box;border-style:none;max-width:100%}.markdown-body code,.markdown-body kbd,.markdown-body pre,.markdown-body samp{font-family:monospace;font-size:1em}.markdown-body figure{margin:1em 2.5rem}.markdown-body hr{box-sizing:content-box;background:#d1d9e0;border:0;height:.25em;margin:1.5rem 0;padding:0;overflow:hidden}.markdown-body input{font:inherit;font-family:inherit;font-size:inherit;line-height:inherit;margin:0;overflow:visible}.markdown-body [type=button],.markdown-body [type=reset],.markdown-body [type=submit]{-webkit-appearance:button;appearance:button}.markdown-body [type=checkbox],.markdown-body [type=radio]{box-sizing:border-box;padding:0}.markdown-body [type=number]::-webkit-inner-spin-button{height:auto}.markdown-body [type=number]::-webkit-outer-spin-button{height:auto}.markdown-body [type=search]::-webkit-search-cancel-button{-webkit-appearance:none;appearance:none}.markdown-body [type=search]::-webkit-search-decoration{-webkit-appearance:none;appearance:none}.markdown-body ::-webkit-input-placeholder{color:inherit;opacity:.54}.markdown-body ::-webkit-file-upload-button{-webkit-appearance:button;appearance:button;font:inherit}.markdown-body ::placeholder{color:#59636e;opacity:1}.markdown-body hr:before{content:"";display:table}.markdown-body hr:after{clear:both;content:"";display:table}.markdown-body table{border-spacing:0;border-collapse:collapse;width:max-content;max-width:100%;display:block;overflow:auto}.markdown-body td,.markdown-body th{padding:0}.markdown-body details summary{cursor:pointer}.markdown-body a:focus,.markdown-body [role=button]:focus,.markdown-body input[type=radio]:focus,.markdown-body input[type=checkbox]:focus{outline-offset:-2px;box-shadow:none;outline:2px solid #0969da}.markdown-body a:focus:not(:focus-visible){outline:1px solid transparent}.markdown-body [role=button]:focus:not(:focus-visible){outline:1px solid transparent}.markdown-body input[type=radio]:focus:not(:focus-visible){outline:1px solid transparent}.markdown-body input[type=checkbox]:focus:not(:focus-visible){outline:1px solid transparent}.markdown-body a:focus-visible{outline-offset:-2px;box-shadow:none;outline:2px solid #0969da}.markdown-body [role=button]:focus-visible{outline-offset:-2px;box-shadow:none;outline:2px solid #0969da}.markdown-body input[type=radio]:focus-visible{outline-offset:-2px;box-shadow:none;outline:2px solid #0969da}.markdown-body input[type=checkbox]:focus-visible{outline-offset:-2px;box-shadow:none;outline:2px solid #0969da}.markdown-body a:not([class]):focus,.markdown-body input[type=radio]:focus,.markdown-body input[type=checkbox]:focus{outline-offset:0}.markdown-body a:not([class]):focus-visible{outline-offset:0}.markdown-body input[type=radio]:focus-visible{outline-offset:0}.markdown-body input[type=checkbox]:focus-visible{outline-offset:0}.markdown-body kbd{color:#1f2328;vertical-align:middle;background-color:#f6f8fa;border:1px solid rgba(209,217,224,.7);border-radius:6px;padding:.25rem;font:11px/10px ui-monospace,SFMono-Regular,SF Mono,Menlo,Consolas,Liberation Mono,monospace;display:inline-block;box-shadow:inset 0 -1px rgba(209,217,224,.7)}.markdown-body h1,.markdown-body h2,.markdown-body h3,.markdown-body h4,.markdown-body h5,.markdown-body h6{margin-top:1.5rem;margin-bottom:1rem;font-weight:600;line-height:1.25}.markdown-body h2{border-bottom:1px solid rgba(209,217,224,.7);padding-bottom:.3em;font-size:1.5em;font-weight:600}.markdown-body h3{font-size:1.25em;font-weight:600}.markdown-body h4{font-size:1em;font-weight:600}.markdown-body h5{font-size:.875em;font-weight:600}.markdown-body h6{color:#59636e;font-size:.85em;font-weight:600}.markdown-body p{margin-top:0;margin-bottom:10px}.markdown-body blockquote{color:#59636e;border-left:.25em solid #d1d9e0;margin:0;padding:0 1em}.markdown-body ul,.markdown-body ol{margin-top:0;margin-bottom:0;padding-left:2em}.markdown-body ol ol,.markdown-body ul ol{list-style-type:lower-roman}.markdown-body ul ul ol,.markdown-body ul ol ol,.markdown-body ol ul ol,.markdown-body ol ol ol{list-style-type:lower-alpha}.markdown-body dd{margin-left:0}.markdown-body tt,.markdown-body code,.markdown-body samp{font-family:ui-monospace,SFMono-Regular,SF Mono,Menlo,Consolas,Liberation Mono,monospace;font-size:12px}.markdown-body pre{word-wrap:normal;margin-top:0;margin-bottom:0;font-family:ui-monospace,SFMono-Regular,SF Mono,Menlo,Consolas,Liberation Mono,monospace;font-size:12px}.markdown-body .octicon{vertical-align:text-bottom;fill:currentColor;display:inline-block;overflow:visible!important}.markdown-body input::-webkit-outer-spin-button{-webkit-appearance:none;appearance:none;margin:0}.markdown-body input::-webkit-inner-spin-button{-webkit-appearance:none;appearance:none;margin:0}.markdown-body .mr-2{margin-right:.5rem!important}.markdown-body:before{content:"";display:table}.markdown-body:after{clear:both;content:"";display:table}.markdown-body>:first-child{margin-top:0!important}.markdown-body>:last-child{margin-bottom:0!important}.markdown-body a:not([href]){color:inherit;text-decoration:none}.markdown-body .absent{color:#d1242f}.markdown-body .anchor{float:left;margin-left:-20px;padding-right:.25rem;line-height:1}.markdown-body .anchor:focus{outline:none}.markdown-body p,.markdown-body blockquote,.markdown-body ul,.markdown-body ol,.markdown-body dl,.markdown-body table,.markdown-body pre,.markdown-body details{margin-top:0;margin-bottom:1rem}.markdown-body blockquote>:first-child{margin-top:0}.markdown-body blockquote>:last-child{margin-bottom:0}.markdown-body h1 .octicon-link,.markdown-body h2 .octicon-link,.markdown-body h3 .octicon-link,.markdown-body h4 .octicon-link,.markdown-body h5 .octicon-link,.markdown-body h6 .octicon-link{color:#1f2328;vertical-align:middle;visibility:hidden}.markdown-body h1:hover .anchor,.markdown-body h2:hover .anchor,.markdown-body h3:hover .anchor,.markdown-body h4:hover .anchor,.markdown-body h5:hover .anchor,.markdown-body h6:hover .anchor{text-decoration:none}.markdown-body h1:hover .anchor .octicon-link,.markdown-body h2:hover .anchor .octicon-link,.markdown-body h3:hover .anchor .octicon-link,.markdown-body h4:hover .anchor .octicon-link,.markdown-body h5:hover .anchor .octicon-link,.markdown-body h6:hover .anchor .octicon-link{visibility:visible}.markdown-body h1 tt,.markdown-body h1 code,.markdown-body h2 tt,.markdown-body h2 code,.markdown-body h3 tt,.markdown-body h3 code,.markdown-body h4 tt,.markdown-body h4 code,.markdown-body h5 tt,.markdown-body h5 code,.markdown-body h6 tt,.markdown-body h6 code{font-size:inherit;padding:0 .2em}.markdown-body summary h1,.markdown-body summary h2,.markdown-body summary h3,.markdown-body summary h4,.markdown-body summary h5,.markdown-body summary h6{display:inline-block}.markdown-body summary h1 .anchor,.markdown-body summary h2 .anchor,.markdown-body summary h3 .anchor,.markdown-body summary h4 .anchor,.markdown-body summary h5 .anchor,.markdown-body summary h6 .anchor{margin-left:-40px}.markdown-body summary h1,.markdown-body summary h2{border-bottom:0;padding-bottom:0}.markdown-body ul.no-list,.markdown-body ol.no-list{padding:0;list-style-type:none}.markdown-body ol[type=a\ s]{list-style-type:lower-alpha}.markdown-body ol[type=A\ s]{list-style-type:upper-alpha}.markdown-body ol[type=i\ s]{list-style-type:lower-roman}.markdown-body ol[type=I\ s]{list-style-type:upper-roman}.markdown-body ol[type="1"],.markdown-body div>ol:not([type]){list-style-type:decimal}.markdown-body ul ul,.markdown-body ul ol,.markdown-body ol ol,.markdown-body ol ul{margin-top:0;margin-bottom:0}.markdown-body li>p{margin-top:1rem}.markdown-body li+li{margin-top:.25em}.markdown-body dl{padding:0}.markdown-body dl dt{margin-top:1rem;padding:0;font-size:1em;font-style:italic;font-weight:600}.markdown-body dl dd{margin-bottom:1rem;padding:0 1rem}.markdown-body table th{font-weight:600}.markdown-body table th,.markdown-body table td{border:1px solid #d1d9e0;padding:6px 13px}.markdown-body table td>:last-child{margin-bottom:0}.markdown-body table tr{background-color:#fff;border-top:1px solid rgba(209,217,224,.7)}.markdown-body table tr:nth-child(2n){background-color:#f6f8fa}.markdown-body table img{background-color:transparent}.markdown-body img[align=right]{padding-left:20px}.markdown-body img[align=left]{padding-right:20px}.markdown-body .emoji{vertical-align:text-top;background-color:transparent;max-width:none}.markdown-body span.frame{display:block;overflow:hidden}.markdown-body span.frame>span{float:left;border:1px solid #d1d9e0;width:auto;margin:13px 0 0;padding:7px;display:block;overflow:hidden}.markdown-body span.frame span img{float:left;display:block}.markdown-body span.frame span span{clear:both;color:#1f2328;padding:5px 0 0;display:block}.markdown-body span.align-center{clear:both;display:block;overflow:hidden}.markdown-body span.align-center>span{text-align:center;margin:13px auto 0;display:block;overflow:hidden}.markdown-body span.align-center span img{text-align:center;margin:0 auto}.markdown-body span.align-right{clear:both;display:block;overflow:hidden}.markdown-body span.align-right>span{text-align:right;margin:13px 0 0;display:block;overflow:hidden}.markdown-body span.align-right span img{text-align:right;margin:0}.markdown-body span.float-left{float:left;margin-right:13px;display:block;overflow:hidden}.markdown-body span.float-left span{margin:13px 0 0}.markdown-body span.float-right{float:right;margin-left:13px;display:block;overflow:hidden}.markdown-body span.float-right>span{text-align:right;margin:13px auto 0;display:block;overflow:hidden}.markdown-body code,.markdown-body tt{white-space:break-spaces;background-color:rgba(129,139,152,.12);border-radius:6px;margin:0;padding:.2em .4em;font-size:85%}.markdown-body code br,.markdown-body tt br{display:none}.markdown-body del code{text-decoration:inherit}.markdown-body samp{font-size:85%}.markdown-body pre code{font-size:100%}.markdown-body pre>code{word-break:normal;white-space:pre;background:0 0;border:0;margin:0;padding:0}.markdown-body .highlight{margin-bottom:1rem}.markdown-body .highlight pre{word-break:normal;margin-bottom:0}.markdown-body .highlight pre,.markdown-body pre{color:#1f2328;background-color:#f6f8fa;border-radius:6px;padding:1rem;font-size:85%;line-height:1.45;overflow:auto}.markdown-body pre code,.markdown-body pre tt{max-width:auto;line-height:inherit;word-wrap:normal;background-color:transparent;border:0;margin:0;padding:0;display:inline;overflow:visible}.markdown-body .csv-data td,.markdown-body .csv-data th{text-align:left;white-space:nowrap;padding:5px;font-size:12px;line-height:1;overflow:hidden}.markdown-body .csv-data .blob-num{text-align:right;background:#fff;border:0;padding:10px .5rem 9px}.markdown-body .csv-data tr{border-top:0}.markdown-body .csv-data th{background:#f6f8fa;border-top:0;font-weight:600}.markdown-body [data-footnote-ref]:before{content:"["}.markdown-body [data-footnote-ref]:after{content:"]"}.markdown-body .footnotes{color:#59636e;border-top:1px solid #d1d9e0;font-size:12px}.markdown-body .footnotes ol{padding-left:1rem}.markdown-body .footnotes ol ul{margin-top:1rem;padding-left:1rem;display:inline-block}.markdown-body .footnotes li{position:relative}.markdown-body .footnotes li:target:before{pointer-events:none;content:"";border:2px solid #0969da;border-radius:6px;position:absolute;top:-.5rem;bottom:-.5rem;left:-1.5rem;right:-.5rem}.markdown-body .footnotes li:target{color:#1f2328}.markdown-body .footnotes .data-footnote-backref g-emoji{font-family:monospace}.markdown-body .pl-c{color:#59636e}.markdown-body .pl-c1,.markdown-body .pl-s .pl-v{color:#0550ae}.markdown-body .pl-e,.markdown-body .pl-en{color:#6639ba}.markdown-body .pl-smi,.markdown-body .pl-s .pl-s1{color:#1f2328}.markdown-body .pl-ent{color:#0550ae}.markdown-body .pl-k{color:#cf222e}.markdown-body .pl-s,.markdown-body .pl-pds,.markdown-body .pl-s .pl-pse .pl-s1,.markdown-body .pl-sr,.markdown-body .pl-sr .pl-cce,.markdown-body .pl-sr .pl-sre,.markdown-body .pl-sr .pl-sra{color:#0a3069}.markdown-body .pl-v,.markdown-body .pl-smw{color:#953800}.markdown-body .pl-bu{color:#82071e}.markdown-body .pl-ii{color:#f6f8fa;background-color:#82071e}.markdown-body .pl-c2{color:#f6f8fa;background-color:#cf222e}.markdown-body .pl-sr .pl-cce{color:#116329;font-weight:700}.markdown-body .pl-ml{color:#3b2300}.markdown-body .pl-mh,.markdown-body .pl-mh .pl-en,.markdown-body .pl-ms{color:#0550ae;font-weight:700}.markdown-body .pl-mi{color:#1f2328;font-style:italic}.markdown-body .pl-mb{color:#1f2328;font-weight:700}.markdown-body .pl-md{color:#82071e;background-color:#ffebe9}.markdown-body .pl-mi1{color:#116329;background-color:#dafbe1}.markdown-body .pl-mc{color:#953800;background-color:#ffd8b5}.markdown-body .pl-mi2{color:#d1d9e0;background-color:#0550ae}.markdown-body .pl-mdr{color:#8250df;font-weight:700}.markdown-body .pl-ba{color:#59636e}.markdown-body .pl-sg{color:#818b98}.markdown-body .pl-corl{color:#0a3069;text-decoration:underline}.markdown-body [role=button]:focus:not(:focus-visible){box-shadow:none;outline:none}.markdown-body [role=tabpanel][tabindex="0"]:focus:not(:focus-visible){box-shadow:none;outline:none}.markdown-body button:focus:not(:focus-visible){box-shadow:none;outline:none}.markdown-body summary:focus:not(:focus-visible){box-shadow:none;outline:none}.markdown-body a:focus:not(:focus-visible){box-shadow:none;outline:none}.markdown-body [tabindex="0"]:focus:not(:focus-visible){outline:none}.markdown-body details-dialog:focus:not(:focus-visible){outline:none}.markdown-body g-emoji{vertical-align:-.075em;min-width:1ch;font-family:Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol;font-size:1em;font-weight:400;line-height:1;display:inline-block;font-style:normal!important}.markdown-body g-emoji img{width:1em;height:1em}.markdown-body .task-list-item{list-style-type:none}.markdown-body .task-list-item label{font-weight:400}.markdown-body .task-list-item.enabled label{cursor:pointer}.markdown-body .task-list-item+.task-list-item{margin-top:.25rem}.markdown-body .task-list-item .handle{display:none}.markdown-body .task-list-item-checkbox{vertical-align:middle;margin:0 .2em .25em -1.4em}.markdown-body ul:-webkit-any(:lang(ae),:lang(ar),:lang(arc),:lang(bcc),:lang(bqi),:lang(ckb),:lang(dv),:lang(fa),:lang(glk),:lang(he),:lang(ku),:lang(mzn),:lang(nqo),:lang(pnb),:lang(ps),:lang(sd),:lang(ug),:lang(ur),:lang(yi)) .task-list-item-checkbox{margin:0 -1.6em .25em .2em}.markdown-body ul:is(:lang(ae),:lang(ar),:lang(arc),:lang(bcc),:lang(bqi),:lang(ckb),:lang(dv),:lang(fa),:lang(glk),:lang(he),:lang(ku),:lang(mzn),:lang(nqo),:lang(pnb),:lang(ps),:lang(sd),:lang(ug),:lang(ur),:lang(yi)) .task-list-item-checkbox{margin:0 -1.6em .25em .2em}.markdown-body ol:-webkit-any(:lang(ae),:lang(ar),:lang(arc),:lang(bcc),:lang(bqi),:lang(ckb),:lang(dv),:lang(fa),:lang(glk),:lang(he),:lang(ku),:lang(mzn),:lang(nqo),:lang(pnb),:lang(ps),:lang(sd),:lang(ug),:lang(ur),:lang(yi)) .task-list-item-checkbox{margin:0 -1.6em .25em .2em}.markdown-body ol:is(:lang(ae),:lang(ar),:lang(arc),:lang(bcc),:lang(bqi),:lang(ckb),:lang(dv),:lang(fa),:lang(glk),:lang(he),:lang(ku),:lang(mzn),:lang(nqo),:lang(pnb),:lang(ps),:lang(sd),:lang(ug),:lang(ur),:lang(yi)) .task-list-item-checkbox{margin:0 -1.6em .25em .2em}.markdown-body .contains-task-list:hover .task-list-item-convert-container,.markdown-body .contains-task-list:focus-within .task-list-item-convert-container{clip:auto;width:auto;height:24px;display:block;overflow:visible}.markdown-body ::-webkit-calendar-picker-indicator{filter:invert(50%)}.markdown-body .markdown-alert{color:inherit;border-left:.25em solid #d1d9e0;margin-bottom:1rem;padding:.5rem 1rem}.markdown-body .markdown-alert>:first-child{margin-top:0}.markdown-body .markdown-alert>:last-child{margin-bottom:0}.markdown-body .markdown-alert .markdown-alert-title{align-items:center;font-weight:500;line-height:1;display:flex}.markdown-body .markdown-alert.markdown-alert-note{border-left-color:#0969da}.markdown-body .markdown-alert.markdown-alert-note .markdown-alert-title{color:#0969da}.markdown-body .markdown-alert.markdown-alert-important{border-left-color:#8250df}.markdown-body .markdown-alert.markdown-alert-important .markdown-alert-title{color:#8250df}.markdown-body .markdown-alert.markdown-alert-warning{border-left-color:#9a6700}.markdown-body .markdown-alert.markdown-alert-warning .markdown-alert-title{color:#9a6700}.markdown-body .markdown-alert.markdown-alert-tip{border-left-color:#1a7f37}.markdown-body .markdown-alert.markdown-alert-tip .markdown-alert-title{color:#1a7f37}.markdown-body .markdown-alert.markdown-alert-caution{border-left-color:#cf222e}.markdown-body .markdown-alert.markdown-alert-caution .markdown-alert-title{color:#d1242f}.markdown-body>:first-child>.heading-element:first-child{margin-top:0!important}.markdown-body [align=center]{text-align:center}.markdown-body [align=right]{text-align:right}.markdown-body [align=left]{text-align:left}.markdown-body p[align=center] img,.markdown-body div[align=center] img{display:inline-block}.markdown-body img[src*=shields\.io],.markdown-body img[src*=badge],.markdown-body img[alt*=badge],.markdown-body img[alt*=Badge]{vertical-align:middle;height:auto;max-height:28px;margin:2px 4px;display:inline-block}.markdown-body p>a>img[src*=shields\.io],.markdown-body p>a>img[src*=badge]{margin:2px}.markdown-body .img-error-placeholder{color:#6b7280;background-color:#f3f4f6;border:1px solid #e5e7eb;border-radius:4px;justify-content:center;align-items:center;padding:4px 8px;font-size:12px;display:inline-flex}.markdown-body .img-loading-spinner{border:2px solid #d1d5db;border-top-color:#3b82f6;border-radius:50%;width:16px;height:16px;animation:.8s linear infinite spin;display:inline-block}@keyframes spin{to{transform:rotate(360deg)}}.markdown-body img{max-width:100%;height:auto}.markdown-body pre code{white-space:pre;word-wrap:normal}.markdown-body blockquote{background-color:#fef9e7;border-left:4px solid #fbbf24;margin:16px 0;padding:12px 16px}.markdown-body table{-webkit-overflow-scrolling:touch;width:100%;display:block;overflow-x:auto}.markdown-body a{color:#0969da;text-decoration:none}.markdown-body a:hover{text-decoration:underline}.markdown-body .katex-display{overflow-x:auto;overflow-y:hidden}
+/*$vite$:1*/

package/dist/utils/overlay-context.d.ts

@@ -0,0 +1,34 @@
+import { default as React } from 'react';
+interface OverlayInstance {
+    id: string;
+    type: "dialog" | "drawer" | "popover" | "tooltip" | "toast";
+    zIndex: number;
+    timestamp: number;
+}
+interface OverlayContextValue {
+    register: (id: string, type: OverlayInstance["type"]) => number;
+    unregister: (id: string) => void;
+    getZIndex: (id: string) => number | null;
+    getTopZIndex: () => number;
+    isTop: (id: string) => boolean;
+}
+/**
+ * OverlayProvider - 全局弹窗层级管理
+ *
+ * 用法：
+ * ```tsx
+ * <OverlayProvider>
+ *   <App />
+ * </OverlayProvider>
+ * ```
+ */
+export declare const OverlayProvider: React.FC<{
+    children: React.ReactNode;
+}>;
+/**
+ * useOverlayContext - 获取 Overlay Context
+ *
+ * @throws {Error} 如果在 OverlayProvider 外部使用
+ */
+export declare const useOverlayContext: () => OverlayContextValue;
+export {};

package/dist/utils/use-container.d.ts

@@ -0,0 +1,30 @@
+interface UseContainerOptions {
+    id: string;
+    zIndex: number;
+    visible: boolean;
+    disableContainer?: boolean;
+}
+/**
+ * useContainer - 自动管理弹窗的挂载容器
+ *
+ * 为每个弹窗创建独立的 DOM 容器，避免样式污染和 z-index 冲突
+ *
+ * 用法：
+ * ```tsx
+ * const MyDialog = ({ open }) => {
+ *   const { zIndex, overlayId } = useOverlay({ type: 'dialog', open });
+ *   const container = useContainer({ id: overlayId, zIndex, visible: open });
+ *
+ *   return createPortal(<DialogContent />, container);
+ * };
+ * ```
+ *
+ * @param options - 配置项
+ * @param options.id - 弹窗唯一标识
+ * @param options.zIndex - z-index 值
+ * @param options.visible - 是否可见
+ * @param options.disableContainer - 是否禁用独立容器
+ * @returns {HTMLElement} 挂载容器
+ */
+export declare function useContainer(options: UseContainerOptions): HTMLElement;
+export {};

package/dist/utils/use-id.d.ts

@@ -0,0 +1 @@
+export declare const useId: () => string;

package/dist/utils/use-overlay.d.ts

@@ -0,0 +1,34 @@
+interface UseOverlayOptions {
+    type: "dialog" | "drawer" | "popover" | "tooltip" | "toast";
+    open?: boolean;
+    customZIndex?: number;
+}
+interface UseOverlayResult {
+    zIndex: number;
+    isTop: boolean;
+    overlayId: string;
+}
+/**
+ * useOverlay - 自动管理弹窗的 z-index
+ *
+ * 用法：
+ * ```tsx
+ * const MyDialog = ({ open }) => {
+ *   const { zIndex, isTop } = useOverlay({ type: 'dialog', open });
+ *
+ *   return (
+ *     <DialogContent style={{ zIndex }}>
+ *       {isTop && <div>我是最顶层</div>}
+ *     </DialogContent>
+ *   );
+ * };
+ * ```
+ *
+ * @param options - 配置项
+ * @param options.type - 弹窗类型
+ * @param options.open - 是否打开（默认 false）
+ * @param options.customZIndex - 自定义 z-index（覆盖自动计算的值）
+ * @returns {UseOverlayResult} z-index 和相关状态
+ */
+export declare function useOverlay(options: UseOverlayOptions): UseOverlayResult;
+export {};