@vavt/react-ui 1.0.0

package/dist/types/Tag/type.d.ts

@@ -0,0 +1,24 @@
+import type { ElementType, HTMLAttributes, MouseEvent } from 'react';
+/** 标签语义状态：默认/中性 (default) | 主题色 (primary) | 成功 (success) | 警告 (warning) | 错误 (error) | 信息 (info) */
+export type TagStatus = 'default' | 'primary' | 'success' | 'warning' | 'error' | 'info';
+/** 标签尺寸：小 (sm) | 中等 (md) | 大 (lg) */
+export type TagSize = 'sm' | 'md' | 'lg';
+/** Tag 根 DOM 元素类型 */
+export type TagRef = HTMLElement;
+/**
+ * Tag 组件属性接口
+ */
+export interface TagProps extends HTMLAttributes<HTMLElement> {
+    /** 标签的语义状态，默认为 `default` */
+    status?: TagStatus;
+    /** 标签尺寸大小，默认为 `md` */
+    size?: TagSize;
+    /** 是否支持关闭/移除，开启后展示关闭图标，默认为 false */
+    closable?: boolean;
+    /** 是否处于禁用状态，禁用后阻止关闭交互，默认为 false */
+    disabled?: boolean;
+    /** 自定义根容器 HTML 标签，默认为 `span` */
+    tag?: ElementType;
+    /** 点击关闭图标时的回调函数 */
+    onClose?: (event: MouseEvent<HTMLButtonElement>) => void;
+}

package/dist/types/Textarea/Textarea.d.cts

@@ -0,0 +1,3 @@
+import type { TextareaProps } from './type.cjs';
+declare const Textarea: import("react").ForwardRefExoticComponent<TextareaProps & import("react").RefAttributes<HTMLTextAreaElement>>;
+export default Textarea;

package/dist/types/Textarea/Textarea.d.ts

@@ -0,0 +1,3 @@
+import type { TextareaProps } from './type.js';
+declare const Textarea: import("react").ForwardRefExoticComponent<TextareaProps & import("react").RefAttributes<HTMLTextAreaElement>>;
+export default Textarea;

package/dist/types/Textarea/index.d.cts

@@ -0,0 +1,5 @@
+import Textarea from './Textarea.cjs';
+/** Textarea 多行文本输入框组件 */
+export declare const VlTextarea: import("react").ForwardRefExoticComponent<import("./type.cjs").TextareaProps & import("react").RefAttributes<HTMLTextAreaElement>>;
+export type { TextareaProps, TextareaSize, TextareaResizeMode, TextareaRef } from './type.cjs';
+export default Textarea;

package/dist/types/Textarea/index.d.ts

@@ -0,0 +1,5 @@
+import Textarea from './Textarea.js';
+/** Textarea 多行文本输入框组件 */
+export declare const VlTextarea: import("react").ForwardRefExoticComponent<import("./type.js").TextareaProps & import("react").RefAttributes<HTMLTextAreaElement>>;
+export type { TextareaProps, TextareaSize, TextareaResizeMode, TextareaRef } from './type.js';
+export default Textarea;

package/dist/types/Textarea/type.d.cts

@@ -0,0 +1,32 @@
+import type { TextareaHTMLAttributes } from 'react';
+/** 文本域尺寸：小 (sm) | 中等 (md) | 大 (lg) */
+export type TextareaSize = 'sm' | 'md' | 'lg';
+/** 文本域拖拽拉伸模式 */
+export type TextareaResizeMode = 'none' | 'vertical' | 'horizontal' | 'both';
+/**
+ * Textarea 组件属性接口
+ */
+export interface TextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'size' | 'value' | 'defaultValue' | 'onChange'> {
+    /** 受控模式：当前文本域内容 */
+    value?: string;
+    /** 非受控模式：初始文本域内容 */
+    defaultValue?: string;
+    /** 原生占位提示文案 */
+    placeholder?: string;
+    /** 是否禁用输入，默认为 false */
+    disabled?: boolean;
+    /** 是否展示加载中状态，默认为 false */
+    loading?: boolean;
+    /** 控件尺寸大小，默认为 `md` */
+    size?: TextareaSize;
+    /** 默认可见行数，默认为 3 */
+    rows?: number;
+    /** 是否根据输入内容自适应调整高度，开启后 resize 将自动回退为 `'none'`，默认为 false */
+    autoSize?: boolean;
+    /** 用户手动拖拽调整大小的模式，默认为 `'vertical'` */
+    resize?: TextareaResizeMode;
+    /** 输入内容变化时的回调函数 */
+    onChange?: (value: string) => void;
+}
+/** Textarea 根原生 textarea DOM 元素类型 */
+export type TextareaRef = HTMLTextAreaElement;

