@vavt/react-ui 1.0.0

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

@@ -0,0 +1,20 @@
+import type { HTMLAttributes, ElementType } from 'react';
+/** 栅格行水平对齐方式 */
+export type RowJustify = 'start' | 'center' | 'end' | 'space-around' | 'space-between' | 'space-evenly';
+/** 栅格行垂直对齐方式 */
+export type RowAlign = 'top' | 'middle' | 'bottom';
+/** Row 根 DOM 元素类型 */
+export type RowRef = HTMLElement;
+/**
+ * Row 组件属性接口
+ */
+export interface RowProps extends HTMLAttributes<HTMLElement> {
+    /** 自定义渲染的 HTML 标签，默认为 `'div'` */
+    tag?: ElementType;
+    /** 栅格列之间的水平间距（px），默认为 0 */
+    gutter?: number;
+    /** 水平主轴对齐方式，默认为 `'start'` */
+    justify?: RowJustify;
+    /** 垂直交叉轴对齐方式，默认为 `'top'` */
+    align?: RowAlign;
+}

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

@@ -0,0 +1,20 @@
+import type { HTMLAttributes, ElementType } from 'react';
+/** 栅格行水平对齐方式 */
+export type RowJustify = 'start' | 'center' | 'end' | 'space-around' | 'space-between' | 'space-evenly';
+/** 栅格行垂直对齐方式 */
+export type RowAlign = 'top' | 'middle' | 'bottom';
+/** Row 根 DOM 元素类型 */
+export type RowRef = HTMLElement;
+/**
+ * Row 组件属性接口
+ */
+export interface RowProps extends HTMLAttributes<HTMLElement> {
+    /** 自定义渲染的 HTML 标签，默认为 `'div'` */
+    tag?: ElementType;
+    /** 栅格列之间的水平间距（px），默认为 0 */
+    gutter?: number;
+    /** 水平主轴对齐方式，默认为 `'start'` */
+    justify?: RowJustify;
+    /** 垂直交叉轴对齐方式，默认为 `'top'` */
+    align?: RowAlign;
+}

package/dist/types/Scrollbar/Scrollbar.d.cts

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

package/dist/types/Scrollbar/Scrollbar.d.ts

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

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

@@ -0,0 +1,5 @@
+import Scrollbar from './Scrollbar.cjs';
+/** Scrollbar 虚拟滚动条组件 */
+export declare const VlScrollbar: import("react").ForwardRefExoticComponent<import("./type.cjs").ScrollbarProps & import("react").RefAttributes<import("./type.cjs").ScrollbarRef>>;
+export type { ScrollbarProps, ScrollbarOrientation, ScrollbarSize, ScrollbarScrollPayload, ScrollbarRef } from './type.cjs';
+export default Scrollbar;

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

@@ -0,0 +1,5 @@
+import Scrollbar from './Scrollbar.js';
+/** Scrollbar 虚拟滚动条组件 */
+export declare const VlScrollbar: import("react").ForwardRefExoticComponent<import("./type.js").ScrollbarProps & import("react").RefAttributes<import("./type.js").ScrollbarRef>>;
+export type { ScrollbarProps, ScrollbarOrientation, ScrollbarSize, ScrollbarScrollPayload, ScrollbarRef } from './type.js';
+export default Scrollbar;

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

