@zerodep-dev/vue-tsx-pro-ui 0.0.0-stage → 0.1.0

package/dist/utils/data/date.js

@@ -0,0 +1,409 @@
+import { CalendarDate, DateFormatter, GregorianCalendar, Time, createCalendar, endOfMonth, getDayOfWeek, getLocalTimeZone, parseDate, parseDateTime, parseTime, startOfMonth, startOfWeek, toCalendar, today } from "@internationalized/date";
+//#region src/utils/data/date.ts
+/**
+* 日期运算（不含界面）：ISO 字符串互转、月份网格、星期名与月份名、可选范围、区间、周数、快捷区间。
+* Calendar、DateField、各种日期选择器共用；运算交给 @internationalized/date（时区、地区的周起始日、非公历）。
+*
+* 组件对外的值是 ISO 8601 字符串（'2026-10-20'、'14:30'、'2026-10-20T14:30'），与原生 input、URL 参数、
+* zod 的 z.iso.date() 一致；组件内部换成 CalendarDate 等对象运算。月份名、星期名一律取自 Intl。
+* 出错的约定：parseXxx 解析不了时返回 null（输入框里的半截内容是常态）；shiftIsoDate、daysBetween 这类运算
+* 要求合法的 ISO 字符串，不合法时抛 RangeError 并带上原值（多半是调用方的数据错了，不该悄悄算出别的日子）。
+*
+*   monthGrid(new CalendarDate(2026, 10, 1), { locale: 'zh-CN' })  → 6 行 × 7 天，补齐上下月
+*   weekdayNames('en-US', { format: 'short' })                      → ['Sun', 'Mon', …]
+*/
+/** 'YYYY-MM-DD' → CalendarDate（公历）；空值或格式不对时为 null */
+function parseIsoDate(value) {
+	return tryParse(value, parseDate);
+}
+/** 'HH:mm' 或 'HH:mm:ss' → Time；空值或格式不对时为 null */
+function parseIsoTime(value) {
+	return tryParse(value, parseTime);
+}
+/**
+* 补成完整的 ISO 日期（这一段的第一天）：'2026' 与 '2026-10' 补成 1 日，'2026-Q4' 是 10 月 1 日，
+* '2026-W43' 是那一周的周一，日期时间取日期部分（DateField、各种日期选择器的粒度）
+*/
+function fullIsoDay(iso) {
+	const period = parsePeriod(iso);
+	if (period) return period.start.toString();
+	return iso.length === 4 ? `${iso}-01-01` : iso.length === 7 ? `${iso}-01` : iso.slice(0, 10);
+}
+/** 这一段的最后一天：'2026' 是 12 月 31 日，'2026-10' 是 31 日，'2026-Q4' 是 12 月 31 日，'2026-W43' 是那周的周日 */
+function lastIsoDay(iso) {
+	const period = parsePeriod(iso);
+	if (period) return period.end.toString();
+	if (iso.length === 4) return `${iso}-12-31`;
+	if (iso.length === 7) return endOfMonth(parseDate(`${iso}-01`)).toString();
+	return iso.slice(0, 10);
+}
+var QUARTER_PATTERN = /^(\d{4})-Q([1-4])$/;
+var WEEK_PATTERN = /^(\d{4})-W(\d{2})$/;
+/** 日期所在的季度：'2026-Q4' */
+function toIsoQuarter(date) {
+	const gregorian = toCalendar(date, GREGORIAN);
+	return `${String(gregorian.year).padStart(4, "0")}-Q${Math.ceil(gregorian.month / 3)}`;
+}
+/** ISO 8601 的周（周一开始，含 1 月 4 日的那周是第 1 周，跨年的周归周四所在的年）：所属的年与第几周 */
+function isoWeekOf(date) {
+	const gregorian = toCalendar(date, GREGORIAN);
+	const day = new CalendarDate(gregorian.year, gregorian.month, gregorian.day);
+	const thursday = day.add({ days: 4 - isoWeekday(day) });
+	return {
+		year: thursday.year,
+		week: Math.floor(thursday.compare(new CalendarDate(thursday.year, 1, 1)) / 7) + 1
+	};
+}
+/** 日期所在的 ISO 周：'2026-W43'（同原生 input type="week"） */
+function toIsoWeek(date) {
+	const { year, week } = isoWeekOf(date);
+	return `${String(year).padStart(4, "0")}-W${String(week).padStart(2, "0")}`;
+}
+/** 一年有几个 ISO 周（52 或 53）：12 月 28 日总在最后一周里 */
+var isoWeeksInYear = (year) => isoWeekOf(new CalendarDate(year, 12, 28)).week;
+/** 周一是 1、周日是 7（与地区无关） */
+function isoWeekday(date) {
+	return date.toDate("UTC").getUTCDay() || 7;
+}
+/** '2026-Q4'、'2026-W43' → 这一段的第一天与最后一天；不是季度、周的形式时 null */
+function parsePeriod(iso) {
+	const quarter = QUARTER_PATTERN.exec(iso);
+	if (quarter) {
+		const start = new CalendarDate(Number(quarter[1]), Number(quarter[2]) * 3 - 2, 1);
+		return {
+			start,
+			end: endOfMonth(start.add({ months: 2 }))
+		};
+	}
+	const week = WEEK_PATTERN.exec(iso);
+	if (week) {
+		const january4 = new CalendarDate(Number(week[1]), 1, 4);
+		const start = january4.add({ days: 1 - isoWeekday(january4) + (Number(week[2]) - 1) * 7 });
+		return {
+			start,
+			end: start.add({ days: 6 })
+		};
+	}
+	return null;
+}
+/** 'YYYY-MM-DDTHH:mm[:ss]' → CalendarDateTime（公历）；空值或格式不对时为 null */
+function parseIsoDateTime(value) {
+	return tryParse(value, parseDateTime);
+}
+/** 日期 → 'YYYY-MM-DD'；不是公历的日期先换回公历 */
+function toIsoDate(date) {
+	const gregorian = toCalendar(date, GREGORIAN);
+	return new CalendarDate(gregorian.year, gregorian.month, gregorian.day).toString();
+}
+/** 时间 → 'HH:mm'；withSeconds 时 'HH:mm:ss'（同原生 input type="time"） */
+function toIsoTime(time, withSeconds = false) {
+	const text = new Time(time.hour, time.minute, withSeconds ? time.second : 0).toString();
+	return withSeconds ? text : text.slice(0, 5);
+}
+/** 日期时间 → 'YYYY-MM-DDTHH:mm'；withSeconds 时带秒（同原生 input type="datetime-local"） */
+function toIsoDateTime(value, withSeconds = false) {
+	const gregorian = toCalendar(value, GREGORIAN);
+	return `${toIsoDate(gregorian)}T${toIsoTime(new Time(gregorian.hour, gregorian.minute, gregorian.second), withSeconds)}`;
+}
+/** 今天的 ISO 日期，按时区（不写时取浏览器的）：`todayIso()` → '2026-10-20' */
+function todayIso(timeZone = getLocalTimeZone()) {
+	return today(timeZone).toString();
+}
+/** ISO 日期加减（月末自动夹到下个月的最后一天）：`shiftIsoDate('2026-01-31', { months: 1 })` → '2026-02-28' */
+function shiftIsoDate(value, duration) {
+	const date = parseIsoDate(value);
+	if (!date) throw new RangeError(`不是 ISO 日期：${value}`);
+	return date.add(duration).toString();
+}
+/** 从 a 到 b 相隔几天（b 在后为正）：`daysBetween('2026-10-20', '2026-10-23')` → 3 */
+function daysBetween(a, b) {
+	const start = parseIsoDate(a);
+	const end = parseIsoDate(b);
+	if (!start || !end) throw new RangeError(`不是 ISO 日期：${start ? b : a}`);
+	return end.compare(start);
+}
+/**
+* ISO 日期是星期几：0 周日 … 6 周六（同 Date#getDay）。直接按日期算，不受时区影响；
+* `new Date('2026-10-20').getDay()` 在 UTC 以西的时区会算成前一天
+*/
+function isoDayOfWeek(value) {
+	const date = parseIsoDate(value);
+	if (!date) throw new RangeError(`不是 ISO 日期：${value}`);
+	return getDayOfWeek(date, "en-US");
+}
+var GREGORIAN = new GregorianCalendar();
+/**
+* 语言里的日历标识 → 运算用的日历；@internationalized/date 不支持的（如农历 'chinese'）退回公历，
+* 月份网格仍按公历排，显示的文字照常由 Intl 按该日历格式化
+*/
+function calendarOf(identifier) {
+	if (identifier === "gregory") return GREGORIAN;
+	try {
+		return createCalendar(identifier);
+	} catch {
+		return GREGORIAN;
+	}
+}
+var DAYS_OF_WEEK = [
+	"sun",
+	"mon",
+	"tue",
+	"wed",
+	"thu",
+	"fri",
+	"sat"
+];
+/** 语言配置的一周第一天（0 表示周日）→ @internationalized/date 的写法；不写时按地区惯例 */
+function toDayOfWeek(firstDayOfWeek) {
+	return firstDayOfWeek == null ? void 0 : DAYS_OF_WEEK[(firstDayOfWeek % 7 + 7) % 7];
+}
+/** 一个月的日期网格：按周分行，首尾用上个月、下个月的日期补齐（同 React Aria 的 getDatesInWeek） */
+function monthGrid(month, { locale, firstDayOfWeek, fixedWeeks = true }) {
+	const first = startOfWeek(startOfMonth(month), locale, toDayOfWeek(firstDayOfWeek));
+	const last = endOfMonth(month);
+	const weeks = [];
+	for (let start = first; weeks.length < 6; start = start.add({ weeks: 1 })) {
+		if (!fixedWeeks && start.compare(last) > 0) break;
+		weeks.push(Array.from({ length: 7 }, (_, index) => start.add({ days: index })));
+	}
+	return weeks;
+}
+/** 按一周的排法列出七天的星期名（取自 Intl），从一周第一天开始 */
+function weekdayNames(locale, { firstDayOfWeek, format = "short" } = {}) {
+	const formatter = cachedFormatter(locale, {
+		weekday: format,
+		timeZone: "UTC"
+	});
+	const start = startOfWeek(new CalendarDate(2024, 1, 10), locale, toDayOfWeek(firstDayOfWeek));
+	return Array.from({ length: 7 }, (_, index) => formatter.format(start.add({ days: index }).toDate("UTC")));
+}
+/** 一年的各月（每月 1 日），按日期所在的日历系统（个别日历一年有 13 个月） */
+function monthsOfYear(date) {
+	const first = date.set({
+		month: 1,
+		day: 1
+	});
+	return Array.from({ length: date.calendar.getMonthsInYear(first) }, (_, index) => first.add({ months: index }));
+}
+/** 年份视图的一页：所在的十年，前后各补一年（共 12 年，排成 4 × 3；同 Ant Design 的年份面板） */
+function yearsOfDecade(date) {
+	const start = date.set({
+		year: Math.floor(date.year / 10) * 10,
+		month: 1,
+		day: 1
+	});
+	return Array.from({ length: 12 }, (_, index) => start.add({ years: index - 1 }));
+}
+/** 是不是十年之外、补上的那两年 */
+var isOutsideDecade = (year, page) => Math.floor(year.year / 10) !== Math.floor(page.year / 10);
+/**
+* 一年里的第几周：一周从周一开始时按 ISO 8601（含 1 月 4 日的那周是第 1 周），
+* 其他（周日、周六开始）按含 1 月 1 日的那周是第 1 周（美国、日本的惯例）
+*/
+function weekOfYear(date, options) {
+	const gregorian = toCalendar(date, GREGORIAN);
+	const monday = getDayOfWeek(new CalendarDate(2024, 1, 1), options.locale, toDayOfWeek(options.firstDayOfWeek)) === 0;
+	const weekStart = startOfWeek(gregorian, options.locale, toDayOfWeek(options.firstDayOfWeek));
+	const anchor = weekStart.add({ days: monday ? 3 : 6 });
+	const firstAnchor = new CalendarDate(anchor.year, 1, monday ? 4 : 1);
+	const firstWeek = startOfWeek(firstAnchor, options.locale, toDayOfWeek(options.firstDayOfWeek));
+	return Math.round(weekStart.compare(firstWeek) / 7) + 1;
+}
+/** 截到粒度：月取 1 日，年取 1 月 1 日 */
+function truncateDate(date, unit) {
+	if (unit === "day") return date;
+	return unit === "month" ? date.set({ day: 1 }) : date.set({
+		month: 1,
+		day: 1
+	});
+}
+/** 按粒度比较：小于 0 表示 a 在前；跨日历系统时按同一天比较 */
+function compareDates(a, b, unit = "day") {
+	const other = toCalendar(b, a.calendar);
+	return truncateDate(a, unit).compare(truncateDate(other, unit));
+}
+/** 是不是同一天 / 同一月 / 同一年；任一方为空时为 false */
+function isSameDate(a, b, unit = "day") {
+	return a != null && b != null && compareDates(a, b, unit) === 0;
+}
+/** 在 min–max 之外（按粒度：月份视图里只要这个月有一天可选就不算在外面） */
+function isOutOfRange(date, { min, max }, unit = "day") {
+	return min != null && compareDates(date, min, unit) < 0 || max != null && compareDates(date, max, unit) > 0;
+}
+/** 不能选：在范围外，或是不可选的日期（只在天的粒度上判断 isUnavailable） */
+function isDateDisabled(date, limits, unit = "day") {
+	return isOutOfRange(date, limits, unit) || unit === "day" && (limits.isUnavailable?.(date) ?? false);
+}
+/** 把日期夹到 min–max 之间 */
+function clampDate(date, { min, max }) {
+	if (min != null && date.compare(toCalendar(min, date.calendar)) < 0) return toCalendar(min, date.calendar);
+	if (max != null && date.compare(toCalendar(max, date.calendar)) > 0) return toCalendar(max, date.calendar);
+	return date;
+}
+/** 两个日期排成区间：先的在前 */
+function orderedRange(a, b) {
+	return a.compare(b) <= 0 ? {
+		start: a,
+		end: b
+	} : {
+		start: b,
+		end: a
+	};
+}
+/** 日期是否在区间里（含两端；按粒度） */
+function isInRange(date, range, unit = "day") {
+	return range != null && compareDates(date, range.start, unit) >= 0 && compareDates(date, range.end, unit) <= 0;
+}
+/** 区间一共几天（含两端） */
+function rangeDays({ start, end }) {
+	return end.compare(start) + 1;
+}
+/** 区间里有没有不可选的日期：酒店连住时中间不能有订满的一天（React Aria 的 allowsNonContiguousRanges 为 false 时） */
+function rangeHasUnavailable({ start, end }, isUnavailable) {
+	if (!isUnavailable) return false;
+	for (let date = start; date.compare(end) <= 0; date = date.add({ days: 1 })) if (isUnavailable(date)) return true;
+	return false;
+}
+/** ISO 字符串的区间 → CalendarDate 的区间；任一端解析不了时为 null */
+function parseIsoRange(range) {
+	const start = parseIsoDate(range?.start);
+	const end = parseIsoDate(range?.end);
+	return start && end ? orderedRange(start, end) : null;
+}
+/** CalendarDate 的区间 → ISO 字符串的区间 */
+function toIsoRange(range) {
+	return {
+		start: toIsoDate(range.start),
+		end: toIsoDate(range.end)
+	};
+}
+/** 按今天算出快捷区间 */
+function presetRange(preset, today, week) {
+	switch (preset) {
+		case "today": return {
+			start: today,
+			end: today
+		};
+		case "yesterday": {
+			const day = today.subtract({ days: 1 });
+			return {
+				start: day,
+				end: day
+			};
+		}
+		case "last7Days": return {
+			start: today.subtract({ days: 6 }),
+			end: today
+		};
+		case "last30Days": return {
+			start: today.subtract({ days: 29 }),
+			end: today
+		};
+		case "thisWeek": {
+			const start = startOfWeek(today, week.locale, toDayOfWeek(week.firstDayOfWeek));
+			return {
+				start,
+				end: start.add({ days: 6 })
+			};
+		}
+		case "thisMonth": return {
+			start: startOfMonth(today),
+			end: endOfMonth(today)
+		};
+		case "lastMonth": {
+			const month = startOfMonth(today).subtract({ months: 1 });
+			return {
+				start: month,
+				end: endOfMonth(month)
+			};
+		}
+		case "thisYear": return {
+			start: today.set({
+				month: 1,
+				day: 1
+			}),
+			end: today.set({
+				month: 12,
+				day: 31
+			})
+		};
+	}
+}
+/** 快捷区间的 ISO 值，按今天（时区，不写时取浏览器的）与一周的排法：`presetIsoRange('last7Days', { locale: 'zh-CN' })` */
+function presetIsoRange(preset, week, timeZone = getLocalTimeZone()) {
+	return toIsoRange(presetRange(preset, today(timeZone), week));
+}
+/** 带时区或 UTC 标记的 ISO 字符串（'2026-10-20T14:30:00Z'、'…+08:00'）：本身就是一个时刻 */
+var ABSOLUTE_ISO = /(?:[zZ]|[+-]\d\d:?\d\d)$/;
+/**
+* 日期值 → 时刻（毫秒时间戳）：Date 与带时区的值照原样；不带时区的（'2026-10-20T14:30'、CalendarDateTime）
+* 按 timeZone 的墙上时间算。格式不对时 NaN
+*/
+function toInstant(value, timeZone = getLocalTimeZone()) {
+	if (value instanceof Date) return value.getTime();
+	if (typeof value !== "string") return ("timeZone" in value ? value.toDate() : value.toDate(timeZone)).getTime();
+	if (ABSOLUTE_ISO.test(value)) return Date.parse(value);
+	const parsed = parseIsoDateTime(value) ?? parseIsoDate(value);
+	return parsed ? parsed.toDate(timeZone).getTime() : NaN;
+}
+/** 相对时间用的单位：多久以内用这个单位（秒），参考 moment.js 的取整阈值 */
+var RELATIVE_UNITS = [
+	[
+		"second",
+		1,
+		45
+	],
+	[
+		"minute",
+		60,
+		2700
+	],
+	[
+		"hour",
+		3600,
+		79200
+	],
+	[
+		"day",
+		86400,
+		2246400
+	],
+	[
+		"month",
+		2592e3,
+		27648e3
+	],
+	[
+		"year",
+		31536e3,
+		Infinity
+	]
+];
+/** 相差的毫秒数 → 相对时间的数值与单位：`relativeUnit(-180_000)` → `{ value: -3, unit: 'minute' }` */
+function relativeUnit(diff) {
+	const seconds = diff / 1e3;
+	const [unit, size] = RELATIVE_UNITS.find(([, , below]) => Math.abs(seconds) < below);
+	return {
+		value: Math.round(seconds / size) || 0,
+		unit
+	};
+}
+function tryParse(value, parse) {
+	if (!value) return null;
+	try {
+		return parse(value);
+	} catch {
+		return null;
+	}
+}
+var formatters = /* @__PURE__ */ new Map();
+function cachedFormatter(locale, options) {
+	const key = `${locale}|${JSON.stringify(options)}`;
+	let formatter = formatters.get(key);
+	if (!formatter) formatters.set(key, formatter = new DateFormatter(locale, options));
+	return formatter;
+}
+//#endregion
+export { calendarOf, clampDate, compareDates, daysBetween, fullIsoDay, isDateDisabled, isInRange, isOutOfRange, isOutsideDecade, isSameDate, isoDayOfWeek, isoWeekOf, isoWeeksInYear, lastIsoDay, monthGrid, monthsOfYear, orderedRange, parseIsoDate, parseIsoDateTime, parseIsoRange, parseIsoTime, presetIsoRange, presetRange, rangeDays, rangeHasUnavailable, relativeUnit, shiftIsoDate, toDayOfWeek, toInstant, toIsoDate, toIsoDateTime, toIsoQuarter, toIsoRange, toIsoTime, toIsoWeek, todayIso, truncateDate, weekOfYear, weekdayNames, yearsOfDecade };
+
+//# sourceMappingURL=date.js.map

