react-native-lich-am 1.0.0

package/lib/core/canchi.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Can Chi: năm, tháng, ngày, giờ — kèm Nạp Âm (ngũ hành) và con giáp.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConGiap = exports.getNguHanhId = exports.getNapAm = exports.getCanChiHour = exports.getCanChiMonth = exports.getCanChiDay = exports.getCanChiYear = exports.canChiIndex = void 0;
+const constants_1 = require("./constants");
+function build(canIndex, chiIndex) {
+    const c = ((canIndex % 10) + 10) % 10;
+    const z = ((chiIndex % 12) + 12) % 12;
+    return { canIndex: c, chiIndex: z, can: constants_1.CAN[c], chi: constants_1.CHI[z], name: `${constants_1.CAN[c]} ${constants_1.CHI[z]}` };
+}
+/** Chỉ số 0–59 trong vòng 60 hoa giáp, từ cặp (can, chi) */
+function canChiIndex(canIndex, chiIndex) {
+    const c = ((canIndex % 10) + 10) % 10;
+    const z = ((chiIndex % 12) + 12) % 12;
+    for (let i = 0; i < 60; i += 1) {
+        if (i % 10 === c && i % 12 === z) {
+            return i;
+        }
+    }
+    return 0;
+}
+exports.canChiIndex = canChiIndex;
+/** Can Chi của năm âm lịch */
+function getCanChiYear(lunarYear) {
+    return build(lunarYear - 4, lunarYear - 4);
+}
+exports.getCanChiYear = getCanChiYear;
+/** Can Chi của ngày, suy từ số ngày Julian */
+function getCanChiDay(jd) {
+    const idx = (((jd + 49) % 60) + 60) % 60;
+    return build(idx % 10, idx % 12);
+}
+exports.getCanChiDay = getCanChiDay;
+/**
+ * Can Chi của tháng âm lịch (theo Ngũ Hổ Độn).
+ *
+ * Tháng 1 (Dần) của năm Giáp/Kỷ là Bính Dần, Ất/Canh là Mậu Dần,
+ * Bính/Tân là Canh Dần, Đinh/Nhâm là Nhâm Dần, Mậu/Quý là Giáp Dần.
+ */
+function getCanChiMonth(lunarMonth, lunarYear) {
+    const yearCan = (((lunarYear - 4) % 10) + 10) % 10;
+    const canThang1 = (yearCan % 5) * 2 + 2; // can của tháng Dần
+    const offset = lunarMonth - 1;
+    return build(canThang1 + offset, 2 + offset);
+}
+exports.getCanChiMonth = getCanChiMonth;
+/**
+ * Can Chi của giờ (theo Ngũ Thử Độn).
+ *
+ * @param dayCanIndex chỉ số can của ngày (0 = Giáp)
+ * @param hourChiIndex chỉ số chi của giờ (0 = Tý)
+ */
+function getCanChiHour(dayCanIndex, hourChiIndex) {
+    const can = (((dayCanIndex % 5) * 2 + hourChiIndex) % 10 + 10) % 10;
+    return build(can, hourChiIndex);
+}
+exports.getCanChiHour = getCanChiHour;
+/** Nạp âm của một cặp can chi */
+function getNapAm(canIndex, chiIndex) {
+    const idx = canChiIndex(canIndex, chiIndex);
+    const [name, element] = constants_1.NAP_AM[idx];
+    return { name, element };
+}
+exports.getNapAm = getNapAm;
+/** Ngũ hành của nạp âm ngày (dạng số 1..5 đúng quy ước Lịch Việt) */
+function getNguHanhId(element) {
+    const i = constants_1.NGU_HANH.indexOf(element);
+    return i > 0 ? i : 0;
+}
+exports.getNguHanhId = getNguHanhId;
+/** Con giáp của năm âm lịch */
+function getConGiap(lunarYear) {
+    const chi = (((lunarYear - 4) % 12) + 12) % 12;
+    return constants_1.CON_GIAP[chi];
+}
+exports.getConGiap = getConGiap;