@@ -0,0 +1,60 @@
+import type { HTMLAttributes } from 'react';
+/** 滚动条方向：仅垂直 (vertical) | 仅水平 (horizontal) | 双向 (both) */
+export type ScrollbarOrientation = 'vertical' | 'horizontal' | 'both';
+/** 滚动条尺寸：小 (sm) | 中等 (md) | 大 (lg) */
+export type ScrollbarSize = 'sm' | 'md' | 'lg';
+/**
+ * Scrollbar 滚动回调参数对象
+ */
+export interface ScrollbarScrollPayload {
+    /** 垂直方向已滚动距离 (px) */
+    scrollTop: number;
+    /** 水平方向已滚动距离 (px) */
+    scrollLeft: number;
+    /** 垂直方向最大可滚动距离 (px) */
+    maxScrollTop: number;
+    /** 水平方向最大可滚动距离 (px) */
+    maxScrollLeft: number;
+    /** 垂直滚动比例 (0 ~ 1) */
+    ratioY: number;
+    /** 水平滚动比例 (0 ~ 1) */
+    ratioX: number;
+}
+/**
+ * Scrollbar 组件属性接口
+ */
+export interface ScrollbarProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onScroll'> {
+    /** 滚动方向，默认为 `'vertical'` */
+    orientation?: ScrollbarOrientation;
+    /** 滚动条尺寸大小，默认为 `md` */
+    size?: ScrollbarSize;
+    /** 滚动条是否保持常显（不自动隐藏），默认为 false */
+    alwaysVisible?: boolean;
+    /** 停止滚动/移出后自动隐藏滚动条的延迟时间（毫秒），默认为 1200 */
+    autoHideDelay?: number;
+    /** 滑块最小像素长度，默认为 24 */
+    minThumbSize?: number;
+    /** 自定义滚动条粗细（如 6 或 `'6px'`） */
+    thickness?: number | string;
+    /** 自定义轨道背景颜色 */
+    trackColor?: string;
+    /** 自定义滑块颜色 */
+    thumbColor?: string;
+    /** 滚动视口的无障碍名称，默认为 `'可滚动区域'` */
+    viewportLabel?: string;
+    /** 滚动视口的 tabIndex；默认为 0，以保留原生键盘方向键滚动能力 */
+    viewportTabIndex?: number;
+    /** 滚动发生时的回调函数 */
+    onScroll?: (payload: ScrollbarScrollPayload) => void;
+}
+/**
+ * Scrollbar 组件暴露的命令式 Ref 句柄
+ */
+export interface ScrollbarRef {
+    /** 手动重新计算并更新滚动条与滑块尺寸位置 */
+    update: () => void;
+    /** 平滑滚动或立即定位到指定坐标 */
+    scrollTo: (options: ScrollToOptions | number, y?: number) => void;
+    /** 获取原生视口 DOM 容器元素 */
+    getViewport: () => HTMLElement | null;
+}

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

@@ -0,0 +1,60 @@
+import type { HTMLAttributes } from 'react';
+/** 滚动条方向：仅垂直 (vertical) | 仅水平 (horizontal) | 双向 (both) */
+export type ScrollbarOrientation = 'vertical' | 'horizontal' | 'both';
+/** 滚动条尺寸：小 (sm) | 中等 (md) | 大 (lg) */
+export type ScrollbarSize = 'sm' | 'md' | 'lg';
+/**
+ * Scrollbar 滚动回调参数对象
+ */
+export interface ScrollbarScrollPayload {
+    /** 垂直方向已滚动距离 (px) */
+    scrollTop: number;
+    /** 水平方向已滚动距离 (px) */
+    scrollLeft: number;
+    /** 垂直方向最大可滚动距离 (px) */
+    maxScrollTop: number;
+    /** 水平方向最大可滚动距离 (px) */
+    maxScrollLeft: number;
+    /** 垂直滚动比例 (0 ~ 1) */
+    ratioY: number;
+    /** 水平滚动比例 (0 ~ 1) */
+    ratioX: number;
+}
+/**
+ * Scrollbar 组件属性接口
+ */
+export interface ScrollbarProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onScroll'> {
+    /** 滚动方向，默认为 `'vertical'` */
+    orientation?: ScrollbarOrientation;
+    /** 滚动条尺寸大小，默认为 `md` */
+    size?: ScrollbarSize;
+    /** 滚动条是否保持常显（不自动隐藏），默认为 false */
+    alwaysVisible?: boolean;
+    /** 停止滚动/移出后自动隐藏滚动条的延迟时间（毫秒），默认为 1200 */
+    autoHideDelay?: number;
+    /** 滑块最小像素长度，默认为 24 */
+    minThumbSize?: number;
+    /** 自定义滚动条粗细（如 6 或 `'6px'`） */
+    thickness?: number | string;
+    /** 自定义轨道背景颜色 */
+    trackColor?: string;
+    /** 自定义滑块颜色 */
+    thumbColor?: string;
+    /** 滚动视口的无障碍名称，默认为 `'可滚动区域'` */
+    viewportLabel?: string;
+    /** 滚动视口的 tabIndex；默认为 0，以保留原生键盘方向键滚动能力 */
+    viewportTabIndex?: number;
+    /** 滚动发生时的回调函数 */
+    onScroll?: (payload: ScrollbarScrollPayload) => void;
+}
+/**
+ * Scrollbar 组件暴露的命令式 Ref 句柄
+ */
+export interface ScrollbarRef {
+    /** 手动重新计算并更新滚动条与滑块尺寸位置 */
+    update: () => void;
+    /** 平滑滚动或立即定位到指定坐标 */
+    scrollTo: (options: ScrollToOptions | number, y?: number) => void;
+    /** 获取原生视口 DOM 容器元素 */
+    getViewport: () => HTMLElement | null;
+}

