@gracefullight/saju 0.2.0 → 0.4.1

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

@@ -0,0 +1,119 @@
+import { describe, expect, it } from "vitest";
+import { analyzeTenGods, countElements, countTenGods, getBranchElement, getHiddenStems, getStemElement, getStemPolarity, getTenGod, } from "../core/ten-gods";
+describe("ten-gods", () => {
+    describe("getStemElement", () => {
+        it("returns correct element for each stem", () => {
+            expect(getStemElement("甲")).toBe("wood");
+            expect(getStemElement("乙")).toBe("wood");
+            expect(getStemElement("丙")).toBe("fire");
+            expect(getStemElement("丁")).toBe("fire");
+            expect(getStemElement("戊")).toBe("earth");
+            expect(getStemElement("己")).toBe("earth");
+            expect(getStemElement("庚")).toBe("metal");
+            expect(getStemElement("辛")).toBe("metal");
+            expect(getStemElement("壬")).toBe("water");
+            expect(getStemElement("癸")).toBe("water");
+        });
+    });
+    describe("getStemPolarity", () => {
+        it("returns correct polarity for each stem", () => {
+            expect(getStemPolarity("甲")).toBe("yang");
+            expect(getStemPolarity("乙")).toBe("yin");
+            expect(getStemPolarity("丙")).toBe("yang");
+            expect(getStemPolarity("丁")).toBe("yin");
+        });
+    });
+    describe("getBranchElement", () => {
+        it("returns correct element for each branch", () => {
+            expect(getBranchElement("子")).toBe("water");
+            expect(getBranchElement("丑")).toBe("earth");
+            expect(getBranchElement("寅")).toBe("wood");
+            expect(getBranchElement("卯")).toBe("wood");
+            expect(getBranchElement("午")).toBe("fire");
+            expect(getBranchElement("酉")).toBe("metal");
+        });
+    });
+    describe("getHiddenStems", () => {
+        it("returns correct hidden stems for each branch", () => {
+            expect(getHiddenStems("子")).toEqual(["癸"]);
+            expect(getHiddenStems("丑")).toEqual(["己", "癸", "辛"]);
+            expect(getHiddenStems("寅")).toEqual(["甲", "丙", "戊"]);
+            expect(getHiddenStems("卯")).toEqual(["乙"]);
+            expect(getHiddenStems("午")).toEqual(["丁", "己"]);
+        });
+    });
+    describe("getTenGod", () => {
+        it("correctly identifies 비견 (same element, same polarity)", () => {
+            expect(getTenGod("甲", "甲")).toBe("비견");
+            expect(getTenGod("乙", "乙")).toBe("비견");
+        });
+        it("correctly identifies 겁재 (same element, different polarity)", () => {
+            expect(getTenGod("甲", "乙")).toBe("겁재");
+            expect(getTenGod("乙", "甲")).toBe("겁재");
+        });
+        it("correctly identifies 식신 (I generate, same polarity)", () => {
+            expect(getTenGod("甲", "丙")).toBe("식신");
+            expect(getTenGod("丙", "戊")).toBe("식신");
+        });
+        it("correctly identifies 상관 (I generate, different polarity)", () => {
+            expect(getTenGod("甲", "丁")).toBe("상관");
+            expect(getTenGod("丙", "己")).toBe("상관");
+        });
+        it("correctly identifies 편재 (I control, same polarity)", () => {
+            expect(getTenGod("甲", "戊")).toBe("편재");
+            expect(getTenGod("丙", "庚")).toBe("편재");
+        });
+        it("correctly identifies 정재 (I control, different polarity)", () => {
+            expect(getTenGod("甲", "己")).toBe("정재");
+            expect(getTenGod("丙", "辛")).toBe("정재");
+        });
+        it("correctly identifies 편관 (controls me, same polarity)", () => {
+            expect(getTenGod("甲", "庚")).toBe("편관");
+            expect(getTenGod("丙", "壬")).toBe("편관");
+        });
+        it("correctly identifies 정관 (controls me, different polarity)", () => {
+            expect(getTenGod("甲", "辛")).toBe("정관");
+            expect(getTenGod("丙", "癸")).toBe("정관");
+        });
+        it("correctly identifies 편인 (generates me, same polarity)", () => {
+            expect(getTenGod("甲", "壬")).toBe("편인");
+            expect(getTenGod("丙", "甲")).toBe("편인");
+        });
+        it("correctly identifies 정인 (generates me, different polarity)", () => {
+            expect(getTenGod("甲", "癸")).toBe("정인");
+            expect(getTenGod("丙", "乙")).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("겁재");
+        });
+        it("includes hidden stems analysis", () => {
+            const result = analyzeTenGods("甲子", "丙寅", "甲辰", "乙亥");
+            expect(result.year.branch.hiddenStems).toHaveLength(1);
+            expect(result.year.branch.hiddenStems[0].stem).toBe("癸");
+            expect(result.month.branch.hiddenStems).toHaveLength(3);
+        });
+    });
+    describe("countTenGods", () => {
+        it("counts ten gods correctly", () => {
+            const analysis = analyzeTenGods("甲子", "丙寅", "甲辰", "乙亥");
+            const counts = countTenGods(analysis);
+            expect(counts.비견).toBeGreaterThanOrEqual(1);
+            expect(counts.식신).toBeGreaterThanOrEqual(1);
+        });
+    });
+    describe("countElements", () => {
+        it("counts elements correctly", () => {
+            const analysis = analyzeTenGods("甲子", "丙寅", "甲辰", "乙亥");
+            const counts = countElements(analysis);
+            expect(counts.wood).toBeGreaterThanOrEqual(3);
+            expect(counts.fire).toBeGreaterThanOrEqual(1);
+        });
+    });
+});

