@cloudcome/utils-core 1.1.1 → 1.2.1

package/dist/date.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.mjs","sources":["../src/date/start-end.ts","../src/date/days.ts","../src/date/relative.ts","../src/date/is.ts","../src/date/weeks.ts"],"sourcesContent":["import { type DateLike, type DateValue, dateParse } from './core';\n\n/**\n * 时间单位符号枚举\n * - 'Y': 年\n * - 'M': 月\n * - 'D': 天\n * - 'W': 周\n * - 'h': 小时\n * - 'm': 分钟\n * - 's': 秒\n */\ntype _TDateOfSymbol = 'Y' | 'M' | 'D' | 'W' | 'h' | 'm' | 's';\n\n/**\n * 各时间单位起始时间映射表\n * 包含将日期设置到单位起始时间的函数\n */\nconst dateOfStartMap: [_TDateOfSymbol, (date: DateLike) => unknown][] = [\n  ['s', (d) => d.setMilliseconds(0)],\n  ['m', (d) => d.setSeconds(0)],\n  ['h', (d) => d.setMinutes(0)],\n  ['D', (d) => d.setHours(0)],\n  ['W', (d) => d.setHours(0)],\n  ['M', (d) => d.setDate(1)],\n  ['Y', (d) => d.setMonth(0)],\n];\n\n/**\n * 返回指定时间单位的起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param symbol - 时间单位符号，可选值为 'Y'（年）、'M'（月）、'D'（天）、'h'（小时）、'm'（分钟）、's'（秒），默认为 'D'\n * @returns 返回指定时间单位的起始时间\n * @example\n * ```typescript\n * const date = new Date(2023, 5, 15, 12, 30, 45, 500); // 2023-06-15 12:30:45.500\n *\n * // 返回秒级起始时间\n * dateOfStart(date, 's'); // 2023-06-15 12:30:45.000\n *\n * // 返回分钟级起始时间\n * dateOfStart(date, 'm'); // 2023-06-15 12:30:00.000\n *\n * // 返回小时级起始时间\n * dateOfStart(date, 'h'); // 2023-06-15 12:00:00.000\n *\n * // 返回天级起始时间\n * dateOfStart(date, 'D'); // 2023-06-15 00:00:00.000\n *\n * // 返回月级起始时间\n * dateOfStart(date, 'M'); // 2023-06-01 00:00:00.000\n *\n * // 返回年级起始时间\n * dateOfStart(date, 'Y'); // 2023-01-01 00:00:00.000\n *\n * // 默认返回天级起始时间\n * dateOfStart(date); // 2023-06-15 00:00:00.000\n * ```\n */\nfunction _dateStart(dateValue: DateValue, symbol: _TDateOfSymbol = 'D') {\n  const date = dateParse(dateValue);\n\n  for (const [sym, fn] of dateOfStartMap) {\n    fn(date);\n    if (symbol === sym) break;\n  }\n\n  return date;\n}\n\n/**\n * 返回秒级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回秒级起始时间，毫秒部分为 0\n */\nexport function dateStartInSecond(dateValue: DateValue) {\n  return _dateStart(dateValue, 's');\n}\n\n/**\n * 返回分钟级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回分钟级起始时间，秒和毫秒部分为 0\n */\nexport function dateStartInMinute(dateValue: DateValue) {\n  return _dateStart(dateValue, 'm');\n}\n\n/**\n * 返回小时级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回小时级起始时间，分钟、秒和毫秒部分为 0\n */\nexport function dateStartInHour(dateValue: DateValue) {\n  return _dateStart(dateValue, 'h');\n}\n\n/**\n * 返回天级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回天级起始时间，小时、分钟、秒和毫秒部分为 0\n */\nexport function dateStartInDay(dateValue: DateValue) {\n  return _dateStart(dateValue, 'D');\n}\n\n/**\n * 返回月级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回月级起始时间，日期为当月第一天，时间部分为 0\n */\nexport function dateStartInMonth(dateValue: DateValue) {\n  return _dateStart(dateValue, 'M');\n}\n\n/**\n * 返回年级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回年级起始时间，月份为 1 月，日期为 1 日，时间部分为 0\n */\nexport function dateStartInYear(dateValue: DateValue) {\n  return _dateStart(dateValue, 'Y');\n}\n\n/**\n * 各时间单位结束时间映射表\n * 包含将日期设置到单位结束时间的函数\n */\nconst dateOfEndMap: [_TDateOfSymbol, (date: DateLike) => unknown][] = [\n  ['s', (d) => d.setMilliseconds(999)],\n  ['m', (d) => d.setSeconds(59)],\n  ['h', (d) => d.setMinutes(59)],\n  ['D', (d) => d.setHours(23)],\n  [\n    'M',\n    (d) => {\n      const d2 = dateParse(d);\n      d2.setMonth(d.getMonth() + 1);\n      d2.setDate(0);\n      d.setDate(d2.getDate());\n    },\n  ],\n  [\n    'Y',\n    (d) => {\n      d.setMonth(11);\n      d.setDate(31);\n    },\n  ],\n];\n\n/**\n * 返回指定时间单位的结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param symbol - 时间单位符号，可选值为 'Y'（年）、'M'（月）、'D'（天）、'h'（小时）、'm'（分钟）、's'（秒），默认为 'D'\n * @returns 返回指定时间单位的结束时间\n * @example\n * ```typescript\n * const date = new Date(2023, 5, 15, 12, 30, 45, 500); // 2023-06-15 12:30:45.500\n *\n * // 返回秒级结束时间\n * dateOfEnd(date, 's'); // 2023-06-15 12:30:45.999\n *\n * // 返回分钟级结束时间\n * dateOfEnd(date, 'm'); // 2023-06-15 12:30:59.999\n *\n * // 返回小时级结束时间\n * dateOfEnd(date, 'h'); // 2023-06-15 12:59:59.999\n *\n * // 返回天级结束时间\n * dateOfEnd(date, 'D'); // 2023-06-15 23:59:59.999\n *\n * // 返回月级结束时间\n * dateOfEnd(date, 'M'); // 2023-06-30 23:59:59.999\n *\n * // 返回年级结束时间\n * dateOfEnd(date, 'Y'); // 2023-12-31 23:59:59.999\n *\n * // 默认返回天级结束时间\n * dateOfEnd(date); // 2023-06-15 23:59:59.999\n * ```\n */\nfunction _dateEnd(dateValue: DateValue, symbol: _TDateOfSymbol = 'D') {\n  const date = dateParse(dateValue);\n\n  for (const [sym, fn] of dateOfEndMap) {\n    fn(date);\n    if (symbol === sym) break;\n  }\n\n  return date;\n}\n\n/**\n * 返回秒级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回秒级结束时间，毫秒部分为 999\n */\nexport function dateEndInSecond(dateValue: DateValue) {\n  return _dateEnd(dateValue, 's');\n}\n\n/**\n * 返回分钟级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回分钟级结束时间，秒为 59，毫秒为 999\n */\nexport function dateEndInMinute(dateValue: DateValue) {\n  return _dateEnd(dateValue, 'm');\n}\n\n/**\n * 返回小时级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回小时级结束时间，分钟为 59，秒为 59，毫秒为 999\n */\nexport function dateEndInHour(dateValue: DateValue) {\n  return _dateEnd(dateValue, 'h');\n}\n\n/**\n * 返回天级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回天级结束时间，小时为 23，分钟为 59，秒为 59，毫秒为 999\n */\nexport function dateEndInDay(dateValue: DateValue) {\n  return _dateEnd(dateValue, 'D');\n}\n\n/**\n * 返回月级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回月级结束时间，日期为当月最后一天，时间为 23:59:59.999\n */\nexport function dateEndInMonth(dateValue: DateValue) {\n  return _dateEnd(dateValue, 'M');\n}\n\n/**\n * 返回年级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回年级结束时间，月份为 12 月，日期为 31 日，时间为 23:59:59.999\n */\nexport function dateEndInYear(dateValue: DateValue) {\n  return _dateEnd(dateValue, 'Y');\n}\n","import { DATE_DAY_MS } from './const';\nimport { type DateValue, dateParse } from './core';\nimport { dateEndInMonth, dateEndInYear, dateStartInMonth, dateStartInYear } from './start-end';\n\n/**\n * 计算指定日期所在年或月的天数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param unit - 时间单位符号，可选值为 'Y'（年）、'M'（月），默认为 'M'\n * @returns 返回指定日期所在年或月的天数\n * @example\n * ```typescript\n * dateDays(new Date('2023-02-15')); // 28\n * dateDays(new Date('2024-02-15')); // 29 (闰年)\n * dateDays(new Date('2023-02-15'), 'Y'); // 365\n * dateDays(new Date('2024-02-15'), 'Y'); // 366 (闰年)\n * ```\n */\nfunction _dateDays(dateValue: DateValue, unit: 'Y' | 'M') {\n  const d = dateParse(dateValue);\n  const ds = unit === 'M' ? dateStartInMonth(d) : dateStartInYear(d);\n  const de = unit === 'M' ? dateEndInMonth(d) : dateEndInYear(d);\n  return Math.ceil((de.getTime() - ds.getTime()) / DATE_DAY_MS);\n}\n\n/**\n * 计算指定日期所在月份的天数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回指定日期所在月份的天数\n * @example\n * ```typescript\n * dateDaysInMonth(new Date('2023-02-15')); // 28\n * dateDaysInMonth(new Date('2024-02-15')); // 29 (闰年)\n * ```\n */\nexport function dateDaysInMonth(dateValue: DateValue) {\n  return _dateDays(dateValue, 'M');\n}\n\n/**\n * 计算指定日期所在年份的天数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回指定日期所在年份的天数\n * @example\n * ```typescript\n * dateDaysInYear(new Date('2023-02-15')); // 365\n * dateDaysInYear(new Date('2024-02-15')); // 366 (闰年)\n * ```\n */\nexport function dateDaysInYear(dateValue: DateValue) {\n  return _dateDays(dateValue, 'Y');\n}\n","import { stringFormat } from '@/string';\nimport { isArray } from '@/type';\nimport { type DateValue, dateFormat, dateParse } from './core';\n\nexport type DateRelativeTemplate = [\n  number /*单位时间差，为 0 表示不计算单位差值，单位秒*/,\n  number /*最大时间差，单位：秒*/,\n  string /*过去模板字符串，%d 表述单位差值*/,\n  string? /*将来模板字符串，%d 表述单位差值，可选*/,\n];\nexport type DateRelativeTemplates = DateRelativeTemplate[];\n\nconst defaultDiffTemplates: DateRelativeTemplates = [\n  [0, 10, '刚刚'],\n  [1, 60, '{n} 秒前', '{n} 秒后'],\n  [60, 60 * 60, '{n} 分钟前', '{n} 分钟后'],\n  [60 * 60, 60 * 60 * 24, '{n} 小时前', '{n} 小时后'],\n  [0, 60 * 60 * 24 * 2, '昨天', '明天'],\n  [0, 60 * 60 * 24 * 3, '前天', '后天'],\n  [60 * 60 * 24, 60 * 60 * 24 * 30, '{n} 天前', '{n} 天后'],\n  [0, Number.POSITIVE_INFINITY, 'YYYY年MM月DD日'],\n];\n\n/**\n * 相对时间\n * @param {DateValue} dateValue 比较的时间\n * @param {DateValue} [refDateValue] 相对的时间，默认为当前\n * @param {DateRelativeTemplates} [templates] 模板\n * @returns {string} 格式化后的相对时间字符串\n * @example\n * ```typescript\n * // 默认模板\n * dateRelative(new Date('2023-01-01')); // '刚刚'\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-02')); // '昨天'\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-04')); // '3 天前'\n * dateRelative(new Date('2023-01-01'), new Date('2023-02-01')); // '2023年01月01日'\n * ```\n * @example\n * ```typescript\n * // 自定义模板\n * const templates: DateRelativeTemplates = [\n *   [0, 10, '刚刚'],\n *   [1, 60, '{n} 秒前', '{n} 秒后'],\n *   [60, 60 * 60, '{n} 分钟前', '{n} 分钟后'],\n *   [60 * 60, 60 * 60 * 24, '{n} 小时前', '{n} 小时后'],\n *   [0, 60 * 60 * 24 * 2, '昨天', '明天'],\n *   [0, 60 * 60 * 24 * 3, '前天', '后天'],\n *   [60 * 60 * 24, 60 * 60 * 24 * 30, '{n} 天前', '{n} 天后'],\n *   [0, Number.POSITIVE_INFINITY, 'YYYY年MM月DD日'],\n * ];\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-02'), templates); // '昨天'\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-04'), templates); // '3 天前'\n * dateRelative(new Date('2023-01-01'), new Date('2023-02-01'), templates); // '2023年01月01日'\n * ```\n */\nexport function dateRelative(dateValue: DateValue, refDateValue: DateValue, templates: DateRelativeTemplates): string;\nexport function dateRelative(dateValue: DateValue, refDateValue: DateValue): string;\nexport function dateRelative(dateValue: DateValue, templates: DateRelativeTemplates): string;\nexport function dateRelative(dateValue: DateValue): string;\nexport function dateRelative(\n  dateValue: DateValue,\n  refDateValue?: DateValue | DateRelativeTemplates,\n  templates?: DateRelativeTemplates,\n): string {\n  const now = Date.now();\n  const refDateValueFinal = isArray(refDateValue) ? now : refDateValue || now;\n  const templatesFinal = isArray(templates) ? templates : isArray(refDateValue) ? refDateValue : defaultDiffTemplates;\n  const d1 = dateParse(dateValue);\n  const d2 = dateParse(refDateValueFinal);\n  const diff = d1.getTime() - d2.getTime();\n  const isAgo = diff < 0;\n  const absDiff = Math.abs(diff);\n  let relative = '';\n\n  for (const [base, max, agoTemplate, featureTemplate] of templatesFinal) {\n    const unitFinal = base * 1000;\n    const maxFinal = max * 1000;\n\n    if (absDiff < maxFinal) {\n      const template = isAgo ? agoTemplate : featureTemplate || agoTemplate;\n      const length = unitFinal === 0 ? 0 : Math.max(Math.floor(absDiff / unitFinal), 1);\n      relative = unitFinal === 0 ? dateFormat(dateValue, template) : stringFormat(template, { n: length });\n      break;\n    }\n  }\n\n  return relative;\n}\n","import { type DateLike, type DateValue, dateParse } from './core';\n\n/**\n * 判断给定的年份是否为闰年\n * @param year - 需要判断的年份\n * @returns 如果年份是闰年则返回 true，否则返回 false\n * @example\n * ```typescript\n * isLeapYear(2020); // true\n * isLeapYear(2021); // false\n * isLeapYear(2000); // true\n * isLeapYear(1900); // false\n * ```\n */\nexport function isLeapYear(year: number): boolean {\n  if (year % 4 !== 0) return false;\n  if (year % 100 !== 0) return true;\n  if (year % 400 !== 0) return false;\n  return true;\n}\n\n/**\n * 日期比较精度枚举类型\n * - Y = 年\n * - M = 月\n * - D = 天\n * - h = 小时\n * - m = 分钟\n * - s = 秒\n * - S = 毫秒\n */\ntype _DateSameSymbol = 'Y' | 'M' | 'D' | 'h' | 'm' | 's' | 'S';\n\n/**\n * 比较两个日期在指定精度下是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @param sameSymbol - 比较精度，默认为 'D'（天，即年月日天都相同）\n * @returns 如果两个日期在指定精度下相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12, 30, 45, 500);\n * const date2 = new Date(2023, 5, 15, 13, 30, 45, 500);\n *\n * // 比较年份\n * isSameDate(date1, date2, 'Y'); // true\n *\n * // 比较月份（年份也要相同）\n * isSameDate(date1, date2, 'M'); // true\n *\n * // 比较日期（默认，年份、月份也要相同）\n * isSameDate(date1, date2); // true\n *\n * // 比较小时（年、月、日也要相同）\n * isSameDate(date1, date2, 'h'); // false\n *\n * // 比较分钟（年、月、日、小时也要相同）\n * isSameDate(date1, date2, 'm'); // false\n *\n * // 比较秒（年、月、日、小时、分钟也要相同）\n * isSameDate(date1, date2, 's'); // false\n *\n * // 比较毫秒（年、月、日、小时、分钟、秒数也要相同）\n * isSameDate(date1, date2, 'S'); // false\n * ```\n */\nfunction _isSameDateIn(date1: DateValue, date2: DateValue, sameSymbol: _DateSameSymbol = 'D') {\n  const defines = [\n    ['Y', (d: DateLike) => d.getFullYear()],\n    ['M', (d: DateLike) => d.getMonth()],\n    ['D', (d: DateLike) => d.getDate()],\n    ['h', (d: DateLike) => d.getHours()],\n    ['m', (d: DateLike) => d.getMinutes()],\n    ['s', (d: DateLike) => d.getSeconds()],\n    ['S', (d: DateLike) => d.getMilliseconds()],\n  ] as const;\n\n  const d1 = dateParse(date1);\n  const d2 = dateParse(date2);\n\n  for (const [sym, fn] of defines) {\n    if (fn(d1) !== fn(d2)) {\n      return false;\n    }\n\n    if (sym === sameSymbol) break;\n  }\n\n  return true;\n}\n\n/**\n * 比较两个日期的年份是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15);\n * const date2 = new Date(2023, 6, 20);\n * isSameDateInYear(date1, date2); // true\n * ```\n */\nexport function isSameDateInYear(date1: DateValue, date2: DateValue) {\n  return _isSameDateIn(date1, date2, 'Y');\n}\n\n/**\n * 比较两个日期的年份和月份是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份和月份相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15);\n * const date2 = new Date(2023, 5, 20);\n * isSameDateInMonth(date1, date2); // true\n * ```\n */\nexport function isSameDateInMonth(date1: DateValue, date2: DateValue) {\n  return _isSameDateIn(date1, date2, 'M');\n}\n\n/**\n * 比较两个日期的年份、月份和天数是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份和天数相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15);\n * const date2 = new Date(2023, 5, 15);\n * isSameDateInDay(date1, date2); // true\n * ```\n */\nexport function isSameDateInDay(date1: DateValue, date2: DateValue) {\n  return _isSameDateIn(date1, date2, 'D');\n}\n\n/**\n * 比较两个日期的年份、月份、天数和小时是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份、天数和小时相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12);\n * const date2 = new Date(2023, 5, 15, 12);\n * isSameDateInHour(date1, date2); // true\n * ```\n */\nexport function isSameDateInHour(date1: DateValue, date2: DateValue) {\n  return _isSameDateIn(date1, date2, 'h');\n}\n\n/**\n * 比较两个日期的年份、月份、天数、小时和分钟是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份、天数、小时和分钟相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12, 30);\n * const date2 = new Date(2023, 5, 15, 12, 30);\n * isSameDateInMinute(date1, date2); // true\n * ```\n */\nexport function isSameDateInMinute(date1: DateValue, date2: DateValue) {\n  return _isSameDateIn(date1, date2, 'm');\n}\n\n/**\n * 比较两个日期的年份、月份、天数、小时、分钟和秒数是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份、天数、小时、分钟和秒数相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12, 30, 45);\n * const date2 = new Date(2023, 5, 15, 12, 30, 45);\n * isSameDateInSecond(date1, date2); // true\n * ```\n */\nexport function isSameDateInSecond(date1: DateValue, date2: DateValue) {\n  return _isSameDateIn(date1, date2, 's');\n}\n","import { DATE_DAY_MS } from './const';\nimport { type DateValue, dateParse } from './core';\n\nexport enum EWeekStart {\n  /**\n   * 周日作为一周的起始日\n   */\n  sunday = 0,\n  /**\n   * 周一作为一周的起始日\n   */\n  monday = 1,\n  /**\n   * 周二作为一周的起始日\n   */\n  tuesday = 2,\n  /**\n   * 周三作为一周的起始日\n   */\n  wednesday = 3,\n  /**\n   * 周四作为一周的起始日\n   */\n  thursday = 4,\n  /**\n   * 周五作为一周的起始日\n   */\n  friday = 5,\n  /**\n   * 周六作为一周的起始日\n   */\n  saturday = 6,\n  // /**\n  //  * 1号所在的周为第一周\n  //  */\n  // firstDate = 7,\n  // /**\n  //  * 完整7天表示第一周\n  //  */\n  // firstFullWeek = 8,\n}\n\n/**\n * 计算指定日期所在年份或月份的周数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param type - 计算范围，'Y' 表示年份，'M' 表示月份\n * @param weekStart - 一周的起始日，默认为 0（周日）\n * @returns 返回指定日期所在年份或月份的周数\n * @example\n * ```typescript\n * const date = new Date(2023, 0, 1); // 2023-01-01\n * _dateWeeks(date, 'Y'); // 1 (计算年份的周数)\n * _dateWeeks(date, 'M'); // 1 (计算月份的周数)\n * _dateWeeks(date, 'Y', 1); // 1 (周一作为一周的起始日，计算年份的周数)\n * ```\n */\nexport function _dateWeeks(dateValue: DateValue, type: 'Y' | 'M', weekStart: EWeekStart = 0) {\n  const date = dateParse(dateValue);\n\n  const year = date.getFullYear();\n  const month = date.getMonth();\n\n  const firstDate = type === 'Y' ? new Date(year, 0, 1) : new Date(year, month, 1);\n  const firstWeek = firstDate.getDay();\n  const days = Math.ceil((date.getTime() - firstDate.getTime()) / DATE_DAY_MS);\n\n  return Math.ceil((firstWeek + days - weekStart) / 7);\n}\n\n/**\n * 计算指定日期所在年份的周数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param weekStart - 一周的起始日，默认为 0（周日）\n * @returns 返回指定日期所在年份的周数\n * @example\n * ```typescript\n * const date = new Date(2023, 0, 1); // 2023-01-01\n * weeksOfYear(date); // 1\n * weeksOfYear(date, 1); // 1 (周一作为一周的起始日)\n * ```\n */\nexport function weeksOfYear(dateValue: DateValue, weekStart: EWeekStart = 0) {\n  return _dateWeeks(dateValue, 'Y', weekStart);\n}\n\n/**\n * 计算指定日期所在月份的周数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param weekStart - 一周的起始日，默认为 0（周日）\n * @returns 返回指定日期所在月份的周数\n * @example\n * ```typescript\n * const date = new Date(2023, 0, 1); // 2023-01-01\n * weeksOfMonth(date); // 1\n * weeksOfMonth(date, 1); // 1 (周一作为一周的起始日)\n * ```\n */\nexport function weeksOfMonth(dateValue: DateValue, weekStart: EWeekStart = 0) {\n  return _dateWeeks(dateValue, 'M', weekStart);\n}\n"],"names":["d","d2","EWeekStart"],"mappings":"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"}

package/dist/dict.cjs

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=dict.cjs.map

package/dist/dict.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dict.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/dict.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=dict.mjs.map

package/dist/dict.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dict.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/each.cjs

@@ -0,0 +1,18 @@
+"use strict";
+function objectEach(obj, iterator) {
+  for (const [key, val] of Object.entries(obj)) {
+    if (iterator.call(obj, val, key) === false) {
+      break;
+    }
+  }
+}
+async function objectEachAsync(obj, iterator) {
+  for (const [key, val] of Object.entries(obj)) {
+    if (await iterator.call(obj, val, key) === false) {
+      break;
+    }
+  }
+}
+exports.objectEach = objectEach;
+exports.objectEachAsync = objectEachAsync;
+//# sourceMappingURL=each.cjs.map

package/dist/each.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"each.cjs","sources":["../src/object/each.ts"],"sourcesContent":["import type { AnyObject, MaybePromise } from '@/types';\n\n/**\n * 遍历对象的每个键值对，并对每个键值对执行提供的回调函数。\n *\n * @param obj - 要遍历的对象。\n * @param iterator - 对每个键值对执行的回调函数。如果回调函数返回 false，则提前终止遍历。\n *\n * @example\n * ```typescript\n * const obj = { a: 1, b: 2, c: 3 };\n * const results: [string, number][] = [];\n * objectEach(obj, (val, key) => {\n *   results.push([key, val]);\n * });\n * console.log(results); // [['a', 1], ['b', 2], ['c', 3]]\n * ```\n */\nexport function objectEach<O extends AnyObject, K extends keyof O & (string | number)>(\n  obj: O,\n  iterator: (this: O, val: O[K], key: K) => false | unknown,\n): void {\n  for (const [key, val] of Object.entries(obj)) {\n    if (iterator.call(obj, val as O[K], key as K) === false) {\n      break;\n    }\n  }\n}\n\n/**\n * 异步遍历对象的每个键值对，并对每个键值对执行提供的回调函数。\n *\n * @param obj - 要遍历的对象。\n * @param iterator - 对每个键值对执行的异步回调函数。如果回调函数返回 false，则提前终止遍历。\n * @returns 返回一个 Promise，当所有异步操作完成后，Promise 会被 resolve。\n *\n * @example\n * ```typescript\n * const obj = { a: 1, b: 2, c: 3 };\n * const results: [string, number][] = [];\n * await objectEachAsync(obj, async (val, key) => {\n *   results.push([key, val]);\n * });\n * console.log(results); // [['a', 1], ['b', 2], ['c', 3]]\n * ```\n */\nexport async function objectEachAsync<O extends AnyObject, K extends keyof O & (string | number)>(\n  obj: O,\n  iterator: (this: O, val: O[K], key: K) => MaybePromise<false | unknown>,\n): Promise<void> {\n  for (const [key, val] of Object.entries(obj)) {\n    if ((await iterator.call(obj, val as O[K], key as K)) === false) {\n      break;\n    }\n  }\n}\n"],"names":[],"mappings":";AAkBgB,SAAA,WACd,KACA,UACM;AACN,aAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,GAAG,GAAG;AAC5C,QAAI,SAAS,KAAK,KAAK,KAAa,GAAQ,MAAM,OAAO;AACvD;AAAA,IAAA;AAAA,EACF;AAEJ;AAmBsB,eAAA,gBACpB,KACA,UACe;AACf,aAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,GAAG,GAAG;AAC5C,QAAK,MAAM,SAAS,KAAK,KAAK,KAAa,GAAQ,MAAO,OAAO;AAC/D;AAAA,IAAA;AAAA,EACF;AAEJ;;;"}