package/dist/types/Select/Select.d.cts

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

package/dist/types/Select/Select.d.ts

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

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

@@ -0,0 +1,5 @@
+import Select from './Select.cjs';
+/** Select 选择器组件 */
+export declare const VlSelect: import("react").ForwardRefExoticComponent<import("./type.cjs").SelectProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { SelectProps, SelectPlacement, SelectOption, SelectOptionIcon, SelectSize, SelectValue, SelectRef } from './type.cjs';
+export default Select;

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

@@ -0,0 +1,5 @@
+import Select from './Select.js';
+/** Select 选择器组件 */
+export declare const VlSelect: import("react").ForwardRefExoticComponent<import("./type.js").SelectProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { SelectProps, SelectPlacement, SelectOption, SelectOptionIcon, SelectSize, SelectValue, SelectRef } from './type.js';
+export default Select;

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

@@ -0,0 +1,91 @@
+import type { FocusEvent, HTMLAttributes, ReactNode } from 'react';
+import type { DecorativeIcon } from '../_shared/icon.cjs';
+/** 下拉选择器尺寸：小 (sm) | 中等 (md) | 大 (lg) */
+export type SelectSize = 'sm' | 'md' | 'lg';
+/** 下拉选择浮层对齐方向 */
+export type SelectPlacement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
+/** 选项值类型 */
+export type SelectValue = string | number;
+/** 选项前置图标类型 */
+export type SelectOptionIcon = DecorativeIcon;
+/** 下拉选项数据结构 */
+export interface SelectOption {
+    /** 选项绑定的实际值 */
+    value: SelectValue;
+    /** 选项展示的文本标签 */
+    label: string;
+    /** 是否禁用该选项，默认为 false */
+    disabled?: boolean;
+    /** 是否作为分割线项展示，默认为 false */
+    divider?: boolean;
+    /** 选项前置装饰图标 */
+    icon?: SelectOptionIcon;
+}
+/**
+ * Select 组件属性接口
+ */
+export interface SelectProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'onFocus' | 'onBlur' | 'defaultValue'> {
+    /** 受控模式：当前选中值（单选为 string | number | null，多选为数组） */
+    value?: SelectValue | SelectValue[] | null;
+    /** 非受控模式的初始值；与 value 同时传入时由 value 接管 */
+    defaultValue?: SelectValue | SelectValue[] | null;
+    /** 下拉候选数据项列表 */
+    options?: SelectOption[];
+    /** 未选择时的占位提示文案，默认为 `'请选择'` */
+    placeholder?: string;
+    /** 是否启用搜索过滤功能，默认为 false */
+    filterable?: boolean;
+    /** 搜索输入框的占位文案，默认为 `'搜索'` */
+    filterPlaceholder?: string;
+    /** 是否支持多选模式，默认为 false */
+    multiple?: boolean;
+    /** 多选模式下是否支持用户自定义输入创建新标签项（Taggable），默认为 false */
+    taggable?: boolean;
+    /** 多选时最多展示的 Tag 数量，超出部分折叠展示 */
+    maxTagCount?: number;
+    /** 是否禁用整个选择器，默认为 false */
+    disabled?: boolean;
+    /** 是否处于远程搜索/加载中状态，默认为 false */
+    loading?: boolean;
+    /** 控件尺寸大小，默认为 `md` */
+    size?: SelectSize;
+    /** 是否支持一键清空选中值，默认为 false */
+    clearable?: boolean;
+    /** 下拉浮层弹出方向，默认为 `bottom-start` */
+    placement?: SelectPlacement;
+    /** 下拉浮层与触发器的垂直间距偏移量（px），默认为 8 */
+    offset?: number;
+    /** 无匹配数据时的提示文案，默认为 `'暂无数据'` */
+    emptyText?: string;
+    /** 自定义下拉选项内容的渲染函数 */
+    renderOption?: (option: SelectOption, index: number, selected: boolean) => ReactNode;
+    /** 自定义空数据状态的内容节点 */
+    emptyContent?: ReactNode;
+    /**
+     * 选中值发生变更时的回调函数。
+     *
+     * 去重语义在单选与多选下并不相同，因为它建立在下一值与当前值的 `Object.is` 比较之上：
+     * - 单选的值是原始类型，重复点选同一个已选中项不会触发本回调；
+     * - 多选的值是每次都新建的数组，即使成员完全相同也会触发本回调。
+     *
+     * 因此不要用「是否收到本回调」来判断选中集合是否真的发生了变化；多选场景如需该判断，
+     * 请在回调内自行比较成员。
+     *
+     * @param value 变更后的完整选中值；单选为选项值或 null，多选为选项值数组
+     * @param option 本次变更涉及的选项。仅在点选/取消单个选项时提供；
+     *               清空、移除标签、Backspace 删除末项等批量操作没有单一来源选项，此处为 undefined
+     */
+    onChange?: (value: SelectValue | SelectValue[] | null, option?: SelectOption) => void;
+    /** 点击清空按钮时的回调函数 */
+    onClear?: () => void;
+    /** 下拉浮层打开时的回调函数 */
+    onOpen?: () => void;
+    /** 下拉浮层关闭时的回调函数 */
+    onClose?: () => void;
+    /** 触发器获得焦点时的回调函数 */
+    onFocus?: (event: FocusEvent<HTMLElement>) => void;
+    /** 触发器失去焦点时的回调函数 */
+    onBlur?: (event: FocusEvent<HTMLElement>) => void;
+}
+/** Select 根 DOM 容器元素类型 */
+export type SelectRef = HTMLDivElement;

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

