@vavt/react-ui 1.0.0

package/dist/types/Cron/expression.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Cron 表达式的方言规格、解析、展开与序列化。
+ *
+ * 设计约束：
+ * 1. 一个字段文本可能是逗号分隔的多个段（如 `0-10,20,30-40/2`）。求值和描述只关心「展开后的值集合」，
+ *    因此 expandField 始终按段解析，与编辑器能否用单一类型表达无关；
+ * 2. 编辑器需要「类型 + 参数」的结构化状态，但并非所有合法字段都能被单一类型表达。无法表达时落为
+ *    `custom` 并保留原文，保证粘贴进来的表达式不会被编辑器悄悄改写；
+ * 3. Unix 与 Quartz 的差异集中在 FIELD_SPECS 与 modeFields 两处，其余逻辑共享，避免方言判断散落各处。
+ */
+/** Cron 表达式方言：标准 Unix 五段 | Quartz 六/七段 */
+export type CronMode = 'unix' | 'quartz';
+/** Cron 字段名 */
+export type CronFieldName = 'second' | 'minute' | 'hour' | 'dayOfMonth' | 'month' | 'dayOfWeek' | 'year';
+/** 字段编辑器的取值类型 */
+export type CronFieldKind = 'every' | 'unspecified' | 'range' | 'step' | 'list' | 'last' | 'weekday' | 'nth' | 'custom';
+/** 字段编辑器的结构化取值 */
+export type CronFieldValue = 
+/** `*` 每一个值 */
+{
+    kind: 'every';
+}
+/** `?` 不指定（仅 Quartz 的日、周字段） */
+ | {
+    kind: 'unspecified';
+}
+/** `a-b` 连续区间 */
+ | {
+    kind: 'range';
+    from: number;
+    to: number;
+}
+/** `a-b/n` 每 n 个单位；起止为 null 时取字段边界，即 `a/n` 与 `星号/n` */
+ | {
+    kind: 'step';
+    from: number | null;
+    to: number | null;
+    step: number;
+}
+/** `a,b,c` 枚举 */
+ | {
+    kind: 'list';
+    values: number[];
+}
+/** `L` 本月最后一天 / `L-n` 最后一天前 n 天 / `LW` 最后一个工作日 / `nL` 本月最后一个周 n */
+ | {
+    kind: 'last';
+    offset: number;
+    weekday: boolean;
+    dayOfWeek: number | null;
+}
+/** `nW` 离 n 号最近的工作日 */
+ | {
+    kind: 'weekday';
+    day: number;
+}
+/** `n#m` 本月第 m 个周 n */
+ | {
+    kind: 'nth';
+    dayOfWeek: number;
+    nth: number;
+}
+/** 编辑器无法用单一类型表达的合法字段，保留原文 */
+ | {
+    kind: 'custom';
+    text: string;
+};
+/** 单个字段的方言规格 */
+export type CronFieldSpec = {
+    name: CronFieldName;
+    /** 中文字段名 */
+    label: string;
+    /** 允许的最小值 */
+    min: number;
+    /** 允许的最大值 */
+    max: number;
+    /** 文本别名到数值的映射（如 JAN=1、MON=2） */
+    aliases?: Record<string, number>;
+    /** 是否允许 `?` */
+    allowUnspecified?: boolean;
+    /** 是否允许 `L` 系列写法 */
+    allowLast?: boolean;
+    /** 是否允许 `nW` */
+    allowWeekday?: boolean;
+    /** 是否允许 `n#m` */
+    allowNth?: boolean;
+    /** 解析时允许但会被归一化的额外取值（Unix 周字段的 7 等价于 0） */
+    wrap?: {
+        from: number;
+        to: number;
+    };
+};
+/** 各方言的字段规格表。方言差异只在这里声明。 */
+export declare const FIELD_SPECS: Record<CronMode, Record<CronFieldName, CronFieldSpec | undefined>>;
+/** 按方言与是否包含年字段返回字段顺序。 */
+export declare const modeFields: (mode: CronMode, withYear?: boolean) => CronFieldName[];
+/** 取字段规格；方言不支持该字段时抛错，避免调用方静默拿到 undefined。 */
+export declare const getFieldSpec: (mode: CronMode, field: CronFieldName) => CronFieldSpec;
+/** 星期数值到中文名的映射，按字段规格的最小值推导方言偏移。 */
+export declare const weekdayLabel: (value: number, spec: CronFieldSpec) => string;
+/** 月份数值到中文名。 */
+export declare const monthLabel: (value: number) => string;
+/** 字段解析失败时抛出，携带字段名以便面板把错误定位到具体 Tab。 */
+export declare class CronFieldError extends Error {
+    readonly field: CronFieldName;
+    constructor(field: CronFieldName, message: string);
+}
+/** `L` 系列与 `W`、`#` 只能作为整段出现，展开时单独记录，不进入数值集合。 */
+export type CronDayRule = 
+/** `L-n`：本月最后一天前 n 天（n 为 0 表示最后一天） */
+{
+    type: 'lastDayOfMonth';
+    offset: number;
+}
+/** `LW`：本月最后一个工作日 */
+ | {
+    type: 'lastWeekdayOfMonth';
+}
+/** `nW`：离 n 号最近的工作日 */
+ | {
+    type: 'nearestWeekday';
+    day: number;
+}
+/** `nL`：本月最后一个周 n */
+ | {
+    type: 'lastDayOfWeek';
+    dayOfWeek: number;
+}
+/** `n#m`：本月第 m 个周 n */
+ | {
+    type: 'nthDayOfWeek';
+    dayOfWeek: number;
+    nth: number;
+};
+/** 字段展开结果：数值集合 + 特殊日规则 + 是否为 `*` / `?`。 */
+export type CronFieldMatch = {
+    /** 命中的数值集合，已升序去重。特殊规则不写入这里。 */
+    values: number[];
+    /** `L` / `W` / `#` 规则 */
+    rules: CronDayRule[];
+    /** 是否为 `*`（不限定） */
+    wildcard: boolean;
+    /** 是否为 `?`（不指定） */
+    unspecified: boolean;
+};
+/** 把字段文本展开为可用于求值的匹配集合。 */
+export declare const expandField: (text: string, spec: CronFieldSpec) => CronFieldMatch;
+/** 全部字段名，与求值顺序一致（由粗到细便于逐层收敛）。 */
+export declare const ALL_FIELDS: CronFieldName[];
+/** 各字段原文。方言不含的字段补等价默认值：Unix 无秒字段即固定在 0 秒触发。 */
+export type CronFields = Record<CronFieldName, string>;
+/** 解析成功的表达式：原文 + 展开结果，求值与描述都只依赖它。 */
+export type CronParsed = {
+    mode: CronMode;
+    /** 表达式是否显式包含年字段 */
+    hasYear: boolean;
+    fields: CronFields;
+    matches: Record<CronFieldName, CronFieldMatch>;
+};
+/** 解析结果。失败时带上字段名，面板据此把错误定位到具体 Tab。 */
+export type CronParseResult = {
+    ok: true;
+    value: CronParsed;
+} | {
+    ok: false;
+    message: string;
+    field?: CronFieldName;
+};
+/** 字段是否限定了取值：`*` 与 `?` 都不算限定。 */
+export declare const isRestricted: (match: CronFieldMatch) => boolean;
+/**
+ * 解析表达式。
+ *
+ * 宽容之处：Quartz 的日/周只要有一个不限定就放行（`0 0 12 * * *` 这类粘贴进来的写法照常工作）；
+ * 严格之处：两者同时为 `?` 或同时被限定都会报错——前者没有任何日期可命中，后者在 Quartz 里行为未定义。
+ */
+export declare const parseCron: (expression: string, mode: CronMode) => CronParseResult;
+/** 按方言的字段顺序拼回表达式。 */
+export declare const stringifyCron: (fields: CronFields, mode: CronMode, hasYear?: boolean) => string;
+/** 方言的默认表达式：Unix 每分钟，Quartz 每分钟的第 0 秒。 */
+export declare const defaultExpression: (mode: CronMode, hasYear?: boolean) => string;
+/**
+ * 字段原文转编辑器状态。无法用单一类型表达时落为 `custom` 保留原文，
+ * 避免打开面板就把用户的 `0-10,20,30-40/2` 改写成别的东西。
+ */
+export declare const fieldToEditor: (text: string, spec: CronFieldSpec) => CronFieldValue;
+/** 编辑器状态转字段原文。 */
+export declare const editorToField: (value: CronFieldValue, spec: CronFieldSpec) => string;

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

