@pisell/utils 3.0.4 → 3.0.6

package/lib/walletValidity.js

@@ -1,349 +1,446 @@
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
+const require_runtime = require("./_virtual/_rolldown/runtime.js");
+const require_objectSpread2 = require("./_virtual/_@oxc-project_runtime@0.122.0/helpers/objectSpread2.js");
+let dayjs = require("dayjs");
+dayjs = require_runtime.__toESM(dayjs);
+//#region src/walletValidity.ts
+const CONSTANTS = {
+	ALL_DAY_START: "00:00",
+	ALL_DAY_END: "23:59",
+	SECONDS_SUFFIX: ":59"
 };
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/walletValidity.ts
-var walletValidity_exports = {};
-__export(walletValidity_exports, {
-  getScheduleSummary: () => getScheduleSummary
-});
-module.exports = __toCommonJS(walletValidity_exports);
-var import_dayjs = __toESM(require("dayjs"));
-var CONSTANTS = {
-  ALL_DAY_START: "00:00",
-  ALL_DAY_END: "23:59",
-  DEFAULT_FUTURE_YEARS: 10,
-  SECONDS_SUFFIX: ":59"
-};
-var textConfig = {
-  "zh-HK": {
-    weekdays: ["日", "一", "二", "三", "四", "五", "六"],
-    separator: "、",
-    timeSeparator: "–",
-    rangeSeparator: " 至 ",
-    periodSeparator: "；",
-    timeSlotSeparator: "，",
-    every: "每",
-    day: "天",
-    week: "周",
-    month: "月",
-    year: "年",
-    available: "可用",
-    unlimited: "无限期",
-    multipleRules: "多規則，點詳情",
-    multipleSlots: "，多時段",
-    until: "至",
-    daily: "每天",
-    days: "天",
-    weeks: "周",
-    everyPrefix: "每",
-    weekPrefix: "周",
-    dateFormat: "YYYY-MM-DD",
-    dateTimeFormat: "YYYY-MM-DD HH:mm",
-    longTermValidFrom: "自",
-    noExpiry: "起長期有效",
-    on: ""
-  },
-  "zh-CN": {
-    weekdays: ["日", "一", "二", "三", "四", "五", "六"],
-    separator: "、",
-    timeSeparator: "–",
-    rangeSeparator: " 至 ",
-    periodSeparator: "；",
-    timeSlotSeparator: "，",
-    every: "每",
-    day: "天",
-    week: "周",
-    month: "月",
-    year: "年",
-    available: "可用",
-    unlimited: "无限期",
-    multipleRules: "多规则，点详情",
-    multipleSlots: "，多时段",
-    until: "至",
-    daily: "每天",
-    days: "天",
-    weeks: "周",
-    everyPrefix: "每",
-    weekPrefix: "周",
-    dateFormat: "YYYY-MM-DD",
-    dateTimeFormat: "YYYY-MM-DD HH:mm",
-    longTermValidFrom: "自",
-    noExpiry: "起长期有效",
-    on: ""
-  },
-  "en": {
-    weekdays: ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"],
-    separator: ", ",
-    timeSeparator: "–",
-    rangeSeparator: " - ",
-    periodSeparator: "; ",
-    timeSlotSeparator: ", ",
-    every: "every ",
-    day: "day",
-    week: "week",
-    month: "month",
-    year: "year",
-    available: "available",
-    unlimited: "unlimited",
-    multipleRules: "Multiple rules, see details",
-    multipleSlots: ", multiple slots",
-    until: "Until ",
-    daily: "daily",
-    days: "days",
-    weeks: "weeks",
-    everyPrefix: "every ",
-    weekPrefix: "",
-    dateFormat: "DD MMM YYYY",
-    dateTimeFormat: "DD MMM YYYY h:mm A",
-    longTermValidFrom: "from ",
-    noExpiry: ", no expiry",
-    on: "on "
-  }
+function getValidityDate(value) {
+	if (typeof value !== "string") return null;
+	const match = value.match(/^(\d{4}-\d{2}-\d{2})(?:$|[ T])/);
+	if (!match) return null;
+	const date = (0, dayjs.default)(match[1]);
+	return date.isValid() && date.format("YYYY-MM-DD") === match[1] ? match[1] : null;
+}
+/** 仅计算展示日期的交集，不修改日程的重复起点或每日使用时段。 */
+function getWalletValidityRange(start, end, validity) {
+	const scheduleStart = getValidityDate(start);
+	const scheduleEnd = getValidityDate(end);
+	const passStart = getValidityDate(validity === null || validity === void 0 ? void 0 : validity.start_date);
+	const passEnd = getValidityDate(validity === null || validity === void 0 ? void 0 : validity.expire_date) || getValidityDate(validity === null || validity === void 0 ? void 0 : validity.expire_time);
+	const startDate = passStart && (!scheduleStart || passStart > scheduleStart) ? passStart : scheduleStart;
+	const endDate = passEnd && (!scheduleEnd || passEnd < scheduleEnd) ? passEnd : scheduleEnd;
+	return {
+		startDate,
+		endDate,
+		isEmpty: Boolean(startDate && endDate && startDate > endDate)
+	};
+}
+const textConfig = {
+	"zh-HK": {
+		weekdays: [
+			"日",
+			"一",
+			"二",
+			"三",
+			"四",
+			"五",
+			"六"
+		],
+		separator: "、",
+		timeSeparator: "–",
+		rangeSeparator: " 至 ",
+		periodSeparator: "；",
+		timeSlotSeparator: "，",
+		every: "每",
+		day: "天",
+		week: "周",
+		month: "月",
+		year: "年",
+		available: "可用",
+		unlimited: "无限期",
+		noAvailableDates: "無可用日期",
+		multipleRules: "多規則，點詳情",
+		multipleSlots: "，多時段",
+		until: "至",
+		daily: "每天",
+		days: "天",
+		weeks: "周",
+		everyPrefix: "每",
+		weekPrefix: "周",
+		dateFormat: "YYYY-MM-DD",
+		dateTimeFormat: "YYYY-MM-DD HH:mm",
+		longTermValidFrom: "自",
+		noExpiry: "起長期有效",
+		on: ""
+	},
+	"zh-CN": {
+		weekdays: [
+			"日",
+			"一",
+			"二",
+			"三",
+			"四",
+			"五",
+			"六"
+		],
+		separator: "、",
+		timeSeparator: "–",
+		rangeSeparator: " 至 ",
+		periodSeparator: "；",
+		timeSlotSeparator: "，",
+		every: "每",
+		day: "天",
+		week: "周",
+		month: "月",
+		year: "年",
+		available: "可用",
+		unlimited: "无限期",
+		noAvailableDates: "无可用日期",
+		multipleRules: "多规则，点详情",
+		multipleSlots: "，多时段",
+		until: "至",
+		daily: "每天",
+		days: "天",
+		weeks: "周",
+		everyPrefix: "每",
+		weekPrefix: "周",
+		dateFormat: "YYYY-MM-DD",
+		dateTimeFormat: "YYYY-MM-DD HH:mm",
+		longTermValidFrom: "自",
+		noExpiry: "起长期有效",
+		on: ""
+	},
+	"en": {
+		weekdays: [
+			"Sun",
+			"Mon",
+			"Tue",
+			"Wed",
+			"Thu",
+			"Fri",
+			"Sat"
+		],
+		separator: ", ",
+		timeSeparator: "–",
+		rangeSeparator: " - ",
+		periodSeparator: "; ",
+		timeSlotSeparator: ", ",
+		every: "every ",
+		day: "day",
+		week: "week",
+		month: "month",
+		year: "year",
+		available: "available",
+		unlimited: "unlimited",
+		noAvailableDates: "No available dates",
+		multipleRules: "Multiple rules, see details",
+		multipleSlots: ", multiple slots",
+		until: "Until ",
+		daily: "daily",
+		days: "days",
+		weeks: "weeks",
+		everyPrefix: "every ",
+		weekPrefix: "",
+		dateFormat: "DD MMM YYYY",
+		dateTimeFormat: "DD MMM YYYY h:mm A",
+		longTermValidFrom: "from ",
+		noExpiry: ", no expiry",
+		on: "on "
+	}
 };
+/**
+* 获取星期几的表示
+* @param dayNumbers 星期几的数字数组 (0-6, 0代表周日)
+* @param locale 语言设置
+* @param separator 分隔符，可选，默认使用locale配置的分隔符
+* @returns 格式化的星期几文案
+*/
 function getWeekdayText(dayNumbers, locale, separator) {
-  const config = textConfig[locale];
-  return dayNumbers.map((day) => config.weekdays[day]).join(separator || config.separator);
+	const config = textConfig[locale];
+	return [...new Set(dayNumbers)].sort((a, b) => a - b).map((day) => config.weekdays[day]).join(separator || config.separator);
 }
+/**
+* 获取指定语言的文案配置
+* @param locale 语言设置
+* @param key 配置项key
+* @returns 对应语言的文案
+*/
 function getText(locale, key) {
-  return textConfig[locale][key];
+	return textConfig[locale][key];
 }
+/**
+* 获取指定语言的配置对象（缓存优化）
+* @param locale 语言设置
+* @returns 对应语言的完整配置对象
+*/
 function getConfig(locale) {
-  return textConfig[locale];
+	return textConfig[locale];
 }
+/**
+* 获取每日频率文案
+* @param frequency 频率数字
+* @param locale 语言设置
+* @returns 格式化的每日频率文案
+*/
 function getDailyFrequencyText(frequency, locale) {
-  if (frequency === 1) {
-    return getText(locale, "daily");
-  }
-  const config = textConfig[locale];
-  if (locale === "en") {
-    return `${config.everyPrefix}${frequency} ${config.days}`;
-  } else {
-    return `${config.everyPrefix}${frequency}${config.days}`;
-  }
+	if (frequency === 1) return getText(locale, "daily");
+	const config = textConfig[locale];
+	if (locale === "en") return `${config.everyPrefix}${frequency} ${config.days}`;
+	else return `${config.everyPrefix}${frequency}${config.days}`;
 }
+/**
+* 获取每周频率前缀文案
+* @param frequency 频率数字
+* @param locale 语言设置
+* @returns 格式化的每周频率前缀文案
+*/
 function getWeeklyFrequencyPrefix(frequency, locale) {
-  if (frequency === 1) {
-    return "";
-  }
-  const config = textConfig[locale];
-  if (locale === "en") {
-    return `${config.everyPrefix}${frequency} ${config.weeks}, `;
-  } else {
-    return `${config.everyPrefix}${frequency}${config.weeks} `;
-  }
+	if (frequency === 1) return "";
+	const config = textConfig[locale];
+	if (locale === "en") return `${config.everyPrefix}${frequency} ${config.weeks}, `;
+	else return `${config.everyPrefix}${frequency}${config.weeks} `;
 }
+/**
+* 格式化日期时间函数
+* @param dateTime 日期时间字符串
+* @param isAll 是否为全天
+* @param locale 语言设置
+* @returns 格式化后的日期时间字符串
+*/
 function formatDateTime(dateTime, isAll = false, locale = "zh-CN") {
-  const date = (0, import_dayjs.default)(dateTime);
-  const config = getConfig(locale);
-  if (isAll) {
-    return date.format(config.dateFormat);
-  }
-  return date.format(config.dateTimeFormat);
+	const date = (0, dayjs.default)(dateTime);
+	const config = getConfig(locale);
+	if (isAll) return date.format(config.dateFormat);
+	return date.format(config.dateTimeFormat);
 }
+/**
+* 判断是否为全天日程
+* @param startTime 开始时间 (HH:mm格式)
+* @param endTime 结束时间 (HH:mm格式)
+* @returns 是否为全天日程
+*/
 function isAllDaySchedule(startTime, endTime) {
-  return startTime === CONSTANTS.ALL_DAY_START && endTime === CONSTANTS.ALL_DAY_END;
+	return startTime === CONSTANTS.ALL_DAY_START && endTime === CONSTANTS.ALL_DAY_END;
 }
-function formatDateRange(startDate, endDate, isStarted, locale, isAllDay = false) {
-  const config = getConfig(locale);
-  if (isStarted) {
-    const endDateStr = formatDateTime(endDate, isAllDay, locale);
-    return `${config.until}${endDateStr}`;
-  } else {
-    const startDateStr = formatDateTime(startDate, isAllDay, locale);
-    const endDateStr = formatDateTime(endDate, isAllDay, locale);
-    return `${startDateStr}${config.rangeSeparator}${endDateStr}`;
-  }
+/**
+* 生成日期范围文案
+* @param startDate 开始日期
+* @param endDate 结束日期
+* @param isStarted 是否已开始
+* @param locale 语言设置
+* @param isAllDay 是否为全天
+* @returns 格式化的日期范围文案
+*/
+function formatDateRange(startDate, endDate, isStarted, locale, isAllDay = false, validity) {
+	const config = getConfig(locale);
+	const range = getWalletValidityRange(startDate, endDate, validity);
+	if (range.isEmpty) return config.noAvailableDates;
+	const effectiveStart = range.startDate === getValidityDate(startDate) ? startDate : `${range.startDate} 00:00:00`;
+	const effectiveEnd = range.endDate === getValidityDate(endDate) ? endDate : `${range.endDate} 23:59:59`;
+	if (!range.endDate) return config.unlimited;
+	if ((range.startDate ? (0, dayjs.default)(effectiveStart).isBefore((0, dayjs.default)()) : isStarted) || !range.startDate) {
+		const endDateStr = formatDateTime(effectiveEnd, isAllDay, locale);
+		return `${config.until}${endDateStr}`;
+	} else {
+		const startDateStr = formatDateTime(effectiveStart, isAllDay, locale);
+		const endDateStr = formatDateTime(effectiveEnd, isAllDay, locale);
+		return `${startDateStr}${config.rangeSeparator}${endDateStr}`;
+	}
 }
-function getScheduleSummary(scheduleList, locale = "zh-CN") {
-  try {
-    if (!scheduleList || !Array.isArray(scheduleList)) {
-      return "";
-    }
-    if (scheduleList.length > 1) {
-      return getText(locale, "multipleRules");
-    }
-    if (scheduleList.length === 0) {
-      return "";
-    }
-    const schedule = scheduleList[0];
-    if (!schedule) {
-      return "";
-    }
-    const now = (0, import_dayjs.default)();
-    let startTime = null;
-    if (schedule.start_time) {
-      startTime = (0, import_dayjs.default)(schedule.start_time);
-    } else if (schedule.designation && schedule.designation.length > 0) {
-      const firstDesignation = schedule.designation[0];
-      if (firstDesignation && firstDesignation.start_date && firstDesignation.start_time) {
-        startTime = (0, import_dayjs.default)(`${firstDesignation.start_date} ${firstDesignation.start_time}`);
-      }
-    }
-    const isStarted = startTime ? isTimeStarted(now, startTime) : false;
-    return generateSummaryText(schedule, isStarted, locale);
-  } catch (error) {
-    console.warn("Error in getScheduleSummary:", error);
-    return "";
-  }
+/**
+* 获取schedule摘要信息
+* @param scheduleList 日程列表
+* @param locale 语言设置
+* @returns 摘要文本
+*/
+function getScheduleSummary(scheduleList, locale = "zh-CN", validity) {
+	try {
+		locale = textConfig[locale] ? locale : "en";
+		if (!scheduleList || !Array.isArray(scheduleList)) return "";
+		if (scheduleList.length > 1) {
+			const range = getWalletValidityRange(null, null, validity);
+			if (!range.startDate && !range.endDate) return getText(locale, "multipleRules");
+			const summaries = scheduleList.map((schedule) => getScheduleSummary([schedule], locale, validity)).filter((summary) => summary !== getText(locale, "noAvailableDates"));
+			if (summaries.length === 0) return getText(locale, "noAvailableDates");
+			if (summaries.length === 1 && summaries[0]) return summaries[0];
+			return `${range.endDate ? `${formatDateRange(range.startDate || "", range.endDate, false, locale, true)}${getText(locale, "periodSeparator")}` : ""}${getText(locale, "multipleRules")}`;
+		}
+		if (scheduleList.length === 0) return "";
+		const schedule = scheduleList[0];
+		if (!schedule) return "";
+		const now = (0, dayjs.default)();
+		let startTime = null;
+		if (schedule.start_time) startTime = (0, dayjs.default)(schedule.start_time);
+		else if (schedule.designation && schedule.designation.length > 0) {
+			const firstDesignation = schedule.designation[0];
+			if (firstDesignation && firstDesignation.start_date && firstDesignation.start_time) startTime = (0, dayjs.default)(`${firstDesignation.start_date} ${firstDesignation.start_time}`);
+		}
+		const passStart = getValidityDate(validity === null || validity === void 0 ? void 0 : validity.start_date);
+		if (passStart && (!startTime || (0, dayjs.default)(passStart).isAfter(startTime))) startTime = (0, dayjs.default)(passStart);
+		const summary = generateSummaryText(schedule, startTime ? isTimeStarted(now, startTime) : false, locale, validity);
+		if (summary === getText(locale, "noAvailableDates")) {
+			var _schedule$repeat_rule;
+			const included = (_schedule$repeat_rule = schedule.repeat_rule) === null || _schedule$repeat_rule === void 0 || (_schedule$repeat_rule = _schedule$repeat_rule.included_date) === null || _schedule$repeat_rule === void 0 ? void 0 : _schedule$repeat_rule.filter((item) => !getWalletValidityRange(item.start, item.end, validity).isEmpty);
+			if (included === null || included === void 0 ? void 0 : included.length) return getScheduleSummary([require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, schedule), {}, {
+				start_time: null,
+				end_time: null,
+				type: "designation",
+				repeat_type: "none",
+				repeat_rule: null,
+				is_all: 1,
+				designation: included.map((item) => ({
+					start_date: item.start,
+					end_date: item.end,
+					start_time: "00:00",
+					end_time: "23:59"
+				}))
+			})], locale, validity);
+		}
+		return summary;
+	} catch (error) {
+		console.warn("Error in getScheduleSummary:", error);
+		return "";
+	}
 }
+/**
+* 判断开始时间是否在当前时间之后
+* @param now 当前时间
+* @param startTime 开始时间
+* @returns 是否已开始
+*/
 function isTimeStarted(now, startTime) {
-  return startTime.isBefore(now);
+	return startTime.isBefore(now);
 }
-function generateSummaryText(schedule, isStarted, locale) {
-  if (schedule.type === "designation" && schedule.designation && schedule.designation.length > 1) {
-    return getText(locale, "multipleRules");
-  }
-  if (schedule.type === "time-slots") {
-    const endDate = getScheduleEndDate(schedule);
-    if (!endDate) return "";
-    const endDateStr = formatDateTime(endDate, true, locale);
-    const prefix = "";
-    const suffix = getText(locale, "multipleSlots");
-    return `${prefix}${endDateStr}${suffix}`;
-  }
-  if (schedule.repeat_type !== "none" && schedule.repeat_rule) {
-    return generateRecurringSummary(schedule, isStarted, locale);
-  }
-  return generateSingleScheduleSummary(schedule, isStarted, locale);
+/**
+* 生成摘要文本
+* @param schedule 日程对象
+* @param isStarted 是否已开始
+* @param locale 语言设置
+* @returns 生成的摘要文本
+*/
+function generateSummaryText(schedule, isStarted, locale, validity) {
+	if (schedule.type === "designation" && schedule.designation && schedule.designation.length > 1) {
+		const passRange = getWalletValidityRange(null, null, validity);
+		if (!passRange.startDate && !passRange.endDate) return getText(locale, "multipleRules");
+		const designation = schedule.designation.filter((item) => !getWalletValidityRange(item.start_date, item.end_date, validity).isEmpty);
+		if (!designation.length) return getText(locale, "noAvailableDates");
+		if (designation.length === 1) return generateSingleScheduleSummary(require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, schedule), {}, { designation }), isStarted, locale, validity);
+		const range = getWalletValidityRange(designation.map((item) => item.start_date).sort()[0], designation.map((item) => item.end_date).sort().pop(), validity);
+		return `${range.endDate ? `${formatDateRange(range.startDate || "", range.endDate, isStarted, locale, true)}${getText(locale, "periodSeparator")}` : ""}${getText(locale, "multipleRules")}`;
+	}
+	if (schedule.type === "time-slots") {
+		const range = getWalletValidityRange(schedule.start_time, getScheduleEndDate(schedule), validity);
+		if (range.isEmpty) return getText(locale, "noAvailableDates");
+		return `${range.endDate ? formatDateTime(range.endDate, true, locale) : getText(locale, "unlimited")}${getText(locale, "multipleSlots")}`;
+	}
+	if (schedule.repeat_type !== "none" && schedule.repeat_rule) return generateRecurringSummary(schedule, isStarted, locale, validity);
+	return generateSingleScheduleSummary(schedule, isStarted, locale, validity);
 }