package/dist/each.mjs

@@ -0,0 +1,19 @@
+function objectEach(obj, iterator) {
+  for (const [key, val] of Object.entries(obj)) {
+    if (iterator.call(obj, val, key) === false) {
+      break;
+    }
+  }
+}
+async function objectEachAsync(obj, iterator) {
+  for (const [key, val] of Object.entries(obj)) {
+    if (await iterator.call(obj, val, key) === false) {
+      break;
+    }
+  }
+}
+export {
+  objectEachAsync as a,
+  objectEach as o
+};
+//# sourceMappingURL=each.mjs.map

package/dist/each.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"each.mjs","sources":["../src/object/each.ts"],"sourcesContent":["import type { AnyObject, MaybePromise } from '@/types';\n\n/**\n * 遍历对象的每个键值对，并对每个键值对执行提供的回调函数。\n *\n * @param obj - 要遍历的对象。\n * @param iterator - 对每个键值对执行的回调函数。如果回调函数返回 false，则提前终止遍历。\n *\n * @example\n * ```typescript\n * const obj = { a: 1, b: 2, c: 3 };\n * const results: [string, number][] = [];\n * objectEach(obj, (val, key) => {\n *   results.push([key, val]);\n * });\n * console.log(results); // [['a', 1], ['b', 2], ['c', 3]]\n * ```\n */\nexport function objectEach<O extends AnyObject, K extends keyof O & (string | number)>(\n  obj: O,\n  iterator: (this: O, val: O[K], key: K) => false | unknown,\n): void {\n  for (const [key, val] of Object.entries(obj)) {\n    if (iterator.call(obj, val as O[K], key as K) === false) {\n      break;\n    }\n  }\n}\n\n/**\n * 异步遍历对象的每个键值对，并对每个键值对执行提供的回调函数。\n *\n * @param obj - 要遍历的对象。\n * @param iterator - 对每个键值对执行的异步回调函数。如果回调函数返回 false，则提前终止遍历。\n * @returns 返回一个 Promise，当所有异步操作完成后，Promise 会被 resolve。\n *\n * @example\n * ```typescript\n * const obj = { a: 1, b: 2, c: 3 };\n * const results: [string, number][] = [];\n * await objectEachAsync(obj, async (val, key) => {\n *   results.push([key, val]);\n * });\n * console.log(results); // [['a', 1], ['b', 2], ['c', 3]]\n * ```\n */\nexport async function objectEachAsync<O extends AnyObject, K extends keyof O & (string | number)>(\n  obj: O,\n  iterator: (this: O, val: O[K], key: K) => MaybePromise<false | unknown>,\n): Promise<void> {\n  for (const [key, val] of Object.entries(obj)) {\n    if ((await iterator.call(obj, val as O[K], key as K)) === false) {\n      break;\n    }\n  }\n}\n"],"names":[],"mappings":"AAkBgB,SAAA,WACd,KACA,UACM;AACN,aAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,GAAG,GAAG;AAC5C,QAAI,SAAS,KAAK,KAAK,KAAa,GAAQ,MAAM,OAAO;AACvD;AAAA,IAAA;AAAA,EACF;AAEJ;AAmBsB,eAAA,gBACpB,KACA,UACe;AACf,aAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,GAAG,GAAG;AAC5C,QAAK,MAAM,SAAS,KAAK,KAAK,KAAa,GAAQ,MAAO,OAAO;AAC/D;AAAA,IAAA;AAAA,EACF;AAEJ;"}

