@lichta/core 2.0.0 → 2.1.0

package/dist/index.d.ts

@@ -73,22 +73,106 @@ declare class LichTa {
 }
 
 /**
- * Lấy ra chuỗi mô tả toàn bộ Can, Chi và Mệnh dựa vào số năm (Ví dụ: 2024)
- * Theo quy ước: Năm 4 (sau CN) là năm Giáp Tý (Can index 0, Chi index 0)
+ * Internationalization — Hỗ trợ song ngữ Việt-Anh
  */
-declare function getYearDetails(year: number): {
-    can: "Giáp" | "Ất" | "Bính" | "Đinh" | "Mậu" | "Kỷ" | "Canh" | "Tân" | "Nhâm" | "Quý";
-    chi: "Tý" | "Sửu" | "Dần" | "Mão" | "Thìn" | "Tỵ" | "Ngọ" | "Mùi" | "Thân" | "Dậu" | "Tuất" | "Hợi";
+type Locale = 'vi' | 'en' | 'ja' | 'ko';
+/**
+ * Lấy bộ dịch theo locale
+ * @param locale - Ngôn ngữ ('vi' | 'en' | 'ja' | 'ko')
+ */
+declare function t(locale: Locale): {
+    readonly heavenlyStems: readonly ["Giáp", "Ất", "Bính", "Đinh", "Mậu", "Kỷ", "Canh", "Tân", "Nhâm", "Quý"];
+    readonly earthlyBranches: readonly ["Tý", "Sửu", "Dần", "Mão", "Thìn", "Tỵ", "Ngọ", "Mùi", "Thân", "Dậu", "Tuất", "Hợi"];
+    readonly fiveElements: readonly ["Kim", "Mộc", "Thủy", "Hỏa", "Thổ"];
+    readonly zodiacAnimals: readonly ["Chuột", "Trâu", "Cọp", "Thỏ", "Rồng", "Rắn", "Ngựa", "Dê", "Khỉ", "Gà", "Chó", "Heo"];
+    readonly monthNames: readonly ["Giêng", "Hai", "Ba", "Tư", "Năm", "Sáu", "Bảy", "Tám", "Chín", "Mười", "Một", "Chạp"];
+    readonly lunarMonthNames: readonly ["Giêng", "Hai", "Ba", "Tư", "Năm", "Sáu", "Bảy", "Tám", "Chín", "Mười", "Một", "Chạp"];
+    readonly solarMonthNames: readonly ["Tháng 1", "Tháng 2", "Tháng 3", "Tháng 4", "Tháng 5", "Tháng 6", "Tháng 7", "Tháng 8", "Tháng 9", "Tháng 10", "Tháng 11", "Tháng 12"];
+    readonly weekDays: readonly ["CN", "T2", "T3", "T4", "T5", "T6", "T7"];
+    readonly leapLabel: "Nhuận";
+    readonly yearLabel: "Năm";
+    readonly monthLabel: "Tháng";
+    readonly destiny: "Mệnh";
+} | {
+    readonly heavenlyStems: readonly ["Giáp", "Ất", "Bính", "Đinh", "Mậu", "Kỷ", "Canh", "Tân", "Nhâm", "Quý"];
+    readonly earthlyBranches: readonly ["Tý", "Sửu", "Dần", "Mão", "Thìn", "Tỵ", "Ngọ", "Mùi", "Thân", "Dậu", "Tuất", "Hợi"];
+    readonly fiveElements: readonly ["Metal", "Wood", "Water", "Fire", "Earth"];
+    readonly zodiacAnimals: readonly ["Rat", "Ox", "Tiger", "Rabbit", "Dragon", "Snake", "Horse", "Goat", "Monkey", "Rooster", "Dog", "Pig"];
+    readonly monthNames: readonly ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"];
+    readonly lunarMonthNames: readonly ["Month 1", "Month 2", "Month 3", "Month 4", "Month 5", "Month 6", "Month 7", "Month 8", "Month 9", "Month 10", "Month 11", "Month 12"];
+    readonly solarMonthNames: readonly ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"];
+    readonly weekDays: readonly ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+    readonly leapLabel: "Leap";
+    readonly yearLabel: "Year";
+    readonly monthLabel: "Month";
+    readonly destiny: "Destiny";
+} | {
+    readonly heavenlyStems: readonly ["甲", "乙", "丙", "丁", "戊", "己", "庚", "辛", "壬", "癸"];
+    readonly earthlyBranches: readonly ["子", "丑", "寅", "卯", "辰", "巳", "午", "未", "申", "酉", "戌", "亥"];
+    readonly fiveElements: readonly ["金", "木", "水", "火", "土"];
+    readonly zodiacAnimals: readonly ["鼠", "牛", "虎", "兎", "竜", "蛇", "馬", "羊", "猿", "鶏", "犬", "猪"];
+    readonly monthNames: readonly ["1月", "2月", "3月", "4月", "5月", "6月", "7月", "8月", "9月", "10月", "11月", "12月"];
+    readonly lunarMonthNames: readonly ["旧暦1月", "旧暦2月", "旧暦3月", "旧暦4月", "旧暦5月", "旧暦6月", "旧暦7月", "旧暦8月", "旧暦9月", "旧暦10月", "旧暦11月", "旧暦12月"];
+    readonly solarMonthNames: readonly ["1月", "2月", "3月", "4月", "5月", "6月", "7月", "8月", "9月", "10月", "11月", "12月"];
+    readonly weekDays: readonly ["日", "月", "火", "水", "木", "金", "土"];
+    readonly leapLabel: "閏";
+    readonly yearLabel: "年";
+    readonly monthLabel: "月";
+    readonly destiny: "命";
+} | {
+    readonly heavenlyStems: readonly ["갑", "을", "병", "정", "무", "기", "경", "신", "임", "계"];
+    readonly earthlyBranches: readonly ["자", "축", "인", "묘", "진", "사", "오", "미", "신", "유", "술", "해"];
+    readonly fiveElements: readonly ["금", "목", "수", "화", "토"];
+    readonly zodiacAnimals: readonly ["쥐", "소", "호랑이", "토끼", "용", "뱀", "말", "양", "원숭이", "닭", "개", "돼지"];
+    readonly monthNames: readonly ["1월", "2월", "3월", "4월", "5월", "6월", "7월", "8월", "9월", "10월", "11월", "12월"];
+    readonly lunarMonthNames: readonly ["음력 1월", "음력 2월", "음력 3월", "음력 4월", "음력 5월", "음력 6월", "음력 7월", "음력 8월", "음력 9월", "음력 10월", "음력 11월", "음력 12월"];
+    readonly solarMonthNames: readonly ["1월", "2월", "3월", "4월", "5월", "6월", "7월", "8월", "9월", "10월", "11월", "12월"];
+    readonly weekDays: readonly ["일", "월", "화", "수", "목", "금", "토"];
+    readonly leapLabel: "윤";
+    readonly yearLabel: "년";
+    readonly monthLabel: "월";
+    readonly destiny: "명";
+};
+/**
+ * Lấy tên con giáp theo locale
+ * @param branchIndex - Index Địa Chi (0-11)
+ * @param locale - Ngôn ngữ
+ */
+declare function getZodiacAnimal(branchIndex: number, locale?: Locale): string;
+
+/** Kết quả trả về của {@link getYearDetails}. */
+interface YearDetails {
+    can: string;
+    chi: string;
     menh: string;
     fullString: string;
-};
+}
+/**
+ * Lấy ra chuỗi mô tả toàn bộ Can, Chi và Mệnh dựa vào số năm (Ví dụ: 2024)
+ * Theo quy ước: Năm 4 (sau CN) là năm Giáp Tý (Can index 0, Chi index 0)
+ *
+ * Công thức Can Chi là chu kỳ 60 năm lặp lại vô hạn nên nhận mọi số năm nguyên,
+ * kể cả năm 0 hoặc âm (trước Công Nguyên) — không giới hạn phạm vi như
+ * {@link LichTa.toLunar} (phạm vi đó là do thuật toán tìm Điểm Sóc, không áp
+ * dụng cho công thức Can Chi thuần).
+ *
+ * @param year - Năm (số nguyên bất kỳ, kể cả 0 hoặc âm)
+ *
+ * @example
+ * ```typescript
+ * getYearDetails(2024);
+ * // → { can: 'Giáp', chi: 'Thìn', menh: 'Thủy', fullString: 'Giáp Thìn - Mệnh Thủy' }
+ * ```
+ */
+declare function getYearDetails(year: number): YearDetails;
 /**
  * Tính Can Chi ngày từ Julian Day Number.
  *
  * @param jd - Julian Day Number
+ * @param locale - Ngôn ngữ hiển thị (mặc định: 'vi', giữ nguyên hành vi cũ)
  * @returns Chuỗi Can Chi (ví dụ: "Giáp Tý")
  */
