@vavt/react-ui 1.0.0

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

@@ -0,0 +1,50 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+/**
+ * Modal 对话框组件属性接口
+ */
+export interface ModalProps extends Omit<HTMLAttributes<HTMLElement>, 'onChange' | 'title'> {
+    /** 受控模式：弹窗是否处于打开显示状态 */
+    open?: boolean;
+    /** 非受控模式：初始是否打开显示，默认为 false */
+    defaultOpen?: boolean;
+    /** 弹窗头部标题文本或自定义节点 */
+    title?: ReactNode;
+    /** 弹窗宽度（如 520 或 `'520px'`），默认为 520 */
+    width?: number | string;
+    /** 相对视口垂直居中的偏移量（px）；负值向上，正值向下，默认为 -24 */
+    offsetY?: number;
+    /** 是否在视口垂直方向严格居中（忽略 offsetY），默认为 false */
+    center?: boolean;
+    /** 是否展示背景半透明遮罩层，默认为 true */
+    mask?: boolean;
+    /** 点击遮罩层是否触发关闭，默认为 true */
+    closeOnClickOverlay?: boolean;
+    /** 按下 Escape 键是否触发关闭，默认为 true */
+    closeOnPressEscape?: boolean;
+    /** 是否显示右上角关闭图标按钮，默认为 true */
+    showClose?: boolean;
+    /** 弹窗打开期间是否锁定网页 body 滚动，默认为 true */
+    lockScroll?: boolean;
+    /** 关闭后是否销毁子节点 DOM（为 false 时离场后仅隐藏以保活状态），默认为 false */
+    destroyOnClose?: boolean;
+    /** 是否允许按住头部拖拽移动弹窗位置，默认为 true */
+    draggable?: boolean;
+    /** 是否以全屏模态形态展示，默认为 false */
+    fullscreen?: boolean;
+    /** 弹窗 z-index 层级 */
+    zIndex?: number;
+    /** 自定义整个头部区域节点 */
+    header?: ReactNode;
+    /** 自定义底部操作按钮区域节点 */
+    footer?: ReactNode;
+    /** 弹窗打开/关闭状态发生变化时的回调函数 */
+    onChange?: (value: boolean) => void;
+    /** 弹窗打开动画开始时的回调函数 */
+    onOpen?: () => void;
+    /** 触发关闭动作时的回调函数 */
+    onClose?: () => void;
+    /** 离场动画完全结束后触发的回调函数，适合在此释放依赖弹窗 DOM 的外部资源 */
+    onAfterClose?: () => void;
+}
+/** Modal 根 DOM 元素类型 */
+export type ModalRef = HTMLDivElement;

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

@@ -0,0 +1,50 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+/**
+ * Modal 对话框组件属性接口
+ */
+export interface ModalProps extends Omit<HTMLAttributes<HTMLElement>, 'onChange' | 'title'> {
+    /** 受控模式：弹窗是否处于打开显示状态 */
+    open?: boolean;
+    /** 非受控模式：初始是否打开显示，默认为 false */
+    defaultOpen?: boolean;
+    /** 弹窗头部标题文本或自定义节点 */
+    title?: ReactNode;
+    /** 弹窗宽度（如 520 或 `'520px'`），默认为 520 */
+    width?: number | string;
+    /** 相对视口垂直居中的偏移量（px）；负值向上，正值向下，默认为 -24 */
+    offsetY?: number;
+    /** 是否在视口垂直方向严格居中（忽略 offsetY），默认为 false */
+    center?: boolean;
+    /** 是否展示背景半透明遮罩层，默认为 true */
+    mask?: boolean;
+    /** 点击遮罩层是否触发关闭，默认为 true */
+    closeOnClickOverlay?: boolean;
+    /** 按下 Escape 键是否触发关闭，默认为 true */
+    closeOnPressEscape?: boolean;
+    /** 是否显示右上角关闭图标按钮，默认为 true */
+    showClose?: boolean;
+    /** 弹窗打开期间是否锁定网页 body 滚动，默认为 true */
+    lockScroll?: boolean;
+    /** 关闭后是否销毁子节点 DOM（为 false 时离场后仅隐藏以保活状态），默认为 false */
+    destroyOnClose?: boolean;
+    /** 是否允许按住头部拖拽移动弹窗位置，默认为 true */
+    draggable?: boolean;
+    /** 是否以全屏模态形态展示，默认为 false */
+    fullscreen?: boolean;
+    /** 弹窗 z-index 层级 */
+    zIndex?: number;
+    /** 自定义整个头部区域节点 */
+    header?: ReactNode;
+    /** 自定义底部操作按钮区域节点 */
+    footer?: ReactNode;
+    /** 弹窗打开/关闭状态发生变化时的回调函数 */
+    onChange?: (value: boolean) => void;
+    /** 弹窗打开动画开始时的回调函数 */
+    onOpen?: () => void;
+    /** 触发关闭动作时的回调函数 */
+    onClose?: () => void;
+    /** 离场动画完全结束后触发的回调函数，适合在此释放依赖弹窗 DOM 的外部资源 */
+    onAfterClose?: () => void;
+}
+/** Modal 根 DOM 元素类型 */
+export type ModalRef = HTMLDivElement;