package/dist/easing.cjs

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const NEWTON_ITERATIONS = 4;
+const NEWTON_MIN_SLOPE = 1e-3;
+const SUBDIVISION_PRECISION = 1e-7;
+const SUBDIVISION_MAX_ITERATIONS = 10;
+const kSplineTableSize = 11;
+const kSampleStepSize = 1 / (kSplineTableSize - 1);
+const float32ArraySupported = typeof Float32Array === "function";
+function A(aA1, aA2) {
+  return 1 - 3 * aA2 + 3 * aA1;
+}
+function B(aA1, aA2) {
+  return 3 * aA2 - 6 * aA1;
+}
+function C(aA1) {
+  return 3 * aA1;
+}
+function calcBezier(aT, aA1, aA2) {
+  return ((A(aA1, aA2) * aT + B(aA1, aA2)) * aT + C(aA1)) * aT;
+}
+function getSlope(aT, aA1, aA2) {
+  return 3 * A(aA1, aA2) * aT * aT + 2 * B(aA1, aA2) * aT + C(aA1);
+}
+function binarySubdivide(aX, aA, aB, mX1, mX2) {
+  let currentX;
+  let currentT;
+  let i = 0;
+  let aBFinal = aB;
+  let aAFinal = aA;
+  do {
+    currentT = aAFinal + (aBFinal - aAFinal) / 2;
+    currentX = calcBezier(currentT, mX1, mX2) - aX;
+    if (currentX > 0) {
+      aBFinal = currentT;
+    } else {
+      aAFinal = currentT;
+    }
+  } while (Math.abs(currentX) > SUBDIVISION_PRECISION && ++i < SUBDIVISION_MAX_ITERATIONS);
+  return currentT;
+}
+function newtonRaphsonIterate(aX, aGuessT, mX1, mX2) {
+  let aGuessTFinal = aGuessT;
+  for (let i = 0; i < NEWTON_ITERATIONS; ++i) {
+    const currentSlope = getSlope(aGuessTFinal, mX1, mX2);
+    if (currentSlope === 0) {
+      return aGuessTFinal;
+    }
+    const currentX = calcBezier(aGuessTFinal, mX1, mX2) - aX;
+    aGuessTFinal -= currentX / currentSlope;
+  }
+  return aGuessTFinal;
+}
+function LinearEasing(x) {
+  return x;
+}
+function createEasingFn(x1, y1, x2, y2) {
+  if (!(0 <= x1 && x1 <= 1 && 0 <= x2 && x2 <= 1)) {
+    throw new Error("bezier x values must be in [0, 1] range");
+  }
+  if (x1 === y1 && x2 === y2) {
+    return LinearEasing;
+  }
+  const sampleValues = float32ArraySupported ? new Float32Array(kSplineTableSize) : new Array(kSplineTableSize);
+  for (let i = 0; i < kSplineTableSize; ++i) {
+    sampleValues[i] = calcBezier(i * kSampleStepSize, x1, x2);
+  }
+  function getTForX(aX) {
+    let intervalStart = 0;
+    let currentSample = 1;
+    const lastSample = kSplineTableSize - 1;
+    for (; currentSample !== lastSample && sampleValues[currentSample] <= aX; ++currentSample) {
+      intervalStart += kSampleStepSize;
+    }
+    --currentSample;
+    const dist = (aX - sampleValues[currentSample]) / (sampleValues[currentSample + 1] - sampleValues[currentSample]);
+    const guessForT = intervalStart + dist * kSampleStepSize;
+    const initialSlope = getSlope(guessForT, x1, x2);
+    if (initialSlope >= NEWTON_MIN_SLOPE) {
+      return newtonRaphsonIterate(aX, guessForT, x1, x2);
+    }
+    if (initialSlope === 0) {
+      return guessForT;
+    }
+    return binarySubdivide(aX, intervalStart, intervalStart + kSampleStepSize, x1, x2);
+  }
+  return function easingFunc(x) {
+    if (x === 0 || x === 1) {
+      return x;
+    }
+    return calcBezier(getTForX(x), y1, y2);
+  };
+}
+const easingEase = createEasingFn(0.25, 0.1, 0.25, 1);
+const easingLinear = createEasingFn(0, 0, 1, 1);
+const easingSnap = createEasingFn(0, 1, 0.5, 1);
+const easingIn = createEasingFn(0.42, 0, 1, 1);
+const easingOut = createEasingFn(0, 0, 0.58, 1);
+const easingInOut = createEasingFn(0.42, 0, 0.58, 1);
+const easingInQuad = createEasingFn(0.55, 0.085, 0.68, 0.53);
+const easingInCubic = createEasingFn(0.55, 0.055, 0.675, 0.19);
+const easingInQuart = createEasingFn(0.895, 0.03, 0.685, 0.22);
+const easingInQuint = createEasingFn(0.755, 0.05, 0.855, 0.06);
+const easingInSine = createEasingFn(0.47, 0, 0.745, 0.715);
+const easingInExpo = createEasingFn(0.95, 0.05, 0.795, 0.035);
+const easingInCirc = createEasingFn(0.6, 0.04, 0.98, 0.335);
+const easingInBack = createEasingFn(0.6, -0.28, 0.735, 0.045);
+const easingOutQuad = createEasingFn(0.25, 0.46, 0.45, 0.94);
+const easingOutCubic = createEasingFn(0.215, 0.61, 0.355, 1);
+const easingOutQuart = createEasingFn(0.165, 0.84, 0.44, 1);
+const easingOutQuint = createEasingFn(0.23, 1, 0.32, 1);
+const easingOutSine = createEasingFn(0.39, 0.575, 0.565, 1);
+const easingOutExpo = createEasingFn(0.19, 1, 0.22, 1);
+const easingOutCirc = createEasingFn(0.075, 0.82, 0.165, 1);
+const easingOutBack = createEasingFn(0.175, 0.885, 0.32, 1.275);
+const easingInOutQuart = createEasingFn(0.77, 0, 0.175, 1);
+const easingInOutQuint = createEasingFn(0.86, 0, 0.07, 1);
+const easingInOutSine = createEasingFn(0.445, 0.05, 0.55, 0.95);
+const easingInOutExpo = createEasingFn(1, 0, 0, 1);
+const easingInOutCirc = createEasingFn(0.785, 0.135, 0.15, 0.86);
+const easingInOutBack = createEasingFn(0.68, -0.55, 0.265, 1.55);
+exports.createEasingFn = createEasingFn;
+exports.easingEase = easingEase;
+exports.easingIn = easingIn;
+exports.easingInBack = easingInBack;
+exports.easingInCirc = easingInCirc;
+exports.easingInCubic = easingInCubic;
+exports.easingInExpo = easingInExpo;
+exports.easingInOut = easingInOut;
+exports.easingInOutBack = easingInOutBack;
+exports.easingInOutCirc = easingInOutCirc;
+exports.easingInOutExpo = easingInOutExpo;
+exports.easingInOutQuart = easingInOutQuart;
+exports.easingInOutQuint = easingInOutQuint;
+exports.easingInOutSine = easingInOutSine;
+exports.easingInQuad = easingInQuad;
+exports.easingInQuart = easingInQuart;
+exports.easingInQuint = easingInQuint;
+exports.easingInSine = easingInSine;
+exports.easingLinear = easingLinear;
+exports.easingOut = easingOut;
+exports.easingOutBack = easingOutBack;
+exports.easingOutCirc = easingOutCirc;
+exports.easingOutCubic = easingOutCubic;
+exports.easingOutExpo = easingOutExpo;
+exports.easingOutQuad = easingOutQuad;
+exports.easingOutQuart = easingOutQuart;
+exports.easingOutQuint = easingOutQuint;
+exports.easingOutSine = easingOutSine;
+exports.easingSnap = easingSnap;
+//# sourceMappingURL=easing.cjs.map