-declare function getDayCanChi(jd: number): string;
+declare function getDayCanChi(jd: number, locale?: Locale): string;
 /**
  * Tính Can Chi tháng từ tháng và năm âm lịch.
  * Can tháng phụ thuộc vào Can của năm (quy tắc Ngũ Hổ Độn):
@@ -100,8 +184,9 @@ declare function getDayCanChi(jd: number): string;
  *
  * @param lunarMonth - Tháng âm lịch (1-12)
  * @param lunarYear - Năm âm lịch
+ * @param locale - Ngôn ngữ hiển thị (mặc định: 'vi', giữ nguyên hành vi cũ)
  */
-declare function getMonthCanChi(lunarMonth: number, lunarYear: number): string;
+declare function getMonthCanChi(lunarMonth: number, lunarYear: number, locale?: Locale): string;
 /**
  * Tính Can Chi giờ từ giờ (0-23) và Julian Day Number của ngày.
  *
@@ -117,16 +202,30 @@ declare function getMonthCanChi(lunarMonth: number, lunarYear: number): string;
  *
  * @param hour - Giờ (0-23)
  * @param dayJd - Julian Day Number của ngày
+ * @param locale - Ngôn ngữ hiển thị (mặc định: 'vi', giữ nguyên hành vi cũ)
  */
-declare function getHourCanChi(hour: number, dayJd: number): string;
+declare function getHourCanChi(hour: number, dayJd: number, locale?: Locale): string;
 /**
  * Lấy danh sách 6 giờ Hoàng Đạo trong ngày.
  * Giờ Hoàng Đạo phụ thuộc vào Địa Chi của ngày.
  *
  * @param dayJd - Julian Day Number của ngày
+ * @param locale - Ngôn ngữ hiển thị (mặc định: 'vi', giữ nguyên hành vi cũ)
  * @returns Mảng 6 chuỗi tên Địa Chi (ví dụ: ["Tý", "Sửu", "Mão", "Ngọ", "Mùi", "Dậu"])
  */