@@ -0,0 +1,5 @@
+import Cron from './Cron.cjs';
+/** Cron 表达式编辑组件 */
+export declare const VlCron: import("react").ForwardRefExoticComponent<import("./type.cjs").CronProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { CronProps, CronMode, CronSize, CronPlacement, CronValue, CronShortcut, CronFieldName, CronRef } from './type.cjs';
+export default Cron;

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

@@ -0,0 +1,5 @@
+import Cron from './Cron.js';
+/** Cron 表达式编辑组件 */
+export declare const VlCron: import("react").ForwardRefExoticComponent<import("./type.js").CronProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { CronProps, CronMode, CronSize, CronPlacement, CronValue, CronShortcut, CronFieldName, CronRef } from './type.js';
+export default Cron;

package/dist/types/Cron/schedule.d.cts

@@ -0,0 +1,15 @@
+/**
+ * Cron 求值器：按本地时区计算下一批触发时间。
+ *
+ * 实现思路是「逐层收敛」而不是逐秒试探：从年往下依次把不匹配的层进位并把更细的层清零，
+ * 命中时才下推一层。这样 `0 0 0 1 1 ?`（每年 1 月 1 日）这类稀疏表达式也是常数级步数。
+ */
+import type { CronParsed } from './expression.cjs';
+/**
+ * 计算严格晚于 from 的下一次触发时间；无解返回 null。
+ */
+export declare const nextDate: (parsed: CronParsed, from: Date) => Date | null;
+/** 连续取 count 个触发时间；提前无解就返回已有的部分。 */
+export declare const nextDates: (parsed: CronParsed, count: number, from?: Date) => Date[];
+/** `YYYY-MM-DD HH:mm:ss`，本地时区。 */
+export declare const formatDate: (date: Date) => string;

