@catlabtech/mycal-core 0.1.2 → 0.1.3

package/dist/index.d.ts

@@ -1,892 +1,14 @@
-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 HolidayCategory = "public" | "bank" | "optional" | "half_day" | "observance";
-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 category?: HolidayCategory;
-    readonly isEstimated?: boolean;
-    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;
-    readonly isoCode?: string;
-}
-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 LeaveSuggestion {
-    readonly startDate: string;
-    readonly endDate: string;
-    readonly totalDays: number;
-    readonly leaveDates: readonly string[];
-    readonly leaveCost: number;
-    readonly efficiency: number;
-    readonly holidays: readonly Holiday[];
-}
-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 holidayCategorySchema: z.ZodEnum<["public", "bank", "optional", "half_day", "observance"]>;
-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"]>;
-    category: z.ZodOptional<z.ZodEnum<["public", "bank", "optional", "half_day", "observance"]>>;
-    isEstimated: z.ZodOptional<z.ZodBoolean>;
-    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;
-    category?: "public" | "bank" | "optional" | "half_day" | "observance" | undefined;
-    isEstimated?: boolean | 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;
-    category?: "public" | "bank" | "optional" | "half_day" | "observance" | undefined;
-    isEstimated?: boolean | 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"]>;
-    category: z.ZodOptional<z.ZodEnum<["public", "bank", "optional", "half_day", "observance"]>>;
-    isEstimated: z.ZodOptional<z.ZodBoolean>;
-    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;
-    category?: "public" | "bank" | "optional" | "half_day" | "observance" | undefined;
-    isEstimated?: boolean | 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;
-    category?: "public" | "bank" | "optional" | "half_day" | "observance" | undefined;
-    isEstimated?: boolean | 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"]>;
-    isoCode: z.ZodOptional<z.ZodString>;
-}, "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";
-    }[];
-    isoCode?: string | undefined;
-}, {
-    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";
-    }[];
-    isoCode?: string | undefined;
-}>;
-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"]>;
-    isoCode: z.ZodOptional<z.ZodString>;
-}, "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";
-    }[];
-    isoCode?: string | undefined;
-}, {
-    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";
-    }[];
-    isoCode?: string | undefined;
-}>, "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[];
-/**
- * Index holidays by their ISO date for O(1) date lookups, skipping cancelled
- * holidays and (when `stateCode` is given) holidays that do not apply to that
- * state. Shared by the business-day and long-weekend scanners so they don't each
- * re-filter the array on every day.
- */
-declare function groupHolidaysByDate(holidays: readonly Holiday[], stateCode?: string): Map<string, 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 subtractBusinessDays(startDate: string, daysToSubtract: number, state: State, holidays: readonly Holiday[]): string;
-declare function isBusinessDay(date: string, state: State, holidays: readonly Holiday[]): boolean;
-declare function nextBusinessDay(date: string, state: State, holidays: readonly Holiday[]): string;
-declare function previousBusinessDay(date: string, state: State, holidays: readonly Holiday[]): string;
-
-/**
- * Natural long weekends for a state in a given year: runs of 3+ consecutive
- * non-working days (weekend days and/or public holidays) that need no leave.
- *
- * Shared by the REST `/holidays/long-weekends` route and the MCP server so the
- * two cannot diverge.
- */
-declare function findLongWeekends(year: number, state: State, holidays: readonly Holiday[]): LongWeekend[];
-/**
- * Leave optimizer: where can you spend up to `maxLeave` working days to chain
- * weekends and public holidays into the longest possible continuous break?
- *
- * Returns suggestions sorted by efficiency (days off gained per leave day spent),
- * then by total length. Each suggestion's `leaveDates` are the exact working days
- * to request off — e.g. "take 2026-09-14 & 2026-09-15 → 2026-09-12…2026-09-16".
- */
-declare function optimizeLeave(year: number, state: State, holidays: readonly Holiday[], maxLeave?: number): LeaveSuggestion[];
-
-/**
- * Input-validation and request-safety helpers shared by the API layer. Kept here
- * (pure, dependency-free) so they are unit-testable and reusable by any consumer.
- */
-/** True only for a real calendar date in strict `YYYY-MM-DD` form (rejects 2026-02-30). */
-declare function isValidISODate(value: string): boolean;
-/**
- * Constant-time string comparison for secrets (API keys). Returns early only on
- * a length mismatch; otherwise compares every byte so timing does not leak how
- * many leading characters matched.
- */
-declare function timingSafeEqualString(a: string, b: string): boolean;
-/**
- * SSRF guard for user-supplied callback/webhook URLs. Requires HTTPS and rejects
- * obviously-internal targets (localhost, *.local/.internal, and private/loopback/
- * link-local/reserved IP literals incl. the 169.254.169.254 cloud-metadata IP).
- *
- * Best-effort at registration time: DNS is NOT resolved here, so delivery code
- * MUST re-validate the resolved IP to defend against DNS rebinding.
- */
-declare function isSafePublicHttpsUrl(raw: string): boolean;
-
-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;
-/**
- * List the school holidays that apply to a group (and optionally a specific
- * state, honouring `states`/`excludeStates` overrides). Shared by the REST
- * `/school/holidays` and iCal feed routes so the filter logic lives in one place.
- */
-declare function filterSchoolHolidays(holidays: readonly SchoolHoliday[], group: StateGroup, stateCode?: string): readonly SchoolHoliday[];
-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, calendarDescription?: 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 HolidayCategory, type HolidayFilter, type HolidaySource, type HolidayStatus, type HolidayType, ISLAMIC_HOLIDAY_DATES, type LeaveSuggestion, 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, filterSchoolHolidays, findHolidaysByDate, findLongWeekends, findNextHoliday, findSchoolHolidayByDate, findSchoolTermByDate, formatHijriDate, generateIcal, getDayOfWeekName, getStateByCode, getStatesByGroup, getWeekendConfig, getWeekendDayNames, groupHolidaysByDate, holidayCategorySchema, holidayFileSchema, holidaySchema, isBusinessDay, isSafePublicHttpsUrl, isSchoolDay, isValidISODate, isWeekend, nextBusinessDay, nextWorkingDay, optimizeLeave, parseHijriDate, previousBusinessDay, resolveStateCode, schoolHolidaySchema, schoolHolidaysFileSchema, schoolTermSchema, schoolTermsFileSchema, stateSchema, statesFileSchema, subtractBusinessDays, timingSafeEqualString };
+export type { LocalizedString, Holiday, HolidayType, HolidayCategory, HolidayStatus, HolidaySource, GazetteLevel, State, StateGroup, StateType, WeekendConfig, SchoolTerm, SchoolTermSegment, SchoolHoliday, SchoolHolidayType, Exam, ExamType, ExamSource, CheckDateResult, BusinessDaysResult, LongWeekend, LeaveSuggestion, ChangelogEntry, } from "./types.js";
+export { holidaySchema, holidayCategorySchema, holidayFileSchema, stateSchema, statesFileSchema, schoolTermSchema, schoolTermsFileSchema, schoolHolidaySchema, schoolHolidaysFileSchema, examSchema, examsFileSchema, } from "./schemas.js";
+export { resolveStateCode, getStateByCode, getStatesByGroup, } from "./state-resolver.js";
+export { getWeekendConfig, isWeekend, getDayOfWeekName, getWeekendDayNames, addDays, nextWorkingDay, diffDays, } from "./weekend.js";
+export { filterHolidays, findHolidaysByDate, findNextHoliday, groupHolidaysByDate, } from "./filter.js";
+export type { HolidayFilter } from "./filter.js";
+export { calculateReplacementHolidays } from "./replacement.js";
+export { countBusinessDays, addBusinessDays, subtractBusinessDays, isBusinessDay, nextBusinessDay, previousBusinessDay, } from "./business-days.js";
+export { findLongWeekends, optimizeLeave } from "./long-weekend.js";
+export { isValidISODate, timingSafeEqualString, isSafePublicHttpsUrl, } from "./validation.js";
+export { findSchoolTermByDate, findSchoolHolidayByDate, filterSchoolHolidays, isSchoolDay, } from "./school.js";
+export { generateIcal } from "./ical.js";
+export { HIJRI_MONTHS, ISLAMIC_HOLIDAY_DATES, parseHijriDate, formatHijriDate, } from "./hijri.js";
+export type { HijriMonth } from "./hijri.js";