lichta 1.0.0-beta

package/dist/components/Formatter.svelte

@@ -0,0 +1,57 @@
+<script lang="ts">
+  import { LichTa } from '../core/lunar.js';
+  import type { LunarDate } from '../core/types.js';
+  import type { Snippet } from 'svelte';
+
+  // Props nhận vào từ consumer ứng dụng
+  interface Props {
+    date?: Date;
+    children?: Snippet;
+  }
+  let { date = new Date(), children }: Props = $props();
+
+  // Khai báo biến reactive tự động tính toán lại khi `date` thay đổi
+  let lunar: LunarDate = $derived.by(() => {
+    const d = date.getDate();
+    const m = date.getMonth() + 1; // Tháng trong JS tính từ 0
+    const y = date.getFullYear();
+    return LichTa.toLunar(d, m, y);
+  });
+</script>
+
+<div class="lich-ta-formatter">
+  <div class="lunar-display-banner">
+    <span class="lunar-date">Ngày {lunar.day} tháng {lunar.month} (Âm lịch)</span>
+    <span class="can-chi-details">Năm {lunar.yearCanChi}</span>
+  </div>
+
+  <div class="control-slot-wrapper">
+    {@render children?.()}
+  </div>
+</div>
+
+<style>
+  .lich-ta-formatter {
+    display: block;
+    width: 100%;
+    box-sizing: border-box;
+  }
+  .lunar-display-banner {
+    padding: 12px;
+    background-color: #fcfaf7;
+    border-left: 4px solid #d4a373;
+    margin-bottom: 16px;
+  }
+  .lunar-date {
+    display: block;
+    font-weight: bold;
+    font-size: 1.1rem;
+    color: #1a1a1a;
+  }
+  .can-chi-details {
+    display: block;
+    font-size: 0.9rem;
+    color: #666666;
+    margin-top: 4px;
+  }
+</style>

package/dist/components/Formatter.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { Snippet } from 'svelte';
+interface Props {
+    date?: Date;
+    children?: Snippet;
+}
+declare const Formatter: import("svelte").Component<Props, {}, "">;
+type Formatter = ReturnType<typeof Formatter>;
+export default Formatter;

package/dist/constants/earthly-branches.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Earthly Branches (Địa Chi - 12 con giáp)
+ * Tý       | Rat (Chuột)
+ * Sửu      | Ox (Trâu)
+ * Dần      | Tiger (Cọp)
+ * Mão      | Rabbit (Thỏ)
+ * Thìn     | Dragon (Rồng)
+ * Tỵ       | Snake (Rắn)
+ * Ngọ      | Horse (Ngựa)
+ * Mùi      | Goat (Dê)
+ * Thân     | Monkey (Khỉ)
+ * Dậu      | Rooster (Gà)
+ * Tuất     | Dog (Chó)
+ * Hợi      | Pig (Heo)
+ */
+export declare const EARTHLY_BRANCHES: readonly ["Tý", "Sửu", "Dần", "Mão", "Thìn", "Tỵ", "Ngọ", "Mùi", "Thân", "Dậu", "Tuất", "Hợi"];
+/**
+ * Tính trọng số của Địa Chi (dùng để tính Ngũ Hành)
+ * Chu kỳ lặp lại sau mỗi 6 Chi (index % 6)
+ */
+export declare function getBranchWeight(index: number): number;
+/**
+ * Tính Dương - Âm (Yin - Yang) cho Địa Chi
+ * Index: 0 -> 1 (Dương) | 1 -> 0 (Âm) | ...
+ */
+export declare function getBranchYinYang(index: number): 1 | 0;
+/**
+ * Tính Ngũ Hành cho Địa Chi
+ * Tý: 1 (Thủy Dương), Sửu: 12 (Thổ Âm), Dần: 3 (Mộc Dương), ...
+ */
+export declare function getBranchElement(index: number): number;

package/dist/constants/earthly-branches.js

