@gracefullight/saju 0.1.1 → 0.3.0

package/dist/core/solar-terms.js

@@ -0,0 +1,266 @@
+/**
+ * 24 Solar Terms (二十四節氣)
+ * Each term corresponds to a specific solar longitude
+ */
+export const SOLAR_TERMS = [
+    { name: "소한", hanja: "小寒", longitude: 285 },
+    { name: "대한", hanja: "大寒", longitude: 300 },
+    { name: "입춘", hanja: "立春", longitude: 315 },
+    { name: "우수", hanja: "雨水", longitude: 330 },
+    { name: "경칩", hanja: "驚蟄", longitude: 345 },
+    { name: "춘분", hanja: "春分", longitude: 0 },
+    { name: "청명", hanja: "淸明", longitude: 15 },
+    { name: "곡우", hanja: "穀雨", longitude: 30 },
+    { name: "입하", hanja: "立夏", longitude: 45 },
+    { name: "소만", hanja: "小滿", longitude: 60 },
+    { name: "망종", hanja: "芒種", longitude: 75 },
+    { name: "하지", hanja: "夏至", longitude: 90 },
+    { name: "소서", hanja: "小暑", longitude: 105 },
+    { name: "대서", hanja: "大暑", longitude: 120 },
+    { name: "입추", hanja: "立秋", longitude: 135 },
+    { name: "처서", hanja: "處暑", longitude: 150 },
+    { name: "백로", hanja: "白露", longitude: 165 },
+    { name: "추분", hanja: "秋分", longitude: 180 },
+    { name: "한로", hanja: "寒露", longitude: 195 },
+    { name: "상강", hanja: "霜降", longitude: 210 },
+    { name: "입동", hanja: "立冬", longitude: 225 },
+    { name: "소설", hanja: "小雪", longitude: 240 },
+    { name: "대설", hanja: "大雪", longitude: 255 },
+    { name: "동지", hanja: "冬至", longitude: 270 },
+];
+function normDeg(x) {
+    x %= 360;
+    return x < 0 ? x + 360 : x;
+}
+function sunApparentLongitude(adapter, dtUtc) {
+    let y = adapter.getYear(dtUtc);
+    let m = adapter.getMonth(dtUtc);
+    const d = adapter.getDay(dtUtc) +
+        (adapter.getHour(dtUtc) + (adapter.getMinute(dtUtc) + adapter.getSecond(dtUtc) / 60) / 60) / 24;
+    if (m <= 2) {
+        y -= 1;
+        m += 12;
+    }
+    const A = Math.floor(y / 100);
+    const B = 2 - A + Math.floor(A / 4);
+    const JD = Math.floor(365.25 * (y + 4716)) + Math.floor(30.6001 * (m + 1)) + d + B - 1524.5;
+    const T = (JD - 2451545.0) / 36525.0;
+    const L0 = normDeg(280.46646 + 36000.76983 * T + 0.0003032 * T * T);
+    const M = normDeg(357.52911 + 35999.05029 * T - 0.0001537 * T * T);
+    const deg2rad = (deg) => (deg * Math.PI) / 180;
+    const C = (1.914602 - 0.004817 * T - 0.000014 * T * T) * Math.sin(deg2rad(M)) +
+        (0.019993 - 0.000101 * T) * Math.sin(deg2rad(2 * M)) +
+        0.000289 * Math.sin(deg2rad(3 * M));
+    const trueLong = L0 + C;
+    const omega = 125.04 - 1934.136 * T;
+    const lambda = trueLong - 0.00569 - 0.00478 * Math.sin(deg2rad(omega));
+    return normDeg(lambda);
+}
+function angleDiffDeg(a, b) {
+    return ((a - b + 540) % 360) - 180;
+}
+function findTermUtc(adapter, targetDeg, startUtc, endUtc) {
+    let a = startUtc;
+    let b = endUtc;
+    const f = (dt) => angleDiffDeg(sunApparentLongitude(adapter, dt), targetDeg);
+    let fa = f(a);
+    let fb = f(b);
+    let expand = 0;
+    while (fa * fb > 0 && expand < 10) {
+        a = adapter.minusDays(a, 1);
+        b = adapter.plusDays(b, 1);
+        fa = f(a);
+        fb = f(b);
+        expand += 1;
+    }
+    if (fa * fb > 0)
+        throw new Error("Failed to bracket solar term");
+    for (let i = 0; i < 80; i++) {
+        const midMillis = (adapter.toMillis(a) + adapter.toMillis(b)) / 2;
+        const mid = adapter.fromMillis(midMillis, "utc");
+        const fm = f(mid);
+        if (Math.abs(fm) < 1e-6)
+            return mid;
+        if (fa * fm <= 0) {
+            b = mid;
+            fb = fm;
+        }
+        else {
+            a = mid;
+            fa = fm;
+        }
+    }
+    return adapter.fromMillis((adapter.toMillis(a) + adapter.toMillis(b)) / 2, "utc");
+}
+/**
+ * Find the exact UTC datetime when a solar term occurs
+ */
+function findSolarTermDate(adapter, term, year, month) {
+    // Approximate dates for solar terms
+    const startUtc = adapter.createUTC(year, month, 1, 0, 0, 0);
+    const endUtc = adapter.createUTC(year, month, 28, 0, 0, 0);
+    return findTermUtc(adapter, term.longitude, startUtc, endUtc);
+}
+/**
+ * Get the solar term index from solar longitude
+ */
+function getSolarTermIndexFromLongitude(longitude) {
+    // Each term is 15 degrees apart
+    // 소한 (285°) is index 0
+    // Normalize to start from 소한
+    const normalized = (longitude - 285 + 360) % 360;
+    return Math.floor(normalized / 15);
+}
+/**
+ * Get approximate month for a solar term
+ */
+function getApproximateMonth(termIndex) {
+    // 소한(0) -> 1월, 대한(1) -> 1월, 입춘(2) -> 2월, ...
+    const months = [1, 1, 2, 2, 3, 3, 4, 4, 5, 5, 6, 6, 7, 7, 8, 8, 9, 9, 10, 10, 11, 11, 12, 12];
+    return months[termIndex];
+}
+function isJie(termIndex) {
+    return termIndex % 2 === 0;
+}
+function findPrevJie(adapter, dtLocal, currentIndex) {
+    const year = adapter.getYear(dtLocal);
+    const zone = adapter.getZoneName(dtLocal);
+    const dtMillis = adapter.toMillis(dtLocal);
+    let jieIndex = isJie(currentIndex) ? currentIndex : currentIndex - 1;
+    if (jieIndex < 0)
+        jieIndex = 22;
+    for (let attempts = 0; attempts < 3; attempts++) {
+        const term = SOLAR_TERMS[jieIndex];
+        const month = getApproximateMonth(jieIndex);
+        for (let yearOffset = 0; yearOffset <= 1; yearOffset++) {
+            const tryYear = year - yearOffset;
+            const termUtc = findSolarTermDate(adapter, term, tryYear, month);
+            const termLocal = adapter.setZone(termUtc, zone);
+            if (adapter.toMillis(termLocal) <= dtMillis) {
+                return { term, termLocal };
+            }
+        }
+        jieIndex = jieIndex - 2;
+        if (jieIndex < 0)
+            jieIndex += 24;
+    }
+    const fallbackTerm = SOLAR_TERMS[jieIndex];
+    const fallbackMonth = getApproximateMonth(jieIndex);
+    const fallbackUtc = findSolarTermDate(adapter, fallbackTerm, year - 1, fallbackMonth);
+    return { term: fallbackTerm, termLocal: adapter.setZone(fallbackUtc, zone) };
+}
+function findNextJie(adapter, dtLocal, currentIndex) {
+    const year = adapter.getYear(dtLocal);
+    const zone = adapter.getZoneName(dtLocal);
+    const dtMillis = adapter.toMillis(dtLocal);
+    let jieIndex = isJie(currentIndex) ? (currentIndex + 2) % 24 : (currentIndex + 1) % 24;
+    for (let attempts = 0; attempts < 3; attempts++) {
+        const term = SOLAR_TERMS[jieIndex];
+        const month = getApproximateMonth(jieIndex);
+        for (let yearOffset = 0; yearOffset <= 1; yearOffset++) {
+            const tryYear = year + yearOffset;
+            const termUtc = findSolarTermDate(adapter, term, tryYear, month);
+            const termLocal = adapter.setZone(termUtc, zone);
+            if (adapter.toMillis(termLocal) > dtMillis) {
+                return { term, termLocal };
+            }
+        }
+        jieIndex = (jieIndex + 2) % 24;
+    }
+    const fallbackTerm = SOLAR_TERMS[jieIndex];
+    const fallbackMonth = getApproximateMonth(jieIndex);
+    const fallbackUtc = findSolarTermDate(adapter, fallbackTerm, year + 1, fallbackMonth);
+    return { term: fallbackTerm, termLocal: adapter.setZone(fallbackUtc, zone) };
+}
+function toDateInfo(adapter, dt) {
+    return {
+        year: adapter.getYear(dt),
+        month: adapter.getMonth(dt),
+        day: adapter.getDay(dt),
+        hour: adapter.getHour(dt),
+        minute: adapter.getMinute(dt),
+    };
+}
+export function analyzeSolarTerms(adapter, dtLocal) {
+    const dtUtc = adapter.toUTC(dtLocal);
+    const currentLongitude = sunApparentLongitude(adapter, dtUtc);
+    const currentIndex = getSolarTermIndexFromLongitude(currentLongitude);
+    const currentTerm = SOLAR_TERMS[currentIndex];
+    const nextIndex = (currentIndex + 1) % 24;
+    const nextTerm = SOLAR_TERMS[nextIndex];
+    const year = adapter.getYear(dtLocal);
+    const currentMonth = getApproximateMonth(currentIndex);
+    const nextMonth = getApproximateMonth(nextIndex);
+    let currentYear = year;
+    if (currentMonth === 12 && adapter.getMonth(dtLocal) <= 2) {
+        currentYear = year - 1;
+    }
+    else if (currentMonth === 1 && adapter.getMonth(dtLocal) >= 11) {
+        currentYear = year + 1;
+    }
+    let currentTermUtc = findSolarTermDate(adapter, currentTerm, currentYear, currentMonth);
+    let currentTermLocal = adapter.setZone(currentTermUtc, adapter.getZoneName(dtLocal));
+    if (adapter.toMillis(currentTermLocal) > adapter.toMillis(dtLocal)) {
+        if (currentMonth <= 2) {
+            currentYear -= 1;
+        }
+        currentTermUtc = findSolarTermDate(adapter, currentTerm, currentYear, currentMonth);
+        currentTermLocal = adapter.setZone(currentTermUtc, adapter.getZoneName(dtLocal));
+    }
+    let nextYear = year;
+    if (nextMonth === 1 && adapter.getMonth(dtLocal) >= 11) {
+        nextYear = year + 1;
+    }
+    let nextTermUtc = findSolarTermDate(adapter, nextTerm, nextYear, nextMonth);
+    let nextTermLocal = adapter.setZone(nextTermUtc, adapter.getZoneName(dtLocal));
+    if (adapter.toMillis(nextTermLocal) <= adapter.toMillis(dtLocal)) {
+        if (nextMonth >= 11) {
+            nextYear += 1;
+        }
+        nextTermUtc = findSolarTermDate(adapter, nextTerm, nextYear, nextMonth);
+        nextTermLocal = adapter.setZone(nextTermUtc, adapter.getZoneName(dtLocal));
+    }
+    const { term: prevJie, termLocal: prevJieLocal } = findPrevJie(adapter, dtLocal, currentIndex);
+    const { term: nextJie, termLocal: nextJieLocal } = findNextJie(adapter, dtLocal, currentIndex);
+    const msPerDay = 24 * 60 * 60 * 1000;
+    const currentMillis = adapter.toMillis(currentTermLocal);
+    const nextMillis = adapter.toMillis(nextTermLocal);
+    const dtMillis = adapter.toMillis(dtLocal);
+    const daysSinceCurrent = Math.floor((dtMillis - currentMillis) / msPerDay);
+    const daysUntilNext = Math.ceil((nextMillis - dtMillis) / msPerDay);
+    return {
+        current: { ...currentTerm },
+        currentDate: toDateInfo(adapter, currentTermLocal),
+        currentMillis,
+        daysSinceCurrent,
+        next: { ...nextTerm },
+        nextDate: toDateInfo(adapter, nextTermLocal),
+        nextMillis,
+        daysUntilNext,
+        prevJie: { ...prevJie },
+        prevJieDate: toDateInfo(adapter, prevJieLocal),
+        prevJieMillis: adapter.toMillis(prevJieLocal),
+        nextJie: { ...nextJie },
+        nextJieDate: toDateInfo(adapter, nextJieLocal),
+        nextJieMillis: adapter.toMillis(nextJieLocal),
+    };
+}
+/**
+ * Get all solar term dates for a given year
+ */
+export function getSolarTermsForYear(adapter, year, timezone) {
+    const result = [];
+    for (let i = 0; i < SOLAR_TERMS.length; i++) {
+        const term = SOLAR_TERMS[i];
+        const month = getApproximateMonth(i);
+        // Handle year boundary for 소한/대한 (January terms)
+        const termYear = month === 1 && i < 2 ? year : month === 12 ? year : year;
+        const termUtc = findSolarTermDate(adapter, term, termYear, month);
+        const termLocal = adapter.setZone(termUtc, timezone);
+        result.push({
+            term: { ...term },
+            date: toDateInfo(adapter, termLocal),
+        });
+    }
+    return result;
+}