package/dist/easing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"easing.cjs","sources":["../src/easing.ts"],"sourcesContent":["/**\n * https://github.com/gre/bezier-easing\n * BezierEasing - use bezier curve for transition easing function\n * by Gaëtan Renaudeau 2014 - 2015 – MIT License\n */\n\n// These values are established by empiricism with tests (tradeoff: performance VS precision)\nconst NEWTON_ITERATIONS = 4;\nconst NEWTON_MIN_SLOPE = 0.001;\nconst SUBDIVISION_PRECISION = 0.0000001;\nconst SUBDIVISION_MAX_ITERATIONS = 10;\n\nconst kSplineTableSize = 11;\nconst kSampleStepSize = 1.0 / (kSplineTableSize - 1.0);\n\nconst float32ArraySupported = typeof Float32Array === 'function';\n\nfunction A(aA1: number, aA2: number) {\n  return 1.0 - 3.0 * aA2 + 3.0 * aA1;\n}\nfunction B(aA1: number, aA2: number) {\n  return 3.0 * aA2 - 6.0 * aA1;\n}\nfunction C(aA1: number) {\n  return 3.0 * aA1;\n}\n\n// Returns x(t) given t, x1, and x2, or y(t) given t, y1, and y2.\nfunction calcBezier(aT: number, aA1: number, aA2: number) {\n  return ((A(aA1, aA2) * aT + B(aA1, aA2)) * aT + C(aA1)) * aT;\n}\n\n// Returns dx/dt given t, x1, and x2, or dy/dt given t, y1, and y2.\nfunction getSlope(aT: number, aA1: number, aA2: number) {\n  return 3.0 * A(aA1, aA2) * aT * aT + 2.0 * B(aA1, aA2) * aT + C(aA1);\n}\n\nfunction binarySubdivide(aX: number, aA: number, aB: number, mX1: number, mX2: number) {\n  let currentX: number;\n  let currentT: number;\n  let i = 0;\n  let aBFinal = aB;\n  let aAFinal = aA;\n\n  do {\n    currentT = aAFinal + (aBFinal - aAFinal) / 2.0;\n    currentX = calcBezier(currentT, mX1, mX2) - aX;\n    if (currentX > 0.0) {\n      aBFinal = currentT;\n    } else {\n      aAFinal = currentT;\n    }\n  } while (Math.abs(currentX) > SUBDIVISION_PRECISION && ++i < SUBDIVISION_MAX_ITERATIONS);\n  return currentT;\n}\n\nfunction newtonRaphsonIterate(aX: number, aGuessT: number, mX1: number, mX2: number) {\n  let aGuessTFinal = aGuessT;\n  for (let i = 0; i < NEWTON_ITERATIONS; ++i) {\n    const currentSlope = getSlope(aGuessTFinal, mX1, mX2);\n    if (currentSlope === 0.0) {\n      return aGuessTFinal;\n    }\n    const currentX = calcBezier(aGuessTFinal, mX1, mX2) - aX;\n    aGuessTFinal -= currentX / currentSlope;\n  }\n  return aGuessTFinal;\n}\n\nfunction LinearEasing(x: number) {\n  return x;\n}\n\n/**\n * 创建一个基于贝塞尔曲线的缓动函数。\n *\n * @param x1 - 贝塞尔曲线的第一个控制点的 X 坐标，必须在 [0, 1] 范围内。\n * @param y1 - 贝塞尔曲线的第一个控制点的 Y 坐标，必须在 [0, 1] 范围内。\n * @param x2 - 贝塞尔曲线的第二个控制点的 X 坐标，必须在 [0, 1] 范围内。\n * @param y2 - 贝塞尔曲线的第二个控制点的 Y 坐标，必须在 [0, 1] 范围内。\n * @returns 返回一个缓动函数，该函数接受一个参数 x（范围在 0 到 1 之间），并返回相应的缓动值。\n * @throws 如果 mX1 或 mX2 不在 [0, 1] 范围内，则抛出错误。\n */\nexport function createEasingFn(x1: number, y1: number, x2: number, y2: number) {\n  if (!(0 <= x1 && x1 <= 1 && 0 <= x2 && x2 <= 1)) {\n    throw new Error('bezier x values must be in [0, 1] range');\n  }\n\n  if (x1 === y1 && x2 === y2) {\n    return LinearEasing;\n  }\n\n  // Precompute samples table\n  const sampleValues = float32ArraySupported ? new Float32Array(kSplineTableSize) : new Array(kSplineTableSize);\n  for (let i = 0; i < kSplineTableSize; ++i) {\n    sampleValues[i] = calcBezier(i * kSampleStepSize, x1, x2);\n  }\n\n  function getTForX(aX: number) {\n    let intervalStart = 0.0;\n    let currentSample = 1;\n    const lastSample = kSplineTableSize - 1;\n\n    for (; currentSample !== lastSample && sampleValues[currentSample] <= aX; ++currentSample) {\n      intervalStart += kSampleStepSize;\n    }\n    --currentSample;\n\n    // Interpolate to provide an initial guess for t\n    const dist = (aX - sampleValues[currentSample]) / (sampleValues[currentSample + 1] - sampleValues[currentSample]);\n    const guessForT = intervalStart + dist * kSampleStepSize;\n    const initialSlope = getSlope(guessForT, x1, x2);\n\n    if (initialSlope >= NEWTON_MIN_SLOPE) {\n      return newtonRaphsonIterate(aX, guessForT, x1, x2);\n    }\n\n    if (initialSlope === 0.0) {\n      return guessForT;\n    }\n\n    return binarySubdivide(aX, intervalStart, intervalStart + kSampleStepSize, x1, x2);\n  }\n\n  /**\n   * 贝塞尔曲线方程\n   * @param x {number} 0~1\n   */\n  return function easingFunc(x: number) {\n    // Because JavaScript number are imprecise, we should guarantee the extremes are right.\n    if (x === 0 || x === 1) {\n      return x;\n    }\n\n    return calcBezier(getTForX(x), y1, y2);\n  };\n}\n\nexport const easingEase = createEasingFn(0.25, 0.1, 0.25, 1);\nexport const easingLinear = createEasingFn(0, 0, 1, 1);\nexport const easingSnap = createEasingFn(0, 1, 0.5, 1);\nexport const easingIn = createEasingFn(0.42, 0, 1, 1);\nexport const easingOut = createEasingFn(0, 0, 0.58, 1);\nexport const easingInOut = createEasingFn(0.42, 0, 0.58, 1);\nexport const easingInQuad = createEasingFn(0.55, 0.085, 0.68, 0.53);\nexport const easingInCubic = createEasingFn(0.55, 0.055, 0.675, 0.19);\nexport const easingInQuart = createEasingFn(0.895, 0.03, 0.685, 0.22);\nexport const easingInQuint = createEasingFn(0.755, 0.05, 0.855, 0.06);\nexport const easingInSine = createEasingFn(0.47, 0, 0.745, 0.715);\nexport const easingInExpo = createEasingFn(0.95, 0.05, 0.795, 0.035);\nexport const easingInCirc = createEasingFn(0.6, 0.04, 0.98, 0.335);\nexport const easingInBack = createEasingFn(0.6, -0.28, 0.735, 0.045);\nexport const easingOutQuad = createEasingFn(0.25, 0.46, 0.45, 0.94);\nexport const easingOutCubic = createEasingFn(0.215, 0.61, 0.355, 1);\nexport const easingOutQuart = createEasingFn(0.165, 0.84, 0.44, 1);\nexport const easingOutQuint = createEasingFn(0.23, 1, 0.32, 1);\nexport const easingOutSine = createEasingFn(0.39, 0.575, 0.565, 1);\nexport const easingOutExpo = createEasingFn(0.19, 1, 0.22, 1);\nexport const easingOutCirc = createEasingFn(0.075, 0.82, 0.165, 1);\nexport const easingOutBack = createEasingFn(0.175, 0.885, 0.32, 1.275);\nexport const easingInOutQuart = createEasingFn(0.77, 0, 0.175, 1);\nexport const easingInOutQuint = createEasingFn(0.86, 0, 0.07, 1);\nexport const easingInOutSine = createEasingFn(0.445, 0.05, 0.55, 0.95);\nexport const easingInOutExpo = createEasingFn(1, 0, 0, 1);\nexport const easingInOutCirc = createEasingFn(0.785, 0.135, 0.15, 0.86);\nexport const easingInOutBack = createEasingFn(0.68, -0.55, 0.265, 1.55);\n"],"names":[],"mappings":"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"}