package/dist/utils/data/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","names":[],"sources":["../../../src/utils/data/date.ts"],"sourcesContent":["/**\n * 日期运算（不含界面）：ISO 字符串互转、月份网格、星期名与月份名、可选范围、区间、周数、快捷区间。\n * Calendar、DateField、各种日期选择器共用；运算交给 @internationalized/date（时区、地区的周起始日、非公历）。\n *\n * 组件对外的值是 ISO 8601 字符串（'2026-10-20'、'14:30'、'2026-10-20T14:30'），与原生 input、URL 参数、\n * zod 的 z.iso.date() 一致；组件内部换成 CalendarDate 等对象运算。月份名、星期名一律取自 Intl。\n * 出错的约定：parseXxx 解析不了时返回 null（输入框里的半截内容是常态）；shiftIsoDate、daysBetween 这类运算\n * 要求合法的 ISO 字符串，不合法时抛 RangeError 并带上原值（多半是调用方的数据错了，不该悄悄算出别的日子）。\n *\n *   monthGrid(new CalendarDate(2026, 10, 1), { locale: 'zh-CN' })  → 6 行 × 7 天，补齐上下月\n *   weekdayNames('en-US', { format: 'short' })                      → ['Sun', 'Mon', …]\n */\nimport {\n  CalendarDate,\n  CalendarDateTime,\n  createCalendar,\n  DateFormatter,\n  endOfMonth,\n  getDayOfWeek,\n  getLocalTimeZone,\n  GregorianCalendar,\n  parseDate,\n  parseDateTime,\n  parseTime,\n  startOfMonth,\n  startOfWeek,\n  Time,\n  toCalendar,\n  today,\n  type Calendar,\n  type CalendarIdentifier,\n  type DateDuration,\n  type DateValue,\n  type DayOfWeek,\n} from '@internationalized/date';\n\n// ───────── ISO 字符串 ─────────\n\n/** 'YYYY-MM-DD' → CalendarDate（公历）；空值或格式不对时为 null */\nexport function parseIsoDate(value: string | null | undefined): CalendarDate | null {\n  return tryParse(value, parseDate);\n}\n\n/** 'HH:mm' 或 'HH:mm:ss' → Time；空值或格式不对时为 null */\nexport function parseIsoTime(value: string | null | undefined): Time | null {\n  return tryParse(value, parseTime);\n}\n\n/**\n * 补成完整的 ISO 日期（这一段的第一天）：'2026' 与 '2026-10' 补成 1 日，'2026-Q4' 是 10 月 1 日，\n * '2026-W43' 是那一周的周一，日期时间取日期部分（DateField、各种日期选择器的粒度）\n */\nexport function fullIsoDay(iso: string): string {\n  const period = parsePeriod(iso);\n  if (period) return period.start.toString();\n  return iso.length === 4 ? `${iso}-01-01` : iso.length === 7 ? `${iso}-01` : iso.slice(0, 10);\n}\n\n/** 这一段的最后一天：'2026' 是 12 月 31 日，'2026-10' 是 31 日，'2026-Q4' 是 12 月 31 日，'2026-W43' 是那周的周日 */\nexport function lastIsoDay(iso: string): string {\n  const period = parsePeriod(iso);\n  if (period) return period.end.toString();\n  if (iso.length === 4) return `${iso}-12-31`;\n  if (iso.length === 7) return endOfMonth(parseDate(`${iso}-01`)).toString();\n  return iso.slice(0, 10);\n}\n\n// ───────── 季度与 ISO 周 ─────────\n\nconst QUARTER_PATTERN = /^(\\d{4})-Q([1-4])$/;\nconst WEEK_PATTERN = /^(\\d{4})-W(\\d{2})$/;\n\n/** 日期所在的季度：'2026-Q4' */\nexport function toIsoQuarter(date: DateValue): string {\n  const gregorian = toCalendar(date, GREGORIAN);\n  return `${String(gregorian.year).padStart(4, '0')}-Q${Math.ceil(gregorian.month / 3)}`;\n}\n\n/** ISO 8601 的周（周一开始，含 1 月 4 日的那周是第 1 周，跨年的周归周四所在的年）：所属的年与第几周 */\nexport function isoWeekOf(date: DateValue): { year: number; week: number } {\n  const gregorian = toCalendar(date, GREGORIAN);\n  const day = new CalendarDate(gregorian.year, gregorian.month, gregorian.day);\n  const thursday = day.add({ days: 4 - isoWeekday(day) });\n  return {\n    year: thursday.year,\n    week: Math.floor(thursday.compare(new CalendarDate(thursday.year, 1, 1)) / 7) + 1,\n  };\n}\n\n/** 日期所在的 ISO 周：'2026-W43'（同原生 input type=\"week\"） */\nexport function toIsoWeek(date: DateValue): string {\n  const { year, week } = isoWeekOf(date);\n  return `${String(year).padStart(4, '0')}-W${String(week).padStart(2, '0')}`;\n}\n\n/** 一年有几个 ISO 周（52 或 53）：12 月 28 日总在最后一周里 */\nexport const isoWeeksInYear = (year: number): number =>\n  isoWeekOf(new CalendarDate(year, 12, 28)).week;\n\n/** 周一是 1、周日是 7（与地区无关） */\nfunction isoWeekday(date: CalendarDate): number {\n  return date.toDate('UTC').getUTCDay() || 7;\n}\n\n/** '2026-Q4'、'2026-W43' → 这一段的第一天与最后一天；不是季度、周的形式时 null */\nfunction parsePeriod(iso: string): { start: CalendarDate; end: CalendarDate } | null {\n  const quarter = QUARTER_PATTERN.exec(iso);\n  if (quarter) {\n    const start = new CalendarDate(Number(quarter[1]), Number(quarter[2]) * 3 - 2, 1);\n    return { start, end: endOfMonth(start.add({ months: 2 })) };\n  }\n  const week = WEEK_PATTERN.exec(iso);\n  if (week) {\n    const january4 = new CalendarDate(Number(week[1]), 1, 4);\n    const start = january4.add({ days: 1 - isoWeekday(january4) + (Number(week[2]) - 1) * 7 });\n    return { start, end: start.add({ days: 6 }) };\n  }\n  return null;\n}\n\n/** 'YYYY-MM-DDTHH:mm[:ss]' → CalendarDateTime（公历）；空值或格式不对时为 null */\nexport function parseIsoDateTime(value: string | null | undefined): CalendarDateTime | null {\n  return tryParse(value, parseDateTime);\n}\n\n/** 日期 → 'YYYY-MM-DD'；不是公历的日期先换回公历 */\nexport function toIsoDate(date: DateValue): string {\n  const gregorian = toCalendar(date, GREGORIAN);\n  return new CalendarDate(gregorian.year, gregorian.month, gregorian.day).toString();\n}\n\n/** 时间 → 'HH:mm'；withSeconds 时 'HH:mm:ss'（同原生 input type=\"time\"） */\nexport function toIsoTime(time: Time, withSeconds = false): string {\n  const text = new Time(time.hour, time.minute, withSeconds ? time.second : 0).toString();\n  return withSeconds ? text : text.slice(0, 5);\n}\n\n/** 日期时间 → 'YYYY-MM-DDTHH:mm'；withSeconds 时带秒（同原生 input type=\"datetime-local\"） */\nexport function toIsoDateTime(value: CalendarDateTime, withSeconds = false): string {\n  const gregorian = toCalendar(value, GREGORIAN);\n  return `${toIsoDate(gregorian)}T${toIsoTime(new Time(gregorian.hour, gregorian.minute, gregorian.second), withSeconds)}`;\n}\n\n/** 今天的 ISO 日期，按时区（不写时取浏览器的）：`todayIso()` → '2026-10-20' */\nexport function todayIso(timeZone = getLocalTimeZone()): string {\n  return today(timeZone).toString();\n}\n\n/** ISO 日期加减（月末自动夹到下个月的最后一天）：`shiftIsoDate('2026-01-31', { months: 1 })` → '2026-02-28' */\nexport function shiftIsoDate(value: string, duration: DateDuration): string {\n  const date = parseIsoDate(value);\n  if (!date) throw new RangeError(`不是 ISO 日期：${value}`);\n  return date.add(duration).toString();\n}\n\n/** 从 a 到 b 相隔几天（b 在后为正）：`daysBetween('2026-10-20', '2026-10-23')` → 3 */\nexport function daysBetween(a: string, b: string): number {\n  const start = parseIsoDate(a);\n  const end = parseIsoDate(b);\n  if (!start || !end) throw new RangeError(`不是 ISO 日期：${start ? b : a}`);\n  return end.compare(start);\n}\n\n/**\n * ISO 日期是星期几：0 周日 … 6 周六（同 Date#getDay）。直接按日期算，不受时区影响；\n * `new Date('2026-10-20').getDay()` 在 UTC 以西的时区会算成前一天\n */\nexport function isoDayOfWeek(value: string): number {\n  const date = parseIsoDate(value);\n  if (!date) throw new RangeError(`不是 ISO 日期：${value}`);\n  return getDayOfWeek(date, 'en-US');\n}\n\n// ───────── 日历系统与周 ─────────\n\nconst GREGORIAN = new GregorianCalendar();\n\n/**\n * 语言里的日历标识 → 运算用的日历；@internationalized/date 不支持的（如农历 'chinese'）退回公历，\n * 月份网格仍按公历排，显示的文字照常由 Intl 按该日历格式化\n */\nexport function calendarOf(identifier: string): Calendar {\n  if (identifier === 'gregory') return GREGORIAN;\n  try {\n    return createCalendar(identifier as CalendarIdentifier);\n  } catch {\n    return GREGORIAN;\n  }\n}\n\nconst DAYS_OF_WEEK: readonly DayOfWeek[] = ['sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat'];\n\n/** 语言配置的一周第一天（0 表示周日）→ @internationalized/date 的写法；不写时按地区惯例 */\nexport function toDayOfWeek(firstDayOfWeek: number | undefined): DayOfWeek | undefined {\n  return firstDayOfWeek == null ? undefined : DAYS_OF_WEEK[((firstDayOfWeek % 7) + 7) % 7];\n}\n\n/** 一周的排法：语言与一周第一天（0 表示周日，不写时按地区惯例） */\nexport interface WeekOptions {\n  /** BCP 47 语言标签 */\n  locale: string;\n  /** 一周的第一天，0 表示周日；不写时按地区惯例（zh-CN 周一，en-US 周日） */\n  firstDayOfWeek?: number;\n}\n\n/** monthGrid 的选项 */\nexport interface MonthGridOptions extends WeekOptions {\n  /** 总是 6 行：几个月并排、或翻页时高度不跳，默认 true */\n  fixedWeeks?: boolean;\n}\n\n/** 一个月的日期网格：按周分行，首尾用上个月、下个月的日期补齐（同 React Aria 的 getDatesInWeek） */\nexport function monthGrid(\n  month: CalendarDate,\n  { locale, firstDayOfWeek, fixedWeeks = true }: MonthGridOptions,\n): CalendarDate[][] {\n  const first = startOfWeek(startOfMonth(month), locale, toDayOfWeek(firstDayOfWeek));\n  const last = endOfMonth(month);\n  const weeks: CalendarDate[][] = [];\n  for (let start = first; weeks.length < 6; start = start.add({ weeks: 1 })) {\n    if (!fixedWeeks && start.compare(last) > 0) break;\n    weeks.push(Array.from({ length: 7 }, (_, index) => start.add({ days: index })));\n  }\n  return weeks;\n}\n\n/** 星期名的长短 */\nexport interface WeekdayFormats {\n  /** 最短：一、二 / S、M */\n  narrow: unknown;\n  /** 简写：周一 / Mon */\n  short: unknown;\n  /** 全称：星期一 / Monday */\n  long: unknown;\n}\n\n/** 按一周的排法列出七天的星期名（取自 Intl），从一周第一天开始 */\nexport function weekdayNames(\n  locale: string,\n  {\n    firstDayOfWeek,\n    format = 'short',\n  }: { firstDayOfWeek?: number; format?: keyof WeekdayFormats } = {},\n): string[] {\n  const formatter = cachedFormatter(locale, { weekday: format, timeZone: 'UTC' });\n  // 任取一周：从这周的第一天起连续七天\n  const start = startOfWeek(new CalendarDate(2024, 1, 10), locale, toDayOfWeek(firstDayOfWeek));\n  return Array.from({ length: 7 }, (_, index) =>\n    formatter.format(start.add({ days: index }).toDate('UTC')),\n  );\n}\n\n/** 一年的各月（每月 1 日），按日期所在的日历系统（个别日历一年有 13 个月） */\nexport function monthsOfYear(date: CalendarDate): CalendarDate[] {\n  const first = date.set({ month: 1, day: 1 });\n  return Array.from({ length: date.calendar.getMonthsInYear(first) }, (_, index) =>\n    first.add({ months: index }),\n  );\n}\n\n/** 年份视图的一页：所在的十年，前后各补一年（共 12 年，排成 4 × 3；同 Ant Design 的年份面板） */\nexport function yearsOfDecade(date: CalendarDate): CalendarDate[] {\n  const start = date.set({ year: Math.floor(date.year / 10) * 10, month: 1, day: 1 });\n  return Array.from({ length: 12 }, (_, index) => start.add({ years: index - 1 }));\n}\n\n/** 是不是十年之外、补上的那两年 */\nexport const isOutsideDecade = (year: CalendarDate, page: CalendarDate) =>\n  Math.floor(year.year / 10) !== Math.floor(page.year / 10);\n\n/**\n * 一年里的第几周：一周从周一开始时按 ISO 8601（含 1 月 4 日的那周是第 1 周），\n * 其他（周日、周六开始）按含 1 月 1 日的那周是第 1 周（美国、日本的惯例）\n */\nexport function weekOfYear(date: CalendarDate, options: WeekOptions): number {\n  const gregorian = toCalendar(date, GREGORIAN);\n  const monday =\n    getDayOfWeek(\n      new CalendarDate(2024, 1, 1),\n      options.locale,\n      toDayOfWeek(options.firstDayOfWeek),\n    ) === 0;\n  const weekStart = startOfWeek(gregorian, options.locale, toDayOfWeek(options.firstDayOfWeek));\n  // 一周归属的年份：ISO 按这周的周四，其他按这周的最后一天（含 1 月 1 日的周就算新年的第 1 周）\n  const anchor = weekStart.add({ days: monday ? 3 : 6 });\n  const firstAnchor = new CalendarDate(anchor.year, 1, monday ? 4 : 1);\n  const firstWeek = startOfWeek(firstAnchor, options.locale, toDayOfWeek(options.firstDayOfWeek));\n  return Math.round(weekStart.compare(firstWeek) / 7) + 1;\n}\n\n// ───────── 比较、范围与不可选 ─────────\n\n/** 比较的粒度：日历的三种视图 */\nexport interface DateUnits {\n  /** 天 */\n  day: unknown;\n  /** 月 */\n  month: unknown;\n  /** 年 */\n  year: unknown;\n}\n\n/** 日期的粒度 */\nexport type DateUnit = keyof DateUnits;\n\n/** 截到粒度：月取 1 日，年取 1 月 1 日 */\nexport function truncateDate(date: CalendarDate, unit: DateUnit): CalendarDate {\n  if (unit === 'day') return date;\n  return unit === 'month' ? date.set({ day: 1 }) : date.set({ month: 1, day: 1 });\n}\n\n/** 按粒度比较：小于 0 表示 a 在前；跨日历系统时按同一天比较 */\nexport function compareDates(a: CalendarDate, b: CalendarDate, unit: DateUnit = 'day'): number {\n  const other = toCalendar(b, a.calendar);\n  return truncateDate(a, unit).compare(truncateDate(other, unit));\n}\n\n/** 是不是同一天 / 同一月 / 同一年；任一方为空时为 false */\nexport function isSameDate(\n  a: CalendarDate | null | undefined,\n  b: CalendarDate | null | undefined,\n  unit: DateUnit = 'day',\n): boolean {\n  return a != null && b != null && compareDates(a, b, unit) === 0;\n}\n\n/** 可选范围与不可选的日期：Calendar、DatePicker、DateField 共用 */\nexport interface DateLimits {\n  /** 最早可选的日期 */\n  min?: CalendarDate | null;\n  /** 最晚可选的日期 */\n  max?: CalendarDate | null;\n  /** 不可选的日期（已订满、节假日）：仍能用方向键经过，读屏能听到，不能选 */\n  isUnavailable?: (date: CalendarDate) => boolean;\n}\n\n/** 在 min–max 之外（按粒度：月份视图里只要这个月有一天可选就不算在外面） */\nexport function isOutOfRange(\n  date: CalendarDate,\n  { min, max }: DateLimits,\n  unit: DateUnit = 'day',\n): boolean {\n  return (\n    (min != null && compareDates(date, min, unit) < 0) ||\n    (max != null && compareDates(date, max, unit) > 0)\n  );\n}\n\n/** 不能选：在范围外，或是不可选的日期（只在天的粒度上判断 isUnavailable） */\nexport function isDateDisabled(\n  date: CalendarDate,\n  limits: DateLimits,\n  unit: DateUnit = 'day',\n): boolean {\n  return (\n    isOutOfRange(date, limits, unit) || (unit === 'day' && (limits.isUnavailable?.(date) ?? false))\n  );\n}\n\n/** 把日期夹到 min–max 之间 */\nexport function clampDate(date: CalendarDate, { min, max }: DateLimits): CalendarDate {\n  if (min != null && date.compare(toCalendar(min, date.calendar)) < 0)\n    return toCalendar(min, date.calendar);\n  if (max != null && date.compare(toCalendar(max, date.calendar)) > 0)\n    return toCalendar(max, date.calendar);\n  return date;\n}\n\n/** 日期区间：两端都包含 */\nexport interface DateRange<T = CalendarDate> {\n  /** 开始（含） */\n  start: T;\n  /** 结束（含） */\n  end: T;\n}\n\n/** 两个日期排成区间：先的在前 */\nexport function orderedRange(a: CalendarDate, b: CalendarDate): DateRange {\n  return a.compare(b) <= 0 ? { start: a, end: b } : { start: b, end: a };\n}\n\n/** 日期是否在区间里（含两端；按粒度） */\nexport function isInRange(\n  date: CalendarDate,\n  range: DateRange | null | undefined,\n  unit: DateUnit = 'day',\n): boolean {\n  return (\n    range != null &&\n    compareDates(date, range.start, unit) >= 0 &&\n    compareDates(date, range.end, unit) <= 0\n  );\n}\n\n/** 区间一共几天（含两端） */\nexport function rangeDays({ start, end }: DateRange): number {\n  return end.compare(start) + 1;\n}\n\n/** 区间里有没有不可选的日期：酒店连住时中间不能有订满的一天（React Aria 的 allowsNonContiguousRanges 为 false 时） */\nexport function rangeHasUnavailable(\n  { start, end }: DateRange,\n  isUnavailable: ((date: CalendarDate) => boolean) | undefined,\n): boolean {\n  if (!isUnavailable) return false;\n  for (let date = start; date.compare(end) <= 0; date = date.add({ days: 1 })) {\n    if (isUnavailable(date)) return true;\n  }\n  return false;\n}\n\n/** ISO 字符串的区间 → CalendarDate 的区间；任一端解析不了时为 null */\nexport function parseIsoRange(range: DateRange<string> | null | undefined): DateRange | null {\n  const start = parseIsoDate(range?.start);\n  const end = parseIsoDate(range?.end);\n  return start && end ? orderedRange(start, end) : null;\n}\n\n/** CalendarDate 的区间 → ISO 字符串的区间 */\nexport function toIsoRange(range: DateRange): DateRange<string> {\n  return { start: toIsoDate(range.start), end: toIsoDate(range.end) };\n}\n\n// ───────── 快捷区间 ─────────\n\n/** 常用的快捷区间：报表、筛选里的“最近 7 天”“本月” */\nexport interface DateRangePresets {\n  /** 今天 */\n  today: unknown;\n  /** 昨天 */\n  yesterday: unknown;\n  /** 最近 7 天（含今天） */\n  last7Days: unknown;\n  /** 最近 30 天（含今天） */\n  last30Days: unknown;\n  /** 本周（按语言的一周第一天） */\n  thisWeek: unknown;\n  /** 本月 */\n  thisMonth: unknown;\n  /** 上月 */\n  lastMonth: unknown;\n  /** 今年 */\n  thisYear: unknown;\n}\n\n/** 快捷区间的名字 */\nexport type DateRangePreset = keyof DateRangePresets;\n\n/** 按今天算出快捷区间 */\nexport function presetRange(\n  preset: DateRangePreset,\n  today: CalendarDate,\n  week: WeekOptions,\n): DateRange {\n  switch (preset) {\n    case 'today':\n      return { start: today, end: today };\n    case 'yesterday': {\n      const day = today.subtract({ days: 1 });\n      return { start: day, end: day };\n    }\n    case 'last7Days':\n      return { start: today.subtract({ days: 6 }), end: today };\n    case 'last30Days':\n      return { start: today.subtract({ days: 29 }), end: today };\n    case 'thisWeek': {\n      const start = startOfWeek(today, week.locale, toDayOfWeek(week.firstDayOfWeek));\n      return { start, end: start.add({ days: 6 }) };\n    }\n    case 'thisMonth':\n      return { start: startOfMonth(today), end: endOfMonth(today) };\n    case 'lastMonth': {\n      const month = startOfMonth(today).subtract({ months: 1 });\n      return { start: month, end: endOfMonth(month) };\n    }\n    case 'thisYear':\n      return { start: today.set({ month: 1, day: 1 }), end: today.set({ month: 12, day: 31 }) };\n  }\n}\n\n/** 快捷区间的 ISO 值，按今天（时区，不写时取浏览器的）与一周的排法：`presetIsoRange('last7Days', { locale: 'zh-CN' })` */\nexport function presetIsoRange(\n  preset: DateRangePreset,\n  week: WeekOptions,\n  timeZone = getLocalTimeZone(),\n): DateRange<string> {\n  return toIsoRange(presetRange(preset, today(timeZone), week));\n}\n\n// ───────── 时刻与相对时间 ─────────\n\n/** 带时区或 UTC 标记的 ISO 字符串（'2026-10-20T14:30:00Z'、'…+08:00'）：本身就是一个时刻 */\nconst ABSOLUTE_ISO = /(?:[zZ]|[+-]\\d\\d:?\\d\\d)$/;\n\n/**\n * 日期值 → 时刻（毫秒时间戳）：Date 与带时区的值照原样；不带时区的（'2026-10-20T14:30'、CalendarDateTime）\n * 按 timeZone 的墙上时间算。格式不对时 NaN\n */\nexport function toInstant(value: Date | DateValue | string, timeZone = getLocalTimeZone()): number {\n  if (value instanceof Date) return value.getTime();\n  if (typeof value !== 'string') {\n    return ('timeZone' in value ? value.toDate() : value.toDate(timeZone)).getTime();\n  }\n  if (ABSOLUTE_ISO.test(value)) return Date.parse(value);\n  const parsed = parseIsoDateTime(value) ?? parseIsoDate(value);\n  return parsed ? parsed.toDate(timeZone).getTime() : Number.NaN;\n}\n\n/** 相对时间用的单位：多久以内用这个单位（秒），参考 moment.js 的取整阈值 */\nconst RELATIVE_UNITS: readonly [Intl.RelativeTimeFormatUnit, number, number][] = [\n  // [单位, 一个单位多少秒, 小于多少秒时用它]\n  ['second', 1, 45],\n  ['minute', 60, 45 * 60],\n  ['hour', 3600, 22 * 3600],\n  ['day', 86_400, 26 * 86_400],\n  ['month', 30 * 86_400, 320 * 86_400],\n  ['year', 365 * 86_400, Infinity],\n];\n\n/** 相差的毫秒数 → 相对时间的数值与单位：`relativeUnit(-180_000)` → `{ value: -3, unit: 'minute' }` */\nexport function relativeUnit(diff: number): { value: number; unit: Intl.RelativeTimeFormatUnit } {\n  const seconds = diff / 1000;\n  const [unit, size] = RELATIVE_UNITS.find(([, , below]) => Math.abs(seconds) < below)!;\n  // -0 换成 0：Intl 的 numeric: auto 才念“现在”\n  return { value: Math.round(seconds / size) || 0, unit };\n}\n\n// ───────── 内部实现 ─────────\n\nfunction tryParse<T>(value: string | null | undefined, parse: (text: string) => T): T | null {\n  if (!value) return null;\n  try {\n    return parse(value);\n  } catch {\n    return null;\n  }\n}\n\nconst formatters = new Map<string, DateFormatter>();\n\nfunction cachedFormatter(locale: string, options: Intl.DateTimeFormatOptions): DateFormatter {\n  const key = `${locale}|${JSON.stringify(options)}`;\n  let formatter = formatters.get(key);\n  if (!formatter) formatters.set(key, (formatter = new DateFormatter(locale, options)));\n  return formatter;\n}\n"],"mappings":"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"}