package/dist/types/NumberInput/NumberInput.d.cts

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

package/dist/types/NumberInput/NumberInput.d.ts

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

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

@@ -0,0 +1,5 @@
+import NumberInput from './NumberInput.cjs';
+/** NumberInput 数字输入框组件 */
+export declare const VlNumberInput: import("react").ForwardRefExoticComponent<import("./type.cjs").NumberInputProps & import("react").RefAttributes<HTMLInputElement>>;
+export type { NumberInputProps, NumberInputSize, NumberInputRef } from './type.cjs';
+export default NumberInput;

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

@@ -0,0 +1,5 @@
+import NumberInput from './NumberInput.js';
+/** NumberInput 数字输入框组件 */
+export declare const VlNumberInput: import("react").ForwardRefExoticComponent<import("./type.js").NumberInputProps & import("react").RefAttributes<HTMLInputElement>>;
+export type { NumberInputProps, NumberInputSize, NumberInputRef } from './type.js';
+export default NumberInput;

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

@@ -0,0 +1,40 @@
+import type { FocusEvent, InputHTMLAttributes } from 'react';
+/** 数字输入框尺寸：小 (sm) | 中等 (md) | 大 (lg) */
+export type NumberInputSize = 'sm' | 'md' | 'lg';
+/**
+ * NumberInput 组件属性接口
+ */
+export interface NumberInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'value' | 'defaultValue' | 'onChange' | 'onInput'> {
+    /** 受控模式：当前数值（支持 null） */
+    value?: number | null;
+    /** 非受控模式：初始数值（支持 null） */
+    defaultValue?: number | null;
+    /** 允许输入的最小值边界，默认为 -Infinity */
+    min?: number;
+    /** 允许输入的最大值边界，默认为 Infinity */
+    max?: number;
+    /** 每次点击增减按钮或按方向键时变化的步长，默认为 1 */
+    step?: number;
+    /** 保留的小数位数精度 */
+    precision?: number;
+    /** 原生占位提示文案 */
+    placeholder?: string;
+    /** 是否禁用输入框，默认为 false */
+    disabled?: boolean;
+    /** 是否设置为只读状态，默认为 false */
+    readonly?: boolean;
+    /** 是否展示右侧步长调节加减按钮，默认为 true */
+    controls?: boolean;
+    /** 输入框尺寸大小，默认为 `md` */
+    size?: NumberInputSize;
+    /** 移动端虚拟键盘输入模式，默认为 `'decimal'` */
+    inputmode?: 'decimal' | 'numeric';
+    /** 数值变更时的回调函数（返回合法数值或 null） */
+    onChange?: (value: number | null) => void;
+    /** 获得焦点时的回调函数 */
+    onFocus?: (event: FocusEvent<HTMLInputElement>) => void;
+    /** 失去焦点时的回调函数 */
+    onBlur?: (event: FocusEvent<HTMLInputElement>) => void;
+}
+/** NumberInput 根原生 input DOM 元素类型 */
+export type NumberInputRef = HTMLInputElement;

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