package/dist/easing.d.ts

@@ -0,0 +1,46 @@
+/**
+ * https://github.com/gre/bezier-easing
+ * BezierEasing - use bezier curve for transition easing function
+ * by Gaëtan Renaudeau 2014 - 2015 – MIT License
+ */
+declare function LinearEasing(x: number): number;
+/**
+ * 创建一个基于贝塞尔曲线的缓动函数。
+ *
+ * @param x1 - 贝塞尔曲线的第一个控制点的 X 坐标，必须在 [0, 1] 范围内。
+ * @param y1 - 贝塞尔曲线的第一个控制点的 Y 坐标，必须在 [0, 1] 范围内。
+ * @param x2 - 贝塞尔曲线的第二个控制点的 X 坐标，必须在 [0, 1] 范围内。
+ * @param y2 - 贝塞尔曲线的第二个控制点的 Y 坐标，必须在 [0, 1] 范围内。
+ * @returns 返回一个缓动函数，该函数接受一个参数 x（范围在 0 到 1 之间），并返回相应的缓动值。
+ * @throws 如果 mX1 或 mX2 不在 [0, 1] 范围内，则抛出错误。
+ */
+export declare function createEasingFn(x1: number, y1: number, x2: number, y2: number): typeof LinearEasing;
+export declare const easingEase: typeof LinearEasing;
+export declare const easingLinear: typeof LinearEasing;
+export declare const easingSnap: typeof LinearEasing;
+export declare const easingIn: typeof LinearEasing;
+export declare const easingOut: typeof LinearEasing;
+export declare const easingInOut: typeof LinearEasing;
+export declare const easingInQuad: typeof LinearEasing;
+export declare const easingInCubic: typeof LinearEasing;
+export declare const easingInQuart: typeof LinearEasing;
+export declare const easingInQuint: typeof LinearEasing;
+export declare const easingInSine: typeof LinearEasing;
+export declare const easingInExpo: typeof LinearEasing;
+export declare const easingInCirc: typeof LinearEasing;
+export declare const easingInBack: typeof LinearEasing;
+export declare const easingOutQuad: typeof LinearEasing;
+export declare const easingOutCubic: typeof LinearEasing;
+export declare const easingOutQuart: typeof LinearEasing;
+export declare const easingOutQuint: typeof LinearEasing;
+export declare const easingOutSine: typeof LinearEasing;
+export declare const easingOutExpo: typeof LinearEasing;
+export declare const easingOutCirc: typeof LinearEasing;
+export declare const easingOutBack: typeof LinearEasing;
+export declare const easingInOutQuart: typeof LinearEasing;
+export declare const easingInOutQuint: typeof LinearEasing;
+export declare const easingInOutSine: typeof LinearEasing;
+export declare const easingInOutExpo: typeof LinearEasing;
+export declare const easingInOutCirc: typeof LinearEasing;
+export declare const easingInOutBack: typeof LinearEasing;
+export {};