@@ -0,0 +1,91 @@
+import type { FocusEvent, HTMLAttributes, ReactNode } from 'react';
+import type { DecorativeIcon } from '../_shared/icon.js';
+/** 下拉选择器尺寸：小 (sm) | 中等 (md) | 大 (lg) */
+export type SelectSize = 'sm' | 'md' | 'lg';
+/** 下拉选择浮层对齐方向 */
+export type SelectPlacement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
+/** 选项值类型 */
+export type SelectValue = string | number;
+/** 选项前置图标类型 */
+export type SelectOptionIcon = DecorativeIcon;
+/** 下拉选项数据结构 */
+export interface SelectOption {
+    /** 选项绑定的实际值 */
+    value: SelectValue;
+    /** 选项展示的文本标签 */
+    label: string;
+    /** 是否禁用该选项，默认为 false */
+    disabled?: boolean;
+    /** 是否作为分割线项展示，默认为 false */
+    divider?: boolean;
+    /** 选项前置装饰图标 */
+    icon?: SelectOptionIcon;
+}
+/**
+ * Select 组件属性接口
+ */
+export interface SelectProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'onFocus' | 'onBlur' | 'defaultValue'> {
+    /** 受控模式：当前选中值（单选为 string | number | null，多选为数组） */
+    value?: SelectValue | SelectValue[] | null;
+    /** 非受控模式的初始值；与 value 同时传入时由 value 接管 */
+    defaultValue?: SelectValue | SelectValue[] | null;
+    /** 下拉候选数据项列表 */
+    options?: SelectOption[];
+    /** 未选择时的占位提示文案，默认为 `'请选择'` */
+    placeholder?: string;
+    /** 是否启用搜索过滤功能，默认为 false */
+    filterable?: boolean;
+    /** 搜索输入框的占位文案，默认为 `'搜索'` */
+    filterPlaceholder?: string;
+    /** 是否支持多选模式，默认为 false */
+    multiple?: boolean;
+    /** 多选模式下是否支持用户自定义输入创建新标签项（Taggable），默认为 false */
+    taggable?: boolean;
+    /** 多选时最多展示的 Tag 数量，超出部分折叠展示 */
+    maxTagCount?: number;
+    /** 是否禁用整个选择器，默认为 false */
+    disabled?: boolean;
+    /** 是否处于远程搜索/加载中状态，默认为 false */
+    loading?: boolean;
+    /** 控件尺寸大小，默认为 `md` */
+    size?: SelectSize;
+    /** 是否支持一键清空选中值，默认为 false */
+    clearable?: boolean;
+    /** 下拉浮层弹出方向，默认为 `bottom-start` */
+    placement?: SelectPlacement;
+    /** 下拉浮层与触发器的垂直间距偏移量（px），默认为 8 */
+    offset?: number;
+    /** 无匹配数据时的提示文案，默认为 `'暂无数据'` */
+    emptyText?: string;
+    /** 自定义下拉选项内容的渲染函数 */
+    renderOption?: (option: SelectOption, index: number, selected: boolean) => ReactNode;
+    /** 自定义空数据状态的内容节点 */
+    emptyContent?: ReactNode;
+    /**
+     * 选中值发生变更时的回调函数。
+     *
+     * 去重语义在单选与多选下并不相同，因为它建立在下一值与当前值的 `Object.is` 比较之上：
+     * - 单选的值是原始类型，重复点选同一个已选中项不会触发本回调；
+     * - 多选的值是每次都新建的数组，即使成员完全相同也会触发本回调。
+     *
+     * 因此不要用「是否收到本回调」来判断选中集合是否真的发生了变化；多选场景如需该判断，
+     * 请在回调内自行比较成员。
+     *
+     * @param value 变更后的完整选中值；单选为选项值或 null，多选为选项值数组
+     * @param option 本次变更涉及的选项。仅在点选/取消单个选项时提供；
+     *               清空、移除标签、Backspace 删除末项等批量操作没有单一来源选项，此处为 undefined
+     */
+    onChange?: (value: SelectValue | SelectValue[] | null, option?: SelectOption) => void;
+    /** 点击清空按钮时的回调函数 */
+    onClear?: () => void;
+    /** 下拉浮层打开时的回调函数 */
+    onOpen?: () => void;
+    /** 下拉浮层关闭时的回调函数 */
+    onClose?: () => void;
+    /** 触发器获得焦点时的回调函数 */
+    onFocus?: (event: FocusEvent<HTMLElement>) => void;
+    /** 触发器失去焦点时的回调函数 */
+    onBlur?: (event: FocusEvent<HTMLElement>) => void;
+}
+/** Select 根 DOM 容器元素类型 */
+export type SelectRef = HTMLDivElement;