package/dist/utils/data/diff.d.ts

@@ -0,0 +1,21 @@
+import { type NumericValue } from './numeric';
+/** 一个字段的比较结果 */
+export interface FieldDiff<T, K extends keyof T = keyof T> {
+    /** 字段名 */
+    key: K;
+    /** 之前的值；那一份没有时 undefined */
+    before: T[K] | undefined;
+    /** 之后的值 */
+    after: T[K] | undefined;
+    /** 变了没有 */
+    changed: boolean;
+    /** 两边都是数值时的差：after − before（Decimal、bigint 精确运算） */
+    delta?: NumericValue;
+    /** 两边都是数值且之前不为 0 时的变化率：delta / before（-0.2 是降了 20%） */
+    ratio?: number;
+}
+/**
+ * 按字段比较两份记录；keys 决定比哪些字段与顺序，不写时是两边出现过的全部字段（before 的在前）。
+ * 某一份是 null / undefined 时，它的每个字段都当作没有
+ */
+export declare function diffFields<T extends object, K extends keyof T = keyof T>(before: T | null | undefined, after: T | null | undefined, keys?: readonly K[]): FieldDiff<T, K>[];

package/dist/utils/data/diff.js

@@ -0,0 +1,43 @@
+import { addNumeric, isDecimal, isNumeric, multiplyNumeric, numericKind, toNumber } from "./numeric.js";
+import { sameValue } from "./equality.js";
+//#region src/utils/data/diff.ts
+/**
+* 两份记录按字段比较（测算版本对比、编辑前后、审批意见）：哪些字段变了，数值字段变了多少。
+*
+*   diffFields(v1, v2, ['amount', 'quantity', 'reason'])
+*   // → [{ key: 'amount', before: 120, after: 98, changed: true, delta: -22, ratio: -0.183 }, …]
+*
+* 变没变按结构相等（sameValue：Decimal('1.0') 与 1 相等、日期按值）；两边都是数值（number、bigint、Decimal）时
+* 给出精确的差（after − before，按 Decimal 或 bigint 运算，不经过浮点）与变化率。
+*/
+/**
+* 按字段比较两份记录；keys 决定比哪些字段与顺序，不写时是两边出现过的全部字段（before 的在前）。
+* 某一份是 null / undefined 时，它的每个字段都当作没有
+*/
+function diffFields(before, after, keys) {
+	return (keys ?? [.../* @__PURE__ */ new Set([...Object.keys(before ?? {}), ...Object.keys(after ?? {})])]).map((key) => {
+		const from = before?.[key];
+		const to = after?.[key];
+		const diff = {
+			key,
+			before: from,
+			after: to,
+			changed: !sameValue(from, to)
+		};
+		if (isNumeric(from) && isNumeric(to)) {
+			diff.delta = subtract(to, from);
+			const base = toNumber(from);
+			if (base !== 0) diff.ratio = toNumber(diff.delta) / base;
+		}
+		return diff;
+	});
+}
+/** a − b：有一边是 Decimal 时按它的构造函数算，都是 bigint 时按整数，否则按 number */
+function subtract(a, b) {
+	const kind = isDecimal(a) ? numericKind(a) : isDecimal(b) ? numericKind(b) : typeof a === "bigint" && typeof b === "bigint" ? "bigint" : "number";
+	return addNumeric(a, multiplyNumeric(b, -1, kind), kind);
+}
+//#endregion
+export { diffFields };
+
+//# sourceMappingURL=diff.js.map

