@nextera.one/tps-standard 0.5.1 → 0.5.3

package/dist/drivers/gregorian.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GregorianDriver = void 0;
+const index_1 = require("../index");
+/**
+ * Gregorian calendar driver.
+ * This mirrors the built-in logic that used to live in `TPS.fromDate`/`toDate`
+ * and provides implementations for the full `CalendarDriver` interface.
+ * The driver also implements the optional helpers, enabling unit tests to
+ * exercise `parseDate`, `format`, `validate`, and `getMetadata`.
+ */
+class GregorianDriver {
+    constructor() {
+        this.code = "greg";
+    }
+    getComponentsFromDate(date) {
+        const fullYear = date.getUTCFullYear();
+        return {
+            calendar: this.code,
+            millennium: Math.floor(fullYear / 1000) + 1,
+            century: Math.floor((fullYear % 1000) / 100) + 1,
+            year: fullYear % 100,
+            month: date.getUTCMonth() + 1,
+            day: date.getUTCDate(),
+            hour: date.getUTCHours(),
+            minute: date.getUTCMinutes(),
+            second: date.getUTCSeconds(),
+            millisecond: date.getUTCMilliseconds(),
+        };
+    }
+    getDateFromComponents(components) {
+        const m = components.millennium ?? 0;
+        const c = components.century ?? 1;
+        const y = components.year ?? 0;
+        const fullYear = (m - 1) * 1000 + (c - 1) * 100 + y;
+        return new Date(Date.UTC(fullYear, (components.month || 1) - 1, components.day || 1, components.hour || 0, components.minute || 0, Math.floor(components.second || 0), components.millisecond ??
+            Math.round(((components.second || 0) % 1) * 1000)));
+    }
+    getFromDate(date) {
+        const comp = this.getComponentsFromDate(date);
+        // buildTimePart understands the `order` field if the caller has set it
+        return index_1.TPS.buildTimePart(comp);
+    }
+    // --- optional helpers --------------------------------------------------
+    parseDate(input, format) {
+        // Accept ISO-like formats: "YYYY-MM-DD" and optionally time portion
+        const s = input.trim();
+        // simple regex - not exhaustive
+        const m = s.match(/^(\d{4})-(\d{2})-(\d{2})(?:[ T](\d{2}):(\d{2}):(\d{2})(?:\.(\d+))?)?$/);
+        if (!m) {
+            throw new Error(`GregorianDriver.parseDate: unsupported format "${input}"`);
+        }
+        const year = parseInt(m[1], 10);
+        const month = parseInt(m[2], 10);
+        const day = parseInt(m[3], 10);
+        const hour = m[4] !== undefined ? parseInt(m[4], 10) : undefined;
+        const minute = m[5] !== undefined ? parseInt(m[5], 10) : undefined;
+        const second = m[6] !== undefined ? parseInt(m[6], 10) : undefined;
+        const millisecond = m[7] !== undefined ? parseInt((m[7] + "000").slice(0, 3), 10) : undefined;
+        const comp = {
+            calendar: this.code,
+            year,
+            month,
+            day,
+        };
+        if (hour !== undefined)
+            comp.hour = hour;
+        if (minute !== undefined)
+            comp.minute = minute;
+        if (second !== undefined)
+            comp.second = second;
+        if (millisecond !== undefined)
+            comp.millisecond = millisecond;
+        return comp;
+    }
+    format(components, format) {
+        // For simplicity we ignore `format` and always produce ISO-ish string
+        const y = components.year !== undefined
+            ? String(components.year).padStart(4, "0")
+            : "0000";
+        const mo = components.month !== undefined
+            ? String(components.month).padStart(2, "0")
+            : "01";
+        const d = components.day !== undefined
+            ? String(components.day).padStart(2, "0")
+            : "01";
+        let out = `${y}-${mo}-${d}`;
+        if (components.hour !== undefined ||
+            components.minute !== undefined ||
+            components.second !== undefined ||
+            components.millisecond !== undefined) {
+            const h = components.hour !== undefined
+                ? String(components.hour).padStart(2, "0")
+                : "00";
+            const mi = components.minute !== undefined
+                ? String(components.minute).padStart(2, "0")
+                : "00";
+            const s = components.second !== undefined
+                ? String(Math.floor(components.second)).padStart(2, "0")
+                : "00";
+            const ms = components.millisecond !== undefined
+                ? String(components.millisecond).padStart(3, "0")
+                : "000";
+            out += `T${h}:${mi}:${s}.${ms}`;
+        }
+        return out;
+    }
+    validate(input) {
+        if (typeof input === "string") {
+            // basic ISO date with optional time and fractional seconds
+            return /^\d{4}-\d{2}-\d{2}(?:[ T]\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?)?$/.test(input.trim());
+        }
+        if (typeof input === "object") {
+            return (input.year !== undefined &&
+                input.month !== undefined &&
+                input.day !== undefined &&
+                input.year >= 0 &&
+                input.month >= 1 &&
+                input.month <= 12 &&
+                input.day >= 1 &&
+                input.day <= 31);
+        }
+        return false;
+    }
+    getMetadata() {
+        return {
+            name: "Gregorian",
+            monthNames: [
+                "January",
+                "February",
+                "March",
+                "April",
+                "May",
+                "June",
+                "July",
+                "August",
+                "September",
+                "October",
+                "November",
+                "December",
+            ],
+            dayNames: [
+                "Sunday",
+                "Monday",
+                "Tuesday",
+                "Wednesday",
+                "Thursday",
+                "Friday",
+                "Saturday",
+            ],
+            monthsPerYear: 12,
+            epochYear: 1,
+        };
+    }
+}
+exports.GregorianDriver = GregorianDriver;
+//# sourceMappingURL=gregorian.js.map