package/dist/types/Textarea/type.d.ts

@@ -0,0 +1,32 @@
+import type { TextareaHTMLAttributes } from 'react';
+/** 文本域尺寸：小 (sm) | 中等 (md) | 大 (lg) */
+export type TextareaSize = 'sm' | 'md' | 'lg';
+/** 文本域拖拽拉伸模式 */
+export type TextareaResizeMode = 'none' | 'vertical' | 'horizontal' | 'both';
+/**
+ * Textarea 组件属性接口
+ */
+export interface TextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'size' | 'value' | 'defaultValue' | 'onChange'> {
+    /** 受控模式：当前文本域内容 */
+    value?: string;
+    /** 非受控模式：初始文本域内容 */
+    defaultValue?: string;
+    /** 原生占位提示文案 */
+    placeholder?: string;
+    /** 是否禁用输入，默认为 false */
+    disabled?: boolean;
+    /** 是否展示加载中状态，默认为 false */
+    loading?: boolean;
+    /** 控件尺寸大小，默认为 `md` */
+    size?: TextareaSize;
+    /** 默认可见行数，默认为 3 */
+    rows?: number;
+    /** 是否根据输入内容自适应调整高度，开启后 resize 将自动回退为 `'none'`，默认为 false */
+    autoSize?: boolean;
+    /** 用户手动拖拽调整大小的模式，默认为 `'vertical'` */
+    resize?: TextareaResizeMode;
+    /** 输入内容变化时的回调函数 */
+    onChange?: (value: string) => void;
+}
+/** Textarea 根原生 textarea DOM 元素类型 */
+export type TextareaRef = HTMLTextAreaElement;

package/dist/types/TimePicker/TimePicker.d.cts

@@ -0,0 +1,3 @@
+import type { TimePickerProps } from './type.cjs';
+declare const TimePicker: import("react").ForwardRefExoticComponent<TimePickerProps & import("react").RefAttributes<HTMLDivElement>>;
+export default TimePicker;

package/dist/types/TimePicker/TimePicker.d.ts

@@ -0,0 +1,3 @@
+import type { TimePickerProps } from './type.js';
+declare const TimePicker: import("react").ForwardRefExoticComponent<TimePickerProps & import("react").RefAttributes<HTMLDivElement>>;
+export default TimePicker;

package/dist/types/TimePicker/index.d.cts

@@ -0,0 +1,5 @@
+import TimePicker from './TimePicker.cjs';
+/** TimePicker 时间选择器组件 */
+export declare const VlTimePicker: import("react").ForwardRefExoticComponent<import("./type.cjs").TimePickerProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { TimePickerProps, TimePickerSize, TimePickerPlacement, TimePickerValue, TimePickerShortcut, TimePickerRef } from './type.cjs';
+export default TimePicker;

package/dist/types/TimePicker/index.d.ts

@@ -0,0 +1,5 @@
+import TimePicker from './TimePicker.js';
+/** TimePicker 时间选择器组件 */
+export declare const VlTimePicker: import("react").ForwardRefExoticComponent<import("./type.js").TimePickerProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { TimePickerProps, TimePickerSize, TimePickerPlacement, TimePickerValue, TimePickerShortcut, TimePickerRef } from './type.js';
+export default TimePicker;

package/dist/types/TimePicker/type.d.cts