package/dist/utils/data/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","names":[],"sources":["../../../src/utils/data/diff.ts"],"sourcesContent":["/**\n * 两份记录按字段比较（测算版本对比、编辑前后、审批意见）：哪些字段变了，数值字段变了多少。\n *\n *   diffFields(v1, v2, ['amount', 'quantity', 'reason'])\n *   // → [{ key: 'amount', before: 120, after: 98, changed: true, delta: -22, ratio: -0.183 }, …]\n *\n * 变没变按结构相等（sameValue：Decimal('1.0') 与 1 相等、日期按值）；两边都是数值（number、bigint、Decimal）时\n * 给出精确的差（after − before，按 Decimal 或 bigint 运算，不经过浮点）与变化率。\n */\nimport { sameValue } from './equality';\nimport {\n  addNumeric,\n  isDecimal,\n  isNumeric,\n  multiplyNumeric,\n  numericKind,\n  toNumber,\n  type NumericValue,\n} from './numeric';\n\n/** 一个字段的比较结果 */\nexport interface FieldDiff<T, K extends keyof T = keyof T> {\n  /** 字段名 */\n  key: K;\n  /** 之前的值；那一份没有时 undefined */\n  before: T[K] | undefined;\n  /** 之后的值 */\n  after: T[K] | undefined;\n  /** 变了没有 */\n  changed: boolean;\n  /** 两边都是数值时的差：after − before（Decimal、bigint 精确运算） */\n  delta?: NumericValue;\n  /** 两边都是数值且之前不为 0 时的变化率：delta / before（-0.2 是降了 20%） */\n  ratio?: number;\n}\n\n/**\n * 按字段比较两份记录；keys 决定比哪些字段与顺序，不写时是两边出现过的全部字段（before 的在前）。\n * 某一份是 null / undefined 时，它的每个字段都当作没有\n */\nexport function diffFields<T extends object, K extends keyof T = keyof T>(\n  before: T | null | undefined,\n  after: T | null | undefined,\n  keys?: readonly K[],\n): FieldDiff<T, K>[] {\n  const fields =\n    keys ?? ([...new Set([...Object.keys(before ?? {}), ...Object.keys(after ?? {})])] as K[]);\n  return fields.map((key) => {\n    const from = before?.[key];\n    const to = after?.[key];\n    const diff: FieldDiff<T, K> = { key, before: from, after: to, changed: !sameValue(from, to) };\n    if (isNumeric(from) && isNumeric(to)) {\n      diff.delta = subtract(to, from);\n      const base = toNumber(from);\n      if (base !== 0) diff.ratio = toNumber(diff.delta) / base;\n    }\n    return diff;\n  });\n}\n\n/** a − b：有一边是 Decimal 时按它的构造函数算，都是 bigint 时按整数，否则按 number */\nfunction subtract(a: NumericValue, b: NumericValue): NumericValue {\n  const kind = isDecimal(a)\n    ? numericKind(a)\n    : isDecimal(b)\n      ? numericKind(b)\n      : typeof a === 'bigint' && typeof b === 'bigint'\n        ? 'bigint'\n        : 'number';\n  return addNumeric(a, multiplyNumeric(b, -1, kind), kind);\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAwCA,SAAgB,WACd,QACA,OACA,MACmB;CAGnB,QADE,QAAS,CAAC,mBAAG,IAAI,IAAI,CAAC,GAAG,OAAO,KAAK,UAAU,CAAC,CAAC,GAAG,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAA,CACrE,KAAK,QAAQ;EACzB,MAAM,OAAO,SAAS;EACtB,MAAM,KAAK,QAAQ;EACnB,MAAM,OAAwB;GAAE;GAAK,QAAQ;GAAM,OAAO;GAAI,SAAS,CAAC,UAAU,MAAM,EAAE;EAAE;EAC5F,IAAI,UAAU,IAAI,KAAK,UAAU,EAAE,GAAG;GACpC,KAAK,QAAQ,SAAS,IAAI,IAAI;GAC9B,MAAM,OAAO,SAAS,IAAI;GAC1B,IAAI,SAAS,GAAG,KAAK,QAAQ,SAAS,KAAK,KAAK,IAAI;EACtD;EACA,OAAO;CACT,CAAC;AACH;;AAGA,SAAS,SAAS,GAAiB,GAA+B;CAChE,MAAM,OAAO,UAAU,CAAC,IACpB,YAAY,CAAC,IACb,UAAU,CAAC,IACT,YAAY,CAAC,IACb,OAAO,MAAM,YAAY,OAAO,MAAM,WACpC,WACA;CACR,OAAO,WAAW,GAAG,gBAAgB,GAAG,IAAI,IAAI,GAAG,IAAI;AACzD"}

package/dist/utils/data/equality.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 结构相等：普通对象与数组逐项比较；Date 比时间；数值（number、bigint、Decimal）按大小，Decimal('1.0') 与 1 相等；
+ * 日期值（CalendarDate 等）按它自己的 compare；其余（含 Blob）比引用
+ */
+export declare function sameValue(a: unknown, b: unknown): boolean;

package/dist/utils/data/equality.js

@@ -0,0 +1,24 @@
+import { isNumeric, sameNumeric } from "./numeric.js";
+//#region src/utils/data/equality.ts
+/** 结构相等：表单判断有没有改过、请求判断参数是不是真的变了 */
+/** 自带 compare 的值（@internationalized/date 的日期值）：不在运行时导入，按形状识别 */
+var isComparable = (value) => typeof value === "object" && value !== null && typeof value.compare === "function";
+/**
+* 结构相等：普通对象与数组逐项比较；Date 比时间；数值（number、bigint、Decimal）按大小，Decimal('1.0') 与 1 相等；
+* 日期值（CalendarDate 等）按它自己的 compare；其余（含 Blob）比引用
+*/
+function sameValue(a, b) {
+	if (Object.is(a, b)) return true;
+	if (a instanceof Date && b instanceof Date) return a.getTime() === b.getTime();
+	if (isNumeric(a) && isNumeric(b)) return sameNumeric(a, b);
+	if (isComparable(a) && isComparable(b) && a.constructor === b.constructor) return a.compare(b) === 0;
+	if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) return false;
+	if (Array.isArray(a) !== Array.isArray(b) || a instanceof Blob || b instanceof Blob) return false;
+	const keys = Object.keys(a);
+	if (keys.length !== Object.keys(b).length) return false;
+	return keys.every((key) => sameValue(a[key], b[key]));
+}
+//#endregion
+export { sameValue };
+
+//# sourceMappingURL=equality.js.map