package/dist/types/Cron/schedule.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Cron 求值器：按本地时区计算下一批触发时间。
+ *
+ * 实现思路是「逐层收敛」而不是逐秒试探：从年往下依次把不匹配的层进位并把更细的层清零，
+ * 命中时才下推一层。这样 `0 0 0 1 1 ?`（每年 1 月 1 日）这类稀疏表达式也是常数级步数。
+ */
+import type { CronParsed } from './expression.js';
+/**
+ * 计算严格晚于 from 的下一次触发时间；无解返回 null。
+ */
+export declare const nextDate: (parsed: CronParsed, from: Date) => Date | null;
+/** 连续取 count 个触发时间；提前无解就返回已有的部分。 */
+export declare const nextDates: (parsed: CronParsed, count: number, from?: Date) => Date[];
+/** `YYYY-MM-DD HH:mm:ss`，本地时区。 */
+export declare const formatDate: (date: Date) => string;

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

@@ -0,0 +1,65 @@
+import type { HTMLAttributes } from 'react';
+import type { CronFieldName, CronMode } from './expression.cjs';
+export type { CronFieldName, CronMode };
+/** Cron 编辑器尺寸大小：小 (sm) | 中等 (md) | 大 (lg) */
+export type CronSize = 'sm' | 'md' | 'lg';
+/** 下拉浮层弹出方向 */
+export type CronPlacement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
+/** Cron 表达式字符串类型 */
+export type CronValue = string;
+/** Cron 快捷预设项定义 */
+export interface CronShortcut {
+    /** 快捷项展示文案 */
+    label: string;
+    /** 对应的 Cron 表达式，需与当前 mode 的段数一致 */
+    value: string;
+}
+/**
+ * Cron 组件属性接口
+ */
+export interface CronProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'onInvalid' | 'defaultValue'> {
+    /** 受控模式：当前 Cron 表达式 */
+    value?: string | null;
+    /** 非受控模式：初始 Cron 表达式 */
+    defaultValue?: string | null;
+    /** 表达式方言，`unix` 为五段（分 时 日 月 周），`quartz` 为六段（含秒），默认为 `quartz` */
+    mode?: CronMode;
+    /** 是否启用年字段（仅 Quartz），默认为 false；传入的七段表达式会自动启用 */
+    withYear?: boolean;
+    /** 是否直接渲染编辑面板而不使用浮层，默认为 false */
+    inline?: boolean;
+    /** 输入框占位提示文案，默认为 `'请选择执行周期'` */
+    placeholder?: string;
+    /** 是否禁用编辑器，默认为 false */
+    disabled?: boolean;
+    /** 是否只读，只读时仍可展开面板查看，但不能修改表达式，默认为 false */
+    readonly?: boolean;
+    /** 是否支持一键清空表达式，默认为 false */
+    clearable?: boolean;
+    /** 控件尺寸大小，默认为 `md` */
+    size?: CronSize;
+    /** 下拉面板弹出方向，默认为 `bottom-start` */
+    placement?: CronPlacement;
+    /** 下拉面板与输入框之间的垂直间距偏移量（px），默认为 8 */
+    offset?: number;
+    /** 快捷预设选项列表 */
+    shortcuts?: CronShortcut[];
+    /** 是否展示中文语义说明，默认为 true */
+    showDescription?: boolean;
+    /** 是否展示最近执行时间预览，默认为 true */
+    showPreview?: boolean;
+    /** 预览的执行次数，默认为 5 */
+    previewCount?: number;
+    /** 表达式变更时的回调函数，仅在表达式合法时触发 */
+    onChange?: (value: string | null) => void;
+    /** 手动输入的表达式非法时的回调函数 */
+    onInvalid?: (expression: string, message: string) => void;
+    /** 点击清空按钮时的回调函数 */
+    onClear?: () => void;
+    /** 下拉面板打开时的回调函数 */
+    onOpen?: () => void;
+    /** 下拉面板关闭时的回调函数 */
+    onClose?: () => void;
+}
+/** Cron 根 DOM 元素类型 */
+export type CronRef = HTMLDivElement;

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