@@ -0,0 +1,55 @@
+import type { HTMLAttributes } from 'react';
+/** 时间选择器尺寸大小：小 (sm) | 中等 (md) | 大 (lg) */
+export type TimePickerSize = 'sm' | 'md' | 'lg';
+/** 下拉浮层弹出方向 */
+export type TimePickerPlacement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
+/** 时间值字符串类型（固定为 `'HH:mm:ss'`） */
+export type TimePickerValue = string;
+/** 时间选择器快捷预设项定义 */
+export interface TimePickerShortcut {
+    /** 快捷项展示文案 */
+    label: string;
+    /** 点击时根据当前时间生成的时间字符串（HH:mm:ss） */
+    getValue: (now: Date) => string | null;
+}
+/**
+ * TimePicker 组件属性接口
+ */
+export interface TimePickerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
+    /** 受控模式：当前时间值（格式为 'HH:mm:ss'） */
+    value?: string | null;
+    /** 非受控模式：初始时间值（格式为 'HH:mm:ss'） */
+    defaultValue?: string | null;
+    /** 仅控制展示格式，默认为 `'HH:mm:ss'`；注意 value 与 onChange 始终遵循 `'HH:mm:ss'` */
+    format?: string;
+    /** 快捷预设选项列表 */
+    shortcuts?: TimePickerShortcut[];
+    /** 允许选择的最小时间（格式 'HH:mm:ss'） */
+    minTime?: string;
+    /** 允许选择的最大时间（格式 'HH:mm:ss'） */
+    maxTime?: string;
+    /** 自定义判断特定时间是否禁用的函数 */
+    disabledTime?: (time: string) => boolean;
+    /** 输入框占位提示文案，默认为 `'请选择时间'` */
+    placeholder?: string;
+    /** 是否禁用时间选择器，默认为 false */
+    disabled?: boolean;
+    /** 是否支持一键清空选中时间，默认为 false */
+    clearable?: boolean;
+    /** 控件尺寸大小，默认为 `md` */
+    size?: TimePickerSize;
+    /** 下拉面板弹出方向，默认为 `bottom-start` */
+    placement?: TimePickerPlacement;
+    /** 下拉面板与输入框之间的垂直间距偏移量（px），默认为 8 */
+    offset?: number;
+    /** 时间值变更时的回调函数 */
+    onChange?: (value: string | null) => void;
+    /** 点击清空按钮时的回调函数 */
+    onClear?: () => void;
+    /** 下拉面板打开时的回调函数 */
+    onOpen?: () => void;
+    /** 下拉面板关闭时的回调函数 */
+    onClose?: () => void;
+}
+/** TimePicker 根 DOM 元素类型 */
+export type TimePickerRef = HTMLDivElement;

package/dist/types/TimePicker/type.d.ts

@@ -0,0 +1,55 @@
+import type { HTMLAttributes } from 'react';
+/** 时间选择器尺寸大小：小 (sm) | 中等 (md) | 大 (lg) */
+export type TimePickerSize = 'sm' | 'md' | 'lg';
+/** 下拉浮层弹出方向 */
+export type TimePickerPlacement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
+/** 时间值字符串类型（固定为 `'HH:mm:ss'`） */
+export type TimePickerValue = string;
+/** 时间选择器快捷预设项定义 */
+export interface TimePickerShortcut {
+    /** 快捷项展示文案 */
+    label: string;
+    /** 点击时根据当前时间生成的时间字符串（HH:mm:ss） */
+    getValue: (now: Date) => string | null;
+}
+/**
+ * TimePicker 组件属性接口
+ */
+export interface TimePickerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
+    /** 受控模式：当前时间值（格式为 'HH:mm:ss'） */
+    value?: string | null;
+    /** 非受控模式：初始时间值（格式为 'HH:mm:ss'） */
+    defaultValue?: string | null;
+    /** 仅控制展示格式，默认为 `'HH:mm:ss'`；注意 value 与 onChange 始终遵循 `'HH:mm:ss'` */
+    format?: string;
+    /** 快捷预设选项列表 */
+    shortcuts?: TimePickerShortcut[];
+    /** 允许选择的最小时间（格式 'HH:mm:ss'） */
+    minTime?: string;
+    /** 允许选择的最大时间（格式 'HH:mm:ss'） */
+    maxTime?: string;
+    /** 自定义判断特定时间是否禁用的函数 */
+    disabledTime?: (time: string) => boolean;
+    /** 输入框占位提示文案，默认为 `'请选择时间'` */
+    placeholder?: string;
+    /** 是否禁用时间选择器，默认为 false */
+    disabled?: boolean;
+    /** 是否支持一键清空选中时间，默认为 false */
+    clearable?: boolean;
+    /** 控件尺寸大小，默认为 `md` */
+    size?: TimePickerSize;
+    /** 下拉面板弹出方向，默认为 `bottom-start` */
+    placement?: TimePickerPlacement;
+    /** 下拉面板与输入框之间的垂直间距偏移量（px），默认为 8 */
+    offset?: number;
+    /** 时间值变更时的回调函数 */
+    onChange?: (value: string | null) => void;
+    /** 点击清空按钮时的回调函数 */
+    onClear?: () => void;
+    /** 下拉面板打开时的回调函数 */
+    onOpen?: () => void;
+    /** 下拉面板关闭时的回调函数 */
+    onClose?: () => void;
+}
+/** TimePicker 根 DOM 元素类型 */
+export type TimePickerRef = HTMLDivElement;