package/dist/utils/data/equality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"equality.js","names":[],"sources":["../../../src/utils/data/equality.ts"],"sourcesContent":["/** 结构相等：表单判断有没有改过、请求判断参数是不是真的变了 */\nimport { isNumeric, sameNumeric } from './numeric';\n\n/** 自带 compare 的值（@internationalized/date 的日期值）：不在运行时导入，按形状识别 */\nconst isComparable = (value: unknown): value is { compare: (other: unknown) => number } =>\n  typeof value === 'object' &&\n  value !== null &&\n  typeof (value as { compare?: unknown }).compare === 'function';\n\n/**\n * 结构相等：普通对象与数组逐项比较；Date 比时间；数值（number、bigint、Decimal）按大小，Decimal('1.0') 与 1 相等；\n * 日期值（CalendarDate 等）按它自己的 compare；其余（含 Blob）比引用\n */\nexport function sameValue(a: unknown, b: unknown): boolean {\n  if (Object.is(a, b)) return true;\n  if (a instanceof Date && b instanceof Date) return a.getTime() === b.getTime();\n  if (isNumeric(a) && isNumeric(b)) return sameNumeric(a, b);\n  if (isComparable(a) && isComparable(b) && a.constructor === b.constructor)\n    return a.compare(b) === 0;\n  if (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null) return false;\n  if (Array.isArray(a) !== Array.isArray(b) || a instanceof Blob || b instanceof Blob) return false;\n  const keys = Object.keys(a);\n  if (keys.length !== Object.keys(b).length) return false;\n  return keys.every((key) =>\n    sameValue((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key]),\n  );\n}\n"],"mappings":";;;;AAIA,IAAM,gBAAgB,UACpB,OAAO,UAAU,YACjB,UAAU,QACV,OAAQ,MAAgC,YAAY;;;;;AAMtD,SAAgB,UAAU,GAAY,GAAqB;CACzD,IAAI,OAAO,GAAG,GAAG,CAAC,GAAG,OAAO;CAC5B,IAAI,aAAa,QAAQ,aAAa,MAAM,OAAO,EAAE,QAAQ,MAAM,EAAE,QAAQ;CAC7E,IAAI,UAAU,CAAC,KAAK,UAAU,CAAC,GAAG,OAAO,YAAY,GAAG,CAAC;CACzD,IAAI,aAAa,CAAC,KAAK,aAAa,CAAC,KAAK,EAAE,gBAAgB,EAAE,aAC5D,OAAO,EAAE,QAAQ,CAAC,MAAM;CAC1B,IAAI,OAAO,MAAM,YAAY,OAAO,MAAM,YAAY,MAAM,QAAQ,MAAM,MAAM,OAAO;CACvF,IAAI,MAAM,QAAQ,CAAC,MAAM,MAAM,QAAQ,CAAC,KAAK,aAAa,QAAQ,aAAa,MAAM,OAAO;CAC5F,MAAM,OAAO,OAAO,KAAK,CAAC;CAC1B,IAAI,KAAK,WAAW,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,OAAO;CAClD,OAAO,KAAK,OAAO,QACjB,UAAW,EAA8B,MAAO,EAA8B,IAAI,CACpF;AACF"}