package/dist/easing.mjs

@@ -0,0 +1,151 @@
+const NEWTON_ITERATIONS = 4;
+const NEWTON_MIN_SLOPE = 1e-3;
+const SUBDIVISION_PRECISION = 1e-7;
+const SUBDIVISION_MAX_ITERATIONS = 10;
+const kSplineTableSize = 11;
+const kSampleStepSize = 1 / (kSplineTableSize - 1);
+const float32ArraySupported = typeof Float32Array === "function";
+function A(aA1, aA2) {
+  return 1 - 3 * aA2 + 3 * aA1;
+}
+function B(aA1, aA2) {
+  return 3 * aA2 - 6 * aA1;
+}
+function C(aA1) {
+  return 3 * aA1;
+}
+function calcBezier(aT, aA1, aA2) {
+  return ((A(aA1, aA2) * aT + B(aA1, aA2)) * aT + C(aA1)) * aT;
+}
+function getSlope(aT, aA1, aA2) {
+  return 3 * A(aA1, aA2) * aT * aT + 2 * B(aA1, aA2) * aT + C(aA1);
+}
+function binarySubdivide(aX, aA, aB, mX1, mX2) {
+  let currentX;
+  let currentT;
+  let i = 0;
+  let aBFinal = aB;
+  let aAFinal = aA;
+  do {
+    currentT = aAFinal + (aBFinal - aAFinal) / 2;
+    currentX = calcBezier(currentT, mX1, mX2) - aX;
+    if (currentX > 0) {
+      aBFinal = currentT;
+    } else {
+      aAFinal = currentT;
+    }
+  } while (Math.abs(currentX) > SUBDIVISION_PRECISION && ++i < SUBDIVISION_MAX_ITERATIONS);
+  return currentT;
+}
+function newtonRaphsonIterate(aX, aGuessT, mX1, mX2) {
+  let aGuessTFinal = aGuessT;
+  for (let i = 0; i < NEWTON_ITERATIONS; ++i) {
+    const currentSlope = getSlope(aGuessTFinal, mX1, mX2);
+    if (currentSlope === 0) {
+      return aGuessTFinal;
+    }
+    const currentX = calcBezier(aGuessTFinal, mX1, mX2) - aX;
+    aGuessTFinal -= currentX / currentSlope;
+  }
+  return aGuessTFinal;
+}
+function LinearEasing(x) {
+  return x;
+}
+function createEasingFn(x1, y1, x2, y2) {
+  if (!(0 <= x1 && x1 <= 1 && 0 <= x2 && x2 <= 1)) {
+    throw new Error("bezier x values must be in [0, 1] range");
+  }
+  if (x1 === y1 && x2 === y2) {
+    return LinearEasing;
+  }
+  const sampleValues = float32ArraySupported ? new Float32Array(kSplineTableSize) : new Array(kSplineTableSize);
+  for (let i = 0; i < kSplineTableSize; ++i) {
+    sampleValues[i] = calcBezier(i * kSampleStepSize, x1, x2);
+  }
+  function getTForX(aX) {
+    let intervalStart = 0;
+    let currentSample = 1;
+    const lastSample = kSplineTableSize - 1;
+    for (; currentSample !== lastSample && sampleValues[currentSample] <= aX; ++currentSample) {
+      intervalStart += kSampleStepSize;
+    }
+    --currentSample;
+    const dist = (aX - sampleValues[currentSample]) / (sampleValues[currentSample + 1] - sampleValues[currentSample]);
+    const guessForT = intervalStart + dist * kSampleStepSize;
+    const initialSlope = getSlope(guessForT, x1, x2);
+    if (initialSlope >= NEWTON_MIN_SLOPE) {
+      return newtonRaphsonIterate(aX, guessForT, x1, x2);
+    }
+    if (initialSlope === 0) {
+      return guessForT;
+    }
+    return binarySubdivide(aX, intervalStart, intervalStart + kSampleStepSize, x1, x2);
+  }
+  return function easingFunc(x) {
+    if (x === 0 || x === 1) {
+      return x;
+    }
+    return calcBezier(getTForX(x), y1, y2);
+  };
+}
+const easingEase = createEasingFn(0.25, 0.1, 0.25, 1);
+const easingLinear = createEasingFn(0, 0, 1, 1);
+const easingSnap = createEasingFn(0, 1, 0.5, 1);
+const easingIn = createEasingFn(0.42, 0, 1, 1);
+const easingOut = createEasingFn(0, 0, 0.58, 1);
+const easingInOut = createEasingFn(0.42, 0, 0.58, 1);
+const easingInQuad = createEasingFn(0.55, 0.085, 0.68, 0.53);
+const easingInCubic = createEasingFn(0.55, 0.055, 0.675, 0.19);
+const easingInQuart = createEasingFn(0.895, 0.03, 0.685, 0.22);
+const easingInQuint = createEasingFn(0.755, 0.05, 0.855, 0.06);
+const easingInSine = createEasingFn(0.47, 0, 0.745, 0.715);
+const easingInExpo = createEasingFn(0.95, 0.05, 0.795, 0.035);
+const easingInCirc = createEasingFn(0.6, 0.04, 0.98, 0.335);
+const easingInBack = createEasingFn(0.6, -0.28, 0.735, 0.045);
+const easingOutQuad = createEasingFn(0.25, 0.46, 0.45, 0.94);
+const easingOutCubic = createEasingFn(0.215, 0.61, 0.355, 1);
+const easingOutQuart = createEasingFn(0.165, 0.84, 0.44, 1);
+const easingOutQuint = createEasingFn(0.23, 1, 0.32, 1);
+const easingOutSine = createEasingFn(0.39, 0.575, 0.565, 1);
+const easingOutExpo = createEasingFn(0.19, 1, 0.22, 1);
+const easingOutCirc = createEasingFn(0.075, 0.82, 0.165, 1);
+const easingOutBack = createEasingFn(0.175, 0.885, 0.32, 1.275);
+const easingInOutQuart = createEasingFn(0.77, 0, 0.175, 1);
+const easingInOutQuint = createEasingFn(0.86, 0, 0.07, 1);
+const easingInOutSine = createEasingFn(0.445, 0.05, 0.55, 0.95);
+const easingInOutExpo = createEasingFn(1, 0, 0, 1);
+const easingInOutCirc = createEasingFn(0.785, 0.135, 0.15, 0.86);
+const easingInOutBack = createEasingFn(0.68, -0.55, 0.265, 1.55);
+export {
+  createEasingFn,
+  easingEase,
+  easingIn,
+  easingInBack,
+  easingInCirc,
+  easingInCubic,
+  easingInExpo,
+  easingInOut,
+  easingInOutBack,
+  easingInOutCirc,
+  easingInOutExpo,
+  easingInOutQuart,
+  easingInOutQuint,
+  easingInOutSine,
+  easingInQuad,
+  easingInQuart,
+  easingInQuint,
+  easingInSine,
+  easingLinear,
+  easingOut,
+  easingOutBack,
+  easingOutCirc,
+  easingOutCubic,
+  easingOutExpo,
+  easingOutQuad,
+  easingOutQuart,
+  easingOutQuint,
+  easingOutSine,
+  easingSnap
+};
+//# sourceMappingURL=easing.mjs.map

