ensis-ui 0.0.0-stage → 3.0.0

package/dist/components/date-picker/src/RsDatePicker.js

@@ -0,0 +1,8 @@
+import './RsDatePicker.css'
+import _plugin_vue_export_helper_default from "../../../_virtual/_plugin-vue_export-helper.js";
+import RsDatePicker_vue_vue_type_script_setup_true_lang_default from "./RsDatePicker.impl.js";
+
+//#region src/components/date-picker/src/RsDatePicker.vue
+var RsDatePicker_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsDatePicker_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-e481c787"]]);
+//#endregion
+export { RsDatePicker_default as default };

package/dist/components/date-picker/src/RsDateTimePicker.d.ts

@@ -0,0 +1,77 @@
+import { type RsDatePickerExpose, type RsDatePickerLabelPosition } from './RsDatePicker.js';
+import type { RsComponentSize, RsRadius } from '../../../theme/types';
+import type { RsDatePickerDisabledDate, RsDatePickerGetPopupContainer, RsDatePickerModelValue, RsDatePickerShortcut, RsDatePickerValueFormat, RsDateRangeValue, RsWeekStartsOn } from './date-picker-utils';
+export type RsDateTimeRangeValue = RsDateRangeValue;
+export type RsDateTimePickerLabelPosition = RsDatePickerLabelPosition;
+export type { RsDatePickerDisabledDate, RsDatePickerGetPopupContainer, RsDatePickerModelValue, RsDatePickerShortcut, RsDatePickerValueFormat, RsWeekStartsOn, };
+export type RsDateTimePickerExpose = RsDatePickerExpose;
+export type RsDateTimePickerInstance = RsDateTimePickerExpose & {
+    $el: HTMLElement;
+};
+type __VLS_Props = {
+    name?: string;
+    label?: string;
+    hint?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    required?: boolean;
+    range?: boolean;
+    withSeconds?: boolean;
+    minDate?: string;
+    maxDate?: string;
+    /**
+     * 绑定值格式（展示仍为墙钟，除非另传 format）。
+     * string：YYYY-MM-DD HH:mm:ss；timestamp：毫秒；iso：本地偏移 RFC3339；
+     * 亦可传入 dayjs 模板。
+     */
+    valueFormat?: RsDatePickerValueFormat;
+    format?: string;
+    labelPosition?: RsDateTimePickerLabelPosition;
+    shortcuts?: RsDatePickerShortcut[];
+    size?: RsComponentSize;
+    radius?: RsRadius;
+    id?: string;
+    invalid?: boolean;
+    showValidateMessage?: boolean;
+    clearable?: boolean;
+    readonly?: boolean;
+    ariaLabel?: string;
+    weekStartsOn?: RsWeekStartsOn;
+    disabledDates?: string[];
+    disabledDate?: RsDatePickerDisabledDate;
+    getPopupContainer?: RsDatePickerGetPopupContainer;
+};
+type __VLS_ModelProps = {
+    modelValue?: RsDatePickerModelValue;
+    'open'?: boolean;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, RsDatePickerExpose, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    change: (value: RsDatePickerModelValue) => any;
+    clear: () => any;
+    blur: () => any;
+    focus: () => any;
+    "update:modelValue": (value: RsDatePickerModelValue) => any;
+    openChange: (open: boolean) => any;
+    "update:open": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onChange?: ((value: RsDatePickerModelValue) => any) | undefined;
+    onClear?: (() => any) | undefined;
+    onBlur?: (() => any) | undefined;
+    onFocus?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: RsDatePickerModelValue) => any) | undefined;
+    onOpenChange?: ((open: boolean) => any) | undefined;
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {
+    required: boolean;
+    disabled: boolean;
+    range: boolean;
+    readonly: boolean;
+    clearable: boolean;
+    showValidateMessage: boolean;
+    labelPosition: RsDateTimePickerLabelPosition;
+    withSeconds: boolean;
+    valueFormat: RsDatePickerValueFormat;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/date-picker/src/RsDateTimePicker.impl.js

@@ -0,0 +1,111 @@
+import RsDatePicker_default from "./RsDatePicker.js";
+import { createBlock, defineComponent, mergeModels, mergeProps, openBlock, useModel, useTemplateRef } from "vue";
+//#region src/components/date-picker/src/RsDateTimePicker.vue?vue&type=script&setup=true&lang.ts
+var RsDateTimePicker_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsDateTimePicker",
+	__name: "RsDateTimePicker",
+	props: /*@__PURE__*/ mergeModels({
+		name: {},
+		label: {},
+		hint: {},
+		placeholder: {},
+		disabled: {
+			type: Boolean,
+			default: false
+		},
+		required: {
+			type: Boolean,
+			default: false
+		},
+		range: {
+			type: Boolean,
+			default: false
+		},
+		withSeconds: {
+			type: Boolean,
+			default: false
+		},
+		minDate: {},
+		maxDate: {},
+		valueFormat: { default: "string" },
+		format: {},
+		labelPosition: { default: "top" },
+		shortcuts: {},
+		size: {},
+		radius: {},
+		id: {},
+		invalid: { type: Boolean },
+		showValidateMessage: {
+			type: Boolean,
+			default: true
+		},
+		clearable: {
+			type: Boolean,
+			default: false
+		},
+		readonly: {
+			type: Boolean,
+			default: false
+		},
+		ariaLabel: {},
+		weekStartsOn: {},
+		disabledDates: {},
+		disabledDate: {},
+		getPopupContainer: {}
+	}, {
+		"modelValue": { default: "" },
+		"modelModifiers": {},
+		"open": {
+			type: Boolean,
+			default: false
+		},
+		"openModifiers": {}
+	}),
+	emits: /*@__PURE__*/ mergeModels([
+		"change",
+		"openChange",
+		"clear",
+		"focus",
+		"blur"
+	], ["update:modelValue", "update:open"]),
+	setup(__props, { expose: __expose, emit: __emit }) {
+		const model = useModel(__props, "modelValue");
+		const open = useModel(__props, "open");
+		const pickerRef = useTemplateRef("pickerRef");
+		const emit = __emit;
+		__expose({
+			setValue: (value) => pickerRef.value?.setValue(value),
+			clearValidation: () => pickerRef.value?.clearValidation(),
+			setError: (message) => pickerRef.value?.setError(message),
+			validate: (trigger) => pickerRef.value?.validate(trigger) ?? Promise.resolve({ valid: true }),
+			focus: () => pickerRef.value?.focus(),
+			blur: () => pickerRef.value?.blur()
+		});
+		return (_ctx, _cache) => {
+			return openBlock(), createBlock(RsDatePicker_default, mergeProps({
+				ref_key: "pickerRef",
+				ref: pickerRef
+			}, _ctx.$props, {
+				modelValue: model.value,
+				"onUpdate:modelValue": _cache[0] || (_cache[0] = ($event) => model.value = $event),
+				open: open.value,
+				"onUpdate:open": _cache[1] || (_cache[1] = ($event) => open.value = $event),
+				"with-time": "",
+				"with-seconds": __props.withSeconds,
+				"value-format": __props.valueFormat,
+				onChange: _cache[2] || (_cache[2] = ($event) => emit("change", $event)),
+				onOpenChange: _cache[3] || (_cache[3] = ($event) => emit("openChange", $event)),
+				onClear: _cache[4] || (_cache[4] = ($event) => emit("clear")),
+				onFocus: _cache[5] || (_cache[5] = ($event) => emit("focus")),
+				onBlur: _cache[6] || (_cache[6] = ($event) => emit("blur"))
+			}), null, 16, [
+				"modelValue",
+				"open",
+				"with-seconds",
+				"value-format"
+			]);
+		};
+	}
+});
+//#endregion
+export { RsDateTimePicker_vue_vue_type_script_setup_true_lang_default as default };