package/dist/utils/data/history.d.ts

@@ -0,0 +1,59 @@
+/** createHistory 的选项 */
+export interface HistoryOptions<T> {
+    /** 读当前的状态 */
+    read: () => T;
+    /** 撤销、重做时把记下的版本写回状态（拿到的是一份拷贝，可以直接放进状态里） */
+    write: (value: T) => void;
+    /** 最多记多少步（不算起点），默认 100；超出时丢掉最早的 */
+    limit?: number;
+    /** 同一个 merge 键的连续提交，间隔不超过多少毫秒就合成一步，默认 500 */
+    mergeWindow?: number;
+    /** 记下一个版本时怎样复制，默认 snapshot（深拷贝、去掉代理）；状态按不可变方式更新时写 (value) => value */
+    clone?: (value: T) => T;
+    /** 与上一步是否相同（相同就不记），默认结构相等（sameValue） */
+    equals?: (a: T, b: T) => boolean;
+}
+/** commit 的选项 */
+export interface HistoryCommitOptions {
+    /**
+     * 合并的键：与上一步的键相同、间隔在 mergeWindow 以内时并进上一步（逐字输入、连续微调）。
+     * 键里带上对象，例如 `name:${node.id}`，改另一个对象的同一个字段时另起一步
+     */
+    merge?: string;
+}
+/** 一次连续的操作（拖动、调整大小）：期间的改动不记，结束时合成一步 */
+export interface HistoryGesture {
+    /** 结束：有改动就记成一步 */
+    end(): void;
+    /** 取消：状态回到开始前（Esc 取消拖动） */
+    cancel(): void;
+}
+/** createHistory 的返回值：状态加方法，交给工具栏、快捷键 */
+export interface History {
+    /** 有可以撤销的步骤 */
+    readonly canUndo: boolean;
+    /** 有可以重做的步骤 */
+    readonly canRedo: boolean;
+    /** 下一次撤销会撤掉的那一步的说明（commit 时写的 label），按钮的提示里用；没有时 undefined */
+    readonly undoLabel: string | undefined;
+    /** 下一次重做会重做的那一步的说明 */
+    readonly redoLabel: string | undefined;
+    /** 现在与保存点（markSaved）不同；还没保存过时与起点比 */
+    readonly dirty: boolean;
+    /** 正在进行一次连续的操作（begin 之后、end 或 cancel 之前） */
+    readonly busy: boolean;
+    /** 把当前状态记成新的一步；与上一步相同时不记。撤销过再提交会丢掉可以重做的步骤 */
+    commit(label?: string, options?: HistoryCommitOptions): void;
+    /** 开始一次连续的操作：期间的 commit 不起作用，end 时记一步、cancel 时回到开始前。已有进行中的操作时先结束它 */
+    begin(label?: string): HistoryGesture;
+    /** 撤销一步 */
+    undo(): void;
+    /** 重做一步 */
+    redo(): void;
+    /** 把当前这一步记为已保存：dirty 变回 false */
+    markSaved(): void;
+    /** 清空历史，以当前状态为新的起点并记为已保存（载入另一份文档、发布之后） */
+    reset(): void;
+}
+/** 撤销重做的历史（在哪里都能调用：不用生命周期与注入） */
+export declare function createHistory<T>(options: HistoryOptions<T>): History;