package/dist/types/Timeline/Timeline.d.cts

@@ -0,0 +1,3 @@
+import type { TimelineProps } from './type.cjs';
+declare const Timeline: import("react").ForwardRefExoticComponent<TimelineProps & import("react").RefAttributes<HTMLOListElement>>;
+export default Timeline;

package/dist/types/Timeline/Timeline.d.ts

@@ -0,0 +1,3 @@
+import type { TimelineProps } from './type.js';
+declare const Timeline: import("react").ForwardRefExoticComponent<TimelineProps & import("react").RefAttributes<HTMLOListElement>>;
+export default Timeline;

package/dist/types/Timeline/index.d.cts

@@ -0,0 +1,5 @@
+import Timeline from './Timeline.cjs';
+/** Timeline 时间轴组件 */
+export declare const VlTimeline: import("react").ForwardRefExoticComponent<import("./type.cjs").TimelineProps & import("react").RefAttributes<HTMLOListElement>>;
+export type { TimelineProps, TimelineItem, TimelineItemStatus, TimelineMode, TimelineSize, TimelineRef } from './type.cjs';
+export default Timeline;

package/dist/types/Timeline/index.d.ts

@@ -0,0 +1,5 @@
+import Timeline from './Timeline.js';
+/** Timeline 时间轴组件 */
+export declare const VlTimeline: import("react").ForwardRefExoticComponent<import("./type.js").TimelineProps & import("react").RefAttributes<HTMLOListElement>>;
+export type { TimelineProps, TimelineItem, TimelineItemStatus, TimelineMode, TimelineSize, TimelineRef } from './type.js';
+export default Timeline;

package/dist/types/Timeline/type.d.cts

@@ -0,0 +1,49 @@
+import type { ComponentType, OlHTMLAttributes, ReactNode } from 'react';
+/** 时间轴排版模式：左对齐 (start) | 左右交替 (alternate) | 交替反转 (alternate-reverse) | 右对齐 (end) */
+export type TimelineMode = 'start' | 'alternate' | 'alternate-reverse' | 'end';
+/** 时间轴尺寸：小 (sm) | 中等 (md) | 大 (lg) */
+export type TimelineSize = 'sm' | 'md' | 'lg';
+/** 时间轴节点语义状态 */
+export type TimelineItemStatus = 'default' | 'primary' | 'success' | 'warning' | 'error';
+/** 单个时间轴节点数据定义 */
+export interface TimelineItem {
+    /** 节点唯一标识 key */
+    key?: string | number;
+    /** 节点标签文案（如时间戳） */
+    label?: string;
+    /** 节点标题 */
+    title?: string;
+    /** 节点详细描述内容 */
+    content?: string;
+    /** 节点状态颜色，默认为 `'default'` */
+    status?: TimelineItemStatus;
+    /** 自定义节点指示器图标 */
+    icon?: ReactNode | ComponentType<any>;
+}
+/**
+ * Timeline 组件属性接口
+ */
+export interface TimelineProps extends OlHTMLAttributes<HTMLOListElement> {
+    /** 时间轴节点列表 */
+    items?: TimelineItem[];
+    /** 排版展示模式，默认为 `'start'` */
+    mode?: TimelineMode;
+    /** 尺寸大小，默认为 `md` */
+    size?: TimelineSize;
+    /** 是否倒序展示节点列表，默认为 false */
+    reverse?: boolean;
+    /** 是否在末尾展示一个进行中的幽灵待处理节点，默认为 false */
+    pending?: boolean;
+    /** 自定义标签渲染函数 */
+    renderLabel?: (item: TimelineItem, index: number) => ReactNode;
+    /** 自定义正文内容渲染函数 */
+    renderContent?: (item: TimelineItem, index: number) => ReactNode;
+    /** 自定义节点图标渲染函数 */
+    renderIcon?: (item: TimelineItem, index: number) => ReactNode;
+    /** 进行中幽灵节点的内容 */
+    pendingContent?: ReactNode;
+    /** 进行中幽灵节点的图标 */
+    pendingIcon?: ReactNode;
+}
+/** Timeline 根 DOM 元素类型（`<ol>`） */
+export type TimelineRef = HTMLOListElement;

