@vustcc/react 0.1.0-alpha.1

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，并遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
+
+## [0.1.0-alpha.1] - 2026-09-10
+
+### Added
+
+- 首次发布 `@vustcc/react` React 19 基础组件库。
+- 提供按钮、输入、选择、开关、复选框、日期范围和表单组件。
+- 提供表格、分页、标签、描述列表、卡片和空状态组件。
+- 提供弹窗、抽屉、模态框、菜单、标签页和面包屑组件。
+- 提供提示、通知、加载、告警和统一 SVG 图标组件。
+- 所有组件使用 `Vust*` 导出名和 VDL Token。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gwj
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# @vustcc/react
+
+VUST React 19 基础组件库，实现 VUST Design Language（VDL）的通用交互和视觉规范。
+
+## 安装
+
+```bash
+pnpm add @vustcc/react @vustcc/icons @vustcc/tokens
+```
+
+项目需要安装 React 19：
+
+```bash
+pnpm add react react-dom
+```
+
+## 样式
+
+在全局样式入口导入主题变量和组件样式：
+
+```css
+@import "@vustcc/tokens/index.css";
+@import "@vustcc/react/style.css";
+```
+
+## 使用
+
+组件采用按需导入：
+
+```tsx
+import { useState } from "react";
+import { VustButton, VustFormItem, VustIcon, VustInput } from "@vustcc/react";
+
+export default function SearchPanel() {
+  const [keyword, setKeyword] = useState("");
+
+  return (
+    <div>
+      <VustFormItem
+        label="关键词"
+        htmlFor="search-keyword"
+        labelId="search-keyword-label"
+        hint="输入名称或标识"
+        hintId="search-keyword-hint"
+      >
+        <VustInput
+          id="search-keyword"
+          value={keyword}
+          name="keyword"
+          ariaLabelledby="search-keyword-label"
+          ariaDescribedby="search-keyword-hint"
+          onChange={setKeyword}
+          placeholder="搜索"
+        />
+      </VustFormItem>
+      <VustButton type="primary">
+        <VustIcon name="search" size={16} />
+        查询
+      </VustButton>
+    </div>
+  );
+}
+```
+
+`VustInput`、`VustCheckbox` 和 `VustSelect` 未提供 `id` 时会自动生成；参与原生表单提交时应提供 `name`。复杂控件可通过 `ariaLabelledby` 和 `ariaDescribedby` 显式关联 `VustFormItem` 的标签、提示与错误节点。
+
+受控组件的 `value`（Checkbox 为 `checked`）为必填，变化统一通过 `onChange` 返回。React DOM 属性使用 `readOnly`、`maxLength`、`autoComplete`、`htmlFor` 和 `className` 等惯用名称，不提供小写兼容别名；业务参数、默认值及配置对象字段与 Vue 契约保持一致。
+
+## 组件范围
+
+- 操作：按钮、操作菜单
+- 输入：输入框、选择器、开关、复选框、日期时间范围
+- 数据：表格、分页、标签、描述列表
+- 容器：卡片、对话框、抽屉、模态框
+- 反馈：告警、通知、加载、空状态、提示
+- 导航：菜单、标签页、面包屑
+
+完整用途、交互、无障碍语义及跨框架映射参见[共享组件契约](https://github.com/vustcc/vust-ui/tree/dev/docs/components)。实际 Props、事件和类型声明以发布包中的 TypeScript 类型为准。
+
+## 约束
+
+- 组件不依赖业务 API、任何全局状态管理库或路由。
+- 视觉变量由 `@vustcc/tokens` 提供。
+- 图标由 `@vustcc/icons` 提供。
+- `react` 和 `react-dom` 是 peer dependencies，不会被组件库重复打包。

package/dist/components/VustActionMenu/VustActionMenu.d.ts

@@ -0,0 +1,20 @@
+import { default as React } from 'react';
+export interface VustAction {
+    label: string;
+    className?: string;
+    icon?: string;
+    disabled?: boolean;
+    tooltip?: string;
+    handler: () => void;
+}
+export interface VustActionMenuProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** 操作列表 */
+    actions: VustAction[];
+    /** 按钮文案 */
+    label?: string;
+    /** 是否禁用菜单入口 */
+    disabled?: boolean;
+    /** 菜单项默认图标 */
+    defaultIcon?: string;
+}
+export declare const VustActionMenu: React.FC<VustActionMenuProps>;