-declare function getAuspiciousHours(dayJd: number): string[];
+declare function getAuspiciousHours(dayJd: number, locale?: Locale): string[];
+/**
+ * Lấy index (0-11, theo thứ tự Địa Chi Tý→Hợi) của 6 giờ Hoàng Đạo trong ngày.
+ *
+ * Dùng khi cần một khoá ổn định, không phụ thuộc ngôn ngữ — ví dụ để map sang
+ * icon riêng, hoặc tự tra bảng dịch của bạn thay vì dùng chuỗi tên có sẵn từ
+ * {@link getAuspiciousHours}. Cả hai hàm dùng chung thứ tự dữ liệu nên
+ * `getAuspiciousHourIndices(jd)[i]` luôn tương ứng với `getAuspiciousHours(jd)[i]`.
+ *
+ * @param dayJd - Julian Day Number của ngày
+ * @returns Mảng 6 index Địa Chi (ví dụ: [0, 1, 3, 6, 7, 9])
+ */
+declare function getAuspiciousHourIndices(dayJd: number): number[];
 
 /**
  * Lấy tên tháng âm lịch dạng chữ truyền thống.
@@ -170,13 +269,14 @@ declare function getDayName(day: number): string;
  * | `M`   | Tháng                                    | 1, 12          |
  * | `yyyy`| Năm 4 chữ số                             | 2024           |
  * | `yy`  | Năm 2 chữ số cuối                        | 24             |
- * | `L`   | "Nhuận" nếu tháng nhuận, "" nếu không    | Nhuận          |
+ * | `L`   | Nhãn tháng nhuận theo `locale` (xem tham số `locale`), "" nếu không phải tháng nhuận | Nhuận |
  * | `CC`  | Can Chi năm                              | Giáp Thìn      |
  * | `DC`  | Can Chi ngày                             | Giáp Tý        |
  * | `MC`  | Can Chi tháng                            | Bính Dần       |
  *
  * @param lunar - Đối tượng LunarDate
  * @param pattern - Chuỗi pattern
+ * @param locale - Ngôn ngữ cho token `L` (mặc định: 'vi', giữ nguyên hành vi cũ — "Nhuận")
  *
  * @example
  * ```typescript
@@ -187,7 +287,7 @@ declare function getDayName(day: number): string;
  * // → "Ngày 1 tháng 1 năm Giáp Thìn"
  * ```
  */
-declare function formatLunarDate(lunar: LunarDate, pattern: string): string;
+declare function formatLunarDate(lunar: LunarDate, pattern: string, locale?: Locale): string;
 /**
  * Format ngày âm lịch theo kiểu truyền thống Việt Nam.
  *
@@ -202,64 +302,26 @@ declare function formatLunarDate(lunar: LunarDate, pattern: string): string;
  */
 declare function formatTraditional(lunar: LunarDate): string;
 
