@cyberpunk-vue/components 1.13.6 → 1.13.7

package/dist/date-picker/src/date-picker-select.d.ts

@@ -0,0 +1,657 @@
+import { ExtractPropTypes, PropType } from 'vue';
+import { Placement } from '@floating-ui/dom';
+import { Size } from '@cyberpunk-vue/hooks';
+export type PickerType = 'date' | 'dates' | 'week' | 'month' | 'year' | 'daterange' | 'monthrange' | 'yearrange' | 'time' | 'timerange' | 'datetime' | 'datetimerange';
+export type PickerSize = Size;
+export type PickerShape = 'clip' | 'no-clip' | 'round';
+export type PickerVariant = 'outline' | 'filled' | 'ghost';
+export type PickerValueItem = string | number | Date;
+export type PickerModelValue = PickerValueItem | PickerValueItem[] | null | undefined;
+export type PickerRangeRole = 'start' | 'end';
+export interface PickerShortcut {
+    /** 快捷项显示文本 */
+    text: string;
+    /** 快捷项值，可以是静态值或返回值的函数 */
+    value: PickerModelValue | (() => PickerModelValue);
+}
+export interface PickerCell {
+    /** 单元格对应日期 */
+    date: Date;
+    /** 单元格显示文本 */
+    label: string;
+    /** 是否为当前视图范围外的日期 */
+    outside: boolean;
+    /** 是否为今天 */
+    today: boolean;
+    /** 是否被选中 */
+    selected: boolean;
+    /** 是否处于范围内 */
+    inRange: boolean;
+    /** 是否为范围起点 */
+    rangeStart: boolean;
+    /** 是否为范围终点 */
+    rangeEnd: boolean;
+    /** 是否禁用 */
+    disabled: boolean;
+}
+export type DisabledTimeResolver = (role?: PickerRangeRole) => number[];
+/**
+ * CpDatePickerSelect 组件 Props 定义
+ *
+ * @description 输入框弹层日期选择器，支持日期、多日期、周、月、年以及日期范围选择。
+ *
+ * @example
+ * ```vue
+ * <CpDatePickerSelect v-model="date" value-format="YYYY-MM-DD" />
+ * <CpDatePickerSelect v-model="range" type="daterange" value-format="YYYY-MM-DD" />
+ * ```
+ *
+ * @slots
+ * - `prefix` - 触发器前缀内容
+ * - `suffix` - 触发器后缀内容
+ * - `cell` - 自定义日期单元格内容
+ * - `footer` - 自定义面板底部操作区
+ *
+ * @exposes
+ * - `open` - 打开选择器浮层
+ * - `close` - 关闭选择器浮层
+ * - `toggle` - 切换选择器浮层
+ * - `focus` - 聚焦触发器
+ * - `blur` - 失焦触发器
+ * @category 表单组件
+ * @displayName CpDatePickerSelect 日期选择选择器
+ */
+export declare const pickerProps: {
+    /**
+     * 绑定值 (v-model)
+     * @default null
+     */
+    readonly modelValue: {
+        readonly type: PropType<PickerModelValue>;
+        readonly default: null;
+    };
+    /**
+     * 选择器类型
+     * @default 'date'
+     */
+    readonly type: {
+        readonly type: PropType<PickerType>;
+        readonly default: "date";
+    };
+    /**
+     * 显示格式，例如 `YYYY-MM-DD HH:mm:ss`
+     * @default 按 type 自动推导
+     */
+    readonly format: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /**
+     * 输出值格式。为空时输出 Date；传入 `timestamp` 时输出时间戳。
+     * @default ''
+     */
+    readonly valueFormat: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /**
+     * 占位文本
+     * @default ''
+     */
+    readonly placeholder: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /**
+     * 范围起始占位文本
+     * @default '开始'
+     */
+    readonly startPlaceholder: {
+        readonly type: StringConstructor;
+        readonly default: "开始";
+    };
+    /**
+     * 范围结束占位文本
+     * @default '结束'
+     */
+    readonly endPlaceholder: {
+        readonly type: StringConstructor;
+        readonly default: "结束";
+    };
+    /**
+     * 范围分隔符
+     * @default ' - '
+     */
+    readonly rangeSeparator: {
+        readonly type: StringConstructor;
+        readonly default: " - ";
+    };
+    /**
+     * 是否禁用
+     * @default false
+     */
+    readonly disabled: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /**
+     * 是否只读
+     * @default false
+     */
+    readonly readonly: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /**
+     * 是否允许直接输入
+     * @default false
+     */
+    readonly editable: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /**
+     * 是否可清空
+     * @default true
+     */
+    readonly clearable: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /**
+     * 是否显示确认按钮。未设置时范围、时间和日期时间类型默认需要确认。
+     * @default undefined
+     */
+    readonly confirm: {
+        readonly type: PropType<boolean | undefined>;
+        readonly default: undefined;
+    };
+    /**
+     * 组件尺寸
+     * @default 'md'
+     */
+    readonly size: {
+        readonly type: PropType<PickerSize>;
+        readonly default: "md";
+    };
+    /**
+     * 形状模式
+     * @default 'clip'
+     */
+    readonly shape: {
+        readonly type: PropType<PickerShape>;
+        readonly default: "clip";
+    };
+    /**
+     * 视觉变体
+     * @default 'outline'
+     */
+    readonly variant: {
+        readonly type: PropType<PickerVariant>;
+        readonly default: "outline";
+    };
+    /**
+     * 自定义主题色
+     * @default ''
+     */
+    readonly color: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /**
+     * 未激活边框颜色
+     * @default ''
+     */
+    readonly inactiveColor: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /**
+     * Placeholder 颜色
+     * @default ''
+     */
+    readonly placeholderColor: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /**
+     * 触发器宽度
+     * @default ''
+     */
+    readonly width: {
+        readonly type: PropType<string | number>;
+        readonly default: "";
+    };
+    /**
+     * 弹出位置
+     * @default 'bottom-start'
+     */
+    readonly placement: {
+        readonly type: PropType<Placement>;
+        readonly default: "bottom-start";
+    };
+    /**
+     * Teleport 目标
+     * @default 'body'
+     */
+    readonly teleportTo: {
+        readonly type: PropType<string | HTMLElement>;
+        readonly default: "body";
+    };
+    /**
+     * 禁用日期判断函数
+     */
+    readonly disabledDate: {
+        readonly type: PropType<(date: Date) => boolean>;
+        readonly default: undefined;
+    };
+    /**
+     * 禁用小时列表
+     */
+    readonly disabledHours: {
+        readonly type: PropType<DisabledTimeResolver>;
+        readonly default: undefined;
+    };
+    /**
+     * 禁用分钟列表
+     */
+    readonly disabledMinutes: {
+        readonly type: PropType<DisabledTimeResolver>;
+        readonly default: undefined;
+    };
+    /**
+     * 禁用秒列表
+     */
+    readonly disabledSeconds: {
+        readonly type: PropType<DisabledTimeResolver>;
+        readonly default: undefined;
+    };
+    /**
+     * 小时步长
+     * @default 1
+     */
+    readonly hourStep: {
+        readonly type: NumberConstructor;
+        readonly default: 1;
+    };
+    /**
+     * 分钟步长
+     * @default 1
+     */
+    readonly minuteStep: {
+        readonly type: NumberConstructor;
+        readonly default: 1;
+    };
+    /**
+     * 秒步长
+     * @default 1
+     */
+    readonly secondStep: {
+        readonly type: NumberConstructor;
+        readonly default: 1;
+    };
+    /**
+     * 是否显示秒
+     * @default true
+     */
+    readonly showSeconds: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /**
+     * 快捷选项
+     * @default []
+     */
+    readonly shortcuts: {
+        readonly type: PropType<PickerShortcut[]>;
+        readonly default: () => never[];
+    };
+    /**
+     * 默认展示日期
+     */
+    readonly defaultValue: {
+        readonly type: PropType<PickerValueItem>;
+        readonly default: undefined;
+    };
+    /**
+     * 默认时间，支持 `HH:mm:ss` 或范围数组
+     * @default undefined
+     */
+    readonly defaultTime: {
+        readonly type: PropType<string | [string, string]>;
+        readonly default: undefined;
+    };
+    /**
+     * 范围面板是否解除联动
+     * @default false
+     */
+    readonly unlinkPanels: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+};
+export type PickerProps = ExtractPropTypes<typeof pickerProps>;
+export declare const datePickerSelectProps: {
+    /**
+     * 绑定值 (v-model)
+     * @default null
+     */
+    readonly modelValue: {
+        readonly type: PropType<PickerModelValue>;
+        readonly default: null;
+    };
+    /**
+     * 选择器类型
+     * @default 'date'
+     */
+    readonly type: {
+        readonly type: PropType<PickerType>;
+        readonly default: "date";
+    };
+    /**
+     * 显示格式，例如 `YYYY-MM-DD HH:mm:ss`
+     * @default 按 type 自动推导
+     */
+    readonly format: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /**
+     * 输出值格式。为空时输出 Date；传入 `timestamp` 时输出时间戳。
+     * @default ''
+     */
+    readonly valueFormat: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /**
+     * 占位文本
+     * @default ''
+     */
+    readonly placeholder: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /**
+     * 范围起始占位文本
+     * @default '开始'
+     */
+    readonly startPlaceholder: {
+        readonly type: StringConstructor;
+        readonly default: "开始";
+    };
+    /**
+     * 范围结束占位文本
+     * @default '结束'
+     */
+    readonly endPlaceholder: {
+        readonly type: StringConstructor;
+        readonly default: "结束";
+    };
+    /**
+     * 范围分隔符
+     * @default ' - '
+     */
+    readonly rangeSeparator: {
+        readonly type: StringConstructor;
+        readonly default: " - ";
+    };
+    /**
+     * 是否禁用
+     * @default false
+     */
+    readonly disabled: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /**
+     * 是否只读
+     * @default false
+     */
+    readonly readonly: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /**
+     * 是否允许直接输入
+     * @default false
+     */
+    readonly editable: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /**
+     * 是否可清空
+     * @default true
+     */
+    readonly clearable: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /**
+     * 是否显示确认按钮。未设置时范围、时间和日期时间类型默认需要确认。
+     * @default undefined
+     */
+    readonly confirm: {
+        readonly type: PropType<boolean | undefined>;
+        readonly default: undefined;
+    };
+    /**
+     * 组件尺寸
+     * @default 'md'
+     */
+    readonly size: {
+        readonly type: PropType<PickerSize>;
+        readonly default: "md";
+    };
+    /**
+     * 形状模式
+     * @default 'clip'
+     */
+    readonly shape: {
+        readonly type: PropType<PickerShape>;
+        readonly default: "clip";
+    };
+    /**
+     * 视觉变体
+     * @default 'outline'
+     */
+    readonly variant: {
+        readonly type: PropType<PickerVariant>;
+        readonly default: "outline";
+    };
+    /**
+     * 自定义主题色
+     * @default ''
+     */
+    readonly color: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /**
+     * 未激活边框颜色
+     * @default ''
+     */
+    readonly inactiveColor: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /**
+     * Placeholder 颜色
+     * @default ''
+     */
+    readonly placeholderColor: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /**
+     * 触发器宽度
+     * @default ''
+     */
+    readonly width: {
+        readonly type: PropType<string | number>;
+        readonly default: "";
+    };
+    /**
+     * 弹出位置
+     * @default 'bottom-start'
+     */
+    readonly placement: {
+        readonly type: PropType<Placement>;
+        readonly default: "bottom-start";
+    };
+    /**
+     * Teleport 目标
+     * @default 'body'
+     */
+    readonly teleportTo: {
+        readonly type: PropType<string | HTMLElement>;
+        readonly default: "body";
+    };
+    /**
+     * 禁用日期判断函数
+     */
+    readonly disabledDate: {
+        readonly type: PropType<(date: Date) => boolean>;
+        readonly default: undefined;
+    };
+    /**
+     * 禁用小时列表
+     */
+    readonly disabledHours: {
+        readonly type: PropType<DisabledTimeResolver>;
+        readonly default: undefined;
+    };
+    /**
+     * 禁用分钟列表
+     */
+    readonly disabledMinutes: {
+        readonly type: PropType<DisabledTimeResolver>;
+        readonly default: undefined;
+    };
+    /**
+     * 禁用秒列表
+     */
+    readonly disabledSeconds: {
+        readonly type: PropType<DisabledTimeResolver>;
+        readonly default: undefined;
+    };
+    /**
+     * 小时步长
+     * @default 1
+     */
+    readonly hourStep: {
+        readonly type: NumberConstructor;
+        readonly default: 1;
+    };
+    /**
+     * 分钟步长
+     * @default 1
+     */
+    readonly minuteStep: {
+        readonly type: NumberConstructor;
+        readonly default: 1;
+    };
+    /**
+     * 秒步长
+     * @default 1
+     */
+    readonly secondStep: {
+        readonly type: NumberConstructor;
+        readonly default: 1;
+    };
+    /**
+     * 是否显示秒
+     * @default true
+     */
+    readonly showSeconds: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /**
+     * 快捷选项
+     * @default []
+     */
+    readonly shortcuts: {
+        readonly type: PropType<PickerShortcut[]>;
+        readonly default: () => never[];
+    };
+    /**
+     * 默认展示日期
+     */
+    readonly defaultValue: {
+        readonly type: PropType<PickerValueItem>;
+        readonly default: undefined;
+    };
+    /**
+     * 默认时间，支持 `HH:mm:ss` 或范围数组
+     * @default undefined
+     */
+    readonly defaultTime: {
+        readonly type: PropType<string | [string, string]>;
+        readonly default: undefined;
+    };
+    /**
+     * 范围面板是否解除联动
+     * @default false
+     */
+    readonly unlinkPanels: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+};
+export type DatePickerSelectProps = PickerProps;
+export declare const pickerEmits: {
+    /**
+     * v-model 更新事件
+     */
+    'update:modelValue': (_value: PickerModelValue) => boolean;
+    /**
+     * 值变化事件
+     */
+    change: (_value: PickerModelValue) => boolean;
+    /**
+     * 清空事件
+     */
+    clear: () => boolean;
+    /**
+     * 聚焦事件
+     */
+    focus: (event?: FocusEvent) => boolean;
+    /**
+     * 失焦事件
+     */
+    blur: (event?: FocusEvent) => boolean;
+    /**
+     * 浮层显示状态变化
+     */
+    visibleChange: (visible: boolean) => boolean;
+};
+export type PickerEmits = typeof pickerEmits;
+export declare const datePickerSelectEmits: {
+    /**
+     * v-model 更新事件
+     */
+    'update:modelValue': (_value: PickerModelValue) => boolean;
+    /**
+     * 值变化事件
+     */
+    change: (_value: PickerModelValue) => boolean;
+    /**
+     * 清空事件
+     */
+    clear: () => boolean;
+    /**
+     * 聚焦事件
+     */
+    focus: (event?: FocusEvent) => boolean;
+    /**
+     * 失焦事件
+     */
+    blur: (event?: FocusEvent) => boolean;
+    /**
+     * 浮层显示状态变化
+     */
+    visibleChange: (visible: boolean) => boolean;
+};
+export type DatePickerSelectEmits = PickerEmits;