package/dist/__tests__/twelve-stages.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=twelve-stages.test.d.ts.map

package/dist/__tests__/twelve-stages.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twelve-stages.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/twelve-stages.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,86 @@
+import { describe, expect, it } from "vitest";
+import { analyzeTwelveStages, getTwelveStage, STAGE_INFO, TWELVE_STAGES, } from "../core/twelve-stages";
+describe("twelve-stages", () => {
+    describe("getTwelveStage", () => {
+        it("should return longLife for 甲 at 亥", () => {
+            expect(getTwelveStage("甲", "亥")).toBe("longLife");
+        });
+        it("should return imperial for 甲 at 卯", () => {
+            expect(getTwelveStage("甲", "卯")).toBe("imperial");
+        });
+        it("should return tomb for 甲 at 未", () => {
+            expect(getTwelveStage("甲", "未")).toBe("tomb");
+        });
+        it("should return longLife for 乙 at 午", () => {
+            expect(getTwelveStage("乙", "午")).toBe("longLife");
+        });
+        it("should return imperial for 乙 at 寅", () => {
+            expect(getTwelveStage("乙", "寅")).toBe("imperial");
+        });
+        it("should return longLife for 丙 at 寅", () => {
+            expect(getTwelveStage("丙", "寅")).toBe("longLife");
+        });
+        it("should return imperial for 丙 at 午", () => {
+            expect(getTwelveStage("丙", "午")).toBe("imperial");
+        });
+        it("should return longLife for 庚 at 巳", () => {
+            expect(getTwelveStage("庚", "巳")).toBe("longLife");
+        });
+        it("should return imperial for 庚 at 酉", () => {
+            expect(getTwelveStage("庚", "酉")).toBe("imperial");
+        });
+        it("should return longLife for 壬 at 申", () => {
+            expect(getTwelveStage("壬", "申")).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");
+        });
+    });
+    describe("STAGE_INFO", () => {
+        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);
+            }
+        });
+        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("사");
+        });
+        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");
+        });
+    });
+});

package/dist/__tests__/utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=utils.test.d.ts.map

package/dist/__tests__/utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/utils.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/utils.test.js