package/lib/core/constants.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Hằng số dùng chung cho toàn bộ thư viện.
+ * Toàn bộ tên gọi theo tiếng Việt, đúng cách gọi trong lịch vạn niên.
+ */
+/** 10 Thiên Can */
+export declare const CAN: readonly ["Giáp", "Ất", "Bính", "Đinh", "Mậu", "Kỷ", "Canh", "Tân", "Nhâm", "Quý"];
+/** 12 Địa Chi */
+export declare const CHI: readonly ["Tý", "Sửu", "Dần", "Mão", "Thìn", "Tỵ", "Ngọ", "Mùi", "Thân", "Dậu", "Tuất", "Hợi"];
+/** 12 con giáp (theo chi của năm) */
+export declare const CON_GIAP: readonly ["Chuột", "Trâu", "Hổ", "Mèo", "Rồng", "Rắn", "Ngựa", "Dê", "Khỉ", "Gà", "Chó", "Lợn"];
+/** Ngũ hành theo đúng thứ tự id mà Lịch Việt dùng: 1=Kim 2=Mộc 3=Thủy 4=Hỏa 5=Thổ */
+export declare const NGU_HANH: readonly ["", "Kim", "Mộc", "Thủy", "Hỏa", "Thổ"];
+/** 12 Trực (Thập nhị kiến trừ), bắt đầu từ Kiến */
+export declare const TRUC: readonly ["Kiến", "Trừ", "Mãn", "Bình", "Định", "Chấp", "Phá", "Nguy", "Thành", "Thu", "Khai", "Bế"];
+/**
+ * 12 thần (Lục hoàng đạo / Lục hắc đạo) theo đúng thứ tự vòng.
+ * Chỉ số 0,1,4,5,7,10 là 6 thần TỐT (hoàng đạo).
+ */
+export declare const THAN_12: readonly ["Thanh long", "Minh đường", "Thiên hình", "Chu tước", "Kim quỹ", "Bảo quang", "Bạch hổ", "Ngọc đường", "Thiên lao", "Huyền vũ", "Tư mệnh", "Câu trần"];
+/** Vị trí (index) của 6 thần hoàng đạo trong vòng 12 thần */
+export declare const THAN_12_TOT: readonly [0, 1, 4, 5, 7, 10];
+/** 12 giờ theo địa chi: giờ Tý = 23h–01h */
+export declare const GIO_CHI: readonly ["Tý", "Sửu", "Dần", "Mão", "Thìn", "Tỵ", "Ngọ", "Mùi", "Thân", "Dậu", "Tuất", "Hợi"];
+/** Khung giờ thực tế của từng địa chi (giờ Tý bắt đầu 23:00 hôm trước) */
+export declare const GIO_RANGE: ReadonlyArray<readonly [number, number]>;
+/**
+ * 24 Tiết khí, đánh số id theo đúng quy ước của Lịch Việt:
+ * id 1 = Xuân phân … id 19 = Đông chí … id 24 = Kinh trập.
+ * `lon` là kinh độ mặt trời (độ) tại thời điểm bắt đầu tiết.
+ */
+export declare const TIET_KHI: ReadonlyArray<{
+    id: number;
+    name: string;
+    lon: number;
+}>;
+/** Tên tháng âm lịch */
+export declare const TEN_THANG_AM: readonly ["", "Giêng", "Hai", "Ba", "Tư", "Năm", "Sáu", "Bảy", "Tám", "Chín", "Mười", "Một", "Chạp"];
+/** Tên tháng âm lịch viết đầy đủ (dạng "tháng Giêng", "tháng Chạp") */
+export declare const TEN_THANG_AM_FULL: readonly ["", "tháng Giêng", "tháng Hai", "tháng Ba", "tháng Tư", "tháng Năm", "tháng Sáu", "tháng Bảy", "tháng Tám", "tháng Chín", "tháng Mười", "tháng Một", "tháng Chạp"];
+/** Thứ trong tuần, bắt đầu từ Chủ nhật để khớp `Date.getDay()` */
+export declare const THU: readonly ["Chủ nhật", "Thứ hai", "Thứ ba", "Thứ tư", "Thứ năm", "Thứ sáu", "Thứ bảy"];
+/** Thứ viết tắt */
+export declare const THU_NGAN: readonly ["CN", "T2", "T3", "T4", "T5", "T6", "T7"];
+/**
+ * Bảng Nạp Âm 60 hoa giáp: index 0..59 ứng với Giáp Tý … Quý Hợi.
+ * Mỗi phần tử là [tên nạp âm, ngũ hành].
+ */
+export declare const NAP_AM: ReadonlyArray<readonly [string, string]>;
+/** 8 hướng chính dùng cho xuất hành */
+export declare const HUONG_8: readonly ["Chính Bắc", "Đông Bắc", "Chính Đông", "Đông Nam", "Chính Nam", "Tây Nam", "Chính Tây", "Tây Bắc"];
+/** Múi giờ mặc định của lịch Việt Nam */
+export declare const TZ_VN = 7;
+/** JD của ngày 1970-01-01 (dùng để quy đổi JD <-> timestamp) */
+export declare const JD_UNIX_EPOCH = 2440587.5;