@@ -0,0 +1,40 @@
+import type { FocusEvent, InputHTMLAttributes } from 'react';
+/** 数字输入框尺寸：小 (sm) | 中等 (md) | 大 (lg) */
+export type NumberInputSize = 'sm' | 'md' | 'lg';
+/**
+ * NumberInput 组件属性接口
+ */
+export interface NumberInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'value' | 'defaultValue' | 'onChange' | 'onInput'> {
+    /** 受控模式：当前数值（支持 null） */
+    value?: number | null;
+    /** 非受控模式：初始数值（支持 null） */
+    defaultValue?: number | null;
+    /** 允许输入的最小值边界，默认为 -Infinity */
+    min?: number;
+    /** 允许输入的最大值边界，默认为 Infinity */
+    max?: number;
+    /** 每次点击增减按钮或按方向键时变化的步长，默认为 1 */
+    step?: number;
+    /** 保留的小数位数精度 */
+    precision?: number;
+    /** 原生占位提示文案 */
+    placeholder?: string;
+    /** 是否禁用输入框，默认为 false */
+    disabled?: boolean;
+    /** 是否设置为只读状态，默认为 false */
+    readonly?: boolean;
+    /** 是否展示右侧步长调节加减按钮，默认为 true */
+    controls?: boolean;
+    /** 输入框尺寸大小，默认为 `md` */
+    size?: NumberInputSize;
+    /** 移动端虚拟键盘输入模式，默认为 `'decimal'` */
+    inputmode?: 'decimal' | 'numeric';
+    /** 数值变更时的回调函数（返回合法数值或 null） */
+    onChange?: (value: number | null) => void;
+    /** 获得焦点时的回调函数 */
+    onFocus?: (event: FocusEvent<HTMLInputElement>) => void;
+    /** 失去焦点时的回调函数 */
+    onBlur?: (event: FocusEvent<HTMLInputElement>) => void;
+}
+/** NumberInput 根原生 input DOM 元素类型 */
+export type NumberInputRef = HTMLInputElement;

package/dist/types/Pagination/Pagination.d.cts

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

package/dist/types/Pagination/Pagination.d.ts

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

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

@@ -0,0 +1,5 @@
+import Pagination from './Pagination.cjs';
+/** Pagination 分页组件 */
+export declare const VlPagination: import("react").ForwardRefExoticComponent<import("./type.cjs").PaginationProps & import("react").RefAttributes<HTMLElement>>;
+export type { PaginationProps, PaginationRef, PaginationSize, PaginationTotalRenderer } from './type.cjs';
+export default Pagination;

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

@@ -0,0 +1,5 @@
+import Pagination from './Pagination.js';
+/** Pagination 分页组件 */
+export declare const VlPagination: import("react").ForwardRefExoticComponent<import("./type.js").PaginationProps & import("react").RefAttributes<HTMLElement>>;
+export type { PaginationProps, PaginationRef, PaginationSize, PaginationTotalRenderer } from './type.js';
+export default Pagination;

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

@@ -0,0 +1,38 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+/** 分页组件尺寸：小 (sm) | 中等 (md) | 大 (lg) */
+export type PaginationSize = 'sm' | 'md' | 'lg';
+/** 分页总数与范围自定义渲染函数类型 */
+export type PaginationTotalRenderer = (total: number, range: [number, number]) => ReactNode;
+/**
+ * Pagination 组件属性接口
+ */
+export interface PaginationProps extends Omit<HTMLAttributes<HTMLElement>, 'onChange'> {
+    /** 受控模式：当前所在页码 */
+    current?: number;
+    /** 非受控模式：初始所在页码，默认为 1 */
+    defaultCurrent?: number;
+    /** 数据总条数，默认为 0 */
+    total?: number;
+    /** 受控模式：当前每页展示的数据条数 */
+    pageSize?: number;
+    /** 非受控模式：初始每页展示的数据条数，默认为 10 */
+    defaultPageSize?: number;
+    /** 每页条数切换下拉菜单的可选项列表，默认为 `[10, 20, 50, 100]` */
+    pageSizeOptions?: number[];
+    /** 是否显示总数；也可以传入自定义总数和范围渲染器 */
+    showTotal?: boolean | PaginationTotalRenderer;
+    /** 是否显示每页条数切换选择器，默认为 false */
+    showSizeChanger?: boolean;
+    /** 是否显示快速跳页输入框，默认为 false */
+    showQuickJumper?: boolean;
+    /** 控件尺寸大小，默认为 `md` */
+    size?: PaginationSize;
+    /** 是否禁用分页导航交互，默认为 false */
+    disabled?: boolean;
+    /** 当前页码或每页条数发生变化时的回调函数 */
+    onChange?: (current: number, pageSize: number) => void;
+    /** 每页条数发生变化时的独立回调函数 */
+    onPageSizeChange?: (pageSize: number, current: number) => void;
+}
+/** Pagination 根 DOM 元素类型（通常为 `<nav>`） */
+export type PaginationRef = HTMLElement;

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