package/dist/types/Sidebar/Sidebar.d.cts

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

package/dist/types/Sidebar/Sidebar.d.ts

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

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

@@ -0,0 +1,5 @@
+import Sidebar from './Sidebar.cjs';
+/** Sidebar 悬浮侧边操作栏组件 */
+export declare const VlSidebar: import("react").ForwardRefExoticComponent<import("./type.cjs").SidebarProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { SidebarProps, SidebarItem, SidebarPosition, SidebarSize, SidebarShape, SidebarIcon, SidebarRef } from './type.cjs';
+export default Sidebar;

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

@@ -0,0 +1,5 @@
+import Sidebar from './Sidebar.js';
+/** Sidebar 悬浮侧边操作栏组件 */
+export declare const VlSidebar: import("react").ForwardRefExoticComponent<import("./type.js").SidebarProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { SidebarProps, SidebarItem, SidebarPosition, SidebarSize, SidebarShape, SidebarIcon, SidebarRef } from './type.js';
+export default Sidebar;

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

@@ -0,0 +1,54 @@
+import type { HTMLAttributes } from 'react';
+import type { ComponentIcon } from '../_shared/icon.cjs';
+/** 侧边栏停靠方位：左侧 (left) 或 右侧 (right) */
+export type SidebarPosition = 'left' | 'right';
+/** 侧边栏尺寸：小 (sm) | 中等 (md) | 大 (lg) */
+export type SidebarSize = 'sm' | 'md' | 'lg';
+/** 侧边栏操作按钮形状：方形 (square) 或 圆形 (circle) */
+export type SidebarShape = 'square' | 'circle';
+/** 侧边栏图标组件类型 */
+export type SidebarIcon = ComponentIcon;
+/** 单个侧边栏操作项配置 */
+export interface SidebarItem {
+    /** 唯一标识 key */
+    key?: string | number;
+    /** 悬停或展示的文本标签 */
+    label?: string;
+    /** 图标组件 */
+    icon?: SidebarIcon;
+    /** 是否禁用交互，默认为 false */
+    disabled?: boolean;
+    /** 是否处于高亮激活状态，默认为 false */
+    active?: boolean;
+    /** 是否作为分割线展示，默认为 false */
+    divider?: boolean;
+    /** 点击单个项时的独立回调函数 */
+    onClick?: (item: SidebarItem) => void;
+}
+/**
+ * Sidebar 组件属性接口
+ */
+export interface SidebarProps extends HTMLAttributes<HTMLDivElement> {
+    /** 侧边栏项列表 */
+    items?: SidebarItem[];
+    /** 停靠方位，默认为 `'right'` */
+    position?: SidebarPosition;
+    /** 距离停靠侧的边距偏移（px 或 CSS 字符串），默认为设计系统 space-6 */
+    offset?: number | string;
+    /** 距离视口顶部的绝对偏移（px 或 CSS 字符串） */
+    top?: number | string;
+    /** 距离视口底部的绝对偏移（px 或 CSS 字符串） */
+    bottom?: number | string;
+    /** 按钮尺寸大小，默认为 `md` */
+    size?: SidebarSize;
+    /** 按钮形状，默认为 `'square'` */
+    shape?: SidebarShape;
+    /** 按钮之间的垂直间距，默认为设计系统 space-2 */
+    gap?: number | string;
+    /** 浮层 z-index 层级 */
+    zIndex?: number;
+    /** 点击任意项时的全局回调函数 */
+    onItemClick?: (item: SidebarItem, index: number) => void;
+}
+/** Sidebar 根 DOM 容器元素类型 */
+export type SidebarRef = HTMLDivElement;

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

