@gracefullight/saju 0.4.2 → 0.6.0

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) {
+export 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,

package/dist/core/twelve-stages.d.ts

@@ -1,17 +1,17 @@
+import type { Label } from "../types/common";
 export declare const TWELVE_STAGES: readonly ["longLife", "bathing", "crownBelt", "establishment", "imperial", "decline", "illness", "death", "tomb", "extinction", "conception", "nurturing"];
-export type TwelveStage = (typeof TWELVE_STAGES)[number];
-export declare function getTwelveStage(stem: string, branch: string): TwelveStage;
+export type TwelveStageKey = (typeof TWELVE_STAGES)[number];
+export type TwelveStageStrength = "strong" | "neutral" | "weak";
+export interface TwelveStageLabel extends Label<TwelveStageKey> {
+    meaning: string;
+    strength: TwelveStageStrength;
+}
+export declare function getTwelveStageLabel(key: TwelveStageKey): TwelveStageLabel;
 export interface TwelveStagesResult {
-    year: TwelveStage;
-    month: TwelveStage;
-    day: TwelveStage;
-    hour: TwelveStage;
+    year: TwelveStageLabel;
+    month: TwelveStageLabel;
+    day: TwelveStageLabel;
+    hour: TwelveStageLabel;
 }
 export declare function analyzeTwelveStages(yearPillar: string, monthPillar: string, dayPillar: string, hourPillar: string): TwelveStagesResult;
-export declare const STAGE_INFO: Record<TwelveStage, {
-    korean: string;
-    hanja: string;
-    meaning: string;
-    strength: "strong" | "neutral" | "weak";
-}>;
 //# sourceMappingURL=twelve-stages.d.ts.map

package/dist/core/twelve-stages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"twelve-stages.d.ts","sourceRoot":"","sources":["../../src/core/twelve-stages.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,4JAahB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAkBzD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAwBxE;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,WAAW,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,kBAAkB,CASpB;AAED,eAAO,MAAM,UAAU,EAAE,MAAM,CAC7B,WAAW,EACX;IACE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;CACzC,CAmBF,CAAC"}
+{"version":3,"file":"twelve-stages.d.ts","sourceRoot":"","sources":["../../src/core/twelve-stages.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,eAAO,MAAM,aAAa,4JAahB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAEhE,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAyCD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,gBAAgB,CAGzE;AA4BD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,gBAAgB,CAAC;IACxB,GAAG,EAAE,gBAAgB,CAAC;IACtB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,kBAAkB,CASpB"}

package/dist/core/twelve-stages.js

@@ -27,7 +27,30 @@ const YIN_STEM_BIRTH_BRANCH = {
     辛: "子",
     癸: "卯",
 };
-export function getTwelveStage(stem, branch) {
+const STAGE_DATA = {
+    longLife: {
+        korean: "장생",
+        hanja: "長生",
+        meaning: "새로운 시작, 성장의 기운",
+        strength: "strong",
+    },
+    bathing: { korean: "목욕", hanja: "沐浴", meaning: "불안정, 변화, 도화", strength: "neutral" },
+    crownBelt: { korean: "관대", hanja: "冠帶", meaning: "성장, 준비, 학업", strength: "strong" },
+    establishment: { korean: "건록", hanja: "建祿", meaning: "안정, 직업, 녹봉", strength: "strong" },
+    imperial: { korean: "제왕", hanja: "帝旺", meaning: "최고 전성기, 권력", strength: "strong" },
+    decline: { korean: "쇠", hanja: "衰", meaning: "기운 약화, 후퇴", strength: "weak" },
+    illness: { korean: "병", hanja: "病", meaning: "질병, 곤란", strength: "weak" },
+    death: { korean: "사", hanja: "死", meaning: "끝, 전환점", strength: "weak" },
+    tomb: { korean: "묘", hanja: "墓", meaning: "저장, 숨김, 보관", strength: "neutral" },
+    extinction: { korean: "절", hanja: "絶", meaning: "단절, 새로운 국면", strength: "weak" },
+    conception: { korean: "태", hanja: "胎", meaning: "잉태, 계획, 구상", strength: "neutral" },
+    nurturing: { korean: "양", hanja: "養", meaning: "양육, 준비, 축적", strength: "neutral" },
+};
+export function getTwelveStageLabel(key) {
+    const data = STAGE_DATA[key];
+    return { key, ...data };
+}
+function getTwelveStageKey(stem, branch) {
     const isYang = isYangStem(stem);
     const birthBranch = isYang ? YANG_STEM_BIRTH_BRANCH[stem] : YIN_STEM_BIRTH_BRANCH[stem];
     if (!birthBranch) {
@@ -50,28 +73,9 @@ export function getTwelveStage(stem, branch) {
 export function analyzeTwelveStages(yearPillar, monthPillar, dayPillar, hourPillar) {
     const dayMaster = dayPillar[0];
     return {
-        year: getTwelveStage(dayMaster, yearPillar[1]),
-        month: getTwelveStage(dayMaster, monthPillar[1]),
-        day: getTwelveStage(dayMaster, dayPillar[1]),
-        hour: getTwelveStage(dayMaster, hourPillar[1]),
+        year: getTwelveStageLabel(getTwelveStageKey(dayMaster, yearPillar[1])),
+        month: getTwelveStageLabel(getTwelveStageKey(dayMaster, monthPillar[1])),
+        day: getTwelveStageLabel(getTwelveStageKey(dayMaster, dayPillar[1])),
+        hour: getTwelveStageLabel(getTwelveStageKey(dayMaster, hourPillar[1])),
     };
 }
-export const STAGE_INFO = {
-    longLife: {
-        korean: "장생",
-        hanja: "長生",
-        meaning: "새로운 시작, 성장의 기운",
-        strength: "strong",
-    },
-    bathing: { korean: "목욕", hanja: "沐浴", meaning: "불안정, 변화, 도화", strength: "neutral" },
-    crownBelt: { korean: "관대", hanja: "冠帶", meaning: "성장, 준비, 학업", strength: "strong" },
-    establishment: { korean: "건록", hanja: "建祿", meaning: "안정, 직업, 녹봉", strength: "strong" },
-    imperial: { korean: "제왕", hanja: "帝旺", meaning: "최고 전성기, 권력", strength: "strong" },
-    decline: { korean: "쇠", hanja: "衰", meaning: "기운 약화, 후퇴", strength: "weak" },
-    illness: { korean: "병", hanja: "病", meaning: "질병, 곤란", strength: "weak" },
-    death: { korean: "사", hanja: "死", meaning: "끝, 전환점", strength: "weak" },
-    tomb: { korean: "묘", hanja: "墓", meaning: "저장, 숨김, 보관", strength: "neutral" },
-    extinction: { korean: "절", hanja: "絶", meaning: "단절, 새로운 국면", strength: "weak" },
-    conception: { korean: "태", hanja: "胎", meaning: "잉태, 계획, 구상", strength: "neutral" },
-    nurturing: { korean: "양", hanja: "養", meaning: "양육, 준비, 축적", strength: "neutral" },
-};

package/dist/core/yongshen.d.ts

@@ -1,16 +1,25 @@
-import { type Element } from "./ten-gods";
-export type YongShenMethod = "격국" | "억부" | "조후" | "통관" | "병약";
+import { type Element, type ElementLabel } from "./ten-gods";
+export type YongShenMethodKey = "formation" | "balance" | "climate" | "bridge" | "disease";
+export interface YongShenMethodLabel extends Label<YongShenMethodKey> {
+}
+export declare function getYongShenMethodLabel(key: YongShenMethodKey): YongShenMethodLabel;
 export interface YongShenResult {
-    primary: Element;
-    secondary: Element | null;
-    method: YongShenMethod;
+    primary: ElementLabel;
+    secondary: ElementLabel | null;
+    method: YongShenMethodLabel;
     reasoning: string;
     allElements: Record<Element, {
         isYongShen: boolean;
         isKiShen: boolean;
     }>;
-    johuAdjustment: Element | null;
+    johuAdjustment: ElementLabel | null;
+    /** 종격 성립 시 억부 기준 용신도 함께 제공 */
+    alternativeBalance?: {
+        primary: ElementLabel;
+        secondary: ElementLabel | null;
+    };
 }
+import type { Label } from "../types";
 export declare function analyzeYongShen(yearPillar: string, monthPillar: string, dayPillar: string, hourPillar: string): YongShenResult;
 export declare function getElementRecommendations(yongShen: YongShenResult): {
     colors: string[];

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

@@ -1 +1 @@
-{"version":3,"file":"yongshen.d.ts","sourceRoot":"","sources":["../../src/core/yongshen.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,OAAO,EAAoC,MAAM,YAAY,CAAC;AAEtF,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACzE,cAAc,EAAE,OAAO,GAAG,IAAI,CAAC;CAChC;AAmJD,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,cAAc,CA+EhB;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,cAAc,GAAG;IACnE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CA0BA"}
+{"version":3,"file":"yongshen.d.ts","sourceRoot":"","sources":["../../src/core/yongshen.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,YAAY,EAIlB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3F,MAAM,WAAW,mBAAoB,SAAQ,KAAK,CAAC,iBAAiB,CAAC;CAAG;AAUxE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,iBAAiB,GAAG,mBAAmB,CAGlF;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACzE,cAAc,EAAE,YAAY,GAAG,IAAI,CAAC;IACpC,8BAA8B;IAC9B,kBAAkB,CAAC,EAAE;QACnB,OAAO,EAAE,YAAY,CAAC;QACtB,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;KAChC,CAAC;CACH;AAED,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AA0JrC,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,cAAc,CA2FhB;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,cAAc,GAAG;IACnE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CA0BA"}

package/dist/core/yongshen.js

@@ -1,5 +1,16 @@
 import { analyzeStrength } from "./strength";
-import { ELEMENTS, getBranchElement, getStemElement } from "./ten-gods";
+import { ELEMENTS, getBranchElement, getElementLabel, getStemElement, } from "./ten-gods";
+const YONGSHEN_METHOD_DATA = {
+    formation: { korean: "격국", hanja: "格局" },
+    balance: { korean: "억부", hanja: "抑扶" },
+    climate: { korean: "조후", hanja: "調候" },
+    bridge: { korean: "통관", hanja: "通關" },
+    disease: { korean: "병약", hanja: "病藥" },
+};
+export function getYongShenMethodLabel(key) {
+    const data = YONGSHEN_METHOD_DATA[key];
+    return { key, ...data };
+}
 const SEASON_MONTH_BRANCHES = {
     spring: ["寅", "卯", "辰"],
     summer: ["巳", "午", "未"],
@@ -72,10 +83,18 @@ const CONTROLLED_BY = {
     metal: "fire",
     wood: "metal",
 };
-function getYokbuYongShen(dayMasterElement, strengthLevel) {
-    const isStrong = ["신강", "태강", "극왕", "중화신강"].includes(strengthLevel);
-    if (isStrong) {
-        const primary = CONTROLS[dayMasterElement];
+const STRONG_LEVEL_KEYS = [
+    "strong",
+    "veryStrong",
+    "extremelyStrong",
+    "neutralStrong",
+];
+function isStrongLevel(level) {
+    return STRONG_LEVEL_KEYS.includes(level.key);
+}
+function getYokbuYongShen(dayMasterElement, level) {
+    if (isStrongLevel(level)) {
+        const primary = CONTROLLED_BY[dayMasterElement];
         const secondary = GENERATES[dayMasterElement];
         return { primary, secondary };
     }
@@ -83,9 +102,8 @@ function getYokbuYongShen(dayMasterElement, strengthLevel) {
     const secondary = dayMasterElement;
     return { primary, secondary };
 }
-function hasSpecialFormation(dayMasterElement, strengthLevel, allElements) {
-    const _isExtreme = ["극약", "극왕"].includes(strengthLevel);
-    if (strengthLevel === "극약") {
+function hasSpecialFormation(dayMasterElement, level, allElements) {
+    if (level.key === "extremelyWeak") {
         const elementCounts = {
             wood: 0,
             fire: 0,
@@ -127,32 +145,35 @@ export function analyzeYongShen(yearPillar, monthPillar, dayPillar, hourPillar)
     const allBranches = [yearPillar[1], monthPillar[1], dayPillar[1], hourPillar[1]];
     const allBranchElements = allBranches.map((b) => getBranchElement(b));
     const specialFormation = hasSpecialFormation(dayMasterElement, strength.level, allBranchElements);
-    let primary;
-    let secondary = null;
-    let method;
+    let primaryKey;
+    let secondaryKey = null;
+    let methodKey;
     let reasoning;
-    let johuAdjustment = null;
+    let johuAdjustmentKey = null;
+    let alternativeBalance;
     if (specialFormation.isSpecial && specialFormation.followElement) {
-        primary = specialFormation.followElement;
-        secondary = GENERATES[specialFormation.followElement];
-        method = "격국";
-        reasoning = `${specialFormation.type} 성립. ${specialFormation.followElement} 세력을 따름`;
+        primaryKey = specialFormation.followElement;
+        secondaryKey = GENERATES[specialFormation.followElement];
+        methodKey = "formation";
+        reasoning = `종격 성립. ${getElementLabel(specialFormation.followElement).korean} 세력을 따름`;
+        const yokbu = getYokbuYongShen(dayMasterElement, strength.level);
+        alternativeBalance = { primary: yokbu.primary, secondary: yokbu.secondary };
     }
     else {
         const yokbu = getYokbuYongShen(dayMasterElement, strength.level);
-        primary = yokbu.primary;
-        secondary = yokbu.secondary;
-        method = "억부";
-        const isStrong = ["신강", "태강", "극왕", "중화신강"].includes(strength.level);
-        if (isStrong) {
-            reasoning = `${strength.level} 상태로 설기(洩氣) 필요. ${primary}로 기운을 발산`;
+        primaryKey = yokbu.primary;
+        secondaryKey = yokbu.secondary;
+        methodKey = "balance";
+        const strong = isStrongLevel(strength.level);
+        if (strong) {
+            reasoning = `${strength.level.korean} 상태로 설기(洩氣) 필요. ${getElementLabel(primaryKey).korean}로 기운을 발산`;
         }
         else {
-            reasoning = `${strength.level} 상태로 부조(扶助) 필요. ${primary}로 일간을 생조`;
+            reasoning = `${strength.level.korean} 상태로 부조(扶助) 필요. ${getElementLabel(primaryKey).korean}로 일간을 생조`;
         }
-        johuAdjustment = getJohuAdjustment(dayMasterElement, season, primary);
-        if (johuAdjustment) {
-            reasoning += `. 조후 보정: ${season} 계절에 ${johuAdjustment} 참고`;
+        johuAdjustmentKey = getJohuAdjustment(dayMasterElement, season, primaryKey);
+        if (johuAdjustmentKey) {
+            reasoning += `. 조후 보정: ${season} 계절에 ${getElementLabel(johuAdjustmentKey).korean} 참고`;
         }
     }
     const allElements = {
@@ -162,12 +183,12 @@ export function analyzeYongShen(yearPillar, monthPillar, dayPillar, hourPillar)
         metal: { isYongShen: false, isKiShen: false },
         water: { isYongShen: false, isKiShen: false },
     };
-    allElements[primary].isYongShen = true;
-    if (secondary)
-        allElements[secondary].isYongShen = true;
-    const isStrong = ["신강", "태강", "극왕", "중화신강"].includes(strength.level);
-    if (method !== "격국") {
-        if (isStrong) {
+    allElements[primaryKey].isYongShen = true;
+    if (secondaryKey)
+        allElements[secondaryKey].isYongShen = true;
+    const strong = isStrongLevel(strength.level);
+    if (methodKey !== "formation") {
+        if (strong) {
             allElements[dayMasterElement].isKiShen = true;
             allElements[GENERATED_BY[dayMasterElement]].isKiShen = true;
         }
@@ -182,12 +203,20 @@ export function analyzeYongShen(yearPillar, monthPillar, dayPillar, hourPillar)
         }
     }
     return {
-        primary,
-        secondary,
-        method,
+        primary: getElementLabel(primaryKey),
+        secondary: secondaryKey ? getElementLabel(secondaryKey) : null,
+        method: getYongShenMethodLabel(methodKey),
         reasoning,
         allElements,
-        johuAdjustment,
+        johuAdjustment: johuAdjustmentKey ? getElementLabel(johuAdjustmentKey) : null,
+        alternativeBalance: alternativeBalance
+            ? {
+                primary: getElementLabel(alternativeBalance.primary),
+                secondary: alternativeBalance.secondary
+                    ? getElementLabel(alternativeBalance.secondary)
+                    : null,
+            }
+            : undefined,
     };
 }
 export function getElementRecommendations(yongShen) {
@@ -198,12 +227,12 @@ export function getElementRecommendations(yongShen) {
         metal: { colors: ["백색", "금색"], direction: "서", numbers: [4, 9] },
         water: { colors: ["흑색", "남색"], direction: "북", numbers: [1, 6] },
     };
-    const primary = elementData[yongShen.primary];
+    const primary = elementData[yongShen.primary.key];
     const colors = [...primary.colors];
     const directions = [primary.direction];
     const numbers = [...primary.numbers];
     if (yongShen.secondary) {
-        const secondary = elementData[yongShen.secondary];
+        const secondary = elementData[yongShen.secondary.key];
         colors.push(...secondary.colors);
         directions.push(secondary.direction);
         numbers.push(...secondary.numbers);