package/dist/types/Timeline/type.d.ts

@@ -0,0 +1,49 @@
+import type { ComponentType, OlHTMLAttributes, ReactNode } from 'react';
+/** 时间轴排版模式：左对齐 (start) | 左右交替 (alternate) | 交替反转 (alternate-reverse) | 右对齐 (end) */
+export type TimelineMode = 'start' | 'alternate' | 'alternate-reverse' | 'end';
+/** 时间轴尺寸：小 (sm) | 中等 (md) | 大 (lg) */
+export type TimelineSize = 'sm' | 'md' | 'lg';
+/** 时间轴节点语义状态 */
+export type TimelineItemStatus = 'default' | 'primary' | 'success' | 'warning' | 'error';
+/** 单个时间轴节点数据定义 */
+export interface TimelineItem {
+    /** 节点唯一标识 key */
+    key?: string | number;
+    /** 节点标签文案（如时间戳） */
+    label?: string;
+    /** 节点标题 */
+    title?: string;
+    /** 节点详细描述内容 */
+    content?: string;
+    /** 节点状态颜色，默认为 `'default'` */
+    status?: TimelineItemStatus;
+    /** 自定义节点指示器图标 */
+    icon?: ReactNode | ComponentType<any>;
+}
+/**
+ * Timeline 组件属性接口
+ */
+export interface TimelineProps extends OlHTMLAttributes<HTMLOListElement> {
+    /** 时间轴节点列表 */
+    items?: TimelineItem[];
+    /** 排版展示模式，默认为 `'start'` */
+    mode?: TimelineMode;
+    /** 尺寸大小，默认为 `md` */
+    size?: TimelineSize;
+    /** 是否倒序展示节点列表，默认为 false */
+    reverse?: boolean;
+    /** 是否在末尾展示一个进行中的幽灵待处理节点，默认为 false */
+    pending?: boolean;
+    /** 自定义标签渲染函数 */
+    renderLabel?: (item: TimelineItem, index: number) => ReactNode;
+    /** 自定义正文内容渲染函数 */
+    renderContent?: (item: TimelineItem, index: number) => ReactNode;
+    /** 自定义节点图标渲染函数 */
+    renderIcon?: (item: TimelineItem, index: number) => ReactNode;
+    /** 进行中幽灵节点的内容 */
+    pendingContent?: ReactNode;
+    /** 进行中幽灵节点的图标 */
+    pendingIcon?: ReactNode;
+}
+/** Timeline 根 DOM 元素类型（`<ol>`） */
+export type TimelineRef = HTMLOListElement;

package/dist/types/Tooltip/Tooltip.d.cts

@@ -0,0 +1,3 @@
+import type { TooltipProps } from './type.cjs';
+declare const Tooltip: import("react").ForwardRefExoticComponent<TooltipProps & import("react").RefAttributes<HTMLDivElement>>;
+export default Tooltip;

package/dist/types/Tooltip/Tooltip.d.ts

@@ -0,0 +1,3 @@
+import type { TooltipProps } from './type.js';
+declare const Tooltip: import("react").ForwardRefExoticComponent<TooltipProps & import("react").RefAttributes<HTMLDivElement>>;
+export default Tooltip;

package/dist/types/Tooltip/index.d.cts

