niuma-ui 2.0.2 → 2.0.4

package/dist/components/calendar-grid/src/RsCalendarGrid.impl.js

@@ -1,20 +1,48 @@
+import { RS_COMPONENT_SIZE_ICON_PX } from "../../../theme/types.js";
+import { useRsConfigOptional } from "../../../composables/useRsConfig.js";
+import { resolveDirMode } from "../../../locale/apply.js";
 import { useRsI18n } from "../../../composables/useRsI18n.js";
 import RsIcon_default from "../../icon/src/RsIcon.js";
-import { buildCalendarGrid, formatDateParts, isDateBetweenParsed, isDateWithinBounds, isSameDate } from "../../date-picker/src/date-picker-utils.js";
-import { Fragment, computed, createElementBlock, createElementVNode, createVNode, defineComponent, mergeModels, normalizeClass, openBlock, renderList, toDisplayString, unref, useModel } from "vue";
+import { useRsFormContext } from "../../form/src/form-utils.js";
+import { useResolvedRsComponentSize } from "../../_shared/src/resolve-size.js";
+import { rsRadiusCss, useResolvedRsRadius } from "../../_shared/src/resolve-radius.js";
+import { buildCalendarGrid, getTodayDate, isSameDate, resolveWeekStartsOn } from "../../date-picker/src/date-picker-utils.js";
+import { addCalendarMonths, calendarCellClass, chunkCalendarWeeks, resolveCalendarCellState, resolveFocusedDate, resolveKeyboardMove, sameYearMonth, toDisabledDateSet, weekNumberOfRow } from "./calendar-grid-utils.js";
+import { Fragment, computed, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, mergeModels, mergeProps, nextTick, normalizeClass, normalizeStyle, openBlock, ref, renderList, renderSlot, toDisplayString, unref, useModel, watch } from "vue";
 //#region src/components/calendar-grid/src/RsCalendarGrid.vue?vue&type=script&setup=true&lang.ts
-var _hoisted_1 = { class: "rs-calendar-grid" };
+var _hoisted_1 = ["id"];
 var _hoisted_2 = { class: "rs-calendar-grid__header" };
 var _hoisted_3 = { class: "rs-calendar-grid__nav-group" };
-var _hoisted_4 = ["aria-label"];
-var _hoisted_5 = ["aria-label"];
-var _hoisted_6 = { class: "rs-calendar-grid__title" };
+var _hoisted_4 = ["aria-label", "disabled"];
+var _hoisted_5 = ["aria-label", "disabled"];
+var _hoisted_6 = {
+	class: "rs-calendar-grid__title",
+	"aria-live": "polite"
+};
 var _hoisted_7 = { class: "rs-calendar-grid__nav-group" };
-var _hoisted_8 = ["aria-label"];
-var _hoisted_9 = ["aria-label"];
-var _hoisted_10 = { class: "rs-calendar-grid__table" };
-var _hoisted_11 = ["disabled", "onClick"];
+var _hoisted_8 = ["aria-label", "disabled"];
+var _hoisted_9 = ["aria-label", "disabled"];
+var _hoisted_10 = ["aria-label"];
+var _hoisted_11 = {
+	key: 0,
+	scope: "col",
+	class: "rs-calendar-grid__weekday rs-calendar-grid__weekday--week"
+};
+var _hoisted_12 = {
+	key: 0,
+	class: "rs-calendar-grid__week-num"
+};
+var _hoisted_13 = [
+	"data-iso",
+	"disabled",
+	"tabindex",
+	"aria-selected",
+	"aria-current",
+	"aria-label",
+	"onClick"
+];
 var RsCalendarGrid_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsCalendarGrid",
 	__name: "RsCalendarGrid",
 	props: /*@__PURE__*/ mergeModels({
 		selected: { default: null },
@@ -22,7 +50,33 @@ var RsCalendarGrid_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ d
 		rangeEnd: { default: null },
 		minDate: {},
 		maxDate: {},
-		disabledDates: { default: () => [] }
+		disabledDates: { default: () => [] },
+		disabledDate: {},
+		weekStartsOn: {},
+		size: {},
+		radius: {},
+		disabled: {
+			type: Boolean,
+			default: false
+		},
+		highlightToday: {
+			type: Boolean,
+			default: true
+		},
+		showOutside: {
+			type: Boolean,
+			default: true
+		},
+		selectOutside: {
+			type: Boolean,
+			default: true
+		},
+		showWeekNumbers: {
+			type: Boolean,
+			default: false
+		},
+		ariaLabel: {},
+		id: {}
 	}, {
 		"viewYear": { required: true },
 		"viewYearModifiers": {},
@@ -30,151 +84,268 @@ var RsCalendarGrid_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ d
 		"viewMonthModifiers": {}
 	}),
 	emits: /*@__PURE__*/ mergeModels(["select"], ["update:viewYear", "update:viewMonth"]),