package/lib/core/constants.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * Hằng số dùng chung cho toàn bộ thư viện.
+ * Toàn bộ tên gọi theo tiếng Việt, đúng cách gọi trong lịch vạn niên.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JD_UNIX_EPOCH = exports.TZ_VN = exports.HUONG_8 = exports.NAP_AM = exports.THU_NGAN = exports.THU = exports.TEN_THANG_AM_FULL = exports.TEN_THANG_AM = exports.TIET_KHI = exports.GIO_RANGE = exports.GIO_CHI = exports.THAN_12_TOT = exports.THAN_12 = exports.TRUC = exports.NGU_HANH = exports.CON_GIAP = exports.CHI = exports.CAN = void 0;
+/** 10 Thiên Can */
+exports.CAN = [
+    'Giáp', 'Ất', 'Bính', 'Đinh', 'Mậu',
+    'Kỷ', 'Canh', 'Tân', 'Nhâm', 'Quý',
+];
+/** 12 Địa Chi */
+exports.CHI = [
+    'Tý', 'Sửu', 'Dần', 'Mão', 'Thìn', 'Tỵ',
+    'Ngọ', 'Mùi', 'Thân', 'Dậu', 'Tuất', 'Hợi',
+];
+/** 12 con giáp (theo chi của năm) */
+exports.CON_GIAP = [
+    'Chuột', 'Trâu', 'Hổ', 'Mèo', 'Rồng', 'Rắn',
+    'Ngựa', 'Dê', 'Khỉ', 'Gà', 'Chó', 'Lợn',
+];
+/** Ngũ hành theo đúng thứ tự id mà Lịch Việt dùng: 1=Kim 2=Mộc 3=Thủy 4=Hỏa 5=Thổ */
+exports.NGU_HANH = ['', 'Kim', 'Mộc', 'Thủy', 'Hỏa', 'Thổ'];
+/** 12 Trực (Thập nhị kiến trừ), bắt đầu từ Kiến */
+exports.TRUC = [
+    'Kiến', 'Trừ', 'Mãn', 'Bình', 'Định', 'Chấp',
+    'Phá', 'Nguy', 'Thành', 'Thu', 'Khai', 'Bế',
+];
+/**
+ * 12 thần (Lục hoàng đạo / Lục hắc đạo) theo đúng thứ tự vòng.
+ * Chỉ số 0,1,4,5,7,10 là 6 thần TỐT (hoàng đạo).
+ */
+exports.THAN_12 = [
+    'Thanh long', 'Minh đường', 'Thiên hình', 'Chu tước',
+    'Kim quỹ', 'Bảo quang', 'Bạch hổ', 'Ngọc đường',
+    'Thiên lao', 'Huyền vũ', 'Tư mệnh', 'Câu trần',
+];
+/** Vị trí (index) của 6 thần hoàng đạo trong vòng 12 thần */
+exports.THAN_12_TOT = [0, 1, 4, 5, 7, 10];
+/** 12 giờ theo địa chi: giờ Tý = 23h–01h */
+exports.GIO_CHI = exports.CHI;
+/** Khung giờ thực tế của từng địa chi (giờ Tý bắt đầu 23:00 hôm trước) */
+exports.GIO_RANGE = [
+    [23, 1], [1, 3], [3, 5], [5, 7], [7, 9], [9, 11],
+    [11, 13], [13, 15], [15, 17], [17, 19], [19, 21], [21, 23],
+];
+/**
+ * 24 Tiết khí, đánh số id theo đúng quy ước của Lịch Việt:
+ * id 1 = Xuân phân … id 19 = Đông chí … id 24 = Kinh trập.
+ * `lon` là kinh độ mặt trời (độ) tại thời điểm bắt đầu tiết.
+ */
+exports.TIET_KHI = [
+    { id: 1, name: 'Xuân phân', lon: 0 },
+    { id: 2, name: 'Thanh minh', lon: 15 },
+    { id: 3, name: 'Cốc vũ', lon: 30 },
+    { id: 4, name: 'Lập hạ', lon: 45 },
+    { id: 5, name: 'Tiểu mãn', lon: 60 },
+    { id: 6, name: 'Mang chủng', lon: 75 },
+    { id: 7, name: 'Hạ chí', lon: 90 },
+    { id: 8, name: 'Tiểu thử', lon: 105 },
+    { id: 9, name: 'Đại thử', lon: 120 },
+    { id: 10, name: 'Lập thu', lon: 135 },
+    { id: 11, name: 'Xử thử', lon: 150 },
+    { id: 12, name: 'Bạch lộ', lon: 165 },
+    { id: 13, name: 'Thu phân', lon: 180 },
+    { id: 14, name: 'Hàn lộ', lon: 195 },
+    { id: 15, name: 'Sương giáng', lon: 210 },
+    { id: 16, name: 'Lập đông', lon: 225 },
+    { id: 17, name: 'Tiểu tuyết', lon: 240 },
+    { id: 18, name: 'Đại tuyết', lon: 255 },
+    { id: 19, name: 'Đông chí', lon: 270 },
+    { id: 20, name: 'Tiểu hàn', lon: 285 },
+    { id: 21, name: 'Đại hàn', lon: 300 },
+    { id: 22, name: 'Lập xuân', lon: 315 },
+    { id: 23, name: 'Vũ thủy', lon: 330 },
+    { id: 24, name: 'Kinh trập', lon: 345 },
+];
+/** Tên tháng âm lịch */
+exports.TEN_THANG_AM = [
+    '', 'Giêng', 'Hai', 'Ba', 'Tư', 'Năm', 'Sáu',
+    'Bảy', 'Tám', 'Chín', 'Mười', 'Một', 'Chạp',
+];
+/** Tên tháng âm lịch viết đầy đủ (dạng "tháng Giêng", "tháng Chạp") */
+exports.TEN_THANG_AM_FULL = [
+    '', 'tháng Giêng', 'tháng Hai', 'tháng Ba', 'tháng Tư', 'tháng Năm',
+    'tháng Sáu', 'tháng Bảy', 'tháng Tám', 'tháng Chín', 'tháng Mười',
+    'tháng Một', 'tháng Chạp',
+];
+/** Thứ trong tuần, bắt đầu từ Chủ nhật để khớp `Date.getDay()` */
+exports.THU = [
+    'Chủ nhật', 'Thứ hai', 'Thứ ba', 'Thứ tư',
+    'Thứ năm', 'Thứ sáu', 'Thứ bảy',
+];
+/** Thứ viết tắt */
+exports.THU_NGAN = ['CN', 'T2', 'T3', 'T4', 'T5', 'T6', 'T7'];
+/**
+ * Bảng Nạp Âm 60 hoa giáp: index 0..59 ứng với Giáp Tý … Quý Hợi.
+ * Mỗi phần tử là [tên nạp âm, ngũ hành].
+ */
+exports.NAP_AM = [
+    ['Hải Trung Kim', 'Kim'], ['Hải Trung Kim', 'Kim'],
+    ['Lư Trung Hỏa', 'Hỏa'], ['Lư Trung Hỏa', 'Hỏa'],
+    ['Lôi Đình Mộc', 'Mộc'], ['Lôi Đình Mộc', 'Mộc'],
+    ['Lộ Bàng Thổ', 'Thổ'], ['Lộ Bàng Thổ', 'Thổ'],
+    ['Kiếm Phong Kim', 'Kim'], ['Kiếm Phong Kim', 'Kim'],
+    ['Sơn Đầu Hỏa', 'Hỏa'], ['Sơn Đầu Hỏa', 'Hỏa'],
+    ['Giản Hạ Thủy', 'Thủy'], ['Giản Hạ Thủy', 'Thủy'],
+    ['Thành Đầu Thổ', 'Thổ'], ['Thành Đầu Thổ', 'Thổ'],
+    ['Bạch Lạp Kim', 'Kim'], ['Bạch Lạp Kim', 'Kim'],
+    ['Dương Liễu Mộc', 'Mộc'], ['Dương Liễu Mộc', 'Mộc'],
+    ['Tuyền Trung Thủy', 'Thủy'], ['Tuyền Trung Thủy', 'Thủy'],
+    ['Ốc Thượng Thổ', 'Thổ'], ['Ốc Thượng Thổ', 'Thổ'],
+    ['Tích Lịch Hỏa', 'Hỏa'], ['Tích Lịch Hỏa', 'Hỏa'],
+    ['Tùng Bách Mộc', 'Mộc'], ['Tùng Bách Mộc', 'Mộc'],
+    ['Trường Lưu Thủy', 'Thủy'], ['Trường Lưu Thủy', 'Thủy'],
+    ['Sa Trung Kim', 'Kim'], ['Sa Trung Kim', 'Kim'],
+    ['Sơn Hạ Hỏa', 'Hỏa'], ['Sơn Hạ Hỏa', 'Hỏa'],
+    ['Bình Địa Mộc', 'Mộc'], ['Bình Địa Mộc', 'Mộc'],
+    ['Bích Thượng Thổ', 'Thổ'], ['Bích Thượng Thổ', 'Thổ'],
+    ['Kim Bạch Kim', 'Kim'], ['Kim Bạch Kim', 'Kim'],
+    ['Phú Đăng Hỏa', 'Hỏa'], ['Phú Đăng Hỏa', 'Hỏa'],
+    ['Thiên Hà Thủy', 'Thủy'], ['Thiên Hà Thủy', 'Thủy'],
+    ['Đại Trạch Thổ', 'Thổ'], ['Đại Trạch Thổ', 'Thổ'],
+    ['Thoa Xuyến Kim', 'Kim'], ['Thoa Xuyến Kim', 'Kim'],
+    ['Tang Đố Mộc', 'Mộc'], ['Tang Đố Mộc', 'Mộc'],
+    ['Đại Khê Thủy', 'Thủy'], ['Đại Khê Thủy', 'Thủy'],
+    ['Sa Trung Thổ', 'Thổ'], ['Sa Trung Thổ', 'Thổ'],
+    ['Thiên Thượng Hỏa', 'Hỏa'], ['Thiên Thượng Hỏa', 'Hỏa'],
+    ['Thạch Lựu Mộc', 'Mộc'], ['Thạch Lựu Mộc', 'Mộc'],
+    ['Đại Hải Thủy', 'Thủy'], ['Đại Hải Thủy', 'Thủy'],
+];
+/** 8 hướng chính dùng cho xuất hành */
+exports.HUONG_8 = [
+    'Chính Bắc', 'Đông Bắc', 'Chính Đông', 'Đông Nam',
+    'Chính Nam', 'Tây Nam', 'Chính Tây', 'Tây Bắc',
+];
+/** Múi giờ mặc định của lịch Việt Nam */
+exports.TZ_VN = 7;
+/** JD của ngày 1970-01-01 (dùng để quy đổi JD <-> timestamp) */
+exports.JD_UNIX_EPOCH = 2440587.5;