-function generateRecurringSummary(schedule, isStarted, locale) {
-  const { repeat_type, repeat_rule } = schedule;
-  if (!repeat_rule) return "";
-  const { frequency, frequency_date, end } = repeat_rule;
-  if (end.type === "never") {
-    return generateNeverEndingRecurringSummary(schedule, isStarted, locale, repeat_type, frequency, frequency_date);
-  }
-  const endDate = getScheduleEndDate(schedule);
-  if (!endDate) return "";
-  const endDateStr = formatDateTime(endDate, true, locale);
-  if (repeat_type === "daily") {
-    const frequencyText = getDailyFrequencyText(frequency, locale);
-    const dateRange = formatDateRange(schedule.start_time, endDate, isStarted, locale, true);
-    return `${dateRange}，${frequencyText}`;
-  }
-  if (repeat_type === "weekly") {
-    const weekdaysText = getWeekdayText(frequency_date, locale, "/");
-    const frequencyPrefix = getWeeklyFrequencyPrefix(frequency, locale);
-    const config = getConfig(locale);
-    const dateRange = formatDateRange(schedule.start_time, endDate, isStarted, locale, true);
-    return `${dateRange}，${frequencyPrefix}${config.weekPrefix}${weekdaysText}`;
-  }
-  return "";
+/**
+* 生成循环日程摘要
+* @param schedule 日程对象
+* @param isStarted 是否已开始
+* @param locale 语言设置
+* @returns 循环日程摘要文本
+*/
+function generateRecurringSummary(schedule, isStarted, locale, validity) {
+	const { repeat_type, repeat_rule } = schedule;
+	if (!repeat_rule) return "";
+	const { frequency, frequency_date, end } = repeat_rule;
+	const range = getWalletValidityRange(schedule.start_time, getScheduleEndDate(schedule), validity);
+	if (range.isEmpty) return getText(locale, "noAvailableDates");
+	if (end.type === "never" && !range.endDate) return generateNeverEndingRecurringSummary(schedule, isStarted, locale, repeat_type, frequency, frequency_date, validity);
+	const endDate = range.endDate;
+	if (!endDate) return "";
+	if (repeat_type === "daily") {
+		const frequencyText = getDailyFrequencyText(frequency, locale);
+		return `${formatDateRange(schedule.start_time, endDate, isStarted, locale, true, validity)}${getText(locale, "timeSlotSeparator")}${frequencyText}`;
+	}
+	if (repeat_type === "weekly") {
+		const weekdaysText = getWeekdayText(frequency_date, locale, "/");
+		const frequencyPrefix = getWeeklyFrequencyPrefix(frequency, locale);
+		const config = getConfig(locale);
+		return `${formatDateRange(schedule.start_time, endDate, isStarted, locale, true, validity)}${config.timeSlotSeparator}${frequencyPrefix}${config.weekPrefix}${weekdaysText}`;
+	}
+	return "";
 }
-function generateNeverEndingRecurringSummary(schedule, isStarted, locale, repeatType, frequency, frequencyDate) {
-  const config = getConfig(locale);
-  if (repeatType === "daily") {
-    if (frequency === 1) {
-      if (schedule.start_time) {
-        const startDateStr = formatDateTime(schedule.start_time, true, locale);
-        return `${config.longTermValidFrom}${startDateStr}${config.noExpiry}`;
-      }
-      return "";
-    } else {
-      const frequencyText = getDailyFrequencyText(frequency, locale);
-      if (locale === "en") {
-        return `${frequencyText}`;
-      } else {
-        return `${frequencyText}${config.available}`;
-      }
-    }
-  }
-  if (repeatType === "weekly") {
-    const weekdaysText = getWeekdayText(frequencyDate, locale, locale === "en" ? " & " : "/");
-    if (frequency === 1) {
-      if (locale === "en") {
-        return `${config.on}${weekdaysText}`;
-      } else {
-        return `${config.everyPrefix}${config.weekPrefix}${weekdaysText}${config.available}`;
-      }
-    } else {
-      const frequencyPrefix = getWeeklyFrequencyPrefix(frequency, locale);
-      if (locale === "en") {
-        return `${frequencyPrefix}${config.on}${weekdaysText}`;
-      } else {
-        return `${frequencyPrefix}${config.weekPrefix}${weekdaysText}`;
-      }
-    }
-  }
-  return "";
+/**
+* 生成永不结束的循环日程摘要
+* @param schedule 日程对象
+* @param isStarted 是否已开始
+* @param locale 语言设置
+* @param repeatType 循环类型
+* @param frequency 频率
+* @param frequencyDate 频率日期数组（用于周循环）
+* @returns 永不结束的循环日程摘要文本
+*/
+function generateNeverEndingRecurringSummary(schedule, isStarted, locale, repeatType, frequency, frequencyDate, validity) {
+	const config = getConfig(locale);
+	if (repeatType === "daily") if (frequency === 1) {
+		const range = getWalletValidityRange(schedule.start_time, null, validity);
+		if (range.startDate) {
+			const startDateStr = formatDateTime(range.startDate, true, locale);
+			return `${config.longTermValidFrom}${startDateStr}${config.noExpiry}`;
+		}
+		return "";
+	} else {
+		const frequencyText = getDailyFrequencyText(frequency, locale);
+		if (locale === "en") return `${frequencyText}`;
+		else return `${frequencyText}${config.available}`;
+	}
+	if (repeatType === "weekly") {
+		const weekdaysText = getWeekdayText(frequencyDate, locale, locale === "en" ? " & " : "/");
+		if (frequency === 1) if (locale === "en") return `${config.on}${weekdaysText}`;
+		else return `${config.everyPrefix}${config.weekPrefix}${weekdaysText}${config.available}`;
+		else {
+			const frequencyPrefix = getWeeklyFrequencyPrefix(frequency, locale);
+			if (locale === "en") return `${frequencyPrefix}${config.on}${weekdaysText}`;
+			else return `${frequencyPrefix}${config.weekPrefix}${weekdaysText}`;
+		}
+	}
+	return "";
 }
-function generateSingleScheduleSummary(schedule, isStarted, locale) {
-  const isAllDay = schedule.is_all === 1;
-  if (schedule.type === "designation" && schedule.designation && schedule.designation.length === 1) {
-    const designation = schedule.designation[0];
-    const startDate = designation.start_date;
-    const endDate = designation.end_date;
-    const startTime = designation.start_time;
-    const endTime = designation.end_time;
-    const isDesignationAllDay = isAllDaySchedule(startTime, endTime);
-    if (isDesignationAllDay || isAllDay) {
-      return formatDateRange(startDate, endDate, isStarted, locale, true);
-    } else {
-      const startDateTime = `${startDate} ${startTime}${CONSTANTS.SECONDS_SUFFIX}`;
-      const endDateTime = `${endDate} ${endTime}${CONSTANTS.SECONDS_SUFFIX}`;
-      return formatDateRange(startDateTime, endDateTime, isStarted, locale, false);
-    }
-  }
-  if (isAllDay) {
-    const endDate = getScheduleEndDate(schedule);
-    if (!endDate) return "";
-    return formatDateRange(schedule.start_time, endDate, isStarted, locale, true);
-  } else {
-    return formatDateRange(schedule.start_time, schedule.end_time, isStarted, locale, false);
-  }
+/**
+* 生成单个日程摘要
+* @param schedule 日程对象
+* @param isStarted 是否已开始
+* @param locale 语言设置
+* @returns 单个日程摘要文本
+*/
+function generateSingleScheduleSummary(schedule, isStarted, locale, validity) {
+	const isAllDay = schedule.is_all === 1;
+	if (schedule.type === "designation" && schedule.designation && schedule.designation.length === 1) {
+		const designation = schedule.designation[0];
+		const startDate = designation.start_date;
+		const endDate = designation.end_date;
+		const startTime = designation.start_time;
+		const endTime = designation.end_time;
+		if (isAllDaySchedule(startTime, endTime) || isAllDay) return formatDateRange(startDate, endDate, isStarted, locale, true, validity);
+		else return formatDateRange(`${startDate} ${startTime}${CONSTANTS.SECONDS_SUFFIX}`, `${endDate} ${endTime}${CONSTANTS.SECONDS_SUFFIX}`, isStarted, locale, false, validity);
+	}
+	if (isAllDay) {
+		const endDate = getScheduleEndDate(schedule);
+		if (!endDate) return "";
+		return formatDateRange(schedule.start_time, endDate, isStarted, locale, true, validity);
+	} else return formatDateRange(schedule.start_time, schedule.end_time, isStarted, locale, false, validity);
 }
+/**
+* 获取日程结束日期
+* @param schedule 日程对象
+* @returns 结束日期字符串，如果无法确定则返回null
+*/
 function getScheduleEndDate(schedule) {
-  try {
-    if (schedule.repeat_rule) {
-      if (schedule.repeat_rule.end.type === "never") {
-        const futureDate = (0, import_dayjs.default)().add(CONSTANTS.DEFAULT_FUTURE_YEARS, "year");
-        return `${futureDate.format("YYYY-MM-DD")} ${CONSTANTS.ALL_DAY_END}${CONSTANTS.SECONDS_SUFFIX}`;
-      } else if (schedule.repeat_rule.end.end_date) {
-        return `${schedule.repeat_rule.end.end_date} ${CONSTANTS.ALL_DAY_END}${CONSTANTS.SECONDS_SUFFIX}`;
-      }
-    }
-    if (schedule.designation && schedule.designation.length > 0) {
-      const lastDesignation = schedule.designation[schedule.designation.length - 1];
-      return `${lastDesignation.end_date} ${lastDesignation.end_time}${CONSTANTS.SECONDS_SUFFIX}`;
-    }
-    if (schedule.end_time) {
-      return schedule.end_time;
-    }
-    if (schedule.start_time) {
-      return schedule.start_time;
-    }
-    return null;
-  } catch (error) {
-    console.warn("Error in getScheduleEndDate:", error);
-    return null;
-  }
+	try {
+		if (schedule.repeat_rule) {
+			if (schedule.repeat_rule.end.type === "never") return null;
+			else if (schedule.repeat_rule.end.end_date) return `${schedule.repeat_rule.end.end_date} ${CONSTANTS.ALL_DAY_END}${CONSTANTS.SECONDS_SUFFIX}`;
+		}
+		if (schedule.designation && schedule.designation.length > 0) {
+			const lastDesignation = schedule.designation[schedule.designation.length - 1];
+			return `${lastDesignation.end_date} ${lastDesignation.end_time}${CONSTANTS.SECONDS_SUFFIX}`;
+		}
+		if (schedule.end_time) return schedule.end_time;
+		if (schedule.start_time) return schedule.start_time;
+		return null;
+	} catch (error) {
+		console.warn("Error in getScheduleEndDate:", error);
+		return null;
+	}
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getScheduleSummary
-});
+//#endregion
+exports.getScheduleSummary = getScheduleSummary;
+exports.getWalletValidityRange = getWalletValidityRange;