@@ -0,0 +1,38 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+/** 分页组件尺寸：小 (sm) | 中等 (md) | 大 (lg) */
+export type PaginationSize = 'sm' | 'md' | 'lg';
+/** 分页总数与范围自定义渲染函数类型 */
+export type PaginationTotalRenderer = (total: number, range: [number, number]) => ReactNode;
+/**
+ * Pagination 组件属性接口
+ */
+export interface PaginationProps extends Omit<HTMLAttributes<HTMLElement>, 'onChange'> {
+    /** 受控模式：当前所在页码 */
+    current?: number;
+    /** 非受控模式：初始所在页码，默认为 1 */
+    defaultCurrent?: number;
+    /** 数据总条数，默认为 0 */
+    total?: number;
+    /** 受控模式：当前每页展示的数据条数 */
+    pageSize?: number;
+    /** 非受控模式：初始每页展示的数据条数，默认为 10 */
+    defaultPageSize?: number;
+    /** 每页条数切换下拉菜单的可选项列表，默认为 `[10, 20, 50, 100]` */
+    pageSizeOptions?: number[];
+    /** 是否显示总数；也可以传入自定义总数和范围渲染器 */
+    showTotal?: boolean | PaginationTotalRenderer;
+    /** 是否显示每页条数切换选择器，默认为 false */
+    showSizeChanger?: boolean;
+    /** 是否显示快速跳页输入框，默认为 false */
+    showQuickJumper?: boolean;
+    /** 控件尺寸大小，默认为 `md` */
+    size?: PaginationSize;
+    /** 是否禁用分页导航交互，默认为 false */
+    disabled?: boolean;
+    /** 当前页码或每页条数发生变化时的回调函数 */
+    onChange?: (current: number, pageSize: number) => void;
+    /** 每页条数发生变化时的独立回调函数 */
+    onPageSizeChange?: (pageSize: number, current: number) => void;
+}
+/** Pagination 根 DOM 元素类型（通常为 `<nav>`） */
+export type PaginationRef = HTMLElement;

package/dist/types/Progress/Progress.d.cts

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

package/dist/types/Progress/Progress.d.ts

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

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

@@ -0,0 +1,5 @@
+import Progress from './Progress.cjs';
+/** Progress 进度条组件 */
+export declare const VlProgress: import("react").ForwardRefExoticComponent<import("./type.cjs").ProgressProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { ProgressFormatter, ProgressProps, ProgressRef, ProgressSize, ProgressStatus } from './type.cjs';
+export default Progress;

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

@@ -0,0 +1,5 @@
+import Progress from './Progress.js';
+/** Progress 进度条组件 */
+export declare const VlProgress: import("react").ForwardRefExoticComponent<import("./type.js").ProgressProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { ProgressFormatter, ProgressProps, ProgressRef, ProgressSize, ProgressStatus } from './type.js';
+export default Progress;

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