package/dist/components/VustAlert/VustAlert.d.ts

@@ -0,0 +1,20 @@
+import { default as React } from 'react';
+export interface VustAlertProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** 警告标题 */
+    title?: string;
+    /** 警告描述 (如果有 title, 则在下方显示) */
+    description?: string;
+    /** 警告类型 */
+    type?: "success" | "warning" | "error" | "info";
+    /** 是否显示图标 */
+    showIcon?: boolean;
+    /** 是否可关闭 */
+    closable?: boolean;
+    /** 关闭事件 */
+    onClose?: () => void;
+    /** 关闭按钮的无障碍标签 */
+    closeLabel?: string;
+    /** 子元素，将作为 description 渲染 */
+    children?: React.ReactNode;
+}
+export declare const VustAlert: React.FC<VustAlertProps>;

package/dist/components/VustBreadcrumb/VustBreadcrumb.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+export declare const BreadcrumbContext: React.Context<string>;
+export interface VustBreadcrumbProps extends React.HTMLAttributes<HTMLElement> {
+    /** 分隔符 */
+    separator?: string;
+}
+export declare const VustBreadcrumb: React.FC<VustBreadcrumbProps>;

package/dist/components/VustBreadcrumbItem/VustBreadcrumbItem.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+export interface VustBreadcrumbItemProps extends React.HTMLAttributes<HTMLSpanElement> {
+    /** 子元素，面包屑项内容 */
+    children?: React.ReactNode;
+}
+export declare const VustBreadcrumbItem: React.FC<VustBreadcrumbItemProps>;

package/dist/components/VustButton/VustButton.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+export interface VustButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "type"> {
+    type?: "primary" | "secondary" | "danger" | "warning" | "info";
+    size?: "small" | "default" | "large";
+    disabled?: boolean;
+    loading?: boolean;
+    onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;
+    children?: React.ReactNode;
+}
+export declare const VustButton: React.FC<VustButtonProps>;

package/dist/components/VustCard/VustCard.d.ts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+export interface VustCardProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** 阴影显示时机 */
+    shadow?: "always" | "hover" | "never";
+    /** 内容区自定义样式 */
+    contentStyle?: React.CSSProperties;
+    /** 默认插槽容器语义 */
+    contentRole?: "content" | "header";
+    /** 内容区是否撑满高度 (用于包含滚动表格的场景) */
+    fullHeight?: boolean;
+    /** 头部内容 */
+    header?: React.ReactNode;
+    /** 子元素，卡片内容 */
+    children?: React.ReactNode;
+}
+export declare const VustCard: React.FC<VustCardProps>;

package/dist/components/VustCheckbox/VustCheckbox.d.ts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+export interface VustCheckboxProps extends Omit<React.LabelHTMLAttributes<HTMLLabelElement>, "onChange" | "id" | "aria-label" | "aria-labelledby" | "aria-describedby"> {
+    /** 绑定值 */
+    checked: boolean;
+    /** 禁用状态 */
+    disabled?: boolean;
+    /** 改变事件 */
+    onChange?: (checked: boolean) => void;
+    indeterminate?: boolean;
+    id?: string;
+    name?: string;
+    ariaLabel?: string;
+    ariaLabelledby?: string;
+    ariaDescribedby?: string;
+}
+export declare const VustCheckbox: React.FC<VustCheckboxProps>;

package/dist/components/VustDateTimeRangePicker/VustDateTimeRangePicker.d.ts