package/lib/core/day.d.ts

@@ -0,0 +1,30 @@
+/**
+ * API tổng hợp: lấy toàn bộ thông tin lịch âm của một ngày.
+ */
+import { type LunarDate } from './lunar';
+import type { DateInput, LunarDateInfo, LunarDayInfo } from './types';
+/** Chuẩn hoá đầu vào thành JD + [ngày, tháng, năm] dương lịch */
+export declare function resolveDate(input: DateInput, timeZone?: number): {
+    jd: number;
+    day: number;
+    month: number;
+    year: number;
+    weekday: number;
+};
+/** Bọc thêm tên tháng, chuỗi ngày âm cho một `LunarDate` */
+export declare function decorateLunar(l: LunarDate): LunarDateInfo;
+/**
+ * Lấy toàn bộ thông tin lịch âm của một ngày.
+ *
+ * @example
+ * getLunarDayInfo('2024-02-10')       // mùng 1 Tết Giáp Thìn
+ * getLunarDayInfo(new Date())         // hôm nay
+ * getLunarDayInfo(10, 2, 2024)        // 10/02/2024
+ */
+export declare function getLunarDayInfo(input: DateInput, timeZone?: number): LunarDayInfo;
+/** Tiện dụng: chỉ lấy ngày âm */
+export declare function getLunarDate(input: DateInput, timeZone?: number): LunarDateInfo;
+/**
+ * Tiện dụng: hôm nay là ngày âm bao nhiêu.
+ */
+export declare function getTodayLunar(timeZone?: number): LunarDateInfo;

