niuma-ui 1.1.12 → 1.2.0

package/dist/components/code-mirror-intel.js

@@ -0,0 +1,62 @@
+import { EditorView, hoverTooltip } from "@codemirror/view";
+//#region src/components/code-mirror-intel.ts
+function posToLineColumn(view, pos) {
+	const line = view.state.doc.lineAt(pos);
+	return {
+		line: line.number,
+		column: pos - line.from + 1
+	};
+}
+function goToPosition(view, line, column = 1) {
+	const doc = view.state.doc;
+	const ln = Math.min(Math.max(1, line), doc.lines);
+	const pos = doc.line(ln).from + Math.max(0, column - 1);
+	view.dispatch({
+		selection: { anchor: pos },
+		scrollIntoView: true
+	});
+	view.focus();
+}
+function codeMirrorIntelExtensions(handlers) {
+	return [hoverTooltip(async (view, pos) => {
+		const h = handlers();
+		if (!h.hoverRequest) return null;
+		const { line, column } = posToLineColumn(view, pos);
+		const text = await h.hoverRequest(line, column);
+		if (!text?.trim()) return null;
+		return {
+			pos,
+			above: true,
+			create() {
+				const dom = document.createElement("div");
+				dom.className = "rs-code-editor__hover";
+				dom.textContent = text;
+				return { dom };
+			}
+		};
+	}, { hoverTime: 450 }), EditorView.domEventHandlers({ mousedown(event, view) {
+		if (!event.ctrlKey && !event.metaKey) return false;
+		const h = handlers();
+		if (!h.definitionRequest) return false;
+		const pos = view.posAtCoords({
+			x: event.clientX,
+			y: event.clientY
+		});
+		if (pos == null) return false;
+		const { line, column } = posToLineColumn(view, pos);
+		h.definitionRequest(line, column).then((loc) => {
+			if (!loc?.line) return;
+			const current = (h.currentFilePath ?? "").replace(/\\/g, "/");
+			const target = (loc.file ?? "").replace(/\\/g, "/");
+			if (target && current && target !== current) {
+				h.onGotoDefinition?.(loc);
+				return;
+			}
+			goToPosition(view, loc.line, loc.column ?? 1);
+		});
+		event.preventDefault();
+		return true;
+	} })];
+}
+//#endregion
+export { codeMirrorIntelExtensions, goToPosition, posToLineColumn };

package/dist/components/code-mirror-lang.d.ts

@@ -0,0 +1,10 @@
+import type { Extension } from '@codemirror/state';
+import type { RsCodeEditorSqlConfig } from './code-editor-utils';
+export interface ResolveCodeMirrorLanguageOptions {
+    sql?: RsCodeEditorSqlConfig;
+}
+/** 按语言标识动态加载 CodeMirror 语言扩展 */
+export declare function resolveCodeMirrorLanguage(lang: string, options?: ResolveCodeMirrorLanguageOptions): Promise<Extension[]>;
+export declare function isCodeMirrorLightTheme(): boolean;
+/** 预加载 CodeMirror 核心与目标语言包（供辅助窗口 reveal 前调用） */
+export declare function prewarmCodeMirrorEditor(language: string): Promise<void>;

package/dist/components/code-mirror-lang.js

