react-native-lich-am 1.0.0

package/lib/core/lunar.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * Chuyển đổi dương lịch ⇄ âm lịch (âm lịch Việt Nam, múi giờ UTC+7).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLunarMonthDays = exports.getLeapMonthOfYear = exports.lunarToSolar = exports.solarToLunar = void 0;
+const constants_1 = require("./constants");
+const astro_1 = require("./astro");
+/**
+ * Dương lịch → âm lịch.
+ *
+ * @example
+ * solarToLunar(10, 2, 2024) // Tết Giáp Thìn → { day: 1, month: 1, year: 2024, leap: false }
+ */
+function solarToLunar(day, month, year, timeZone = constants_1.TZ_VN) {
+    const dayNumber = (0, astro_1.jdFromDate)(day, month, year);
+    const k = (0, astro_1.int)((dayNumber - 2415021.076998695) / 29.530588853);
+    let monthStart = (0, astro_1.getNewMoonDay)(k + 1, timeZone);
+    if (monthStart > dayNumber) {
+        monthStart = (0, astro_1.getNewMoonDay)(k, timeZone);
+    }
+    let a11 = (0, astro_1.getLunarMonth11)(year, timeZone);
+    let b11 = a11;
+    let lunarYear;
+    if (a11 >= monthStart) {
+        lunarYear = year;
+        a11 = (0, astro_1.getLunarMonth11)(year - 1, timeZone);
+    }
+    else {
+        lunarYear = year + 1;
+        b11 = (0, astro_1.getLunarMonth11)(year + 1, timeZone);
+    }
+    const lunarDay = dayNumber - monthStart + 1;
+    const diff = (0, astro_1.int)((monthStart - a11) / 29);
+    let lunarLeap = false;
+    let lunarMonth = diff + 11;
+    if (b11 - a11 > 365) {
+        const leapMonthDiff = (0, astro_1.getLeapMonthOffset)(a11, timeZone);
+        if (diff >= leapMonthDiff) {
+            lunarMonth = diff + 10;
+            if (diff === leapMonthDiff) {
+                lunarLeap = true;
+            }
+        }
+    }
+    if (lunarMonth > 12) {
+        lunarMonth -= 12;
+    }
+    if (lunarMonth >= 11 && diff < 4) {
+        lunarYear -= 1;
+    }
+    return {
+        day: lunarDay,
+        month: lunarMonth,
+        year: lunarYear,
+        leap: lunarLeap,
+        jd: dayNumber,
+    };
+}
+exports.solarToLunar = solarToLunar;
+/**
+ * Âm lịch → dương lịch.
+ *
+ * @returns ngày dương lịch, hoặc `null` nếu tổ hợp âm lịch không tồn tại
+ *          (ví dụ yêu cầu tháng nhuận nhưng năm đó không có tháng nhuận đó).
+ */
+function lunarToSolar(day, month, year, leap = false, timeZone = constants_1.TZ_VN) {
+    let a11;
+    let b11;
+    if (month < 11) {
+        a11 = (0, astro_1.getLunarMonth11)(year - 1, timeZone);
+        b11 = (0, astro_1.getLunarMonth11)(year, timeZone);
+    }
+    else {
+        a11 = (0, astro_1.getLunarMonth11)(year, timeZone);
+        b11 = (0, astro_1.getLunarMonth11)(year + 1, timeZone);
+    }
+    let off = month - 11;
+    if (off < 0) {
+        off += 12;
+    }
+    if (b11 - a11 > 365) {
+        const leapOff = (0, astro_1.getLeapMonthOffset)(a11, timeZone);
+        let leapMonth = leapOff - 2;
+        if (leapMonth < 0) {
+            leapMonth += 12;
+        }
+        if (leap && month !== leapMonth) {
+            return null;
+        }
+        if (leap || off >= leapOff) {
+            off += 1;
+        }
+    }
+    const k = (0, astro_1.int)(0.5 + (a11 - 2415021.076998695) / 29.530588853);
+    const monthStart = (0, astro_1.getNewMoonDay)(k + off, timeZone);
+    const jd = monthStart + day - 1;
+    const [d, m, y] = (0, astro_1.jdToDate)(jd);
+    return { day: d, month: m, year: y, jd };
+}
+exports.lunarToSolar = lunarToSolar;
+/** Tháng âm `month` của năm âm `year` có phải tháng nhuận hay không */
+function getLeapMonthOfYear(year, timeZone = constants_1.TZ_VN) {
+    const a11 = (0, astro_1.getLunarMonth11)(year - 1, timeZone);
+    const b11 = (0, astro_1.getLunarMonth11)(year, timeZone);
+    if (b11 - a11 <= 365) {
+        return 0;
+    }
+    const leapOff = (0, astro_1.getLeapMonthOffset)(a11, timeZone);
+    let leapMonth = leapOff - 2;
+    if (leapMonth < 0) {
+        leapMonth += 12;
+    }
+    return leapMonth;
+}
+exports.getLeapMonthOfYear = getLeapMonthOfYear;
+/** Số ngày của một tháng âm (29 hoặc 30) */
+function getLunarMonthDays(month, year, leap = false, timeZone = constants_1.TZ_VN) {
+    const first = lunarToSolar(1, month, year, leap, timeZone);
+    if (!first) {
+        return 0;
+    }
+    const next = lunarToSolar(1, month === 12 ? 1 : month + 1, month === 12 ? year + 1 : year, false, timeZone);
+    if (!next) {
+        return 0;
+    }
+    const diff = next.jd - first.jd;
+    return diff > 0 && diff < 32 ? diff : 0;
+}
+exports.getLunarMonthDays = getLunarMonthDays;