@@ -0,0 +1,65 @@
+import type { HTMLAttributes } from 'react';
+import type { CronFieldName, CronMode } from './expression.js';
+export type { CronFieldName, CronMode };
+/** Cron 编辑器尺寸大小：小 (sm) | 中等 (md) | 大 (lg) */
+export type CronSize = 'sm' | 'md' | 'lg';
+/** 下拉浮层弹出方向 */
+export type CronPlacement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
+/** Cron 表达式字符串类型 */
+export type CronValue = string;
+/** Cron 快捷预设项定义 */
+export interface CronShortcut {
+    /** 快捷项展示文案 */
+    label: string;
+    /** 对应的 Cron 表达式，需与当前 mode 的段数一致 */
+    value: string;
+}
+/**
+ * Cron 组件属性接口
+ */
+export interface CronProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'onInvalid' | 'defaultValue'> {
+    /** 受控模式：当前 Cron 表达式 */
+    value?: string | null;
+    /** 非受控模式：初始 Cron 表达式 */
+    defaultValue?: string | null;
+    /** 表达式方言，`unix` 为五段（分 时 日 月 周），`quartz` 为六段（含秒），默认为 `quartz` */
+    mode?: CronMode;
+    /** 是否启用年字段（仅 Quartz），默认为 false；传入的七段表达式会自动启用 */
+    withYear?: boolean;
+    /** 是否直接渲染编辑面板而不使用浮层，默认为 false */
+    inline?: boolean;
+    /** 输入框占位提示文案，默认为 `'请选择执行周期'` */
+    placeholder?: string;
+    /** 是否禁用编辑器，默认为 false */
+    disabled?: boolean;
+    /** 是否只读，只读时仍可展开面板查看，但不能修改表达式，默认为 false */
+    readonly?: boolean;
+    /** 是否支持一键清空表达式，默认为 false */
+    clearable?: boolean;
+    /** 控件尺寸大小，默认为 `md` */
+    size?: CronSize;
+    /** 下拉面板弹出方向，默认为 `bottom-start` */
+    placement?: CronPlacement;
+    /** 下拉面板与输入框之间的垂直间距偏移量（px），默认为 8 */
+    offset?: number;
+    /** 快捷预设选项列表 */
+    shortcuts?: CronShortcut[];
+    /** 是否展示中文语义说明，默认为 true */
+    showDescription?: boolean;
+    /** 是否展示最近执行时间预览，默认为 true */
+    showPreview?: boolean;
+    /** 预览的执行次数，默认为 5 */
+    previewCount?: number;
+    /** 表达式变更时的回调函数，仅在表达式合法时触发 */
+    onChange?: (value: string | null) => void;
+    /** 手动输入的表达式非法时的回调函数 */
+    onInvalid?: (expression: string, message: string) => void;
+    /** 点击清空按钮时的回调函数 */
+    onClear?: () => void;
+    /** 下拉面板打开时的回调函数 */
+    onOpen?: () => void;
+    /** 下拉面板关闭时的回调函数 */
+    onClose?: () => void;
+}
+/** Cron 根 DOM 元素类型 */
+export type CronRef = HTMLDivElement;