@@ -0,0 +1,130 @@
+import { describe, expect, it } from "vitest";
+import { BRANCHES, dayPillarIndexFromJdn, ELEMENTS, getBranchIndex, getPillarIndex, getStemIndex, isYangStem, isYinStem, jdnFromDate, pillarFromIndex, STEMS, } from "../utils";
+describe("constants", () => {
+    describe("STEMS", () => {
+        it("should have 10 stems", () => {
+            expect(STEMS).toHaveLength(10);
+        });
+        it("should start with 甲 and end with 癸", () => {
+            expect(STEMS[0]).toBe("甲");
+            expect(STEMS[9]).toBe("癸");
+        });
+    });
+    describe("BRANCHES", () => {
+        it("should have 12 branches", () => {
+            expect(BRANCHES).toHaveLength(12);
+        });
+        it("should start with 子 and end with 亥", () => {
+            expect(BRANCHES[0]).toBe("子");
+            expect(BRANCHES[11]).toBe("亥");
+        });
+    });
+    describe("ELEMENTS", () => {
+        it("should have 5 elements", () => {
+            expect(ELEMENTS).toHaveLength(5);
+        });
+        it("should contain wood, fire, earth, metal, water", () => {
+            expect(ELEMENTS).toContain("wood");
+            expect(ELEMENTS).toContain("fire");
+            expect(ELEMENTS).toContain("earth");
+            expect(ELEMENTS).toContain("metal");
+            expect(ELEMENTS).toContain("water");
+        });
+    });
+});
+describe("getStemIndex", () => {
+    it("should return correct index for each stem", () => {
+        expect(getStemIndex("甲")).toBe(0);
+        expect(getStemIndex("乙")).toBe(1);
+        expect(getStemIndex("癸")).toBe(9);
+    });
+    it("should return -1 for invalid stem", () => {
+        expect(getStemIndex("X")).toBe(-1);
+    });
+});
+describe("getBranchIndex", () => {
+    it("should return correct index for each branch", () => {
+        expect(getBranchIndex("子")).toBe(0);
+        expect(getBranchIndex("丑")).toBe(1);
+        expect(getBranchIndex("亥")).toBe(11);
+    });
+    it("should return -1 for invalid branch", () => {
+        expect(getBranchIndex("X")).toBe(-1);
+    });
+});
+describe("pillarFromIndex", () => {
+    it("should return 甲子 for index 0", () => {
+        expect(pillarFromIndex(0)).toBe("甲子");
+    });
+    it("should return 乙丑 for index 1", () => {
+        expect(pillarFromIndex(1)).toBe("乙丑");
+    });
+    it("should handle negative indices", () => {
+        expect(pillarFromIndex(-1)).toBe("癸亥");
+    });
+    it("should wrap around for indices >= 60", () => {
+        expect(pillarFromIndex(60)).toBe("甲子");
+        expect(pillarFromIndex(61)).toBe("乙丑");
+    });
+});
+describe("getPillarIndex", () => {
+    it("should return 0 for 甲子", () => {
+        expect(getPillarIndex("甲子")).toBe(0);
+    });
+    it("should return correct index for 乙丑", () => {
+        expect(getPillarIndex("乙丑")).toBe(1);
+    });
+    it("should be inverse of pillarFromIndex", () => {
+        for (let i = 0; i < 60; i++) {
+            const pillar = pillarFromIndex(i);
+            expect(getPillarIndex(pillar)).toBe(i);
+        }
+    });
+});
+describe("jdnFromDate", () => {
+    it("should return correct JDN for known date", () => {
+        expect(jdnFromDate(2000, 1, 1)).toBe(2451545);
+    });
+    it("should return correct JDN for epoch date", () => {
+        expect(jdnFromDate(1970, 1, 1)).toBe(2440588);
+    });
+});
+describe("dayPillarIndexFromJdn", () => {
+    it("should return value between 0 and 59", () => {
+        const idx = dayPillarIndexFromJdn(2451545);
+        expect(idx).toBeGreaterThanOrEqual(0);
+        expect(idx).toBeLessThan(60);
+    });
+});
+describe("isYangStem", () => {
+    it("should return true for yang stems", () => {
+        expect(isYangStem("甲")).toBe(true);
+        expect(isYangStem("丙")).toBe(true);
+        expect(isYangStem("戊")).toBe(true);
+        expect(isYangStem("庚")).toBe(true);
+        expect(isYangStem("壬")).toBe(true);
+    });
+    it("should return false for yin stems", () => {
+        expect(isYangStem("乙")).toBe(false);
+        expect(isYangStem("丁")).toBe(false);
+        expect(isYangStem("己")).toBe(false);
+        expect(isYangStem("辛")).toBe(false);
+        expect(isYangStem("癸")).toBe(false);
+    });
+});
+describe("isYinStem", () => {
+    it("should return true for yin stems", () => {
+        expect(isYinStem("乙")).toBe(true);
+        expect(isYinStem("丁")).toBe(true);
+        expect(isYinStem("己")).toBe(true);
+        expect(isYinStem("辛")).toBe(true);
+        expect(isYinStem("癸")).toBe(true);
+    });
+    it("should return false for yang stems", () => {
+        expect(isYinStem("甲")).toBe(false);
+        expect(isYinStem("丙")).toBe(false);
+        expect(isYinStem("戊")).toBe(false);
+        expect(isYinStem("庚")).toBe(false);
+        expect(isYinStem("壬")).toBe(false);
+    });
+});