-	setup(__props, { emit: __emit }) {
+	setup(__props, { expose: __expose, emit: __emit }) {
 		const viewYear = useModel(__props, "viewYear");
 		const viewMonth = useModel(__props, "viewMonth");
 		const props = __props;
 		const emit = __emit;
 		const { t, locale } = useRsI18n();
+		const config = useRsConfigOptional();
+		const form = useRsFormContext();
+		const resolvedSize = useResolvedRsComponentSize(() => props.size);
+		const resolvedRadius = useResolvedRsRadius(() => props.radius, "sm");
+		const rootRef = ref(null);
+		const focused = ref(resolveFocusedDate(viewYear.value, viewMonth.value, props.selected));
+		const resolvedDisabled = computed(() => props.disabled || form?.disabled.value === true);
+		const writingDir = computed(() => resolveDirMode(config?.dir.value ?? "auto", locale.value));
+		const resolvedWeekStartsOn = computed(() => resolveWeekStartsOn(locale.value, props.weekStartsOn));
+		const navIconSize = computed(() => RS_COMPONENT_SIZE_ICON_PX[resolvedSize.value]);
+		const disabledDateSet = computed(() => toDisabledDateSet(props.disabledDates));
+		const todayDate = computed(() => props.highlightToday ? getTodayDate() : null);
 		const weekdayLabels = computed(() => {
 			const formatter = new Intl.DateTimeFormat(locale.value, { weekday: "short" });
-			const monday = new Date(2024, 0, 1);
+			const sunday = new Date(2024, 0, 7);
 			return Array.from({ length: 7 }, (_, index) => {
-				const date = new Date(monday);
-				date.setDate(monday.getDate() + index);
+				const date = new Date(sunday);
+				date.setDate(sunday.getDate() + (resolvedWeekStartsOn.value + index) % 7);
 				return formatter.format(date);
 			});
 		});
-		const monthLabel = computed(() => new Intl.DateTimeFormat(locale.value, {
+		const monthFormatter = computed(() => new Intl.DateTimeFormat(locale.value, {
 			year: "numeric",
 			month: "long"
-		}).format(new Date(viewYear.value, viewMonth.value - 1, 1)));
-		const cells = computed(() => buildCalendarGrid(viewYear.value, viewMonth.value));
-		const weeks = computed(() => {
-			const rows = [];
-			for (let index = 0; index < cells.value.length; index += 7) rows.push(cells.value.slice(index, index + 7));
-			return rows;
+		}));
+		const monthLabel = computed(() => monthFormatter.value.format(new Date(viewYear.value, viewMonth.value - 1, 1)));
+		const cellAriaFormatter = computed(() => new Intl.DateTimeFormat(locale.value, { dateStyle: "full" }));
+		const cellViews = computed(() => {
+			return buildCalendarGrid(viewYear.value, viewMonth.value, resolvedWeekStartsOn.value).map((cell) => ({
+				cell,
+				state: resolveCalendarCellState(cell, {
+					selected: props.selected,
+					rangeStart: props.rangeStart,
+					rangeEnd: props.rangeEnd,
+					today: todayDate.value,
+					disabledDates: disabledDateSet.value,
+					disabledDate: props.disabledDate,
+					minDate: props.minDate,
+					maxDate: props.maxDate,
+					gridDisabled: resolvedDisabled.value
+				})
+			}));
 		});
+		const weeks = computed(() => chunkCalendarWeeks(cellViews.value).map((days) => ({
+			days,
+			weekNumber: weekNumberOfRow(days, resolvedWeekStartsOn.value)
+		})));
+		const gridLabel = computed(() => props.ariaLabel || t("calendarGrid.label"));
+		const rootStyle = computed(() => ({ "--rs-calendar-grid-radius": rsRadiusCss(resolvedRadius.value) }));
+		function cellAriaLabel(date) {
+			return cellAriaFormatter.value.format(new Date(date.year, date.month - 1, date.day));
+		}
+		function cellSlotProps(view, weekNumber) {
+			return {
+				date: {
+					year: view.cell.year,
+					month: view.cell.month,
+					day: view.cell.day
+				},
+				iso: view.state.iso,
+				inCurrentMonth: view.cell.inCurrentMonth,
+				selected: view.state.selected,
+				disabled: view.state.disabled,
+				today: view.state.today,
+				inRange: view.state.inRange,
+				rangeStart: view.state.rangeStart,
+				rangeEnd: view.state.rangeEnd,
+				weekNumber
+			};
+		}
+		function isCellInteractive(inCurrentMonth, disabled) {
+			if (disabled) return false;
+			if (!inCurrentMonth && !props.showOutside) return false;
+			if (!inCurrentMonth && !props.selectOutside) return false;
+			return true;
+		}
+		function isCellTabbable(date, inCurrentMonth) {
+			if (!props.showOutside && !inCurrentMonth) return false;
+			return isSameDate(focused.value, date);
+		}
+		function applyView(next) {
+			if (next.year !== viewYear.value) viewYear.value = next.year;
+			if (next.month !== viewMonth.value) viewMonth.value = next.month;
+			focused.value = next;
+		}
+		function focusCell(date) {
+			const iso = `${String(date.year).padStart(4, "0")}-${String(date.month).padStart(2, "0")}-${String(date.day).padStart(2, "0")}`;
+			(rootRef.value?.querySelector(`[data-iso="${iso}"]`))?.focus();
+		}
 		function goPrevYear() {
-			viewYear.value -= 1;
+			if (resolvedDisabled.value) return;
+			applyView(addCalendarMonths({
+				year: viewYear.value,
+				month: viewMonth.value,
+				day: focused.value.day
+			}, -12));
 		}
 		function goNextYear() {
-			viewYear.value += 1;
+			if (resolvedDisabled.value) return;
+			applyView(addCalendarMonths({
+				year: viewYear.value,
+				month: viewMonth.value,
+				day: focused.value.day
+			}, 12));
 		}
 		function goPrevMonth() {
-			if (viewMonth.value === 1) {
-				viewYear.value -= 1;
-				viewMonth.value = 12;
-				return;
-			}
-			viewMonth.value -= 1;
+			if (resolvedDisabled.value) return;
+			applyView(addCalendarMonths({
+				year: viewYear.value,
+				month: viewMonth.value,
+				day: focused.value.day
+			}, -1));
 		}
 		function goNextMonth() {
-			if (viewMonth.value === 12) {
-				viewYear.value += 1;
-				viewMonth.value = 1;
-				return;
-			}
-			viewMonth.value += 1;
+			if (resolvedDisabled.value) return;
+			applyView(addCalendarMonths({
+				year: viewYear.value,
+				month: viewMonth.value,
+				day: focused.value.day
+			}, 1));
 		}
-		function isSelected(cell) {
-			return props.selected ? isSameDate(props.selected, cell) : false;
-		}
-		function isRangeStart(cell) {
-			return props.rangeStart ? isSameDate(props.rangeStart, cell) : false;
+		function selectDate(date, inCurrentMonth, disabled) {
+			if (!isCellInteractive(inCurrentMonth, disabled)) return;
+			focused.value = date;
+			emit("select", {
+				year: date.year,
+				month: date.month,
+				day: date.day
+			});
 		}
-		function isRangeEnd(cell) {
-			return props.rangeEnd ? isSameDate(props.rangeEnd, cell) : false;
+		function moveFocus(next) {
+			applyView(next);
+			nextTick(() => focusCell(next));
 		}
-		function isInRange(cell) {
-			if (!props.rangeStart || !props.rangeEnd) return false;
-			return isDateBetweenParsed(cell, props.rangeStart, props.rangeEnd);
+		function selectFocusedDate() {
+			const view = cellViews.value.find((item) => isSameDate(item.cell, focused.value));
+			if (view) selectDate(view.cell, view.cell.inCurrentMonth, view.state.disabled);
 		}
-		function isDisabled(cell) {
-			const iso = formatDateParts(cell);
-			if (props.disabledDates.includes(iso)) return true;
-			return !isDateWithinBounds(cell.year, cell.month, cell.day, {
-				minDate: props.minDate,
-				maxDate: props.maxDate
+		function onGridKeydown(event) {
+			if (resolvedDisabled.value) return;
+			if (event.key === "Enter" || event.key === " ") {
+				event.preventDefault();
+				selectFocusedDate();
+				return;
+			}
+			const next = resolveKeyboardMove(focused.value, event.key, {
+				weekStartsOn: resolvedWeekStartsOn.value,
+				rtl: writingDir.value === "rtl",
+				shiftKey: event.shiftKey
 			});
+			if (!next) return;
+			event.preventDefault();
+			moveFocus(next);
 		}
-		function cellClass(cell) {
-			const endpoint = isRangeStart(cell) || isRangeEnd(cell);
-			const inRange = isInRange(cell);
-			const selected = isSelected(cell);
-			return {
-				"rs-calendar-grid__cell--outside": !cell.inCurrentMonth,
-				"rs-calendar-grid__cell--selected": selected,
-				"rs-calendar-grid__cell--range-start": isRangeStart(cell),
-				"rs-calendar-grid__cell--range-end": isRangeEnd(cell),
-				"rs-calendar-grid__cell--in-range": inRange && !endpoint,
-				"rs-calendar-grid__cell--endpoint": endpoint || selected
-			};
+		function focus() {
+			if (resolvedDisabled.value) return;
+			if (!sameYearMonth(focused.value, viewYear.value, viewMonth.value)) focused.value = resolveFocusedDate(viewYear.value, viewMonth.value, props.selected);
+			nextTick(() => focusCell(focused.value));
 		}
-		function selectDate(cell) {
-			if (isDisabled(cell)) return;
-			emit("select", {
-				year: cell.year,
-				month: cell.month,
-				day: cell.day
-			});
+		function goToToday() {
+			if (resolvedDisabled.value) return;
+			const today = getTodayDate();
+			applyView(today);
+			nextTick(() => focusCell(today));
 		}
+		watch(() => [
+			viewYear.value,
+			viewMonth.value,
+			props.selected
+		], () => {
+			if (!sameYearMonth(focused.value, viewYear.value, viewMonth.value)) focused.value = resolveFocusedDate(viewYear.value, viewMonth.value, props.selected);
+		});
+		__expose({
+			focus,
+			goToToday
+		});
 		return (_ctx, _cache) => {
-			return openBlock(), createElementBlock("div", _hoisted_1, [createElementVNode("div", _hoisted_2, [
+			return openBlock(), createElementBlock("div", {
+				id: __props.id,
+				ref_key: "rootRef",
+				ref: rootRef,
+				class: normalizeClass(["rs-calendar-grid", [`rs-calendar-grid--${unref(resolvedSize)}`, { "rs-calendar-grid--disabled": resolvedDisabled.value }]]),
+				style: normalizeStyle(rootStyle.value)
+			}, [createElementVNode("div", _hoisted_2, [
 				createElementVNode("div", _hoisted_3, [createElementVNode("button", {
 					type: "button",
 					class: "rs-calendar-grid__nav rs-calendar-grid__nav--prev-year",
-					"aria-label": unref(t)("datePicker.prevYear"),
+					"aria-label": unref(t)("calendarGrid.prevYear"),
+					disabled: resolvedDisabled.value,
 					onClick: goPrevYear
 				}, [createVNode(RsIcon_default, {
 					name: "chevrons-left",
-					size: 16
-				})], 8, _hoisted_4), createElementVNode("button", {
+					size: navIconSize.value
+				}, null, 8, ["size"])], 8, _hoisted_4), createElementVNode("button", {
 					type: "button",
 					class: "rs-calendar-grid__nav rs-calendar-grid__nav--prev-month",
-					"aria-label": unref(t)("datePicker.prevMonth"),
+					"aria-label": unref(t)("calendarGrid.prevMonth"),
+					disabled: resolvedDisabled.value,
 					onClick: goPrevMonth
 				}, [createVNode(RsIcon_default, {
 					name: "chevron-left",
-					size: 16
-				})], 8, _hoisted_5)]),
-				createElementVNode("span", _hoisted_6, toDisplayString(monthLabel.value), 1),
+					size: navIconSize.value
+				}, null, 8, ["size"])], 8, _hoisted_5)]),
+				createElementVNode("span", _hoisted_6, [renderSlot(_ctx.$slots, "title", {
+					year: viewYear.value,
+					month: viewMonth.value,
+					label: monthLabel.value
+				}, () => [createTextVNode(toDisplayString(monthLabel.value), 1)], true)]),
 				createElementVNode("div", _hoisted_7, [createElementVNode("button", {
 					type: "button",
 					class: "rs-calendar-grid__nav rs-calendar-grid__nav--next-month",
-					"aria-label": unref(t)("datePicker.nextMonth"),
+					"aria-label": unref(t)("calendarGrid.nextMonth"),
+					disabled: resolvedDisabled.value,
 					onClick: goNextMonth
 				}, [createVNode(RsIcon_default, {
 					name: "chevron-right",
-					size: 16
-				})], 8, _hoisted_8), createElementVNode("button", {
+					size: navIconSize.value
+				}, null, 8, ["size"])], 8, _hoisted_8), createElementVNode("button", {
 					type: "button",
 					class: "rs-calendar-grid__nav rs-calendar-grid__nav--next-year",
-					"aria-label": unref(t)("datePicker.nextYear"),
+					"aria-label": unref(t)("calendarGrid.nextYear"),
+					disabled: resolvedDisabled.value,
 					onClick: goNextYear
 				}, [createVNode(RsIcon_default, {
 					name: "chevrons-right",
-					size: 16
-				})], 8, _hoisted_9)])
-			]), createElementVNode("table", _hoisted_10, [createElementVNode("thead", null, [createElementVNode("tr", null, [(openBlock(true), createElementBlock(Fragment, null, renderList(weekdayLabels.value, (label, index) => {
+					size: navIconSize.value
+				}, null, 8, ["size"])], 8, _hoisted_9)])
+			]), createElementVNode("table", {
+				class: "rs-calendar-grid__table",
+				"aria-label": gridLabel.value,
+				onKeydown: onGridKeydown
+			}, [createElementVNode("thead", null, [createElementVNode("tr", null, [__props.showWeekNumbers ? (openBlock(), createElementBlock("th", _hoisted_11, toDisplayString(unref(t)("calendarGrid.week")), 1)) : createCommentVNode("", true), (openBlock(true), createElementBlock(Fragment, null, renderList(weekdayLabels.value, (label, index) => {
 				return openBlock(), createElementBlock("th", {
 					key: index,
 					scope: "col",
 					class: "rs-calendar-grid__weekday"
 				}, toDisplayString(label), 1);
 			}), 128))])]), createElementVNode("tbody", null, [(openBlock(true), createElementBlock(Fragment, null, renderList(weeks.value, (week, weekIndex) => {
-				return openBlock(), createElementBlock("tr", { key: weekIndex }, [(openBlock(true), createElementBlock(Fragment, null, renderList(week, (cell) => {
+				return openBlock(), createElementBlock("tr", { key: weekIndex }, [__props.showWeekNumbers ? (openBlock(), createElementBlock("td", _hoisted_12, toDisplayString(week.weekNumber), 1)) : createCommentVNode("", true), (openBlock(true), createElementBlock(Fragment, null, renderList(week.days, (view) => {
 					return openBlock(), createElementBlock("td", {
-						key: unref(formatDateParts)(cell),
+						key: view.state.iso,
 						class: "rs-calendar-grid__day"
-					}, [createElementVNode("button", {
+					}, [view.cell.inCurrentMonth || __props.showOutside ? (openBlock(), createElementBlock("button", {
+						key: 0,
 						type: "button",
-						class: normalizeClass(["rs-calendar-grid__cell", cellClass(cell)]),
-						disabled: isDisabled(cell),
-						onClick: ($event) => selectDate(cell)
-					}, toDisplayString(cell.day), 11, _hoisted_11)]);
+						class: normalizeClass(["rs-calendar-grid__cell", unref(calendarCellClass)(view.state, view.cell.inCurrentMonth)]),
+						"data-iso": view.state.iso,
+						disabled: view.state.disabled || !view.cell.inCurrentMonth && !__props.selectOutside,
+						tabindex: isCellTabbable(view.cell, view.cell.inCurrentMonth) ? 0 : -1,
+						"aria-selected": view.state.selected || view.state.rangeStart || view.state.rangeEnd,
+						"aria-current": view.state.today ? "date" : void 0,
+						"aria-label": cellAriaLabel(view.cell),
+						onClick: ($event) => selectDate(view.cell, view.cell.inCurrentMonth, view.state.disabled)
+					}, [renderSlot(_ctx.$slots, "cell", mergeProps({ ref_for: true }, cellSlotProps(view, week.weekNumber)), () => [createTextVNode(toDisplayString(view.cell.day), 1)], true)], 10, _hoisted_13)) : createCommentVNode("", true)]);
 				}), 128))]);
-			}), 128))])])]);
+			}), 128))])], 40, _hoisted_10)], 14, _hoisted_1);
 		};
 	}
 });