package/lib/core/day.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * API tổng hợp: lấy toàn bộ thông tin lịch âm của một ngày.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTodayLunar = exports.getLunarDate = exports.getLunarDayInfo = exports.decorateLunar = exports.resolveDate = void 0;
+const constants_1 = require("./constants");
+const astro_1 = require("./astro");
+const lunar_1 = require("./lunar");
+const canchi_1 = require("./canchi");
+const tietkhi_1 = require("./tietkhi");
+const truc_1 = require("./truc");
+const huong_1 = require("./huong");
+/** Chuẩn hoá đầu vào thành JD + [ngày, tháng, năm] dương lịch */
+function resolveDate(input, timeZone = constants_1.TZ_VN) {
+    let jd;
+    let weekday;
+    if (input instanceof Date) {
+        jd = (0, astro_1.jdFromDateObject)(input, timeZone);
+        const shifted = new Date(input.getTime() + timeZone * 3600 * 1000);
+        weekday = shifted.getUTCDay();
+    }
+    else if (typeof input === 'number') {
+        jd = input;
+        weekday = (((jd + 1) % 7) + 7) % 7;
+    }
+    else if (typeof input === 'string') {
+        const m = /^(\d{4})-(\d{1,2})-(\d{1,2})/.exec(input.trim());
+        if (!m) {
+            throw new Error(`react-native-lich-am: không hiểu chuỗi ngày "${input}" (cần dạng YYYY-MM-DD)`);
+        }
+        jd = (0, astro_1.jdFromDate)(Number(m[3]), Number(m[2]), Number(m[1]));
+        weekday = (((jd + 1) % 7) + 7) % 7;
+    }
+    else {
+        jd = (0, astro_1.jdFromDate)(input.day, input.month, input.year);
+        weekday = (((jd + 1) % 7) + 7) % 7;
+    }
+    const [day, month, year] = (0, astro_1.jdToDate)(jd);
+    return { jd, day, month, year, weekday };
+}
+exports.resolveDate = resolveDate;
+/** Bọc thêm tên tháng, chuỗi ngày âm cho một `LunarDate` */
+function decorateLunar(l) {
+    const base = constants_1.TEN_THANG_AM_FULL[l.month];
+    return Object.assign(Object.assign({}, l), { monthName: base, monthNameFull: l.leap ? `${base} nhuận` : base, text: `${l.day}/${l.month}/${l.year}` });
+}
+exports.decorateLunar = decorateLunar;
+/**
+ * Lấy toàn bộ thông tin lịch âm của một ngày.
+ *
+ * @example
+ * getLunarDayInfo('2024-02-10')       // mùng 1 Tết Giáp Thìn
+ * getLunarDayInfo(new Date())         // hôm nay
+ * getLunarDayInfo(10, 2, 2024)        // 10/02/2024
+ */
+function getLunarDayInfo(input, timeZone = constants_1.TZ_VN) {
+    const { jd, day, month, year, weekday } = resolveDate(input, timeZone);
+    const lunar = (0, lunar_1.solarToLunar)(day, month, year, timeZone);
+    const canChiDay = (0, canchi_1.getCanChiDay)(jd);
+    const canChiYear = (0, canchi_1.getCanChiYear)(lunar.year);
+    const canChiMonth = (0, canchi_1.getCanChiMonth)(lunar.month, lunar.year);
+    const napAmDay = (0, canchi_1.getNapAm)(canChiDay.canIndex, canChiDay.chiIndex);
+    const napAmYear = (0, canchi_1.getNapAm)(canChiYear.canIndex, canChiYear.chiIndex);
+    const napAmMonth = (0, canchi_1.getNapAm)(canChiMonth.canIndex, canChiMonth.chiIndex);
+    const gio = (0, truc_1.getGioInDay)(canChiDay.chiIndex);
+    return {
+        jd,
+        solar: {
+            day,
+            month,
+            year,
+            weekday,
+            weekdayName: constants_1.THU[weekday],
+            iso: `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`,
+        },
+        lunar: decorateLunar(lunar),
+        canChi: { year: canChiYear, month: canChiMonth, day: canChiDay },
+        conGiap: (0, canchi_1.getConGiap)(lunar.year),
+        napAm: { year: napAmYear, month: napAmMonth, day: napAmDay },
+        nguHanh: napAmDay.element,
+        nguHanhId: (0, canchi_1.getNguHanhId)(napAmDay.element),
+        tietKhi: (0, tietkhi_1.getTietKhi)(jd, timeZone),
+        truc: (0, truc_1.getTruc)(jd, canChiDay.chiIndex, timeZone),
+        gio,
+        gioHoangDao: gio.filter((g) => g.hoangDao),
+        huongXuatHanh: (0, huong_1.getHuongXuatHanh)(canChiDay.canIndex, canChiDay.can),
+    };
+}
+exports.getLunarDayInfo = getLunarDayInfo;
+/** Tiện dụng: chỉ lấy ngày âm */
+function getLunarDate(input, timeZone = constants_1.TZ_VN) {
+    const { day, month, year } = resolveDate(input, timeZone);
+    return decorateLunar((0, lunar_1.solarToLunar)(day, month, year, timeZone));
+}
+exports.getLunarDate = getLunarDate;
+/**
+ * Tiện dụng: hôm nay là ngày âm bao nhiêu.
+ */
+function getTodayLunar(timeZone = constants_1.TZ_VN) {
+    return getLunarDate(new Date(), timeZone);
+}
+exports.getTodayLunar = getTodayLunar;