package/lib/core/tietkhi.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Tiết khí (24 tiết) và "tháng tiết khí" (Kiến tháng) dùng cho Trực.
+ */
+/**
+ * Cung 15° của kinh độ mặt trời, giá trị 0..23. `arc * 15°` là kinh độ mặt trời; 0 = Xuân phân.
+ *
+ * Lấy tại **cuối ngày địa phương**, tức tiết khí đang hiệu lực lúc 24:00.
+ * Tiết khí được ấn định cho ngày mà thời điểm giao tiết rơi vào, chứ không phải
+ * theo vị trí mặt trời lúc 00:00 — nếu lấy mốc đầu ngày thì những tiết giao vào
+ * buổi sáng/tối sẽ bị lùi sang hôm sau (sai 96 ngày trên dữ liệu đối chiếu).
+ */
+export declare function getSunArc(jd: number, timeZone?: number): number;
+export interface TietKhi {
+    /** id 1..24, theo quy ước: 1 = Xuân phân, 19 = Đông chí */
+    id: number;
+    name: string;
+    /** Kinh độ mặt trời tại điểm bắt đầu tiết (độ) */
+    longitude: number;
+    /** Ngày dương lịch bắt đầu tiết này */
+    start: {
+        day: number;
+        month: number;
+        year: number;
+    };
+    /** JD của ngày bắt đầu tiết */
+    startJd: number;
+}
+/** Tiết khí của một ngày (theo JD) */
+export declare function getTietKhi(jd: number, timeZone?: number): TietKhi;
+/**
+ * Chi của "tháng tiết khí" (Kiến tháng) — dùng để tính Trực.
+ *
+ * Lập xuân → Dần, Kinh trập → Mão, Thanh minh → Thìn, …
+ * Trả về chỉ số địa chi 0..11 (0 = Tý).
+ */
+export declare function getTietKhiMonthChi(jd: number, timeZone?: number): number;
+/** Danh sách 24 tiết khí của một năm dương lịch, kèm ngày bắt đầu */
+export declare function getTietKhiOfYear(year: number, timeZone?: number): TietKhi[];
+/** JD của ngày sóc gần nhất trước hoặc bằng `jd` */
+export declare function getMonthStart(jd: number, timeZone?: number): number;