@@ -0,0 +1,113 @@
+//#region src/components/code-mirror-lang.ts
+/** 按语言标识动态加载 CodeMirror 语言扩展 */
+async function resolveCodeMirrorLanguage(lang, options) {
+	const l = lang.toLowerCase().trim();
+	try {
+		switch (l) {
+			case "js":
+			case "javascript":
+			case "jsx": {
+				const { javascript } = await import("@codemirror/lang-javascript");
+				return [javascript()];
+			}
+			case "ts":
+			case "typescript":
+			case "tsx": {
+				const { javascript } = await import("@codemirror/lang-javascript");
+				return [javascript({ typescript: true })];
+			}
+			case "py":
+			case "python": {
+				const { python } = await import("@codemirror/lang-python");
+				return [python()];
+			}
+			case "go": {
+				const { go } = await import("@codemirror/lang-go");
+				return [go()];
+			}
+			case "html":
+			case "htm": {
+				const { html } = await import("@codemirror/lang-html");
+				return [html()];
+			}
+			case "css":
+			case "scss":
+			case "less": {
+				const { css } = await import("@codemirror/lang-css");
+				return [css()];
+			}
+			case "json":
+			case "jsonc": {
+				const { json } = await import("@codemirror/lang-json");
+				return [json()];
+			}
+			case "sql": {
+				const { sql, PostgreSQL, StandardSQL, MySQL } = await import("@codemirror/lang-sql");
+				const dialectName = options?.sql?.dialect ?? "postgresql";
+				let dialect = PostgreSQL;
+				if (dialectName === "mysql") dialect = MySQL;
+				else if (dialectName === "standard") dialect = StandardSQL;
+				return [sql({
+					dialect,
+					schema: options?.sql?.schema,
+					defaultTable: options?.sql?.defaultTable,
+					defaultSchema: options?.sql?.defaultSchema
+				})];
+			}
+			case "rust":
+			case "rs": {
+				const { rust } = await import("@codemirror/lang-rust");
+				return [rust()];
+			}
+			case "cpp":
+			case "cc":
+			case "cxx":
+			case "c": {
+				const { cpp } = await import("@codemirror/lang-cpp");
+				return [cpp()];
+			}
+			case "java": {
+				const { java } = await import("@codemirror/lang-java");
+				return [java()];
+			}
+			case "md":
+			case "markdown": {
+				const { markdown } = await import("@codemirror/lang-markdown");
+				return [markdown()];
+			}
+			case "xml":
+			case "svg": {
+				const { xml } = await import("@codemirror/lang-xml");
+				return [xml()];
+			}
+			case "yaml":
+			case "yml": {
+				const { yaml } = await import("@codemirror/lang-yaml");
+				return [yaml()];
+			}
+			case "vue": {
+				const { html } = await import("@codemirror/lang-html");
+				return [html()];
+			}
+			case "sh":
+			case "bash":
+			case "shell":
+			case "zsh": {
+				const [{ StreamLanguage }, { shell }] = await Promise.all([import("@codemirror/language"), import("@codemirror/legacy-modes/mode/shell")]);
+				return [StreamLanguage.define(shell)];
+			}
+			default: return [];
+		}
+	} catch {
+		return [];
+	}
+}
+function isCodeMirrorLightTheme() {
+	return typeof document !== "undefined" && document.documentElement.dataset.rsTheme === "light";
+}
+/** 预加载 CodeMirror 核心与目标语言包（供辅助窗口 reveal 前调用） */
+async function prewarmCodeMirrorEditor(language) {
+	await Promise.all([import("codemirror"), resolveCodeMirrorLanguage(language)]);
+}
+//#endregion
+export { isCodeMirrorLightTheme, prewarmCodeMirrorEditor, resolveCodeMirrorLanguage };

package/dist/components/context-menu-utils.d.ts

@@ -0,0 +1,21 @@
+/** 右键菜单图标尺寸（与 Dropdown / Menu 一致） */
+export declare const RS_CONTEXT_MENU_ICON_SIZE = 16;
+export declare const RS_CONTEXT_MENU_ARROW_SIZE = 14;
+/** 右键菜单项定义 */
+export interface RsContextMenuItem {
+    /** 唯一标识，选中时回传 */
+    key: string;
+    label: string;
+    icon?: string;
+    disabled?: boolean;
+    /** 危险操作样式 */
+    danger?: boolean;
+    /** 为 true 时渲染分隔线 */
+    separator?: boolean;
+    /** 子菜单项 */
+    children?: RsContextMenuItem[];
+    /** 键盘快捷键提示（仅展示，不绑定事件），如 "⌘K"、"⌃C" */
+    shortcut?: string;
+}
+/** 是否存在可操作项（排除纯分隔线），用于避免空菜单气泡 */
+export declare function hasActionableContextMenuItems(items: RsContextMenuItem[] | undefined): boolean;

package/dist/components/context-menu-utils.js

@@ -0,0 +1,8 @@
+//#region src/components/context-menu-utils.ts
+/** 是否存在可操作项（排除纯分隔线），用于避免空菜单气泡 */
+function hasActionableContextMenuItems(items) {
+	if (!items?.length) return false;
+	return items.some((item) => !item.separator);
+}
+//#endregion
+export { hasActionableContextMenuItems };

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

@@ -0,0 +1,115 @@
+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;
+export declare function buildCalendarGrid(year: number, month: number, weekStartsOn?: number): RsCalendarCell[];

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

@@ -0,0 +1,270 @@
+import { RS_DATETIME_FORMAT, RS_DATE_FORMAT, RS_TIME_MINUTE_FORMAT, RS_TIME_SECONDS_FORMAT, dayjs, parseRsDateTimeDayjs, parseRsDayjs } from "../lib/rs-dayjs.js";
+//#region src/components/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 formatDateRangeLabel(range, separator = " ~ ") {
+	return formatDateRangeDisplay(range, { separator });
+}
+function formatDateTimeRangeLabel(range, separator = " ~ ") {
+	return formatDateRangeDisplay(range, {
+		separator,
+		datetime: true
+	});
+}
+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;
+}
+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, formatDateRangeLabel, formatDateTimeDisplay, formatDateTimeParts, formatDateTimeRangeLabel, formatDateTimeValue, formatDateValue, formatTimestampValue, fromInternalPickerValue, getDaysInMonth, getNextMonth, getNowDateTime, getTodayDate, isDateBetweenParsed, isDateRangeEmpty, isDateRangeOrdered, isDateTimeRangeOrdered, isDateWithinBounds, isSameDate, isTimestampRange, normalizeShortcutValue, parseDateTimeValue, parseDateToNumber, parseDateValue, parseTimestampValue, toInternalPickerValue, toRangeEndpointString };

package/dist/components/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-range-validation.js

@@ -0,0 +1,16 @@
+import { isDateRangeOrdered } from "./date-picker-utils.js";
+//#region src/components/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-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;