package/lib/core/format.d.ts

@@ -0,0 +1,26 @@
+/** Hàm định dạng hiển thị */
+import type { LunarDateInfo, LunarDayInfo } from './types';
+/** Tên ngày âm theo cách gọi dân gian: Mùng 1 … Rằm … Ba mươi */
+export declare function getLunarDayName(day: number): string;
+export interface FormatLunarOptions {
+    /** Dạng hiển thị */
+    style?: 'short' | 'long' | 'day';
+    /** Thêm chữ "nhuận" khi là tháng nhuận (mặc định true) */
+    showLeap?: boolean;
+}
+/**
+ * Định dạng ngày âm.
+ *
+ * - `short` → "20/11/2023"
+ * - `long`  → "20 tháng Một, năm Quý Mão"
+ * - `day`   → "Mùng 1"
+ */
+export declare function formatLunar(lunar: LunarDateInfo, options?: FormatLunarOptions): string;
+/** Định dạng ngày dương: "10/02/2024" hoặc "Thứ bảy, 10/02/2024" */
+export declare function formatSolar(day: LunarDayInfo, withWeekday?: boolean): string;
+/** Nhãn ngắn cho ô lịch: thứ viết tắt + ngày dương */
+export declare function formatCell(day: LunarDayInfo): string;
+/** Một dòng mô tả đầy đủ: "Thứ bảy 10/02/2024 — Mùng 1 tháng Giêng, Giáp Thìn" */
+export declare function describeDay(day: LunarDayInfo): string;
+/** Tên tháng âm ngắn: "Giêng", "Chạp" */
+export declare function getShortMonthName(month: number): string;

package/lib/core/format.js