package/dist/core/strength.d.ts

@@ -0,0 +1,18 @@
+export type StrengthLevel = "극약" | "태약" | "신약" | "중화신약" | "중화" | "중화신강" | "신강" | "태강" | "극왕";
+export declare const STRENGTH_LEVELS: StrengthLevel[];
+export interface StrengthFactors {
+    deukryeong: number;
+    deukji: number;
+    deukse: number;
+    tonggeun: number;
+    helpCount: number;
+    weakenCount: number;
+}
+export interface StrengthResult {
+    level: StrengthLevel;
+    score: number;
+    factors: StrengthFactors;
+    description: string;
+}
+export declare function analyzeStrength(yearPillar: string, monthPillar: string, dayPillar: string, hourPillar: string): StrengthResult;
+//# sourceMappingURL=strength.d.ts.map

package/dist/core/strength.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strength.d.ts","sourceRoot":"","sources":["../../src/core/strength.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,aAAa,GACrB,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,IAAI,GACJ,MAAM,GACN,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;AAET,eAAO,MAAM,eAAe,EAAE,aAAa,EAU1C,CAAC;AAsKF,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,eAAe,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,cAAc,CAsGhB"}

package/dist/core/strength.js

@@ -0,0 +1,255 @@
+import { getStemElement, getBranchElement, getHiddenStems, getTenGod, getStemPolarity, } from "./ten-gods";
+export const STRENGTH_LEVELS = [
+    "극약",
+    "태약",
+    "신약",
+    "중화신약",
+    "중화",
+    "중화신강",
+    "신강",
+    "태강",
+    "극왕",
+];
+const HIDDEN_STEM_WEIGHTS = {
+    子: [{ stem: "癸", weight: 1.0, type: "본기" }],
+    丑: [
+        { stem: "己", weight: 0.6, type: "본기" },
+        { stem: "癸", weight: 0.25, type: "중기" },
+        { stem: "辛", weight: 0.15, type: "여기" },
+    ],
+    寅: [
+        { stem: "甲", weight: 0.6, type: "본기" },
+        { stem: "丙", weight: 0.25, type: "중기" },
+        { stem: "戊", weight: 0.15, type: "여기" },
+    ],
+    卯: [{ stem: "乙", weight: 1.0, type: "본기" }],
+    辰: [
+        { stem: "戊", weight: 0.6, type: "본기" },
+        { stem: "乙", weight: 0.25, type: "중기" },
+        { stem: "癸", weight: 0.15, type: "여기" },
+    ],
+    巳: [
+        { stem: "丙", weight: 0.6, type: "본기" },
+        { stem: "庚", weight: 0.25, type: "중기" },
+        { stem: "戊", weight: 0.15, type: "여기" },
+    ],
+    午: [
+        { stem: "丁", weight: 0.7, type: "본기" },
+        { stem: "己", weight: 0.3, type: "중기" },
+    ],
+    未: [
+        { stem: "己", weight: 0.6, type: "본기" },
+        { stem: "丁", weight: 0.25, type: "중기" },
+        { stem: "乙", weight: 0.15, type: "여기" },
+    ],
+    申: [
+        { stem: "庚", weight: 0.6, type: "본기" },
+        { stem: "壬", weight: 0.25, type: "중기" },
+        { stem: "戊", weight: 0.15, type: "여기" },
+    ],
+    酉: [{ stem: "辛", weight: 1.0, type: "본기" }],
+    戌: [
+        { stem: "戊", weight: 0.6, type: "본기" },
+        { stem: "辛", weight: 0.25, type: "중기" },
+        { stem: "丁", weight: 0.15, type: "여기" },
+    ],
+    亥: [
+        { stem: "壬", weight: 0.7, type: "본기" },
+        { stem: "甲", weight: 0.3, type: "중기" },
+    ],
+};
+const MONTH_BRANCH_SEASONAL = {
+    寅: "wood",
+    卯: "wood",
+    辰: "wet_earth",
+    巳: "fire",
+    午: "fire",
+    未: "dry_earth",
+    申: "metal",
+    酉: "metal",
+    戌: "dry_earth",
+    亥: "water",
+    子: "water",
+    丑: "wet_earth",
+};
+function getMonthlyStrengthMultiplier(dayMasterElement, monthBranch) {
+    const seasonal = MONTH_BRANCH_SEASONAL[monthBranch];
+    const strengthTable = {
+        wood: {
+            wood: 1.0,
+            fire: 0.3,
+            wet_earth: 0.5,
+            dry_earth: 0.2,
+            metal: 0.1,
+            water: 0.7,
+        },
+        fire: {
+            wood: 0.7,
+            fire: 1.0,
+            wet_earth: 0.3,
+            dry_earth: 0.5,
+            metal: 0.1,
+            water: 0.1,
+        },
+        earth: {
+            wood: 0.1,
+            fire: 0.7,
+            wet_earth: 0.8,
+            dry_earth: 1.0,
+            metal: 0.3,
+            water: 0.1,
+        },
+        metal: {
+            wood: 0.1,
+            fire: 0.1,
+            wet_earth: 0.5,
+            dry_earth: 0.7,
+            metal: 1.0,
+            water: 0.3,
+        },
+        water: {
+            wood: 0.3,
+            fire: 0.1,
+            wet_earth: 0.2,
+            dry_earth: 0.1,
+            metal: 0.7,
+            water: 1.0,
+        },
+    };
+    return strengthTable[dayMasterElement][seasonal];
+}
+function calculateRootStrength(dayMaster, branch) {
+    const dayMasterElement = getStemElement(dayMaster);
+    const dayMasterPolarity = getStemPolarity(dayMaster);
+    const hiddenStems = HIDDEN_STEM_WEIGHTS[branch] || [];
+    let strength = 0;
+    for (const hs of hiddenStems) {
+        const hsElement = getStemElement(hs.stem);
+        const hsPolarity = getStemPolarity(hs.stem);
+        if (hsElement === dayMasterElement) {
+            if (hsPolarity === dayMasterPolarity) {
+                strength += hs.weight * 1.0;
+            }
+            else {
+                strength += hs.weight * 0.7;
+            }
+        }
+        else if ((dayMasterElement === "wood" && hsElement === "water") ||
+            (dayMasterElement === "fire" && hsElement === "wood") ||
+            (dayMasterElement === "earth" && hsElement === "fire") ||
+            (dayMasterElement === "metal" && hsElement === "earth") ||
+            (dayMasterElement === "water" && hsElement === "metal")) {
+            strength += hs.weight * 0.5;
+        }
+    }
+    return strength;
+}
+function isTransparent(stem, allStems) {
+    return allStems.includes(stem);
+}
+function isHelpfulTenGod(tenGod) {
+    return ["비견", "겁재", "정인", "편인"].includes(tenGod);
+}
+function isWeakeningTenGod(tenGod) {
+    return ["식신", "상관", "편재", "정재", "편관", "정관"].includes(tenGod);
+}
+export function analyzeStrength(yearPillar, monthPillar, dayPillar, hourPillar) {
+    const dayMaster = dayPillar[0];
+    const dayMasterElement = getStemElement(dayMaster);
+    const monthBranch = monthPillar[1];
+    const deukryeong = getMonthlyStrengthMultiplier(dayMasterElement, monthBranch);
+    const allBranches = [yearPillar[1], monthPillar[1], dayPillar[1], hourPillar[1]];
+    let tonggeun = 0;
+    for (const branch of allBranches) {
+        tonggeun += calculateRootStrength(dayMaster, branch);
+    }
+    const allStems = [yearPillar[0], monthPillar[0], dayPillar[0], hourPillar[0]];
+    const monthHiddenStems = HIDDEN_STEM_WEIGHTS[monthBranch] || [];
+    let transparentBonus = 0;
+    for (const hs of monthHiddenStems) {
+        if (isTransparent(hs.stem, allStems)) {
+            const tenGod = getTenGod(dayMaster, hs.stem);
+            if (isHelpfulTenGod(tenGod)) {
+                transparentBonus += hs.weight * 0.3;
+            }
+        }
+    }
+    let deukji = 0;
+    const nearBranches = [dayPillar[1], hourPillar[1]];
+    for (const branch of nearBranches) {
+        deukji += calculateRootStrength(dayMaster, branch);
+    }
+    let deukse = 0;
+    const otherStems = [yearPillar[0], monthPillar[0], hourPillar[0]];
+    for (const stem of otherStems) {
+        const tenGod = getTenGod(dayMaster, stem);
+        if (isHelpfulTenGod(tenGod)) {
+            deukse += 1;
+        }
+    }
+    let helpCount = 0;
+    let weakenCount = 0;
+    for (const stem of otherStems) {
+        const tenGod = getTenGod(dayMaster, stem);
+        if (isHelpfulTenGod(tenGod))
+            helpCount++;
+        if (isWeakeningTenGod(tenGod))
+            weakenCount++;
+    }
+    for (const branch of allBranches) {
+        const hiddenStems = HIDDEN_STEM_WEIGHTS[branch] || [];
+        const mainStem = hiddenStems[0]?.stem;
+        if (mainStem) {
+            const tenGod = getTenGod(dayMaster, mainStem);
+            if (isHelpfulTenGod(tenGod))
+                helpCount++;
+            if (isWeakeningTenGod(tenGod))
+                weakenCount++;
+        }
+    }
+    let score = 0;
+    score += deukryeong * 35;
+    score += tonggeun * 20;
+    score += transparentBonus * 15;
+    score += deukse * 8;
+    score += helpCount * 5;
+    score -= weakenCount * 6;
+    score = Math.round(score * 10) / 10;
+    let level;
+    if (score <= 10)
+        level = "극약";
+    else if (score <= 20)
+        level = "태약";
+    else if (score <= 30)
+        level = "신약";
+    else if (score <= 38)
+        level = "중화신약";
+    else if (score <= 45)
+        level = "중화";
+    else if (score <= 55)
+        level = "중화신강";
+    else if (score <= 70)
+        level = "신강";
+    else if (score <= 85)
+        level = "태강";
+    else
+        level = "극왕";
+    const factors = {
+        deukryeong: Math.round(deukryeong * 100) / 100,
+        deukji: Math.round(deukji * 100) / 100,
+        deukse,
+        tonggeun: Math.round(tonggeun * 100) / 100,
+        helpCount,
+        weakenCount,
+    };
+    const deukryeongDesc = deukryeong >= 0.7 ? "득령" : deukryeong >= 0.4 ? "반득령" : "실령";
+    let description = `일간 ${dayMaster}(${dayMasterElement}), ${deukryeongDesc}(${Math.round(deukryeong * 100)}%)`;
+    description += tonggeun > 0 ? `, 통근(${Math.round(tonggeun * 100) / 100})` : "";
+    description += deukse > 0 ? `, 득세(${deukse})` : "";
+    return {
+        level,
+        score,
+        factors,
+        description,
+    };
+}