package/lib/core/tietkhi.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * Tiết khí (24 tiết) và "tháng tiết khí" (Kiến tháng) dùng cho Trực.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMonthStart = exports.getTietKhiOfYear = exports.getTietKhiMonthChi = exports.getTietKhi = exports.getSunArc = void 0;
+const constants_1 = require("./constants");
+const astro_1 = require("./astro");
+/**
+ * Cung 15° của kinh độ mặt trời, giá trị 0..23. `arc * 15°` là kinh độ mặt trời; 0 = Xuân phân.
+ *
+ * Lấy tại **cuối ngày địa phương**, tức tiết khí đang hiệu lực lúc 24:00.
+ * Tiết khí được ấn định cho ngày mà thời điểm giao tiết rơi vào, chứ không phải
+ * theo vị trí mặt trời lúc 00:00 — nếu lấy mốc đầu ngày thì những tiết giao vào
+ * buổi sáng/tối sẽ bị lùi sang hôm sau (sai 96 ngày trên dữ liệu đối chiếu).
+ */
+function getSunArc(jd, timeZone = constants_1.TZ_VN) {
+    const l = (0, astro_1.sunLongitude)(jd + 0.5 - timeZone / 24);
+    return (0, astro_1.int)((l / Math.PI) * 12);
+}
+exports.getSunArc = getSunArc;
+function arcToId(arc) {
+    const id = (arc + 1) % 24;
+    return id === 0 ? 24 : id;
+}
+function jdToYmd(jd) {
+    // tách riêng để tránh import vòng
+    let a;
+    let b;
+    let c;
+    if (jd > 2299160) {
+        a = jd + 32044;
+        b = (0, astro_1.int)((4 * a + 3) / 146097);
+        c = a - (0, astro_1.int)((b * 146097) / 4);
+    }
+    else {
+        b = 0;
+        c = jd + 32082;
+    }
+    const d = (0, astro_1.int)((4 * c + 3) / 1461);
+    const e = c - (0, astro_1.int)((1461 * d) / 4);
+    const m = (0, astro_1.int)((5 * e + 2) / 153);
+    return {
+        day: e - (0, astro_1.int)((153 * m + 2) / 5) + 1,
+        month: m + 3 - 12 * (0, astro_1.int)(m / 10),
+        year: b * 100 + d - 4800 + (0, astro_1.int)(m / 10),
+    };
+}
+/** Tiết khí của một ngày (theo JD) */
+function getTietKhi(jd, timeZone = constants_1.TZ_VN) {
+    const arc = getSunArc(jd, timeZone);
+    const id = arcToId(arc);
+    const meta = constants_1.TIET_KHI[id - 1];
+    // lùi về ngày bắt đầu tiết hiện tại
+    let startJd = jd;
+    while (getSunArc(startJd - 1, timeZone) === arc) {
+        startJd -= 1;
+    }
+    return {
+        id,
+        name: meta.name,
+        longitude: meta.lon,
+        startJd,
+        start: jdToYmd(startJd),
+    };
+}
+exports.getTietKhi = getTietKhi;
+/**
+ * Chi của "tháng tiết khí" (Kiến tháng) — dùng để tính Trực.
+ *
+ * Lập xuân → Dần, Kinh trập → Mão, Thanh minh → Thìn, …
+ * Trả về chỉ số địa chi 0..11 (0 = Tý).
+ */
+function getTietKhiMonthChi(jd, timeZone = constants_1.TZ_VN) {
+    const arc = getSunArc(jd, timeZone);
+    return (((arc + 1) >> 1) + 3) % 12;
+}
+exports.getTietKhiMonthChi = getTietKhiMonthChi;
+/** Danh sách 24 tiết khí của một năm dương lịch, kèm ngày bắt đầu */
+function getTietKhiOfYear(year, timeZone = constants_1.TZ_VN) {
+    const out = [];
+    const jdStart = (() => {
+        // 01/01 dương lịch
+        const a = (0, astro_1.int)((14 - 1) / 12);
+        const y = year + 4800 - a;
+        const m = 1 + 12 * a - 3;
+        return 1 + (0, astro_1.int)((153 * m + 2) / 5) + 365 * y + (0, astro_1.int)(y / 4) - (0, astro_1.int)(y / 100) + (0, astro_1.int)(y / 400) - 32045;
+    })();
+    let jd = jdStart;
+    let lastId = -1;
+    while (true) {
+        const tk = getTietKhi(jd, timeZone);
+        const ymd = jdToYmd(jd);
+        if (ymd.year > year) {
+            break;
+        }
+        if (tk.id !== lastId) {
+            out.push(tk);
+            lastId = tk.id;
+        }
+        jd += 1;
+    }
+    return out;
+}
+exports.getTietKhiOfYear = getTietKhiOfYear;
+/** JD của ngày sóc gần nhất trước hoặc bằng `jd` */
+function getMonthStart(jd, timeZone = constants_1.TZ_VN) {
+    const k = (0, astro_1.int)((jd - 2415021.076998695) / 29.530588853);
+    let start = (0, astro_1.getNewMoonDay)(k + 1, timeZone);
+    if (start > jd) {
+        start = (0, astro_1.getNewMoonDay)(k, timeZone);
+    }
+    return start;
+}
+exports.getMonthStart = getMonthStart;

