@gracefullight/saju 0.4.1 → 0.5.0

package/dist/core/strength.js

@@ -1,4 +1,31 @@
 import { getStemElement, getStemPolarity, getTenGod } from "./ten-gods";
+export const STRENGTH_LEVEL_KEYS = [
+    "extremelyWeak",
+    "veryWeak",
+    "weak",
+    "neutralWeak",
+    "neutral",
+    "neutralStrong",
+    "strong",
+    "veryStrong",
+    "extremelyStrong",
+];
+const STRENGTH_LEVEL_DATA = {
+    extremelyWeak: { korean: "극약", hanja: "極弱" },
+    veryWeak: { korean: "태약", hanja: "太弱" },
+    weak: { korean: "신약", hanja: "身弱" },
+    neutralWeak: { korean: "중화신약", hanja: "中和身弱" },
+    neutral: { korean: "중화", hanja: "中和" },
+    neutralStrong: { korean: "중화신강", hanja: "中和身強" },
+    strong: { korean: "신강", hanja: "身強" },
+    veryStrong: { korean: "태강", hanja: "太強" },
+    extremelyStrong: { korean: "극왕", hanja: "極旺" },
+};
+export function getStrengthLevelLabel(key) {
+    const data = STRENGTH_LEVEL_DATA[key];
+    return { key, ...data };
+}
+/** @deprecated Use STRENGTH_LEVEL_KEYS instead */
 export const STRENGTH_LEVELS = [
     "극약",
     "태약",
@@ -215,25 +242,25 @@ export function analyzeStrength(yearPillar, monthPillar, dayPillar, hourPillar)
     score += helpCount * 5;
     score -= weakenCount * 6;
     score = Math.round(score * 10) / 10;
-    let level;
+    let levelKey;
     if (score <= 10)
-        level = "극약";
+        levelKey = "extremelyWeak";
     else if (score <= 20)
-        level = "태약";
+        levelKey = "veryWeak";
     else if (score <= 30)
-        level = "신약";
+        levelKey = "weak";
     else if (score <= 38)
-        level = "중화신약";
+        levelKey = "neutralWeak";
     else if (score <= 45)
-        level = "중화";
+        levelKey = "neutral";
     else if (score <= 55)
-        level = "중화신강";
+        levelKey = "neutralStrong";
     else if (score <= 70)
-        level = "신강";
+        levelKey = "strong";
     else if (score <= 85)
-        level = "태강";
+        levelKey = "veryStrong";
     else
-        level = "극왕";
+        levelKey = "extremelyStrong";
     const factors = {
         deukryeong: Math.round(deukryeong * 100) / 100,
         deukji: Math.round(deukji * 100) / 100,
@@ -247,7 +274,7 @@ export function analyzeStrength(yearPillar, monthPillar, dayPillar, hourPillar)
     description += tonggeun > 0 ? `, 통근(${Math.round(tonggeun * 100) / 100})` : "";
     description += deukse > 0 ? `, 득세(${deukse})` : "";
     return {
-        level,
+        level: getStrengthLevelLabel(levelKey),
         score,
         factors,
         description,

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

@@ -1,127 +1,99 @@
-import type { Element, Polarity } from "../types";
+import type { Element, Label, Polarity } from "../types";
 import { ELEMENTS } from "../utils";
 export type { Element, Polarity };
 export { ELEMENTS };
-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 interface ElementLabel extends Label<Element> {
+}
+export declare function getElementLabel(key: Element): ElementLabel;
+export declare const TEN_GOD_KEYS: readonly ["companion", "robWealth", "eatingGod", "hurtingOfficer", "indirectWealth", "directWealth", "sevenKillings", "directOfficer", "indirectSeal", "directSeal"];
+export type TenGodKey = (typeof TEN_GOD_KEYS)[number];
+export interface TenGodLabel extends Label<TenGodKey> {
+}
+export declare function getTenGodLabel(key: TenGodKey): TenGodLabel;
 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 getTenGodForBranch(dayMaster: string, branch: string): TenGodLabel;
 export declare function getTenGodsForBranch(dayMaster: string, branch: string): {
     stem: string;
-    tenGod: TenGod;
+    tenGod: TenGodLabel;
     type: "본기" | "중기" | "여기";
 }[];
-/**
- * 사주 전체의 십신 분석
- */
+export interface DayMasterLabel extends Label<"dayMaster"> {
+}
 export interface FourPillarsTenGods {
     year: {
         stem: {
             char: string;
-            tenGod: TenGod;
+            tenGod: TenGodLabel;
         };
         branch: {
             char: string;
-            tenGod: TenGod;
+            tenGod: TenGodLabel;
             hiddenStems: {
                 stem: string;
-                tenGod: TenGod;
+                tenGod: TenGodLabel;
             }[];
         };
     };
     month: {
         stem: {
             char: string;
-            tenGod: TenGod;
+            tenGod: TenGodLabel;
         };
         branch: {
             char: string;
-            tenGod: TenGod;
+            tenGod: TenGodLabel;
             hiddenStems: {
                 stem: string;
-                tenGod: TenGod;
+                tenGod: TenGodLabel;
             }[];
         };
     };
     day: {
         stem: {
             char: string;
-            tenGod: "일간";
+            tenGod: DayMasterLabel;
         };
         branch: {
             char: string;
-            tenGod: TenGod;
+            tenGod: TenGodLabel;
             hiddenStems: {
                 stem: string;
-                tenGod: TenGod;
+                tenGod: TenGodLabel;
             }[];
         };
     };
     hour: {
         stem: {
             char: string;
-            tenGod: TenGod;
+            tenGod: TenGodLabel;
         };
         branch: {
             char: string;
-            tenGod: TenGod;
+            tenGod: TenGodLabel;
             hiddenStems: {
                 stem: string;
-                tenGod: TenGod;
+                tenGod: TenGodLabel;
             }[];
         };
     };
     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 countTenGods(analysis: FourPillarsTenGods): Record<TenGodKey, number>;
 export declare function countElements(analysis: FourPillarsTenGods): Record<Element, number>;
+/** @deprecated Use TenGodKey instead */
+export type TenGod = "비견" | "겁재" | "식신" | "상관" | "편재" | "정재" | "편관" | "정관" | "편인" | "정인";
+/** @deprecated Use TEN_GOD_KEYS instead */
+export declare const TEN_GODS: TenGod[];
+/** @deprecated Use TEN_GOD_DATA instead */
+export declare const TEN_GOD_HANJA: Record<TenGod, string>;
+/** @deprecated Use TEN_GOD_DATA instead */
+export declare const TEN_GOD_ENGLISH: Record<TenGod, string>;
+/** @deprecated Use getTenGodLabel(getTenGodKey(...)) instead */
+export declare function getTenGod(dayMaster: string, targetStem: string): TenGod;
 //# sourceMappingURL=ten-gods.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ten-gods.d.ts","sourceRoot":"","sources":["../../src/core/ten-gods.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ten-gods.d.ts","sourceRoot":"","sources":["../../src/core/ten-gods.ts"],"names":[],"mappings":"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"}

package/dist/core/ten-gods.js

@@ -1,44 +1,44 @@
 import { ELEMENTS } from "../utils";
 export { ELEMENTS };
-export const TEN_GODS = [
-    "비견",
-    "겁재",
-    "식신",
-    "상관",
-    "편재",
-    "정재",
-    "편관",
-    "정관",
-    "편인",
-    "정인",
-];
-// 십신 한자 매핑
-export const TEN_GOD_HANJA = {
-    비견: "比肩",
-    겁재: "劫財",
-    식신: "食神",
-    상관: "傷官",
-    편재: "偏財",
-    정재: "正財",
-    편관: "偏官",
-    정관: "正官",
-    편인: "偏印",
-    정인: "正印",
+const ELEMENT_DATA = {
+    wood: { korean: "목", hanja: "木" },
+    fire: { korean: "화", hanja: "火" },
+    earth: { korean: "토", hanja: "土" },
+    metal: { korean: "금", hanja: "金" },
+    water: { korean: "수", hanja: "水" },
 };
-// 십신 영문 매핑
-export const TEN_GOD_ENGLISH = {
-    비견: "Companion",
-    겁재: "Rob Wealth",
-    식신: "Eating God",
-    상관: "Hurting Officer",
-    편재: "Indirect Wealth",
-    정재: "Direct Wealth",
-    편관: "Seven Killings",
-    정관: "Direct Officer",
-    편인: "Indirect Seal",
-    정인: "Direct Seal",
+export function getElementLabel(key) {
+    const data = ELEMENT_DATA[key];
+    return { key, ...data };
+}
+export const TEN_GOD_KEYS = [
+    "companion",
+    "robWealth",
+    "eatingGod",
+    "hurtingOfficer",
+    "indirectWealth",
+    "directWealth",
+    "sevenKillings",
+    "directOfficer",
+    "indirectSeal",
+    "directSeal",
+];
+const TEN_GOD_DATA = {
+    companion: { korean: "비견", hanja: "比肩" },
+    robWealth: { korean: "겁재", hanja: "劫財" },
+    eatingGod: { korean: "식신", hanja: "食神" },
+    hurtingOfficer: { korean: "상관", hanja: "傷官" },
+    indirectWealth: { korean: "편재", hanja: "偏財" },
+    directWealth: { korean: "정재", hanja: "正財" },
+    sevenKillings: { korean: "편관", hanja: "偏官" },
+    directOfficer: { korean: "정관", hanja: "正官" },
+    indirectSeal: { korean: "편인", hanja: "偏印" },
+    directSeal: { korean: "정인", hanja: "正印" },
 };
-// 천간별 오행
+export function getTenGodLabel(key) {
+    const data = TEN_GOD_DATA[key];
+    return { key, ...data };
+}
 const STEM_ELEMENT = {
     甲: "wood",
     乙: "wood",
@@ -51,7 +51,6 @@ const STEM_ELEMENT = {
     壬: "water",
     癸: "water",
 };
-// 천간별 음양
 const STEM_POLARITY = {
     甲: "yang",
     乙: "yin",
@@ -64,7 +63,6 @@ const STEM_POLARITY = {
     壬: "yang",
     癸: "yin",
 };
-// 지지별 오행
 const BRANCH_ELEMENT = {
     子: "water",
     丑: "earth",
@@ -79,7 +77,6 @@ const BRANCH_ELEMENT = {
     戌: "earth",
     亥: "water",
 };
-// 지지별 음양
 const BRANCH_POLARITY = {
     子: "yang",
     丑: "yin",
@@ -94,8 +91,6 @@ const BRANCH_POLARITY = {
     戌: "yang",
     亥: "yin",
 };
-// 장간(藏干) - 지지 속에 숨은 천간들
-// 순서: [본기(本氣), 중기(中氣)?, 여기(餘氣)?]
 export const HIDDEN_STEMS = {
     子: ["癸"],
     丑: ["己", "癸", "辛"],
@@ -110,8 +105,6 @@ export const HIDDEN_STEMS = {
     戌: ["戊", "辛", "丁"],
     亥: ["壬", "甲"],
 };
-// 오행 상생 관계 (A가 B를 생함)
-// 목생화, 화생토, 토생금, 금생수, 수생목
 const GENERATES = {
     wood: "fire",
     fire: "earth",
@@ -119,8 +112,6 @@ const GENERATES = {
     metal: "water",
     water: "wood",
 };
-// 오행 상극 관계 (A가 B를 극함)
-// 목극토, 토극수, 수극화, 화극금, 금극목
 const CONTROLS = {
     wood: "earth",
     earth: "water",
@@ -128,112 +119,77 @@ const CONTROLS = {
     fire: "metal",
     metal: "wood",
 };
-/**
- * 천간의 오행을 반환
- */
 export function getStemElement(stem) {
     const element = STEM_ELEMENT[stem];
     if (!element)
         throw new Error(`Invalid stem: ${stem}`);
     return element;
 }
-/**
- * 천간의 음양을 반환
- */
 export function getStemPolarity(stem) {
     const polarity = STEM_POLARITY[stem];
     if (!polarity)
         throw new Error(`Invalid stem: ${stem}`);
     return polarity;
 }
-/**
- * 지지의 오행을 반환
- */
 export function getBranchElement(branch) {
     const element = BRANCH_ELEMENT[branch];
     if (!element)
         throw new Error(`Invalid branch: ${branch}`);
     return element;
 }
-/**
- * 지지의 음양을 반환
- */
 export function getBranchPolarity(branch) {
     const polarity = BRANCH_POLARITY[branch];
     if (!polarity)
         throw new Error(`Invalid branch: ${branch}`);
     return polarity;
 }
-/**
- * 지지의 장간(숨은 천간들)을 반환
- */
 export function getHiddenStems(branch) {
     const hidden = HIDDEN_STEMS[branch];
     if (!hidden)
         throw new Error(`Invalid branch: ${branch}`);
     return [...hidden];
 }
-/**
- * 일간(Day Master)과 다른 천간의 관계에서 십신을 판정
- * @param dayMaster 일간 (예: "甲")
- * @param targetStem 비교 대상 천간
- * @returns 십신
- */
-export function getTenGod(dayMaster, targetStem) {
+function getTenGodKey(dayMaster, targetStem) {
     const dmElement = getStemElement(dayMaster);
     const dmPolarity = getStemPolarity(dayMaster);
     const targetElement = getStemElement(targetStem);
     const targetPolarity = getStemPolarity(targetStem);
     const samePolarity = dmPolarity === targetPolarity;
-    // 같은 오행
     if (dmElement === targetElement) {
-        return samePolarity ? "비견" : "겁재";
+        return samePolarity ? "companion" : "robWealth";
     }
-    // 내가 생하는 오행 (식상)
     if (GENERATES[dmElement] === targetElement) {
-        return samePolarity ? "식신" : "상관";
+        return samePolarity ? "eatingGod" : "hurtingOfficer";
     }
-    // 내가 극하는 오행 (재성)
     if (CONTROLS[dmElement] === targetElement) {
-        return samePolarity ? "편재" : "정재";
+        return samePolarity ? "indirectWealth" : "directWealth";
     }
-    // 나를 극하는 오행 (관성)
     if (CONTROLS[targetElement] === dmElement) {
-        return samePolarity ? "편관" : "정관";
+        return samePolarity ? "sevenKillings" : "directOfficer";
     }
-    // 나를 생하는 오행 (인성)
     if (GENERATES[targetElement] === dmElement) {
-        return samePolarity ? "편인" : "정인";
+        return samePolarity ? "indirectSeal" : "directSeal";
     }
     throw new Error(`Unable to determine ten god relationship: ${dayMaster} -> ${targetStem}`);
 }
-/**
- * 지지에 대한 십신 판정 (본기 기준)
- */
 export function getTenGodForBranch(dayMaster, branch) {
     const hiddenStems = getHiddenStems(branch);
-    // 본기(첫 번째 장간)를 기준으로 판정
-    return getTenGod(dayMaster, hiddenStems[0]);
+    return getTenGodLabel(getTenGodKey(dayMaster, hiddenStems[0]));
 }
-/**
- * 지지의 모든 장간에 대한 십신 분석
- */
 export function getTenGodsForBranch(dayMaster, branch) {
     const hiddenStems = getHiddenStems(branch);
     const types = ["본기", "중기", "여기"];
     return hiddenStems.map((stem, i) => ({
         stem,
-        tenGod: getTenGod(dayMaster, stem),
+        tenGod: getTenGodLabel(getTenGodKey(dayMaster, stem)),
         type: types[i],
     }));
 }
-/**
- * 사주 팔자에서 십신 분석
- * @param yearPillar 연주 (예: "甲子")
- * @param monthPillar 월주
- * @param dayPillar 일주
- * @param hourPillar 시주
- */
+const DAY_MASTER_LABEL = {
+    key: "dayMaster",
+    korean: "일간",
+    hanja: "日干",
+};
 export function analyzeTenGods(yearPillar, monthPillar, dayPillar, hourPillar) {
     const dayMaster = dayPillar[0];
     const analyzePillar = (pillar, isDayPillar = false) => {
@@ -241,16 +197,16 @@ export function analyzeTenGods(yearPillar, monthPillar, dayPillar, hourPillar) {
         const branch = pillar[1];
         const hiddenStems = getHiddenStems(branch).map((hs) => ({
             stem: hs,
-            tenGod: getTenGod(dayMaster, hs),
+            tenGod: getTenGodLabel(getTenGodKey(dayMaster, hs)),
         }));
         return {
             stem: {
                 char: stem,
-                tenGod: isDayPillar ? "일간" : getTenGod(dayMaster, stem),
+                tenGod: isDayPillar ? DAY_MASTER_LABEL : getTenGodLabel(getTenGodKey(dayMaster, stem)),
             },
             branch: {
                 char: branch,
-                tenGod: getTenGod(dayMaster, hiddenStems[0].stem),
+                tenGod: getTenGodLabel(getTenGodKey(dayMaster, hiddenStems[0].stem)),
                 hiddenStems,
             },
         };
@@ -263,28 +219,23 @@ export function analyzeTenGods(yearPillar, monthPillar, dayPillar, hourPillar) {
         dayMaster,
     };
 }
-/**
- * 십신 통계 (각 십신이 몇 개 있는지)
- */
 export function countTenGods(analysis) {
     const counts = {
-        비견: 0,
-        겁재: 0,
-        식신: 0,
-        상관: 0,
-        편재: 0,
-        정재: 0,
-        편관: 0,
-        정관: 0,
-        편인: 0,
-        정인: 0,
+        companion: 0,
+        robWealth: 0,
+        eatingGod: 0,
+        hurtingOfficer: 0,
+        indirectWealth: 0,
+        directWealth: 0,
+        sevenKillings: 0,
+        directOfficer: 0,
+        indirectSeal: 0,
+        directSeal: 0,
     };
-    // 천간 십신 카운트 (일간 제외)
     const stems = [analysis.year.stem, analysis.month.stem, analysis.hour.stem];
     for (const s of stems) {
-        counts[s.tenGod]++;
+        counts[s.tenGod.key]++;
     }
-    // 지지 본기 십신 카운트
     const branches = [
         analysis.year.branch,
         analysis.month.branch,
@@ -292,13 +243,10 @@ export function countTenGods(analysis) {
         analysis.hour.branch,
     ];
     for (const b of branches) {
-        counts[b.tenGod]++;
+        counts[b.tenGod.key]++;
     }
     return counts;
 }
-/**
- * 오행별 개수 (천간 + 지지 본기)
- */
 export function countElements(analysis) {
     const counts = {
         wood: 0,
@@ -307,7 +255,6 @@ export function countElements(analysis) {
         metal: 0,
         water: 0,
     };
-    // 모든 천간의 오행
     const stems = [
         analysis.year.stem.char,
         analysis.month.stem.char,
@@ -317,7 +264,6 @@ export function countElements(analysis) {
     for (const s of stems) {
         counts[getStemElement(s)]++;
     }
-    // 모든 지지의 오행
     const branches = [
         analysis.year.branch.char,
         analysis.month.branch.char,
@@ -329,3 +275,47 @@ export function countElements(analysis) {
     }
     return counts;
 }
+/** @deprecated Use TEN_GOD_KEYS instead */
+export const TEN_GODS = [
+    "비견",
+    "겁재",
+    "식신",
+    "상관",
+    "편재",
+    "정재",
+    "편관",
+    "정관",
+    "편인",
+    "정인",
+];
+/** @deprecated Use TEN_GOD_DATA instead */
+export const TEN_GOD_HANJA = {
+    비견: "比肩",
+    겁재: "劫財",
+    식신: "食神",
+    상관: "傷官",
+    편재: "偏財",
+    정재: "正財",
+    편관: "偏官",
+    정관: "正官",
+    편인: "偏印",
+    정인: "正印",
+};
+/** @deprecated Use TEN_GOD_DATA instead */
+export const TEN_GOD_ENGLISH = {
+    비견: "Companion",
+    겁재: "Rob Wealth",
+    식신: "Eating God",
+    상관: "Hurting Officer",
+    편재: "Indirect Wealth",
+    정재: "Direct Wealth",
+    편관: "Seven Killings",
+    정관: "Direct Officer",
+    편인: "Indirect Seal",
+    정인: "Direct Seal",
+};
+/** @deprecated Use getTenGodLabel(getTenGodKey(...)) instead */
+export function getTenGod(dayMaster, targetStem) {
+    const key = getTenGodKey(dayMaster, targetStem);
+    return TEN_GOD_DATA[key].korean;
+}