package/dist/components/date-picker/src/RsDateTimePicker.js

@@ -0,0 +1,5 @@
+import RsDateTimePicker_vue_vue_type_script_setup_true_lang_default from "./RsDateTimePicker.impl.js";
+//#region src/components/date-picker/src/RsDateTimePicker.vue
+var RsDateTimePicker_default = RsDateTimePicker_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { RsDateTimePicker_default as default };

package/dist/components/date-picker/src/date-picker-utils.d.ts

@@ -0,0 +1,134 @@
+export interface RsParsedDate {
+    year: number;
+    month: number;
+    day: number;
+}
+export interface RsParsedDateTime extends RsParsedDate {
+    hour: number;
+    minute: number;
+    second: number;
+}
+export interface RsDateRangeValue {
+    start?: string;
+    end?: string;
+}
+/** valueFormat 预设：string 墙钟、timestamp 毫秒、iso 本地偏移 RFC3339 */
+export declare const RS_DATE_PICKER_VALUE_FORMAT_PRESETS: readonly ["string", "timestamp", "iso"];
+/**
+ * valueFormat 预设名。
+ * string 为默认墙钟字符串；timestamp 为毫秒；iso 为带本地偏移的 RFC3339。
+ */
+export type RsDatePickerValueFormatPreset = (typeof RS_DATE_PICKER_VALUE_FORMAT_PRESETS)[number];
+/**
+ * v-model 取值格式，对齐 Element Plus `value-format` / Ant Design Vue `valueFormat`：
+ * 展示格式与绑定格式分离。预设之外可传入任意 dayjs 模板，如 `YYYY-MM-DDTHH:mm:ssZ`。
+ */
+export type RsDatePickerValueFormat = RsDatePickerValueFormatPreset | (string & {});
+/**
+ * 内部墙钟字符串与对外 valueFormat 互转时的选项。
+ */
+export interface RsDatePickerValueConvertOptions {
+    valueFormat: string;
+    withTime: boolean;
+}
+/** 时间戳范围（毫秒），用于 valueFormat=timestamp 的 range 模式 */
+export type RsDatePickerTimestampRange = [number, number];
+/** 组件对外 v-model 联合类型 */
+export type RsDatePickerModelValue = string | number | null | RsDateRangeValue | RsDatePickerTimestampRange;
+/** 快捷项可返回字符串、时间戳或范围 */
+export type RsDatePickerShortcutValue = string | number | RsDateRangeValue | RsDatePickerTimestampRange;
+/** 日期/时间范围面板快捷项 */
+export interface RsDatePickerShortcut {
+    label: string;
+    value: () => RsDatePickerShortcutValue;
+}
+/** 将毫秒时间戳格式化为组件内部日期时间字符串 */
+export declare function formatTimestampValue(ms: number, withTime?: boolean): string;
+/** 将组件内部日期/日期时间字符串解析为毫秒时间戳 */
+export declare function parseTimestampValue(value?: string): number | null;
+/**
+ * 将对外 v-model 规范为控件内部墙钟字符串（`YYYY-MM-DD` / `YYYY-MM-DD HH:mm:ss`）。
+ * 解析 ISO 时去掉 Z/偏移，按墙钟分量展示，不按浏览器时区换算。
+ * @param value - 对外绑定值（字符串、毫秒时间戳或空）
+ * @param options - valueFormat 与是否含时分秒
+ * @returns 内部墙钟字符串；无法解析时尽量原样返回
+ */
+export declare function toInternalPickerValue(value: unknown, options: RsDatePickerValueConvertOptions): string;
+/**
+ * 将控件内部墙钟字符串转为对外 valueFormat。
+ * iso 空值返回 null，避免 JSON `""` 无法绑定到 Go `time.Time`。
+ * @param internal - 内部墙钟字符串
+ * @param options - valueFormat 与是否含时分秒
+ * @returns 字符串、毫秒时间戳或 null
+ */
+export declare function fromInternalPickerValue(internal: string, options: RsDatePickerValueConvertOptions): string | number | null;
+/**
+ * 将 fromInternalPickerValue 的结果写入 range.start/end（范围端点始终为字符串）。
+ * @param value - 转换后的端点
+ * @returns 范围对象可用的字符串；空为 `''`
+ */
+export declare function toRangeEndpointString(value: string | number | null): string;
+/** 判断是否为时间戳范围元组 */
+export declare function isTimestampRange(value: unknown): value is RsDatePickerTimestampRange;
+/** 将快捷项返回值规范为内部 string / RsDateRangeValue */
+export declare function normalizeShortcutValue(next: RsDatePickerShortcutValue, options?: {
+    withTime?: boolean;
+}): string | RsDateRangeValue | null;
+export interface RsCalendarCell extends RsParsedDate {
+    inCurrentMonth: boolean;
+}
+export declare const EMPTY_DATE_RANGE: RsDateRangeValue;
+export declare function parseDateValue(value?: string): RsParsedDate | null;
+export declare function parseDateTimeValue(value?: string): RsParsedDateTime | null;
+export declare function formatDateValue(value?: string): string;
+export declare function formatDateParts(date: RsParsedDate): string;
+export declare function formatDateTimeValue(value?: string): string;
+export declare function formatDateTimeParts(date: RsParsedDate, time: string, withSeconds?: boolean): string | null;
+export declare function extractTimeFromDateTime(value?: string, withSeconds?: boolean): string;
+export declare function isDateRangeOrdered(range: RsDateRangeValue): boolean;
+export declare const isDateTimeRangeOrdered: typeof isDateRangeOrdered;
+export declare function formatDateRangeDisplay(range: RsDateRangeValue, options?: {
+    separator?: string;
+    datetime?: boolean;
+}): string;
+export declare function formatLocalDate(date: Date): string;
+export declare function formatDateDisplay(value?: string): string;
+export declare function formatDateTimeDisplay(value?: string): string;
+export declare function formatDateRangeLabel(range: RsDateRangeValue, separator?: string): string;
+export declare function formatDateTimeRangeLabel(range: RsDateRangeValue, separator?: string): string;
+export declare function isDateBetween(value: string, start?: string, end?: string): boolean;
+export declare function getTodayDate(): RsParsedDate;
+export declare function formatTimeFromDateTimeParts(value: RsParsedDateTime, withSeconds?: boolean): string;
+export declare function getNowDateTime(): RsParsedDateTime;
+export declare function getNextMonth(year: number, month: number): Pick<RsParsedDate, 'year' | 'month'>;
+export declare function getDaysInMonth(year: number, month: number): number;
+export declare function dateToNumber(year: number, month: number, day: number): number;
+export declare function parseDateToNumber(value: string): number | null;
+export declare function compareDates(a: RsParsedDate, b: RsParsedDate): number;
+export declare function isSameDate(a: RsParsedDate, b: RsParsedDate): boolean;
+export declare function isDateBetweenParsed(cell: RsParsedDate, start: RsParsedDate, end: RsParsedDate): boolean;
+export declare function isDateWithinBounds(year: number, month: number, day: number, options?: {
+    minDate?: string;
+    maxDate?: string;
+}): boolean;
+export declare function isDateRangeEmpty(value: RsDateRangeValue): boolean;
+/** 一周从哪一天起：0 = 周日 … 6 = 周六，对齐 JS `Date.getDay()`。 */
+export type RsWeekStartsOn = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/** 禁用某一天。入参是墙钟年月日，不是 Date 对象。 */
+export type RsDatePickerDisabledDate = (date: RsParsedDate) => boolean;
+/** 把面板挂到何处。未传则 `body`。 */
+export type RsDatePickerGetPopupContainer = (trigger?: HTMLElement) => HTMLElement | string | undefined;
+/**
+ * 解析一周起始日。显式 `weekStartsOn` 优先；否则读 `Intl.Locale` weekInfo；
+ * 再按语言回退（en-US / en-CA / ja 周日，其它周一）。SSR 无 Intl.Locale 时回退周一。
+ */
+export declare function resolveWeekStartsOn(locale: string, override?: number | null): RsWeekStartsOn;
+/**
+ * 触发器展示文案。`format` 是 dayjs 模板；未传则墙钟 `YYYY-MM-DD` / `YYYY-MM-DD HH:mm:ss`。
+ */
+export declare function formatPickerDisplay(value: string | undefined, options?: {
+    format?: string;
+    withTime?: boolean;
+}): string;
+export declare function resolveDatePickerPortalTarget(getPopupContainer: RsDatePickerGetPopupContainer | undefined, trigger?: HTMLElement | null): string | HTMLElement;
+export declare function buildCalendarGrid(year: number, month: number, weekStartsOn?: number): RsCalendarCell[];