@@ -0,0 +1,5 @@
+import Tooltip from './Tooltip.cjs';
+/** Tooltip 文字提示组件 */
+export declare const VlTooltip: import("react").ForwardRefExoticComponent<import("./type.cjs").TooltipProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { TooltipProps, TooltipPlacement, TooltipTrigger, TooltipRef } from './type.cjs';
+export default Tooltip;

package/dist/types/Tooltip/index.d.ts

@@ -0,0 +1,5 @@
+import Tooltip from './Tooltip.js';
+/** Tooltip 文字提示组件 */
+export declare const VlTooltip: import("react").ForwardRefExoticComponent<import("./type.js").TooltipProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { TooltipProps, TooltipPlacement, TooltipTrigger, TooltipRef } from './type.js';
+export default Tooltip;

package/dist/types/Tooltip/type.d.cts

@@ -0,0 +1,40 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+/** 文字提示气泡对齐方向枚举（支持 12 方向） */
+export type TooltipPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end';
+/** 触发提示气泡展示的交互方式：鼠标悬停 (hover) | 点击 (click) | 获得焦点 (focus) */
+export type TooltipTrigger = 'hover' | 'click' | 'focus';
+/**
+ * Tooltip 组件属性接口
+ */
+export interface TooltipProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'content'> {
+    /** 气泡提示中显示的文本内容或 ReactNode */
+    content?: ReactNode;
+    /** 气泡弹出方向，默认为 `'top'` */
+    placement?: TooltipPlacement;
+    /** 触发方式，默认为 `'hover'` */
+    trigger?: TooltipTrigger;
+    /** 是否禁用提示气泡，默认为 false */
+    disabled?: boolean;
+    /** 气泡与目标元素之间的像素偏移量，默认为 8 */
+    offset?: number;
+    /** 触发到气泡显示的延迟时间（毫秒），默认为 100 */
+    showDelay?: number;
+    /** 移出到气泡隐藏的延迟时间（毫秒），默认为 100 */
+    hideDelay?: number;
+    /** 是否显示气泡小三角箭头，默认为 true */
+    showArrow?: boolean;
+    /** 气泡内容的最大宽度（px 或 CSS 字符串），默认为 300 */
+    maxWidth?: number | string;
+    /** 受控模式：气泡是否处于显示状态 */
+    open?: boolean;
+    /** 非受控模式：初始是否显示，默认为 false */
+    defaultOpen?: boolean;
+    /** 显示/隐藏状态发生变化时的回调函数 */
+    onChange?: (value: boolean) => void;
+    /** 气泡显示时的回调函数 */
+    onShow?: () => void;
+    /** 气泡隐藏时的回调函数 */
+    onHide?: () => void;
+}
+/** Tooltip 根 DOM 容器元素类型 */
+export type TooltipRef = HTMLDivElement;

package/dist/types/Tooltip/type.d.ts

@@ -0,0 +1,40 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+/** 文字提示气泡对齐方向枚举（支持 12 方向） */
+export type TooltipPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end';
+/** 触发提示气泡展示的交互方式：鼠标悬停 (hover) | 点击 (click) | 获得焦点 (focus) */
+export type TooltipTrigger = 'hover' | 'click' | 'focus';
+/**
+ * Tooltip 组件属性接口
+ */
+export interface TooltipProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'content'> {
+    /** 气泡提示中显示的文本内容或 ReactNode */
+    content?: ReactNode;
+    /** 气泡弹出方向，默认为 `'top'` */
+    placement?: TooltipPlacement;
+    /** 触发方式，默认为 `'hover'` */
+    trigger?: TooltipTrigger;
+    /** 是否禁用提示气泡，默认为 false */
+    disabled?: boolean;
+    /** 气泡与目标元素之间的像素偏移量，默认为 8 */
+    offset?: number;
+    /** 触发到气泡显示的延迟时间（毫秒），默认为 100 */
+    showDelay?: number;
+    /** 移出到气泡隐藏的延迟时间（毫秒），默认为 100 */
+    hideDelay?: number;
+    /** 是否显示气泡小三角箭头，默认为 true */
+    showArrow?: boolean;
+    /** 气泡内容的最大宽度（px 或 CSS 字符串），默认为 300 */
+    maxWidth?: number | string;
+    /** 受控模式：气泡是否处于显示状态 */
+    open?: boolean;
+    /** 非受控模式：初始是否显示，默认为 false */
+    defaultOpen?: boolean;
+    /** 显示/隐藏状态发生变化时的回调函数 */
+    onChange?: (value: boolean) => void;
+    /** 气泡显示时的回调函数 */
+    onShow?: () => void;
+    /** 气泡隐藏时的回调函数 */
+    onHide?: () => void;
+}
+/** Tooltip 根 DOM 容器元素类型 */
+export type TooltipRef = HTMLDivElement;