+/** Một ô ngày trong lưới lịch tháng. */
+interface CalendarDayCell {
+    solar: Date;
+    lunar: LunarDate;
+    isToday: boolean;
+    isSelected: boolean;
+    isCurrentMonth: boolean;
+}
 /**
- * Internationalization — Hỗ trợ song ngữ Việt-Anh
- */
-type Locale = 'vi' | 'en' | 'ja' | 'ko';
-/**
- * Lấy bộ dịch theo locale
- * @param locale - Ngôn ngữ ('vi' | 'en' | 'ja' | 'ko')
- */
-declare function t(locale: Locale): {
-    readonly heavenlyStems: readonly ["Giáp", "Ất", "Bính", "Đinh", "Mậu", "Kỷ", "Canh", "Tân", "Nhâm", "Quý"];
-    readonly earthlyBranches: readonly ["Tý", "Sửu", "Dần", "Mão", "Thìn", "Tỵ", "Ngọ", "Mùi", "Thân", "Dậu", "Tuất", "Hợi"];
-    readonly fiveElements: readonly ["Kim", "Mộc", "Thủy", "Hỏa", "Thổ"];
-    readonly zodiacAnimals: readonly ["Chuột", "Trâu", "Cọp", "Thỏ", "Rồng", "Rắn", "Ngựa", "Dê", "Khỉ", "Gà", "Chó", "Heo"];
-    readonly monthNames: readonly ["Giêng", "Hai", "Ba", "Tư", "Năm", "Sáu", "Bảy", "Tám", "Chín", "Mười", "Một", "Chạp"];
-    readonly weekDays: readonly ["CN", "T2", "T3", "T4", "T5", "T6", "T7"];
-    readonly leapLabel: "Nhuận";
-    readonly yearLabel: "Năm";
-    readonly monthLabel: "Tháng";
-    readonly destiny: "Mệnh";
-} | {
-    readonly heavenlyStems: readonly ["Giáp", "Ất", "Bính", "Đinh", "Mậu", "Kỷ", "Canh", "Tân", "Nhâm", "Quý"];
-    readonly earthlyBranches: readonly ["Tý", "Sửu", "Dần", "Mão", "Thìn", "Tỵ", "Ngọ", "Mùi", "Thân", "Dậu", "Tuất", "Hợi"];
-    readonly fiveElements: readonly ["Metal", "Wood", "Water", "Fire", "Earth"];
-    readonly zodiacAnimals: readonly ["Rat", "Ox", "Tiger", "Rabbit", "Dragon", "Snake", "Horse", "Goat", "Monkey", "Rooster", "Dog", "Pig"];
-    readonly monthNames: readonly ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"];
-    readonly weekDays: readonly ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
-    readonly leapLabel: "Leap";
-    readonly yearLabel: "Year";
-    readonly monthLabel: "Month";
-    readonly destiny: "Destiny";
-} | {
-    readonly heavenlyStems: readonly ["甲", "乙", "丙", "丁", "戊", "己", "庚", "辛", "壬", "癸"];
-    readonly earthlyBranches: readonly ["子", "丑", "寅", "卯", "辰", "巳", "午", "未", "申", "酉", "戌", "亥"];
-    readonly fiveElements: readonly ["金", "木", "水", "火", "土"];
-    readonly zodiacAnimals: readonly ["鼠", "牛", "虎", "兎", "竜", "蛇", "馬", "羊", "猿", "鶏", "犬", "猪"];
-    readonly monthNames: readonly ["1月", "2月", "3月", "4月", "5月", "6月", "7月", "8月", "9月", "10月", "11月", "12月"];
-    readonly weekDays: readonly ["日", "月", "火", "水", "木", "金", "土"];
-    readonly leapLabel: "閏";
-    readonly yearLabel: "年";
-    readonly monthLabel: "月";
-    readonly destiny: "命";
-} | {
-    readonly heavenlyStems: readonly ["갑", "을", "병", "정", "무", "기", "경", "신", "임", "계"];
-    readonly earthlyBranches: readonly ["자", "축", "인", "묘", "진", "사", "오", "미", "신", "유", "술", "해"];
-    readonly fiveElements: readonly ["금", "목", "수", "화", "토"];
-    readonly zodiacAnimals: readonly ["쥐", "소", "호랑이", "토끼", "용", "뱀", "말", "양", "원숭이", "닭", "개", "돼지"];
-    readonly monthNames: readonly ["1월", "2월", "3월", "4월", "5월", "6월", "7월", "8월", "9월", "10월", "11월", "12월"];
-    readonly weekDays: readonly ["일", "월", "화", "수", "목", "금", "토"];
-    readonly leapLabel: "윤";
-    readonly yearLabel: "년";
-    readonly monthLabel: "월";
-    readonly destiny: "명";
-};
-/**
- * Lấy tên con giáp theo locale
- * @param branchIndex - Index Địa Chi (0-11)
- * @param locale - Ngôn ngữ
+ * Dựng lưới 42 ô (6 tuần x 7 ngày) cho 1 tháng dương lịch, gồm ngày tràn từ
+ * tháng trước/sau để lấp đầy tuần đầu/cuối, mỗi ô kèm ngày âm tương ứng.
+ *
+ * Logic này trước đây bị lặp lại độc lập ở Calendar.tsx/vue/svelte — tách ra
+ * đây để có 1 nguồn tính toán duy nhất (tránh 3 bản có thể lệch nhau khi sửa
+ * riêng lẻ), dùng chung cho cả Calendar và DatePicker ở mọi framework.
+ *
+ * @param month - Tháng dương lịch (1-12)
+ * @param year - Năm dương lịch
+ * @param selectedDate - Ngày đang được chọn (nếu có), dùng để đánh dấu `isSelected`
  */
-declare function getZodiacAnimal(branchIndex: number, locale?: Locale): string;
+declare function getCalendarGrid(month: number, year: number, selectedDate?: Date | null): CalendarDayCell[];
 
-export { LichTa, type Locale, type LunarDate, type SolarDate, formatLunarDate, formatTraditional, getAuspiciousHours, getDayCanChi, getDayName, getHourCanChi, getMonthCanChi, getMonthName, getYearDetails, getZodiacAnimal, jdFromDate, jdToDate, t };
+export { type CalendarDayCell, LichTa, type Locale, type LunarDate, type SolarDate, type YearDetails, formatLunarDate, formatTraditional, getAuspiciousHourIndices, getAuspiciousHours, getCalendarGrid, getDayCanChi, getDayName, getHourCanChi, getMonthCanChi, getMonthName, getYearDetails, getZodiacAnimal, jdFromDate, jdToDate, t };

package/dist/index.js

@@ -15,7 +15,7 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __toCommonJS = (mod2) => __copyProps(__defProp({}, "__esModule", { value: true }), mod2);
 
 // src/index.ts
 var index_exports = {};