package/dist/easing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"easing.mjs","sources":["../src/easing.ts"],"sourcesContent":["/**\n * https://github.com/gre/bezier-easing\n * BezierEasing - use bezier curve for transition easing function\n * by Gaëtan Renaudeau 2014 - 2015 – MIT License\n */\n\n// These values are established by empiricism with tests (tradeoff: performance VS precision)\nconst NEWTON_ITERATIONS = 4;\nconst NEWTON_MIN_SLOPE = 0.001;\nconst SUBDIVISION_PRECISION = 0.0000001;\nconst SUBDIVISION_MAX_ITERATIONS = 10;\n\nconst kSplineTableSize = 11;\nconst kSampleStepSize = 1.0 / (kSplineTableSize - 1.0);\n\nconst float32ArraySupported = typeof Float32Array === 'function';\n\nfunction A(aA1: number, aA2: number) {\n  return 1.0 - 3.0 * aA2 + 3.0 * aA1;\n}\nfunction B(aA1: number, aA2: number) {\n  return 3.0 * aA2 - 6.0 * aA1;\n}\nfunction C(aA1: number) {\n  return 3.0 * aA1;\n}\n\n// Returns x(t) given t, x1, and x2, or y(t) given t, y1, and y2.\nfunction calcBezier(aT: number, aA1: number, aA2: number) {\n  return ((A(aA1, aA2) * aT + B(aA1, aA2)) * aT + C(aA1)) * aT;\n}\n\n// Returns dx/dt given t, x1, and x2, or dy/dt given t, y1, and y2.\nfunction getSlope(aT: number, aA1: number, aA2: number) {\n  return 3.0 * A(aA1, aA2) * aT * aT + 2.0 * B(aA1, aA2) * aT + C(aA1);\n}\n\nfunction binarySubdivide(aX: number, aA: number, aB: number, mX1: number, mX2: number) {\n  let currentX: number;\n  let currentT: number;\n  let i = 0;\n  let aBFinal = aB;\n  let aAFinal = aA;\n\n  do {\n    currentT = aAFinal + (aBFinal - aAFinal) / 2.0;\n    currentX = calcBezier(currentT, mX1, mX2) - aX;\n    if (currentX > 0.0) {\n      aBFinal = currentT;\n    } else {\n      aAFinal = currentT;\n    }\n  } while (Math.abs(currentX) > SUBDIVISION_PRECISION && ++i < SUBDIVISION_MAX_ITERATIONS);\n  return currentT;\n}\n\nfunction newtonRaphsonIterate(aX: number, aGuessT: number, mX1: number, mX2: number) {\n  let aGuessTFinal = aGuessT;\n  for (let i = 0; i < NEWTON_ITERATIONS; ++i) {\n    const currentSlope = getSlope(aGuessTFinal, mX1, mX2);\n    if (currentSlope === 0.0) {\n      return aGuessTFinal;\n    }\n    const currentX = calcBezier(aGuessTFinal, mX1, mX2) - aX;\n    aGuessTFinal -= currentX / currentSlope;\n  }\n  return aGuessTFinal;\n}\n\nfunction LinearEasing(x: number) {\n  return x;\n}\n\n/**\n * 创建一个基于贝塞尔曲线的缓动函数。\n *\n * @param x1 - 贝塞尔曲线的第一个控制点的 X 坐标，必须在 [0, 1] 范围内。\n * @param y1 - 贝塞尔曲线的第一个控制点的 Y 坐标，必须在 [0, 1] 范围内。\n * @param x2 - 贝塞尔曲线的第二个控制点的 X 坐标，必须在 [0, 1] 范围内。\n * @param y2 - 贝塞尔曲线的第二个控制点的 Y 坐标，必须在 [0, 1] 范围内。\n * @returns 返回一个缓动函数，该函数接受一个参数 x（范围在 0 到 1 之间），并返回相应的缓动值。\n * @throws 如果 mX1 或 mX2 不在 [0, 1] 范围内，则抛出错误。\n */\nexport function createEasingFn(x1: number, y1: number, x2: number, y2: number) {\n  if (!(0 <= x1 && x1 <= 1 && 0 <= x2 && x2 <= 1)) {\n    throw new Error('bezier x values must be in [0, 1] range');\n  }\n\n  if (x1 === y1 && x2 === y2) {\n    return LinearEasing;\n  }\n\n  // Precompute samples table\n  const sampleValues = float32ArraySupported ? new Float32Array(kSplineTableSize) : new Array(kSplineTableSize);\n  for (let i = 0; i < kSplineTableSize; ++i) {\n    sampleValues[i] = calcBezier(i * kSampleStepSize, x1, x2);\n  }\n\n  function getTForX(aX: number) {\n    let intervalStart = 0.0;\n    let currentSample = 1;\n    const lastSample = kSplineTableSize - 1;\n\n    for (; currentSample !== lastSample && sampleValues[currentSample] <= aX; ++currentSample) {\n      intervalStart += kSampleStepSize;\n    }\n    --currentSample;\n\n    // Interpolate to provide an initial guess for t\n    const dist = (aX - sampleValues[currentSample]) / (sampleValues[currentSample + 1] - sampleValues[currentSample]);\n    const guessForT = intervalStart + dist * kSampleStepSize;\n    const initialSlope = getSlope(guessForT, x1, x2);\n\n    if (initialSlope >= NEWTON_MIN_SLOPE) {\n      return newtonRaphsonIterate(aX, guessForT, x1, x2);\n    }\n\n    if (initialSlope === 0.0) {\n      return guessForT;\n    }\n\n    return binarySubdivide(aX, intervalStart, intervalStart + kSampleStepSize, x1, x2);\n  }\n\n  /**\n   * 贝塞尔曲线方程\n   * @param x {number} 0~1\n   */\n  return function easingFunc(x: number) {\n    // Because JavaScript number are imprecise, we should guarantee the extremes are right.\n    if (x === 0 || x === 1) {\n      return x;\n    }\n\n    return calcBezier(getTForX(x), y1, y2);\n  };\n}\n\nexport const easingEase = createEasingFn(0.25, 0.1, 0.25, 1);\nexport const easingLinear = createEasingFn(0, 0, 1, 1);\nexport const easingSnap = createEasingFn(0, 1, 0.5, 1);\nexport const easingIn = createEasingFn(0.42, 0, 1, 1);\nexport const easingOut = createEasingFn(0, 0, 0.58, 1);\nexport const easingInOut = createEasingFn(0.42, 0, 0.58, 1);\nexport const easingInQuad = createEasingFn(0.55, 0.085, 0.68, 0.53);\nexport const easingInCubic = createEasingFn(0.55, 0.055, 0.675, 0.19);\nexport const easingInQuart = createEasingFn(0.895, 0.03, 0.685, 0.22);\nexport const easingInQuint = createEasingFn(0.755, 0.05, 0.855, 0.06);\nexport const easingInSine = createEasingFn(0.47, 0, 0.745, 0.715);\nexport const easingInExpo = createEasingFn(0.95, 0.05, 0.795, 0.035);\nexport const easingInCirc = createEasingFn(0.6, 0.04, 0.98, 0.335);\nexport const easingInBack = createEasingFn(0.6, -0.28, 0.735, 0.045);\nexport const easingOutQuad = createEasingFn(0.25, 0.46, 0.45, 0.94);\nexport const easingOutCubic = createEasingFn(0.215, 0.61, 0.355, 1);\nexport const easingOutQuart = createEasingFn(0.165, 0.84, 0.44, 1);\nexport const easingOutQuint = createEasingFn(0.23, 1, 0.32, 1);\nexport const easingOutSine = createEasingFn(0.39, 0.575, 0.565, 1);\nexport const easingOutExpo = createEasingFn(0.19, 1, 0.22, 1);\nexport const easingOutCirc = createEasingFn(0.075, 0.82, 0.165, 1);\nexport const easingOutBack = createEasingFn(0.175, 0.885, 0.32, 1.275);\nexport const easingInOutQuart = createEasingFn(0.77, 0, 0.175, 1);\nexport const easingInOutQuint = createEasingFn(0.86, 0, 0.07, 1);\nexport const easingInOutSine = createEasingFn(0.445, 0.05, 0.55, 0.95);\nexport const easingInOutExpo = createEasingFn(1, 0, 0, 1);\nexport const easingInOutCirc = createEasingFn(0.785, 0.135, 0.15, 0.86);\nexport const easingInOutBack = createEasingFn(0.68, -0.55, 0.265, 1.55);\n"],"names":[],"mappings":"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"}