package/dist/drivers/gregorian.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gregorian.js","sourceRoot":"","sources":["../../src/drivers/gregorian.ts"],"names":[],"mappings":"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"}

package/dist/drivers/hijri.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Hijri (Islamic) Calendar Driver — Tabular / Arithmetic variant
+ *
+ * Calendar characteristics:
+ * - Lunar calendar with 12 months of alternating 30/29 days
+ * - 30-year cycle with 11 leap years (Dhul Hijjah gains a day)
+ * - Year 1 AH ≈ 16 July 622 CE (Julian)
+ * - Average year ≈ 354.36667 days
+ *
+ * This uses the Tabular Islamic Calendar (civil/Type II-A) algorithm
+ * based on the formulas from Meeus "Astronomical Algorithms".
+ */
+import { CalendarDriver, CalendarMetadata, TPSComponents } from "../index";
+export declare class HijriDriver implements CalendarDriver {
+    readonly code = "hij";
+    readonly name = "Hijri (Islamic Calendar)";
+    private readonly MONTH_NAMES;
+    private readonly MONTH_NAMES_SHORT;
+    private readonly DAY_NAMES;
+    /** Leap years in a 30-year cycle (civil / Type II-A pattern) */
+    private readonly LEAP_YEARS_IN_CYCLE;
+    getComponentsFromDate(date: Date): Partial<TPSComponents>;
+    getDateFromComponents(components: Partial<TPSComponents>): Date;
+    getFromDate(date: Date): string;
+    parseDate(input: string, format?: string): Partial<TPSComponents>;
+    format(components: Partial<TPSComponents>, format?: string): string;
+    validate(input: string | Partial<TPSComponents>): boolean;
+    getMetadata(): CalendarMetadata;
+    private isLeapYear;
+    private daysInMonth;
+    /**
+     * Convert Gregorian to Hijri (Tabular Islamic Calendar).
+     * Algorithm from "Astronomical Algorithms" by Jean Meeus.
+     */
+    private gregorianToHijri;
+    /**
+     * Convert Hijri to Gregorian.
+     */
+    private hijriToGregorian;
+    private gregorianToJdn;
+    private jdnToGregorian;
+}

package/dist/drivers/hijri.js