package/dist/components/calendar-grid/src/RsCalendarGrid.js

@@ -3,6 +3,6 @@ import _plugin_vue_export_helper_default from "../../../_virtual/_plugin-vue_exp
 import RsCalendarGrid_vue_vue_type_script_setup_true_lang_default from "./RsCalendarGrid.impl.js";
 
 //#region src/components/calendar-grid/src/RsCalendarGrid.vue
-var RsCalendarGrid_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsCalendarGrid_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-35786efd"]]);
+var RsCalendarGrid_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsCalendarGrid_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-e9d29258"]]);
 //#endregion
 export { RsCalendarGrid_default as default };

package/dist/components/calendar-grid/src/calendar-grid-utils.d.ts

@@ -0,0 +1,72 @@
+import { type RsCalendarCell, type RsDatePickerDisabledDate, type RsParsedDate, type RsWeekStartsOn } from '../../date-picker/src/date-picker-utils';
+export type { RsCalendarCell, RsDatePickerDisabledDate, RsParsedDate, RsWeekStartsOn, };
+/** `#cell` 插槽载荷。墙钟年月日，不是 Date。 */
+export interface RsCalendarGridCellSlot {
+    date: RsParsedDate;
+    iso: string;
+    inCurrentMonth: boolean;
+    selected: boolean;
+    disabled: boolean;
+    today: boolean;
+    inRange: boolean;
+    rangeStart: boolean;
+    rangeEnd: boolean;
+    weekNumber: number;
+}
+export interface RsCalendarCellState {
+    iso: string;
+    selected: boolean;
+    rangeStart: boolean;
+    rangeEnd: boolean;
+    inRange: boolean;
+    endpoint: boolean;
+    today: boolean;
+    disabled: boolean;
+}
+export interface RsCalendarCellView {
+    cell: RsCalendarCell;
+    state: RsCalendarCellState;
+}
+export interface RsCalendarWeekView {
+    days: RsCalendarCellView[];
+    weekNumber: number;
+}
+export declare function toDisabledDateSet(dates: readonly string[] | undefined): Set<string>;
+export declare function isCalendarCellDisabled(cell: RsParsedDate, options: {
+    disabledDates: ReadonlySet<string>;
+    disabledDate?: RsDatePickerDisabledDate;
+    minDate?: string;
+    maxDate?: string;
+}): boolean;
+export declare function resolveCalendarCellState(cell: RsCalendarCell, options: {
+    selected?: RsParsedDate | null;
+    rangeStart?: RsParsedDate | null;
+    rangeEnd?: RsParsedDate | null;
+    today?: RsParsedDate | null;
+    disabledDates: ReadonlySet<string>;
+    disabledDate?: RsDatePickerDisabledDate;
+    minDate?: string;
+    maxDate?: string;
+    gridDisabled?: boolean;
+}): RsCalendarCellState;
+export declare function calendarCellClass(state: RsCalendarCellState, inCurrentMonth: boolean): Record<string, boolean>;
+export declare function shiftViewMonth(year: number, month: number, delta: number): {
+    year: number;
+    month: number;
+};
+export declare function shiftViewYear(year: number, delta: number): number;
+export declare function addCalendarDays(date: RsParsedDate, days: number): RsParsedDate;
+export declare function addCalendarMonths(date: RsParsedDate, months: number): RsParsedDate;
+export declare function startOfCalendarWeek(date: RsParsedDate, weekStartsOn: RsWeekStartsOn): RsParsedDate;
+export declare function endOfCalendarWeek(date: RsParsedDate, weekStartsOn: RsWeekStartsOn): RsParsedDate;
+/** ISO-8601 周序号（周四所在年）。不引入 dayjs isoWeek 插件。 */
+export declare function isoWeekOf(date: RsParsedDate): number;
+export declare function weekNumberOfRow(days: readonly RsCalendarCellView[], weekStartsOn: RsWeekStartsOn): number;
+export declare function chunkCalendarWeeks(cells: readonly RsCalendarCellView[]): RsCalendarCellView[][];
+export declare function resolveKeyboardMove(focused: RsParsedDate, key: string, options: {
+    weekStartsOn: RsWeekStartsOn;
+    rtl: boolean;
+    shiftKey: boolean;
+}): RsParsedDate | null;
+export declare function resolveFocusedDate(viewYear: number, viewMonth: number, selected?: RsParsedDate | null): RsParsedDate;
+export declare function sameYearMonth(date: RsParsedDate, year: number, month: number): boolean;