@@ -0,0 +1,42 @@
+/**
+ * Earthly Branches (Địa Chi - 12 con giáp)
+ * Tý       | Rat (Chuột)
+ * Sửu      | Ox (Trâu)
+ * Dần      | Tiger (Cọp)
+ * Mão      | Rabbit (Thỏ)
+ * Thìn     | Dragon (Rồng)
+ * Tỵ       | Snake (Rắn)
+ * Ngọ      | Horse (Ngựa)
+ * Mùi      | Goat (Dê)
+ * Thân     | Monkey (Khỉ)
+ * Dậu      | Rooster (Gà)
+ * Tuất     | Dog (Chó)
+ * Hợi      | Pig (Heo)
+ */
+export const EARTHLY_BRANCHES = [
+    'Tý', 'Sửu', 'Dần', 'Mão', 'Thìn', 'Tỵ',
+    'Ngọ', 'Mùi', 'Thân', 'Dậu', 'Tuất', 'Hợi'
+];
+/**
+ * Tính trọng số của Địa Chi (dùng để tính Ngũ Hành)
+ * Chu kỳ lặp lại sau mỗi 6 Chi (index % 6)
+ */
+export function getBranchWeight(index) {
+    const normalizedIndex = index % 6;
+    return Math.floor(normalizedIndex / 2);
+}
+/**
+ * Tính Dương - Âm (Yin - Yang) cho Địa Chi
+ * Index: 0 -> 1 (Dương) | 1 -> 0 (Âm) | ...
+ */
+export function getBranchYinYang(index) {
+    return (index % 2 === 0) ? 1 : 0;
+}
+/**
+ * Tính Ngũ Hành cho Địa Chi
+ * Tý: 1 (Thủy Dương), Sửu: 12 (Thổ Âm), Dần: 3 (Mộc Dương), ...
+ */
+export function getBranchElement(index) {
+    const weight = Math.floor(index / 2) + 1;
+    return weight === 5 ? 1 : weight;
+}

package/dist/constants/five-elements.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Five Elements (Ngũ Hành)
+ * Kim       | Metal
+ * Mộc       | Wood
+ * Thủy      | Water
+ * Hỏa       | Fire
+ * Thổ       | Earth
+ */
+export declare const FIVE_ELEMENTS: string[];

package/dist/constants/five-elements.js

@@ -0,0 +1,9 @@
+/**
+ * Five Elements (Ngũ Hành)
+ * Kim       | Metal
+ * Mộc       | Wood
+ * Thủy      | Water
+ * Hỏa       | Fire
+ * Thổ       | Earth
+ */
+export const FIVE_ELEMENTS = ['Kim', 'Mộc', 'Thủy', 'Hỏa', 'Thổ'];

package/dist/constants/heavenly-stems.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Heavenly Stems (Thiên Can)
+ * Giáp (Dương)     | Wood
+ * Ất (Âm)          | Wood
+ * Bính (Dương)     | Fire
+ * Đinh (Âm)        | Fire
+ * Mậu (Dương)      | Earth
+ * Kỷ (Âm)          | Earth
+ * Canh (Dương)     | Metal
+ * Tân (Âm)         | Metal
+ * Nhâm (Dương)     | Water
+ * Quý (Âm)         | Water
+ */
+export declare const HEAVENLY_STEMS: readonly ["Giáp", "Ất", "Bính", "Đinh", "Mậu", "Kỷ", "Canh", "Tân", "Nhâm", "Quý"];
+/**
+ * Tính trọng số của Thiên Can (dùng để tính Ngũ Hành)
+ * Index: 0, 1 -> 1 | 2, 3 -> 2 | ... | 8, 9 -> 5
+ */
+export declare function getStemWeight(index: number): number;

package/dist/constants/heavenly-stems.js