package/dist/core/ten-gods.d.ts

@@ -0,0 +1,130 @@
+/**
+ * 십신(十神) 분석 모듈
+ * Ten Gods analysis based on the relationship between Day Master and other elements
+ */
+export type Element = "wood" | "fire" | "earth" | "metal" | "water";
+export declare const ELEMENTS: Element[];
+export type Polarity = "yang" | "yin";
+export type TenGod = "비견" | "겁재" | "식신" | "상관" | "편재" | "정재" | "편관" | "정관" | "편인" | "정인";
+export declare const TEN_GODS: TenGod[];
+export declare const TEN_GOD_HANJA: Record<TenGod, string>;
+export declare const TEN_GOD_ENGLISH: Record<TenGod, string>;
+export declare const HIDDEN_STEMS: Record<string, string[]>;
+/**
+ * 천간의 오행을 반환
+ */
+export declare function getStemElement(stem: string): Element;
+/**
+ * 천간의 음양을 반환
+ */
+export declare function getStemPolarity(stem: string): Polarity;
+/**
+ * 지지의 오행을 반환
+ */
+export declare function getBranchElement(branch: string): Element;
+/**
+ * 지지의 음양을 반환
+ */
+export declare function getBranchPolarity(branch: string): Polarity;
+/**
+ * 지지의 장간(숨은 천간들)을 반환
+ */
+export declare function getHiddenStems(branch: string): string[];
+/**
+ * 일간(Day Master)과 다른 천간의 관계에서 십신을 판정
+ * @param dayMaster 일간 (예: "甲")
+ * @param targetStem 비교 대상 천간
+ * @returns 십신
+ */
+export declare function getTenGod(dayMaster: string, targetStem: string): TenGod;
+/**
+ * 지지에 대한 십신 판정 (본기 기준)
+ */
+export declare function getTenGodForBranch(dayMaster: string, branch: string): TenGod;
+/**
+ * 지지의 모든 장간에 대한 십신 분석
+ */
+export declare function getTenGodsForBranch(dayMaster: string, branch: string): {
+    stem: string;
+    tenGod: TenGod;
+    type: "본기" | "중기" | "여기";
+}[];
+/**
+ * 사주 전체의 십신 분석
+ */
+export interface FourPillarsTenGods {
+    year: {
+        stem: {
+            char: string;
+            tenGod: TenGod;
+        };
+        branch: {
+            char: string;
+            tenGod: TenGod;
+            hiddenStems: {
+                stem: string;
+                tenGod: TenGod;
+            }[];
+        };
+    };
+    month: {
+        stem: {
+            char: string;
+            tenGod: TenGod;
+        };
+        branch: {
+            char: string;
+            tenGod: TenGod;
+            hiddenStems: {
+                stem: string;
+                tenGod: TenGod;
+            }[];
+        };
+    };
+    day: {
+        stem: {
+            char: string;
+            tenGod: "일간";
+        };
+        branch: {
+            char: string;
+            tenGod: TenGod;
+            hiddenStems: {
+                stem: string;
+                tenGod: TenGod;
+            }[];
+        };
+    };
+    hour: {
+        stem: {
+            char: string;
+            tenGod: TenGod;
+        };
+        branch: {
+            char: string;
+            tenGod: TenGod;
+            hiddenStems: {
+                stem: string;
+                tenGod: TenGod;
+            }[];
+        };
+    };
+    dayMaster: string;
+}
+/**
+ * 사주 팔자에서 십신 분석
+ * @param yearPillar 연주 (예: "甲子")
+ * @param monthPillar 월주
+ * @param dayPillar 일주
+ * @param hourPillar 시주
+ */
+export declare function analyzeTenGods(yearPillar: string, monthPillar: string, dayPillar: string, hourPillar: string): FourPillarsTenGods;
+/**
+ * 십신 통계 (각 십신이 몇 개 있는지)
+ */
+export declare function countTenGods(analysis: FourPillarsTenGods): Record<TenGod, number>;
+/**
+ * 오행별 개수 (천간 + 지지 본기)
+ */
+export declare function countElements(analysis: FourPillarsTenGods): Record<Element, number>;
+//# sourceMappingURL=ten-gods.d.ts.map