package/dist/__tests__/yongshen.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=yongshen.test.d.ts.map

package/dist/__tests__/yongshen.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yongshen.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/yongshen.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/yongshen.test.js

@@ -0,0 +1,62 @@
+import { describe, expect, it } from "vitest";
+import { analyzeYongShen, getElementRecommendations } from "../core/yongshen";
+describe("yongshen", () => {
+    describe("analyzeYongShen", () => {
+        it("returns yongshen analysis result", () => {
+            const result = analyzeYongShen("甲子", "丙寅", "甲辰", "乙亥");
+            expect(result.primary).toBeDefined();
+            expect(result.method).toBeDefined();
+            expect(result.reasoning).toBeDefined();
+            expect(result.allElements).toBeDefined();
+        });
+        it("identifies yongshen elements correctly", () => {
+            const result = analyzeYongShen("甲子", "丙寅", "甲辰", "乙亥");
+            expect(result.allElements[result.primary].isYongShen).toBe(true);
+        });
+        it("identifies kishen elements correctly", () => {
+            const result = analyzeYongShen("甲子", "丙寅", "甲辰", "乙亥");
+            const hasKiShen = Object.values(result.allElements).some((e) => e.isKiShen);
+            expect(hasKiShen).toBe(true);
+        });
+        it("uses 억부 method for 중화 strength (조후 is adjustment, not primary)", () => {
+            const result = analyzeYongShen("甲子", "丙寅", "庚申", "丁亥");
+            expect(["억부", "격국"]).toContain(result.method);
+        });
+        it("uses 억부 method for extreme strength", () => {
+            const result = analyzeYongShen("甲寅", "甲寅", "甲寅", "甲寅");
+            expect(result.method).toBe("억부");
+        });
+        it("includes johuAdjustment field in result", () => {
+            const result = analyzeYongShen("甲子", "丙寅", "甲辰", "乙亥");
+            expect("johuAdjustment" in result).toBe(true);
+        });
+        it("includes reasoning in result", () => {
+            const result = analyzeYongShen("甲子", "丙寅", "甲辰", "乙亥");
+            expect(result.reasoning.length).toBeGreaterThan(0);
+        });
+    });
+    describe("getElementRecommendations", () => {
+        it("returns colors for yongshen element", () => {
+            const yongShen = analyzeYongShen("甲子", "丙寅", "甲辰", "乙亥");
+            const recommendations = getElementRecommendations(yongShen);
+            expect(recommendations.colors.length).toBeGreaterThan(0);
+        });
+        it("returns directions for yongshen element", () => {
+            const yongShen = analyzeYongShen("甲子", "丙寅", "甲辰", "乙亥");
+            const recommendations = getElementRecommendations(yongShen);
+            expect(recommendations.directions.length).toBeGreaterThan(0);
+        });
+        it("returns numbers for yongshen element", () => {
+            const yongShen = analyzeYongShen("甲子", "丙寅", "甲辰", "乙亥");
+            const recommendations = getElementRecommendations(yongShen);
+            expect(recommendations.numbers.length).toBeGreaterThan(0);
+        });
+        it("includes secondary element recommendations when present", () => {
+            const yongShen = analyzeYongShen("甲子", "丙寅", "甲辰", "乙亥");
+            if (yongShen.secondary) {
+                const recommendations = getElementRecommendations(yongShen);
+                expect(recommendations.colors.length).toBeGreaterThan(2);
+            }
+        });
+    });
+});

package/dist/adapters/date-fns.d.ts