package/dist/components/calendar-grid/src/calendar-grid-utils.js

@@ -0,0 +1,122 @@
+import { dayjs } from "../../../utils/rs-dayjs.js";
+import { formatDateParts, getTodayDate, isDateBetweenParsed, isDateWithinBounds, isSameDate } from "../../date-picker/src/date-picker-utils.js";
+//#region src/components/calendar-grid/src/calendar-grid-utils.ts
+function toDisabledDateSet(dates) {
+	return new Set(dates ?? []);
+}
+function isCalendarCellDisabled(cell, options) {
+	const iso = formatDateParts(cell);
+	if (options.disabledDates.has(iso)) return true;
+	if (options.disabledDate?.({
+		year: cell.year,
+		month: cell.month,
+		day: cell.day
+	})) return true;
+	return !isDateWithinBounds(cell.year, cell.month, cell.day, {
+		minDate: options.minDate,
+		maxDate: options.maxDate
+	});
+}
+function resolveCalendarCellState(cell, options) {
+	const selected = options.selected ? isSameDate(options.selected, cell) : false;
+	const rangeStart = options.rangeStart ? isSameDate(options.rangeStart, cell) : false;
+	const rangeEnd = options.rangeEnd ? isSameDate(options.rangeEnd, cell) : false;
+	const inRange = Boolean(options.rangeStart && options.rangeEnd && isDateBetweenParsed(cell, options.rangeStart, options.rangeEnd));
+	const endpoint = rangeStart || rangeEnd || selected;
+	return {
+		iso: formatDateParts(cell),
+		selected,
+		rangeStart,
+		rangeEnd,
+		inRange: inRange && !endpoint,
+		endpoint,
+		today: options.today ? isSameDate(options.today, cell) : false,
+		disabled: options.gridDisabled === true || isCalendarCellDisabled(cell, options)
+	};
+}
+function calendarCellClass(state, inCurrentMonth) {
+	return {
+		"rs-calendar-grid__cell--outside": !inCurrentMonth,
+		"rs-calendar-grid__cell--selected": state.selected,
+		"rs-calendar-grid__cell--range-start": state.rangeStart,
+		"rs-calendar-grid__cell--range-end": state.rangeEnd,
+		"rs-calendar-grid__cell--in-range": state.inRange,
+		"rs-calendar-grid__cell--endpoint": state.endpoint,
+		"rs-calendar-grid__cell--today": state.today
+	};
+}
+function addCalendarDays(date, days) {
+	const next = dayjs().year(date.year).month(date.month - 1).date(date.day).add(days, "day");
+	return {
+		year: next.year(),
+		month: next.month() + 1,
+		day: next.date()
+	};
+}
+function addCalendarMonths(date, months) {
+	const nextMonth = dayjs().year(date.year).month(date.month - 1).date(1).add(months, "month");
+	const maxDay = nextMonth.daysInMonth();
+	return {
+		year: nextMonth.year(),
+		month: nextMonth.month() + 1,
+		day: Math.min(date.day, maxDay)
+	};
+}
+function startOfCalendarWeek(date, weekStartsOn) {
+	return addCalendarDays(date, -((dayjs().year(date.year).month(date.month - 1).date(date.day).day() - weekStartsOn + 7) % 7));
+}
+function endOfCalendarWeek(date, weekStartsOn) {
+	return addCalendarDays(startOfCalendarWeek(date, weekStartsOn), 6);
+}
+/** ISO-8601 周序号（周四所在年）。不引入 dayjs isoWeek 插件。 */
+function isoWeekOf(date) {
+	const current = dayjs().year(date.year).month(date.month - 1).date(date.day);
+	const weekday = current.day() || 7;
+	const thursday = current.add(4 - weekday, "day");
+	const jan1 = dayjs().year(thursday.year()).month(0).date(1);
+	return Math.ceil((thursday.diff(jan1, "day") + 1) / 7);
+}
+function weekNumberOfRow(days, weekStartsOn) {
+	const pivot = days[(4 - weekStartsOn + 7) % 7]?.cell ?? days[0]?.cell;
+	return pivot ? isoWeekOf(pivot) : 0;
+}
+function chunkCalendarWeeks(cells) {
+	const rows = [];
+	for (let index = 0; index < cells.length; index += 7) rows.push(cells.slice(index, index + 7));
+	return rows;
+}
+function arrowDayDelta(key, rtl) {
+	if (key === "ArrowLeft") return rtl ? 1 : -1;
+	if (key === "ArrowRight") return rtl ? -1 : 1;
+	if (key === "ArrowUp") return -7;
+	if (key === "ArrowDown") return 7;
+	return null;
+}
+function resolveKeyboardMove(focused, key, options) {
+	const days = arrowDayDelta(key, options.rtl);
+	if (days != null) return addCalendarDays(focused, days);
+	if (key === "Home") return startOfCalendarWeek(focused, options.weekStartsOn);
+	if (key === "End") return endOfCalendarWeek(focused, options.weekStartsOn);
+	if (key === "PageUp") return addCalendarMonths(focused, options.shiftKey ? -12 : -1);
+	if (key === "PageDown") return addCalendarMonths(focused, options.shiftKey ? 12 : 1);
+	return null;
+}
+function resolveFocusedDate(viewYear, viewMonth, selected) {
+	if (selected?.year === viewYear && selected.month === viewMonth) return {
+		year: selected.year,
+		month: selected.month,
+		day: selected.day
+	};
+	const today = getTodayDate();
+	if (today.year === viewYear && today.month === viewMonth) return today;
+	return {
+		year: viewYear,
+		month: viewMonth,
+		day: 1
+	};
+}
+function sameYearMonth(date, year, month) {
+	return date.year === year && date.month === month;
+}
+//#endregion
+export { addCalendarDays, addCalendarMonths, calendarCellClass, chunkCalendarWeeks, endOfCalendarWeek, isCalendarCellDisabled, isoWeekOf, resolveCalendarCellState, resolveFocusedDate, resolveKeyboardMove, sameYearMonth, startOfCalendarWeek, toDisabledDateSet, weekNumberOfRow };

package/dist/components/card/index.d.ts

@@ -1,2 +1,2 @@
 export { default as RsCard } from './src/RsCard.js';
-export type { RsCardSize, RsCardVariant } from './src/RsCard.js';
+export type { RsCardSize, RsCardVariant } from './src/card-utils';