@@ -0,0 +1,60 @@
+"use strict";
+/** Hàm định dạng hiển thị */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getShortMonthName = exports.describeDay = exports.formatCell = exports.formatSolar = exports.formatLunar = exports.getLunarDayName = void 0;
+const constants_1 = require("./constants");
+/** Tên ngày âm theo cách gọi dân gian: Mùng 1 … Rằm … Ba mươi */
+function getLunarDayName(day) {
+    if (day === 15)
+        return 'Rằm';
+    if (day === 30)
+        return 'Ba mươi';
+    if (day >= 1 && day <= 10)
+        return `Mùng ${day}`;
+    return String(day);
+}
+exports.getLunarDayName = getLunarDayName;
+/**
+ * Định dạng ngày âm.
+ *
+ * - `short` → "20/11/2023"
+ * - `long`  → "20 tháng Một, năm Quý Mão"
+ * - `day`   → "Mùng 1"
+ */
+function formatLunar(lunar, options = {}) {
+    const { style = 'short', showLeap = true } = options;
+    const leap = lunar.leap && showLeap ? ' nhuận' : '';
+    if (style === 'day') {
+        return getLunarDayName(lunar.day);
+    }
+    if (style === 'long') {
+        const yearPart = lunar.canChiYearName ? `, năm ${lunar.canChiYearName}` : '';
+        return `${lunar.day} ${constants_1.TEN_THANG_AM_FULL[lunar.month]}${leap}${yearPart}`;
+    }
+    return `${lunar.day}/${lunar.month}${leap}/${lunar.year}`;
+}
+exports.formatLunar = formatLunar;
+/** Định dạng ngày dương: "10/02/2024" hoặc "Thứ bảy, 10/02/2024" */
+function formatSolar(day, withWeekday = false) {
+    const { solar } = day;
+    const d = `${String(solar.day).padStart(2, '0')}/${String(solar.month).padStart(2, '0')}/${solar.year}`;
+    return withWeekday ? `${solar.weekdayName}, ${d}` : d;
+}
+exports.formatSolar = formatSolar;
+/** Nhãn ngắn cho ô lịch: thứ viết tắt + ngày dương */
+function formatCell(day) {
+    return `${constants_1.THU_NGAN[day.solar.weekday]} ${day.solar.day}`;
+}
+exports.formatCell = formatCell;
+/** Một dòng mô tả đầy đủ: "Thứ bảy 10/02/2024 — Mùng 1 tháng Giêng, Giáp Thìn" */
+function describeDay(day) {
+    const leap = day.lunar.leap ? ' nhuận' : '';
+    return (`${day.solar.weekdayName} ${String(day.solar.day).padStart(2, '0')}/${String(day.solar.month).padStart(2, '0')}/${day.solar.year}` +
+        ` — ${getLunarDayName(day.lunar.day)} ${constants_1.TEN_THANG_AM_FULL[day.lunar.month]}${leap}, ${day.canChi.year.name}`);
+}
+exports.describeDay = describeDay;
+/** Tên tháng âm ngắn: "Giêng", "Chạp" */
+function getShortMonthName(month) {
+    return constants_1.TEN_THANG_AM[month];
+}
+exports.getShortMonthName = getShortMonthName;

package/lib/core/huong.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Hướng xuất hành theo bảng Ngọc Hạp Thông Thư.
+ *
+ * Bảng đối xứng theo cặp Can ngày:
+ *   Giáp / Kỷ  → Hỷ: Đông Bắc  · Tài: Đông Bắc  · Hạc: Đông Nam
+ *   Ất   / Canh→ Hỷ: Tây Bắc   · Tài: Đông Nam  · Hạc: Đông Nam
+ *   Bính / Tân → Hỷ: Tây Nam   · Tài: Tây       · Hạc: Đông
+ *   Đinh / Nhâm→ Hỷ: Nam       · Tài: Tây Nam   · Hạc: Đông
+ *   Mậu  / Quý → Hỷ: Đông Nam  · Tài: Bắc       · Hạc: Trung cung
+ */
+export interface HuongXuatHanh {
+    /** Can của ngày (0 = Giáp) */
+    canIndex: number;
+    /** Tên can */
+    can: string;
+    /** Hướng Hỷ thần — gặp việc vui, cưới hỏi, gặp gỡ */
+    hyThan: string;
+    /** Hướng Tài thần — cầu tài, khai trương, đàm phán */
+    taiThan: string;
+    /** Hướng Hạc thần — đại kỵ, nên tránh */
+    hacThan: string;
+}
+/** Hướng xuất hành của ngày, suy từ can ngày */
+export declare function getHuongXuatHanh(canIndex: number, canName: string): HuongXuatHanh;
+/** Toạ độ la bàn (độ, 0 = Chính Bắc, thuận chiều kim đồng hồ) của 8 hướng */
+export declare const HUONG_DEGREE: Record<string, number>;