package/dist/types/DatePicker/DatePicker.d.cts

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

package/dist/types/DatePicker/DatePicker.d.ts

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

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

@@ -0,0 +1,5 @@
+import DatePicker from './DatePicker.cjs';
+/** DatePicker 日期选择器组件 */
+export declare const VlDatePicker: import("react").ForwardRefExoticComponent<import("./type.cjs").DatePickerProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { DatePickerProps, DatePickerBaseProps, DatePickerSize, DatePickerPlacement, DatePickerValueType, DatePickerDateValue, DatePickerRangeValue, DatePickerValue, DatePickerShortcut, DatePickerDateProps, DatePickerStringProps, DatePickerDateRangeProps, DatePickerStringRangeProps, DatePickerRef } from './type.cjs';
+export default DatePicker;

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

@@ -0,0 +1,5 @@
+import DatePicker from './DatePicker.js';
+/** DatePicker 日期选择器组件 */
+export declare const VlDatePicker: import("react").ForwardRefExoticComponent<import("./type.js").DatePickerProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { DatePickerProps, DatePickerBaseProps, DatePickerSize, DatePickerPlacement, DatePickerValueType, DatePickerDateValue, DatePickerRangeValue, DatePickerValue, DatePickerShortcut, DatePickerDateProps, DatePickerStringProps, DatePickerDateRangeProps, DatePickerStringRangeProps, DatePickerRef } from './type.js';
+export default DatePicker;

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

