@sanguo-dev/calendar 0.0.0-stage → 1.0.1

package/dist/index.cjs

@@ -0,0 +1,1766 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+// src/data/Calendar.ts
+/**
+* 农历1900-2100的润大小信息表
+* @Array Of Property
+* @return Hex
+*/
+const LunarInfo = [
+	19416,
+	19168,
+	42352,
+	21717,
+	53856,
+	55632,
+	91476,
+	22176,
+	39632,
+	21970,
+	19168,
+	42422,
+	42192,
+	53840,
+	119381,
+	46400,
+	54944,
+	44450,
+	38320,
+	84343,
+	18800,
+	42160,
+	46261,
+	27216,
+	27968,
+	109396,
+	11104,
+	38256,
+	21234,
+	18800,
+	25958,
+	54432,
+	59984,
+	28309,
+	23248,
+	11104,
+	100067,
+	37600,
+	116951,
+	51536,
+	54432,
+	120998,
+	46416,
+	22176,
+	107956,
+	9680,
+	37584,
+	53938,
+	43344,
+	46423,
+	27808,
+	46416,
+	86869,
+	19872,
+	42416,
+	83315,
+	21168,
+	43432,
+	59728,
+	27296,
+	44710,
+	43856,
+	19296,
+	43748,
+	42352,
+	21088,
+	62051,
+	55632,
+	23383,
+	22176,
+	38608,
+	19925,
+	19152,
+	42192,
+	54484,
+	53840,
+	54616,
+	46400,
+	46752,
+	103846,
+	38320,
+	18864,
+	43380,
+	42160,
+	45690,
+	27216,
+	27968,
+	44870,
+	43872,
+	38256,
+	19189,
+	18800,
+	25776,
+	29859,
+	59984,
+	27480,
+	21952,
+	43872,
+	38613,
+	37600,
+	51552,
+	55636,
+	54432,
+	55888,
+	30034,
+	22176,
+	43959,
+	9680,
+	37584,
+	51893,
+	43344,
+	46240,
+	47780,
+	44368,
+	21977,
+	19360,
+	42416,
+	86390,
+	21168,
+	43312,
+	31060,
+	27296,
+	44368,
+	23378,
+	19296,
+	42726,
+	42208,
+	53856,
+	60005,
+	54576,
+	23200,
+	30371,
+	38608,
+	19195,
+	19152,
+	42192,
+	118966,
+	53840,
+	54560,
+	56645,
+	46496,
+	22224,
+	21938,
+	18864,
+	42359,
+	42160,
+	43600,
+	111189,
+	27936,
+	44448,
+	84835,
+	37744,
+	18936,
+	18800,
+	25776,
+	92326,
+	59984,
+	27424,
+	108228,
+	43744,
+	41696,
+	53987,
+	51552,
+	54615,
+	54432,
+	55888,
+	23893,
+	22176,
+	42704,
+	21972,
+	21200,
+	43448,
+	43344,
+	46240,
+	46758,
+	44368,
+	21920,
+	43940,
+	42416,
+	21168,
+	45683,
+	26928,
+	29495,
+	27296,
+	44368,
+	84821,
+	19296,
+	42352,
+	21732,
+	53600,
+	59752,
+	54560,
+	55968,
+	92838,
+	22224,
+	19168,
+	43476,
+	41680,
+	53584,
+	62034,
+	54560
+];
+/**
+* 公历每个月份的天数普通表
+* @Array Of Property
+* @return Number
+*/
+const SolarMonth = [
+	31,
+	28,
+	31,
+	30,
+	31,
+	30,
+	31,
+	31,
+	30,
+	31,
+	30,
+	31
+];
+/**
+* 天干地支之天干速查表
+* @Array Of Property trans["甲","乙","丙","丁","戊","己","庚","辛","壬","癸"]
+* @return Cn string
+*/
+const Gan = [
+	"甲",
+	"乙",
+	"丙",
+	"丁",
+	"戊",
+	"己",
+	"庚",
+	"辛",
+	"壬",
+	"癸"
+];
+/**
+* 天干地支之地支速查表
+* @Array Of Property
+* @trans["子","丑","寅","卯","辰","巳","午","未","申","酉","戌","亥"]
+* @return Cn string
+*/
+const Zhi = [
+	"子",
+	"丑",
+	"寅",
+	"卯",
+	"辰",
+	"巳",
+	"午",
+	"未",
+	"申",
+	"酉",
+	"戌",
+	"亥"
+];
+/**
+* 每日的时辰对照表
+* @Array Of Property
+* @return Cn string
+*/
+const GanZhiHour = [
+	"甲子-乙丑-丙寅-丁卯-戊辰-己巳-庚午-辛未-壬申-癸酉-甲戌-乙亥",
+	"丙子-丁丑-戊寅-己卯-庚辰-辛巳-壬午-癸未-甲申-乙酉-丙戌-丁亥",
+	"戊子-己丑-庚寅-辛卯-壬辰-癸巳-甲午-乙未-丙申-丁酉-戊戌-己亥",
+	"庚子-辛丑-壬寅-癸卯-甲辰-乙巳-丙午-丁未-戊申-己酉-庚戌-辛亥",
+	"壬子-癸丑-甲寅-乙卯-丙辰-丁巳-戊午-己未-庚申-辛酉-壬戌-癸亥",
+	"甲子-乙丑-丙寅-丁卯-戊辰-己巳-庚午-辛未-壬申-癸酉-甲戌-乙亥",
+	"丙子-丁丑-戊寅-己卯-庚辰-辛巳-壬午-癸未-甲申-乙酉-丙戌-丁亥",
+	"戊子-己丑-庚寅-辛卯-壬辰-癸巳-甲午-乙未-丙申-丁酉-戊戌-己亥",
+	"庚子-辛丑-壬寅-癸卯-甲辰-乙巳-丙午-丁未-戊申-己酉-庚戌-辛亥",
+	"壬子-癸丑-甲寅-乙卯-丙辰-丁巳-戊午-己未-庚申-辛酉-壬戌-癸亥"
+];
+/**
+* 天干地支之地支速查表<=>生肖
+* @Array Of Property
+* @trans["鼠","牛","虎","兔","龙","蛇","马","羊","猴","鸡","狗","猪"]
+* @return Cn string
+*/
+const Animals = [
+	"鼠",
+	"牛",
+	"虎",
+	"兔",
+	"龙",
+	"蛇",
+	"马",
+	"羊",
+	"猴",
+	"鸡",
+	"狗",
+	"猪"
+];
+/**
+* 24节气速查表
+* @Array Of Property
+* @trans["小寒","大寒","立春","雨水","惊蛰","春分","清明","谷雨","立夏","小满","芒种","夏至","小暑","大暑","立秋","处暑","白露","秋分","寒露","霜降","立冬","小雪","大雪","冬至"]
+* @return Cn string
+*/
+const SolarTerm = [
+	"小寒",
+	"大寒",
+	"立春",
+	"雨水",
+	"惊蛰",
+	"春分",
+	"清明",
+	"谷雨",
+	"立夏",
+	"小满",
+	"芒种",
+	"夏至",
+	"小暑",
+	"大暑",
+	"立秋",
+	"处暑",
+	"白露",
+	"秋分",
+	"寒露",
+	"霜降",
+	"立冬",
+	"小雪",
+	"大雪",
+	"冬至"
+];
+/**
+* 1900-2100各年的24节气日期速查表
+* @Array Of Property
+* @return 0x string For splice
+*/
+const TermInfo = [
+	"9778397bd097c36b0b6fc9274c91aa",
+	"97b6b97bd19801ec9210c965cc920e",
+	"97bcf97c3598082c95f8c965cc920f",
+	"97bd0b06bdb0722c965ce1cfcc920f",
+	"b027097bd097c36b0b6fc9274c91aa",
+	"97b6b97bd19801ec9210c965cc920e",
+	"97bcf97c359801ec95f8c965cc920f",
+	"97bd0b06bdb0722c965ce1cfcc920f",
+	"b027097bd097c36b0b6fc9274c91aa",
+	"97b6b97bd19801ec9210c965cc920e",
+	"97bcf97c359801ec95f8c965cc920f",
+	"97bd0b06bdb0722c965ce1cfcc920f",
+	"b027097bd097c36b0b6fc9274c91aa",
+	"9778397bd19801ec9210c965cc920e",
+	"97b6b97bd19801ec95f8c965cc920f",
+	"97bd09801d98082c95f8e1cfcc920f",
+	"97bd097bd097c36b0b6fc9210c8dc2",
+	"9778397bd197c36c9210c9274c91aa",
+	"97b6b97bd19801ec95f8c965cc920e",
+	"97bd09801d98082c95f8e1cfcc920f",
+	"97bd097bd097c36b0b6fc9210c8dc2",
+	"9778397bd097c36c9210c9274c91aa",
+	"97b6b97bd19801ec95f8c965cc920e",
+	"97bcf97c3598082c95f8e1cfcc920f",
+	"97bd097bd097c36b0b6fc9210c8dc2",
+	"9778397bd097c36c9210c9274c91aa",
+	"97b6b97bd19801ec9210c965cc920e",
+	"97bcf97c3598082c95f8c965cc920f",
+	"97bd097bd097c35b0b6fc920fb0722",
+	"9778397bd097c36b0b6fc9274c91aa",
+	"97b6b97bd19801ec9210c965cc920e",
+	"97bcf97c3598082c95f8c965cc920f",
+	"97bd097bd097c35b0b6fc920fb0722",
+	"9778397bd097c36b0b6fc9274c91aa",
+	"97b6b97bd19801ec9210c965cc920e",
+	"97bcf97c359801ec95f8c965cc920f",
+	"97bd097bd097c35b0b6fc920fb0722",
+	"9778397bd097c36b0b6fc9274c91aa",
+	"97b6b97bd19801ec9210c965cc920e",
+	"97bcf97c359801ec95f8c965cc920f",
+	"97bd097bd097c35b0b6fc920fb0722",
+	"9778397bd097c36b0b6fc9274c91aa",
+	"97b6b97bd19801ec9210c965cc920e",
+	"97bcf97c359801ec95f8c965cc920f",
+	"97bd097bd07f595b0b6fc920fb0722",
+	"9778397bd097c36b0b6fc9210c8dc2",
+	"9778397bd19801ec9210c9274c920e",
+	"97b6b97bd19801ec95f8c965cc920f",
+	"97bd07f5307f595b0b0bc920fb0722",
+	"7f0e397bd097c36b0b6fc9210c8dc2",
+	"9778397bd097c36c9210c9274c920e",
+	"97b6b97bd19801ec95f8c965cc920f",
+	"97bd07f5307f595b0b0bc920fb0722",
+	"7f0e397bd097c36b0b6fc9210c8dc2",
+	"9778397bd097c36c9210c9274c91aa",
+	"97b6b97bd19801ec9210c965cc920e",
+	"97bd07f1487f595b0b0bc920fb0722",
+	"7f0e397bd097c36b0b6fc9210c8dc2",
+	"9778397bd097c36b0b6fc9274c91aa",
+	"97b6b97bd19801ec9210c965cc920e",
+	"97bcf7f1487f595b0b0bb0b6fb0722",
+	"7f0e397bd097c35b0b6fc920fb0722",
+	"9778397bd097c36b0b6fc9274c91aa",
+	"97b6b97bd19801ec9210c965cc920e",
+	"97bcf7f1487f595b0b0bb0b6fb0722",
+	"7f0e397bd097c35b0b6fc920fb0722",
+	"9778397bd097c36b0b6fc9274c91aa",
+	"97b6b97bd19801ec9210c965cc920e",
+	"97bcf7f1487f531b0b0bb0b6fb0722",
+	"7f0e397bd097c35b0b6fc920fb0722",
+	"9778397bd097c36b0b6fc9274c91aa",
+	"97b6b97bd19801ec9210c965cc920e",
+	"97bcf7f1487f531b0b0bb0b6fb0722",
+	"7f0e397bd07f595b0b6fc920fb0722",
+	"9778397bd097c36b0b6fc9274c91aa",
+	"97b6b97bd19801ec9210c9274c920e",
+	"97bcf7f0e47f531b0b0bb0b6fb0722",
+	"7f0e397bd07f595b0b0bc920fb0722",
+	"9778397bd097c36b0b6fc9210c91aa",
+	"97b6b97bd197c36c9210c9274c920e",
+	"97bcf7f0e47f531b0b0bb0b6fb0722",
+	"7f0e397bd07f595b0b0bc920fb0722",
+	"9778397bd097c36b0b6fc9210c8dc2",
+	"9778397bd097c36c9210c9274c920e",
+	"97b6b7f0e47f531b0723b0b6fb0722",
+	"7f0e37f5307f595b0b0bc920fb0722",
+	"7f0e397bd097c36b0b6fc9210c8dc2",
+	"9778397bd097c36b0b70c9274c91aa",
+	"97b6b7f0e47f531b0723b0b6fb0721",
+	"7f0e37f1487f595b0b0bb0b6fb0722",
+	"7f0e397bd097c35b0b6fc9210c8dc2",
+	"9778397bd097c36b0b6fc9274c91aa",
+	"97b6b7f0e47f531b0723b0b6fb0721",
+	"7f0e27f1487f595b0b0bb0b6fb0722",
+	"7f0e397bd097c35b0b6fc920fb0722",
+	"9778397bd097c36b0b6fc9274c91aa",
+	"97b6b7f0e47f531b0723b0b6fb0721",
+	"7f0e27f1487f531b0b0bb0b6fb0722",
+	"7f0e397bd097c35b0b6fc920fb0722",
+	"9778397bd097c36b0b6fc9274c91aa",
+	"97b6b7f0e47f531b0723b0b6fb0721",
+	"7f0e27f1487f531b0b0bb0b6fb0722",
+	"7f0e397bd097c35b0b6fc920fb0722",
+	"9778397bd097c36b0b6fc9274c91aa",
+	"97b6b7f0e47f531b0723b0b6fb0721",
+	"7f0e27f1487f531b0b0bb0b6fb0722",
+	"7f0e397bd07f595b0b0bc920fb0722",
+	"9778397bd097c36b0b6fc9274c91aa",
+	"97b6b7f0e47f531b0723b0787b0721",
+	"7f0e27f0e47f531b0b0bb0b6fb0722",
+	"7f0e397bd07f595b0b0bc920fb0722",
+	"9778397bd097c36b0b6fc9210c91aa",
+	"97b6b7f0e47f149b0723b0787b0721",
+	"7f0e27f0e47f531b0723b0b6fb0722",
+	"7f0e397bd07f595b0b0bc920fb0722",
+	"9778397bd097c36b0b6fc9210c8dc2",
+	"977837f0e37f149b0723b0787b0721",
+	"7f07e7f0e47f531b0723b0b6fb0722",
+	"7f0e37f5307f595b0b0bc920fb0722",
+	"7f0e397bd097c35b0b6fc9210c8dc2",
+	"977837f0e37f14998082b0787b0721",
+	"7f07e7f0e47f531b0723b0b6fb0721",
+	"7f0e37f1487f595b0b0bb0b6fb0722",
+	"7f0e397bd097c35b0b6fc9210c8dc2",
+	"977837f0e37f14998082b0787b06bd",
+	"7f07e7f0e47f531b0723b0b6fb0721",
+	"7f0e27f1487f531b0b0bb0b6fb0722",
+	"7f0e397bd097c35b0b6fc920fb0722",
+	"977837f0e37f14998082b0787b06bd",
+	"7f07e7f0e47f531b0723b0b6fb0721",
+	"7f0e27f1487f531b0b0bb0b6fb0722",
+	"7f0e397bd097c35b0b6fc920fb0722",
+	"977837f0e37f14998082b0787b06bd",
+	"7f07e7f0e47f531b0723b0b6fb0721",
+	"7f0e27f1487f531b0b0bb0b6fb0722",
+	"7f0e397bd07f595b0b0bc920fb0722",
+	"977837f0e37f14998082b0787b06bd",
+	"7f07e7f0e47f531b0723b0b6fb0721",
+	"7f0e27f1487f531b0b0bb0b6fb0722",
+	"7f0e397bd07f595b0b0bc920fb0722",
+	"977837f0e37f14998082b0787b06bd",
+	"7f07e7f0e47f149b0723b0787b0721",
+	"7f0e27f0e47f531b0b0bb0b6fb0722",
+	"7f0e397bd07f595b0b0bc920fb0722",
+	"977837f0e37f14998082b0723b06bd",
+	"7f07e7f0e37f149b0723b0787b0721",
+	"7f0e27f0e47f531b0723b0b6fb0722",
+	"7f0e397bd07f595b0b0bc920fb0722",
+	"977837f0e37f14898082b0723b02d5",
+	"7ec967f0e37f14998082b0787b0721",
+	"7f07e7f0e47f531b0723b0b6fb0722",
+	"7f0e37f1487f595b0b0bb0b6fb0722",
+	"7f0e37f0e37f14898082b0723b02d5",
+	"7ec967f0e37f14998082b0787b0721",
+	"7f07e7f0e47f531b0723b0b6fb0722",
+	"7f0e37f1487f531b0b0bb0b6fb0722",
+	"7f0e37f0e37f14898082b0723b02d5",
+	"7ec967f0e37f14998082b0787b06bd",
+	"7f07e7f0e47f531b0723b0b6fb0721",
+	"7f0e37f1487f531b0b0bb0b6fb0722",
+	"7f0e37f0e37f14898082b072297c35",
+	"7ec967f0e37f14998082b0787b06bd",
+	"7f07e7f0e47f531b0723b0b6fb0721",
+	"7f0e27f1487f531b0b0bb0b6fb0722",
+	"7f0e37f0e37f14898082b072297c35",
+	"7ec967f0e37f14998082b0787b06bd",
+	"7f07e7f0e47f531b0723b0b6fb0721",
+	"7f0e27f1487f531b0b0bb0b6fb0722",
+	"7f0e37f0e366aa89801eb072297c35",
+	"7ec967f0e37f14998082b0787b06bd",
+	"7f07e7f0e47f149b0723b0787b0721",
+	"7f0e27f1487f531b0b0bb0b6fb0722",
+	"7f0e37f0e366aa89801eb072297c35",
+	"7ec967f0e37f14998082b0723b06bd",
+	"7f07e7f0e47f149b0723b0787b0721",
+	"7f0e27f0e47f531b0723b0b6fb0722",
+	"7f0e37f0e366aa89801eb072297c35",
+	"7ec967f0e37f14998082b0723b06bd",
+	"7f07e7f0e37f14998083b0787b0721",
+	"7f0e27f0e47f531b0723b0b6fb0722",
+	"7f0e37f0e366aa89801eb072297c35",
+	"7ec967f0e37f14898082b0723b02d5",
+	"7f07e7f0e37f14998082b0787b0721",
+	"7f07e7f0e47f531b0723b0b6fb0722",
+	"7f0e36665b66aa89801e9808297c35",
+	"665f67f0e37f14898082b0723b02d5",
+	"7ec967f0e37f14998082b0787b0721",
+	"7f07e7f0e47f531b0723b0b6fb0722",
+	"7f0e36665b66a449801e9808297c35",
+	"665f67f0e37f14898082b0723b02d5",
+	"7ec967f0e37f14998082b0787b06bd",
+	"7f07e7f0e47f531b0723b0b6fb0721",
+	"7f0e36665b66a449801e9808297c35",
+	"665f67f0e37f14898082b072297c35",
+	"7ec967f0e37f14998082b0787b06bd",
+	"7f07e7f0e47f531b0723b0b6fb0721",
+	"7f0e26665b66a449801e9808297c35",
+	"665f67f0e37f1489801eb072297c35",
+	"7ec967f0e37f14998082b0787b06bd",
+	"7f07e7f0e47f531b0723b0b6fb0721",
+	"7f0e27f1487f531b0b0bb0b6fb0722"
+];
+/**
+* 数字转中文速查表
+* @Array Of Property
+* @trans ['日','一','二','三','四','五','六','七','八','九','十']
+* @return Cn string
+*/
+const nStr1 = [
+	"日",
+	"一",
+	"二",
+	"三",
+	"四",
+	"五",
+	"六",
+	"七",
+	"八",
+	"九",
+	"十"
+];
+/**
+* 日期转农历称呼速查表
+* @Array Of Property
+* @trans ['初','十','廿','卅']
+* @return Cn string
+*/
+const nStr2 = [
+	"初",
+	"十",
+	"廿",
+	"卅"
+];
+/**
+* 月份转农历称呼速查表
+* @Array Of Property
+* @trans ['正','一','二','三','四','五','六','七','八','九','十','冬','腊']
+* @return Cn string
+*/
+const nStr3 = [
+	"正",
+	"二",
+	"三",
+	"四",
+	"五",
+	"六",
+	"七",
+	"八",
+	"九",
+	"十",
+	"冬",
+	"腊"
+];
+// src/utils/Assert.ts
+/** 四位 "MMDD"，月份 01-12、日期 01-31 */
+const MMDD_RE = /^(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])$/;
+/** 预生成的 MMDD 查表键（12 × 31），避免每次查节日 / 调休都拼字符串 */
+const MMDD = Array.from({ length: 13 }, () => Array.from({ length: 32 }, () => ""));
+for (let m = 1; m <= 12; m++) for (let d = 1; d <= 31; d++) MMDD[m][d] = (m < 10 ? "0" + m : String(m)) + (d < 10 ? "0" + d : String(d));
+/** 取四位 MMDD 字符串，例如 mmddOf(1, 1) → "0101" */
+const mmddOf = function(m, d) {
+	return MMDD[m][d];
+};
+/** 调休年份：1900-2100 */
+const YEAR_RE = /^(19\d{2}|20\d{2}|2100)$/;
+/** 公历每个月的最大天数，2 月按闰年放宽到 29 */
+const SOLAR_MAX_DAY = [
+	31,
+	29,
+	31,
+	30,
+	31,
+	30,
+	31,
+	31,
+	30,
+	31,
+	30,
+	31
+];
+/** 调休表每年的字段 */
+const REST_FIELDS = ["xiu", "ban"];
+/** 抛出带位置信息的 TypeError，用于配置格式错误 */
+function failType(path, message) {
+	throw new TypeError(`[calendar] ${path} ${message}`);
+}
+/** 抛出带位置信息的 RangeError，用于数值越界 */
+function failRange(path, message) {
+	throw new RangeError(`[calendar] ${path} ${message}`);
+}
+/** 是否为普通对象（非 null、非数组） */
+const isPlainObject = function(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+};
+/** 校验是普通对象，否则按 path 抛 TypeError；断言之后可以直接当字典用 */
+function assertPlainObject(value, path, message = "必须是对象") {
+	if (!isPlainObject(value)) failType(path, `${message}，收到 ${describe(value)}`);
+}
+/** 校验对象里没有白名单之外的字段 */
+const assertKnownKeys = function(value, allowed, path) {
+	Object.keys(value).forEach(function(key) {
+		if (allowed.indexOf(key) === -1) failType(`${path}.${key}`, `不认识的字段，只支持 ${allowed.join(" 与 ")}`);
+	});
+};
+/** 把任意值格式化成便于排查的短字符串 */
+const describe = function(value) {
+	if (typeof value === "string") return JSON.stringify(value);
+	if (typeof value === "number" || typeof value === "boolean" || value === null || value === void 0) return String(value);
+	if (Array.isArray(value)) return `Array(${value.length})`;
+	if (typeof value === "object") {
+		const keys = Object.keys(value);
+		return `Object(keys: ${keys.slice(0, 5).join(", ")}${keys.length > 5 ? ", …" : ""})`;
+	}
+	return typeof value;
+};
+/** 校验一个整数并返回它 */
+const assertInteger = function(path, value, min, max) {
+	if (typeof value !== "number" || !Number.isInteger(value)) return failRange(path, `必须是整数，收到 ${describe(value)}`);
+	if (value < min || value > max) return failRange(path, `必须在 ${min}-${max} 之间，收到 ${value}`);
+	return value;
+};
+/** 公历 MMDD 是否对应真实存在的日期（例如 0231、0431 为 false） */
+const isSolarMonthDay = function(m, d) {
+	return d >= 1 && d <= (SOLAR_MAX_DAY[m - 1] ?? 0);
+};
+/** 农历 MMDD：每个月最多 30 天 */
+const isLunarMonthDay = function(m, d) {
+	return d >= 1 && d <= 30;
+};
+/**
+* 校验并解析四位 MMDD：节日 key 与调休日期共用同一套格式和日期检查
+*
+* @param value 待校验值，必须是 "MMDD" 字符串
+* @param path 出错时用于定位的路径
+* @param options.lunar 按农历校验（每月最多 30 天），默认公历
+* @param options.label 报错信息里的主语，例如 "节日 key"
+*/
+function assertMMDD(value, path, options = {}) {
+	const { lunar = false, label } = options;
+	const prefix = label === void 0 ? "" : `${label} `;
+	const parsed = typeof value === "string" && MMDD_RE.test(value) ? {
+		month: Number(value.slice(0, 2)),
+		day: Number(value.slice(2)),
+		text: value
+	} : null;
+	if (parsed === null) failType(path, `${prefix}必须是四位 "MMDD"（如 "0101"），收到 ${describe(value)}`);
+	if (!(lunar ? isLunarMonthDay(parsed.month, parsed.day) : isSolarMonthDay(parsed.month, parsed.day))) failType(path, `${lunar ? "农历" : "公历"}不存在 ${parsed.month} 月 ${parsed.day} 日`);
+	return parsed;
+}
+/**
+* 校验并规范化节日表
+*
+* @param input 待校验的节日表
+* @param path 出错时用于定位的路径，例如 "createCalendar.setFestival.sFtv"
+* @param lunar 农历节日（true）还是公历节日（false）
+*/
+const normalizeFestivalMap = function(input, path, lunar = false) {
+	assertPlainObject(input, path);
+	const result = {};
+	Object.keys(input).forEach(function(key) {
+		assertMMDD(key, `${path}.${key}`, {
+			lunar,
+			label: "节日 key"
+		});
+		const value = input[key];
+		if (!Array.isArray(value)) throw failType(`${path}.${key}`, `节日名称必须是字符串数组，收到 ${describe(value)}`);
+		const names = [];
+		value.forEach(function(name, index) {
+			if (typeof name !== "string" || name.trim() === "") throw failType(`${path}.${key}[${index}]`, `节日名称必须是非空字符串，收到 ${describe(name)}`);
+			names.push(name);
+		});
+		result[key] = names;
+	});
+	return result;
+};
+/** 校验并去重一组调休日期（MMDD 字符串） */
+const normalizeDayList = function(input, path) {
+	if (!Array.isArray(input)) throw failType(path, `必须是 "MMDD" 字符串数组，收到 ${describe(input)}`);
+	const days = [];
+	input.forEach(function(day, index) {
+		days.push(assertMMDD(day, `${path}[${index}]`).text);
+	});
+	return Array.from(new Set(days));
+};
+/**
+* 校验并规范化调休表，key 为年份
+*
+* @param input 待校验的调休表
+* @param path 出错时用于定位的路径
+*/
+const normalizeRestMap = function(input, path) {
+	assertPlainObject(input, path);
+	const result = {};
+	Object.keys(input).forEach(function(yearKey) {
+		if (!YEAR_RE.test(yearKey)) throw failType(`${path}.${yearKey}`, `年份必须是 1900-2100 的四位数字，收到 ${describe(yearKey)}`);
+		const entry = input[yearKey];
+		assertPlainObject(entry, `${path}.${yearKey}`, "必须是 { xiu: [], ban: [] }");
+		assertKnownKeys(entry, REST_FIELDS, `${path}.${yearKey}`);
+		const xiu = entry.xiu === void 0 ? [] : normalizeDayList(entry.xiu, `${path}.${yearKey}.xiu`);
+		const ban = entry.ban === void 0 ? [] : normalizeDayList(entry.ban, `${path}.${yearKey}.ban`);
+		const conflict = xiu.filter(function(day) {
+			return ban.indexOf(day) !== -1;
+		});
+		if (conflict.length > 0) throw failType(`${path}.${yearKey}`, `同一天不能既是放假日又是补班日：${conflict.join("、")}`);
+		result[yearKey] = {
+			xiu,
+			ban
+		};
+	});
+	return result;
+};
+// src/utils/LunarFunction.ts
+/** 农历数据表覆盖的年份 */
+const LUNAR_YEAR_MIN = 1900;
+const LUNAR_YEAR_MAX = 2100;
+/**
+* 校验农历年份是否在数据表范围内，越界直接抛 RangeError
+*/
+const assertLunarYear = function(y, path) {
+	return assertInteger(path, y, LUNAR_YEAR_MIN, LUNAR_YEAR_MAX);
+};
+/**
+* 返回农历 y 年一整年的总天数
+* @param y 农历年（1900-2100）
+* @return 348-385
+*/
+const lYearDays = function(y) {
+	assertLunarYear(y, "lYearDays(year)");
+	let sum = 348;
+	for (let i = 32768; i > 8; i >>= 1) sum += LunarInfo[y - 1900] & i ? 1 : 0;
+	return sum + leapDays(y);
+};
+/**
+* 返回农历 y 年闰月是哪个月；没有闰月返回 0
+* @param y 农历年（1900-2100）
+*/
+const leapMonth = function(y) {
+	assertLunarYear(y, "leapMonth(year)");
+	return LunarInfo[y - 1900] & 15;
+};
+/**
+* 返回农历 y 年闰月的天数；没有闰月返回 0
+* @param y 农历年（1900-2100）
+*/
+const leapDays = function(y) {
+	if (leapMonth(y)) return LunarInfo[y - 1900] & 65536 ? 30 : 29;
+	return 0;
+};
+/**
+* 返回农历 y 年 m 月（非闰月）的天数，闰月天数请用 leapDays
+* @param y 农历年（1900-2100）
+* @param m 农历月（1-12）
+*/
+const lMonthDays = function(y, m) {
+	assertLunarYear(y, "lMonthDays(year)");
+	assertInteger("lMonthDays(month)", m, 1, 12);
+	return LunarInfo[y - 1900] & 65536 >> m ? 30 : 29;
+};
+/** 农历每年正月初一距 1900-01-31 的天数；长度 202，最后一项是 2101 正月初一 */
+const YEAR_START = (function() {
+	const starts = [0];
+	for (let y = LUNAR_YEAR_MIN; y <= LUNAR_YEAR_MAX; y++) starts.push(starts[starts.length - 1] + lYearDays(y));
+	return starts;
+})();
+/** 某年正月初一距 1900-01-31 的天数 */
+const yearStartOf = function(year) {
+	assertLunarYear(year, "yearStartOf(year)");
+	return YEAR_START[year - LUNAR_YEAR_MIN];
+};
+const segmentCache = /* @__PURE__ */ new Map();
+/** 某年的月份段表（按时间顺序），第一次构建后缓存 */
+const monthSegmentsOf = function(year) {
+	const cached = segmentCache.get(year);
+	if (cached) return cached;
+	const leap = leapMonth(year);
+	const segments = [];
+	let start = 0;
+	for (let m = 1; m <= 12; m++) {
+		segments.push({
+			month: m,
+			isLeap: false,
+			start
+		});
+		start += lMonthDays(year, m);
+		if (leap === m) {
+			segments.push({
+				month: m,
+				isLeap: true,
+				start
+			});
+			start += leapDays(year);
+		}
+	}
+	segmentCache.set(year, segments);
+	return segments;
+};
+/** 把“距 1900-01-31 的天数”换算成农历年与当年第几天（二分查找，替代逐年累减） */
+const resolveLunarYear = function(offset) {
+	let low = 0;
+	let high = 200;
+	while (low < high) {
+		const mid = low + high + 1 >>> 1;
+		if (YEAR_START[mid] <= offset) low = mid;
+		else high = mid - 1;
+	}
+	return {
+		year: LUNAR_YEAR_MIN + low,
+		offsetInYear: offset - YEAR_START[low]
+	};
+};
+/**
+* 农历年转换为干支纪年
+* @param lYear 农历年，允许 1899 这类边界年（只做算术，不查表）
+*/
+const toGanZhiYear = function(lYear) {
+	if (typeof lYear !== "number" || !Number.isInteger(lYear)) failRange("toGanZhiYear(year)", `必须是整数，收到 ${lYear}`);
+	let ganKey = (lYear - 3) % 10;
+	let zhiKey = (lYear - 3) % 12;
+	if (ganKey <= 0) ganKey += 10;
+	if (zhiKey <= 0) zhiKey += 12;
+	return Gan[ganKey - 1] + Zhi[zhiKey - 1];
+};
+/**
+* 传入相对甲子的偏移量返回干支
+* @param offset 可以为负数
+*/
+const toGanZhi = function(offset) {
+	if (typeof offset !== "number" || !Number.isInteger(offset)) failRange("toGanZhi(offset)", `必须是整数，收到 ${offset}`);
+	const gan = (offset % 10 + 10) % 10;
+	const zhi = (offset % 12 + 12) % 12;
+	return Gan[gan] + Zhi[zhi];
+};
+/**
+* 传入当天的干支偏移量，返回当天十二个时辰的干支
+* @param offset 相对甲子的偏移量（与 gzDay 用同一个偏移量）
+*/
+const toHourGanZhi = function(offset) {
+	if (typeof offset !== "number" || !Number.isInteger(offset)) failRange("toHourGanZhi(offset)", `必须是整数，收到 ${offset}`);
+	const index = (offset % 10 + 10) % 10;
+	return GanZhiHour[index].split("-");
+};
+/**
+* 农历数字月份转中文，例如 1 -> "正月"、12 -> "腊月"
+* @param m 农历月（1-12）
+*/
+const toChinaMonth = function(m) {
+	assertInteger("toChinaMonth(month)", m, 1, 12);
+	return nStr3[m - 1] + "月";
+};
+/**
+* 农历日期数字转中文，例如 1 -> "初一"、21 -> "廿一"
+* @param d 农历日（1-30）
+*/
+const toChinaDay = function(d) {
+	assertInteger("toChinaDay(day)", d, 1, 30);
+	switch (d) {
+		case 10: return "初十";
+		case 20: return "二十";
+		case 30: return "三十";
+		default: return nStr2[Math.floor(d / 10)] + nStr1[d % 10];
+	}
+};
+/**
+* 取第 n 个节气名（n 从 0 开始，0 为小寒）
+* @param n 0-23
+*/
+const getSolarTerm = function(n) {
+	assertInteger("getSolarTerm(n)", n, 0, 23);
+	return SolarTerm[n];
+};
+// src/utils/SolarFunction.ts
+/** 公历年份下限，只为挡住明显错误的入参 */
+const SOLAR_YEAR_MIN = 1;
+const SOLAR_YEAR_MAX = 9999;
+const MS_PER_DAY = 864e5;
+/** 1970-01-01 是星期四，用作星期推算的基准 */
+const EPOCH_WEEKDAY = 4;
+/** 用毫秒数直接算星期，避免每次都 new Date */
+const weekdayOf = function(y, m, d) {
+	return ((Math.round(Date.UTC(y, m - 1, d) / MS_PER_DAY) + EPOCH_WEEKDAY) % 7 + 7) % 7;
+};
+/** 按年缓存的 24 个节气日期，同一年只解析一次 */
+const termCache = /* @__PURE__ */ new Map();
+/** 解析某一年的节气表，返回 24 个日期数字 */
+const parseTerms = function(y) {
+	const table = TermInfo[y - 1900];
+	if (typeof table !== "string" || table.length < 30) failRange("getTerm(year)", `缺少 ${y} 年的节气数据`);
+	const days = [];
+	for (let i = 0; i < 6; i++) {
+		const chunk = parseInt(table.slice(i * 5, i * 5 + 5), 16).toString();
+		days.push(Number(chunk.slice(0, 1)), Number(chunk.slice(1, 3)), Number(chunk.slice(3, 4)), Number(chunk.slice(4, 6)));
+	}
+	return days;
+};
+/**
+* 返回公历 y 年 m 月的天数（会自动处理闰年）
+* @param y 公历年
+* @param m 公历月（1-12）
+* @return 28-31
+*/
+const solarDays = function(y, m) {
+	assertInteger("solarDays(year)", y, SOLAR_YEAR_MIN, SOLAR_YEAR_MAX);
+	assertInteger("solarDays(month)", m, 1, 12);
+	if (m === 2) return y % 4 === 0 && y % 100 !== 0 || y % 400 === 0 ? 29 : 28;
+	return SolarMonth[m - 1];
+};
+/**
+* 返回公历 y 年 m 月 1 日是星期几
+* @param y 公历年
+* @param m 公历月（1-12）
+* @return 0-6，0 为周日
+*/
+const solarFirstWeek = function(y, m) {
+	assertInteger("solarFirstWeek(year)", y, SOLAR_YEAR_MIN, SOLAR_YEAR_MAX);
+	assertInteger("solarFirstWeek(month)", m, 1, 12);
+	return weekdayOf(y, m, 1);
+};
+/**
+* 返回公历 y 年 m 月第 nth 个星期 weekday 是几号
+* @param y 公历年
+* @param m 公历月（1-12）
+* @param weekday 0-6，0 为周日
+* @param nth 第几个，从 1 开始
+* @example nthWeekdayOfMonth(2026, 5, 0, 2) // 10，2026 年母亲节是 5 月 10 日
+*/
+const nthWeekdayOfMonth = function(y, m, weekday, nth) {
+	assertInteger("nthWeekdayOfMonth(weekday)", weekday, 0, 6);
+	assertInteger("nthWeekdayOfMonth(nth)", nth, 1, 5);
+	const day = 1 + (weekday - solarFirstWeek(y, m) + 7) % 7 + (nth - 1) * 7;
+	if (day > solarDays(y, m)) failRange("nthWeekdayOfMonth", `${y} 年 ${m} 月没有第 ${nth} 个星期${weekday}，超出当月天数`);
+	return day;
+};
+/**
+* 星座名称，每个星座占两个字符，末尾补一个摩羯座用于 12 月下旬切片
+*/
+const ASTRO_NAMES = "摩羯水瓶双鱼白羊金牛双子巨蟹狮子处女天秤天蝎射手摩羯";
+/** 每个月切换星座的日期，当天大于等于该值即属于后一个星座 */
+const ASTRO_CUSP = [
+	20,
+	19,
+	21,
+	20,
+	21,
+	22,
+	23,
+	23,
+	23,
+	24,
+	23,
+	22
+];
+/**
+* 公历月、日判断所属星座
+* @param m 公历月（1-12）
+* @param d 公历日
+* @example toAstro(4, 19) // "白羊座"
+*/
+const toAstro = function(m, d) {
+	assertInteger("toAstro(month)", m, 1, 12);
+	assertInteger("toAstro(day)", d, 1, 31);
+	const start = m * 2 - (d < ASTRO_CUSP[m - 1] ? 2 : 0);
+	return ASTRO_NAMES.slice(start, start + 2) + "座";
+};
+/**
+* 传入公历年获得该年第 n 个节气所在公历月的日期
+* @param y 公历年（1900-2100）
+* @param n 第几个节气（1-24），1 为小寒
+* @return 日期数字
+* @example getTerm(1987, 3) // 4，1987 年 2 月 4 日立春
+*/
+const getTerm = function(y, n) {
+	assertInteger("getTerm(year)", y, 1900, 2100);
+	assertInteger("getTerm(n)", n, 1, 24);
+	let days = termCache.get(y);
+	if (days === void 0) {
+		days = parseTerms(y);
+		termCache.set(y, days);
+	}
+	const day = days[n - 1];
+	if (!Number.isInteger(day)) failRange("getTerm", `${y} 年第 ${n} 个节气解析失败`);
+	return day;
+};
+/**
+* 年份转生肖，以农历年为准
+* @param y 年份
+* @example getAnimal(1987) // "兔"
+*/
+const getAnimal = function(y) {
+	assertInteger("getAnimal(year)", y, SOLAR_YEAR_MIN, SOLAR_YEAR_MAX);
+	return Animals[((y - 4) % 12 + 12) % 12];
+};
+/**
+* 数字转中文，0-10
+* @param num 0-10
+* @example toChinaNum(3) // "三"
+*/
+const toChinaNum = function(num) {
+	assertInteger("toChinaNum(num)", num, 0, 10);
+	return nStr1[num];
+};
+// src/utils/SetFestival.ts
+/** 没有节日时共用的空数组，冻结后不怕调用方误改 */
+const NO_FESTIVAL = Object.freeze([]);
+/**
+* 把两份节日表按 key 合并并去重，不修改入参
+*/
+const mergeFestivalMap = function(base, extra) {
+	if (!extra) return base;
+	const result = { ...base };
+	Object.keys(extra).forEach(function(key) {
+		const merged = result[key] ? result[key].concat(extra[key]) : extra[key];
+		result[key] = Array.from(new Set(merged));
+	});
+	return result;
+};
+/**
+* 冻结节日表，防止调用方后续误改
+*/
+const freezeFestivalMap = function(map) {
+	Object.keys(map).forEach(function(key) {
+		Object.freeze(map[key]);
+	});
+	return Object.freeze(map);
+};
+/**
+* 取某一天（MMDD）的节日名称，没有则返回共享的空数组。
+*
+* 返回的是只读数组：配置里的数组已被冻结，调用方要追加节日必须自己 copy。
+*/
+const festivalList = function(map, m, d) {
+	return map[mmddOf(m, d)] ?? NO_FESTIVAL;
+};
+// src/utils/SetRest.ts
+/**
+* 按年、按列表合并调休数据，不修改入参
+*/
+const mergeRestMap = function(base, extra) {
+	if (!extra) return base;
+	const result = {};
+	new Set(Object.keys(base).concat(Object.keys(extra))).forEach(function(year) {
+		const left = base[year];
+		const right = extra[year];
+		if (left && right) result[year] = {
+			xiu: Array.from(new Set(left.xiu.concat(right.xiu))),
+			ban: Array.from(new Set(left.ban.concat(right.ban)))
+		};
+		else if (left) result[year] = left;
+		else if (right) result[year] = right;
+	});
+	return result;
+};
+/**
+* 冻结调休表
+*/
+const freezeRestMap = function(map) {
+	Object.keys(map).forEach(function(year) {
+		Object.freeze(map[year].xiu);
+		Object.freeze(map[year].ban);
+		Object.freeze(map[year]);
+	});
+	return Object.freeze(map);
+};
+/**
+* 建立年份 -> Set 的索引
+*/
+const buildRestIndex = function(map) {
+	const index = {};
+	Object.keys(map).forEach(function(year) {
+		index[year] = {
+			xiu: new Set(map[year].xiu),
+			ban: new Set(map[year].ban)
+		};
+	});
+	return index;
+};
+/**
+* 查询某天的调休状态
+*
+* 只返回一个字符串，不为每天分配 { isHoliday, isBan } 对象。
+*/
+const restOf = function(index, y, m, d) {
+	const entry = index[y];
+	if (!entry) return void 0;
+	const key = mmddOf(m, d);
+	if (entry.ban.has(key)) return "ban";
+	if (entry.xiu.has(key)) return "xiu";
+};
+// src/data/festival.json
+var festival_default = {
+	sFtv: {
+		"1001": [
+			"国庆节",
+			"国际音乐日",
+			"国际老人节"
+		],
+		"1002": ["国际和平与民主自由斗争日"],
+		"1004": [
+			"世界动物日",
+			"世界住房日",
+			"国际建筑日"
+		],
+		"1005": ["世界教师日"],
+		"1008": [
+			"世界视觉日",
+			"全国高血压日",
+			"世界视力日"
+		],
+		"1009": ["世界邮政日"],
+		"1010": ["世界精神卫生日", "辛亥革命纪念日"],
+		"1011": ["萝莉节"],
+		"1012": ["世界关节炎日"],
+		"1013": [
+			"国际减轻自然灾害日",
+			"世界保健日",
+			"国际标准时间日",
+			"中国少年先锋队诞辰日"
+		],
+		"1014": ["世界标准日"],
+		"1015": [
+			"国际盲人节",
+			"全球洗手日",
+			"世界农村妇女日"
+		],
+		"1016": ["世界粮食节"],
+		"1017": ["国际消除贫困日", "国家扶贫日"],
+		"1019": ["世界镇痛日"],
+		"1020": ["世界骨质疏松日", "世界厨师日"],
+		"1022": ["世界传统医药日"],
+		"1024": ["联合国日", "世界发展信息日"],
+		"1025": [
+			"人类天花绝迹日",
+			"抗美援朝纪念日",
+			"台湾光复纪念日"
+		],
+		"1028": ["世界男性健康日"],
+		"1029": ["圣纪节"],
+		"1031": ["世界勤俭日"],
+		"1101": ["万圣节"],
+		"1108": ["中国记者日", "记者节"],
+		"1109": ["消防宣传日"],
+		"1111": ["光棍节", "双十一购物狂欢节"],
+		"1112": ["吉尼斯世界纪录日"],
+		"1114": ["联合国糖尿病日", "屌丝节"],
+		"1116": ["国际宽容日"],
+		"1117": ["国际大学生节"],
+		"1119": ["世界厕所日"],
+		"1120": ["世界儿童日"],
+		"1121": ["世界电视日", "世界问候日"],
+		"1125": ["国际消除对妇女的暴力日"],
+		"1129": ["国际声援巴勒斯坦人民日"],
+		"1201": ["世界艾滋病日"],
+		"1202": ["全国交通安全日"],
+		"1203": ["国际残疾人日"],
+		"1204": ["全国法制宣传日", "国家宪法日"],
+		"1205": ["国际志愿人员日"],
+		"1207": ["国际民航日"],
+		"1209": ["世界足球日", "国际反腐败日"],
+		"1210": ["世界人权日"],
+		"1212": ["双十二购物狂欢节", "国际儿童电视广播日"],
+		"1213": ["国家公祭日"],
+		"1215": ["世界强化免疫日"],
+		"1218": ["国际移徙者日"],
+		"1219": ["联合国南南合作日"],
+		"1220": ["澳门回归纪念"],
+		"1221": ["国际篮球日"],
+		"1224": ["平安夜", "长津湖战役胜利纪念日"],
+		"1225": ["圣诞节"],
+		"1226": ["毛泽东诞辰日"],
+		"0101": ["元旦"],
+		"0110": ["中国人民警察节"],
+		"0131": ["国际麻风节"],
+		"0126": ["国际海关日"],
+		"0127": ["国际大屠杀纪念日"],
+		"0202": ["世界湿地日"],
+		"0207": ["国际声援南非日"],
+		"0210": ["国际气象节"],
+		"0214": ["情人节"],
+		"0224": ["第三世界青年日"],
+		"0204": ["世界抗癌症日", "世界癌症日"],
+		"0221": ["国际母语日"],
+		"0228": ["国际罕见病日", "世界居住条件调查日"],
+		"0301": ["国际海豹日", "国际民防日"],
+		"0303": ["全国爱耳日"],
+		"0305": ["学雷锋纪念日", "中国青年志愿者服务日"],
+		"0308": ["妇女节"],
+		"0312": ["植树节", "世界肾脏日"],
+		"0314": ["白色情人节", "国际警察日"],
+		"0315": ["消费者权益日"],
+		"0317": ["国际航海日", "中国国医节"],
+		"0320": ["世界无肉日"],
+		"0321": [
+			"世界睡眠日",
+			"世界森林日",
+			"世界儿歌日",
+			"国际消除种族歧视日",
+			"世界诗歌日"
+		],
+		"0322": ["世界水日"],
+		"0323": ["世界气象日"],
+		"0311": ["国际尊严尊敬日"],
+		"0316": ["手拉手情系贫困小伙伴全国统一行动日", "世界社会工作日"],
+		"0324": ["世界防治结核病日"],
+		"0307": ["女生节"],
+		"0306": ["世界青光眼日"],
+		"0327": ["世界戏剧日"],
+		"0309": ["保护母亲河日"],
+		"0318": ["全国科技人才活动日"],
+		"0329": ["全国中小学生安全教育日"],
+		"0410": ["耶稣受难日", "非洲环境保护日"],
+		"0401": ["愚人节"],
+		"0402": ["国际儿童图书日", "世界自闭症日"],
+		"0407": ["世界卫生日"],
+		"0411": ["世界帕金森病日"],
+		"0422": ["世界地球日"],
+		"0423": ["世界读书日", "中国海军建军节"],
+		"0426": ["世界知识产权日", "世界防治疟疾日"],
+		"0404": ["复活节", "清明节"],
+		"0417": ["世界血友病日"],
+		"0418": ["国际古迹遗址日"],
+		"0421": ["秘书节"],
+		"0425": ["全国儿童预防接种宣传日"],
+		"0428": ["世界安全生产与健康日"],
+		"0429": ["化学战受害者纪念日"],
+		"0415": ["全民国家安全教育日"],
+		"0424": ["中国航天日"],
+		"0430": ["全国交通安全反思日"],
+		"0501": ["劳动节"],
+		"0504": ["青年节", "五四运动纪念日"],
+		"0505": ["世界哮喘日", "碘缺乏病防治日"],
+		"0508": ["世界红十字日", "世界微笑日"],
+		"0512": ["国际护士节", "全国防灾减灾日"],
+		"0510": ["中国品牌日"],
+		"0515": ["国际家庭日", "防治碘缺乏病日"],
+		"0517": [
+			"世界电信日",
+			"全国助残日",
+			"世界高血压日"
+		],
+		"0518": ["国际博物馆日"],
+		"0520": [
+			"全国学生营养日",
+			"全国母乳喂养宣传日",
+			"世界计量日"
+		],
+		"0522": ["国际生物多样性日"],
+		"0531": ["世界无烟日"],
+		"0513": ["开斋节"],
+		"0503": ["世界新闻自由日"],
+		"0521": ["世界文化发展日"],
+		"0526": ["世界向人体条件挑战日"],
+		"0529": ["国际维和人员日"],
+		"0509": ["救助贫困母亲日"],
+		"0519": ["中国旅游日"],
+		"0606": ["全国爱眼日"],
+		"0601": ["国际儿童节", "世界牛奶日"],
+		"0605": ["世界环境日"],
+		"0612": ["中国文化遗产日", "世界无童工日"],
+		"0620": ["世界难民日"],
+		"0617": ["世界防治荒漠化和干旱日"],
+		"0623": ["国际奥林匹克日"],
+		"0625": ["全国土地日"],
+		"0626": ["国际禁毒日", "联合国宪章日"],
+		"0604": ["受侵略戕害的无辜儿童国际日"],
+		"0608": ["世界海洋日"],
+		"0614": ["世界献血日"],
+		"0630": ["世界青年联欢节"],
+		"0622": ["中国儿童慈善活动日"],
+		"0701": [
+			"香港回归纪念日",
+			"建党节",
+			"世界建筑日"
+		],
+		"0703": ["国际合作节"],
+		"0711": ["世界人口日", "中国航海日"],
+		"0720": ["古尔邦节", "人类月球日"],
+		"0702": ["国际体育记者日"],
+		"0706": ["国际接吻日"],
+		"0707": ["七七事变纪念日"],
+		"0708": ["世界过敏性疾病日"],
+		"0718": ["纳尔逊·曼德拉国际日"],
+		"0728": ["世界肝炎日"],
+		"0731": ["非洲妇女节"],
+		"0801": ["建军节"],
+		"0803": ["男人节"],
+		"0808": ["八卦节", "全民健身日"],
+		"0809": ["国际土著人日"],
+		"0826": ["纳米比亚日", "全国律师咨询日"],
+		"0815": ["日本无条件投降日"],
+		"0819": ["中国医师节"],
+		"0903": ["中国人民抗日战争纪念日", "中国人民抗日战争胜利纪念日"],
+		"0908": ["国际扫盲日"],
+		"0910": ["教师节", "世界预防自杀日"],
+		"0916": ["国际臭氧层保护日"],
+		"0918": [
+			"中国国耻日",
+			"世界清洁地球日",
+			"九一八事变",
+			"全民国防教育日"
+		],
+		"0920": ["国际爱牙日", "公民道德宣传日"],
+		"0921": [
+			"国际和平日",
+			"世界停火日",
+			"世界阿尔茨海默病日"
+		],
+		"0927": [
+			"国际聋人节",
+			"世界旅游日",
+			"国际聋人日"
+		],
+		"0928": ["孔子诞辰"],
+		"0911": ["世界急救日"],
+		"0915": ["国际民主日"],
+		"0922": ["世界无车日"],
+		"0926": ["世界避孕日"],
+		"0930": ["国际翻译日", "烈士纪念日"],
+		"0905": ["中华慈善日"]
+	},
+	lFtv: {
+		"0101": ["春节"],
+		"0107": ["人日"],
+		"0115": ["元宵节"],
+		"0202": ["龙抬头", "中和节"],
+		"0303": ["上巳节"],
+		"0505": ["端午节"],
+		"0520": ["分龙节"],
+		"0616": ["鲁班节"],
+		"0707": ["七夕情人节"],
+		"0714": ["鬼节(南方)"],
+		"0715": ["中元节", "盂兰节"],
+		"0815": ["中秋节"],
+		"0909": ["重阳节"],
+		"1001": ["寒衣节"],
+		"1015": ["下元节"],
+		"1208": ["腊八节"],
+		"1223": ["小年", "祭灶节"],
+		"1230": ["除夕"]
+	}
+};
+// src/data/rest.json
+var rest_default = {
+	"2026": {
+		"xiu": [
+			"0101",
+			"0102",
+			"0103",
+			"0215",
+			"0216",
+			"0217",
+			"0218",
+			"0219",
+			"0220",
+			"0221",
+			"0222",
+			"0223",
+			"0404",
+			"0405",
+			"0406",
+			"0501",
+			"0502",
+			"0503",
+			"0504",
+			"0505",
+			"0619",
+			"0620",
+			"0621",
+			"0925",
+			"0926",
+			"0927",
+			"1001",
+			"1002",
+			"1003",
+			"1004",
+			"1005",
+			"1006",
+			"1007"
+		],
+		"ban": [
+			"0104",
+			"0214",
+			"0228",
+			"0509",
+			"0920",
+			"1010"
+		]
+	},
+	"2027": {
+		"xiu": [
+			"0101",
+			"0102",
+			"0103",
+			"0205",
+			"0206",
+			"0207",
+			"0208",
+			"0209",
+			"0210",
+			"0211",
+			"0212",
+			"0213",
+			"0403",
+			"0404",
+			"0405",
+			"0501",
+			"0502",
+			"0503",
+			"0504",
+			"0505",
+			"0609",
+			"0915",
+			"1001",
+			"1002",
+			"1003",
+			"1004",
+			"1005",
+			"1006",
+			"1007"
+		],
+		"ban": [
+			"0131",
+			"0214",
+			"0508",
+			"0926",
+			"1009"
+		]
+	}
+};
+// src/config.ts
+/**
+* 冻结并预建索引；rest 没变时复用调用方给的 restIndex，避免重复建 Set
+*/
+const createResolved = function(sFtv, lFtv, rest, restIndex) {
+	const frozenRest = freezeRestMap(rest);
+	return {
+		sFtv: freezeFestivalMap(sFtv),
+		lFtv: freezeFestivalMap(lFtv),
+		rest: frozenRest,
+		restIndex: restIndex ?? buildRestIndex(frozenRest)
+	};
+};
+/**
+* 内置数据在模块加载时就校验一遍，数据写错会立刻抛错而不是在运行时返回脏值
+*/
+const FESTIVAL_DATA = festival_default;
+const BASE = createResolved(normalizeFestivalMap(FESTIVAL_DATA.sFtv, "data/festival.json.sFtv"), normalizeFestivalMap(FESTIVAL_DATA.lFtv, "data/festival.json.lFtv", true), normalizeRestMap(rest_default, "data/rest.json"));
+const EMPTY = createResolved({}, {}, {});
+const FESTIVAL_FIELDS = ["sFtv", "lFtv"];
+const HOLIDAY_FIELDS = ["setFestival", "setRest"];
+/**
+* 校验并规范用户传入的配置，整份配置只在这里检查一次。
+*
+* 返回的片段是全新的数组 / 对象，不和入参共享引用；
+* 合并、冻结、建索引这些后续步骤都直接信任这里的结果，不再重复校验。
+*/
+const normalizeHoliday = function(config = {}, options = {}, path = "createCalendar") {
+	assertPlainObject(config, path);
+	assertKnownKeys(config, HOLIDAY_FIELDS, path);
+	assertPlainObject(options, `${path}(options)`, "第二个参数必须是对象");
+	if (options.replace !== void 0 && typeof options.replace !== "boolean") failType(`${path}(options).replace`, `必须是布尔值，收到 ${describe(options.replace)}`);
+	let sFtv;
+	let lFtv;
+	if (config.setFestival !== void 0) {
+		const festivalConfig = config.setFestival;
+		assertPlainObject(festivalConfig, `${path}.setFestival`);
+		assertKnownKeys(festivalConfig, FESTIVAL_FIELDS, `${path}.setFestival`);
+		if (festivalConfig.sFtv !== void 0) sFtv = normalizeFestivalMap(festivalConfig.sFtv, `${path}.setFestival.sFtv`);
+		if (festivalConfig.lFtv !== void 0) lFtv = normalizeFestivalMap(festivalConfig.lFtv, `${path}.setFestival.lFtv`, true);
+	}
+	return {
+		replace: options.replace === true,
+		sFtv,
+		lFtv,
+		rest: config.setRest === void 0 ? void 0 : normalizeRestMap(config.setRest, `${path}.setRest`)
+	};
+};
+/**
+* 把补丁合并到 base 上；replace 为 true 时从空配置开始。
+*
+* 补丁来自 normalizeHoliday，已经是干净数据，这里只做合并、冻结和建索引。
+*/
+const applyHoliday = function(base, patch) {
+	const from = patch.replace ? EMPTY : base;
+	if (patch.sFtv === void 0 && patch.lFtv === void 0 && patch.rest === void 0) return from;
+	return createResolved(patch.sFtv === void 0 ? from.sFtv : mergeFestivalMap(from.sFtv, patch.sFtv), patch.lFtv === void 0 ? from.lFtv : mergeFestivalMap(from.lFtv, patch.lFtv), patch.rest === void 0 ? from.rest : mergeRestMap(from.rest, patch.rest), patch.rest === void 0 ? from.restIndex : void 0);
+};
+/** 复制一份节日表，返回值可以安全修改 */
+const cloneFestivalMap = function(map) {
+	const result = {};
+	Object.keys(map).forEach(function(key) {
+		result[key] = map[key].slice();
+	});
+	return result;
+};
+/** 复制一份调休表，返回值可以安全修改 */
+const cloneRestMap = function(rest) {
+	const result = {};
+	Object.keys(rest).forEach(function(year) {
+		result[year] = {
+			xiu: rest[year].xiu.slice(),
+			ban: rest[year].ban.slice()
+		};
+	});
+	return result;
+};
+/** 把内部配置转成可再次使用的快照 */
+const snapshotOf = function(resolved) {
+	return {
+		setFestival: {
+			sFtv: cloneFestivalMap(resolved.sFtv),
+			lFtv: cloneFestivalMap(resolved.lFtv)
+		},
+		setRest: cloneRestMap(resolved.rest)
+	};
+};
+/** 只含用户传入部分的快照：own 不参与查询，不需要冻结 / 建索引 */
+const snapshotOfPatch = function(patch) {
+	return {
+		setFestival: {
+			sFtv: cloneFestivalMap(patch.sFtv ?? {}),
+			lFtv: cloneFestivalMap(patch.lFtv ?? {})
+		},
+		setRest: cloneRestMap(patch.rest ?? {})
+	};
+};
+/**
+* createCalendar 用的配置。
+*
+* 只有一份可查询的 merged；getHolidays({ merged: false }) 要的"用户传入的那部分"
+* 不参与查询，所以不另外建 ResolvedConfig，需要时直接从 patch 生成快照。
+* replace 为 true 时 merged 本身就是用户那份，两条路径共用同一份配置。
+*/
+const createCalendarConfig = function(config = {}, options = {}) {
+	const patch = normalizeHoliday(config, options);
+	const merged = applyHoliday(BASE, patch);
+	return {
+		merged,
+		snapshotOwn: patch.replace ? () => snapshotOf(merged) : () => snapshotOfPatch(patch)
+	};
+};
+// src/index.ts
+/** 支持的公历 / 农历年份范围 */
+const MIN_YEAR = 1900;
+const MAX_YEAR = 2100;
+const DAY_MS = 864e5;
+/** 农历数据起点：1900-01-31，即农历 1900 年正月初一 */
+const MIN_SOLAR_UTC = Date.UTC(MIN_YEAR, 0, 31);
+/** 支持的最后一个公历日 */
+const MAX_SOLAR_UTC = Date.UTC(MAX_YEAR, 11, 31);
+/** 把公历年月日校验成合法的、在支持范围内的日期 */
+const validateSolar = function(y, m, d) {
+	const year = assertInteger("solarToLunar(year)", y, MIN_YEAR, MAX_YEAR);
+	const month = assertInteger("solarToLunar(month)", m, 1, 12);
+	const day = assertInteger("solarToLunar(day)", d, 1, solarDays(year, month));
+	const utc = Date.UTC(year, month - 1, day);
+	if (utc < MIN_SOLAR_UTC) failRange("solarToLunar", `${year}-${month}-${day} 早于 1900-01-31，超出农历数据范围`);
+	if (utc > MAX_SOLAR_UTC) failRange("solarToLunar", `${year}-${month}-${day} 晚于 2100-12-31，超出农历数据范围`);
+	return {
+		year,
+		month,
+		day
+	};
+};
+/** 某一天的公历节日，包含按规则计算的浮动节日 */
+const solarFestivals = function(y, m, d, sFtv) {
+	const base = festivalList(sFtv, m, d);
+	const extra = [];
+	const add = function(name) {
+		if (base.indexOf(name) === -1 && extra.indexOf(name) === -1) extra.push(name);
+	};
+	if (m === 5 && d === nthWeekdayOfMonth(y, 5, 0, 2)) add("母亲节");
+	if (m === 6 && d === nthWeekdayOfMonth(y, 6, 0, 3)) add("父亲节");
+	if (m === 11 && d === nthWeekdayOfMonth(y, 11, 4, 4)) add("感恩节");
+	return extra.length === 0 ? base : Object.freeze(base.concat(extra));
+};
+/**
+* 某一天的农历节日，除夕按“腊月最后一天”计算，不写死 12-30
+*
+* 闰月不过节：闰五月初五不算端午、闰八月十五不算中秋。
+*/
+const lunarFestivals = function(lYear, lMonth, lDay, isLeap, lFtv) {
+	if (isLeap) return NO_FESTIVAL;
+	const base = festivalList(lFtv, lMonth, lDay);
+	if (lMonth === 12 && lDay === lMonthDays(lYear, 12) && base.indexOf("除夕") === -1) return Object.freeze(base.concat("除夕"));
+	return base;
+};
+/**
+* 核心换算，入参必须是已经校验过、且在支持范围内的公历日期
+*/
+const computeLunar = function(config, sy, sm, sd) {
+	const utc = Date.UTC(sy, sm - 1, sd);
+	const offset = Math.round((utc - MIN_SOLAR_UTC) / DAY_MS);
+	const { year, offsetInYear } = resolveLunarYear(offset);
+	const segments = monthSegmentsOf(year);
+	let segment = segments[0];
+	for (const item of segments) {
+		if (item.start > offsetInYear) break;
+		segment = item;
+	}
+	const month = segment.month;
+	const day = offsetInYear - segment.start + 1;
+	const isLeap = segment.isLeap;
+	const dayOfWeek = weekdayOf(sy, sm, sd);
+	const firstTermDay = getTerm(sy, sm * 2 - 1);
+	const secondTermDay = getTerm(sy, sm * 2);
+	let term = null;
+	if (firstTermDay === sd) term = getSolarTerm(sm * 2 - 2);
+	if (secondTermDay === sd) term = getSolarTerm(sm * 2 - 1);
+	const restState = restOf(config.restIndex, sy, sm, sd);
+	const isXiu = restState === "xiu";
+	const isBan = restState === "ban";
+	const gzDayOffset = utc / DAY_MS - (sd - 1) + 25567 + 10 + sd - 1;
+	const ganzhiYear = sm > 2 || sm === 2 && sd >= getTerm(sy, 3) ? sy : sy - 1;
+	return {
+		xiu: isXiu,
+		ban: isBan,
+		gljr: solarFestivals(sy, sm, sd, config.sFtv),
+		nljr: lunarFestivals(year, month, day, isLeap, config.lFtv),
+		lYear: year,
+		lMonth: month,
+		lDay: day,
+		animal: getAnimal(year),
+		lMonthCn: (isLeap ? "闰" : "") + toChinaMonth(month),
+		lDayCn: toChinaDay(day),
+		cYear: sy,
+		cMonth: sm,
+		cDay: sd,
+		gzYear: toGanZhiYear(ganzhiYear),
+		gzYearLunar: toGanZhiYear(year),
+		gzMonth: toGanZhi((sy - 1900) * 12 + sm + (sd >= firstTermDay ? 12 : 11)),
+		gzDay: toGanZhi(gzDayOffset),
+		gzHour: toHourGanZhi(gzDayOffset),
+		isToday: (function() {
+			const now = /* @__PURE__ */ new Date();
+			return now.getFullYear() === sy && now.getMonth() + 1 === sm && now.getDate() === sd;
+		})(),
+		isLeap,
+		nWeek: dayOfWeek === 0 ? 7 : dayOfWeek,
+		dayOfWeek,
+		ncWeek: "星期" + toChinaNum(dayOfWeek),
+		term,
+		astro: toAstro(sm, sd)
+	};
+};
+/** 公历转农历的内部实现，节假日配置由调用方固定 */
+const solarToLunarWith = function(config, y, m, d) {
+	if (y === void 0 && m === void 0 && d === void 0) {
+		const now = /* @__PURE__ */ new Date();
+		const today = validateSolar(now.getFullYear(), now.getMonth() + 1, now.getDate());
+		return computeLunar(config, today.year, today.month, today.day);
+	}
+	if (y === void 0 || m === void 0 || d === void 0) failRange("solarToLunar", `年、月、日必须同时传入，或全部不传以取今天（收到 year=${String(y)}, month=${String(m)}, day=${String(d)}）`);
+	const date = validateSolar(y, m, d);
+	return computeLunar(config, date.year, date.month, date.day);
+};
+/** 农历转公历的内部实现，节假日配置由调用方固定 */
+const lunarToSolarWith = function(config, y, m, d, isLeapMonth) {
+	const year = assertInteger("lunarToSolar(year)", y, MIN_YEAR, MAX_YEAR);
+	const month = assertInteger("lunarToSolar(month)", m, 1, 12);
+	if (isLeapMonth !== void 0 && typeof isLeapMonth !== "boolean") throw failType("lunarToSolar(isLeapMonth)", `必须是布尔值，收到 ${describe(isLeapMonth)}`);
+	const leap = leapMonth(year);
+	const wantLeap = isLeapMonth === true;
+	if (wantLeap && leap !== month) failRange("lunarToSolar(isLeapMonth)", `${year} 年${leap === 0 ? "没有闰月" : `的闰月是闰${leap}月`}，不能按闰${month}月换算`);
+	const maxDay = wantLeap ? leapDays(year) : lMonthDays(year, month);
+	const day = assertInteger("lunarToSolar(day)", d, 1, maxDay);
+	const segment = monthSegmentsOf(year).find((item) => item.month === month && item.isLeap === wantLeap);
+	if (!segment) return failRange("lunarToSolar", `${year} 年${wantLeap ? "闰" : ""}${month}月不存在`);
+	const offset = yearStartOf(year) + segment.start;
+	const utc = MIN_SOLAR_UTC + (offset + day - 1) * DAY_MS;
+	if (utc > MAX_SOLAR_UTC) failRange("lunarToSolar", `农历 ${year}-${month}-${day} 换算后晚于 2100-12-31，超出支持范围`);
+	const date = new Date(utc);
+	return computeLunar(config, date.getUTCFullYear(), date.getUTCMonth() + 1, date.getUTCDate());
+};
+/**
+* 创建固定节假日配置的日历实例
+*
+* 不读取也不修改任何全局状态；配置在创建时校验并冻结，
+* 多个实例之间互不影响。不传配置时使用内置数据。
+*
+* @param config 节假日 / 调休配置
+* @param options replace 为 true 时忽略内置数据
+* @throws TypeError 配置格式不合法（含具体字段路径）
+* @example
+* const cc = createCalendar({ setRest: { 2027: { xiu: ["0101"] } } });
+* cc.solarToLunar(2027, 1, 1).xiu; // true
+*/
+const createCalendar = function(config = {}, options = {}) {
+	const { merged, snapshotOwn } = createCalendarConfig(config, options);
+	return {
+		/** 公历转农历，不传参返回今天 */
+		solarToLunar: (y, m, d) => solarToLunarWith(merged, y, m, d),
+		/** 农历转公历 */
+		lunarToSolar: (y, m, d, isLeapMonth) => lunarToSolarWith(merged, y, m, d, isLeapMonth),
+		/** 当前配置的深拷贝；merged 为 false 时只导出用户传入的部分 */
+		getHolidays: (getOptions) => {
+			if (getOptions !== void 0) assertPlainObject(getOptions, "getHolidays(options)");
+			if (getOptions?.merged !== void 0 && typeof getOptions.merged !== "boolean") throw failType("getHolidays(options).merged", `必须是布尔值，收到 ${describe(getOptions.merged)}`);
+			return getOptions?.merged === false ? snapshotOwn() : snapshotOf(merged);
+		}
+	};
+};
+const utils = {
+	lYearDays,
+	leapMonth,
+	leapDays,
+	lMonthDays,
+	toChinaMonth,
+	toChinaDay,
+	toChinaNum,
+	solarDays,
+	solarFirstWeek,
+	nthWeekdayOfMonth,
+	toAstro,
+	getAnimal,
+	getTerm,
+	getSolarTerm,
+	toGanZhi,
+	toGanZhiYear,
+	toHourGanZhi
+};
+exports.createCalendar = createCalendar;
+exports.default = createCalendar;
+exports.utils = utils;