package/dist/components/date-picker/src/date-picker-utils.js

@@ -0,0 +1,293 @@
+import { RS_DATETIME_FORMAT, RS_DATE_FORMAT, RS_TIME_MINUTE_FORMAT, RS_TIME_SECONDS_FORMAT, dayjs, parseRsDateTimeDayjs, parseRsDayjs } from "../../../utils/rs-dayjs.js";
+//#region src/components/date-picker/src/date-picker-utils.ts
+/** valueFormat 预设：string 墙钟、timestamp 毫秒、iso 本地偏移 RFC3339 */
+var RS_DATE_PICKER_VALUE_FORMAT_PRESETS = [
+	"string",
+	"timestamp",
+	"iso"
+];
+/** 将毫秒时间戳格式化为组件内部日期时间字符串 */
+function formatTimestampValue(ms, withTime = true) {
+	const parsed = dayjs(ms);
+	return withTime ? parsed.format(RS_DATETIME_FORMAT) : parsed.format(RS_DATE_FORMAT);
+}
+/** 将组件内部日期/日期时间字符串解析为毫秒时间戳 */
+function parseTimestampValue(value) {
+	if (!value) return null;
+	const parsed = parseRsDateTimeDayjs(value) ?? parseRsDayjs(value);
+	return parsed ? parsed.valueOf() : null;
+}
+function parsePickerDayjs(value) {
+	return parseRsDateTimeDayjs(value) ?? parseRsDayjs(value);
+}
+function isTimestampFormat(valueFormat) {
+	return valueFormat === "timestamp";
+}
+function isIsoFormat(valueFormat) {
+	return valueFormat === "iso";
+}
+function isStringFormat(valueFormat) {
+	return valueFormat === "string" || valueFormat === "";
+}
+/**
+* 将对外 v-model 规范为控件内部墙钟字符串（`YYYY-MM-DD` / `YYYY-MM-DD HH:mm:ss`）。
+* 解析 ISO 时去掉 Z/偏移，按墙钟分量展示，不按浏览器时区换算。
+* @param value - 对外绑定值（字符串、毫秒时间戳或空）
+* @param options - valueFormat 与是否含时分秒
+* @returns 内部墙钟字符串；无法解析时尽量原样返回
+*/
+function toInternalPickerValue(value, options) {
+	if (value == null || value === "") return "";
+	if (typeof value === "number") return formatTimestampValue(value, options.withTime);
+	if (typeof value !== "string") return "";
+	const format = options.valueFormat || "string";
+	if (!isStringFormat(format) && !isTimestampFormat(format) && !isIsoFormat(format)) {
+		const strict = dayjs(value, format, true);
+		if (strict.isValid()) return options.withTime ? strict.format(RS_DATETIME_FORMAT) : strict.format(RS_DATE_FORMAT);
+	}
+	const parsed = parsePickerDayjs(value);
+	if (!parsed) return value;
+	return options.withTime ? parsed.format(RS_DATETIME_FORMAT) : parsed.format(RS_DATE_FORMAT);
+}
+/**
+* 将控件内部墙钟字符串转为对外 valueFormat。
+* iso 空值返回 null，避免 JSON `""` 无法绑定到 Go `time.Time`。
+* @param internal - 内部墙钟字符串
+* @param options - valueFormat 与是否含时分秒
+* @returns 字符串、毫秒时间戳或 null
+*/
+function fromInternalPickerValue(internal, options) {
+	const format = options.valueFormat || "string";
+	if (!internal) return isTimestampFormat(format) || isIsoFormat(format) ? null : "";
+	if (isTimestampFormat(format)) return parseTimestampValue(internal);
+	if (isStringFormat(format)) return internal;
+	const parsed = parsePickerDayjs(internal);
+	if (!parsed) return internal;
+	if (isIsoFormat(format)) return `${options.withTime ? parsed.format("YYYY-MM-DDTHH:mm:ss") : parsed.format("YYYY-MM-DDT00:00:00")}${parsed.format("Z")}`;
+	return parsed.format(format);
+}
+/**
+* 将 fromInternalPickerValue 的结果写入 range.start/end（范围端点始终为字符串）。
+* @param value - 转换后的端点
+* @returns 范围对象可用的字符串；空为 `''`
+*/
+function toRangeEndpointString(value) {
+	if (value == null) return "";
+	return typeof value === "number" ? String(value) : value;
+}
+/** 判断是否为时间戳范围元组 */
+function isTimestampRange(value) {
+	return Array.isArray(value) && value.length === 2 && typeof value[0] === "number" && typeof value[1] === "number";
+}
+/** 将快捷项返回值规范为内部 string / RsDateRangeValue */
+function normalizeShortcutValue(next, options) {
+	const withTime = options?.withTime ?? true;
+	if (typeof next === "number") return formatTimestampValue(next, withTime);
+	if (isTimestampRange(next)) return {
+		start: formatTimestampValue(next[0], withTime),
+		end: formatTimestampValue(next[1], withTime)
+	};
+	if (typeof next === "string") return next || null;
+	if (next && typeof next === "object") return { ...next };
+	return null;
+}
+var EMPTY_DATE_RANGE = {};
+function parseDateValue(value) {
+	const parsed = parseRsDayjs(value);
+	if (!parsed) return null;
+	return {
+		year: parsed.year(),
+		month: parsed.month() + 1,
+		day: parsed.date()
+	};
+}
+function parseDateTimeValue(value) {
+	const parsed = parseRsDateTimeDayjs(value);
+	if (!parsed) return null;
+	return {
+		year: parsed.year(),
+		month: parsed.month() + 1,
+		day: parsed.date(),
+		hour: parsed.hour(),
+		minute: parsed.minute(),
+		second: parsed.second()
+	};
+}
+function formatDateValue(value) {
+	const parsed = parseRsDayjs(value);
+	return parsed ? parsed.format(RS_DATE_FORMAT) : value ?? "";
+}
+function formatDateParts(date) {
+	return dayjs().year(date.year).month(date.month - 1).date(date.day).format(RS_DATE_FORMAT);
+}
+function formatDateTimeValue(value) {
+	const parsed = parseRsDateTimeDayjs(value);
+	return parsed ? parsed.format(RS_DATETIME_FORMAT) : value ?? "";
+}
+function formatDateTimeParts(date, time, withSeconds = true) {
+	const dateText = formatDateParts(date);
+	const formats = withSeconds ? [`${RS_DATE_FORMAT} ${RS_TIME_SECONDS_FORMAT}`, `${RS_DATE_FORMAT} ${RS_TIME_MINUTE_FORMAT}`] : [`${RS_DATE_FORMAT} ${RS_TIME_MINUTE_FORMAT}`];
+	for (const format of formats) {
+		const parsed = dayjs(`${dateText} ${time}`, format, true);
+		if (parsed.isValid()) return parsed.format(withSeconds ? RS_DATETIME_FORMAT : `${RS_DATE_FORMAT} ${RS_TIME_MINUTE_FORMAT}`);
+	}
+	return null;
+}
+function extractTimeFromDateTime(value, withSeconds = true) {
+	const parsed = parseRsDateTimeDayjs(value);
+	if (!parsed) return withSeconds ? "00:00:00" : "00:00";
+	return parsed.format(withSeconds ? RS_TIME_SECONDS_FORMAT : RS_TIME_MINUTE_FORMAT);
+}
+function isDateRangeOrdered(range) {
+	if (!range.start || !range.end) return true;
+	const start = parseRsDateTimeDayjs(range.start) ?? parseRsDayjs(range.start);
+	const end = parseRsDateTimeDayjs(range.end) ?? parseRsDayjs(range.end);
+	if (!start || !end) return range.start <= range.end;
+	return start.isSame(end) || start.isBefore(end);
+}
+var isDateTimeRangeOrdered = isDateRangeOrdered;
+function formatDateRangeDisplay(range, options) {
+	const separator = options?.separator ?? " ~ ";
+	const format = options?.datetime ? formatDateTimeDisplay : formatDateDisplay;
+	const start = range.start ? format(range.start) : "";
+	const end = range.end ? format(range.end) : "";
+	if (start && end) return `${start}${separator}${end}`;
+	return start || end;
+}
+function formatDateDisplay(value) {
+	return formatDateValue(value);
+}
+function formatDateTimeDisplay(value) {
+	return formatDateTimeValue(value);
+}
+function getTodayDate() {
+	const today = dayjs();
+	return {
+		year: today.year(),
+		month: today.month() + 1,
+		day: today.date()
+	};
+}
+function getNowDateTime() {
+	const now = dayjs();
+	return {
+		year: now.year(),
+		month: now.month() + 1,
+		day: now.date(),
+		hour: now.hour(),
+		minute: now.minute(),
+		second: now.second()
+	};
+}
+function getNextMonth(year, month) {
+	const next = dayjs().year(year).month(month - 1).add(1, "month");
+	return {
+		year: next.year(),
+		month: next.month() + 1
+	};
+}
+function getDaysInMonth(year, month) {
+	return dayjs().year(year).month(month - 1).daysInMonth();
+}
+function dateToNumber(year, month, day) {
+	return year * 1e4 + month * 100 + day;
+}
+function parseDateToNumber(value) {
+	const parsed = parseDateValue(value);
+	if (!parsed) return null;
+	return dateToNumber(parsed.year, parsed.month, parsed.day);
+}
+function compareDates(a, b) {
+	return dateToNumber(a.year, a.month, a.day) - dateToNumber(b.year, b.month, b.day);
+}
+function isSameDate(a, b) {
+	return a.year === b.year && a.month === b.month && a.day === b.day;
+}
+function isDateBetweenParsed(cell, start, end) {
+	const value = dateToNumber(cell.year, cell.month, cell.day);
+	const from = dateToNumber(start.year, start.month, start.day);
+	const to = dateToNumber(end.year, end.month, end.day);
+	return value >= Math.min(from, to) && value <= Math.max(from, to);
+}
+function isDateWithinBounds(year, month, day, options = {}) {
+	const candidate = dateToNumber(year, month, day);
+	if (options.minDate) {
+		const min = parseDateToNumber(options.minDate);
+		if (min !== null && candidate < min) return false;
+	}
+	if (options.maxDate) {
+		const max = parseDateToNumber(options.maxDate);
+		if (max !== null && candidate > max) return false;
+	}
+	return true;
+}
+function isDateRangeEmpty(value) {
+	return !value.start && !value.end;
+}
+/**
+* 解析一周起始日。显式 `weekStartsOn` 优先；否则读 `Intl.Locale` weekInfo；
+* 再按语言回退（en-US / en-CA / ja 周日，其它周一）。SSR 无 Intl.Locale 时回退周一。
+*/
+function resolveWeekStartsOn(locale, override) {
+	if (override != null && override >= 0 && override <= 6) return override;
+	try {
+		const withWeek = new Intl.Locale(locale);
+		const info = withWeek.weekInfo ?? withWeek.getWeekInfo?.();
+		if (info?.firstDay != null) {
+			const day = info.firstDay === 7 ? 0 : info.firstDay;
+			if (day >= 0 && day <= 6) return day;
+		}
+	} catch {}
+	const tag = locale.toLowerCase();
+	if (tag.startsWith("en-us") || tag.startsWith("en-ca") || tag.startsWith("ja")) return 0;
+	return 1;
+}
+/**
+* 触发器展示文案。`format` 是 dayjs 模板；未传则墙钟 `YYYY-MM-DD` / `YYYY-MM-DD HH:mm:ss`。
+*/
+function formatPickerDisplay(value, options) {
+	if (!value) return "";
+	if (!options?.format) return options?.withTime ? formatDateTimeDisplay(value) : formatDateDisplay(value);
+	const parsed = parseRsDateTimeDayjs(value) ?? parseRsDayjs(value);
+	return parsed ? parsed.format(options.format) : value;
+}
+function resolveDatePickerPortalTarget(getPopupContainer, trigger) {
+	if (typeof document === "undefined") return "body";
+	if (!getPopupContainer) return "body";
+	return getPopupContainer(trigger ?? void 0) ?? "body";
+}
+function buildCalendarGrid(year, month, weekStartsOn = 1) {
+	const daysInMonth = getDaysInMonth(year, month);
+	const leading = (dayjs().year(year).month(month - 1).date(1).day() - weekStartsOn + 7) % 7;
+	const prevMonth = month === 1 ? 12 : month - 1;
+	const prevYear = month === 1 ? year - 1 : year;
+	const daysInPrevMonth = getDaysInMonth(prevYear, prevMonth);
+	const cells = [];
+	for (let index = leading; index > 0; index -= 1) cells.push({
+		year: prevYear,
+		month: prevMonth,
+		day: daysInPrevMonth - index + 1,
+		inCurrentMonth: false
+	});
+	for (let day = 1; day <= daysInMonth; day += 1) cells.push({
+		year,
+		month,
+		day,
+		inCurrentMonth: true
+	});
+	const nextMonth = month === 12 ? 1 : month + 1;
+	const nextYear = month === 12 ? year + 1 : year;
+	let nextDay = 1;
+	while (cells.length < 42) {
+		cells.push({
+			year: nextYear,
+			month: nextMonth,
+			day: nextDay,
+			inCurrentMonth: false
+		});
+		nextDay += 1;
+	}
+	return cells;
+}
+//#endregion
+export { EMPTY_DATE_RANGE, RS_DATE_PICKER_VALUE_FORMAT_PRESETS, buildCalendarGrid, compareDates, dateToNumber, extractTimeFromDateTime, formatDateDisplay, formatDateParts, formatDateRangeDisplay, formatDateTimeDisplay, formatDateTimeParts, formatDateTimeValue, formatDateValue, formatPickerDisplay, formatTimestampValue, fromInternalPickerValue, getDaysInMonth, getNextMonth, getNowDateTime, getTodayDate, isDateBetweenParsed, isDateRangeEmpty, isDateRangeOrdered, isDateTimeRangeOrdered, isDateWithinBounds, isSameDate, isTimestampRange, normalizeShortcutValue, parseDateTimeValue, parseDateToNumber, parseDateValue, parseTimestampValue, resolveDatePickerPortalTarget, resolveWeekStartsOn, toInternalPickerValue, toRangeEndpointString };