@@ -1,4 +1,4 @@
-import type { DateAdapter } from "@/adapters/date-adapter";
+import type { DateAdapter } from "../adapters/date-adapter";
 interface DateFnsDate {
     date: Date;
     timeZone: string;

package/dist/adapters/luxon.d.ts

@@ -1,3 +1,3 @@
-import type { DateAdapter } from "@/adapters/date-adapter";
+import type { DateAdapter } from "../adapters/date-adapter";
 export declare function createLuxonAdapter(): Promise<DateAdapter<import("luxon").DateTime>>;
 //# sourceMappingURL=luxon.d.ts.map

package/dist/core/four-pillars.d.ts

@@ -1,7 +1,7 @@
-import type { DateAdapter } from "@/adapters/date-adapter";
-import { type LunarDate } from "@/core/lunar";
-export declare const STEMS: string[];
-export declare const BRANCHES: string[];
+import type { DateAdapter } from "../adapters/date-adapter";
+import { type LunarDate } from "../core/lunar";
+import { BRANCHES, STEMS } from "../utils";
+export { STEMS, BRANCHES };
 export declare const STANDARD_PRESET: {
     dayBoundary: "midnight";
     useMeanSolarTimeForHour: boolean;
@@ -65,8 +65,8 @@ export declare function hourPillar<T>(adapter: DateAdapter<T>, dtLocal: T, { lon
         day: number;
     };
 };
-export declare function getFourPillars<T>(adapter: DateAdapter<T>, dtLocal: T, { longitudeDeg, tzOffsetHours, preset, }: {
-    longitudeDeg: number;
+export declare function getFourPillars<T>(adapter: DateAdapter<T>, dtLocal: T, { longitudeDeg, tzOffsetHours, preset, }?: {
+    longitudeDeg?: number;
     tzOffsetHours?: number;
     preset?: typeof presetA | typeof presetB;
 }): {

package/dist/core/four-pillars.d.ts.map

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

package/dist/core/four-pillars.js

@@ -1,9 +1,9 @@
-import { getLunarDate } from "@/core/lunar";
-export const STEMS = ["甲", "乙", "丙", "丁", "戊", "己", "庚", "辛", "壬", "癸"];
-export const BRANCHES = ["子", "丑", "寅", "卯", "辰", "巳", "午", "未", "申", "酉", "戌", "亥"];
+import { getLunarDate } from "../core/lunar";
+import { BRANCHES, jdnFromDate, pillarFromIndex, STEMS } from "../utils";
+export { STEMS, BRANCHES };
 export const STANDARD_PRESET = {
     dayBoundary: "midnight",
-    useMeanSolarTimeForHour: false,
+    useMeanSolarTimeForHour: true,
     useMeanSolarTimeForBoundary: false,
 };
 export const TRADITIONAL_PRESET = {
@@ -17,25 +17,10 @@ function normDeg(x) {
     x %= 360;
     return x < 0 ? x + 360 : x;
 }
-function pillarFrom60(idx60) {
-    return STEMS[idx60 % 10] + BRANCHES[idx60 % 12];
-}
-function jdnFromDate(y, m, d) {
-    const a = Math.floor((14 - m) / 12);
-    const y2 = y + 4800 - a;
-    const m2 = m + 12 * a - 3;
-    return (d +
-        Math.floor((153 * m2 + 2) / 5) +
-        365 * y2 +
-        Math.floor(y2 / 4) -
-        Math.floor(y2 / 100) +
-        Math.floor(y2 / 400) -
-        32045);
-}
 export function dayPillarFromDate({ year, month, day, }) {
     const jdn = jdnFromDate(year, month, day);
     const idx60 = (((jdn - 11) % 60) + 60) % 60;
-    return { idx60, pillar: pillarFrom60(idx60) };
+    return { idx60, pillar: pillarFromIndex(idx60) };
 }
 export function applyMeanSolarTime(adapter, dtLocal, longitudeDeg, tzOffsetHours = 9) {
     const deltaMinutes = 4 * (longitudeDeg - 15 * tzOffsetHours);
@@ -111,7 +96,7 @@ export function yearPillar(adapter, dtLocal) {
     const lichunLocal = adapter.setZone(lichunUtc(adapter, y), adapter.getZoneName(dtLocal));
     const solarYear = adapter.isGreaterThanOrEqual(dtLocal, lichunLocal) ? y : y - 1;
     const idx60 = (((solarYear - 1984) % 60) + 60) % 60;
-    return { idx60, pillar: pillarFrom60(idx60), solarYear };
+    return { idx60, pillar: pillarFromIndex(idx60), solarYear };
 }
 function monthBranchIndexFromSunLon(lon) {
     return (Math.floor(((lon + 45) % 360) / 30) + 2) % 12;
@@ -184,9 +169,8 @@ export function hourPillar(adapter, dtLocal, { longitudeDeg, tzOffsetHours = 9,
     const hs = (dayStemIdx * 2 + hb) % 10;
     return { pillar: STEMS[hs] + BRANCHES[hb], adjustedDt: dtUsed, effectiveDate: effDate };
 }
-export function getFourPillars(adapter, dtLocal, { longitudeDeg, tzOffsetHours = 9, preset = presetA, }) {
-    if (typeof longitudeDeg !== "number")
-        throw new Error("longitudeDeg is required");
+export function getFourPillars(adapter, dtLocal, { longitudeDeg, tzOffsetHours = 9, preset = presetA, } = {}) {
+    const effectiveLongitude = longitudeDeg ?? tzOffsetHours * 15;
     const dayBoundary = preset.dayBoundary ?? "midnight";
     const useMeanSolarTimeForHour = preset.useMeanSolarTimeForHour ?? false;
     const useMeanSolarTimeForBoundary = preset.useMeanSolarTimeForBoundary ?? false;
@@ -194,13 +178,13 @@ export function getFourPillars(adapter, dtLocal, { longitudeDeg, tzOffsetHours =
     const m = monthPillar(adapter, dtLocal);
     const effDate = effectiveDayDate(adapter, dtLocal, {
         dayBoundary,
-        longitudeDeg,
+        longitudeDeg: effectiveLongitude,
         tzOffsetHours,
         useMeanSolarTimeForBoundary,
     });
     const d = dayPillarFromDate(effDate);
     const h = hourPillar(adapter, dtLocal, {
-        longitudeDeg,
+        longitudeDeg: effectiveLongitude,
         tzOffsetHours,
         useMeanSolarTimeForHour,
         dayBoundary,

package/dist/core/luck.d.ts

@@ -0,0 +1,60 @@
+import type { DateAdapter } from "../adapters/date-adapter";
+import type { Gender, Polarity } from "../types";
+export type { Gender };
+export interface LuckPillar {
+    index: number;
+    startAge: number;
+    endAge: number;
+    stem: string;
+    branch: string;
+    pillar: string;
+}
+export interface StartAgeDetail {
+    years: number;
+    months: number;
+    days: number;
+}
+export interface MajorLuckResult {
+    gender: Gender;
+    yearStemPolarity: Polarity;
+    isForward: boolean;
+    startAge: number;
+    startAgeDetail: StartAgeDetail;
+    daysToTerm: number;
+    pillars: LuckPillar[];
+}
+export declare function calculateMajorLuck<T>(adapter: DateAdapter<T>, birthDateTime: T, gender: Gender, yearPillar: string, monthPillar: string, options?: {
+    count?: number;
+    nextJieMillis?: number;
+    prevJieMillis?: number;
+}): MajorLuckResult;
+export interface YearlyLuckResult {
+    year: number;
+    stem: string;
+    branch: string;
+    pillar: string;
+    age: number;
+}
+export declare function calculateYearlyLuck(birthYear: number, fromYear: number, toYear: number): YearlyLuckResult[];
+export declare function getYearPillar(year: number): string;
+export declare function getCurrentMajorLuck(majorLuck: MajorLuckResult, age: number): LuckPillar | null;
+export interface MonthlyLuckResult {
+    year: number;
+    month: number;
+    stem: string;
+    branch: string;
+    pillar: string;
+}
+export declare function calculateMonthlyLuck(year: number, fromMonth: number, toMonth: number): MonthlyLuckResult[];
+export interface DailyLuckResult {
+    year: number;
+    month: number;
+    day: number;
+    stem: string;
+    branch: string;
+    pillar: string;
+}
+export declare function calculateDailyLuck(year: number, month: number, fromDay: number, toDay: number): DailyLuckResult[];
+export declare function getDayPillar(year: number, month: number, day: number): string;
+export declare function getMonthPillar(year: number, month: number): string;
+//# sourceMappingURL=luck.d.ts.map

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

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