package/lib/core/truc.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Trực (Thập nhị kiến trừ) và 12 giờ hoàng đạo.
+ *
+ * Quy luật Trực đã được kiểm chứng khớp 1.462/1.462 ngày dữ liệu Lịch Việt:
+ * Trực = (chi ngày − chi tháng tiết khí) mod 12, tra vào 12 Trực bắt đầu từ Kiến.
+ *
+ * Bảng giờ hoàng đạo sinh từ công thức `(2 × chi ngày + 8) mod 12`
+ * khớp đúng bảng cổ điển (Tý–Ngọ: Tý Sửu Mão Ngọ Thân Dậu; …).
+ */
+export interface TrucInfo {
+    /** Chỉ số 0..11, 0 = Kiến */
+    index: number;
+    /** Tên Trực */
+    name: string;
+    /** Chi tháng tiết khí dùng để tính */
+    monthChiIndex: number;
+    /** Chi ngày */
+    dayChiIndex: number;
+}
+/** Trực của ngày */
+export declare function getTruc(jd: number, dayChiIndex: number, timeZone?: number): TrucInfo;
+export interface GioInfo {
+    /** Chỉ số địa chi của giờ, 0 = Tý */
+    index: number;
+    /** Tên chi, ví dụ "Tý" */
+    chi: string;
+    /** Khung giờ thực, ví dụ "23:00 – 00:59" */
+    range: string;
+    /** Giờ bắt đầu (0..23) */
+    startHour: number;
+    /** Giờ kết thúc (0..23) */
+    endHour: number;
+    /** Thần cai quản giờ này */
+    than: string;
+    /** Có phải giờ hoàng đạo (giờ tốt) */
+    hoangDao: boolean;
+}
+/** Vị trí thần hoàng đạo tại giờ Tý, suy từ chi ngày */
+export declare function getThanOffset(dayChiIndex: number): number;
+/** Thần cai quản một giờ */
+export declare function getThanOfHour(dayChiIndex: number, hourIndex: number): string;
+/** Có phải giờ hoàng đạo hay không */
+export declare function isHoangDaoHour(dayChiIndex: number, hourIndex: number): boolean;
+/** Đầy đủ 12 khung giờ trong ngày kèm thông tin hoàng đạo */
+export declare function getGioInDay(dayChiIndex: number): GioInfo[];
+/** Danh sách chỉ số 6 giờ hoàng đạo trong ngày */
+export declare function getHoangDaoHours(dayChiIndex: number): number[];