@@ -0,0 +1,44 @@
+import { default as React } from 'react';
+export interface DateTimeRangeValue {
+    startAt: number | null;
+    endAt: number | null;
+}
+export interface ShortcutOption {
+    label: string;
+    value: "15m" | "1h" | "24h" | "7d" | "today";
+}
+export interface VustDateTimeRangePickerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "value" | "onChange"> {
+    /** 绑定的时间范围，使用 Unix epoch milliseconds */
+    value: DateTimeRangeValue;
+    /** 占位文案 */
+    placeholder?: string;
+    /** 起始端标签 */
+    startLabel?: string;
+    /** 结束端标签 */
+    endLabel?: string;
+    /** 快捷范围标题 */
+    shortcutsLabel?: string;
+    /** 日历标题 */
+    calendarLabel?: string;
+    /** 时间标题 */
+    timeLabel?: string;
+    /** 清空按钮文案 */
+    clearLabel?: string;
+    /** 确认按钮文案 */
+    confirmLabel?: string;
+    /** 取消按钮文案 */
+    cancelLabel?: string;
+    /** 当前应用语言 */
+    locale?: string;
+    /** 星期标题，长度为 7 */
+    weekDays?: string[];
+    /** 快捷范围选项 */
+    shortcuts?: ShortcutOption[];
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 改变值时的回调 */
+    onChange?: (value: DateTimeRangeValue) => void;
+    /** 点击确认应用时的回调 */
+    onApply?: (value: DateTimeRangeValue) => void;
+}
+export declare const VustDateTimeRangePicker: React.FC<VustDateTimeRangePickerProps>;

package/dist/components/VustDescriptions/VustDescriptions.d.ts

@@ -0,0 +1,23 @@
+import { default as React } from 'react';
+export interface DescriptionItem {
+    label: string;
+    value?: React.ReactNode;
+    slot?: string;
+    span?: number;
+    render?: (item: DescriptionItem, data?: any) => React.ReactNode;
+}
+export interface VustDescriptionsProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** 标题 */
+    title?: string;
+    /** 列表项配置 */
+    items: DescriptionItem[];
+    /** 原始数据对象 (用于插槽渲染) */
+    data?: Record<string, any>;
+    /** 列数 */
+    column?: number;
+    /** 是否显示边框 */
+    border?: boolean;
+    /** 插槽渲染器，对应 Vue 的 slot */
+    slots?: Record<string, (item: DescriptionItem, data?: any) => React.ReactNode>;
+}
+export declare const VustDescriptions: React.FC<VustDescriptionsProps>;

package/dist/components/VustDialog/VustDialog.d.ts

@@ -0,0 +1,20 @@
+import { default as React } from 'react';
+export interface VustDialogProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** 对话框是否显示 */
+    visible: boolean;
+    /** 对话框标题 */
+    title: string;
+    /** 自定义宽度，支持 px 或百分比，默认值为 500px */
+    width?: string;
+    /** 点击遮罩层是否允许自动关闭对话框，默认为 true */
+    closeOnClickOverlay?: boolean;
+    /** 对话框遮罩层级，默认使用 VDL modal 层级 */
+    zIndex?: number | string;
+    /** 关闭回调 */
+    onClose?: () => void;
+    /** 底部渲染插槽 */
+    footer?: React.ReactNode;
+    /** 对话框内容 */
+    children?: React.ReactNode;
+}
+export declare const VustDialog: React.FC<VustDialogProps>;

package/dist/components/VustDrawer/VustDrawer.d.ts

@@ -0,0 +1,18 @@
+import { default as React } from 'react';
+export interface VustDrawerProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** 抽屉是否显示 */
+    visible: boolean;
+    /** 抽屉标题 */
+    title?: string;
+    /** 自定义宽度，支持 px 或百分比，默认值为 420px */
+    width?: string;
+    /** 点击遮罩层是否允许自动关闭抽屉，默认为 true */
+    closeOnOverlay?: boolean;
+    /** 关闭回调 */
+    onClose?: () => void;
+    /** 底部操作按钮栏 */
+    footer?: React.ReactNode;
+    /** 抽屉主体内容 */
+    children?: React.ReactNode;
+}
+export declare const VustDrawer: React.FC<VustDrawerProps>;

package/dist/components/VustEmpty/VustEmpty.d.ts

