@gracefullight/saju 0.4.2 → 0.6.0

package/dist/__tests__/relations.test.js

@@ -48,7 +48,7 @@ describe("relations", () => {
     describe("analyzeRelations", () => {
         it("finds stem combinations in four pillars", () => {
             const result = analyzeRelations("甲子", "己丑", "丙寅", "辛亥");
-            const stemCombos = result.combinations.filter((c) => c.type === "천간합");
+            const stemCombos = result.combinations.filter((c) => c.type.key === "stemCombination");
             expect(stemCombos.length).toBeGreaterThan(0);
         });
         it("finds branch clashes in four pillars", () => {
@@ -57,23 +57,23 @@ describe("relations", () => {
         });
         it("finds 삼합 (triple combination)", () => {
             const result = analyzeRelations("甲寅", "丙午", "戊戌", "庚子");
-            const tripleCombos = result.combinations.filter((c) => c.type === "삼합");
+            const tripleCombos = result.combinations.filter((c) => c.type.key === "tripleCombination");
             expect(tripleCombos.length).toBeGreaterThan(0);
-            expect(tripleCombos[0].resultElement).toBe("fire");
+            expect(tripleCombos[0].resultElement.key).toBe("fire");
         });
         it("finds 육합 (six combination)", () => {
             const result = analyzeRelations("甲子", "乙丑", "丙寅", "丁卯");
-            const sixCombos = result.combinations.filter((c) => c.type === "육합");
+            const sixCombos = result.combinations.filter((c) => c.type.key === "sixCombination");
             expect(sixCombos.length).toBeGreaterThan(0);
         });
         it("finds 형 (punishment)", () => {
             const result = analyzeRelations("甲寅", "丙巳", "戊申", "庚子");
             expect(result.punishments.length).toBeGreaterThan(0);
-            expect(result.punishments[0].punishmentType).toBe("무은지형");
+            expect(result.punishments[0].punishmentType.key).toBe("ungrateful");
         });
         it("includes transformStatus and transformReason for combinations", () => {
             const result = analyzeRelations("甲子", "己丑", "丙寅", "辛亥");
-            const stemCombos = result.combinations.filter((c) => c.type === "천간합");
+            const stemCombos = result.combinations.filter((c) => c.type.key === "stemCombination");
             expect(stemCombos.length).toBeGreaterThan(0);
             expect(stemCombos[0]).toHaveProperty("transformStatus");
             expect(stemCombos[0]).toHaveProperty("transformReason");

package/dist/__tests__/saju.test.js

@@ -32,8 +32,8 @@ describe("getSaju integration", () => {
             gender: "female",
             preset: STANDARD_PRESET,
         });
-        expect(result.solarTerms.current.name).toBe("소한");
-        expect(result.solarTerms.next.name).toBe("대한");
+        expect(result.solarTerms.current.korean).toBe("소한");
+        expect(result.solarTerms.next.korean).toBe("대한");
         expect(result.solarTerms.daysSinceCurrent).toBeGreaterThanOrEqual(0);
         expect(result.solarTerms.daysUntilNext).toBeGreaterThan(0);
         expect(result.solarTerms.currentDate).toBeDefined();
@@ -99,7 +99,7 @@ describe("getSaju integration", () => {
             preset: STANDARD_PRESET,
         });
         expect(result.tenGods.dayMaster).toBe("丁");
-        expect(result.tenGods.day.stem.tenGod).toBe("일간");
+        expect(result.tenGods.day.stem.tenGod.key).toBe("dayMaster");
     });
     it("calculates major luck start age based on actual solar terms (not fixed 10)", async () => {
         const adapter = await createLuxonAdapter();

package/dist/__tests__/sinsals.test.js

@@ -4,17 +4,17 @@ describe("sinsals", () => {
     describe("analyzeSinsals", () => {
         it("should detect peach blossom (도화살)", () => {
             const result = analyzeSinsals("甲寅", "丙寅", "戊卯", "庚午");
-            const peachBlossoms = result.matches.filter((m) => m.sinsal === "peachBlossom");
+            const peachBlossoms = result.matches.filter((m) => m.sinsal.key === "peachBlossom");
             expect(peachBlossoms.length).toBeGreaterThan(0);
         });
         it("should detect sky horse (역마살)", () => {
             const result = analyzeSinsals("甲寅", "丙寅", "戊申", "庚午");
-            const skyHorses = result.matches.filter((m) => m.sinsal === "skyHorse");
+            const skyHorses = result.matches.filter((m) => m.sinsal.key === "skyHorse");
             expect(skyHorses.length).toBeGreaterThan(0);
         });
         it("should detect flowery canopy (화개살)", () => {
             const result = analyzeSinsals("甲寅", "丙戌", "戊子", "庚午");
-            const floweryCanopies = result.matches.filter((m) => m.sinsal === "floweryCanopy");
+            const floweryCanopies = result.matches.filter((m) => m.sinsal.key === "floweryCanopy");
             expect(floweryCanopies.length).toBeGreaterThan(0);
         });
         it("should return summary grouped by sinsal", () => {
@@ -29,14 +29,14 @@ describe("sinsals", () => {
             const result = analyzeSinsals("甲子", "丙寅", "戊辰", "庚午");
             const seen = new Set();
             for (const match of result.matches) {
-                const key = `${match.sinsal}-${match.position}`;
+                const key = `${match.sinsal.key}-${match.position}`;
                 expect(seen.has(key)).toBe(false);
                 seen.add(key);
             }
         });
         it("should detect sky noble (천을귀인)", () => {
             const result = analyzeSinsals("甲丑", "丙寅", "甲子", "庚午");
-            const skyNobles = result.matches.filter((m) => m.sinsal === "skyNoble");
+            const skyNobles = result.matches.filter((m) => m.sinsal.key === "skyNoble");
             expect(skyNobles.length).toBeGreaterThan(0);
         });
     });

package/dist/__tests__/solar-terms.test.js

@@ -15,51 +15,61 @@ describe("solar-terms", async () => {
             }
         });
         it("should start with 소한 at 285°", () => {
-            expect(SOLAR_TERMS[0]).toEqual({ name: "소한", hanja: "小寒", longitude: 285 });
+            expect(SOLAR_TERMS[0]).toEqual({
+                key: "minorCold",
+                korean: "소한",
+                hanja: "小寒",
+                longitude: 285,
+            });
         });
         it("should have 입춘 at 315°", () => {
-            const ipchun = SOLAR_TERMS.find((t) => t.name === "입춘");
-            expect(ipchun).toEqual({ name: "입춘", hanja: "立春", longitude: 315 });
+            const ipchun = SOLAR_TERMS.find((t) => t.korean === "입춘");
+            expect(ipchun).toEqual({
+                key: "springBegins",
+                korean: "입춘",
+                hanja: "立春",
+                longitude: 315,
+            });
         });
     });
     describe("analyzeSolarTerms", () => {
         it("should return current and next solar terms for mid-January", () => {
             const dt = DateTime.fromObject({ year: 2024, month: 1, day: 15 }, { zone: "Asia/Seoul" });
             const result = analyzeSolarTerms(adapter, dt);
-            expect(result.current.name).toBe("소한");
-            expect(result.next.name).toBe("대한");
+            expect(result.current.korean).toBe("소한");
+            expect(result.next.korean).toBe("대한");
             expect(result.daysSinceCurrent).toBeGreaterThanOrEqual(0);
             expect(result.daysUntilNext).toBeGreaterThan(0);
         });
         it("should return current and next solar terms for early February", () => {
             const dt = DateTime.fromObject({ year: 2024, month: 2, day: 3 }, { zone: "Asia/Seoul" });
             const result = analyzeSolarTerms(adapter, dt);
-            expect(result.current.name).toBe("대한");
-            expect(result.next.name).toBe("입춘");
+            expect(result.current.korean).toBe("대한");
+            expect(result.next.korean).toBe("입춘");
         });
         it("should return current and next solar terms for summer solstice period", () => {
             const dt = DateTime.fromObject({ year: 2024, month: 6, day: 25 }, { zone: "Asia/Seoul" });
             const result = analyzeSolarTerms(adapter, dt);
-            expect(result.current.name).toBe("하지");
-            expect(result.next.name).toBe("소서");
+            expect(result.current.korean).toBe("하지");
+            expect(result.next.korean).toBe("소서");
         });
         it("should return current and next solar terms for winter solstice period", () => {
             const dt = DateTime.fromObject({ year: 2024, month: 12, day: 25 }, { zone: "Asia/Seoul" });
             const result = analyzeSolarTerms(adapter, dt);
-            expect(result.current.name).toBe("동지");
-            expect(result.next.name).toBe("소한");
+            expect(result.current.korean).toBe("동지");
+            expect(result.next.korean).toBe("소한");
         });
         it("should calculate days since current term correctly", () => {
             const dt = DateTime.fromObject({ year: 2024, month: 3, day: 25 }, { zone: "Asia/Seoul" });
             const result = analyzeSolarTerms(adapter, dt);
-            expect(result.current.name).toBe("춘분");
+            expect(result.current.korean).toBe("춘분");
             expect(result.daysSinceCurrent).toBeGreaterThanOrEqual(0);
             expect(result.daysSinceCurrent).toBeLessThan(16);
         });
         it("should calculate days until next term correctly", () => {
             const dt = DateTime.fromObject({ year: 2024, month: 4, day: 1 }, { zone: "Asia/Seoul" });
             const result = analyzeSolarTerms(adapter, dt);
-            expect(result.next.name).toBe("청명");
+            expect(result.next.korean).toBe("청명");
             expect(result.daysUntilNext).toBeGreaterThan(0);
             expect(result.daysUntilNext).toBeLessThan(16);
         });
@@ -85,7 +95,7 @@ describe("solar-terms", async () => {
         });
         it("should have all terms in order", () => {
             const terms = getSolarTermsForYear(adapter, 2024, "Asia/Seoul");
-            const names = terms.map((t) => t.term.name);
+            const names = terms.map((t) => t.term.korean);
             expect(names[0]).toBe("소한");
             expect(names[2]).toBe("입춘");
             expect(names[5]).toBe("춘분");
@@ -105,14 +115,14 @@ describe("solar-terms", async () => {
         });
         it("should have 입춘 around February 4", () => {
             const terms = getSolarTermsForYear(adapter, 2024, "Asia/Seoul");
-            const ipchun = terms.find((t) => t.term.name === "입춘");
+            const ipchun = terms.find((t) => t.term.korean === "입춘");
             expect(ipchun?.date.month).toBe(2);
             expect(ipchun?.date.day).toBeGreaterThanOrEqual(3);
             expect(ipchun?.date.day).toBeLessThanOrEqual(5);
         });
         it("should have 하지 around June 21", () => {
             const terms = getSolarTermsForYear(adapter, 2024, "Asia/Seoul");
-            const haji = terms.find((t) => t.term.name === "하지");
+            const haji = terms.find((t) => t.term.korean === "하지");
             expect(haji?.date.month).toBe(6);
             expect(haji?.date.day).toBeGreaterThanOrEqual(20);
             expect(haji?.date.day).toBeLessThanOrEqual(22);

package/dist/__tests__/strength.test.js

@@ -29,11 +29,11 @@ describe("strength", () => {
         });
         it("returns 신강 for strong day master", () => {
             const result = analyzeStrength("甲子", "甲寅", "甲寅", "甲寅");
-            expect(["신강", "태강", "극왕", "중화신강"]).toContain(result.level);
+            expect(["신강", "태강", "극왕", "중화신강"]).toContain(result.level.korean);
         });
         it("returns 신약 for weak day master", () => {
             const result = analyzeStrength("庚申", "庚申", "甲申", "庚申");
-            expect(["신약", "태약", "극약", "중화신약"]).toContain(result.level);
+            expect(["신약", "태약", "극약", "중화신약"]).toContain(result.level.korean);
         });
         it("includes description with day master info", () => {
             const result = analyzeStrength("甲子", "丙寅", "甲辰", "乙亥");

package/dist/__tests__/ten-gods.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { analyzeTenGods, countElements, countTenGods, getBranchElement, getHiddenStems, getStemElement, getStemPolarity, getTenGod, } from "../core/ten-gods";
+import { analyzeTenGods, countElements, countTenGods, getBranchElement, getHiddenStems, getStemElement, getStemPolarity, getTenGodKey, getTenGodLabel, } from "../core/ten-gods";
 describe("ten-gods", () => {
     describe("getStemElement", () => {
         it("returns correct element for each stem", () => {
@@ -42,56 +42,70 @@ describe("ten-gods", () => {
             expect(getHiddenStems("午")).toEqual(["丁", "己"]);
         });
     });
-    describe("getTenGod", () => {
-        it("correctly identifies 비견 (same element, same polarity)", () => {
-            expect(getTenGod("甲", "甲")).toBe("비견");
-            expect(getTenGod("乙", "乙")).toBe("비견");
+    describe("getTenGodKey", () => {
+        it("correctly identifies companion (same element, same polarity)", () => {
+            expect(getTenGodKey("甲", "甲")).toBe("companion");
+            expect(getTenGodKey("乙", "乙")).toBe("companion");
         });
-        it("correctly identifies 겁재 (same element, different polarity)", () => {
-            expect(getTenGod("甲", "乙")).toBe("겁재");
-            expect(getTenGod("乙", "甲")).toBe("겁재");
+        it("correctly identifies robWealth (same element, different polarity)", () => {
+            expect(getTenGodKey("甲", "乙")).toBe("robWealth");
+            expect(getTenGodKey("乙", "甲")).toBe("robWealth");
         });
-        it("correctly identifies 식신 (I generate, same polarity)", () => {
-            expect(getTenGod("甲", "丙")).toBe("식신");
-            expect(getTenGod("丙", "戊")).toBe("식신");
+        it("correctly identifies eatingGod (I generate, same polarity)", () => {
+            expect(getTenGodKey("甲", "丙")).toBe("eatingGod");
+            expect(getTenGodKey("丙", "戊")).toBe("eatingGod");
         });
-        it("correctly identifies 상관 (I generate, different polarity)", () => {
-            expect(getTenGod("甲", "丁")).toBe("상관");
-            expect(getTenGod("丙", "己")).toBe("상관");
+        it("correctly identifies hurtingOfficer (I generate, different polarity)", () => {
+            expect(getTenGodKey("甲", "丁")).toBe("hurtingOfficer");
+            expect(getTenGodKey("丙", "己")).toBe("hurtingOfficer");
         });
-        it("correctly identifies 편재 (I control, same polarity)", () => {
-            expect(getTenGod("甲", "戊")).toBe("편재");
-            expect(getTenGod("丙", "庚")).toBe("편재");
+        it("correctly identifies indirectWealth (I control, same polarity)", () => {
+            expect(getTenGodKey("甲", "戊")).toBe("indirectWealth");
+            expect(getTenGodKey("丙", "庚")).toBe("indirectWealth");
         });
-        it("correctly identifies 정재 (I control, different polarity)", () => {
-            expect(getTenGod("甲", "己")).toBe("정재");
-            expect(getTenGod("丙", "辛")).toBe("정재");
+        it("correctly identifies directWealth (I control, different polarity)", () => {
+            expect(getTenGodKey("甲", "己")).toBe("directWealth");
+            expect(getTenGodKey("丙", "辛")).toBe("directWealth");
         });
-        it("correctly identifies 편관 (controls me, same polarity)", () => {
-            expect(getTenGod("甲", "庚")).toBe("편관");
-            expect(getTenGod("丙", "壬")).toBe("편관");
+        it("correctly identifies sevenKillings (controls me, same polarity)", () => {
+            expect(getTenGodKey("甲", "庚")).toBe("sevenKillings");
+            expect(getTenGodKey("丙", "壬")).toBe("sevenKillings");
         });
-        it("correctly identifies 정관 (controls me, different polarity)", () => {
-            expect(getTenGod("甲", "辛")).toBe("정관");
-            expect(getTenGod("丙", "癸")).toBe("정관");
+        it("correctly identifies directOfficer (controls me, different polarity)", () => {
+            expect(getTenGodKey("甲", "辛")).toBe("directOfficer");
+            expect(getTenGodKey("丙", "癸")).toBe("directOfficer");
         });
-        it("correctly identifies 편인 (generates me, same polarity)", () => {
-            expect(getTenGod("甲", "壬")).toBe("편인");
-            expect(getTenGod("丙", "甲")).toBe("편인");
+        it("correctly identifies indirectSeal (generates me, same polarity)", () => {
+            expect(getTenGodKey("甲", "壬")).toBe("indirectSeal");
+            expect(getTenGodKey("丙", "甲")).toBe("indirectSeal");
         });
-        it("correctly identifies 정인 (generates me, different polarity)", () => {
-            expect(getTenGod("甲", "癸")).toBe("정인");
-            expect(getTenGod("丙", "乙")).toBe("정인");
+        it("correctly identifies directSeal (generates me, different polarity)", () => {
+            expect(getTenGodKey("甲", "癸")).toBe("directSeal");
+            expect(getTenGodKey("丙", "乙")).toBe("directSeal");
+        });
+    });
+    describe("getTenGodLabel", () => {
+        it("returns correct Korean labels", () => {
+            expect(getTenGodLabel("companion").korean).toBe("비견");
+            expect(getTenGodLabel("robWealth").korean).toBe("겁재");
+            expect(getTenGodLabel("eatingGod").korean).toBe("식신");
+            expect(getTenGodLabel("hurtingOfficer").korean).toBe("상관");
+            expect(getTenGodLabel("indirectWealth").korean).toBe("편재");
+            expect(getTenGodLabel("directWealth").korean).toBe("정재");
+            expect(getTenGodLabel("sevenKillings").korean).toBe("편관");
+            expect(getTenGodLabel("directOfficer").korean).toBe("정관");
+            expect(getTenGodLabel("indirectSeal").korean).toBe("편인");
+            expect(getTenGodLabel("directSeal").korean).toBe("정인");
         });
     });
     describe("analyzeTenGods", () => {
         it("analyzes four pillars correctly", () => {
             const result = analyzeTenGods("甲子", "丙寅", "甲辰", "乙亥");
             expect(result.dayMaster).toBe("甲");
-            expect(result.year.stem.tenGod).toBe("비견");
-            expect(result.month.stem.tenGod).toBe("식신");
-            expect(result.day.stem.tenGod).toBe("일간");
-            expect(result.hour.stem.tenGod).toBe("겁재");
+            expect(result.year.stem.tenGod.key).toBe("companion");
+            expect(result.month.stem.tenGod.key).toBe("eatingGod");
+            expect(result.day.stem.tenGod.key).toBe("dayMaster");
+            expect(result.hour.stem.tenGod.key).toBe("robWealth");
         });
         it("includes hidden stems analysis", () => {
             const result = analyzeTenGods("甲子", "丙寅", "甲辰", "乙亥");
@@ -104,8 +118,8 @@ describe("ten-gods", () => {
         it("counts ten gods correctly", () => {
             const analysis = analyzeTenGods("甲子", "丙寅", "甲辰", "乙亥");
             const counts = countTenGods(analysis);
-            expect(counts.비견).toBeGreaterThanOrEqual(1);
-            expect(counts.식신).toBeGreaterThanOrEqual(1);
+            expect(counts.companion).toBeGreaterThanOrEqual(1);
+            expect(counts.eatingGod).toBeGreaterThanOrEqual(1);
         });
     });
     describe("countElements", () => {

package/dist/__tests__/twelve-stages.test.js

@@ -1,86 +1,90 @@
 import { describe, expect, it } from "vitest";
-import { analyzeTwelveStages, getTwelveStage, STAGE_INFO, TWELVE_STAGES, } from "../core/twelve-stages";
+import { analyzeTwelveStages, getTwelveStageLabel, TWELVE_STAGES } from "../core/twelve-stages";
 describe("twelve-stages", () => {
-    describe("getTwelveStage", () => {
+    describe("analyzeTwelveStages", () => {
+        it("should analyze all four pillars", () => {
+            const result = analyzeTwelveStages("甲子", "丙寅", "戊辰", "庚午");
+            expect(result.year).toBeDefined();
+            expect(result.month).toBeDefined();
+            expect(result.day).toBeDefined();
+            expect(result.hour).toBeDefined();
+            expect(TWELVE_STAGES).toContain(result.year.key);
+            expect(TWELVE_STAGES).toContain(result.month.key);
+            expect(TWELVE_STAGES).toContain(result.day.key);
+            expect(TWELVE_STAGES).toContain(result.hour.key);
+        });
+        it("should correctly analyze 戊 day master", () => {
+            const result = analyzeTwelveStages("甲子", "丙寅", "戊辰", "庚午");
+            expect(result.month.key).toBe("longLife");
+            expect(result.hour.key).toBe("imperial");
+        });
         it("should return longLife for 甲 at 亥", () => {
-            expect(getTwelveStage("甲", "亥")).toBe("longLife");
+            const result = analyzeTwelveStages("甲亥", "甲亥", "甲亥", "甲亥");
+            expect(result.year.key).toBe("longLife");
         });
         it("should return imperial for 甲 at 卯", () => {
-            expect(getTwelveStage("甲", "卯")).toBe("imperial");
+            const result = analyzeTwelveStages("甲卯", "甲卯", "甲卯", "甲卯");
+            expect(result.year.key).toBe("imperial");
         });
         it("should return tomb for 甲 at 未", () => {
-            expect(getTwelveStage("甲", "未")).toBe("tomb");
+            const result = analyzeTwelveStages("甲未", "甲未", "甲未", "甲未");
+            expect(result.year.key).toBe("tomb");
         });
         it("should return longLife for 乙 at 午", () => {
-            expect(getTwelveStage("乙", "午")).toBe("longLife");
+            const result = analyzeTwelveStages("乙午", "乙午", "乙午", "乙午");
+            expect(result.year.key).toBe("longLife");
         });
         it("should return imperial for 乙 at 寅", () => {
-            expect(getTwelveStage("乙", "寅")).toBe("imperial");
+            const result = analyzeTwelveStages("乙寅", "乙寅", "乙寅", "乙寅");
+            expect(result.year.key).toBe("imperial");
         });
         it("should return longLife for 丙 at 寅", () => {
-            expect(getTwelveStage("丙", "寅")).toBe("longLife");
+            const result = analyzeTwelveStages("丙寅", "丙寅", "丙寅", "丙寅");
+            expect(result.year.key).toBe("longLife");
         });
         it("should return imperial for 丙 at 午", () => {
-            expect(getTwelveStage("丙", "午")).toBe("imperial");
+            const result = analyzeTwelveStages("丙午", "丙午", "丙午", "丙午");
+            expect(result.year.key).toBe("imperial");
         });
         it("should return longLife for 庚 at 巳", () => {
-            expect(getTwelveStage("庚", "巳")).toBe("longLife");
+            const result = analyzeTwelveStages("庚巳", "庚巳", "庚巳", "庚巳");
+            expect(result.year.key).toBe("longLife");
         });
         it("should return imperial for 庚 at 酉", () => {
-            expect(getTwelveStage("庚", "酉")).toBe("imperial");
+            const result = analyzeTwelveStages("庚酉", "庚酉", "庚酉", "庚酉");
+            expect(result.year.key).toBe("imperial");
         });
         it("should return longLife for 壬 at 申", () => {
-            expect(getTwelveStage("壬", "申")).toBe("longLife");
+            const result = analyzeTwelveStages("壬申", "壬申", "壬申", "壬申");
+            expect(result.year.key).toBe("longLife");
         });
         it("should return imperial for 壬 at 子", () => {
-            expect(getTwelveStage("壬", "子")).toBe("imperial");
-        });
-        it("should throw error for invalid stem", () => {
-            expect(() => getTwelveStage("X", "子")).toThrow("Invalid stem: X");
-        });
-        it("should throw error for invalid branch", () => {
-            expect(() => getTwelveStage("甲", "X")).toThrow("Invalid branch: X");
-        });
-    });
-    describe("analyzeTwelveStages", () => {
-        it("should analyze all four pillars", () => {
-            const result = analyzeTwelveStages("甲子", "丙寅", "戊辰", "庚午");
-            expect(result.year).toBeDefined();
-            expect(result.month).toBeDefined();
-            expect(result.day).toBeDefined();
-            expect(result.hour).toBeDefined();
-            expect(TWELVE_STAGES).toContain(result.year);
-            expect(TWELVE_STAGES).toContain(result.month);
-            expect(TWELVE_STAGES).toContain(result.day);
-            expect(TWELVE_STAGES).toContain(result.hour);
-        });
-        it("should correctly analyze 戊 day master", () => {
-            const result = analyzeTwelveStages("甲子", "丙寅", "戊辰", "庚午");
-            expect(result.month).toBe("longLife");
-            expect(result.hour).toBe("imperial");
+            const result = analyzeTwelveStages("壬子", "壬子", "壬子", "壬子");
+            expect(result.year.key).toBe("imperial");
         });
     });
-    describe("STAGE_INFO", () => {
+    describe("getTwelveStageLabel", () => {
         it("should have info for all twelve stages", () => {
             for (const stage of TWELVE_STAGES) {
-                expect(STAGE_INFO[stage]).toBeDefined();
-                expect(STAGE_INFO[stage].korean).toBeDefined();
-                expect(STAGE_INFO[stage].hanja).toBeDefined();
-                expect(STAGE_INFO[stage].meaning).toBeDefined();
-                expect(["strong", "neutral", "weak"]).toContain(STAGE_INFO[stage].strength);
+                const label = getTwelveStageLabel(stage);
+                expect(label.key).toBe(stage);
+                expect(label.korean).toBeDefined();
+                expect(label.hanja).toBeDefined();
+                expect(label.meaning).toBeDefined();
+                expect(["strong", "neutral", "weak"]).toContain(label.strength);
             }
         });
         it("should have correct korean names", () => {
-            expect(STAGE_INFO.longLife.korean).toBe("장생");
-            expect(STAGE_INFO.bathing.korean).toBe("목욕");
-            expect(STAGE_INFO.imperial.korean).toBe("제왕");
-            expect(STAGE_INFO.death.korean).toBe("사");
+            expect(getTwelveStageLabel("longLife").korean).toBe("장생");
+            expect(getTwelveStageLabel("bathing").korean).toBe("목욕");
+            expect(getTwelveStageLabel("imperial").korean).toBe("제왕");
+            expect(getTwelveStageLabel("death").korean).toBe("사");
         });
         it("should have correct strength classifications", () => {
-            expect(STAGE_INFO.longLife.strength).toBe("strong");
-            expect(STAGE_INFO.imperial.strength).toBe("strong");
-            expect(STAGE_INFO.decline.strength).toBe("weak");
-            expect(STAGE_INFO.tomb.strength).toBe("neutral");
+            expect(getTwelveStageLabel("longLife").strength).toBe("strong");
+            expect(getTwelveStageLabel("imperial").strength).toBe("strong");
+            expect(getTwelveStageLabel("decline").strength).toBe("weak");
+            expect(getTwelveStageLabel("tomb").strength).toBe("neutral");
         });
     });
 });

package/dist/__tests__/yongshen.test.js

@@ -11,7 +11,7 @@ describe("yongshen", () => {
         });
         it("identifies yongshen elements correctly", () => {
             const result = analyzeYongShen("甲子", "丙寅", "甲辰", "乙亥");
-            expect(result.allElements[result.primary].isYongShen).toBe(true);
+            expect(result.allElements[result.primary.key].isYongShen).toBe(true);
         });
         it("identifies kishen elements correctly", () => {
             const result = analyzeYongShen("甲子", "丙寅", "甲辰", "乙亥");
@@ -20,11 +20,11 @@ describe("yongshen", () => {
         });
         it("uses 억부 method for 중화 strength (조후 is adjustment, not primary)", () => {
             const result = analyzeYongShen("甲子", "丙寅", "庚申", "丁亥");
-            expect(["억부", "격국"]).toContain(result.method);
+            expect(["balance", "formation"]).toContain(result.method.key);
         });
         it("uses 억부 method for extreme strength", () => {
             const result = analyzeYongShen("甲寅", "甲寅", "甲寅", "甲寅");
-            expect(result.method).toBe("억부");
+            expect(result.method.key).toBe("balance");
         });
         it("includes johuAdjustment field in result", () => {
             const result = analyzeYongShen("甲子", "丙寅", "甲辰", "乙亥");

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

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

package/dist/core/luck.js

@@ -24,7 +24,8 @@ export function calculateMajorLuck(adapter, birthDateTime, gender, yearPillar, m
     const years = Math.floor(totalMonths / 12);
     const months = totalMonths % 12;
     const days = Math.round(((daysToTerm / 3) * 12 - totalMonths) * 30);
-    const startAge = years;
+    // 전통적으로 6개월 이상이면 반올림하여 1년 추가
+    const startAge = months >= 6 ? years + 1 : years;
     const startAgeDetail = { years, months, days: Math.abs(days) };
     const monthIdx60 = getPillarIndex(monthPillar);
     const pillars = [];