@qingwu-ui/holiday-data 0.0.0-stage → 1.1.0

package/dist/index.d.cts

@@ -0,0 +1,63 @@
+//#region src/schema.d.ts
+/** 数据协议独立于运行时与农历算法；calendar/core 构建时内联本文件。 */
+interface DataSource {
+  title: string;
+  publisher: string;
+  url: string;
+  accessedAt: string;
+}
+interface HolidayDay {
+  date: string;
+  name: string;
+  isOffDay: boolean;
+}
+interface HolidayYear {
+  schemaVersion: 1;
+  year: number;
+  updatedAt: string;
+  sources: DataSource[];
+  days: HolidayDay[];
+  /** 非空时表示仅部分收录；未列出的日期不能据此认定为工作日。 */
+  missingHolidays?: string[];
+}
+interface SourcedText {
+  text: string;
+  sources: DataSource[];
+}
+interface FestivalRecord {
+  id: string;
+  name: string;
+  rule: {
+    calendar: "lunar" | "solar" | "solar-term" | "lunar-eve";
+    month?: number;
+    day?: number;
+    term?: string;
+  };
+  description: SourcedText;
+  origin: SourcedText;
+  customs: SourcedText;
+}
+interface HolidayData {
+  schemaVersion: 1;
+  updatedAt: string;
+  years: HolidayYear[];
+  festivals: FestivalRecord[];
+  coverage?: {
+    startYear: number;
+    endYear: number;
+    missingYears: number[];
+  };
+}
+declare function isISODate(value: unknown): value is string;
+declare function validateHolidayYear(value: unknown): asserts value is HolidayYear;
+declare function validateHolidayData(value: unknown): asserts value is HolidayData;
+/** 接受 JSON.parse 后的对象，也接受年度文件；年度输入不会替换其他年份。 */
+declare function parseHolidayData(value: unknown): HolidayData;
+declare function mergeHolidayData(base: HolidayData, custom: HolidayData | HolidayYear): HolidayData;
+//#endregion
+//#region src/index.d.ts
+declare const holidayData: HolidayData;
+declare function getHolidayYear(year: number): HolidayYear | null;
+//#endregion
+export { DataSource, FestivalRecord, HolidayData, HolidayDay, HolidayYear, SourcedText, getHolidayYear, holidayData, isISODate, mergeHolidayData, parseHolidayData, validateHolidayData, validateHolidayYear };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/schema.ts","../src/index.ts"],"mappings":";;UACiB;EACf;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA,SAAS;EACT,MAAM;;EAEN;;UAGe;EACf;EACA,SAAS;;UAGM;EACf;EACA;EACA;IACE;IACA;IACA;IACA;;EAEF,aAAa;EACb,QAAQ;EACR,SAAS;;UAGM;EACf;EACA;EACA,OAAO;EACP,WAAW;EACX;IAAa;IAAmB;IAAiB;;;iBAGnC,UAAU,iBAAiB;iBAwC3B,oBAAoB,yBAAyB,SAAS;iBAmCtD,oBAAoB,yBAAyB,SAAS;;iBAmEtD,iBAAiB,iBAAiB;iBASlC,iBACd,MAAM,aACN,QAAQ,cAAc,cACrB;;;cCzMU,aAAA;iBACG,eAAe,eAAf"}

package/dist/index.d.mts

@@ -0,0 +1,63 @@
+//#region src/schema.d.ts
+/** 数据协议独立于运行时与农历算法；calendar/core 构建时内联本文件。 */
+interface DataSource {
+  title: string;
+  publisher: string;
+  url: string;
+  accessedAt: string;
+}
+interface HolidayDay {
+  date: string;
+  name: string;
+  isOffDay: boolean;
+}
+interface HolidayYear {
+  schemaVersion: 1;
+  year: number;
+  updatedAt: string;
+  sources: DataSource[];
+  days: HolidayDay[];
+  /** 非空时表示仅部分收录；未列出的日期不能据此认定为工作日。 */
+  missingHolidays?: string[];
+}
+interface SourcedText {
+  text: string;
+  sources: DataSource[];
+}
+interface FestivalRecord {
+  id: string;
+  name: string;
+  rule: {
+    calendar: "lunar" | "solar" | "solar-term" | "lunar-eve";
+    month?: number;
+    day?: number;
+    term?: string;
+  };
+  description: SourcedText;
+  origin: SourcedText;
+  customs: SourcedText;
+}
+interface HolidayData {
+  schemaVersion: 1;
+  updatedAt: string;
+  years: HolidayYear[];
+  festivals: FestivalRecord[];
+  coverage?: {
+    startYear: number;
+    endYear: number;
+    missingYears: number[];
+  };
+}
+declare function isISODate(value: unknown): value is string;
+declare function validateHolidayYear(value: unknown): asserts value is HolidayYear;
+declare function validateHolidayData(value: unknown): asserts value is HolidayData;
+/** 接受 JSON.parse 后的对象，也接受年度文件；年度输入不会替换其他年份。 */
+declare function parseHolidayData(value: unknown): HolidayData;
+declare function mergeHolidayData(base: HolidayData, custom: HolidayData | HolidayYear): HolidayData;
+//#endregion
+//#region src/index.d.ts
+declare const holidayData: HolidayData;
+declare function getHolidayYear(year: number): HolidayYear | null;
+//#endregion
+export { DataSource, FestivalRecord, HolidayData, HolidayDay, HolidayYear, SourcedText, getHolidayYear, holidayData, isISODate, mergeHolidayData, parseHolidayData, validateHolidayData, validateHolidayYear };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/schema.ts","../src/index.ts"],"mappings":";;UACiB;EACf;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA,SAAS;EACT,MAAM;;EAEN;;UAGe;EACf;EACA,SAAS;;UAGM;EACf;EACA;EACA;IACE;IACA;IACA;IACA;;EAEF,aAAa;EACb,QAAQ;EACR,SAAS;;UAGM;EACf;EACA;EACA,OAAO;EACP,WAAW;EACX;IAAa;IAAmB;IAAiB;;;iBAGnC,UAAU,iBAAiB;iBAwC3B,oBAAoB,yBAAyB,SAAS;iBAmCtD,oBAAoB,yBAAyB,SAAS;;iBAmEtD,iBAAiB,iBAAiB;iBASlC,iBACd,MAAM,aACN,QAAQ,cAAc,cACrB;;;cCzMU,aAAA;iBACG,eAAe,eAAf"}