package/lib/core/truc.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Trực (Thập nhị kiến trừ) và 12 giờ hoàng đạo.
+ *
+ * Quy luật Trực đã được kiểm chứng khớp 1.462/1.462 ngày dữ liệu Lịch Việt:
+ * Trực = (chi ngày − chi tháng tiết khí) mod 12, tra vào 12 Trực bắt đầu từ Kiến.
+ *
+ * Bảng giờ hoàng đạo sinh từ công thức `(2 × chi ngày + 8) mod 12`
+ * khớp đúng bảng cổ điển (Tý–Ngọ: Tý Sửu Mão Ngọ Thân Dậu; …).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHoangDaoHours = exports.getGioInDay = exports.isHoangDaoHour = exports.getThanOfHour = exports.getThanOffset = exports.getTruc = void 0;
+const constants_1 = require("./constants");
+const tietkhi_1 = require("./tietkhi");
+/** Trực của ngày */
+function getTruc(jd, dayChiIndex, timeZone = constants_1.TZ_VN) {
+    const monthChiIndex = (0, tietkhi_1.getTietKhiMonthChi)(jd, timeZone);
+    const index = (((dayChiIndex - monthChiIndex) % 12) + 12) % 12;
+    return { index, name: constants_1.TRUC[index], monthChiIndex, dayChiIndex };
+}
+exports.getTruc = getTruc;
+const GIO_LABEL = [
+    '23:00 – 00:59', '01:00 – 02:59', '03:00 – 04:59', '05:00 – 06:59',
+    '07:00 – 08:59', '09:00 – 10:59', '11:00 – 12:59', '13:00 – 14:59',
+    '15:00 – 16:59', '17:00 – 18:59', '19:00 – 20:59', '21:00 – 22:59',
+];
+const GIO_START = [23, 1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21];
+/** Vị trí thần hoàng đạo tại giờ Tý, suy từ chi ngày */
+function getThanOffset(dayChiIndex) {
+    return (((2 * dayChiIndex + 8) % 12) + 12) % 12;
+}
+exports.getThanOffset = getThanOffset;
+/** Thần cai quản một giờ */
+function getThanOfHour(dayChiIndex, hourIndex) {
+    const offset = getThanOffset(dayChiIndex);
+    const idx = (((hourIndex - offset) % 12) + 12) % 12;
+    return constants_1.THAN_12[idx];
+}
+exports.getThanOfHour = getThanOfHour;
+/** Có phải giờ hoàng đạo hay không */
+function isHoangDaoHour(dayChiIndex, hourIndex) {
+    const offset = getThanOffset(dayChiIndex);
+    const idx = (((hourIndex - offset) % 12) + 12) % 12;
+    return constants_1.THAN_12_TOT.indexOf(idx) >= 0;
+}
+exports.isHoangDaoHour = isHoangDaoHour;
+/** Đầy đủ 12 khung giờ trong ngày kèm thông tin hoàng đạo */
+function getGioInDay(dayChiIndex) {
+    return GIO_LABEL.map((range, i) => ({
+        index: i,
+        chi: constants_1.CHI[i],
+        range,
+        startHour: GIO_START[i],
+        endHour: (GIO_START[i] + 1) % 24,
+        than: getThanOfHour(dayChiIndex, i),
+        hoangDao: isHoangDaoHour(dayChiIndex, i),
+    }));
+}
+exports.getGioInDay = getGioInDay;
+/** Danh sách chỉ số 6 giờ hoàng đạo trong ngày */
+function getHoangDaoHours(dayChiIndex) {
+    const out = [];
+    for (let i = 0; i < 12; i += 1) {
+        if (isHoangDaoHour(dayChiIndex, i)) {
+            out.push(i);
+        }
+    }
+    return out;
+}
+exports.getHoangDaoHours = getHoangDaoHours;