@@ -0,0 +1,14 @@
+import { default as React } from 'react';
+export interface VustEmptyProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** 描述文字 */
+    description?: string;
+    /** VDL 图标名称 */
+    icon?: string;
+    /** 自定义图标节点，会覆盖 icon 属性 */
+    iconNode?: React.ReactNode;
+    /** 额外内容 */
+    extra?: React.ReactNode;
+    /** 子元素，将作为 description 渲染 */
+    children?: React.ReactNode;
+}
+export declare const VustEmpty: React.FC<VustEmptyProps>;

package/dist/components/VustFormItem/VustFormItem.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+export interface VustFormItemProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** 标签文本 */
+    label?: string;
+    /** 是否必填 (显示红星) */
+    required?: boolean;
+    /** 提示文本 */
+    hint?: string;
+    htmlFor?: string;
+    error?: string;
+    labelId?: string;
+    hintId?: string;
+    errorId?: string;
+}
+export declare const VustFormItem: React.FC<VustFormItemProps>;

package/dist/components/VustIcon/VustIcon.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+import { IconNamespace } from '@vustcc/icons';
+export interface VustIconProps extends React.HTMLAttributes<HTMLSpanElement> {
+    name?: string | null;
+    namespace?: IconNamespace;
+    size?: number | string;
+    label?: string;
+    decorative?: boolean;
+}
+export declare const VustIcon: React.FC<VustIconProps>;

package/dist/components/VustInput/VustInput.d.ts

@@ -0,0 +1,40 @@
+import { default as React } from 'react';
+export interface VustInputProps<T extends string | number | null = string> extends Omit<React.HTMLAttributes<HTMLDivElement>, "value" | "onChange" | "onFocus" | "onBlur" | "id" | "aria-label" | "aria-labelledby" | "aria-describedby"> {
+    /** 绑定值 */
+    value: T;
+    /** 输入类型 */
+    type?: "text" | "password" | "textarea" | "number" | "datetime-local";
+    /** 占位符 */
+    placeholder?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否只读 */
+    readOnly?: boolean;
+    /** 最大长度 */
+    maxLength?: number;
+    /** 行数 (仅 textarea 有效) */
+    rows?: number;
+    /** 是否显示密码切换按钮 */
+    showPassword?: boolean;
+    /** 最小值 (仅 number 有效) */
+    min?: number | string;
+    /** 最大值 (仅 number 有效) */
+    max?: number | string;
+    /** 步长 (仅 number 有效) */
+    step?: number | string;
+    /** 自动填充属性 */
+    autoComplete?: string;
+    /** 值改变事件 */
+    onChange?: (value: T) => void;
+    invalid?: boolean;
+    id?: string;
+    name?: string;
+    ariaLabel?: string;
+    ariaLabelledby?: string;
+    ariaDescribedby?: string;
+    /** focus 事件 */
+    onFocus?: React.FocusEventHandler<HTMLInputElement | HTMLTextAreaElement>;
+    /** blur 事件 */
+    onBlur?: React.FocusEventHandler<HTMLInputElement | HTMLTextAreaElement>;
+}
+export declare function VustInput<T extends string | number | null = string>({ value, type, placeholder, disabled, readOnly, maxLength, rows, showPassword, min, max, step, autoComplete, onChange, onFocus, onBlur, invalid, id, name, ariaLabel, ariaLabelledby, ariaDescribedby, className, ...rest }: VustInputProps<T>): React.JSX.Element;

package/dist/components/VustLoading/VustLoading.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+export interface VustLoadingProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** 是否显示加载中 */
+    loading: boolean;
+    /** 提示文字 */
+    text?: string;
+    /** 是否覆盖父容器 */
+    cover?: boolean;
+}
+export declare const VustLoading: React.FC<VustLoadingProps>;

package/dist/components/VustMenu/VustMenu.d.ts