@@ -0,0 +1,30 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+/** 进度条语义状态：默认/中性 | 主题色 | 成功 | 警告 | 错误 | 信息 */
+export type ProgressStatus = 'default' | 'primary' | 'success' | 'warning' | 'error' | 'info';
+/** 进度条尺寸：小 | 中等 | 大 */
+export type ProgressSize = 'sm' | 'md' | 'lg';
+/** 进度标签格式化函数；value 已被限制在 0..max 范围内。 */
+export type ProgressFormatter = (value: number, max: number) => ReactNode;
+/**
+ * Progress 组件属性接口。
+ *
+ * 进度条是展示型组件，value 采用受控值语义；不提供 defaultValue 或内部递增逻辑。
+ */
+export interface ProgressProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** 当前进度值，默认为 0；最终会被钳制在 0..max 范围内。 */
+    value?: number;
+    /** 进度上限，默认为 100；非有限值或非正数回退到 100。 */
+    max?: number;
+    /** 是否展示无法确定具体百分比的不确定进度动画，默认为 false。 */
+    indeterminate?: boolean;
+    /** 进度条语义状态，默认为 `primary`。 */
+    status?: ProgressStatus;
+    /** 进度条尺寸，默认为 `md`。 */
+    size?: ProgressSize;
+    /** 是否展示进度标签，默认为 false。 */
+    showText?: boolean;
+    /** 自定义进度标签；仅在 showText 为 true 时生效。 */
+    format?: ProgressFormatter;
+}
+/** Progress 根 DOM 容器元素类型 */
+export type ProgressRef = HTMLDivElement;

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

@@ -0,0 +1,30 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+/** 进度条语义状态：默认/中性 | 主题色 | 成功 | 警告 | 错误 | 信息 */
+export type ProgressStatus = 'default' | 'primary' | 'success' | 'warning' | 'error' | 'info';
+/** 进度条尺寸：小 | 中等 | 大 */
+export type ProgressSize = 'sm' | 'md' | 'lg';
+/** 进度标签格式化函数；value 已被限制在 0..max 范围内。 */
+export type ProgressFormatter = (value: number, max: number) => ReactNode;
+/**
+ * Progress 组件属性接口。
+ *
+ * 进度条是展示型组件，value 采用受控值语义；不提供 defaultValue 或内部递增逻辑。
+ */
+export interface ProgressProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** 当前进度值，默认为 0；最终会被钳制在 0..max 范围内。 */
+    value?: number;
+    /** 进度上限，默认为 100；非有限值或非正数回退到 100。 */
+    max?: number;
+    /** 是否展示无法确定具体百分比的不确定进度动画，默认为 false。 */
+    indeterminate?: boolean;
+    /** 进度条语义状态，默认为 `primary`。 */
+    status?: ProgressStatus;
+    /** 进度条尺寸，默认为 `md`。 */
+    size?: ProgressSize;
+    /** 是否展示进度标签，默认为 false。 */
+    showText?: boolean;
+    /** 自定义进度标签；仅在 showText 为 true 时生效。 */
+    format?: ProgressFormatter;
+}
+/** Progress 根 DOM 容器元素类型 */
+export type ProgressRef = HTMLDivElement;

package/dist/types/Radio/Radio.d.cts

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

package/dist/types/Radio/Radio.d.ts

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

package/dist/types/Radio/RadioGroup.d.cts

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

package/dist/types/Radio/RadioGroup.d.ts

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

package/dist/types/Radio/context.d.cts

@@ -0,0 +1,19 @@
+import type { RadioSize, RadioValue } from './type.cjs';
+/** RadioGroup 共享上下文数据接口 */
+export interface RadioGroupContextValue {
+    /** 当前选中的单选值 */
+    value: RadioValue | null;
+    /** 整组是否禁用 */
+    disabled?: boolean;
+    /** 是否使用边框卡片样式 */
+    bordered?: boolean;
+    /** 原生表单 name 字段 */
+    name: string;
+    /** 尺寸大小 */
+    size?: RadioSize;
+    /** 选中特定单选项的方法 */
+    selectValue: (value: RadioValue) => void;
+}
+export declare const RadioGroupProvider: import("react").Provider<RadioGroupContextValue | null>;
+/** 获取 RadioGroup 上下文的 Hook */
+export declare const useRadioGroupContext: () => RadioGroupContextValue | null;

package/dist/types/Radio/context.d.ts