@@ -0,0 +1,54 @@
+import type { HTMLAttributes } from 'react';
+import type { ComponentIcon } from '../_shared/icon.js';
+/** 侧边栏停靠方位：左侧 (left) 或 右侧 (right) */
+export type SidebarPosition = 'left' | 'right';
+/** 侧边栏尺寸：小 (sm) | 中等 (md) | 大 (lg) */
+export type SidebarSize = 'sm' | 'md' | 'lg';
+/** 侧边栏操作按钮形状：方形 (square) 或 圆形 (circle) */
+export type SidebarShape = 'square' | 'circle';
+/** 侧边栏图标组件类型 */
+export type SidebarIcon = ComponentIcon;
+/** 单个侧边栏操作项配置 */
+export interface SidebarItem {
+    /** 唯一标识 key */
+    key?: string | number;
+    /** 悬停或展示的文本标签 */
+    label?: string;
+    /** 图标组件 */
+    icon?: SidebarIcon;
+    /** 是否禁用交互，默认为 false */
+    disabled?: boolean;
+    /** 是否处于高亮激活状态，默认为 false */
+    active?: boolean;
+    /** 是否作为分割线展示，默认为 false */
+    divider?: boolean;
+    /** 点击单个项时的独立回调函数 */
+    onClick?: (item: SidebarItem) => void;
+}
+/**
+ * Sidebar 组件属性接口
+ */
+export interface SidebarProps extends HTMLAttributes<HTMLDivElement> {
+    /** 侧边栏项列表 */
+    items?: SidebarItem[];
+    /** 停靠方位，默认为 `'right'` */
+    position?: SidebarPosition;
+    /** 距离停靠侧的边距偏移（px 或 CSS 字符串），默认为设计系统 space-6 */
+    offset?: number | string;
+    /** 距离视口顶部的绝对偏移（px 或 CSS 字符串） */
+    top?: number | string;
+    /** 距离视口底部的绝对偏移（px 或 CSS 字符串） */
+    bottom?: number | string;
+    /** 按钮尺寸大小，默认为 `md` */
+    size?: SidebarSize;
+    /** 按钮形状，默认为 `'square'` */
+    shape?: SidebarShape;
+    /** 按钮之间的垂直间距，默认为设计系统 space-2 */
+    gap?: number | string;
+    /** 浮层 z-index 层级 */
+    zIndex?: number;
+    /** 点击任意项时的全局回调函数 */
+    onItemClick?: (item: SidebarItem, index: number) => void;
+}
+/** Sidebar 根 DOM 容器元素类型 */
+export type SidebarRef = HTMLDivElement;

package/dist/types/Slider/Slider.d.cts

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

package/dist/types/Slider/Slider.d.ts

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

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

@@ -0,0 +1,5 @@
+import Slider from './Slider.cjs';
+/** Slider 滑动输入条组件 */
+export declare const VlSlider: import("react").ForwardRefExoticComponent<import("./type.cjs").SliderProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { SliderProps, SliderStatus, SliderTooltipFormatter, SliderMark, SliderRef } from './type.cjs';
+export default Slider;

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

@@ -0,0 +1,5 @@
+import Slider from './Slider.js';
+/** Slider 滑动输入条组件 */
+export declare const VlSlider: import("react").ForwardRefExoticComponent<import("./type.js").SliderProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { SliderProps, SliderStatus, SliderTooltipFormatter, SliderMark, SliderRef } from './type.js';
+export default Slider;

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