@@ -23,7 +23,9 @@ __export(index_exports, {
   LichTa: () => LichTa,
   formatLunarDate: () => formatLunarDate,
   formatTraditional: () => formatTraditional,
+  getAuspiciousHourIndices: () => getAuspiciousHourIndices,
   getAuspiciousHours: () => getAuspiciousHours,
+  getCalendarGrid: () => getCalendarGrid,
   getDayCanChi: () => getDayCanChi,
   getDayName: () => getDayName,
   getHourCanChi: () => getHourCanChi,
@@ -321,10 +323,83 @@ var LichTa = class {
 // src/constants/five-elements.ts
 var FIVE_ELEMENTS = ["Kim", "M\u1ED9c", "Th\u1EE7y", "H\u1ECFa", "Th\u1ED5"];
 
+// src/constants/i18n.ts
+var translations = {
+  vi: {
+    heavenlyStems: ["Gi\xE1p", "\u1EA4t", "B\xEDnh", "\u0110inh", "M\u1EADu", "K\u1EF7", "Canh", "T\xE2n", "Nh\xE2m", "Qu\xFD"],
+    earthlyBranches: ["T\xFD", "S\u1EEDu", "D\u1EA7n", "M\xE3o", "Th\xECn", "T\u1EF5", "Ng\u1ECD", "M\xF9i", "Th\xE2n", "D\u1EADu", "Tu\u1EA5t", "H\u1EE3i"],
+    fiveElements: ["Kim", "M\u1ED9c", "Th\u1EE7y", "H\u1ECFa", "Th\u1ED5"],
+    zodiacAnimals: ["Chu\u1ED9t", "Tr\xE2u", "C\u1ECDp", "Th\u1ECF", "R\u1ED3ng", "R\u1EAFn", "Ng\u1EF1a", "D\xEA", "Kh\u1EC9", "G\xE0", "Ch\xF3", "Heo"],
+    // @deprecated Ngữ nghĩa không nhất quán giữa các locale (xem lunarMonthNames/solarMonthNames).
+    monthNames: ["Gi\xEAng", "Hai", "Ba", "T\u01B0", "N\u0103m", "S\xE1u", "B\u1EA3y", "T\xE1m", "Ch\xEDn", "M\u01B0\u1EDDi", "M\u1ED9t", "Ch\u1EA1p"],
+    lunarMonthNames: ["Gi\xEAng", "Hai", "Ba", "T\u01B0", "N\u0103m", "S\xE1u", "B\u1EA3y", "T\xE1m", "Ch\xEDn", "M\u01B0\u1EDDi", "M\u1ED9t", "Ch\u1EA1p"],
+    solarMonthNames: ["Th\xE1ng 1", "Th\xE1ng 2", "Th\xE1ng 3", "Th\xE1ng 4", "Th\xE1ng 5", "Th\xE1ng 6", "Th\xE1ng 7", "Th\xE1ng 8", "Th\xE1ng 9", "Th\xE1ng 10", "Th\xE1ng 11", "Th\xE1ng 12"],
+    weekDays: ["CN", "T2", "T3", "T4", "T5", "T6", "T7"],
+    leapLabel: "Nhu\u1EADn",
+    yearLabel: "N\u0103m",
+    monthLabel: "Th\xE1ng",
+    destiny: "M\u1EC7nh"
+  },
+  en: {
+    heavenlyStems: ["Gi\xE1p", "\u1EA4t", "B\xEDnh", "\u0110inh", "M\u1EADu", "K\u1EF7", "Canh", "T\xE2n", "Nh\xE2m", "Qu\xFD"],
+    earthlyBranches: ["T\xFD", "S\u1EEDu", "D\u1EA7n", "M\xE3o", "Th\xECn", "T\u1EF5", "Ng\u1ECD", "M\xF9i", "Th\xE2n", "D\u1EADu", "Tu\u1EA5t", "H\u1EE3i"],
+    fiveElements: ["Metal", "Wood", "Water", "Fire", "Earth"],
+    zodiacAnimals: ["Rat", "Ox", "Tiger", "Rabbit", "Dragon", "Snake", "Horse", "Goat", "Monkey", "Rooster", "Dog", "Pig"],
+    // @deprecated Ngữ nghĩa không nhất quán giữa các locale (xem lunarMonthNames/solarMonthNames).
+    monthNames: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"],
+    lunarMonthNames: ["Month 1", "Month 2", "Month 3", "Month 4", "Month 5", "Month 6", "Month 7", "Month 8", "Month 9", "Month 10", "Month 11", "Month 12"],
+    solarMonthNames: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"],
+    weekDays: ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"],
+    leapLabel: "Leap",
+    yearLabel: "Year",
+    monthLabel: "Month",
+    destiny: "Destiny"
+  },
+  ja: {
+    heavenlyStems: ["\u7532", "\u4E59", "\u4E19", "\u4E01", "\u620A", "\u5DF1", "\u5E9A", "\u8F9B", "\u58EC", "\u7678"],
+    earthlyBranches: ["\u5B50", "\u4E11", "\u5BC5", "\u536F", "\u8FB0", "\u5DF3", "\u5348", "\u672A", "\u7533", "\u9149", "\u620C", "\u4EA5"],
+    fiveElements: ["\u91D1", "\u6728", "\u6C34", "\u706B", "\u571F"],
+    zodiacAnimals: ["\u9F20", "\u725B", "\u864E", "\u514E", "\u7ADC", "\u86C7", "\u99AC", "\u7F8A", "\u733F", "\u9D8F", "\u72AC", "\u732A"],
+    // @deprecated Ngữ nghĩa không nhất quán giữa các locale (xem lunarMonthNames/solarMonthNames).
+    monthNames: ["1\u6708", "2\u6708", "3\u6708", "4\u6708", "5\u6708", "6\u6708", "7\u6708", "8\u6708", "9\u6708", "10\u6708", "11\u6708", "12\u6708"],
+    lunarMonthNames: ["\u65E7\u66A61\u6708", "\u65E7\u66A62\u6708", "\u65E7\u66A63\u6708", "\u65E7\u66A64\u6708", "\u65E7\u66A65\u6708", "\u65E7\u66A66\u6708", "\u65E7\u66A67\u6708", "\u65E7\u66A68\u6708", "\u65E7\u66A69\u6708", "\u65E7\u66A610\u6708", "\u65E7\u66A611\u6708", "\u65E7\u66A612\u6708"],
+    solarMonthNames: ["1\u6708", "2\u6708", "3\u6708", "4\u6708", "5\u6708", "6\u6708", "7\u6708", "8\u6708", "9\u6708", "10\u6708", "11\u6708", "12\u6708"],
+    weekDays: ["\u65E5", "\u6708", "\u706B", "\u6C34", "\u6728", "\u91D1", "\u571F"],
+    leapLabel: "\u958F",
+    yearLabel: "\u5E74",
+    monthLabel: "\u6708",
+    destiny: "\u547D"
+  },
+  ko: {
+    heavenlyStems: ["\uAC11", "\uC744", "\uBCD1", "\uC815", "\uBB34", "\uAE30", "\uACBD", "\uC2E0", "\uC784", "\uACC4"],
+    earthlyBranches: ["\uC790", "\uCD95", "\uC778", "\uBB18", "\uC9C4", "\uC0AC", "\uC624", "\uBBF8", "\uC2E0", "\uC720", "\uC220", "\uD574"],
+    fiveElements: ["\uAE08", "\uBAA9", "\uC218", "\uD654", "\uD1A0"],
+    zodiacAnimals: ["\uC950", "\uC18C", "\uD638\uB791\uC774", "\uD1A0\uB07C", "\uC6A9", "\uBC40", "\uB9D0", "\uC591", "\uC6D0\uC22D\uC774", "\uB2ED", "\uAC1C", "\uB3FC\uC9C0"],
+    // @deprecated Ngữ nghĩa không nhất quán giữa các locale (xem lunarMonthNames/solarMonthNames).
+    monthNames: ["1\uC6D4", "2\uC6D4", "3\uC6D4", "4\uC6D4", "5\uC6D4", "6\uC6D4", "7\uC6D4", "8\uC6D4", "9\uC6D4", "10\uC6D4", "11\uC6D4", "12\uC6D4"],
+    lunarMonthNames: ["\uC74C\uB825 1\uC6D4", "\uC74C\uB825 2\uC6D4", "\uC74C\uB825 3\uC6D4", "\uC74C\uB825 4\uC6D4", "\uC74C\uB825 5\uC6D4", "\uC74C\uB825 6\uC6D4", "\uC74C\uB825 7\uC6D4", "\uC74C\uB825 8\uC6D4", "\uC74C\uB825 9\uC6D4", "\uC74C\uB825 10\uC6D4", "\uC74C\uB825 11\uC6D4", "\uC74C\uB825 12\uC6D4"],
+    solarMonthNames: ["1\uC6D4", "2\uC6D4", "3\uC6D4", "4\uC6D4", "5\uC6D4", "6\uC6D4", "7\uC6D4", "8\uC6D4", "9\uC6D4", "10\uC6D4", "11\uC6D4", "12\uC6D4"],
+    weekDays: ["\uC77C", "\uC6D4", "\uD654", "\uC218", "\uBAA9", "\uAE08", "\uD1A0"],
+    leapLabel: "\uC724",
+    yearLabel: "\uB144",
+    monthLabel: "\uC6D4",
+    destiny: "\uBA85"
+  }
+};
+function t(locale) {
+  return translations[locale];
+}
+function getZodiacAnimal(branchIndex, locale = "vi") {
+  return translations[locale].zodiacAnimals[branchIndex % 12];
+}
+
 // src/core/feng-shui.ts
+function mod(n, m) {
+  return (n % m + m) % m;
+}
 function getYearDetails(year) {
-  const stemIndex = (year - 4) % 10;
-  const branchIndex = (year - 4) % 12;
+  const stemIndex = mod(year - 4, 10);
+  const branchIndex = mod(year - 4, 12);
   const stemWeight = getStemWeight(stemIndex);
   const branchWeight = getBranchWeight(branchIndex);
   let elementValue = stemWeight + branchWeight;
@@ -339,24 +414,27 @@ function getYearDetails(year) {
     fullString: `${HEAVENLY_STEMS[stemIndex]} ${EARTHLY_BRANCHES[branchIndex]} - M\u1EC7nh ${FIVE_ELEMENTS[elementIndex]}`
   };
 }
-function getDayCanChi(jd) {
+function getDayCanChi(jd, locale = "vi") {
   const stemIndex = (jd + 9) % 10;
   const branchIndex = (jd + 1) % 12;
-  return `${HEAVENLY_STEMS[stemIndex]} ${EARTHLY_BRANCHES[branchIndex]}`;
+  const { heavenlyStems, earthlyBranches } = t(locale);
+  return `${heavenlyStems[stemIndex]} ${earthlyBranches[branchIndex]}`;
 }
-function getMonthCanChi(lunarMonth, lunarYear) {
+function getMonthCanChi(lunarMonth, lunarYear, locale = "vi") {
   const yearStemIndex = (lunarYear + 6) % 10;
   const monthStemOffset = yearStemIndex % 5 * 2 + 2;
   const monthStemIndex = (monthStemOffset + lunarMonth - 1) % 10;
   const monthBranchIndex = (lunarMonth + 1) % 12;
-  return `${HEAVENLY_STEMS[monthStemIndex]} ${EARTHLY_BRANCHES[monthBranchIndex]}`;
+  const { heavenlyStems, earthlyBranches } = t(locale);
+  return `${heavenlyStems[monthStemIndex]} ${earthlyBranches[monthBranchIndex]}`;
 }
-function getHourCanChi(hour, dayJd) {
+function getHourCanChi(hour, dayJd, locale = "vi") {
   const hourBranchIndex = Math.floor((hour + 1) / 2) % 12;
   const dayStemIndex = (dayJd + 9) % 10;
   const hourStemOffset = dayStemIndex % 5 * 2;
   const hourStemIndex = (hourStemOffset + hourBranchIndex) % 10;
-  return `${HEAVENLY_STEMS[hourStemIndex]} ${EARTHLY_BRANCHES[hourBranchIndex]}`;
+  const { heavenlyStems, earthlyBranches } = t(locale);
+  return `${heavenlyStems[hourStemIndex]} ${earthlyBranches[hourBranchIndex]}`;
 }
 var AUSPICIOUS_HOURS_TABLE = [
   [0, 1, 3, 6, 7, 9],
@@ -372,11 +450,17 @@ var AUSPICIOUS_HOURS_TABLE = [
   [2, 5, 6, 8, 11, 0]
   // Ngày Tỵ (5) / Hợi (11)
 ];
-function getAuspiciousHours(dayJd) {
+function getAuspiciousHours(dayJd, locale = "vi") {
   const branchIndex = (dayJd + 1) % 12;
   const groupIndex = branchIndex % 6;
   const hourIndices = AUSPICIOUS_HOURS_TABLE[groupIndex];
-  return hourIndices.map((i) => EARTHLY_BRANCHES[i]);
+  const { earthlyBranches } = t(locale);
+  return hourIndices.map((i) => earthlyBranches[i]);
+}
+function getAuspiciousHourIndices(dayJd) {
+  const branchIndex = (dayJd + 1) % 12;
+  const groupIndex = branchIndex % 6;
+  return [...AUSPICIOUS_HOURS_TABLE[groupIndex]];
 }
 
 // src/utils/format.ts
@@ -435,7 +519,7 @@ function getDayName(day) {
   }
   return "Ba M\u01B0\u01A1i";
 }
-function formatLunarDate(lunar, pattern) {
+function formatLunarDate(lunar, pattern, locale = "vi") {
   let result = pattern;
   result = result.replace(/yyyy/g, String(lunar.year));
   result = result.replace(/yy/g, String(lunar.year).slice(-2));
@@ -444,7 +528,7 @@ function formatLunarDate(lunar, pattern) {
   result = result.replace(/CC/g, lunar.yearCanChi ?? "");
   result = result.replace(/DC/g, lunar.dayCanChi ?? "");
   result = result.replace(/MC/g, lunar.monthCanChi ?? "");
-  result = result.replace(/L/g, lunar.isLeap ? "Nhu\u1EADn" : "");
+  result = result.replace(/L/g, lunar.isLeap ? t(locale).leapLabel : "");
   result = result.replace(/(?<![0-9])d(?![0-9d])/g, String(lunar.day));
   result = result.replace(/(?<![0-9])M(?![0-9MC])/g, String(lunar.month));
   return result.trim();
@@ -457,69 +541,53 @@ function formatTraditional(lunar) {
   return `${dayName} th\xE1ng ${monthName}${leapSuffix} n\u0103m ${yearCanChi}`.trim();
 }
 
-// src/constants/i18n.ts
-var translations = {
-  vi: {
-    heavenlyStems: ["Gi\xE1p", "\u1EA4t", "B\xEDnh", "\u0110inh", "M\u1EADu", "K\u1EF7", "Canh", "T\xE2n", "Nh\xE2m", "Qu\xFD"],
-    earthlyBranches: ["T\xFD", "S\u1EEDu", "D\u1EA7n", "M\xE3o", "Th\xECn", "T\u1EF5", "Ng\u1ECD", "M\xF9i", "Th\xE2n", "D\u1EADu", "Tu\u1EA5t", "H\u1EE3i"],
-    fiveElements: ["Kim", "M\u1ED9c", "Th\u1EE7y", "H\u1ECFa", "Th\u1ED5"],
-    zodiacAnimals: ["Chu\u1ED9t", "Tr\xE2u", "C\u1ECDp", "Th\u1ECF", "R\u1ED3ng", "R\u1EAFn", "Ng\u1EF1a", "D\xEA", "Kh\u1EC9", "G\xE0", "Ch\xF3", "Heo"],
-    monthNames: ["Gi\xEAng", "Hai", "Ba", "T\u01B0", "N\u0103m", "S\xE1u", "B\u1EA3y", "T\xE1m", "Ch\xEDn", "M\u01B0\u1EDDi", "M\u1ED9t", "Ch\u1EA1p"],
-    weekDays: ["CN", "T2", "T3", "T4", "T5", "T6", "T7"],
-    leapLabel: "Nhu\u1EADn",
-    yearLabel: "N\u0103m",
-    monthLabel: "Th\xE1ng",
-    destiny: "M\u1EC7nh"
-  },
-  en: {
-    heavenlyStems: ["Gi\xE1p", "\u1EA4t", "B\xEDnh", "\u0110inh", "M\u1EADu", "K\u1EF7", "Canh", "T\xE2n", "Nh\xE2m", "Qu\xFD"],
-    earthlyBranches: ["T\xFD", "S\u1EEDu", "D\u1EA7n", "M\xE3o", "Th\xECn", "T\u1EF5", "Ng\u1ECD", "M\xF9i", "Th\xE2n", "D\u1EADu", "Tu\u1EA5t", "H\u1EE3i"],
-    fiveElements: ["Metal", "Wood", "Water", "Fire", "Earth"],
-    zodiacAnimals: ["Rat", "Ox", "Tiger", "Rabbit", "Dragon", "Snake", "Horse", "Goat", "Monkey", "Rooster", "Dog", "Pig"],
-    monthNames: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"],
-    weekDays: ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"],
-    leapLabel: "Leap",
-    yearLabel: "Year",
-    monthLabel: "Month",
-    destiny: "Destiny"
-  },
-  ja: {
-    heavenlyStems: ["\u7532", "\u4E59", "\u4E19", "\u4E01", "\u620A", "\u5DF1", "\u5E9A", "\u8F9B", "\u58EC", "\u7678"],
-    earthlyBranches: ["\u5B50", "\u4E11", "\u5BC5", "\u536F", "\u8FB0", "\u5DF3", "\u5348", "\u672A", "\u7533", "\u9149", "\u620C", "\u4EA5"],
-    fiveElements: ["\u91D1", "\u6728", "\u6C34", "\u706B", "\u571F"],
-    zodiacAnimals: ["\u9F20", "\u725B", "\u864E", "\u514E", "\u7ADC", "\u86C7", "\u99AC", "\u7F8A", "\u733F", "\u9D8F", "\u72AC", "\u732A"],
-    monthNames: ["1\u6708", "2\u6708", "3\u6708", "4\u6708", "5\u6708", "6\u6708", "7\u6708", "8\u6708", "9\u6708", "10\u6708", "11\u6708", "12\u6708"],
-    weekDays: ["\u65E5", "\u6708", "\u706B", "\u6C34", "\u6728", "\u91D1", "\u571F"],
-    leapLabel: "\u958F",
-    yearLabel: "\u5E74",
-    monthLabel: "\u6708",
-    destiny: "\u547D"
-  },
-  ko: {
-    heavenlyStems: ["\uAC11", "\uC744", "\uBCD1", "\uC815", "\uBB34", "\uAE30", "\uACBD", "\uC2E0", "\uC784", "\uACC4"],
-    earthlyBranches: ["\uC790", "\uCD95", "\uC778", "\uBB18", "\uC9C4", "\uC0AC", "\uC624", "\uBBF8", "\uC2E0", "\uC720", "\uC220", "\uD574"],
-    fiveElements: ["\uAE08", "\uBAA9", "\uC218", "\uD654", "\uD1A0"],
-    zodiacAnimals: ["\uC950", "\uC18C", "\uD638\uB791\uC774", "\uD1A0\uB07C", "\uC6A9", "\uBC40", "\uB9D0", "\uC591", "\uC6D0\uC22D\uC774", "\uB2ED", "\uAC1C", "\uB3FC\uC9C0"],
-    monthNames: ["1\uC6D4", "2\uC6D4", "3\uC6D4", "4\uC6D4", "5\uC6D4", "6\uC6D4", "7\uC6D4", "8\uC6D4", "9\uC6D4", "10\uC6D4", "11\uC6D4", "12\uC6D4"],
-    weekDays: ["\uC77C", "\uC6D4", "\uD654", "\uC218", "\uBAA9", "\uAE08", "\uD1A0"],
-    leapLabel: "\uC724",
-    yearLabel: "\uB144",
-    monthLabel: "\uC6D4",
-    destiny: "\uBA85"
-  }
-};
-function t(locale) {
-  return translations[locale];
+// src/utils/calendar-grid.ts
+function dateKey(date) {
+  return `${date.getFullYear()}-${date.getMonth() + 1}-${date.getDate()}`;
 }
-function getZodiacAnimal(branchIndex, locale = "vi") {
-  return translations[locale].zodiacAnimals[branchIndex % 12];
+function getCalendarGrid(month, year, selectedDate) {
+  const grid = [];
+  const firstDay = new Date(year, month - 1, 1);
+  const lastDay = new Date(year, month, 0);
+  const startingDayOfWeek = firstDay.getDay();
+  const daysInMonth = lastDay.getDate();
+  const todayKey = dateKey(/* @__PURE__ */ new Date());
+  const selectedKey = selectedDate ? dateKey(selectedDate) : "";
+  const prevMonthLastDay = new Date(year, month - 1, 0).getDate();
+  const pushCell = (solar, d, m, y, isCurrentMonth) => {
+    grid.push({
+      solar,
+      lunar: LichTa.toLunar(d, m, y),
+      isToday: dateKey(solar) === todayKey,
+      isSelected: dateKey(solar) === selectedKey,
+      isCurrentMonth
+    });
+  };
+  for (let i = startingDayOfWeek - 1; i >= 0; i--) {
+    const d = prevMonthLastDay - i;
+    const m = month - 1 < 1 ? 12 : month - 1;
+    const y = month - 1 < 1 ? year - 1 : year;
+    pushCell(new Date(y, m - 1, d), d, m, y, false);
+  }
+  for (let d = 1; d <= daysInMonth; d++) {
+    pushCell(new Date(year, month - 1, d), d, month, year, true);
+  }
+  const remaining = 42 - grid.length;
+  for (let d = 1; d <= remaining; d++) {
+    const m = month + 1 > 12 ? 1 : month + 1;
+    const y = month + 1 > 12 ? year + 1 : year;
+    pushCell(new Date(y, m - 1, d), d, m, y, false);
+  }
+  return grid;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   LichTa,
   formatLunarDate,
   formatTraditional,
+  getAuspiciousHourIndices,
   getAuspiciousHours,
+  getCalendarGrid,
   getDayCanChi,
   getDayName,
   getHourCanChi,