@gracefullight/saju 0.1.1 → 0.3.0

package/dist/__tests__/yongshen.test.js

@@ -0,0 +1,62 @@
+import { describe, it, expect } 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/core/four-pillars.d.ts

@@ -1,4 +1,5 @@
 import type { DateAdapter } from "@/adapters/date-adapter";
+import { type LunarDate } from "@/core/lunar";
 export declare const STEMS: string[];
 export declare const BRANCHES: string[];
 export declare const STANDARD_PRESET: {
@@ -73,6 +74,7 @@ export declare function getFourPillars<T>(adapter: DateAdapter<T>, dtLocal: T, {
     month: string;
     day: string;
     hour: string;
+    lunar: LunarDate;
     meta: {
         solarYearUsed: number;
         sunLonDeg: number;

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,3 +1,4 @@
+import { getLunarDate } from "@/core/lunar";
 export const STEMS = ["甲", "乙", "丙", "丁", "戊", "己", "庚", "辛", "壬", "癸"];
 export const BRANCHES = ["子", "丑", "寅", "卯", "辰", "巳", "午", "未", "申", "酉", "戌", "亥"];
 export const STANDARD_PRESET = {
@@ -33,7 +34,7 @@ function jdnFromDate(y, m, d) {
 }
 export function dayPillarFromDate({ year, month, day, }) {
     const jdn = jdnFromDate(year, month, day);
-    const idx60 = (jdn + 12) % 60;
+    const idx60 = (((jdn - 11) % 60) + 60) % 60;
     return { idx60, pillar: pillarFrom60(idx60) };
 }
 export function applyMeanSolarTime(adapter, dtLocal, longitudeDeg, tzOffsetHours = 9) {
@@ -160,9 +161,9 @@ function hourBranchIndexFromHour(h) {
     // Traditional Chinese hours (時辰) mapping:
     // Each branch represents a 2-hour period, starting from 子時 at 23:00
     // 子時 (0): 23:00-01:00, 丑時 (1): 01:00-03:00, ..., 亥時 (11): 21:00-23:00
-    // Formula: (hour + 1) / 2 gives the branch index, but we need +1 offset
-    // because 23:00 (hour 23) should map to index 0 (子), wrapping around
-    return Math.floor((h + 1) / 2 + 1) % 12;
+    // Formula: floor((hour + 1) / 2) % 12
+    // Examples: 0->0(子), 1->1(丑), 3->2(寅), 23->0(子)
+    return Math.floor((h + 1) / 2) % 12;
 }
 export function hourPillar(adapter, dtLocal, { longitudeDeg, tzOffsetHours = 9, useMeanSolarTimeForHour = false, dayBoundary = "midnight", useMeanSolarTimeForBoundary = false, } = {}) {
     let dtUsed = dtLocal;
@@ -205,11 +206,13 @@ export function getFourPillars(adapter, dtLocal, { longitudeDeg, tzOffsetHours =
         dayBoundary,
         useMeanSolarTimeForBoundary,
     });
+    const lunar = getLunarDate(effDate.year, effDate.month, effDate.day);
     return {
         year: y.pillar,
         month: m.pillar,
         day: d.pillar,
         hour: h.pillar,
+        lunar,
         meta: {
             solarYearUsed: y.solarYear,
             sunLonDeg: m.sunLonDeg,

package/dist/core/luck.d.ts

@@ -0,0 +1,41 @@
+import type { DateAdapter } from "@/adapters/date-adapter";
+import { type Polarity } from "./ten-gods";
+export type Gender = "male" | "female";
+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;
+//# 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":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvC,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,QAAQ,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAqBD,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,aAAa,EAAE,CAAC,EAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACnB,GACL,eAAe,CA2DjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,gBAAgB,EAAE,CAkBpB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAO9F"}

package/dist/core/luck.js

@@ -0,0 +1,96 @@
+import { STEMS, BRANCHES } from "./four-pillars";
+import { getStemPolarity } from "./ten-gods";
+function getMonthPillarIndex(monthPillar) {
+    const stem = monthPillar[0];
+    const branch = monthPillar[1];
+    const stemIdx = STEMS.indexOf(stem);
+    const branchIdx = BRANCHES.indexOf(branch);
+    for (let i = 0; i < 60; i++) {
+        if (i % 10 === stemIdx && i % 12 === branchIdx) {
+            return i;
+        }
+    }
+    return 0;
+}
+function pillarFromIndex(idx60) {
+    const normalized = ((idx60 % 60) + 60) % 60;
+    return STEMS[normalized % 10] + BRANCHES[normalized % 12];
+}
+export function calculateMajorLuck(adapter, birthDateTime, gender, yearPillar, monthPillar, options = {}) {
+    const { count = 8 } = options;
+    const yearStem = yearPillar[0];
+    const yearStemPolarity = getStemPolarity(yearStem);
+    const isForward = (yearStemPolarity === "yang" && gender === "male") ||
+        (yearStemPolarity === "yin" && gender === "female");
+    const birthMillis = adapter.toMillis(birthDateTime);
+    const msPerDay = 1000 * 60 * 60 * 24;
+    let daysToTerm;
+    if (options.nextJieMillis !== undefined && options.prevJieMillis !== undefined) {
+        if (isForward) {
+            daysToTerm = Math.abs(options.nextJieMillis - birthMillis) / msPerDay;
+        }
+        else {
+            daysToTerm = Math.abs(birthMillis - options.prevJieMillis) / msPerDay;
+        }
+    }
+    else {
+        daysToTerm = 30;
+    }
+    const totalMonths = Math.round((daysToTerm / 3) * 12);
+    const years = Math.floor(totalMonths / 12);
+    const months = totalMonths % 12;
+    const days = Math.round(((daysToTerm / 3) * 12 - totalMonths) * 30);
+    const startAge = years;
+    const startAgeDetail = { years, months, days: Math.abs(days) };
+    const monthIdx60 = getMonthPillarIndex(monthPillar);
+    const pillars = [];
+    for (let i = 1; i <= count; i++) {
+        const pillarIdx = isForward ? monthIdx60 + i : monthIdx60 - i;
+        const pillar = pillarFromIndex(pillarIdx);
+        pillars.push({
+            index: i,
+            startAge: startAge + (i - 1) * 10,
+            endAge: startAge + i * 10 - 1,
+            stem: pillar[0],
+            branch: pillar[1],
+            pillar,
+        });
+    }
+    return {
+        gender,
+        yearStemPolarity,
+        isForward,
+        startAge,
+        startAgeDetail,
+        daysToTerm: Math.round(daysToTerm * 10) / 10,
+        pillars,
+    };
+}
+export function calculateYearlyLuck(birthYear, fromYear, toYear) {
+    const results = [];
+    for (let year = fromYear; year <= toYear; year++) {
+        const idx60 = (((year - 1984) % 60) + 60) % 60;
+        const pillar = pillarFromIndex(idx60);
+        const age = year - birthYear + 1;
+        results.push({
+            year,
+            stem: pillar[0],
+            branch: pillar[1],
+            pillar,
+            age,
+        });
+    }
+    return results;
+}
+export function getYearPillar(year) {
+    const idx60 = (((year - 1984) % 60) + 60) % 60;
+    return pillarFromIndex(idx60);
+}
+export function getCurrentMajorLuck(majorLuck, age) {
+    for (const pillar of majorLuck.pillars) {
+        if (age >= pillar.startAge && age <= pillar.endAge) {
+            return pillar;
+        }
+    }
+    return null;
+}

package/dist/core/lunar.d.ts

@@ -0,0 +1,13 @@
+export interface LunarDate {
+    lunarYear: number;
+    lunarMonth: number;
+    lunarDay: number;
+    isLeapMonth: boolean;
+}
+export declare function getLunarDate(year: number, month: number, day: number): LunarDate;
+export declare function getSolarDate(lunarYear: number, lunarMonth: number, lunarDay: number, isLeapMonth?: boolean): {
+    year: number;
+    month: number;
+    day: number;
+};
+//# sourceMappingURL=lunar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lunar.d.ts","sourceRoot":"","sources":["../../src/core/lunar.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAYhF;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,UAAQ,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAW9C"}

package/dist/core/lunar.js

@@ -0,0 +1,24 @@
+import { Lunar, Solar } from "lunar-javascript";
+export function getLunarDate(year, month, day) {
+    const solar = Solar.fromYmd(year, month, day);
+    const lunar = solar.getLunar();
+    const rawMonth = lunar.getMonth();
+    const isLeapMonth = rawMonth < 0;
+    return {
+        lunarYear: lunar.getYear(),
+        lunarMonth: isLeapMonth ? Math.abs(rawMonth) : rawMonth,
+        lunarDay: lunar.getDay(),
+        isLeapMonth,
+    };
+}
+export function getSolarDate(lunarYear, lunarMonth, lunarDay, isLeapMonth = false) {
+    // lunar-javascript uses negative month for leap months
+    const month = isLeapMonth ? -lunarMonth : lunarMonth;
+    const lunar = Lunar.fromYmd(lunarYear, month, lunarDay);
+    const solar = lunar.getSolar();
+    return {
+        year: solar.getYear(),
+        month: solar.getMonth(),
+        day: solar.getDay(),
+    };
+}

package/dist/core/relations.d.ts

@@ -0,0 +1,94 @@
+import type { Element } from "./ten-gods";
+export type TransformationStatus = "합" | "반합" | "화" | "불화";
+export type StemCombinationResult = {
+    stems: [string, string];
+    resultElement: Element;
+};
+export declare const STEM_COMBINATIONS: StemCombinationResult[];
+export type BranchCombinationResult = {
+    branches: [string, string];
+    resultElement: Element;
+};
+export declare const BRANCH_SIX_COMBINATIONS: BranchCombinationResult[];
+export type TripleCombinationResult = {
+    branches: [string, string, string];
+    resultElement: Element;
+};
+export declare const BRANCH_TRIPLE_COMBINATIONS: TripleCombinationResult[];
+export declare const BRANCH_DIRECTIONAL_COMBINATIONS: TripleCombinationResult[];
+export declare const BRANCH_CLASHES: [string, string][];
+export declare const BRANCH_HARMS: [string, string][];
+export declare const BRANCH_PUNISHMENTS: {
+    branches: string[];
+    type: string;
+}[];
+export declare const BRANCH_DESTRUCTIONS: [string, string][];
+export interface StemCombination {
+    type: "천간합";
+    pair: [string, string];
+    positions: [string, string];
+    resultElement: Element;
+    transformStatus: TransformationStatus;
+    transformReason: string;
+}
+export interface BranchSixCombination {
+    type: "육합";
+    pair: [string, string];
+    positions: [string, string];
+    resultElement: Element;
+    transformStatus: TransformationStatus;
+    transformReason: string;
+}
+export interface BranchTripleCombination {
+    type: "삼합";
+    branches: string[];
+    positions: string[];
+    resultElement: Element;
+    isComplete: boolean;
+    transformStatus: TransformationStatus;
+    transformReason: string;
+}
+export interface BranchDirectionalCombination {
+    type: "방합";
+    branches: string[];
+    positions: string[];
+    resultElement: Element;
+    isComplete: boolean;
+    transformStatus: TransformationStatus;
+    transformReason: string;
+}
+export interface BranchClash {
+    type: "충";
+    pair: [string, string];
+    positions: [string, string];
+}
+export interface BranchHarm {
+    type: "해";
+    pair: [string, string];
+    positions: [string, string];
+}
+export interface BranchPunishment {
+    type: "형";
+    branches: string[];
+    positions: string[];
+    punishmentType: string;
+}
+export interface BranchDestruction {
+    type: "파";
+    pair: [string, string];
+    positions: [string, string];
+}
+export type Relation = StemCombination | BranchSixCombination | BranchTripleCombination | BranchDirectionalCombination | BranchClash | BranchHarm | BranchPunishment | BranchDestruction;
+export interface RelationsResult {
+    combinations: (StemCombination | BranchSixCombination | BranchTripleCombination | BranchDirectionalCombination)[];
+    clashes: BranchClash[];
+    harms: BranchHarm[];
+    punishments: BranchPunishment[];
+    destructions: BranchDestruction[];
+    all: Relation[];
+}
+export declare function analyzeRelations(yearPillar: string, monthPillar: string, dayPillar: string, hourPillar: string): RelationsResult;
+export declare function findStemCombination(stem1: string, stem2: string): StemCombinationResult | null;
+export declare function findBranchClash(branch1: string, branch2: string): boolean;
+export declare function findBranchSixCombination(branch1: string, branch2: string): BranchCombinationResult | null;
+//# sourceMappingURL=relations.d.ts.map

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

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