@@ -0,0 +1,24 @@
+/**
+ * Heavenly Stems (Thiên Can)
+ * Giáp (Dương)     | Wood
+ * Ất (Âm)          | Wood
+ * Bính (Dương)     | Fire
+ * Đinh (Âm)        | Fire
+ * Mậu (Dương)      | Earth
+ * Kỷ (Âm)          | Earth
+ * Canh (Dương)     | Metal
+ * Tân (Âm)         | Metal
+ * Nhâm (Dương)     | Water
+ * Quý (Âm)         | Water
+ */
+export const HEAVENLY_STEMS = [
+    'Giáp', 'Ất', 'Bính', 'Đinh', 'Mậu',
+    'Kỷ', 'Canh', 'Tân', 'Nhâm', 'Quý'
+];
+/**
+ * Tính trọng số của Thiên Can (dùng để tính Ngũ Hành)
+ * Index: 0, 1 -> 1 | 2, 3 -> 2 | ... | 8, 9 -> 5
+ */
+export function getStemWeight(index) {
+    return Math.floor(index / 2) + 1;
+}

package/dist/constants/i18n.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Internationalization — Hỗ trợ song ngữ Việt-Anh
+ */
+export type Locale = 'vi' | 'en' | 'ja' | 'ko';
+/**
+ * Lấy bộ dịch theo locale
+ * @param locale - Ngôn ngữ ('vi' | 'en' | 'ja' | 'ko')
+ */
+export 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ữ
+ */
+export declare function getZodiacAnimal(branchIndex: number, locale?: Locale): string;

package/dist/constants/i18n.js

@@ -0,0 +1,65 @@
+const translations = {
+    vi: {
+        heavenlyStems: ['Giáp', 'Ất', 'Bính', 'Đinh', 'Mậu', 'Kỷ', 'Canh', 'Tân', 'Nhâm', 'Quý'],
+        earthlyBranches: ['Tý', 'Sửu', 'Dần', 'Mão', 'Thìn', 'Tỵ', 'Ngọ', 'Mùi', 'Thân', 'Dậu', 'Tuất', 'Hợi'],
+        fiveElements: ['Kim', 'Mộc', 'Thủy', 'Hỏa', 'Thổ'],
+        zodiacAnimals: ['Chuột', 'Trâu', 'Cọp', 'Thỏ', 'Rồng', 'Rắn', 'Ngựa', 'Dê', 'Khỉ', 'Gà', 'Chó', 'Heo'],
+        monthNames: ['Giêng', 'Hai', 'Ba', 'Tư', 'Năm', 'Sáu', 'Bảy', 'Tám', 'Chín', 'Mười', 'Một', 'Chạp'],
+        weekDays: ['CN', 'T2', 'T3', 'T4', 'T5', 'T6', 'T7'],
+        leapLabel: 'Nhuận',
+        yearLabel: 'Năm',
+        monthLabel: 'Tháng',
+        destiny: 'Mệnh',
+    },
+    en: {
+        heavenlyStems: ['Giáp', 'Ất', 'Bính', 'Đinh', 'Mậu', 'Kỷ', 'Canh', 'Tân', 'Nhâm', 'Quý'],
+        earthlyBranches: ['Tý', 'Sửu', 'Dần', 'Mão', 'Thìn', 'Tỵ', 'Ngọ', 'Mùi', 'Thân', 'Dậu', 'Tuất', 'Hợi'],
+        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: ['甲', '乙', '丙', '丁', '戊', '己', '庚', '辛', '壬', '癸'],
+        earthlyBranches: ['子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥'],
+        fiveElements: ['金', '木', '水', '火', '土'],
+        zodiacAnimals: ['鼠', '牛', '虎', '兎', '竜', '蛇', '馬', '羊', '猿', '鶏', '犬', '猪'],
+        monthNames: ['1月', '2月', '3月', '4月', '5月', '6月', '7月', '8月', '9月', '10月', '11月', '12月'],
+        weekDays: ['日', '月', '火', '水', '木', '金', '土'],
+        leapLabel: '閏',
+        yearLabel: '年',
+        monthLabel: '月',
+        destiny: '命',
+    },
+    ko: {
+        heavenlyStems: ['갑', '을', '병', '정', '무', '기', '경', '신', '임', '계'],
+        earthlyBranches: ['자', '축', '인', '묘', '진', '사', '오', '미', '신', '유', '술', '해'],
+        fiveElements: ['금', '목', '수', '화', '토'],
+        zodiacAnimals: ['쥐', '소', '호랑이', '토끼', '용', '뱀', '말', '양', '원숭이', '닭', '개', '돼지'],
+        monthNames: ['1월', '2월', '3월', '4월', '5월', '6월', '7월', '8월', '9월', '10월', '11월', '12월'],
+        weekDays: ['일', '월', '화', '수', '목', '금', '토'],
+        leapLabel: '윤',
+        yearLabel: '년',
+        monthLabel: '월',
+        destiny: '명',
+    },
+};
+/**
+ * Lấy bộ dịch theo locale
+ * @param locale - Ngôn ngữ ('vi' | 'en' | 'ja' | 'ko')
+ */
+export function t(locale) {
+    return translations[locale];
+}
+/**
+ * Lấy tên con giáp theo locale
+ * @param branchIndex - Index Địa Chi (0-11)
+ * @param locale - Ngôn ngữ
+ */
+export function getZodiacAnimal(branchIndex, locale = 'vi') {
+    return translations[locale].zodiacAnimals[branchIndex % 12];
+}