@@ -0,0 +1,19 @@
+import { default as React } from 'react';
+export interface MenuItem {
+    key: string;
+    label: string;
+}
+export interface MenuCategory {
+    key: string;
+    label: string;
+    children: MenuItem[];
+}
+export interface VustMenuProps extends Omit<React.HTMLAttributes<HTMLElement>, "onChange" | "onSelect"> {
+    /** 当前选中的菜单项 key */
+    value: string;
+    /** 菜单项列表 (带分组) */
+    items: MenuCategory[];
+    /** 绑定值改变事件 */
+    onChange?: (key: string) => void;
+}
+export declare const VustMenu: React.FC<VustMenuProps>;

package/dist/components/VustModal/VustModal.d.ts

@@ -0,0 +1,20 @@
+import { default as React } from 'react';
+export interface VustModalProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** 是否可见 */
+    visible: boolean;
+    /** 标题 */
+    title: string;
+    /** 消息内容 */
+    message: string;
+    /** 确认按钮文案 */
+    confirmText?: string;
+    /** 取消按钮文案 */
+    cancelText?: string;
+    /** 确认按钮类型 */
+    type?: "primary" | "danger" | "warning";
+    /** 确认回调 */
+    onConfirm?: () => void;
+    /** 取消回调 */
+    onCancel?: () => void;
+}
+export declare const VustModal: React.FC<VustModalProps>;

package/dist/components/VustPagination/VustPagination.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+export interface VustPaginationProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** 当前页码 (从 1 开始) */
+    currentPage: number;
+    /** 总页数 */
+    totalPages: number;
+    /** 最大可见页码数，默认为 5 */
+    maxVisibleButtons?: number;
+    /** 页码改变时的回调 */
+    onPageChange?: (page: number) => void;
+    ariaLabel?: string;
+    previousLabel?: string;
+    nextLabel?: string;
+}
+export declare const VustPagination: React.FC<VustPaginationProps>;

package/dist/components/VustSelect/VustSelect.d.ts

@@ -0,0 +1,33 @@
+import { default as React } from 'react';
+export interface VustSelectOption {
+    value: string | number;
+    label: string;
+    disabled?: boolean;
+    hint?: string;
+}
+export interface VustSelectProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "value" | "onChange" | "id" | "aria-label" | "aria-labelledby" | "aria-describedby"> {
+    /** 绑定值 */
+    value: string | number | null;
+    /** 选项列表 */
+    options: VustSelectOption[];
+    /** 占位符 */
+    placeholder?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    id?: string;
+    name?: string;
+    ariaLabel?: string;
+    ariaLabelledby?: string;
+    ariaDescribedby?: string;
+    /** 改变值时的回调 */
+    onChange?: (value: string | number | null) => void;
+    /** 禁用选项被点击时的回调 */
+    onOptionDisabled?: (option: VustSelectOption) => void;
+    /** 下拉列表滚动时的回调 */
+    onDropdownScroll?: (event: React.UIEvent<HTMLUListElement>) => void;
+    /** 下拉列表滚动到底部附近时的回调 */
+    onDropdownReachBottom?: (event: React.UIEvent<HTMLUListElement>) => void;
+    /** 下拉列表底部内容 */
+    dropdownFooter?: React.ReactNode;
+}
+export declare const VustSelect: React.FC<VustSelectProps>;

package/dist/components/VustSelectionBar/VustSelectionBar.d.ts

@@ -0,0 +1,18 @@
+import { default as React } from 'react';
+export interface VustSelectionBarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "aria-label"> {
+    /** 已选择项目数量。 */
+    count: number;
+    /** 数量前的本地化说明，例如“已选择”。 */
+    label: string;
+    /** 清除选择按钮文案；不传时隐藏按钮。 */
+    clearLabel?: string;
+    /** 是否禁止清除选择。 */
+    clearDisabled?: boolean;
+    /** 选择摘要的无障碍名称。 */
+    ariaLabel?: string;
+    /** 清除选择回调。 */
+    onClear?: () => void;
+    /** 批量操作。 */
+    children?: React.ReactNode;
+}
+export declare const VustSelectionBar: React.FC<VustSelectionBarProps>;

package/dist/components/VustSwitch/VustSwitch.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+export interface VustSwitchProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onChange" | "value"> {
+    value: boolean;
+    onChange?: (value: boolean) => void;
+    activeText?: string;
+    disabled?: boolean;
+}
+export declare const VustSwitch: React.FC<VustSwitchProps>;