package/dist/core/ten-gods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ten-gods.d.ts","sourceRoot":"","sources":["../../src/core/ten-gods.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AACpE,eAAO,MAAM,QAAQ,EAAE,OAAO,EAAgD,CAAC;AAG/E,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAGtC,MAAM,MAAM,MAAM,GACd,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;AAET,eAAO,MAAM,QAAQ,EAAE,MAAM,EAW5B,CAAC;AAGF,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAWhD,CAAC;AAGF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAWlD,CAAC;AAgEF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAajD,CAAC;AAsBF;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAItD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAIxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAI1D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAIvD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAkCvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI5E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;CAAE,EAAE,CAS9D;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE;QACJ,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QACvC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAE,EAAE,CAAA;SAAE,CAAC;KAC3F,CAAC;IACF,KAAK,EAAE;QACL,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QACvC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAE,EAAE,CAAA;SAAE,CAAC;KAC3F,CAAC;IACF,GAAG,EAAE;QACH,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,IAAI,CAAA;SAAE,CAAC;QACrC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAE,EAAE,CAAA;SAAE,CAAC;KAC3F,CAAC;IACF,IAAI,EAAE;QACJ,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QACvC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAE,EAAE,CAAA;SAAE,CAAC;KAC3F,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,kBAAkB,CA+BpB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgCjF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAgCnF"}