package/dist/types/Transition/Transition.d.cts

@@ -0,0 +1,6 @@
+import type { TransitionProps } from './type.cjs';
+declare const Transition: {
+    ({ show, name, unmountOnExit, forceMount, deferEffects, onAfterEnter, onAfterLeave, children }: TransitionProps): import("react").ReactElement<import("react").RefAttributes<HTMLElement>, string | import("react").JSXElementConstructor<any>> | null;
+    displayName: string;
+};
+export default Transition;

package/dist/types/Transition/Transition.d.ts

@@ -0,0 +1,6 @@
+import type { TransitionProps } from './type.js';
+declare const Transition: {
+    ({ show, name, unmountOnExit, forceMount, deferEffects, onAfterEnter, onAfterLeave, children }: TransitionProps): import("react").ReactElement<import("react").RefAttributes<HTMLElement>, string | import("react").JSXElementConstructor<any>> | null;
+    displayName: string;
+};
+export default Transition;

package/dist/types/Transition/index.d.cts

@@ -0,0 +1,8 @@
+import Transition from './Transition.cjs';
+/** Transition 基础过渡动效组件 */
+export declare const VlTransition: {
+    ({ show, name, unmountOnExit, forceMount, deferEffects, onAfterEnter, onAfterLeave, children }: import("./type.cjs").TransitionProps): import("react").ReactElement<import("react").RefAttributes<HTMLElement>, string | import("react").JSXElementConstructor<any>> | null;
+    displayName: string;
+};
+export type { TransitionProps } from './type.cjs';
+export default Transition;

package/dist/types/Transition/index.d.ts

@@ -0,0 +1,8 @@
+import Transition from './Transition.js';
+/** Transition 基础过渡动效组件 */
+export declare const VlTransition: {
+    ({ show, name, unmountOnExit, forceMount, deferEffects, onAfterEnter, onAfterLeave, children }: import("./type.js").TransitionProps): import("react").ReactElement<import("react").RefAttributes<HTMLElement>, string | import("react").JSXElementConstructor<any>> | null;
+    displayName: string;
+};
+export type { TransitionProps } from './type.js';
+export default Transition;

package/dist/types/Transition/type.d.cts

@@ -0,0 +1,22 @@
+import type { ReactElement, RefAttributes } from 'react';
+/**
+ * Transition 组件属性接口
+ */
+export interface TransitionProps {
+    /** 控制子元素的显示与隐藏状态 */
+    show: boolean;
+    /** 过渡动画类名前缀（如 `vl-loading-fade`），用于派生 `-enter-from`, `-enter-active`, `-leave-to` 等类名 */
+    name: string;
+    /** 在离场动画完全结束后是否销毁子节点 DOM，默认为 false */
+    unmountOnExit?: boolean;
+    /** 在 show=false 时仍预挂载节点，供 Portal 浮层先完成测量和定位，默认为 false */
+    forceMount?: boolean;
+    /** SSR hydration 首轮暂缓浏览器动画副作用，迁移到 Portal 后再启动生命周期 */
+    deferEffects?: boolean;
+    /** 入场动画结束后的回调函数 */
+    onAfterEnter?: () => void;
+    /** 离场动画结束后的回调函数 */
+    onAfterLeave?: () => void;
+    /** 唯一的 React 元素子节点（必须能够接收 ref） */
+    children: ReactElement<RefAttributes<HTMLElement>>;
+}

package/dist/types/Transition/type.d.ts