package/lib/core/types.d.ts

@@ -0,0 +1,66 @@
+/** Kiểu dữ liệu dùng chung */
+import type { CanChi, NapAm } from './canchi';
+import type { GioInfo, TrucInfo } from './truc';
+import type { HuongXuatHanh } from './huong';
+import type { TietKhi } from './tietkhi';
+import type { LunarDate } from './lunar';
+/** Ngày dương lịch */
+export interface SolarDateInfo {
+    day: number;
+    month: number;
+    year: number;
+    /** 0 = Chủ nhật … 6 = Thứ bảy */
+    weekday: number;
+    /** "Chủ nhật" … */
+    weekdayName: string;
+    /** "2024-02-10" */
+    iso: string;
+}
+/** Ngày âm lịch kèm tên tháng */
+export interface LunarDateInfo extends LunarDate {
+    /** "tháng Giêng", "tháng Chạp" */
+    monthName: string;
+    /** "tháng Sáu nhuận" nếu là tháng nhuận */
+    monthNameFull: string;
+    /** "20/11/2023" */
+    text: string;
+    /** "Quý Mão" — chỉ có khi đi kèm can chi năm */
+    canChiYearName?: string;
+}
+/** Thông tin đầy đủ của một ngày */
+export interface LunarDayInfo {
+    jd: number;
+    solar: SolarDateInfo;
+    lunar: LunarDateInfo;
+    canChi: {
+        year: CanChi;
+        month: CanChi;
+        day: CanChi;
+    };
+    /** Con giáp của năm âm, ví dụ "Rồng" */
+    conGiap: string;
+    /** Nạp âm (ngũ hành) của năm / tháng / ngày */
+    napAm: {
+        year: NapAm;
+        month: NapAm;
+        day: NapAm;
+    };
+    /** Ngũ hành của ngày, dạng chữ: Kim | Mộc | Thủy | Hỏa | Thổ */
+    nguHanh: string;
+    /** Ngũ hành của ngày, dạng số đúng quy ước Lịch Việt: 1=Kim 2=Mộc 3=Thủy 4=Hỏa 5=Thổ */
+    nguHanhId: number;
+    tietKhi: TietKhi;
+    truc: TrucInfo;
+    /** Đủ 12 khung giờ trong ngày */
+    gio: GioInfo[];
+    /** Chỉ 6 giờ hoàng đạo */
+    gioHoangDao: GioInfo[];
+    /** Hướng xuất hành (Hỷ thần / Tài thần / Hạc thần) */
+    huongXuatHanh: HuongXuatHanh;
+}
+/** Ngày có thể truyền vào API */
+export type DateInput = Date | string | number | {
+    day: number;
+    month: number;
+    year: number;
+};

package/lib/core/types.js

@@ -0,0 +1,3 @@
+"use strict";
+/** Kiểu dữ liệu dùng chung */
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/dataset/2024.d.ts

@@ -0,0 +1,30 @@
+/**
+ * react-native-lich-am / dataset/2024
+ *
+ * Chỉ nạp dữ liệu năm 2024 — nhẹ hơn hẳn so với entry `dataset` (nạp cả 5 năm).
+ */
+import { type ChatLuong, type FindGoodDaysOptions, type LichVietDay } from './decode';
+export * from './decode';
+/** Năm của bộ dữ liệu này */
+export declare const YEAR = 2024;
+/** Các năm có dữ liệu trong entry point này */
+export declare const AVAILABLE_YEARS: number[];
+/** Có dữ liệu chi tiết cho ngày này hay không (chuỗi "YYYY-MM-DD") */
+export declare function hasDayData(date: string): boolean;
+/** Lấy thông tin chi tiết một ngày theo chuỗi "YYYY-MM-DD" */
+export declare function getDayData(date: string): LichVietDay | null;
+/** Lấy theo ngày/tháng/năm dương */
+export declare function getDayDataBySolar(day: number, month: number, year: number): LichVietDay | null;
+/** Toàn bộ ngày có dữ liệu, dạng "YYYY-MM-DD", đã sắp xếp */
+export declare function listDayKeys(): string[];
+/** Toàn bộ ngày đã giải mã */
+export declare function listDays(): LichVietDay[];
+/** Tìm ngày phù hợp cho một việc */
+export declare function findGoodDays(options: FindGoodDaysOptions): LichVietDay[];
+/** Ngày đẹp nhất trong một khoảng */
+export declare function topDays(from?: string, to?: string, limit?: number): LichVietDay[];
+/** Thống kê chất lượng ngày trong một khoảng */
+export declare function getQualityStats(from?: string, to?: string): Record<ChatLuong, number> & {
+    total: number;
+    avgDiem: number;
+};