@@ -0,0 +1,89 @@
+import type { HTMLAttributes } from 'react';
+/** 日期选择器尺寸大小：小 (sm) | 中等 (md) | 大 (lg) */
+export type DatePickerSize = 'sm' | 'md' | 'lg';
+/** 浮层弹窗对齐方向 */
+export type DatePickerPlacement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
+/** 绑定值类型：Date 实例 (`date`) 或格式化字符串 (`string`) */
+export type DatePickerValueType = 'date' | 'string';
+/** 单个日期数值类型 */
+export type DatePickerDateValue = Date | string;
+/** 日期范围数值元组类型 */
+export type DatePickerRangeValue = [DatePickerDateValue, DatePickerDateValue];
+/** 日期选择器支持的值类型联合 */
+export type DatePickerValue = DatePickerDateValue | DatePickerRangeValue | null;
+/** 快捷预设选项定义 */
+export interface DatePickerShortcut<TValue = DatePickerDateValue | DatePickerRangeValue> {
+    /** 快捷项展示文案 */
+    label: string;
+    /** 点击时根据当前时间计算出的目标值 */
+    getValue: (now: Date) => TValue | null;
+}
+/** DatePicker 基础属性接口 */
+export interface DatePickerBaseProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
+    /** 日期格式化模版，默认为 `YYYY-MM-DD` */
+    format?: string;
+    /** 允许选择的最小日期边界 */
+    minDate?: DatePickerDateValue;
+    /** 允许选择的最大日期边界 */
+    maxDate?: DatePickerDateValue;
+    /** 自定义判断特定日期是否禁用的函数 */
+    disabledDate?: (date: Date) => boolean;
+    /** 输入框占位文案 */
+    placeholder?: string;
+    /** 是否禁用选择器，默认为 false */
+    disabled?: boolean;
+    /** 是否支持一键清空选中值，默认为 false */
+    clearable?: boolean;
+    /** 控件尺寸大小，默认为 `md` */
+    size?: DatePickerSize;
+    /** 浮层弹出方向，默认为 `bottom-start` */
+    placement?: DatePickerPlacement;
+    /** 浮层与输入框之间的纵向偏移距离（px），默认为 4 */
+    offset?: number;
+    /** 清空内容时的回调函数 */
+    onClear?: () => void;
+    /** 下拉面板打开时的回调函数 */
+    onOpen?: () => void;
+    /** 下拉面板关闭时的回调函数 */
+    onClose?: () => void;
+}
+/** 单日选择模式（返回 Date 对象）属性接口 */
+export interface DatePickerDateProps extends DatePickerBaseProps {
+    range?: false;
+    valueType?: 'date';
+    value?: Date | null;
+    defaultValue?: Date | null;
+    shortcuts?: DatePickerShortcut<Date>[];
+    onChange?: (value: Date | null) => void;
+}
+/** 单日选择模式（返回格式化字符串）属性接口 */
+export interface DatePickerStringProps extends DatePickerBaseProps {
+    range?: false;
+    valueType: 'string';
+    value?: string | null;
+    defaultValue?: string | null;
+    shortcuts?: DatePickerShortcut<string>[];
+    onChange?: (value: string | null) => void;
+}
+/** 日期范围选择模式（返回 Date 元组）属性接口 */
+export interface DatePickerDateRangeProps extends DatePickerBaseProps {
+    range: true;
+    valueType?: 'date';
+    value?: [Date, Date] | null;
+    defaultValue?: [Date, Date] | null;
+    shortcuts?: DatePickerShortcut<[Date, Date]>[];
+    onChange?: (value: [Date, Date] | null) => void;
+}
+/** 日期范围选择模式（返回格式化字符串元组）属性接口 */
+export interface DatePickerStringRangeProps extends DatePickerBaseProps {
+    range: true;
+    valueType: 'string';
+    value?: [string, string] | null;
+    defaultValue?: [string, string] | null;
+    shortcuts?: DatePickerShortcut<[string, string]>[];
+    onChange?: (value: [string, string] | null) => void;
+}
+/** DatePicker 组件属性联合类型 */
+export type DatePickerProps = DatePickerDateProps | DatePickerStringProps | DatePickerDateRangeProps | DatePickerStringRangeProps;
+/** DatePicker 根 DOM 元素类型 */
+export type DatePickerRef = HTMLDivElement;

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