package/dist/components/date-picker/src/date-range-validation.d.ts

@@ -0,0 +1,15 @@
+import type { RsDateRangeValue } from './date-picker-utils';
+export interface RsDateRangeValidationRules {
+    required?: boolean;
+    ordered?: boolean;
+}
+export type RsDateRangeValidationError = 'required' | 'order';
+export interface RsDateRangeValidationResult {
+    valid: boolean;
+    error?: RsDateRangeValidationError;
+}
+export type RsDateTimeRangeValidationRules = RsDateRangeValidationRules;
+export type RsDateTimeRangeValidationError = RsDateRangeValidationError;
+export type RsDateTimeRangeValidationResult = RsDateRangeValidationResult;
+export declare function validateDateRangeValue(value: RsDateRangeValue, rules?: RsDateRangeValidationRules): RsDateRangeValidationResult;
+export declare const validateDateTimeRangeValue: typeof validateDateRangeValue;

package/dist/components/date-picker/src/date-range-validation.js

@@ -0,0 +1,16 @@
+import { isDateRangeOrdered } from "./date-picker-utils.js";
+//#region src/components/date-picker/src/date-range-validation.ts
+function validateDateRangeValue(value, rules = {}) {
+	if (rules.required && (!value.start || !value.end)) return {
+		valid: false,
+		error: "required"
+	};
+	if (rules.ordered !== false && !isDateRangeOrdered(value)) return {
+		valid: false,
+		error: "order"
+	};
+	return { valid: true };
+}
+var validateDateTimeRangeValue = validateDateRangeValue;
+//#endregion
+export { validateDateRangeValue, validateDateTimeRangeValue };

package/dist/components/date-picker/src/date-validation.d.ts

@@ -0,0 +1,15 @@
+export interface RsDateValidationRules {
+    required?: boolean;
+    min?: string;
+    max?: string;
+}
+export type RsDateValidationError = 'required' | 'min' | 'max' | 'format';
+export interface RsDateValidationResult {
+    valid: boolean;
+    error?: RsDateValidationError;
+}
+export type RsDateTimeValidationRules = RsDateValidationRules;
+export type RsDateTimeValidationError = RsDateValidationError;
+export type RsDateTimeValidationResult = RsDateValidationResult;
+export declare function validateDateValue(value: string, rules?: RsDateValidationRules): RsDateValidationResult;
+export declare function validateDateTimeValue(value: string, rules?: RsDateTimeValidationRules): RsDateTimeValidationResult;