package/lib/dataset/2024.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * react-native-lich-am / dataset/2024
+ *
+ * Chỉ nạp dữ liệu năm 2024 — nhẹ hơn hẳn so với entry `dataset` (nạp cả 5 năm).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getQualityStats = exports.topDays = exports.findGoodDays = exports.listDays = exports.listDayKeys = exports.getDayDataBySolar = exports.getDayData = exports.hasDayData = exports.AVAILABLE_YEARS = exports.YEAR = void 0;
+const decode_1 = require("./decode");
+__exportStar(require("./decode"), exports);
+const store = (0, decode_1.createStore)([require('./data/days-2024.json')]);
+/** Năm của bộ dữ liệu này */
+exports.YEAR = 2024;
+/** Các năm có dữ liệu trong entry point này */
+exports.AVAILABLE_YEARS = [2024];
+/** Có dữ liệu chi tiết cho ngày này hay không (chuỗi "YYYY-MM-DD") */
+function hasDayData(date) {
+    return store.has(date);
+}
+exports.hasDayData = hasDayData;
+/** Lấy thông tin chi tiết một ngày theo chuỗi "YYYY-MM-DD" */
+function getDayData(date) {
+    return store.lookup(date);
+}
+exports.getDayData = getDayData;
+/** Lấy theo ngày/tháng/năm dương */
+function getDayDataBySolar(day, month, year) {
+    return store.lookup((0, decode_1.toIso)(year, month, day));
+}
+exports.getDayDataBySolar = getDayDataBySolar;
+/** Toàn bộ ngày có dữ liệu, dạng "YYYY-MM-DD", đã sắp xếp */
+function listDayKeys() {
+    return store.keys;
+}
+exports.listDayKeys = listDayKeys;
+/** Toàn bộ ngày đã giải mã */
+function listDays() {
+    return store.all();
+}
+exports.listDays = listDays;
+/** Tìm ngày phù hợp cho một việc */
+function findGoodDays(options) {
+    return (0, decode_1.findGoodDaysIn)(store.keys, store.lookup, options);
+}
+exports.findGoodDays = findGoodDays;
+/** Ngày đẹp nhất trong một khoảng */
+function topDays(from, to, limit = 10) {
+    return (0, decode_1.topDaysIn)(store.keys, store.lookup, from, to, limit);
+}
+exports.topDays = topDays;
+/** Thống kê chất lượng ngày trong một khoảng */
+function getQualityStats(from, to) {
+    return (0, decode_1.qualityStatsIn)(store.keys, store.lookup, from, to);
+}
+exports.getQualityStats = getQualityStats;

package/lib/dataset/2025.d.ts