@@ -0,0 +1,19 @@
+import type { RadioSize, RadioValue } from './type.js';
+/** RadioGroup 共享上下文数据接口 */
+export interface RadioGroupContextValue {
+    /** 当前选中的单选值 */
+    value: RadioValue | null;
+    /** 整组是否禁用 */
+    disabled?: boolean;
+    /** 是否使用边框卡片样式 */
+    bordered?: boolean;
+    /** 原生表单 name 字段 */
+    name: string;
+    /** 尺寸大小 */
+    size?: RadioSize;
+    /** 选中特定单选项的方法 */
+    selectValue: (value: RadioValue) => void;
+}
+export declare const RadioGroupProvider: import("react").Provider<RadioGroupContextValue | null>;
+/** 获取 RadioGroup 上下文的 Hook */
+export declare const useRadioGroupContext: () => RadioGroupContextValue | null;

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

@@ -0,0 +1,7 @@
+import Radio from './Radio.cjs';
+/** Radio 单选框组件 */
+export declare const VlRadio: import("react").ForwardRefExoticComponent<import("./type.cjs").RadioProps & import("react").RefAttributes<HTMLInputElement>>;
+/** RadioGroup 单选框组组件 */
+export declare const VlRadioGroup: import("react").ForwardRefExoticComponent<import("./type.cjs").RadioGroupProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { RadioProps, RadioGroupProps, RadioSize, RadioValue, RadioRef, RadioGroupRef } from './type.cjs';
+export default Radio;

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

@@ -0,0 +1,7 @@
+import Radio from './Radio.js';
+/** Radio 单选框组件 */
+export declare const VlRadio: import("react").ForwardRefExoticComponent<import("./type.js").RadioProps & import("react").RefAttributes<HTMLInputElement>>;
+/** RadioGroup 单选框组组件 */
+export declare const VlRadioGroup: import("react").ForwardRefExoticComponent<import("./type.js").RadioGroupProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { RadioProps, RadioGroupProps, RadioSize, RadioValue, RadioRef, RadioGroupRef } from './type.js';
+export default Radio;

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

@@ -0,0 +1,53 @@
+import type { HTMLAttributes, InputHTMLAttributes, ReactNode } from 'react';
+/** 单选框尺寸：小 (sm) | 中等 (md) | 大 (lg) */
+export type RadioSize = 'sm' | 'md' | 'lg';
+/** 单选框绑定的值类型 */
+export type RadioValue = string | number | boolean;
+/** Radio 根原生 input DOM 元素类型 */
+export type RadioRef = HTMLInputElement;
+/** RadioGroup 根 DOM 容器元素类型 */
+export type RadioGroupRef = HTMLDivElement;
+/**
+ * Radio 单体组件属性接口
+ */
+export interface RadioProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'value' | 'defaultValue' | 'checked' | 'defaultChecked' | 'onChange'> {
+    /** 受控模式：当前是否处于选中状态 */
+    checked?: boolean;
+    /** 非受控模式：初始是否处于选中状态，默认为 false */
+    defaultChecked?: boolean;
+    /** 单选框绑定的值（在 RadioGroup 中使用时必填） */
+    value?: RadioValue;
+    /** 单选框标签文本（也可通过 children 传入） */
+    label?: ReactNode;
+    /** 是否禁用交互，默认为 false */
+    disabled?: boolean;
+    /** 是否采用带边框的卡片形态，默认为 false */
+    bordered?: boolean;
+    /** 原生表单 name 字段 */
+    name?: string;
+    /** 控件尺寸大小，默认为 `md` */
+    size?: RadioSize;
+    /** 选中状态发生变化时的回调函数 */
+    onChange?: (value: RadioValue | undefined, checked: boolean) => void;
+}
+/**
+ * RadioGroup 单选框组属性接口
+ */
+export interface RadioGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, 'defaultValue' | 'onChange'> {
+    /** 受控模式：当前选中的单选值 */
+    value?: RadioValue | null;
+    /** 非受控模式：初始选中的单选值 */
+    defaultValue?: RadioValue | null;
+    /** 是否禁用整组所有单选框，默认为 false */
+    disabled?: boolean;
+    /** 整组是否采用带边框卡片样式，默认为 false */
+    bordered?: boolean;
+    /** 整组下属单选框统一的原生表单 name 字段 */
+    name?: string;
+    /** 整组统一尺寸大小，默认为 `md` */
+    size?: RadioSize;
+    /** 子节点列表（通常为一组 Radio） */
+    children?: ReactNode;
+    /** 选中值发生变更时的回调函数 */
+    onChange?: (value: RadioValue) => void;
+}

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

