lichta 1.0.0-beta

package/dist/core/lunar.js

@@ -0,0 +1,335 @@
+import { HEAVENLY_STEMS } from '../constants/heavenly-stems.js';
+import { EARTHLY_BRANCHES } from '../constants/earthly-branches.js';
+/**
+ * Thuật toán chuyển đổi Dương lịch ↔ Âm lịch Việt Nam
+ * Dựa trên công trình của Hồ Ngọc Đức (Đại học Leipzig)
+ * Tham khảo: Jean Meeus, "Astronomical Algorithms" (1998)
+ *
+ * Copyright (c) 2006 Ho Ngoc Duc. All Rights Reserved.
+ * TypeScript adaptation for Lichta library.
+ */
+const PI = Math.PI;
+function INT(d) {
+    return Math.floor(d);
+}
+// ============================================================
+// Julian Day Number
+// ============================================================
+/**
+ * Chuyển ngày Gregorian sang Julian Day Number.
+ *
+ * @param dd - Ngày (1-31)
+ * @param mm - Tháng (1-12)
+ * @param yy - Năm
+ */
+export function jdFromDate(dd, mm, yy) {
+    const a = INT((14 - mm) / 12);
+    const y = yy + 4800 - a;
+    const m = mm + 12 * a - 3;
+    let jd = dd + INT((153 * m + 2) / 5) + 365 * y + INT(y / 4) - INT(y / 100) + INT(y / 400) - 32045;
+    if (jd < 2299161) {
+        jd = dd + INT((153 * m + 2) / 5) + 365 * y + INT(y / 4) - 32083;
+    }
+    return jd;
+}
+/**
+ * Chuyển Julian Day Number sang ngày Gregorian.
+ *
+ * @param jd - Julian Day Number
+ * @returns Tuple [day, month, year]
+ */
+export function jdToDate(jd) {
+    let a, b, c;
+    if (jd > 2299160) {
+        a = jd + 32044;
+        b = INT((4 * a + 3) / 146097);
+        c = a - INT((b * 146097) / 4);
+    }
+    else {
+        b = 0;
+        c = jd + 32082;
+    }
+    const d = INT((4 * c + 3) / 1461);
+    const e = c - INT((1461 * d) / 4);
+    const m = INT((5 * e + 2) / 153);
+    const day = e - INT((153 * m + 2) / 5) + 1;
+    const month = m + 3 - 12 * INT(m / 10);
+    const year = b * 100 + d - 4800 + INT(m / 10);
+    return [day, month, year];
+}
+// ============================================================
+// Điểm Sóc (New Moon) — Thuật toán Hồ Ngọc Đức / Jean Meeus
+// ============================================================
+/**
+ * Tính thời điểm điểm Sóc (New Moon) thứ k
+ * (đo bằng số ngày Julian kể từ 1/1/4713 BC trưa UTC).
+ *
+ * k=0 tương ứng New Moon ngày 1/1/1900 13:52 UTC.
+ *
+ * @param k - Số thứ tự New Moon
+ */
+function NewMoon(k) {
+    const T = k / 1236.85;
+    const T2 = T * T;
+    const T3 = T2 * T;
+    const dr = PI / 180;
+    let Jd1 = 2415020.75933 + 29.53058868 * k + 0.0001178 * T2 - 0.000000155 * T3;
+    Jd1 = Jd1 + 0.00033 * Math.sin((166.56 + 132.87 * T - 0.009173 * T2) * dr);
+    // Mean anomaly của Mặt Trời
+    const M = 359.2242 + 29.10535608 * k - 0.0000333 * T2 - 0.00000347 * T3;
+    // Mean anomaly của Mặt Trăng
+    const Mpr = 306.0253 + 385.81691806 * k + 0.0107306 * T2 + 0.00001236 * T3;
+    // Argument of latitude của Mặt Trăng
+    const F = 21.2964 + 390.67050646 * k - 0.0016528 * T2 - 0.00000239 * T3;
+    // Hiệu chỉnh
+    let C1 = (0.1734 - 0.000393 * T) * Math.sin(M * dr) + 0.0021 * Math.sin(2 * dr * M);
+    C1 = C1 - 0.4068 * Math.sin(Mpr * dr) + 0.0161 * Math.sin(dr * 2 * Mpr);
+    C1 = C1 - 0.0004 * Math.sin(dr * 3 * Mpr);
+    C1 = C1 + 0.0104 * Math.sin(dr * 2 * F) - 0.0051 * Math.sin(dr * (M + Mpr));
+    C1 = C1 - 0.0074 * Math.sin(dr * (M - Mpr)) + 0.0004 * Math.sin(dr * (2 * F + M));
+    C1 = C1 - 0.0004 * Math.sin(dr * (2 * F - M)) - 0.0006 * Math.sin(dr * (2 * F + Mpr));
+    C1 = C1 + 0.001 * Math.sin(dr * (2 * F - Mpr)) + 0.0005 * Math.sin(dr * (2 * Mpr + M));
+    const JdNew = Jd1 + C1;
+    return JdNew;
+}
+/**
+ * Tính ngày Julian (integer) của điểm Sóc thứ k theo múi giờ.
+ *
+ * @param k - Số thứ tự New Moon
+ * @param timeZone - Múi giờ (7 = GMT+7)
+ */
+export function getNewMoonDay(k, timeZone) {
+    return INT(NewMoon(k) + 0.5 + timeZone / 24);
+}
+// ============================================================
+// Kinh độ Mặt Trời (Sun Longitude)
+// ============================================================
+/**
+ * Tính kinh độ Mặt Trời tại ngày Julian cho trước.
+ * Trả về index 0-11 (mỗi 30°), dùng để xác định Trung khí.
+ *
+ * Index 9 = Đông Chí (270°-300°)
+ *
+ * @param jdn - Julian Day Number
+ * @param timeZone - Múi giờ
+ */
+export function getSunLongitude(jdn, timeZone) {
+    const T = (jdn - 2451545.5 - timeZone / 24) / 36525;
+    const T2 = T * T;
+    const dr = PI / 180;
+    // Mean longitude
+    const M = 357.5291 + 35999.0503 * T - 0.0001559 * T2 - 0.00000048 * T * T2;
+    // Mean longitude
+    const L0 = 280.46645 + 36000.76983 * T + 0.0003032 * T2;
+    let DL = (1.9146 - 0.004817 * T - 0.000014 * T2) * Math.sin(dr * M);
+    DL = DL + (0.019993 - 0.000101 * T) * Math.sin(dr * 2 * M) + 0.00029 * Math.sin(dr * 3 * M);
+    let L = L0 + DL;
+    // Chuẩn hóa
+    L = L - 360 * INT(L / 360);
+    return INT(L / 30);
+}
+// ============================================================
+// Tháng 11 âm lịch & Tháng nhuận
+// ============================================================
+/**
+ * Tìm JDN của mùng 1 tháng 11 âm lịch (tháng chứa Đông Chí).
+ */
+function getLunarMonth11(yy, timeZone) {
+    const off = jdFromDate(31, 12, yy) - 2415021.076998695;
+    const k = INT(off / 29.530588853);
+    let nm = getNewMoonDay(k, timeZone);
+    const sunLong = getSunLongitude(nm, timeZone);
+    if (sunLong >= 9) {
+        nm = getNewMoonDay(k - 1, timeZone);
+    }
+    return nm;
+}
+/**
+ * Tìm offset tháng nhuận (tháng đầu tiên không chứa Trung khí
+ * giữa 2 tháng 11 âm lịch liên tiếp).
+ */
+function getLeapMonthOffset(a11, timeZone) {
+    const k = INT((a11 - 2415021.076998695) / 29.530588853 + 0.5);
+    let last;
+    let i = 1;
+    let arc = getSunLongitude(getNewMoonDay(k + i, timeZone), timeZone);
+    last = arc;
+    while (i < 14) {
+        i++;
+        arc = getSunLongitude(getNewMoonDay(k + i, timeZone), timeZone);
+        if (arc !== last) {
+            last = arc;
+        }
+        else {
+            // 2 tháng liên tiếp cùng Trung khí → tháng trước đó là tháng nhuận
+            break;
+        }
+    }
+    return i - 1;
+}
+// ============================================================
+// Can Chi helpers
+// ============================================================
+function getYearCanChi(lunarYear) {
+    const stemIndex = (lunarYear + 6) % 10;
+    const branchIndex = (lunarYear + 8) % 12;
+    return `${HEAVENLY_STEMS[stemIndex]} ${EARTHLY_BRANCHES[branchIndex]}`;
+}
+function getMonthCanChiInternal(lunarMonth, lunarYear) {
+    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]}`;
+}
+function getDayCanChiInternal(jd) {
+    const stemIndex = (jd + 9) % 10;
+    const branchIndex = (jd + 1) % 12;
+    return `${HEAVENLY_STEMS[stemIndex]} ${EARTHLY_BRANCHES[branchIndex]}`;
+}
+// ============================================================
+// LichTa — Public API
+// ============================================================
+export class LichTa {
+    /**
+     * Chuyển đổi ngày Dương lịch sang Âm lịch.
+     *
+     * Sử dụng thuật toán Hồ Ngọc Đức để tìm Điểm Sóc và Tiết Khí,
+     * từ đó xác định ngày, tháng, năm âm lịch tương ứng.
+     *
+     * @param day - Ngày dương lịch (1-31)
+     * @param month - Tháng dương lịch (1-12)
+     * @param year - Năm dương lịch (1800-2199)
+     * @param timeZone - Múi giờ (mặc định: 7 cho GMT+7 Việt Nam)
+     * @returns Đối tượng LunarDate chứa thông tin ngày âm lịch
+     * @throws {RangeError} Khi input ngoài phạm vi hợp lệ
+     *
+     * @example
+     * ```typescript
+     * const lunar = LichTa.toLunar(10, 2, 2024);
+     * // → { day: 1, month: 1, year: 2024, isLeap: false, yearCanChi: 'Giáp Thìn' }
+     * ```
+     */
+    static toLunar(day, month, year, timeZone = 7) {
+        if (year < 1800 || year > 2199) {
+            throw new RangeError(`Lichta: Year must be between 1800 and 2199, got ${year}`);
+        }
+        if (month < 1 || month > 12) {
+            throw new RangeError(`Lichta: Month must be between 1 and 12, got ${month}`);
+        }
+        if (day < 1 || day > 31) {
+            throw new RangeError(`Lichta: Day must be between 1 and 31, got ${day}`);
+        }
+        const dayNumber = jdFromDate(day, month, year);
+        const k = INT((dayNumber - 2415021.076998695) / 29.530588853);
+        let monthStart = getNewMoonDay(k + 1, timeZone);
+        if (monthStart > dayNumber) {
+            monthStart = getNewMoonDay(k, timeZone);
+        }
+        let a11 = getLunarMonth11(year, timeZone);
+        let b11 = getLunarMonth11(year + 1, timeZone);
+        let lunarYear;
+        if (a11 >= monthStart) {
+            lunarYear = year;
+            a11 = getLunarMonth11(year - 1, timeZone);
+        }
+        else {
+            lunarYear = year + 1;
+            if (b11 <= monthStart) {
+                a11 = b11;
+                b11 = getLunarMonth11(year + 2, timeZone);
+            }
+            else {
+                lunarYear = year;
+            }
+        }
+        const diff = INT((monthStart - a11) / 29);
+        let lunarLeap = false;
+        let lunarMonth = diff + 11;
+        if (lunarMonth > 12) {
+            lunarMonth = lunarMonth - 12;
+        }
+        // Kiểm tra tháng nhuận
+        const leapMonthDiff = INT((b11 - a11) / 29) === 13 ? getLeapMonthOffset(a11, timeZone) : 0;
+        if (leapMonthDiff !== 0) {
+            if (diff === leapMonthDiff) {
+                lunarLeap = true;
+                lunarMonth = diff + 11;
+                if (lunarMonth > 12)
+                    lunarMonth -= 12;
+                lunarMonth -= 1;
+                if (lunarMonth <= 0)
+                    lunarMonth += 12;
+            }
+            else if (diff > leapMonthDiff) {
+                lunarMonth = diff + 11 - 1;
+                if (lunarMonth > 12)
+                    lunarMonth -= 12;
+            }
+        }
+        const lunarDay = dayNumber - monthStart + 1;
+        const yearCanChi = getYearCanChi(lunarYear);
+        const monthCanChi = getMonthCanChiInternal(lunarMonth, lunarYear);
+        const dayCanChi = getDayCanChiInternal(dayNumber);
+        return {
+            day: lunarDay,
+            month: lunarMonth,
+            year: lunarYear,
+            isLeap: lunarLeap,
+            jd: dayNumber,
+            dayCanChi,
+            monthCanChi,
+            yearCanChi,
+        };
+    }
+    /**
+     * Chuyển đổi ngày Âm lịch sang Dương lịch.
+     *
+     * @param lunarDay - Ngày âm lịch
+     * @param lunarMonth - Tháng âm lịch
+     * @param lunarYear - Năm âm lịch
+     * @param isLeap - Có phải tháng nhuận không
+     * @param timeZone - Múi giờ (mặc định: 7 cho GMT+7 Việt Nam)
+     * @returns Đối tượng SolarDate
+     * @throws {RangeError} Khi năm ngoài phạm vi 1800-2199
+     *
+     * @example
+     * ```typescript
+     * const solar = LichTa.toSolar(1, 1, 2024, false);
+     * // → { day: 10, month: 2, year: 2024 }
+     * ```
+     */
+    static toSolar(lunarDay, lunarMonth, lunarYear, isLeap = false, timeZone = 7) {
+        if (lunarYear < 1800 || lunarYear > 2199) {
+            throw new RangeError(`Lichta: Year must be between 1800 and 2199, got ${lunarYear}`);
+        }
+        let a11, b11;
+        if (lunarMonth < 11) {
+            a11 = getLunarMonth11(lunarYear - 1, timeZone);
+            b11 = getLunarMonth11(lunarYear, timeZone);
+        }
+        else {
+            a11 = getLunarMonth11(lunarYear, timeZone);
+            b11 = getLunarMonth11(lunarYear + 1, timeZone);
+        }
+        const k = INT(0.5 + (a11 - 2415021.076998695) / 29.530588853);
+        let off = lunarMonth - 11;
+        if (off < 0) {
+            off += 12;
+        }
+        // Xử lý tháng nhuận
+        if (INT((b11 - a11) / 29) === 13) {
+            const leapOff = getLeapMonthOffset(a11, timeZone);
+            if (off >= leapOff) {
+                off += 1;
+                if (isLeap) {
+                    // isLeap flag đã đúng vị trí, không cần thêm offset
+                }
+            }
+        }
+        const nm = getNewMoonDay(k + off, timeZone);
+        const jd = nm + lunarDay - 1;
+        const [day, month, year] = jdToDate(jd);
+        return { day, month, year };
+    }
+}

package/dist/core/types.d.ts

@@ -0,0 +1,17 @@
+/** Kết quả chuyển đổi sang Âm lịch */
+export interface LunarDate {
+    day: number;
+    month: number;
+    year: number;
+    isLeap: boolean;
+    jd: number;
+    dayCanChi?: string;
+    monthCanChi?: string;
+    yearCanChi?: string;
+}
+/** Kết quả chuyển đổi sang Dương lịch */
+export interface SolarDate {
+    day: number;
+    month: number;
+    year: number;
+}

package/dist/core/types.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { LichTa, jdFromDate, jdToDate } from './core/lunar.js';
+export type { LunarDate, SolarDate } from './core/types.js';
+export { getYearDetails, getDayCanChi, getMonthCanChi, getHourCanChi, getAuspiciousHours, } from './core/feng-shui.js';
+export { formatLunarDate, formatTraditional, getMonthName, getDayName } from './utils/format.js';
+export { t, getZodiacAnimal } from './constants/i18n.js';
+export type { Locale } from './constants/i18n.js';
+export { default as Formatter } from './components/Formatter.svelte';
+export { default as Calendar } from './components/Calendar.svelte';

package/dist/index.js

@@ -0,0 +1,14 @@
+// ============================================================
+// Lichta — Public API (Root Entry Point)
+// ============================================================
+// Xuất bản phần lõi TypeScript (Cho những ai chỉ muốn dùng logic toán học)
+export { LichTa, jdFromDate, jdToDate } from './core/lunar.js';
+// Xuất bản phần phong thủy
+export { getYearDetails, getDayCanChi, getMonthCanChi, getHourCanChi, getAuspiciousHours, } from './core/feng-shui.js';
+// Xuất bản phần format/tiện ích
+export { formatLunarDate, formatTraditional, getMonthName, getDayName } from './utils/format.js';
+// Xuất bản phần i18n
+export { t, getZodiacAnimal } from './constants/i18n.js';
+// Xuất bản phần Svelte Component (Cho những ai muốn dùng UI ăn liền)
+export { default as Formatter } from './components/Formatter.svelte';
+export { default as Calendar } from './components/Calendar.svelte';

package/dist/utils/format.d.ts

@@ -0,0 +1,74 @@
+import type { LunarDate } from '../core/types.js';
+/**
+ * Lấy tên tháng âm lịch dạng chữ truyền thống.
+ *
+ * @param month - Tháng âm lịch (1-12)
+ * @returns Tên tháng (ví dụ: 1 → "Giêng", 12 → "Chạp")
+ *
+ * @example
+ * ```typescript
+ * getMonthName(1);  // "Giêng"
+ * getMonthName(12); // "Chạp"
+ * ```
+ */
+export declare function getMonthName(month: number): string;
+/**
+ * Lấy tên ngày âm lịch theo cách gọi truyền thống Việt Nam.
+ *
+ * - 1-10: "Mùng Một", "Mùng Hai", ..., "Mùng Mười"
+ * - 11-20: "Mười Một", ..., "Hai Mươi"
+ * - 21-30: "Hăm Mốt", "Hăm Hai", ..., "Ba Mươi"
+ *
+ * @param day - Ngày âm lịch (1-30)
+ *
+ * @example
+ * ```typescript
+ * getDayName(1);  // "Mùng Một"
+ * getDayName(15); // "Rằm"
+ * getDayName(30); // "Ba Mươi"
+ * ```
+ */
+export declare function getDayName(day: number): string;
+/**
+ * Format ngày âm lịch theo pattern.
+ *
+ * **Patterns hỗ trợ:**
+ * | Token | Mô tả                                    | Ví dụ          |
+ * |-------|------------------------------------------|----------------|
+ * | `dd`  | Ngày 2 chữ số                            | 01, 15, 30     |
+ * | `d`   | Ngày                                     | 1, 15, 30      |
+ * | `MM`  | Tháng 2 chữ số                           | 01, 12         |
+ * | `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          |
+ * | `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
+ *
+ * @example
+ * ```typescript
+ * formatLunarDate(lunar, 'dd/MM/yyyy');
+ * // → "01/01/2024"
+ *
+ * formatLunarDate(lunar, 'Ngày d tháng M năm CC');
+ * // → "Ngày 1 tháng 1 năm Giáp Thìn"
+ * ```
+ */
+export declare function formatLunarDate(lunar: LunarDate, pattern: string): string;
+/**
+ * Format ngày âm lịch theo kiểu truyền thống Việt Nam.
+ *
+ * @param lunar - Đối tượng LunarDate
+ * @returns Chuỗi truyền thống (ví dụ: "Mùng Một tháng Giêng năm Giáp Thìn")
+ *
+ * @example
+ * ```typescript
+ * formatTraditional(lunar);
+ * // → "Mùng Một tháng Giêng năm Giáp Thìn"
+ * ```
+ */
+export declare function formatTraditional(lunar: LunarDate): string;

package/dist/utils/format.js

@@ -0,0 +1,150 @@
+// ============================================================
+// Tên tháng & ngày truyền thống
+// ============================================================
+/** Tên tháng âm lịch truyền thống */
+const MONTH_NAMES = [
+    'Giêng', 'Hai', 'Ba', 'Tư', 'Năm', 'Sáu',
+    'Bảy', 'Tám', 'Chín', 'Mười', 'Một', 'Chạp',
+];
+/** Tên số đếm truyền thống */
+const DAY_UNITS = [
+    '', 'Một', 'Hai', 'Ba', 'Bốn', 'Năm',
+    'Sáu', 'Bảy', 'Tám', 'Chín', 'Mười',
+];
+/**
+ * Lấy tên tháng âm lịch dạng chữ truyền thống.
+ *
+ * @param month - Tháng âm lịch (1-12)
+ * @returns Tên tháng (ví dụ: 1 → "Giêng", 12 → "Chạp")
+ *
+ * @example
+ * ```typescript
+ * getMonthName(1);  // "Giêng"
+ * getMonthName(12); // "Chạp"
+ * ```
+ */
+export function getMonthName(month) {
+    if (month < 1 || month > 12) {
+        throw new RangeError(`Lichta: Month must be between 1 and 12, got ${month}`);
+    }
+    return MONTH_NAMES[month - 1];
+}
+/**
+ * Lấy tên ngày âm lịch theo cách gọi truyền thống Việt Nam.
+ *
+ * - 1-10: "Mùng Một", "Mùng Hai", ..., "Mùng Mười"
+ * - 11-20: "Mười Một", ..., "Hai Mươi"
+ * - 21-30: "Hăm Mốt", "Hăm Hai", ..., "Ba Mươi"
+ *
+ * @param day - Ngày âm lịch (1-30)
+ *
+ * @example
+ * ```typescript
+ * getDayName(1);  // "Mùng Một"
+ * getDayName(15); // "Rằm"
+ * getDayName(30); // "Ba Mươi"
+ * ```
+ */
+export function getDayName(day) {
+    if (day < 1 || day > 30) {
+        throw new RangeError(`Lichta: Day must be between 1 and 30, got ${day}`);
+    }
+    // Ngày Rằm
+    if (day === 15)
+        return 'Rằm';
+    // Mùng 1-10
+    if (day <= 10) {
+        return `Mùng ${DAY_UNITS[day]}`;
+    }
+    // 11-19
+    if (day < 20) {
+        if (day === 11)
+            return 'Mười Một';
+        if (day === 14)
+            return 'Mười Bốn';
+        return `Mười ${DAY_UNITS[day - 10]}`;
+    }
+    // 20
+    if (day === 20)
+        return 'Hai Mươi';
+    // 21-29
+    if (day < 30) {
+        if (day === 21)
+            return 'Hăm Mốt';
+        if (day === 24)
+            return 'Hăm Tư';
+        if (day === 25)
+            return 'Hăm Lăm';
+        return `Hăm ${DAY_UNITS[day - 20]}`;
+    }
+    // 30
+    return 'Ba Mươi';
+}
+// ============================================================
+// Format functions
+// ============================================================
+/**
+ * Format ngày âm lịch theo pattern.
+ *
+ * **Patterns hỗ trợ:**
+ * | Token | Mô tả                                    | Ví dụ          |
+ * |-------|------------------------------------------|----------------|
+ * | `dd`  | Ngày 2 chữ số                            | 01, 15, 30     |
+ * | `d`   | Ngày                                     | 1, 15, 30      |
+ * | `MM`  | Tháng 2 chữ số                           | 01, 12         |
+ * | `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          |
+ * | `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
+ *
+ * @example
+ * ```typescript
+ * formatLunarDate(lunar, 'dd/MM/yyyy');
+ * // → "01/01/2024"
+ *
+ * formatLunarDate(lunar, 'Ngày d tháng M năm CC');
+ * // → "Ngày 1 tháng 1 năm Giáp Thìn"
+ * ```
+ */
+export function formatLunarDate(lunar, pattern) {
+    let result = pattern;
+    // Thay thế theo thứ tự dài → ngắn để tránh xung đột (yyyy trước yy, dd trước d, MM trước M)
+    result = result.replace(/yyyy/g, String(lunar.year));
+    result = result.replace(/yy/g, String(lunar.year).slice(-2));
+    result = result.replace(/dd/g, String(lunar.day).padStart(2, '0'));
+    result = result.replace(/MM/g, String(lunar.month).padStart(2, '0'));
+    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ận' : '');
+    // Thay d và M cuối cùng (sau khi dd, MM đã được xử lý, tránh double-replace)
+    // Dùng regex negative lookbehind để không match các token đã được thay
+    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();
+}
+/**
+ * Format ngày âm lịch theo kiểu truyền thống Việt Nam.
+ *
+ * @param lunar - Đối tượng LunarDate
+ * @returns Chuỗi truyền thống (ví dụ: "Mùng Một tháng Giêng năm Giáp Thìn")
+ *
+ * @example
+ * ```typescript
+ * formatTraditional(lunar);
+ * // → "Mùng Một tháng Giêng năm Giáp Thìn"
+ * ```
+ */
+export function formatTraditional(lunar) {
+    const dayName = getDayName(lunar.day);
+    const monthName = getMonthName(lunar.month);
+    const leapSuffix = lunar.isLeap ? ' Nhuận' : '';
+    const yearCanChi = lunar.yearCanChi ?? '';
+    return `${dayName} tháng ${monthName}${leapSuffix} năm ${yearCanChi}`.trim();
+}

package/dist/utils/index.d.ts

@@ -0,0 +1 @@
+export { formatLunarDate, formatTraditional, getMonthName, getDayName } from './format.js';

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+// Xuất bản các hàm format/tiện ích
+export { formatLunarDate, formatTraditional, getMonthName, getDayName } from './format.js';