package/dist/core/feng-shui.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 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)
+ */
+export 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";
+    menh: string;
+    fullString: string;
+};
+/**
+ * Tính Can Chi ngày từ Julian Day Number.
+ *
+ * @param jd - Julian Day Number
+ * @returns Chuỗi Can Chi (ví dụ: "Giáp Tý")
+ */
+export declare function getDayCanChi(jd: number): 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):
+ *   - Năm Giáp/Kỷ  → Tháng Giêng bắt đầu bằng Bính (index 2)
+ *   - Năm Ất/Canh  → Tháng Giêng bắt đầu bằng Mậu (index 4)
+ *   - Năm Bính/Tân → Tháng Giêng bắt đầu bằng Canh (index 6)
+ *   - Năm Đinh/Nhâm → Tháng Giêng bắt đầu bằng Nhâm (index 8)
+ *   - Năm Mậu/Quý  → Tháng Giêng bắt đầu bằng Giáp (index 0)
+ *
+ * @param lunarMonth - Tháng âm lịch (1-12)
+ * @param lunarYear - Năm âm lịch
+ */
+export declare function getMonthCanChi(lunarMonth: number, lunarYear: number): string;
+/**
+ * Tính Can Chi giờ từ giờ (0-23) và Julian Day Number của ngày.
+ *
+ * 12 canh giờ (mỗi canh = 2 tiếng):
+ *   Tý: 23h-01h, Sửu: 01h-03h, Dần: 03h-05h, ...
+ *
+ * Can giờ Tý phụ thuộc Can ngày (quy tắc Ngũ Thử Độn):
+ *   - Ngày Giáp/Kỷ → Giờ Tý bắt đầu bằng Giáp
+ *   - Ngày Ất/Canh → Giờ Tý bắt đầu bằng Bính
+ *   - Ngày Bính/Tân → Giờ Tý bắt đầu bằng Mậu
+ *   - Ngày Đinh/Nhâm → Giờ Tý bắt đầu bằng Canh
+ *   - Ngày Mậu/Quý → Giờ Tý bắt đầu bằng Nhâm
+ *
+ * @param hour - Giờ (0-23)
+ * @param dayJd - Julian Day Number của ngày
+ */
+export declare function getHourCanChi(hour: number, dayJd: number): 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
+ * @returns Mảng 6 chuỗi tên Địa Chi (ví dụ: ["Tý", "Sửu", "Mão", "Ngọ", "Mùi", "Dậu"])
+ */
+export declare function getAuspiciousHours(dayJd: number): string[];

package/dist/core/feng-shui.js