@@ -0,0 +1,22 @@
+import type { ReactElement, RefAttributes } from 'react';
+/**
+ * Transition 组件属性接口
+ */
+export interface TransitionProps {
+    /** 控制子元素的显示与隐藏状态 */
+    show: boolean;
+    /** 过渡动画类名前缀（如 `vl-loading-fade`），用于派生 `-enter-from`, `-enter-active`, `-leave-to` 等类名 */
+    name: string;
+    /** 在离场动画完全结束后是否销毁子节点 DOM，默认为 false */
+    unmountOnExit?: boolean;
+    /** 在 show=false 时仍预挂载节点，供 Portal 浮层先完成测量和定位，默认为 false */
+    forceMount?: boolean;
+    /** SSR hydration 首轮暂缓浏览器动画副作用，迁移到 Portal 后再启动生命周期 */
+    deferEffects?: boolean;
+    /** 入场动画结束后的回调函数 */
+    onAfterEnter?: () => void;
+    /** 离场动画结束后的回调函数 */
+    onAfterLeave?: () => void;
+    /** 唯一的 React 元素子节点（必须能够接收 ref） */
+    children: ReactElement<RefAttributes<HTMLElement>>;
+}

package/dist/types/_shared/client.d.cts

@@ -0,0 +1,9 @@
+/**
+ * 监听当前组件是否已在浏览器客户端完成首轮挂载。
+ *
+ * Portal 只能在客户端提交后创建。延迟到 effect 可同时避免 SSR 调用 createPortal，
+ * 也让服务端 HTML 与客户端首次 hydration 输出保持一致。
+ *
+ * @returns 客户端就绪标志布尔值（SSR 期间为 false，挂载后变为 true）
+ */
+export declare const useClientReady: () => boolean;

package/dist/types/_shared/client.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 监听当前组件是否已在浏览器客户端完成首轮挂载。
+ *
+ * Portal 只能在客户端提交后创建。延迟到 effect 可同时避免 SSR 调用 createPortal，
+ * 也让服务端 HTML 与客户端首次 hydration 输出保持一致。
+ *
+ * @returns 客户端就绪标志布尔值（SSR 期间为 false，挂载后变为 true）
+ */
+export declare const useClientReady: () => boolean;

package/dist/types/_shared/date-picker.d.cts

@@ -0,0 +1,17 @@
+import type { DatePickerProps } from '../DatePicker/type.cjs';
+import type { DateTimePickerProps } from '../DateTimePicker/type.cjs';
+/** DatePickerCore 内部共享核心属性接口 */
+type DatePickerCoreProps = (DatePickerProps | DateTimePickerProps) & {
+    /** 当前宿主组件名称（用于 BEM 类名与标识生成） */
+    componentName: 'date-picker' | 'date-time-picker';
+    /** 是否启用带时分秒的时间选择面板 */
+    withTime?: boolean;
+    /** 最小允许的时间边界（格式 'HH:mm:ss'） */
+    minTime?: string;
+    /** 最大允许的时间边界（格式 'HH:mm:ss'） */
+    maxTime?: string;
+    /** 自定义判断特定时间是否禁用的函数 */
+    disabledTime?: (time: string) => boolean;
+};
+declare const DatePickerCore: import("react").ForwardRefExoticComponent<DatePickerCoreProps & import("react").RefAttributes<HTMLDivElement>>;
+export default DatePickerCore;

package/dist/types/_shared/date-picker.d.ts

@@ -0,0 +1,17 @@
+import type { DatePickerProps } from '../DatePicker/type.js';
+import type { DateTimePickerProps } from '../DateTimePicker/type.js';
+/** DatePickerCore 内部共享核心属性接口 */
+type DatePickerCoreProps = (DatePickerProps | DateTimePickerProps) & {
+    /** 当前宿主组件名称（用于 BEM 类名与标识生成） */
+    componentName: 'date-picker' | 'date-time-picker';
+    /** 是否启用带时分秒的时间选择面板 */
+    withTime?: boolean;
+    /** 最小允许的时间边界（格式 'HH:mm:ss'） */
+    minTime?: string;
+    /** 最大允许的时间边界（格式 'HH:mm:ss'） */
+    maxTime?: string;
+    /** 自定义判断特定时间是否禁用的函数 */
+    disabledTime?: (time: string) => boolean;
+};
+declare const DatePickerCore: import("react").ForwardRefExoticComponent<DatePickerCoreProps & import("react").RefAttributes<HTMLDivElement>>;
+export default DatePickerCore;