@@ -0,0 +1,47 @@
+import type { HTMLAttributes } from 'react';
+/** 滑块语义状态颜色：默认/中性 (default) | 主题色 (primary) | 成功 (success) | 警告 (warning) | 错误 (error) | 信息 (info) */
+export type SliderStatus = 'default' | 'primary' | 'success' | 'warning' | 'error' | 'info';
+/** 浮动提示文案格式化函数 */
+export type SliderTooltipFormatter = (value: number) => string;
+/** 刻度标记项定义 */
+export interface SliderMark {
+    /** 刻度对应的数值点 */
+    value: number;
+    /** 刻度下方展示的文本说明 */
+    label?: string;
+}
+/**
+ * Slider 组件属性接口
+ */
+export interface SliderProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
+    /** 受控模式：当前滑动值 */
+    value?: number | null;
+    /** 非受控模式：初始滑动值 */
+    defaultValue?: number | null;
+    /** 滑动条最小值边界，默认为 0 */
+    min?: number;
+    /** 滑动条最大值边界，默认为 100 */
+    max?: number;
+    /** 步长大小，默认为 1 */
+    step?: number;
+    /** 是否禁用滑块交互，默认为 false */
+    disabled?: boolean;
+    /** 滑块激活状态色调，默认为 `primary` */
+    status?: SliderStatus;
+    /** 是否在拖拽/悬停时展示气泡提示，默认为 true */
+    showTooltip?: boolean;
+    /** 气泡提示是否保持常显，默认为 false */
+    tooltipAlways?: boolean;
+    /** 自定义气泡提示文案格式化函数 */
+    tooltipFormatter?: SliderTooltipFormatter;
+    /** 是否在轨道上渲染离散步长断点，默认为 false */
+    showStops?: boolean;
+    /** 自定义刻度标记列表 */
+    marks?: SliderMark[];
+    /** 滑块无障碍名称说明 */
+    ariaLabel?: string;
+    /** 滑动数值变化时的回调函数 */
+    onChange?: (value: number) => void;
+}
+/** Slider 根 DOM 容器元素类型 */
+export type SliderRef = HTMLDivElement;

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

@@ -0,0 +1,47 @@
+import type { HTMLAttributes } from 'react';
+/** 滑块语义状态颜色：默认/中性 (default) | 主题色 (primary) | 成功 (success) | 警告 (warning) | 错误 (error) | 信息 (info) */
+export type SliderStatus = 'default' | 'primary' | 'success' | 'warning' | 'error' | 'info';
+/** 浮动提示文案格式化函数 */
+export type SliderTooltipFormatter = (value: number) => string;
+/** 刻度标记项定义 */
+export interface SliderMark {
+    /** 刻度对应的数值点 */
+    value: number;
+    /** 刻度下方展示的文本说明 */
+    label?: string;
+}
+/**
+ * Slider 组件属性接口
+ */
+export interface SliderProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
+    /** 受控模式：当前滑动值 */
+    value?: number | null;
+    /** 非受控模式：初始滑动值 */
+    defaultValue?: number | null;
+    /** 滑动条最小值边界，默认为 0 */
+    min?: number;
+    /** 滑动条最大值边界，默认为 100 */
+    max?: number;
+    /** 步长大小，默认为 1 */
+    step?: number;
+    /** 是否禁用滑块交互，默认为 false */
+    disabled?: boolean;
+    /** 滑块激活状态色调，默认为 `primary` */
+    status?: SliderStatus;
+    /** 是否在拖拽/悬停时展示气泡提示，默认为 true */
+    showTooltip?: boolean;
+    /** 气泡提示是否保持常显，默认为 false */
+    tooltipAlways?: boolean;
+    /** 自定义气泡提示文案格式化函数 */
+    tooltipFormatter?: SliderTooltipFormatter;
+    /** 是否在轨道上渲染离散步长断点，默认为 false */
+    showStops?: boolean;
+    /** 自定义刻度标记列表 */
+    marks?: SliderMark[];
+    /** 滑块无障碍名称说明 */
+    ariaLabel?: string;
+    /** 滑动数值变化时的回调函数 */
+    onChange?: (value: number) => void;
+}
+/** Slider 根 DOM 容器元素类型 */
+export type SliderRef = HTMLDivElement;