@@ -0,0 +1,116 @@
+import { HEAVENLY_STEMS, getStemWeight } from '../constants/heavenly-stems.js';
+import { EARTHLY_BRANCHES, getBranchWeight } from '../constants/earthly-branches.js';
+import { FIVE_ELEMENTS } from '../constants/five-elements.js';
+/**
+ * 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)
+ */
+export function getYearDetails(year) {
+    // Tính index của Can và Chi dựa trên mốc năm gốc
+    // Năm 1984, 2044 là Giáp Tý -> Offset để tính toán dễ nhất là lấy (year - 4) % hệ cơ số
+    const stemIndex = (year - 4) % 10;
+    const branchIndex = (year - 4) % 12;
+    // Công thức vàng tính Ngũ Hành
+    const stemWeight = getStemWeight(stemIndex);
+    const branchWeight = getBranchWeight(branchIndex);
+    let elementValue = stemWeight + branchWeight;
+    if (elementValue > 5) {
+        elementValue -= 5;
+    }
+    // Value ra từ 1-5, nên trừ 1 để lấy index của mảng FIVE_ELEMENTS (0-4)
+    const elementIndex = elementValue - 1;
+    return {
+        can: HEAVENLY_STEMS[stemIndex],
+        chi: EARTHLY_BRANCHES[branchIndex],
+        menh: FIVE_ELEMENTS[elementIndex],
+        fullString: `${HEAVENLY_STEMS[stemIndex]} ${EARTHLY_BRANCHES[branchIndex]} - Mệnh ${FIVE_ELEMENTS[elementIndex]}`
+    };
+}
+// ============================================================
+// Can Chi cho Ngày, Tháng, Giờ
+// ============================================================
+/**
+ * Tính Can Chi ngày từ Julian Day Number.
+ *
+ * @param jd - Julian Day Number
+ * @returns Chuỗi Can Chi (ví dụ: "Giáp Tý")
+ */
+export function getDayCanChi(jd) {
+    const stemIndex = (jd + 9) % 10;
+    const branchIndex = (jd + 1) % 12;
+    return `${HEAVENLY_STEMS[stemIndex]} ${EARTHLY_BRANCHES[branchIndex]}`;
+}
+/**
+ * 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):
+ *   - Năm Giáp/Kỷ  → Tháng Giêng bắt đầu bằng Bính (index 2)
+ *   - Năm Ất/Canh  → Tháng Giêng bắt đầu bằng Mậu (index 4)
+ *   - Năm Bính/Tân → Tháng Giêng bắt đầu bằng Canh (index 6)
+ *   - Năm Đinh/Nhâm → Tháng Giêng bắt đầu bằng Nhâm (index 8)
+ *   - Năm Mậu/Quý  → Tháng Giêng bắt đầu bằng Giáp (index 0)
+ *
+ * @param lunarMonth - Tháng âm lịch (1-12)
+ * @param lunarYear - Năm âm lịch
+ */
+export function getMonthCanChi(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]}`;
+}
+/**
+ * Tính Can Chi giờ từ giờ (0-23) và Julian Day Number của ngày.
+ *
+ * 12 canh giờ (mỗi canh = 2 tiếng):
+ *   Tý: 23h-01h, Sửu: 01h-03h, Dần: 03h-05h, ...
+ *
+ * Can giờ Tý phụ thuộc Can ngày (quy tắc Ngũ Thử Độn):
+ *   - Ngày Giáp/Kỷ → Giờ Tý bắt đầu bằng Giáp
+ *   - Ngày Ất/Canh → Giờ Tý bắt đầu bằng Bính
+ *   - Ngày Bính/Tân → Giờ Tý bắt đầu bằng Mậu
+ *   - Ngày Đinh/Nhâm → Giờ Tý bắt đầu bằng Canh
+ *   - Ngày Mậu/Quý → Giờ Tý bắt đầu bằng Nhâm
+ *
+ * @param hour - Giờ (0-23)
+ * @param dayJd - Julian Day Number của ngày
+ */
+export function getHourCanChi(hour, dayJd) {
+    // Tính Địa Chi của giờ: Tý từ 23h, mỗi canh 2 tiếng
+    const hourBranchIndex = Math.floor((hour + 1) / 2) % 12;
+    // Tính Thiên Can của giờ dựa vào Can ngày
+    const dayStemIndex = (dayJd + 9) % 10;
+    const hourStemOffset = (dayStemIndex % 5) * 2;
+    const hourStemIndex = (hourStemOffset + hourBranchIndex) % 10;
+    return `${HEAVENLY_STEMS[hourStemIndex]} ${EARTHLY_BRANCHES[hourBranchIndex]}`;
+}
+// ============================================================
+// Giờ Hoàng Đạo
+// ============================================================
+/**
+ * Bảng giờ Hoàng Đạo theo Chi của ngày.
+ * Mỗi hàng tương ứng với 2 Chi (Tý-Ngọ, Sửu-Mùi, ...) → 6 nhóm.
+ * Giá trị là index các Địa Chi tốt (6 giờ tốt trong 12 canh).
+ */
+const AUSPICIOUS_HOURS_TABLE = [
+    [0, 1, 3, 6, 7, 9], // Ngày Tý (0) / Ngọ (6)
+    [2, 3, 5, 8, 9, 11], // Ngày Sửu (1) / Mùi (7)
+    [0, 1, 4, 5, 7, 10], // Ngày Dần (2) / Thân (8)
+    [1, 2, 4, 7, 8, 10], // Ngày Mão (3) / Dậu (9)
+    [0, 3, 4, 6, 9, 10], // Ngày Thìn (4) / Tuất (10)
+    [2, 5, 6, 8, 11, 0], // Ngày Tỵ (5) / Hợi (11)
+];
+/**
+ * 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
+ * @returns Mảng 6 chuỗi tên Địa Chi (ví dụ: ["Tý", "Sửu", "Mão", "Ngọ", "Mùi", "Dậu"])
+ */
+export function getAuspiciousHours(dayJd) {
+    const branchIndex = (dayJd + 1) % 12;
+    // Nhóm theo 2 Chi (Tý-Ngọ, Sửu-Mùi, ...)
+    const groupIndex = branchIndex % 6;
+    const hourIndices = AUSPICIOUS_HOURS_TABLE[groupIndex];
+    return hourIndices.map((i) => EARTHLY_BRANCHES[i]);
+}

package/dist/core/index.d.ts

@@ -0,0 +1,3 @@
+export { LichTa, jdFromDate, jdToDate, getNewMoonDay, getSunLongitude } from './lunar.js';
+export { getYearDetails, getDayCanChi, getMonthCanChi, getHourCanChi, getAuspiciousHours, } from './feng-shui.js';
+export type { LunarDate, SolarDate } from './types.js';

package/dist/core/index.js

@@ -0,0 +1,4 @@
+// Xuất bản phần lõi TypeScript — KHÔNG có Svelte dependencies
+// Dành cho React, Vue, Angular, vanilla JS consumers
+export { LichTa, jdFromDate, jdToDate, getNewMoonDay, getSunLongitude } from './lunar.js';
+export { getYearDetails, getDayCanChi, getMonthCanChi, getHourCanChi, getAuspiciousHours, } from './feng-shui.js';

package/dist/core/lunar.d.ts

@@ -0,0 +1,73 @@
+import type { LunarDate, SolarDate } from './types.js';
+/**
+ * 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 declare function jdFromDate(dd: number, mm: number, yy: number): number;
+/**
+ * Chuyển Julian Day Number sang ngày Gregorian.
+ *
+ * @param jd - Julian Day Number
+ * @returns Tuple [day, month, year]
+ */
+export declare function jdToDate(jd: number): [number, number, number];
+/**
+ * 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 declare function getNewMoonDay(k: number, timeZone: number): number;
+/**
+ * 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 declare function getSunLongitude(jdn: number, timeZone: number): number;
+export declare 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: number, month: number, year: number, timeZone?: number): LunarDate;
+    /**
+     * 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: number, lunarMonth: number, lunarYear: number, isLeap?: boolean, timeZone?: number): SolarDate;
+}