@@ -0,0 +1,281 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HijriDriver = void 0;
+/**
+ * Hijri (Islamic) Calendar Driver — Tabular / Arithmetic variant
+ *
+ * Calendar characteristics:
+ * - Lunar calendar with 12 months of alternating 30/29 days
+ * - 30-year cycle with 11 leap years (Dhul Hijjah gains a day)
+ * - Year 1 AH ≈ 16 July 622 CE (Julian)
+ * - Average year ≈ 354.36667 days
+ *
+ * This uses the Tabular Islamic Calendar (civil/Type II-A) algorithm
+ * based on the formulas from Meeus "Astronomical Algorithms".
+ */
+const index_1 = require("../index");
+class HijriDriver {
+    constructor() {
+        this.code = "hij";
+        this.name = "Hijri (Islamic Calendar)";
+        this.MONTH_NAMES = [
+            "Muharram",
+            "Safar",
+            "Rabi' al-Awwal",
+            "Rabi' al-Thani",
+            "Jumada al-Ula",
+            "Jumada al-Thani",
+            "Rajab",
+            "Sha'ban",
+            "Ramadan",
+            "Shawwal",
+            "Dhu al-Qi'dah",
+            "Dhu al-Hijjah",
+        ];
+        this.MONTH_NAMES_SHORT = [
+            "Muh",
+            "Saf",
+            "Rab I",
+            "Rab II",
+            "Jum I",
+            "Jum II",
+            "Raj",
+            "Sha",
+            "Ram",
+            "Shaw",
+            "Dhu Q",
+            "Dhu H",
+        ];
+        this.DAY_NAMES = [
+            "al-Ahad",
+            "al-Ithnayn",
+            "ath-Thulatha",
+            "al-Arbi'a",
+            "al-Khamis",
+            "al-Jumu'ah",
+            "as-Sabt",
+        ];
+        /** Leap years in a 30-year cycle (civil / Type II-A pattern) */
+        this.LEAP_YEARS_IN_CYCLE = new Set([
+            2, 5, 7, 10, 13, 16, 18, 21, 24, 26, 29,
+        ]);
+    }
+    // ── CalendarDriver interface ──────────────────────────────────────────
+    getComponentsFromDate(date) {
+        const { hy, hm, hd } = this.gregorianToHijri(date.getUTCFullYear(), date.getUTCMonth() + 1, date.getUTCDate());
+        return {
+            calendar: this.code,
+            millennium: Math.floor(hy / 1000) + 1,
+            century: Math.floor((hy % 1000) / 100) + 1,
+            year: hy % 100,
+            month: hm,
+            day: hd,
+            hour: date.getUTCHours(),
+            minute: date.getUTCMinutes(),
+            second: date.getUTCSeconds(),
+            millisecond: date.getUTCMilliseconds(),
+        };
+    }
+    getDateFromComponents(components) {
+        let hy;
+        if (components.millennium !== undefined) {
+            const m = components.millennium ?? 0;
+            const c = components.century ?? 1;
+            const y = components.year ?? 0;
+            hy = (m - 1) * 1000 + (c - 1) * 100 + y;
+        }
+        else {
+            hy = components.year ?? 1;
+        }
+        const hm = components.month ?? 1;
+        const hd = components.day ?? 1;
+        const { gy, gm, gd } = this.hijriToGregorian(hy, hm, hd);
+        return new Date(Date.UTC(gy, gm - 1, gd, components.hour ?? 0, components.minute ?? 0, Math.floor(components.second ?? 0), components.millisecond ?? 0));
+    }
+    getFromDate(date) {
+        const comp = this.getComponentsFromDate(date);
+        return index_1.TPS.buildTimePart(comp);
+    }
+    parseDate(input, format) {
+        const trimmed = input.trim();
+        if (format === "short" ||
+            (trimmed.includes("/") && trimmed.split("/")[0].length <= 2)) {
+            const [day, month, year] = trimmed.split("/").map(Number);
+            return {
+                calendar: this.code,
+                millennium: Math.floor(year / 1000) + 1,
+                century: Math.floor((year % 1000) / 100) + 1,
+                year: year % 100,
+                month,
+                day,
+            };
+        }
+        const segments = trimmed.split(/[\s,T]+/);
+        const [fullYear, month, day] = segments[0].split("-").map(Number);
+        const result = {
+            calendar: this.code,
+            millennium: Math.floor(fullYear / 1000) + 1,
+            century: Math.floor((fullYear % 1000) / 100) + 1,
+            year: fullYear % 100,
+            month,
+            day,
+        };
+        if (segments[1]) {
+            const [h, m, s] = segments[1].split(":").map(Number);
+            result.hour = h ?? 0;
+            result.minute = m ?? 0;
+            result.second = s ?? 0;
+        }
+        return result;
+    }
+    format(components, format) {
+        const pad = (n) => String(n ?? 0).padStart(2, "0");
+        let fullYear;
+        if (components.millennium !== undefined) {
+            const m = components.millennium ?? 0;
+            const c = components.century ?? 1;
+            const y = components.year ?? 0;
+            fullYear = (m - 1) * 1000 + (c - 1) * 100 + y;
+        }
+        else {
+            fullYear = components.year ?? 0;
+        }
+        if (format === "short") {
+            return `${components.day}/${pad(components.month)}/${fullYear}`;
+        }
+        if (format === "long") {
+            const mn = this.MONTH_NAMES[(components.month ?? 1) - 1];
+            return `${components.day} ${mn} ${fullYear}`;
+        }
+        let out = `${fullYear}-${pad(components.month)}-${pad(components.day)}`;
+        if (components.hour !== undefined) {
+            out += ` ${pad(components.hour)}:${pad(components.minute)}:${pad(Math.floor(components.second ?? 0))}`;
+        }
+        return out;
+    }
+    validate(input) {
+        let comp;
+        if (typeof input === "string") {
+            try {
+                comp = this.parseDate(input);
+            }
+            catch {
+                return false;
+            }
+        }
+        else {
+            comp = input;
+        }
+        const { year, month, day } = comp;
+        // Reconstruct full year for leap check
+        let fullYear;
+        if (comp.millennium !== undefined) {
+            fullYear =
+                ((comp.millennium ?? 0) - 1) * 1000 +
+                    ((comp.century ?? 1) - 1) * 100 +
+                    (year ?? 0);
+        }
+        else {
+            fullYear = year ?? 0;
+        }
+        if (fullYear < 1)
+            return false;
+        if (!month || month < 1 || month > 12)
+            return false;
+        if (!day || day < 1)
+            return false;
+        const maxDays = this.daysInMonth(fullYear, month);
+        return day <= maxDays;
+    }
+    getMetadata() {
+        return {
+            name: "Hijri (Islamic Calendar)",
+            monthNames: this.MONTH_NAMES,
+            monthNamesShort: this.MONTH_NAMES_SHORT,
+            dayNames: this.DAY_NAMES,
+            dayNamesShort: this.DAY_NAMES.map((d) => d.slice(0, 3)),
+            isLunar: true,
+            monthsPerYear: 12,
+            epochYear: 1,
+        };
+    }
+    // ── Internal helpers ──────────────────────────────────────────────────
+    isLeapYear(year) {
+        return this.LEAP_YEARS_IN_CYCLE.has(((year - 1) % 30) + 1);
+    }
+    daysInMonth(year, month) {
+        if (month === 12 && this.isLeapYear(year))
+            return 30;
+        return month % 2 === 1 ? 30 : 29;
+    }
+    // ── Gregorian ↔ Hijri (Tabular algorithm from Meeus) ──────────────────
+    /**
+     * Convert Gregorian to Hijri (Tabular Islamic Calendar).
+     * Algorithm from "Astronomical Algorithms" by Jean Meeus.
+     */
+    gregorianToHijri(gy, gm, gd) {
+        // Step 1: Gregorian → JDN
+        const jdn = this.gregorianToJdn(gy, gm, gd);
+        // Step 2: JDN → Hijri
+        // L = JDN − 1948440 + 10632
+        const L = jdn - 1948440 + 10632;
+        // N = floor((L − 1) / 10631)
+        const N = Math.floor((L - 1) / 10631);
+        // L = L − 10631 × N + 354
+        const L2 = L - 10631 * N + 354;
+        // J = floor((10985 − L2) / 5316) × floor((50×L2) / 17719) + floor(L2 / 5670) × floor((43×L2) / 15238)
+        const J = Math.floor((10985 - L2) / 5316) * Math.floor((50 * L2) / 17719) +
+            Math.floor(L2 / 5670) * Math.floor((43 * L2) / 15238);
+        // L3 = L2 − floor((30 − J) / 15) × floor((17719 × J) / 50) − floor(J / 16) × floor((15238 × J) / 43) + 29
+        const L3 = L2 -
+            Math.floor((30 - J) / 15) * Math.floor((17719 * J) / 50) -
+            Math.floor(J / 16) * Math.floor((15238 * J) / 43) +
+            29;
+        const hm = Math.floor((24 * L3) / 709);
+        const hd = L3 - Math.floor((709 * hm) / 24);
+        const hy = 30 * N + J - 30;
+        return { hy, hm, hd };
+    }
+    /**
+     * Convert Hijri to Gregorian.
+     */
+    hijriToGregorian(hy, hm, hd) {
+        // Hijri → JDN
+        const jdn = Math.floor((11 * hy + 3) / 30) +
+            354 * hy +
+            30 * hm -
+            Math.floor((hm - 1) / 2) +
+            hd +
+            1948440 -
+            385;
+        // JDN → Gregorian
+        return this.jdnToGregorian(jdn);
+    }
+    // ── JDN helpers ───────────────────────────────────────────────────────
+    gregorianToJdn(gy, gm, gd) {
+        const a = Math.floor((14 - gm) / 12);
+        const y = gy + 4800 - a;
+        const m = gm + 12 * a - 3;
+        return (gd +
+            Math.floor((153 * m + 2) / 5) +
+            365 * y +
+            Math.floor(y / 4) -
+            Math.floor(y / 100) +
+            Math.floor(y / 400) -
+            32045);
+    }
+    jdnToGregorian(jdn) {
+        const a = jdn + 32044;
+        const b = Math.floor((4 * a + 3) / 146097);
+        const c = a - Math.floor((146097 * b) / 4);
+        const d = Math.floor((4 * c + 3) / 1461);
+        const e = c - Math.floor((1461 * d) / 4);
+        const m = Math.floor((5 * e + 2) / 153);
+        const gd = e - Math.floor((153 * m + 2) / 5) + 1;
+        const gm = m + 3 - 12 * Math.floor(m / 10);
+        const gy = 100 * b + d - 4800 + Math.floor(m / 10);
+        return { gy, gm, gd };
+    }
+}
+exports.HijriDriver = HijriDriver;
+//# sourceMappingURL=hijri.js.map