@@ -0,0 +1,30 @@
+/**
+ * react-native-lich-am / dataset/2025
+ *
+ * Chỉ nạp dữ liệu năm 2025 — nhẹ hơn hẳn so với entry `dataset` (nạp cả 5 năm).
+ */
+import { type ChatLuong, type FindGoodDaysOptions, type LichVietDay } from './decode';
+export * from './decode';
+/** Năm của bộ dữ liệu này */
+export declare const YEAR = 2025;
+/** Các năm có dữ liệu trong entry point này */
+export declare const AVAILABLE_YEARS: number[];
+/** Có dữ liệu chi tiết cho ngày này hay không (chuỗi "YYYY-MM-DD") */
+export declare function hasDayData(date: string): boolean;
+/** Lấy thông tin chi tiết một ngày theo chuỗi "YYYY-MM-DD" */
+export declare function getDayData(date: string): LichVietDay | null;
+/** Lấy theo ngày/tháng/năm dương */
+export declare function getDayDataBySolar(day: number, month: number, year: number): LichVietDay | null;
+/** Toàn bộ ngày có dữ liệu, dạng "YYYY-MM-DD", đã sắp xếp */
+export declare function listDayKeys(): string[];
+/** Toàn bộ ngày đã giải mã */
+export declare function listDays(): LichVietDay[];
+/** Tìm ngày phù hợp cho một việc */
+export declare function findGoodDays(options: FindGoodDaysOptions): LichVietDay[];
+/** Ngày đẹp nhất trong một khoảng */
+export declare function topDays(from?: string, to?: string, limit?: number): LichVietDay[];
+/** Thống kê chất lượng ngày trong một khoảng */
+export declare function getQualityStats(from?: string, to?: string): Record<ChatLuong, number> & {
+    total: number;
+    avgDiem: number;
+};

package/lib/dataset/2025.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * react-native-lich-am / dataset/2025
+ *
+ * Chỉ nạp dữ liệu năm 2025 — nhẹ hơn hẳn so với entry `dataset` (nạp cả 5 năm).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getQualityStats = exports.topDays = exports.findGoodDays = exports.listDays = exports.listDayKeys = exports.getDayDataBySolar = exports.getDayData = exports.hasDayData = exports.AVAILABLE_YEARS = exports.YEAR = void 0;
+const decode_1 = require("./decode");
+__exportStar(require("./decode"), exports);
+const store = (0, decode_1.createStore)([require('./data/days-2025.json')]);
+/** Năm của bộ dữ liệu này */
+exports.YEAR = 2025;
+/** Các năm có dữ liệu trong entry point này */
+exports.AVAILABLE_YEARS = [2025];
+/** Có dữ liệu chi tiết cho ngày này hay không (chuỗi "YYYY-MM-DD") */
+function hasDayData(date) {
+    return store.has(date);
+}
+exports.hasDayData = hasDayData;
+/** Lấy thông tin chi tiết một ngày theo chuỗi "YYYY-MM-DD" */
+function getDayData(date) {
+    return store.lookup(date);
+}
+exports.getDayData = getDayData;
+/** Lấy theo ngày/tháng/năm dương */
+function getDayDataBySolar(day, month, year) {
+    return store.lookup((0, decode_1.toIso)(year, month, day));
+}
+exports.getDayDataBySolar = getDayDataBySolar;
+/** Toàn bộ ngày có dữ liệu, dạng "YYYY-MM-DD", đã sắp xếp */
+function listDayKeys() {
+    return store.keys;
+}
+exports.listDayKeys = listDayKeys;
+/** Toàn bộ ngày đã giải mã */
+function listDays() {
+    return store.all();
+}
+exports.listDays = listDays;
+/** Tìm ngày phù hợp cho một việc */
+function findGoodDays(options) {
+    return (0, decode_1.findGoodDaysIn)(store.keys, store.lookup, options);
+}
+exports.findGoodDays = findGoodDays;
+/** Ngày đẹp nhất trong một khoảng */
+function topDays(from, to, limit = 10) {
+    return (0, decode_1.topDaysIn)(store.keys, store.lookup, from, to, limit);
+}
+exports.topDays = topDays;
+/** Thống kê chất lượng ngày trong một khoảng */
+function getQualityStats(from, to) {
+    return (0, decode_1.qualityStatsIn)(store.keys, store.lookup, from, to);
+}
+exports.getQualityStats = getQualityStats;