@@ -0,0 +1,89 @@
+import type { HTMLAttributes } from 'react';
+/** 日期选择器尺寸大小：小 (sm) | 中等 (md) | 大 (lg) */
+export type DatePickerSize = 'sm' | 'md' | 'lg';
+/** 浮层弹窗对齐方向 */
+export type DatePickerPlacement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
+/** 绑定值类型：Date 实例 (`date`) 或格式化字符串 (`string`) */
+export type DatePickerValueType = 'date' | 'string';
+/** 单个日期数值类型 */
+export type DatePickerDateValue = Date | string;
+/** 日期范围数值元组类型 */
+export type DatePickerRangeValue = [DatePickerDateValue, DatePickerDateValue];
+/** 日期选择器支持的值类型联合 */
+export type DatePickerValue = DatePickerDateValue | DatePickerRangeValue | null;
+/** 快捷预设选项定义 */
+export interface DatePickerShortcut<TValue = DatePickerDateValue | DatePickerRangeValue> {
+    /** 快捷项展示文案 */
+    label: string;
+    /** 点击时根据当前时间计算出的目标值 */
+    getValue: (now: Date) => TValue | null;
+}
+/** DatePicker 基础属性接口 */
+export interface DatePickerBaseProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
+    /** 日期格式化模版，默认为 `YYYY-MM-DD` */
+    format?: string;
+    /** 允许选择的最小日期边界 */
+    minDate?: DatePickerDateValue;
+    /** 允许选择的最大日期边界 */
+    maxDate?: DatePickerDateValue;
+    /** 自定义判断特定日期是否禁用的函数 */
+    disabledDate?: (date: Date) => boolean;
+    /** 输入框占位文案 */
+    placeholder?: string;
+    /** 是否禁用选择器，默认为 false */
+    disabled?: boolean;
+    /** 是否支持一键清空选中值，默认为 false */
+    clearable?: boolean;
+    /** 控件尺寸大小，默认为 `md` */
+    size?: DatePickerSize;
+    /** 浮层弹出方向，默认为 `bottom-start` */
+    placement?: DatePickerPlacement;
+    /** 浮层与输入框之间的纵向偏移距离（px），默认为 4 */
+    offset?: number;
+    /** 清空内容时的回调函数 */
+    onClear?: () => void;
+    /** 下拉面板打开时的回调函数 */
+    onOpen?: () => void;
+    /** 下拉面板关闭时的回调函数 */
+    onClose?: () => void;
+}
+/** 单日选择模式（返回 Date 对象）属性接口 */
+export interface DatePickerDateProps extends DatePickerBaseProps {
+    range?: false;
+    valueType?: 'date';
+    value?: Date | null;
+    defaultValue?: Date | null;
+    shortcuts?: DatePickerShortcut<Date>[];
+    onChange?: (value: Date | null) => void;
+}
+/** 单日选择模式（返回格式化字符串）属性接口 */
+export interface DatePickerStringProps extends DatePickerBaseProps {
+    range?: false;
+    valueType: 'string';
+    value?: string | null;
+    defaultValue?: string | null;
+    shortcuts?: DatePickerShortcut<string>[];
+    onChange?: (value: string | null) => void;
+}
+/** 日期范围选择模式（返回 Date 元组）属性接口 */
+export interface DatePickerDateRangeProps extends DatePickerBaseProps {
+    range: true;
+    valueType?: 'date';
+    value?: [Date, Date] | null;
+    defaultValue?: [Date, Date] | null;
+    shortcuts?: DatePickerShortcut<[Date, Date]>[];
+    onChange?: (value: [Date, Date] | null) => void;
+}
+/** 日期范围选择模式（返回格式化字符串元组）属性接口 */
+export interface DatePickerStringRangeProps extends DatePickerBaseProps {
+    range: true;
+    valueType: 'string';
+    value?: [string, string] | null;
+    defaultValue?: [string, string] | null;
+    shortcuts?: DatePickerShortcut<[string, string]>[];
+    onChange?: (value: [string, string] | null) => void;
+}
+/** DatePicker 组件属性联合类型 */
+export type DatePickerProps = DatePickerDateProps | DatePickerStringProps | DatePickerDateRangeProps | DatePickerStringRangeProps;
+/** DatePicker 根 DOM 元素类型 */
+export type DatePickerRef = HTMLDivElement;

package/dist/types/DateTimePicker/DateTimePicker.d.cts

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

package/dist/types/DateTimePicker/DateTimePicker.d.ts

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

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

@@ -0,0 +1,5 @@
+import DateTimePicker from './DateTimePicker.cjs';
+/** DateTimePicker 日期时间选择器组件 */
+export declare const VlDateTimePicker: import("react").ForwardRefExoticComponent<import("./type.cjs").DateTimePickerProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { DateTimePickerProps, DateTimePickerBaseProps, DateTimePickerSize, DateTimePickerPlacement, DateTimePickerValueType, DateTimePickerDateValue, DateTimePickerRangeValue, DateTimePickerValue, DateTimePickerShortcut, DateTimePickerDateProps, DateTimePickerStringProps, DateTimePickerDateRangeProps, DateTimePickerStringRangeProps, DateTimePickerRef } from './type.cjs';
+export default DateTimePicker;

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