package/dist/drivers/hijri.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hijri.js","sourceRoot":"","sources":["../../src/drivers/hijri.ts"],"names":[],"mappings":"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"}

package/dist/drivers/holocene.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Holocene (Human Era) Calendar Driver
+ *
+ * Calendar characteristics:
+ * - Adds 10,000 to the Gregorian year (year 1 CE = 10,001 HE)
+ * - Same months, days, and leap year rules as Gregorian
+ * - Proposed by Cesare Emiliani in 1993 to encompass all of human history
+ * - Also called Human Era (HE) calendar
+ *
+ * This is a thin wrapper around GregorianDriver with a year offset.
+ */
+import { CalendarDriver, CalendarMetadata, TPSComponents } from "../index";
+export declare class HoloceneDriver implements CalendarDriver {
+    readonly code = "holo";
+    readonly name = "Holocene (Human Era)";
+    private readonly gregorian;
+    private readonly YEAR_OFFSET;
+    getComponentsFromDate(date: Date): Partial<TPSComponents>;
+    getDateFromComponents(components: Partial<TPSComponents>): Date;
+    getFromDate(date: Date): string;
+    parseDate(input: string, format?: string): Partial<TPSComponents>;
+    format(components: Partial<TPSComponents>, format?: string): string;
+    validate(input: string | Partial<TPSComponents>): boolean;
+    getMetadata(): CalendarMetadata;
+}