package/dist/emitter.cjs

@@ -0,0 +1,94 @@
+"use strict";
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+var _events, _Emitter_instances, offAll_fn, offEvent_fn, offListener_fn;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+class Emitter {
+  constructor() {
+    __privateAdd(this, _Emitter_instances);
+    __privateAdd(this, _events, /* @__PURE__ */ new Map());
+  }
+  /**
+   * 注册事件监听器
+   * @param event - 要监听的事件名称
+   * @param listener - 事件监听器函数
+   * @example
+   * emitter.on('click', (x, y) => {
+   *   console.log(`Clicked at (${x}, ${y})`);
+   * });
+   */
+  on(event, listener) {
+    const listeners = __privateGet(this, _events).get(event);
+    if (listeners) {
+      listeners.add(listener);
+    } else {
+      __privateGet(this, _events).set(event, /* @__PURE__ */ new Set([listener]));
+    }
+  }
+  /**
+   * 移除事件监听器，有三种使用方式：
+   * 1. 移除特定事件的特定监听器
+   * 2. 移除特定事件的所有监听器
+   * 3. 移除所有事件的所有监听器
+   * @param event - 要移除的事件名称（可选）
+   * @param listener - 要移除的监听器函数（可选）
+   * @example
+   * // 移除特定事件的特定监听器
+   * emitter.off('click', clickHandler);
+   *
+   * // 移除特定事件的所有监听器
+   * emitter.off('click');
+   *
+   * // 移除所有事件的所有监听器
+   * emitter.off();
+   */
+  off(event, listener) {
+    if (event && listener) {
+      __privateMethod(this, _Emitter_instances, offListener_fn).call(this, event, listener);
+    } else if (event) {
+      __privateMethod(this, _Emitter_instances, offEvent_fn).call(this, event);
+    } else {
+      __privateMethod(this, _Emitter_instances, offAll_fn).call(this);
+    }
+  }
+  /**
+   * 触发指定事件，调用所有注册的监听器
+   * @param event - 要触发的事件名称
+   * @param payloads - 传递给监听器的参数
+   * @remarks
+   * 监听器会按照注册的顺序依次执行，如果某个监听器返回 false，
+   * 则后续监听器将不会被执行
+   * @example
+   * emitter.emit('click', 10, 20);
+   */
+  emit(event, ...payloads) {
+    const listeners = __privateGet(this, _events).get(event);
+    if (!listeners) return;
+    for (const listener of [...listeners]) {
+      if (listener(...payloads) === false) {
+        break;
+      }
+    }
+  }
+}
+_events = new WeakMap();
+_Emitter_instances = new WeakSet();
+offAll_fn = function() {
+  __privateGet(this, _events).clear();
+};
+offEvent_fn = function(event) {
+  __privateGet(this, _events).delete(event);
+};
+offListener_fn = function(event, listener) {
+  const listeners = __privateGet(this, _events).get(event);
+  if (listeners) {
+    listeners.delete(listener);
+  }
+};
+exports.Emitter = Emitter;
+//# sourceMappingURL=emitter.cjs.map

package/dist/emitter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.cjs","sources":["../src/emitter.ts"],"sourcesContent":["import type { AnyFunction, AnyObject } from './types';\n\n/**\n * 事件类型映射，key 为事件名称，value 为事件参数类型数组\n */\nexport type EmitterMap = Record<string, unknown[]>;\n\n/**\n * 事件监听器函数类型\n * @template E - EmitterMap 类型\n * @template K - 事件名称类型\n */\nexport type EmitterListener<E extends EmitterMap, K extends keyof E> = (...payloads: E[K]) => false | unknown;\n\n/**\n * 事件发射器类，用于管理事件监听和触发\n * @template E - 事件类型映射\n *\n * @example\n * type MyEvents = {\n *   'click': [x: number, y: number];\n *   'change': [value: string];\n * };\n *\n * const emitter = new Emitter<MyEvents>();\n * emitter.on('click', (x, y) => {\n *   console.log(`Clicked at (${x}, ${y})`);\n * });\n * emitter.emit('click', 10, 20);\n */\nexport class Emitter<E extends EmitterMap> {\n  #events: Map<keyof E, Set<AnyFunction>> = new Map();\n\n  /**\n   * 注册事件监听器\n   * @param event - 要监听的事件名称\n   * @param listener - 事件监听器函数\n   * @example\n   * emitter.on('click', (x, y) => {\n   *   console.log(`Clicked at (${x}, ${y})`);\n   * });\n   */\n  on<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n    const listeners = this.#events.get(event);\n    if (listeners) {\n      listeners.add(listener);\n    } else {\n      this.#events.set(event, new Set([listener]));\n    }\n  }\n\n  /**\n   * 移除事件监听器，有三种使用方式：\n   * 1. 移除特定事件的特定监听器\n   * 2. 移除特定事件的所有监听器\n   * 3. 移除所有事件的所有监听器\n   * @param event - 要移除的事件名称（可选）\n   * @param listener - 要移除的监听器函数（可选）\n   * @example\n   * // 移除特定事件的特定监听器\n   * emitter.off('click', clickHandler);\n   *\n   * // 移除特定事件的所有监听器\n   * emitter.off('click');\n   *\n   * // 移除所有事件的所有监听器\n   * emitter.off();\n   */\n  off<K extends keyof E>(event?: K, listener?: EmitterListener<E, K>) {\n    if (event && listener) {\n      this.#offListener(event, listener);\n    } else if (event) {\n      this.#offEvent(event);\n    } else {\n      this.#offAll();\n    }\n  }\n\n  #offAll() {\n    this.#events.clear();\n  }\n\n  #offEvent<K extends keyof E>(event: K) {\n    this.#events.delete(event);\n  }\n\n  #offListener<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n    const listeners = this.#events.get(event);\n\n    if (listeners) {\n      listeners.delete(listener);\n    }\n  }\n\n  /**\n   * 触发指定事件，调用所有注册的监听器\n   * @param event - 要触发的事件名称\n   * @param payloads - 传递给监听器的参数\n   * @remarks\n   * 监听器会按照注册的顺序依次执行，如果某个监听器返回 false，\n   * 则后续监听器将不会被执行\n   * @example\n   * emitter.emit('click', 10, 20);\n   */\n  emit<K extends keyof E>(event: K, ...payloads: Parameters<EmitterListener<E, K>>) {\n    const listeners = this.#events.get(event) as Set<EmitterListener<E, K>> | undefined;\n\n    if (!listeners) return;\n\n    // 避免在 emit、on 的过程中改变 listeners 从而影响本次 emit\n    for (const listener of [...listeners]) {\n      if (listener(...payloads) === false) {\n        break;\n      }\n    }\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;AA8BO,MAAM,QAA8B;AAAA,EAApC;AAAA;AACL,oDAA8C,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWlD,GAAsB,OAAU,UAAiC;AAC/D,UAAM,YAAY,mBAAK,SAAQ,IAAI,KAAK;AACxC,QAAI,WAAW;AACb,gBAAU,IAAI,QAAQ;AAAA,IAAA,OACjB;AACA,yBAAA,SAAQ,IAAI,OAAO,oBAAI,IAAI,CAAC,QAAQ,CAAC,CAAC;AAAA,IAAA;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBF,IAAuB,OAAW,UAAkC;AAClE,QAAI,SAAS,UAAU;AAChB,4BAAA,oCAAA,WAAa,OAAO;AAAA,eAChB,OAAO;AAChB,4BAAK,iCAAL,WAAe;AAAA,IAAK,OACf;AACL,4BAAK,+BAAL;AAAA,IAAa;AAAA,EACf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BF,KAAwB,UAAa,UAA6C;AAChF,UAAM,YAAY,mBAAK,SAAQ,IAAI,KAAK;AAExC,QAAI,CAAC,UAAW;AAGhB,eAAW,YAAY,CAAC,GAAG,SAAS,GAAG;AACrC,UAAI,SAAS,GAAG,QAAQ,MAAM,OAAO;AACnC;AAAA,MAAA;AAAA,IACF;AAAA,EACF;AAEJ;AArFE;AADK;AAgDL,YAAU,WAAA;AACR,qBAAK,SAAQ,MAAM;AAAA;AAGrB,uBAA6B,OAAU;AAChC,qBAAA,SAAQ,OAAO,KAAK;AAAA;AAG3B,iBAAA,SAAgC,OAAU,UAAiC;AACzE,QAAM,YAAY,mBAAK,SAAQ,IAAI,KAAK;AAExC,MAAI,WAAW;AACb,cAAU,OAAO,QAAQ;AAAA,EAAA;AAC3B;;"}