package/lib/core/huong.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Hướng xuất hành theo bảng Ngọc Hạp Thông Thư.
+ *
+ * Bảng đối xứng theo cặp Can ngày:
+ *   Giáp / Kỷ  → Hỷ: Đông Bắc  · Tài: Đông Bắc  · Hạc: Đông Nam
+ *   Ất   / Canh→ Hỷ: Tây Bắc   · Tài: Đông Nam  · Hạc: Đông Nam
+ *   Bính / Tân → Hỷ: Tây Nam   · Tài: Tây       · Hạc: Đông
+ *   Đinh / Nhâm→ Hỷ: Nam       · Tài: Tây Nam   · Hạc: Đông
+ *   Mậu  / Quý → Hỷ: Đông Nam  · Tài: Bắc       · Hạc: Trung cung
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HUONG_DEGREE = exports.getHuongXuatHanh = void 0;
+const HY = ['Đông Bắc', 'Tây Bắc', 'Tây Nam', 'Nam', 'Đông Nam'];
+const TAI = ['Đông Bắc', 'Đông Nam', 'Tây', 'Tây Nam', 'Bắc'];
+const HAC = ['Đông Nam', 'Đông Nam', 'Đông', 'Đông', 'Trung cung'];
+/** Hướng xuất hành của ngày, suy từ can ngày */
+function getHuongXuatHanh(canIndex, canName) {
+    const g = (((canIndex % 10) + 10) % 10) % 5;
+    return {
+        canIndex: (((canIndex % 10) + 10) % 10),
+        can: canName,
+        hyThan: HY[g],
+        taiThan: TAI[g],
+        hacThan: HAC[g],
+    };
+}
+exports.getHuongXuatHanh = getHuongXuatHanh;
+/** Toạ độ la bàn (độ, 0 = Chính Bắc, thuận chiều kim đồng hồ) của 8 hướng */
+exports.HUONG_DEGREE = {
+    'Chính Bắc': 0,
+    'Đông Bắc': 45,
+    'Chính Đông': 90,
+    'Đông Nam': 135,
+    'Chính Nam': 180,
+    'Tây Nam': 225,
+    'Chính Tây': 270,
+    'Tây Bắc': 315,
+    Bắc: 0,
+    Đông: 90,
+    Nam: 180,
+    Tây: 270,
+    'Trung cung': -1,
+};

package/lib/core/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * react-native-lich-am / core
+ *
+ * Toàn bộ phần tính toán lịch âm — không phụ thuộc React Native,
+ * không phụ thuộc thư viện ngoài, chạy được cả trên Node và trình duyệt.
+ */
+export * from './constants';
+export * from './astro';
+export * from './lunar';
+export * from './canchi';
+export * from './tietkhi';
+export * from './truc';
+export * from './huong';
+export * from './format';
+export * from './day';
+export * from './types';

package/lib/core/index.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * react-native-lich-am / core
+ *
+ * Toàn bộ phần tính toán lịch âm — không phụ thuộc React Native,
+ * không phụ thuộc thư viện ngoài, chạy được cả trên Node và trình duyệt.
+ */
+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 });
+__exportStar(require("./constants"), exports);
+__exportStar(require("./astro"), exports);
+__exportStar(require("./lunar"), exports);
+__exportStar(require("./canchi"), exports);
+__exportStar(require("./tietkhi"), exports);
+__exportStar(require("./truc"), exports);
+__exportStar(require("./huong"), exports);
+__exportStar(require("./format"), exports);
+__exportStar(require("./day"), exports);
+__exportStar(require("./types"), exports);

package/lib/core/lunar.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Chuyển đổi dương lịch ⇄ âm lịch (âm lịch Việt Nam, múi giờ UTC+7).
+ */
+export interface LunarDate {
+    /** Ngày âm (1–30) */
+    day: number;
+    /** Tháng âm (1–12) */
+    month: number;
+    /** Năm âm */
+    year: number;
+    /** Tháng nhuận hay không */
+    leap: boolean;
+    /** Số ngày Julian của ngày dương tương ứng */
+    jd: number;
+}
+export interface SolarDate {
+    day: number;
+    month: number;
+    year: number;
+    jd: number;
+}
+/**
+ * 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 }
+ */
+export declare function solarToLunar(day: number, month: number, year: number, timeZone?: number): LunarDate;
+/**
+ * Â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 đó).
+ */
+export declare function lunarToSolar(day: number, month: number, year: number, leap?: boolean, timeZone?: number): SolarDate | null;
+/** Tháng âm `month` của năm âm `year` có phải tháng nhuận hay không */
+export declare function getLeapMonthOfYear(year: number, timeZone?: number): number;
+/** Số ngày của một tháng âm (29 hoặc 30) */
+export declare function getLunarMonthDays(month: number, year: number, leap?: boolean, timeZone?: number): number;