package/dist/drivers/holocene.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HoloceneDriver = void 0;
+/**
+ * Holocene (Human Era) Calendar Driver
+ *
+ * Calendar characteristics:
+ * - Adds 10,000 to the Gregorian year (year 1 CE = 10,001 HE)
+ * - Same months, days, and leap year rules as Gregorian
+ * - Proposed by Cesare Emiliani in 1993 to encompass all of human history
+ * - Also called Human Era (HE) calendar
+ *
+ * This is a thin wrapper around GregorianDriver with a year offset.
+ */
+const index_1 = require("../index");
+const gregorian_1 = require("./gregorian");
+class HoloceneDriver {
+    constructor() {
+        this.code = "holo";
+        this.name = "Holocene (Human Era)";
+        this.gregorian = new gregorian_1.GregorianDriver();
+        this.YEAR_OFFSET = 10000;
+    }
+    // ── CalendarDriver interface ──────────────────────────────────────────
+    getComponentsFromDate(date) {
+        const greg = this.gregorian.getComponentsFromDate(date);
+        const fullYear = date.getUTCFullYear() + this.YEAR_OFFSET;
+        return {
+            ...greg,
+            calendar: this.code,
+            millennium: Math.floor(fullYear / 1000) + 1,
+            century: Math.floor((fullYear % 1000) / 100) + 1,
+            year: fullYear % 100,
+        };
+    }
+    getDateFromComponents(components) {
+        const m = components.millennium ?? 0;
+        const c = components.century ?? 1;
+        const y = components.year ?? 0;
+        const holoYear = (m - 1) * 1000 + (c - 1) * 100 + y;
+        const gregYear = holoYear - this.YEAR_OFFSET;
+        return new Date(Date.UTC(gregYear, (components.month ?? 1) - 1, components.day ?? 1, components.hour ?? 0, components.minute ?? 0, Math.floor(components.second ?? 0), components.millisecond ??
+            Math.round(((components.second ?? 0) % 1) * 1000)));
+    }
+    getFromDate(date) {
+        const comp = this.getComponentsFromDate(date);
+        return index_1.TPS.buildTimePart(comp);
+    }
+    parseDate(input, format) {
+        // Accept ISO-like: "12026-01-09" (Holocene year)
+        const m = input
+            .trim()
+            .match(/^(\d{4,5})-(\d{2})-(\d{2})(?:[ T](\d{2}):(\d{2}):(\d{2})(?:\.(\d+))?)?$/);
+        if (!m) {
+            throw new Error(`HoloceneDriver.parseDate: unsupported format "${input}"`);
+        }
+        const result = {
+            calendar: this.code,
+            year: parseInt(m[1], 10),
+            month: parseInt(m[2], 10),
+            day: parseInt(m[3], 10),
+        };
+        if (m[4] !== undefined)
+            result.hour = parseInt(m[4], 10);
+        if (m[5] !== undefined)
+            result.minute = parseInt(m[5], 10);
+        if (m[6] !== undefined)
+            result.second = parseInt(m[6], 10);
+        if (m[7] !== undefined)
+            result.millisecond = parseInt((m[7] + "000").slice(0, 3), 10);
+        return result;
+    }
+    format(components, format) {
+        const pad = (n, w = 2) => String(n ?? 0).padStart(w, "0");
+        // Reconstruct full Holocene year from components
+        let holoYear;
+        if (components.millennium !== undefined) {
+            const m = components.millennium ?? 0;
+            const c = components.century ?? 1;
+            const y = components.year ?? 0;
+            holoYear = (m - 1) * 1000 + (c - 1) * 100 + y;
+        }
+        else {
+            holoYear = components.year ?? 0;
+        }
+        let out = `${String(holoYear).padStart(5, "0")}-${pad(components.month)}-${pad(components.day)}`;
+        if (components.hour !== undefined ||
+            components.minute !== undefined ||
+            components.second !== undefined) {
+            out += `T${pad(components.hour)}:${pad(components.minute)}:${pad(Math.floor(components.second ?? 0))}`;
+        }
+        return out;
+    }
+    validate(input) {
+        if (typeof input === "string") {
+            return /^\d{4,5}-\d{2}-\d{2}(?:[ T]\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?)?$/.test(input.trim());
+        }
+        if (typeof input === "object") {
+            // Delegate day/month validation to Gregorian (same structure)
+            return this.gregorian.validate({
+                year: input.year,
+                month: input.month,
+                day: input.day,
+            });
+        }
+        return false;
+    }
+    getMetadata() {
+        return {
+            name: "Holocene (Human Era)",
+            monthNames: [
+                "January",
+                "February",
+                "March",
+                "April",
+                "May",
+                "June",
+                "July",
+                "August",
+                "September",
+                "October",
+                "November",
+                "December",
+            ],
+            isLunar: false,
+            monthsPerYear: 12,
+            epochYear: -10000, // 10001 BCE
+        };
+    }
+}
+exports.HoloceneDriver = HoloceneDriver;
+//# sourceMappingURL=holocene.js.map