@@ -0,0 +1,5 @@
+import DateTimePicker from './DateTimePicker.js';
+/** DateTimePicker 日期时间选择器组件 */
+export declare const VlDateTimePicker: import("react").ForwardRefExoticComponent<import("./type.js").DateTimePickerProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { DateTimePickerProps, DateTimePickerBaseProps, DateTimePickerSize, DateTimePickerPlacement, DateTimePickerValueType, DateTimePickerDateValue, DateTimePickerRangeValue, DateTimePickerValue, DateTimePickerShortcut, DateTimePickerDateProps, DateTimePickerStringProps, DateTimePickerDateRangeProps, DateTimePickerStringRangeProps, DateTimePickerRef } from './type.js';
+export default DateTimePicker;

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

@@ -0,0 +1,64 @@
+import type { DatePickerBaseProps, DatePickerDateValue, DatePickerPlacement, DatePickerRangeValue, DatePickerShortcut, DatePickerSize, DatePickerValue, DatePickerValueType } from '../DatePicker/type.cjs';
+/** 日期时间选择器尺寸大小 */
+export type DateTimePickerSize = DatePickerSize;
+/** 浮层弹窗对齐方向 */
+export type DateTimePickerPlacement = DatePickerPlacement;
+/** 绑定值类型 */
+export type DateTimePickerValueType = DatePickerValueType;
+/** 单个日期时间值 */
+export type DateTimePickerDateValue = DatePickerDateValue;
+/** 日期时间范围数值元组 */
+export type DateTimePickerRangeValue = DatePickerRangeValue;
+/** 日期时间选择器支持的值类型联合 */
+export type DateTimePickerValue = DatePickerValue;
+/** 日期时间选择器快捷项定义 */
+export type DateTimePickerShortcut<TValue = DateTimePickerDateValue | DateTimePickerRangeValue> = DatePickerShortcut<TValue>;
+/** DateTimePicker 基础属性接口 */
+export interface DateTimePickerBaseProps extends DatePickerBaseProps {
+    /** 允许选择的最小时间（格式 'HH:mm:ss'） */
+    minTime?: string;
+    /** 允许选择的最大时间（格式 'HH:mm:ss'） */
+    maxTime?: string;
+    /** 自定义判断特定时间是否禁用的函数 */
+    disabledTime?: (time: string) => boolean;
+}
+/** 单日期时间选择模式（返回 Date 对象）属性接口 */
+export interface DateTimePickerDateProps extends DateTimePickerBaseProps {
+    range?: false;
+    valueType?: 'date';
+    value?: Date | null;
+    defaultValue?: Date | null;
+    shortcuts?: DateTimePickerShortcut<Date>[];
+    onChange?: (value: Date | null) => void;
+}
+/** 单日期时间选择模式（返回格式化字符串）属性接口 */
+export interface DateTimePickerStringProps extends DateTimePickerBaseProps {
+    range?: false;
+    valueType: 'string';
+    value?: string | null;
+    defaultValue?: string | null;
+    shortcuts?: DateTimePickerShortcut<string>[];
+    onChange?: (value: string | null) => void;
+}
+/** 日期时间范围选择模式（返回 Date 元组）属性接口 */
+export interface DateTimePickerDateRangeProps extends DateTimePickerBaseProps {
+    range: true;
+    valueType?: 'date';
+    value?: [Date, Date] | null;
+    defaultValue?: [Date, Date] | null;
+    shortcuts?: DateTimePickerShortcut<[Date, Date]>[];
+    onChange?: (value: [Date, Date] | null) => void;
+}
+/** 日期时间范围选择模式（返回格式化字符串元组）属性接口 */
+export interface DateTimePickerStringRangeProps extends DateTimePickerBaseProps {
+    range: true;
+    valueType: 'string';
+    value?: [string, string] | null;
+    defaultValue?: [string, string] | null;
+    shortcuts?: DateTimePickerShortcut<[string, string]>[];
+    onChange?: (value: [string, string] | null) => void;
+}
+/** DateTimePicker 组件属性联合类型 */
+export type DateTimePickerProps = DateTimePickerDateProps | DateTimePickerStringProps | DateTimePickerDateRangeProps | DateTimePickerStringRangeProps;
+/** DateTimePicker 根 DOM 元素类型 */
+export type DateTimePickerRef = HTMLDivElement;