@catlabtech/mycal-core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,803 @@
+import { z } from 'zod';
+
+interface LocalizedString {
+    readonly ms: string;
+    readonly en: string;
+    readonly zh?: string;
+}
+type HolidayType = "federal" | "state" | "islamic" | "islamic_state" | "replacement" | "adhoc";
+type HolidayStatus = "confirmed" | "tentative" | "announced" | "cancelled";
+type GazetteLevel = "P" | "N";
+type HolidaySource = "jpm" | "jakim" | "state-gov" | "community" | "admin";
+interface Holiday {
+    readonly id: string;
+    readonly date: string;
+    readonly endDate?: string;
+    readonly name: LocalizedString;
+    readonly type: HolidayType;
+    readonly status: HolidayStatus;
+    readonly states: readonly string[];
+    readonly isPublicHoliday: boolean;
+    readonly gazetteLevel: GazetteLevel;
+    readonly isReplacementFor?: string;
+    readonly hijriDate?: string;
+    readonly gazetteRef?: string;
+    readonly source: HolidaySource;
+    readonly confirmedAt?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+type StateGroup = "A" | "B";
+interface WeekendConfig {
+    readonly from: string;
+    readonly to: string | null;
+    readonly weekendDays: readonly number[];
+    readonly group: StateGroup;
+}
+type StateType = "state" | "federal_territory";
+interface State {
+    readonly code: string;
+    readonly aliases: readonly string[];
+    readonly name: LocalizedString;
+    readonly type: StateType;
+    readonly weekendHistory: readonly WeekendConfig[];
+    readonly group: StateGroup;
+}
+interface SchoolTermSegment {
+    readonly startDate: string;
+    readonly endDate: string;
+    readonly schoolDays: number;
+}
+interface SchoolTerm {
+    readonly id: string;
+    readonly year: number;
+    readonly term: 1 | 2;
+    readonly group: StateGroup;
+    readonly segments: readonly SchoolTermSegment[];
+    readonly totalSchoolDays: number;
+    readonly startDate: string;
+    readonly endDate: string;
+}
+type SchoolHolidayType = "cuti_penggal_1" | "cuti_pertengahan" | "cuti_penggal_2" | "cuti_akhir" | "cuti_perayaan_kpm";
+interface SchoolHoliday {
+    readonly id: string;
+    readonly year: number;
+    readonly group: StateGroup;
+    readonly type: SchoolHolidayType;
+    readonly name: LocalizedString;
+    readonly startDate: string;
+    readonly endDate: string;
+    readonly days: number;
+    readonly states?: readonly string[];
+    readonly excludeStates?: readonly string[];
+    readonly remarks?: string;
+}
+type ExamType = "spm" | "stpm" | "muet" | "pt3" | "stam" | "other";
+type ExamSource = "kpm" | "mpm";
+interface Exam {
+    readonly id: string;
+    readonly year: number;
+    readonly name: string;
+    readonly fullName: LocalizedString;
+    readonly type: ExamType;
+    readonly startDate: string;
+    readonly endDate?: string;
+    readonly status: "confirmed" | "tentative";
+    readonly resultsDate?: string;
+    readonly source: ExamSource;
+}
+interface CheckDateResult {
+    readonly date: string;
+    readonly dayOfWeek: string;
+    readonly isHoliday: boolean;
+    readonly isWeekend: boolean;
+    readonly isWorkingDay: boolean;
+    readonly isSchoolDay: boolean;
+    readonly holidays: readonly Holiday[];
+    readonly school: {
+        readonly group: StateGroup;
+        readonly term: SchoolTerm | null;
+        readonly holiday: SchoolHoliday | null;
+    } | null;
+    readonly state: {
+        readonly code: string;
+        readonly weekendDays: readonly string[];
+        readonly group: StateGroup;
+    };
+}
+interface BusinessDaysResult {
+    readonly totalDays: number;
+    readonly businessDays: number;
+    readonly holidays: number;
+    readonly weekendDays: number;
+    readonly holidayList: readonly Holiday[];
+}
+interface LongWeekend {
+    readonly startDate: string;
+    readonly endDate: string;
+    readonly totalDays: number;
+    readonly holidays: readonly Holiday[];
+    readonly weekendDays: number;
+    readonly bridgeDaysNeeded: number;
+}
+interface ChangelogEntry {
+    readonly timestamp: string;
+    readonly event: string;
+    readonly holidayId?: string;
+    readonly examId?: string;
+    readonly description: string;
+    readonly changes?: Record<string, {
+        from: unknown;
+        to: unknown;
+    }>;
+}
+
+declare const holidaySchema: z.ZodObject<{
+    id: z.ZodString;
+    date: z.ZodString;
+    endDate: z.ZodOptional<z.ZodString>;
+    name: z.ZodObject<{
+        ms: z.ZodString;
+        en: z.ZodString;
+        zh: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    }, {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    }>;
+    type: z.ZodEnum<["federal", "state", "islamic", "islamic_state", "replacement", "adhoc"]>;
+    status: z.ZodEnum<["confirmed", "tentative", "announced", "cancelled"]>;
+    states: z.ZodArray<z.ZodString, "many">;
+    isPublicHoliday: z.ZodBoolean;
+    gazetteLevel: z.ZodEnum<["P", "N"]>;
+    isReplacementFor: z.ZodOptional<z.ZodString>;
+    hijriDate: z.ZodOptional<z.ZodString>;
+    gazetteRef: z.ZodOptional<z.ZodString>;
+    source: z.ZodEnum<["jpm", "jakim", "state-gov", "community", "admin"]>;
+    confirmedAt: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "federal" | "state" | "islamic" | "islamic_state" | "replacement" | "adhoc";
+    status: "confirmed" | "tentative" | "announced" | "cancelled";
+    id: string;
+    date: string;
+    name: {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    };
+    states: string[];
+    isPublicHoliday: boolean;
+    gazetteLevel: "P" | "N";
+    source: "jpm" | "jakim" | "state-gov" | "community" | "admin";
+    createdAt: string;
+    updatedAt: string;
+    endDate?: string | undefined;
+    isReplacementFor?: string | undefined;
+    hijriDate?: string | undefined;
+    gazetteRef?: string | undefined;
+    confirmedAt?: string | undefined;
+}, {
+    type: "federal" | "state" | "islamic" | "islamic_state" | "replacement" | "adhoc";
+    status: "confirmed" | "tentative" | "announced" | "cancelled";
+    id: string;
+    date: string;
+    name: {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    };
+    states: string[];
+    isPublicHoliday: boolean;
+    gazetteLevel: "P" | "N";
+    source: "jpm" | "jakim" | "state-gov" | "community" | "admin";
+    createdAt: string;
+    updatedAt: string;
+    endDate?: string | undefined;
+    isReplacementFor?: string | undefined;
+    hijriDate?: string | undefined;
+    gazetteRef?: string | undefined;
+    confirmedAt?: string | undefined;
+}>;
+declare const holidayFileSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    date: z.ZodString;
+    endDate: z.ZodOptional<z.ZodString>;
+    name: z.ZodObject<{
+        ms: z.ZodString;
+        en: z.ZodString;
+        zh: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    }, {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    }>;
+    type: z.ZodEnum<["federal", "state", "islamic", "islamic_state", "replacement", "adhoc"]>;
+    status: z.ZodEnum<["confirmed", "tentative", "announced", "cancelled"]>;
+    states: z.ZodArray<z.ZodString, "many">;
+    isPublicHoliday: z.ZodBoolean;
+    gazetteLevel: z.ZodEnum<["P", "N"]>;
+    isReplacementFor: z.ZodOptional<z.ZodString>;
+    hijriDate: z.ZodOptional<z.ZodString>;
+    gazetteRef: z.ZodOptional<z.ZodString>;
+    source: z.ZodEnum<["jpm", "jakim", "state-gov", "community", "admin"]>;
+    confirmedAt: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "federal" | "state" | "islamic" | "islamic_state" | "replacement" | "adhoc";
+    status: "confirmed" | "tentative" | "announced" | "cancelled";
+    id: string;
+    date: string;
+    name: {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    };
+    states: string[];
+    isPublicHoliday: boolean;
+    gazetteLevel: "P" | "N";
+    source: "jpm" | "jakim" | "state-gov" | "community" | "admin";
+    createdAt: string;
+    updatedAt: string;
+    endDate?: string | undefined;
+    isReplacementFor?: string | undefined;
+    hijriDate?: string | undefined;
+    gazetteRef?: string | undefined;
+    confirmedAt?: string | undefined;
+}, {
+    type: "federal" | "state" | "islamic" | "islamic_state" | "replacement" | "adhoc";
+    status: "confirmed" | "tentative" | "announced" | "cancelled";
+    id: string;
+    date: string;
+    name: {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    };
+    states: string[];
+    isPublicHoliday: boolean;
+    gazetteLevel: "P" | "N";
+    source: "jpm" | "jakim" | "state-gov" | "community" | "admin";
+    createdAt: string;
+    updatedAt: string;
+    endDate?: string | undefined;
+    isReplacementFor?: string | undefined;
+    hijriDate?: string | undefined;
+    gazetteRef?: string | undefined;
+    confirmedAt?: string | undefined;
+}>, "many">;
+declare const stateSchema: z.ZodObject<{
+    code: z.ZodString;
+    aliases: z.ZodArray<z.ZodString, "many">;
+    name: z.ZodObject<{
+        ms: z.ZodString;
+        en: z.ZodString;
+        zh: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    }, {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    }>;
+    type: z.ZodEnum<["state", "federal_territory"]>;
+    weekendHistory: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodNullable<z.ZodString>;
+        weekendDays: z.ZodArray<z.ZodNumber, "many">;
+        group: z.ZodEnum<["A", "B"]>;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string | null;
+        weekendDays: number[];
+        group: "A" | "B";
+    }, {
+        from: string;
+        to: string | null;
+        weekendDays: number[];
+        group: "A" | "B";
+    }>, "many">;
+    group: z.ZodEnum<["A", "B"]>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    type: "state" | "federal_territory";
+    name: {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    };
+    group: "A" | "B";
+    aliases: string[];
+    weekendHistory: {
+        from: string;
+        to: string | null;
+        weekendDays: number[];
+        group: "A" | "B";
+    }[];
+}, {
+    code: string;
+    type: "state" | "federal_territory";
+    name: {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    };
+    group: "A" | "B";
+    aliases: string[];
+    weekendHistory: {
+        from: string;
+        to: string | null;
+        weekendDays: number[];
+        group: "A" | "B";
+    }[];
+}>;
+declare const statesFileSchema: z.ZodArray<z.ZodObject<{
+    code: z.ZodString;
+    aliases: z.ZodArray<z.ZodString, "many">;
+    name: z.ZodObject<{
+        ms: z.ZodString;
+        en: z.ZodString;
+        zh: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    }, {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    }>;
+    type: z.ZodEnum<["state", "federal_territory"]>;
+    weekendHistory: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodNullable<z.ZodString>;
+        weekendDays: z.ZodArray<z.ZodNumber, "many">;
+        group: z.ZodEnum<["A", "B"]>;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string | null;
+        weekendDays: number[];
+        group: "A" | "B";
+    }, {
+        from: string;
+        to: string | null;
+        weekendDays: number[];
+        group: "A" | "B";
+    }>, "many">;
+    group: z.ZodEnum<["A", "B"]>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    type: "state" | "federal_territory";
+    name: {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    };
+    group: "A" | "B";
+    aliases: string[];
+    weekendHistory: {
+        from: string;
+        to: string | null;
+        weekendDays: number[];
+        group: "A" | "B";
+    }[];
+}, {
+    code: string;
+    type: "state" | "federal_territory";
+    name: {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    };
+    group: "A" | "B";
+    aliases: string[];
+    weekendHistory: {
+        from: string;
+        to: string | null;
+        weekendDays: number[];
+        group: "A" | "B";
+    }[];
+}>, "many">;
+declare const schoolTermSchema: z.ZodObject<{
+    id: z.ZodString;
+    year: z.ZodNumber;
+    term: z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>]>;
+    group: z.ZodEnum<["A", "B"]>;
+    segments: z.ZodArray<z.ZodObject<{
+        startDate: z.ZodString;
+        endDate: z.ZodString;
+        schoolDays: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        endDate: string;
+        startDate: string;
+        schoolDays: number;
+    }, {
+        endDate: string;
+        startDate: string;
+        schoolDays: number;
+    }>, "many">;
+    totalSchoolDays: z.ZodNumber;
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    endDate: string;
+    group: "A" | "B";
+    startDate: string;
+    year: number;
+    term: 1 | 2;
+    segments: {
+        endDate: string;
+        startDate: string;
+        schoolDays: number;
+    }[];
+    totalSchoolDays: number;
+}, {
+    id: string;
+    endDate: string;
+    group: "A" | "B";
+    startDate: string;
+    year: number;
+    term: 1 | 2;
+    segments: {
+        endDate: string;
+        startDate: string;
+        schoolDays: number;
+    }[];
+    totalSchoolDays: number;
+}>;
+declare const schoolHolidaySchema: z.ZodObject<{
+    id: z.ZodString;
+    year: z.ZodNumber;
+    group: z.ZodEnum<["A", "B"]>;
+    type: z.ZodEnum<["cuti_penggal_1", "cuti_pertengahan", "cuti_penggal_2", "cuti_akhir", "cuti_perayaan_kpm"]>;
+    name: z.ZodObject<{
+        ms: z.ZodString;
+        en: z.ZodString;
+        zh: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    }, {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    }>;
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+    days: z.ZodNumber;
+    states: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    excludeStates: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    remarks: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "cuti_penggal_1" | "cuti_pertengahan" | "cuti_penggal_2" | "cuti_akhir" | "cuti_perayaan_kpm";
+    id: string;
+    endDate: string;
+    name: {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    };
+    group: "A" | "B";
+    startDate: string;
+    year: number;
+    days: number;
+    states?: string[] | undefined;
+    excludeStates?: string[] | undefined;
+    remarks?: string | undefined;
+}, {
+    type: "cuti_penggal_1" | "cuti_pertengahan" | "cuti_penggal_2" | "cuti_akhir" | "cuti_perayaan_kpm";
+    id: string;
+    endDate: string;
+    name: {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    };
+    group: "A" | "B";
+    startDate: string;
+    year: number;
+    days: number;
+    states?: string[] | undefined;
+    excludeStates?: string[] | undefined;
+    remarks?: string | undefined;
+}>;
+declare const schoolTermsFileSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    year: z.ZodNumber;
+    term: z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>]>;
+    group: z.ZodEnum<["A", "B"]>;
+    segments: z.ZodArray<z.ZodObject<{
+        startDate: z.ZodString;
+        endDate: z.ZodString;
+        schoolDays: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        endDate: string;
+        startDate: string;
+        schoolDays: number;
+    }, {
+        endDate: string;
+        startDate: string;
+        schoolDays: number;
+    }>, "many">;
+    totalSchoolDays: z.ZodNumber;
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    endDate: string;
+    group: "A" | "B";
+    startDate: string;
+    year: number;
+    term: 1 | 2;
+    segments: {
+        endDate: string;
+        startDate: string;
+        schoolDays: number;
+    }[];
+    totalSchoolDays: number;
+}, {
+    id: string;
+    endDate: string;
+    group: "A" | "B";
+    startDate: string;
+    year: number;
+    term: 1 | 2;
+    segments: {
+        endDate: string;
+        startDate: string;
+        schoolDays: number;
+    }[];
+    totalSchoolDays: number;
+}>, "many">;
+declare const schoolHolidaysFileSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    year: z.ZodNumber;
+    group: z.ZodEnum<["A", "B"]>;
+    type: z.ZodEnum<["cuti_penggal_1", "cuti_pertengahan", "cuti_penggal_2", "cuti_akhir", "cuti_perayaan_kpm"]>;
+    name: z.ZodObject<{
+        ms: z.ZodString;
+        en: z.ZodString;
+        zh: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    }, {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    }>;
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+    days: z.ZodNumber;
+    states: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    excludeStates: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    remarks: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "cuti_penggal_1" | "cuti_pertengahan" | "cuti_penggal_2" | "cuti_akhir" | "cuti_perayaan_kpm";
+    id: string;
+    endDate: string;
+    name: {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    };
+    group: "A" | "B";
+    startDate: string;
+    year: number;
+    days: number;
+    states?: string[] | undefined;
+    excludeStates?: string[] | undefined;
+    remarks?: string | undefined;
+}, {
+    type: "cuti_penggal_1" | "cuti_pertengahan" | "cuti_penggal_2" | "cuti_akhir" | "cuti_perayaan_kpm";
+    id: string;
+    endDate: string;
+    name: {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    };
+    group: "A" | "B";
+    startDate: string;
+    year: number;
+    days: number;
+    states?: string[] | undefined;
+    excludeStates?: string[] | undefined;
+    remarks?: string | undefined;
+}>, "many">;
+declare const examSchema: z.ZodObject<{
+    id: z.ZodString;
+    year: z.ZodNumber;
+    name: z.ZodString;
+    fullName: z.ZodObject<{
+        ms: z.ZodString;
+        en: z.ZodString;
+        zh: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    }, {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    }>;
+    type: z.ZodEnum<["spm", "stpm", "muet", "pt3", "stam", "other"]>;
+    startDate: z.ZodString;
+    endDate: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["confirmed", "tentative"]>;
+    resultsDate: z.ZodOptional<z.ZodString>;
+    source: z.ZodEnum<["kpm", "mpm"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "spm" | "stpm" | "muet" | "pt3" | "stam" | "other";
+    status: "confirmed" | "tentative";
+    id: string;
+    name: string;
+    source: "kpm" | "mpm";
+    startDate: string;
+    year: number;
+    fullName: {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    };
+    endDate?: string | undefined;
+    resultsDate?: string | undefined;
+}, {
+    type: "spm" | "stpm" | "muet" | "pt3" | "stam" | "other";
+    status: "confirmed" | "tentative";
+    id: string;
+    name: string;
+    source: "kpm" | "mpm";
+    startDate: string;
+    year: number;
+    fullName: {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    };
+    endDate?: string | undefined;
+    resultsDate?: string | undefined;
+}>;
+declare const examsFileSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    year: z.ZodNumber;
+    name: z.ZodString;
+    fullName: z.ZodObject<{
+        ms: z.ZodString;
+        en: z.ZodString;
+        zh: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    }, {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    }>;
+    type: z.ZodEnum<["spm", "stpm", "muet", "pt3", "stam", "other"]>;
+    startDate: z.ZodString;
+    endDate: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["confirmed", "tentative"]>;
+    resultsDate: z.ZodOptional<z.ZodString>;
+    source: z.ZodEnum<["kpm", "mpm"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "spm" | "stpm" | "muet" | "pt3" | "stam" | "other";
+    status: "confirmed" | "tentative";
+    id: string;
+    name: string;
+    source: "kpm" | "mpm";
+    startDate: string;
+    year: number;
+    fullName: {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    };
+    endDate?: string | undefined;
+    resultsDate?: string | undefined;
+}, {
+    type: "spm" | "stpm" | "muet" | "pt3" | "stam" | "other";
+    status: "confirmed" | "tentative";
+    id: string;
+    name: string;
+    source: "kpm" | "mpm";
+    startDate: string;
+    year: number;
+    fullName: {
+        ms: string;
+        en: string;
+        zh?: string | undefined;
+    };
+    endDate?: string | undefined;
+    resultsDate?: string | undefined;
+}>, "many">;
+
+declare function resolveStateCode(query: string, states: readonly State[]): State | null;
+declare function getStateByCode(code: string, states: readonly State[]): State | null;
+declare function getStatesByGroup(group: "A" | "B", states: readonly State[]): readonly State[];
+
+declare function getWeekendConfig(state: State, date: string): WeekendConfig;
+declare function isWeekend(date: string, state: State): boolean;
+declare function getDayOfWeekName(date: string): string;
+declare function getWeekendDayNames(state: State, date: string): readonly string[];
+declare function addDays(date: string, days: number): string;
+declare function nextWorkingDay(date: string, state: State, holidayDates: ReadonlySet<string>): string;
+declare function diffDays(start: string, end: string): number;
+
+interface HolidayFilter {
+    readonly year?: number;
+    readonly month?: number;
+    readonly state?: string;
+    readonly type?: HolidayType;
+    readonly status?: HolidayStatus;
+}
+declare function filterHolidays(holidays: readonly Holiday[], filter: HolidayFilter): readonly Holiday[];
+declare function findHolidaysByDate(date: string, holidays: readonly Holiday[], stateCode?: string): readonly Holiday[];
+declare function findNextHoliday(afterDate: string, holidays: readonly Holiday[], stateCode?: string, type?: HolidayType, limit?: number): readonly Holiday[];
+
+declare function calculateReplacementHolidays(holidays: readonly Holiday[], state: State): readonly Holiday[];
+
+declare function countBusinessDays(start: string, end: string, state: State, holidays: readonly Holiday[]): BusinessDaysResult;
+declare function addBusinessDays(startDate: string, daysToAdd: number, state: State, holidays: readonly Holiday[]): string;
+
+declare function findSchoolTermByDate(date: string, terms: readonly SchoolTerm[], group: StateGroup): SchoolTerm | null;
+declare function findSchoolHolidayByDate(date: string, holidays: readonly SchoolHoliday[], group: StateGroup, stateCode?: string): SchoolHoliday | null;
+declare function isSchoolDay(date: string, terms: readonly SchoolTerm[], schoolHolidays: readonly SchoolHoliday[], group: StateGroup, isPublicHoliday: boolean, isWeekendDay: boolean, stateCode?: string): boolean;
+
+declare function generateIcal(holidays: readonly Holiday[], schoolHolidays: readonly SchoolHoliday[], calendarName: string): string;
+
+/**
+ * Basic Hijri date utilities.
+ *
+ * Note: Hijri dates for Islamic holidays are approximate until confirmed
+ * by JAKIM rukyah (moon sighting). This module provides reference mapping
+ * only — actual dates should come from the gazette/JAKIM confirmation.
+ */
+interface HijriMonth {
+    readonly number: number;
+    readonly nameMs: string;
+    readonly nameEn: string;
+    readonly nameAr: string;
+}
+declare const HIJRI_MONTHS: readonly HijriMonth[];
+/**
+ * Parse a hijri date string like "1 Syawal 1447" → { day, month, year }
+ */
+declare function parseHijriDate(hijriStr: string): {
+    day: number;
+    month: HijriMonth;
+    year: number;
+} | null;
+/**
+ * Format a hijri date for display: "1 Syawal 1447"
+ */
+declare function formatHijriDate(day: number, monthNumber: number, year: number): string;
+/**
+ * Key Islamic holidays and their Hijri dates (fixed in the Islamic calendar).
+ * Gregorian dates shift ~11 days earlier each year.
+ */
+declare const ISLAMIC_HOLIDAY_DATES: readonly {
+    readonly nameMs: string;
+    readonly nameEn: string;
+    readonly hijriMonth: number;
+    readonly hijriDay: number;
+}[];
+
+export { type BusinessDaysResult, type ChangelogEntry, type CheckDateResult, type Exam, type ExamSource, type ExamType, type GazetteLevel, HIJRI_MONTHS, type HijriMonth, type Holiday, type HolidayFilter, type HolidaySource, type HolidayStatus, type HolidayType, ISLAMIC_HOLIDAY_DATES, type LocalizedString, type LongWeekend, type SchoolHoliday, type SchoolHolidayType, type SchoolTerm, type SchoolTermSegment, type State, type StateGroup, type StateType, type WeekendConfig, addBusinessDays, addDays, calculateReplacementHolidays, countBusinessDays, diffDays, examSchema, examsFileSchema, filterHolidays, findHolidaysByDate, findNextHoliday, findSchoolHolidayByDate, findSchoolTermByDate, formatHijriDate, generateIcal, getDayOfWeekName, getStateByCode, getStatesByGroup, getWeekendConfig, getWeekendDayNames, holidayFileSchema, holidaySchema, isSchoolDay, isWeekend, nextWorkingDay, parseHijriDate, resolveStateCode, schoolHolidaySchema, schoolHolidaysFileSchema, schoolTermSchema, schoolTermsFileSchema, stateSchema, statesFileSchema };

package/dist/index.js

@@ -0,0 +1,517 @@
+// src/schemas.ts
+import { z } from "zod";
+var isoDate = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Must be ISO 8601 date (YYYY-MM-DD)");
+var localizedString = z.object({
+  ms: z.string().min(1),
+  en: z.string().min(1),
+  zh: z.string().optional()
+});
+var holidayTypeSchema = z.enum([
+  "federal",
+  "state",
+  "islamic",
+  "islamic_state",
+  "replacement",
+  "adhoc"
+]);
+var holidayStatusSchema = z.enum([
+  "confirmed",
+  "tentative",
+  "announced",
+  "cancelled"
+]);
+var gazetteLevelSchema = z.enum(["P", "N"]);
+var holidaySourceSchema = z.enum([
+  "jpm",
+  "jakim",
+  "state-gov",
+  "community",
+  "admin"
+]);
+var holidaySchema = z.object({
+  id: z.string().min(1),
+  date: isoDate,
+  endDate: isoDate.optional(),
+  name: localizedString,
+  type: holidayTypeSchema,
+  status: holidayStatusSchema,
+  states: z.array(z.string().min(1)).min(1),
+  isPublicHoliday: z.boolean(),
+  gazetteLevel: gazetteLevelSchema,
+  isReplacementFor: z.string().optional(),
+  hijriDate: z.string().optional(),
+  gazetteRef: z.string().optional(),
+  source: holidaySourceSchema,
+  confirmedAt: z.string().optional(),
+  createdAt: z.string(),
+  updatedAt: z.string()
+});
+var holidayFileSchema = z.array(holidaySchema);
+var stateGroupSchema = z.enum(["A", "B"]);
+var weekendConfigSchema = z.object({
+  from: isoDate,
+  to: isoDate.nullable(),
+  weekendDays: z.array(z.number().int().min(0).max(6)),
+  group: stateGroupSchema
+});
+var stateSchema = z.object({
+  code: z.string().min(1),
+  aliases: z.array(z.string()),
+  name: localizedString,
+  type: z.enum(["state", "federal_territory"]),
+  weekendHistory: z.array(weekendConfigSchema).min(1),
+  group: stateGroupSchema
+});
+var statesFileSchema = z.array(stateSchema);
+var schoolTermSegmentSchema = z.object({
+  startDate: isoDate,
+  endDate: isoDate,
+  schoolDays: z.number().int().min(0)
+});
+var schoolTermSchema = z.object({
+  id: z.string().min(1),
+  year: z.number().int().min(2020).max(2100),
+  term: z.union([z.literal(1), z.literal(2)]),
+  group: stateGroupSchema,
+  segments: z.array(schoolTermSegmentSchema).min(1),
+  totalSchoolDays: z.number().int().min(0),
+  startDate: isoDate,
+  endDate: isoDate
+});
+var schoolHolidayTypeSchema = z.enum([
+  "cuti_penggal_1",
+  "cuti_pertengahan",
+  "cuti_penggal_2",
+  "cuti_akhir",
+  "cuti_perayaan_kpm"
+]);
+var schoolHolidaySchema = z.object({
+  id: z.string().min(1),
+  year: z.number().int().min(2020).max(2100),
+  group: stateGroupSchema,
+  type: schoolHolidayTypeSchema,
+  name: localizedString,
+  startDate: isoDate,
+  endDate: isoDate,
+  days: z.number().int().min(1),
+  states: z.array(z.string()).optional(),
+  excludeStates: z.array(z.string()).optional(),
+  remarks: z.string().optional()
+});
+var schoolTermsFileSchema = z.array(schoolTermSchema);
+var schoolHolidaysFileSchema = z.array(schoolHolidaySchema);
+var examTypeSchema = z.enum([
+  "spm",
+  "stpm",
+  "muet",
+  "pt3",
+  "stam",
+  "other"
+]);
+var examSchema = z.object({
+  id: z.string().min(1),
+  year: z.number().int().min(2020).max(2100),
+  name: z.string().min(1),
+  fullName: localizedString,
+  type: examTypeSchema,
+  startDate: isoDate,
+  endDate: isoDate.optional(),
+  status: z.enum(["confirmed", "tentative"]),
+  resultsDate: isoDate.optional(),
+  source: z.enum(["kpm", "mpm"])
+});
+var examsFileSchema = z.array(examSchema);
+
+// src/state-resolver.ts
+function resolveStateCode(query, states) {
+  const normalized = query.toLowerCase().trim();
+  for (const state of states) {
+    if (state.code === normalized) return state;
+    for (const alias of state.aliases) {
+      if (alias.toLowerCase() === normalized) return state;
+    }
+  }
+  return null;
+}
+function getStateByCode(code, states) {
+  return states.find((s) => s.code === code) ?? null;
+}
+function getStatesByGroup(group, states) {
+  return states.filter((s) => s.group === group);
+}
+
+// src/weekend.ts
+var DAY_NAMES = [
+  "Sunday",
+  "Monday",
+  "Tuesday",
+  "Wednesday",
+  "Thursday",
+  "Friday",
+  "Saturday"
+];
+function getWeekendConfig(state, date) {
+  for (const config of state.weekendHistory) {
+    const from = config.from;
+    const to = config.to;
+    if (date >= from && (to === null || date <= to)) {
+      return config;
+    }
+  }
+  return state.weekendHistory[0];
+}
+function isWeekend(date, state) {
+  const config = getWeekendConfig(state, date);
+  const dayOfWeek = (/* @__PURE__ */ new Date(date + "T12:00:00Z")).getUTCDay();
+  return config.weekendDays.includes(dayOfWeek);
+}
+function getDayOfWeekName(date) {
+  const dayIndex = (/* @__PURE__ */ new Date(date + "T12:00:00Z")).getUTCDay();
+  return DAY_NAMES[dayIndex];
+}
+function getWeekendDayNames(state, date) {
+  const config = getWeekendConfig(state, date);
+  return config.weekendDays.map((d) => DAY_NAMES[d]);
+}
+function addDays(date, days) {
+  const d = /* @__PURE__ */ new Date(date + "T12:00:00Z");
+  d.setUTCDate(d.getUTCDate() + days);
+  return d.toISOString().slice(0, 10);
+}
+function nextWorkingDay(date, state, holidayDates) {
+  let candidate = addDays(date, 1);
+  while (isWeekend(candidate, state) || holidayDates.has(candidate)) {
+    candidate = addDays(candidate, 1);
+  }
+  return candidate;
+}
+function diffDays(start, end) {
+  const s = (/* @__PURE__ */ new Date(start + "T00:00:00")).getTime();
+  const e = (/* @__PURE__ */ new Date(end + "T00:00:00")).getTime();
+  return Math.round((e - s) / (1e3 * 60 * 60 * 24));
+}
+
+// src/filter.ts
+function filterHolidays(holidays, filter) {
+  return holidays.filter((h) => {
+    if (filter.year !== void 0) {
+      const year = parseInt(h.date.slice(0, 4), 10);
+      if (year !== filter.year) return false;
+    }
+    if (filter.month !== void 0) {
+      const month = parseInt(h.date.slice(5, 7), 10);
+      if (month !== filter.month) return false;
+    }
+    if (filter.state !== void 0) {
+      if (!h.states.includes("*") && !h.states.includes(filter.state)) {
+        return false;
+      }
+    }
+    if (filter.type !== void 0 && h.type !== filter.type) return false;
+    if (filter.status !== void 0 && h.status !== filter.status) return false;
+    return true;
+  });
+}
+function findHolidaysByDate(date, holidays, stateCode) {
+  return holidays.filter((h) => {
+    if (h.date !== date) return false;
+    if (h.status === "cancelled") return false;
+    if (stateCode && !h.states.includes("*") && !h.states.includes(stateCode)) {
+      return false;
+    }
+    return true;
+  });
+}
+function findNextHoliday(afterDate, holidays, stateCode, type, limit = 1) {
+  const filtered = holidays.filter((h) => {
+    if (h.date <= afterDate) return false;
+    if (h.status === "cancelled") return false;
+    if (stateCode && !h.states.includes("*") && !h.states.includes(stateCode)) {
+      return false;
+    }
+    if (type !== void 0 && h.type !== type) return false;
+    return true;
+  }).sort((a, b) => a.date.localeCompare(b.date));
+  return filtered.slice(0, limit);
+}
+
+// src/replacement.ts
+function calculateReplacementHolidays(holidays, state) {
+  const stateHolidays = holidays.filter(
+    (h) => h.status !== "cancelled" && (h.states.includes("*") || h.states.includes(state.code))
+  );
+  const holidayDates = new Set(stateHolidays.map((h) => h.date));
+  const replacementDates = /* @__PURE__ */ new Set();
+  const replacements = [];
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  for (const holiday of stateHolidays) {
+    if (holiday.type === "replacement") continue;
+    if (isWeekend(holiday.date, state)) {
+      const allOccupied = /* @__PURE__ */ new Set([...holidayDates, ...replacementDates]);
+      const replacementDate = nextWorkingDay(holiday.date, state, allOccupied);
+      replacementDates.add(replacementDate);
+      replacements.push({
+        id: `${holiday.id}-replacement`,
+        date: replacementDate,
+        name: {
+          ms: `Cuti Ganti ${holiday.name.ms}`,
+          en: `Replacement for ${holiday.name.en}`,
+          zh: holiday.name.zh ? `\u8865\u5047 ${holiday.name.zh}` : void 0
+        },
+        type: "replacement",
+        status: holiday.status,
+        states: [state.code],
+        isPublicHoliday: true,
+        gazetteLevel: holiday.gazetteLevel,
+        isReplacementFor: holiday.id,
+        source: holiday.source,
+        createdAt: now,
+        updatedAt: now
+      });
+    }
+  }
+  const dateGroups = /* @__PURE__ */ new Map();
+  for (const h of stateHolidays) {
+    if (h.type === "replacement") continue;
+    const existing = dateGroups.get(h.date) ?? [];
+    dateGroups.set(h.date, [...existing, h]);
+  }
+  for (const [, group] of dateGroups) {
+    if (group.length <= 1) continue;
+    const stateHoliday = group.find((h) => h.gazetteLevel === "N");
+    if (!stateHoliday) continue;
+    if (replacements.some((r) => r.isReplacementFor === stateHoliday.id)) continue;
+    const allOccupied = /* @__PURE__ */ new Set([...holidayDates, ...replacementDates]);
+    const replacementDate = nextWorkingDay(stateHoliday.date, state, allOccupied);
+    replacementDates.add(replacementDate);
+    replacements.push({
+      id: `${stateHoliday.id}-overlap-replacement`,
+      date: replacementDate,
+      name: {
+        ms: `Cuti Ganti ${stateHoliday.name.ms}`,
+        en: `Replacement for ${stateHoliday.name.en}`,
+        zh: stateHoliday.name.zh ? `\u8865\u5047 ${stateHoliday.name.zh}` : void 0
+      },
+      type: "replacement",
+      status: stateHoliday.status,
+      states: [state.code],
+      isPublicHoliday: true,
+      gazetteLevel: stateHoliday.gazetteLevel,
+      isReplacementFor: stateHoliday.id,
+      source: stateHoliday.source,
+      createdAt: now,
+      updatedAt: now
+    });
+  }
+  return replacements;
+}
+
+// src/business-days.ts
+function countBusinessDays(start, end, state, holidays) {
+  const totalDays = diffDays(start, end) + 1;
+  let businessDays = 0;
+  let weekendCount = 0;
+  let holidayCount = 0;
+  const holidayList = [];
+  let current = start;
+  while (current <= end) {
+    const weekend = isWeekend(current, state);
+    const dayHolidays = findHolidaysByDate(current, holidays, state.code);
+    const isHoliday = dayHolidays.length > 0;
+    if (weekend) {
+      weekendCount++;
+    } else if (isHoliday) {
+      holidayCount++;
+      for (const h of dayHolidays) {
+        if (!holidayList.some((existing) => existing.id === h.id)) {
+          holidayList.push(h);
+        }
+      }
+    } else {
+      businessDays++;
+    }
+    current = addDays(current, 1);
+  }
+  return {
+    totalDays,
+    businessDays,
+    holidays: holidayCount,
+    weekendDays: weekendCount,
+    holidayList
+  };
+}
+function addBusinessDays(startDate, daysToAdd, state, holidays) {
+  let remaining = daysToAdd;
+  let current = startDate;
+  while (remaining > 0) {
+    current = addDays(current, 1);
+    const weekend = isWeekend(current, state);
+    const isHoliday = findHolidaysByDate(current, holidays, state.code).length > 0;
+    if (!weekend && !isHoliday) {
+      remaining--;
+    }
+  }
+  return current;
+}
+
+// src/school.ts
+function findSchoolTermByDate(date, terms, group) {
+  return terms.find(
+    (t) => t.group === group && date >= t.startDate && date <= t.endDate
+  ) ?? null;
+}
+function findSchoolHolidayByDate(date, holidays, group, stateCode) {
+  return holidays.find((h) => {
+    if (h.group !== group) return false;
+    if (date < h.startDate || date > h.endDate) return false;
+    if (stateCode && h.excludeStates?.includes(stateCode)) return false;
+    if (h.states && !h.states.includes(stateCode ?? "")) return false;
+    return true;
+  }) ?? null;
+}
+function isSchoolDay(date, terms, schoolHolidays, group, isPublicHoliday, isWeekendDay, stateCode) {
+  if (isWeekendDay) return false;
+  if (isPublicHoliday) return false;
+  const schoolHoliday = findSchoolHolidayByDate(
+    date,
+    schoolHolidays,
+    group,
+    stateCode
+  );
+  if (schoolHoliday) return false;
+  const term = findSchoolTermByDate(date, terms, group);
+  return term !== null;
+}
+
+// src/ical.ts
+function escapeIcal(text) {
+  return text.replace(/[\\;,]/g, (c) => `\\${c}`).replace(/\n/g, "\\n");
+}
+function formatIcalDate(date) {
+  return date.replace(/-/g, "");
+}
+function holidayToVevent(h) {
+  const dtstart = formatIcalDate(h.date);
+  const dtend = h.endDate ? formatIcalDate(h.endDate) : formatIcalDate(h.date);
+  return [
+    "BEGIN:VEVENT",
+    `DTSTART;VALUE=DATE:${dtstart}`,
+    `DTEND;VALUE=DATE:${dtend}`,
+    `SUMMARY:${escapeIcal(h.name.en)}`,
+    `DESCRIPTION:${escapeIcal(h.name.ms)}${h.hijriDate ? ` (${h.hijriDate})` : ""}`,
+    `UID:${h.id}@mycal.my`,
+    `STATUS:${h.status === "tentative" ? "TENTATIVE" : "CONFIRMED"}`,
+    "END:VEVENT"
+  ].join("\r\n");
+}
+function schoolHolidayToVevent(h) {
+  return [
+    "BEGIN:VEVENT",
+    `DTSTART;VALUE=DATE:${formatIcalDate(h.startDate)}`,
+    `DTEND;VALUE=DATE:${formatIcalDate(h.endDate)}`,
+    `SUMMARY:[School] ${escapeIcal(h.name.en)}`,
+    `DESCRIPTION:${escapeIcal(h.name.ms)}`,
+    `UID:${h.id}@mycal.my`,
+    "STATUS:CONFIRMED",
+    "END:VEVENT"
+  ].join("\r\n");
+}
+function generateIcal(holidays, schoolHolidays, calendarName) {
+  const header = [
+    "BEGIN:VCALENDAR",
+    "VERSION:2.0",
+    "PRODID:-//MyCal//Malaysia Calendar API//EN",
+    `X-WR-CALNAME:${escapeIcal(calendarName)}`,
+    "X-WR-TIMEZONE:Asia/Kuala_Lumpur",
+    "CALSCALE:GREGORIAN",
+    "METHOD:PUBLISH",
+    "REFRESH-INTERVAL;VALUE=DURATION:PT6H",
+    "X-PUBLISHED-TTL:PT6H"
+  ].join("\r\n");
+  const events = [
+    ...holidays.filter((h) => h.status !== "cancelled").map(holidayToVevent),
+    ...schoolHolidays.map(schoolHolidayToVevent)
+  ].join("\r\n");
+  return `${header}\r
+${events}\r
+END:VCALENDAR\r
+`;
+}
+
+// src/hijri.ts
+var HIJRI_MONTHS = [
+  { number: 1, nameMs: "Muharam", nameEn: "Muharram", nameAr: "\u0645\u062D\u0631\u0651\u0645" },
+  { number: 2, nameMs: "Safar", nameEn: "Safar", nameAr: "\u0635\u0641\u0631" },
+  { number: 3, nameMs: "Rabiulawal", nameEn: "Rabi al-Awwal", nameAr: "\u0631\u0628\u064A\u0639 \u0627\u0644\u0623\u0648\u0651\u0644" },
+  { number: 4, nameMs: "Rabiulakhir", nameEn: "Rabi al-Thani", nameAr: "\u0631\u0628\u064A\u0639 \u0627\u0644\u062B\u0627\u0646\u064A" },
+  { number: 5, nameMs: "Jamadilawal", nameEn: "Jumada al-Ula", nameAr: "\u062C\u0645\u0627\u062F\u0649 \u0627\u0644\u0623\u0648\u0644\u0649" },
+  { number: 6, nameMs: "Jamadilakhir", nameEn: "Jumada al-Thani", nameAr: "\u062C\u0645\u0627\u062F\u0649 \u0627\u0644\u062B\u0627\u0646\u064A\u0629" },
+  { number: 7, nameMs: "Rejab", nameEn: "Rajab", nameAr: "\u0631\u062C\u0628" },
+  { number: 8, nameMs: "Syaaban", nameEn: "Sha'ban", nameAr: "\u0634\u0639\u0628\u0627\u0646" },
+  { number: 9, nameMs: "Ramadan", nameEn: "Ramadan", nameAr: "\u0631\u0645\u0636\u0627\u0646" },
+  { number: 10, nameMs: "Syawal", nameEn: "Shawwal", nameAr: "\u0634\u0648\u0651\u0627\u0644" },
+  { number: 11, nameMs: "Zulkaedah", nameEn: "Dhu al-Qi'dah", nameAr: "\u0630\u0648 \u0627\u0644\u0642\u0639\u062F\u0629" },
+  { number: 12, nameMs: "Zulhijjah", nameEn: "Dhu al-Hijjah", nameAr: "\u0630\u0648 \u0627\u0644\u062D\u062C\u0651\u0629" }
+];
+function parseHijriDate(hijriStr) {
+  const match = hijriStr.match(/^(\d+)\s+(.+?)\s+(\d+)$/);
+  if (!match) return null;
+  const day = parseInt(match[1], 10);
+  const monthName = match[2].toLowerCase();
+  const year = parseInt(match[3], 10);
+  const month = HIJRI_MONTHS.find(
+    (m) => m.nameMs.toLowerCase() === monthName || m.nameEn.toLowerCase() === monthName
+  );
+  if (!month) return null;
+  return { day, month, year };
+}
+function formatHijriDate(day, monthNumber, year) {
+  const month = HIJRI_MONTHS.find((m) => m.number === monthNumber);
+  if (!month) return `${day} ? ${year}`;
+  return `${day} ${month.nameMs} ${year}`;
+}
+var ISLAMIC_HOLIDAY_DATES = [
+  { nameMs: "Awal Muharam", nameEn: "Islamic New Year", hijriMonth: 1, hijriDay: 1 },
+  { nameMs: "Maulidur Rasul", nameEn: "Prophet Muhammad's Birthday", hijriMonth: 3, hijriDay: 12 },
+  { nameMs: "Israk dan Mikraj", nameEn: "Isra' Mi'raj", hijriMonth: 7, hijriDay: 27 },
+  { nameMs: "Nuzul Al-Quran", nameEn: "Revelation of the Quran", hijriMonth: 9, hijriDay: 17 },
+  { nameMs: "Hari Raya Aidilfitri", nameEn: "Eid al-Fitr", hijriMonth: 10, hijriDay: 1 },
+  { nameMs: "Hari Raya Haji", nameEn: "Eid al-Adha", hijriMonth: 12, hijriDay: 10 },
+  { nameMs: "Hari Arafah", nameEn: "Day of Arafah", hijriMonth: 12, hijriDay: 9 }
+];
+export {
+  HIJRI_MONTHS,
+  ISLAMIC_HOLIDAY_DATES,
+  addBusinessDays,
+  addDays,
+  calculateReplacementHolidays,
+  countBusinessDays,
+  diffDays,
+  examSchema,
+  examsFileSchema,
+  filterHolidays,
+  findHolidaysByDate,
+  findNextHoliday,
+  findSchoolHolidayByDate,
+  findSchoolTermByDate,
+  formatHijriDate,
+  generateIcal,
+  getDayOfWeekName,
+  getStateByCode,
+  getStatesByGroup,
+  getWeekendConfig,
+  getWeekendDayNames,
+  holidayFileSchema,
+  holidaySchema,
+  isSchoolDay,
+  isWeekend,
+  nextWorkingDay,
+  parseHijriDate,
+  resolveStateCode,
+  schoolHolidaySchema,
+  schoolHolidaysFileSchema,
+  schoolTermSchema,
+  schoolTermsFileSchema,
+  stateSchema,
+  statesFileSchema
+};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@catlabtech/mycal-core",
+  "version": "0.1.0",
+  "description": "Core types, schemas, and business logic for the Malaysia Calendar API",
+  "keywords": [
+    "malaysia",
+    "calendar",
+    "holidays",
+    "cuti",
+    "typescript"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Junhui20/malaysia-calendar-api.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://mycal.pages.dev",
+  "bugs": "https://github.com/Junhui20/malaysia-calendar-api/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "dependencies": {
+    "zod": "^3.24.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "dev": "tsup src/index.ts --format esm --dts --watch",
+    "test": "node __tests__/run-tests.cjs"
+  }
+}