@@ -0,0 +1,53 @@
+import type { HTMLAttributes, InputHTMLAttributes, ReactNode } from 'react';
+/** 单选框尺寸：小 (sm) | 中等 (md) | 大 (lg) */
+export type RadioSize = 'sm' | 'md' | 'lg';
+/** 单选框绑定的值类型 */
+export type RadioValue = string | number | boolean;
+/** Radio 根原生 input DOM 元素类型 */
+export type RadioRef = HTMLInputElement;
+/** RadioGroup 根 DOM 容器元素类型 */
+export type RadioGroupRef = HTMLDivElement;
+/**
+ * Radio 单体组件属性接口
+ */
+export interface RadioProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'value' | 'defaultValue' | 'checked' | 'defaultChecked' | 'onChange'> {
+    /** 受控模式：当前是否处于选中状态 */
+    checked?: boolean;
+    /** 非受控模式：初始是否处于选中状态，默认为 false */
+    defaultChecked?: boolean;
+    /** 单选框绑定的值（在 RadioGroup 中使用时必填） */
+    value?: RadioValue;
+    /** 单选框标签文本（也可通过 children 传入） */
+    label?: ReactNode;
+    /** 是否禁用交互，默认为 false */
+    disabled?: boolean;
+    /** 是否采用带边框的卡片形态，默认为 false */
+    bordered?: boolean;
+    /** 原生表单 name 字段 */
+    name?: string;
+    /** 控件尺寸大小，默认为 `md` */
+    size?: RadioSize;
+    /** 选中状态发生变化时的回调函数 */
+    onChange?: (value: RadioValue | undefined, checked: boolean) => void;
+}
+/**
+ * RadioGroup 单选框组属性接口
+ */
+export interface RadioGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, 'defaultValue' | 'onChange'> {
+    /** 受控模式：当前选中的单选值 */
+    value?: RadioValue | null;
+    /** 非受控模式：初始选中的单选值 */
+    defaultValue?: RadioValue | null;
+    /** 是否禁用整组所有单选框，默认为 false */
+    disabled?: boolean;
+    /** 整组是否采用带边框卡片样式，默认为 false */
+    bordered?: boolean;
+    /** 整组下属单选框统一的原生表单 name 字段 */
+    name?: string;
+    /** 整组统一尺寸大小，默认为 `md` */
+    size?: RadioSize;
+    /** 子节点列表（通常为一组 Radio） */
+    children?: ReactNode;
+    /** 选中值发生变更时的回调函数 */
+    onChange?: (value: RadioValue) => void;
+}

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

@@ -0,0 +1,8 @@
+import type { RowProps } from './type.cjs';
+/** Row 向子级 Col 传递的间距 Context 数据类型 */
+export type RowContextValue = {
+    gutter: number;
+};
+export declare const RowContext: import("react").Context<RowContextValue>;
+declare const Row: import("react").ForwardRefExoticComponent<RowProps & import("react").RefAttributes<HTMLElement>>;
+export default Row;

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

@@ -0,0 +1,8 @@
+import type { RowProps } from './type.js';
+/** Row 向子级 Col 传递的间距 Context 数据类型 */
+export type RowContextValue = {
+    gutter: number;
+};
+export declare const RowContext: import("react").Context<RowContextValue>;
+declare const Row: import("react").ForwardRefExoticComponent<RowProps & import("react").RefAttributes<HTMLElement>>;
+export default Row;

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

@@ -0,0 +1,5 @@
+import Row from './Row.cjs';
+/** Row 栅格行组件 */
+export declare const VlRow: import("react").ForwardRefExoticComponent<import("./type.cjs").RowProps & import("react").RefAttributes<HTMLElement>>;
+export type { RowProps, RowJustify, RowAlign, RowRef } from './type.cjs';
+export default Row;

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

@@ -0,0 +1,5 @@
+import Row from './Row.js';
+/** Row 栅格行组件 */
+export declare const VlRow: import("react").ForwardRefExoticComponent<import("./type.js").RowProps & import("react").RefAttributes<HTMLElement>>;
+export type { RowProps, RowJustify, RowAlign, RowRef } from './type.js';
+export default Row;