package/dist/components/VustTable/VustTable.d.ts

@@ -0,0 +1,59 @@
+import { default as React } from 'react';
+export interface VustTableColumn<T = any> {
+    prop?: string;
+    label: string;
+    width?: string | number;
+    minWidth?: string | number;
+    align?: "left" | "center" | "right";
+    headerAlign?: "left" | "center" | "right";
+    slot?: string;
+    headerSlot?: string;
+    renderCell?: (row: T, column: VustTableColumn<T>, index: number) => React.ReactNode;
+    renderHeader?: (column: VustTableColumn<T>, index: number) => React.ReactNode;
+    fixed?: "left" | "right";
+}
+export interface VustTableProps<T> extends React.HTMLAttributes<HTMLDivElement> {
+    /** 表格数据 */
+    data: T[];
+    /** 列配置 */
+    columns: VustTableColumn<T>[];
+    /** 是否显示全网格边框 */
+    border?: boolean;
+    /** 无数据时显示的占位文案 */
+    emptyText?: string;
+    rowKey?: keyof T | ((row: T) => React.Key);
+    /** 插槽映射 (对应 Vue 中的 scoped slots) */
+    slots?: Record<string, (scope: {
+        row: T;
+        column: VustTableColumn<T>;
+        index: number;
+    }) => React.ReactNode>;
+    /** 表头插槽映射 */
+    headerSlots?: Record<string, (scope: {
+        column: VustTableColumn<T>;
+        index: number;
+    }) => React.ReactNode>;
+    /** 自定义空数据占位 */
+    emptySlot?: React.ReactNode;
+    /** 鼠标悬浮行回调 */
+    onRowMouseEnter?: (row: T, event: React.MouseEvent<HTMLTableRowElement>, index: number) => void;
+    /** 右键行回调 */
+    onRowContextMenu?: (row: T, event: React.MouseEvent<HTMLTableRowElement>, index: number) => void;
+    /** 是否显示内置选择列。 */
+    selectable?: boolean;
+    /** 当前选中的稳定行键。 */
+    selectedRowKeys?: React.Key[];
+    /** 更新受控选择状态。 */
+    onSelectedRowKeysChange?: (keys: React.Key[]) => void;
+    /** 选择状态变化回调。 */
+    onSelectionChange?: (keys: React.Key[]) => void;
+    /** 判断一行是否允许选择。 */
+    rowSelectable?: (row: T, index: number) => boolean;
+    /** 全选复选框的无障碍名称。 */
+    selectAllLabel?: string;
+    /** 行复选框的无障碍名称或计算函数。 */
+    selectRowLabel?: string | ((row: T, index: number) => string);
+    /** 选择列宽度。 */
+    selectionColumnWidth?: number;
+}
+export declare function VustTable<T extends Record<string, any>>({ data, columns, border, emptyText, rowKey, slots, headerSlots, emptySlot, onRowMouseEnter, onRowContextMenu, selectable, selectedRowKeys, onSelectedRowKeysChange, onSelectionChange, rowSelectable, selectAllLabel, selectRowLabel, selectionColumnWidth, className, ...rest }: VustTableProps<T>): React.JSX.Element;

package/dist/components/VustTabs/VustTabs.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+export interface TabItem {
+    label: string;
+    name: string;
+    disabled?: boolean;
+}
+export interface VustTabsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** 当前选中的标签页 name */
+    value: string;
+    /** 标签页列表 */
+    tabs: TabItem[];
+    /** 绑定值改变事件 */
+    onChange?: (name: string) => void;
+}
+export declare const VustTabs: React.FC<VustTabsProps>;

package/dist/components/VustTag/VustTag.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+export interface VustTagProps extends React.HTMLAttributes<HTMLSpanElement> {
+    /** 标签类型 */
+    type?: "primary" | "success" | "warning" | "danger" | "info" | "default";
+    /** 主题风格 */
+    effect?: "light" | "plain" | "dark";
+}
+export declare const VustTag: React.FC<VustTagProps>;