@gracefullight/saju 0.2.0 → 0.4.1

package/dist/core/sinsals.js

@@ -0,0 +1,339 @@
+export const SINSALS = [
+    "peachBlossom",
+    "skyHorse",
+    "floweryCanopy",
+    "ghostGate",
+    "solitaryStar",
+    "widowStar",
+    "heavenlyVirtue",
+    "monthlyVirtue",
+    "skyNoble",
+    "moonNoble",
+    "literaryNoble",
+    "academicHall",
+    "bloodKnife",
+    "sixHarms",
+    "whiteCloth",
+    "heavenlyDoctor",
+];
+const PEACH_BLOSSOM_MAP = {
+    寅: "卯",
+    午: "卯",
+    戌: "卯",
+    申: "酉",
+    子: "酉",
+    辰: "酉",
+    巳: "午",
+    酉: "午",
+    丑: "午",
+    亥: "子",
+    卯: "子",
+    未: "子",
+};
+const SKY_HORSE_MAP = {
+    寅: "申",
+    午: "申",
+    戌: "申",
+    申: "寅",
+    子: "寅",
+    辰: "寅",
+    巳: "亥",
+    酉: "亥",
+    丑: "亥",
+    亥: "巳",
+    卯: "巳",
+    未: "巳",
+};
+const FLOWERY_CANOPY_MAP = {
+    寅: "戌",
+    午: "戌",
+    戌: "戌",
+    申: "辰",
+    子: "辰",
+    辰: "辰",
+    巳: "丑",
+    酉: "丑",
+    丑: "丑",
+    亥: "未",
+    卯: "未",
+    未: "未",
+};
+const GHOST_GATE_MAP = {
+    子: "卯",
+    丑: "寅",
+    寅: "丑",
+    卯: "子",
+    辰: "亥",
+    巳: "戌",
+    午: "酉",
+    未: "申",
+    申: "未",
+    酉: "午",
+    戌: "巳",
+    亥: "辰",
+};
+const SOLITARY_STAR_MAP = {
+    子: "寅",
+    丑: "寅",
+    寅: "巳",
+    卯: "巳",
+    辰: "巳",
+    巳: "申",
+    午: "申",
+    未: "申",
+    申: "亥",
+    酉: "亥",
+    戌: "亥",
+    亥: "寅",
+};
+const WIDOW_STAR_MAP = {
+    子: "戌",
+    丑: "戌",
+    寅: "丑",
+    卯: "丑",
+    辰: "丑",
+    巳: "辰",
+    午: "辰",
+    未: "辰",
+    申: "未",
+    酉: "未",
+    戌: "未",
+    亥: "戌",
+};
+const HEAVENLY_VIRTUE_MAP = {
+    寅: "丁",
+    卯: "申",
+    辰: "壬",
+    巳: "辛",
+    午: "亥",
+    未: "甲",
+    申: "癸",
+    酉: "寅",
+    戌: "丙",
+    亥: "乙",
+    子: "巳",
+    丑: "庚",
+};
+const MONTHLY_VIRTUE_MAP = {
+    寅: "丙",
+    卯: "甲",
+    辰: "壬",
+    巳: "庚",
+    午: "丙",
+    未: "甲",
+    申: "壬",
+    酉: "庚",
+    戌: "丙",
+    亥: "甲",
+    子: "壬",
+    丑: "庚",
+};
+const SKY_NOBLE_MAP = {
+    甲: ["丑", "未"],
+    戊: ["丑", "未"],
+    庚: ["丑", "未"],
+    乙: ["子", "申"],
+    己: ["子", "申"],
+    丙: ["亥", "酉"],
+    丁: ["亥", "酉"],
+    壬: ["卯", "巳"],
+    癸: ["卯", "巳"],
+    辛: ["午", "寅"],
+};
+const LITERARY_NOBLE_MAP = {
+    甲: "巳",
+    乙: "午",
+    丙: "申",
+    丁: "酉",
+    戊: "申",
+    己: "酉",
+    庚: "亥",
+    辛: "子",
+    壬: "寅",
+    癸: "卯",
+};
+const ACADEMIC_HALL_MAP = {
+    甲: "亥",
+    乙: "子",
+    丙: "寅",
+    丁: "卯",
+    戊: "寅",
+    己: "卯",
+    庚: "巳",
+    辛: "午",
+    壬: "申",
+    癸: "酉",
+};
+const BLOOD_KNIFE_MAP = {
+    子: "酉",
+    丑: "戌",
+    寅: "亥",
+    卯: "子",
+    辰: "丑",
+    巳: "寅",
+    午: "卯",
+    未: "辰",
+    申: "巳",
+    酉: "午",
+    戌: "未",
+    亥: "申",
+};
+const HEAVENLY_DOCTOR_MAP = {
+    子: "亥",
+    丑: "子",
+    寅: "丑",
+    卯: "寅",
+    辰: "卯",
+    巳: "辰",
+    午: "巳",
+    未: "午",
+    申: "未",
+    酉: "申",
+    戌: "酉",
+    亥: "戌",
+};
+function checkBranchBasedSinsal(baseBranch, targetBranches, positions, map, sinsal) {
+    const matches = [];
+    const targetSinsal = map[baseBranch];
+    if (targetSinsal) {
+        targetBranches.forEach((branch, idx) => {
+            if (branch === targetSinsal) {
+                matches.push({ sinsal, position: positions[idx] });
+            }
+        });
+    }
+    return matches;
+}
+function checkStemBasedSinsal(baseStem, targetBranches, positions, map, sinsal) {
+    const matches = [];
+    const targetSinsal = map[baseStem];
+    if (targetSinsal) {
+        const targets = Array.isArray(targetSinsal) ? targetSinsal : [targetSinsal];
+        targetBranches.forEach((branch, idx) => {
+            if (targets.includes(branch)) {
+                matches.push({ sinsal, position: positions[idx] });
+            }
+        });
+    }
+    return matches;
+}
+export function analyzeSinsals(yearPillar, monthPillar, dayPillar, hourPillar) {
+    const yearBranch = yearPillar[1];
+    const monthBranch = monthPillar[1];
+    const dayBranch = dayPillar[1];
+    const hourBranch = hourPillar[1];
+    const dayStem = dayPillar[0];
+    const yearStem = yearPillar[0];
+    const allBranches = [yearBranch, monthBranch, dayBranch, hourBranch];
+    const positions = ["year", "month", "day", "hour"];
+    const matches = [];
+    matches.push(...checkBranchBasedSinsal(yearBranch, allBranches, positions, PEACH_BLOSSOM_MAP, "peachBlossom"));
+    matches.push(...checkBranchBasedSinsal(dayBranch, allBranches, positions, PEACH_BLOSSOM_MAP, "peachBlossom"));
+    matches.push(...checkBranchBasedSinsal(yearBranch, allBranches, positions, SKY_HORSE_MAP, "skyHorse"));
+    matches.push(...checkBranchBasedSinsal(dayBranch, allBranches, positions, SKY_HORSE_MAP, "skyHorse"));
+    matches.push(...checkBranchBasedSinsal(yearBranch, allBranches, positions, FLOWERY_CANOPY_MAP, "floweryCanopy"));
+    matches.push(...checkBranchBasedSinsal(dayBranch, allBranches, positions, FLOWERY_CANOPY_MAP, "floweryCanopy"));
+    matches.push(...checkBranchBasedSinsal(dayBranch, allBranches, positions, GHOST_GATE_MAP, "ghostGate"));
+    matches.push(...checkBranchBasedSinsal(yearBranch, allBranches, positions, SOLITARY_STAR_MAP, "solitaryStar"));
+    matches.push(...checkBranchBasedSinsal(yearBranch, allBranches, positions, WIDOW_STAR_MAP, "widowStar"));
+    matches.push(...checkBranchBasedSinsal(monthBranch, [yearPillar[0], monthPillar[0], dayPillar[0], hourPillar[0]].map((s) => s), positions, HEAVENLY_VIRTUE_MAP, "heavenlyVirtue"));
+    matches.push(...checkBranchBasedSinsal(monthBranch, [yearPillar[0], monthPillar[0], dayPillar[0], hourPillar[0]].map((s) => s), positions, MONTHLY_VIRTUE_MAP, "monthlyVirtue"));
+    matches.push(...checkStemBasedSinsal(dayStem, allBranches, positions, SKY_NOBLE_MAP, "skyNoble"));
+    matches.push(...checkStemBasedSinsal(yearStem, allBranches, positions, SKY_NOBLE_MAP, "moonNoble"));
+    matches.push(...checkStemBasedSinsal(dayStem, allBranches, positions, LITERARY_NOBLE_MAP, "literaryNoble"));
+    matches.push(...checkStemBasedSinsal(dayStem, allBranches, positions, ACADEMIC_HALL_MAP, "academicHall"));
+    matches.push(...checkBranchBasedSinsal(dayBranch, allBranches, positions, BLOOD_KNIFE_MAP, "bloodKnife"));
+    matches.push(...checkBranchBasedSinsal(monthBranch, allBranches, positions, HEAVENLY_DOCTOR_MAP, "heavenlyDoctor"));
+    const uniqueMatches = matches.filter((match, index, self) => index === self.findIndex((m) => m.sinsal === match.sinsal && m.position === match.position));
+    const summary = {};
+    for (const match of uniqueMatches) {
+        if (!summary[match.sinsal]) {
+            summary[match.sinsal] = [];
+        }
+        summary[match.sinsal]?.push(match.position);
+    }
+    return { matches: uniqueMatches, summary };
+}
+export const SINSAL_INFO = {
+    peachBlossom: {
+        korean: "도화살",
+        hanja: "桃花煞",
+        meaning: "이성 인연, 매력, 색정",
+        type: "neutral",
+    },
+    skyHorse: { korean: "역마살", hanja: "驛馬煞", meaning: "이동, 변화, 해외", type: "neutral" },
+    floweryCanopy: {
+        korean: "화개살",
+        hanja: "華蓋煞",
+        meaning: "예술, 종교, 고독",
+        type: "neutral",
+    },
+    ghostGate: {
+        korean: "귀문관살",
+        hanja: "鬼門關煞",
+        meaning: "귀신, 영적 감각, 불안",
+        type: "inauspicious",
+    },
+    solitaryStar: {
+        korean: "고진살",
+        hanja: "孤辰煞",
+        meaning: "고독, 독립, 자립",
+        type: "inauspicious",
+    },
+    widowStar: {
+        korean: "과숙살",
+        hanja: "寡宿煞",
+        meaning: "외로움, 배우자 인연 약함",
+        type: "inauspicious",
+    },
+    heavenlyVirtue: {
+        korean: "천덕귀인",
+        hanja: "天德貴人",
+        meaning: "하늘의 덕, 재난 해소",
+        type: "auspicious",
+    },
+    monthlyVirtue: {
+        korean: "월덕귀인",
+        hanja: "月德貴人",
+        meaning: "달의 덕, 흉화 해소",
+        type: "auspicious",
+    },
+    skyNoble: {
+        korean: "천을귀인",
+        hanja: "天乙貴人",
+        meaning: "귀인의 도움, 위기 극복",
+        type: "auspicious",
+    },
+    moonNoble: { korean: "월을귀인", hanja: "月乙貴人", meaning: "귀인의 도움", type: "auspicious" },
+    literaryNoble: {
+        korean: "문창귀인",
+        hanja: "文昌貴人",
+        meaning: "학업, 시험, 문서",
+        type: "auspicious",
+    },
+    academicHall: {
+        korean: "학당귀인",
+        hanja: "學堂貴人",
+        meaning: "학문, 교육, 지식",
+        type: "auspicious",
+    },
+    bloodKnife: {
+        korean: "혈인살",
+        hanja: "血刃煞",
+        meaning: "수술, 출혈, 부상",
+        type: "inauspicious",
+    },
+    sixHarms: { korean: "육해살", hanja: "六害煞", meaning: "인관계 해침", type: "inauspicious" },
+    whiteCloth: {
+        korean: "백호살",
+        hanja: "白虎煞",
+        meaning: "상해, 사고, 흉사",
+        type: "inauspicious",
+    },
+    heavenlyDoctor: {
+        korean: "천의성",
+        hanja: "天醫星",
+        meaning: "치료, 의료, 건강 회복",
+        type: "auspicious",
+    },
+};

package/dist/core/solar-terms.d.ts

@@ -0,0 +1,155 @@
+import type { DateAdapter } from "../adapters/date-adapter";
+/**
+ * 24 Solar Terms (二十四節氣)
+ * Each term corresponds to a specific solar longitude
+ */
+export declare const SOLAR_TERMS: readonly [{
+    readonly name: "소한";
+    readonly hanja: "小寒";
+    readonly longitude: 285;
+}, {
+    readonly name: "대한";
+    readonly hanja: "大寒";
+    readonly longitude: 300;
+}, {
+    readonly name: "입춘";
+    readonly hanja: "立春";
+    readonly longitude: 315;
+}, {
+    readonly name: "우수";
+    readonly hanja: "雨水";
+    readonly longitude: 330;
+}, {
+    readonly name: "경칩";
+    readonly hanja: "驚蟄";
+    readonly longitude: 345;
+}, {
+    readonly name: "춘분";
+    readonly hanja: "春分";
+    readonly longitude: 0;
+}, {
+    readonly name: "청명";
+    readonly hanja: "淸明";
+    readonly longitude: 15;
+}, {
+    readonly name: "곡우";
+    readonly hanja: "穀雨";
+    readonly longitude: 30;
+}, {
+    readonly name: "입하";
+    readonly hanja: "立夏";
+    readonly longitude: 45;
+}, {
+    readonly name: "소만";
+    readonly hanja: "小滿";
+    readonly longitude: 60;
+}, {
+    readonly name: "망종";
+    readonly hanja: "芒種";
+    readonly longitude: 75;
+}, {
+    readonly name: "하지";
+    readonly hanja: "夏至";
+    readonly longitude: 90;
+}, {
+    readonly name: "소서";
+    readonly hanja: "小暑";
+    readonly longitude: 105;
+}, {
+    readonly name: "대서";
+    readonly hanja: "大暑";
+    readonly longitude: 120;
+}, {
+    readonly name: "입추";
+    readonly hanja: "立秋";
+    readonly longitude: 135;
+}, {
+    readonly name: "처서";
+    readonly hanja: "處暑";
+    readonly longitude: 150;
+}, {
+    readonly name: "백로";
+    readonly hanja: "白露";
+    readonly longitude: 165;
+}, {
+    readonly name: "추분";
+    readonly hanja: "秋分";
+    readonly longitude: 180;
+}, {
+    readonly name: "한로";
+    readonly hanja: "寒露";
+    readonly longitude: 195;
+}, {
+    readonly name: "상강";
+    readonly hanja: "霜降";
+    readonly longitude: 210;
+}, {
+    readonly name: "입동";
+    readonly hanja: "立冬";
+    readonly longitude: 225;
+}, {
+    readonly name: "소설";
+    readonly hanja: "小雪";
+    readonly longitude: 240;
+}, {
+    readonly name: "대설";
+    readonly hanja: "大雪";
+    readonly longitude: 255;
+}, {
+    readonly name: "동지";
+    readonly hanja: "冬至";
+    readonly longitude: 270;
+}];
+export type SolarTermName = (typeof SOLAR_TERMS)[number]["name"];
+export type SolarTermHanja = (typeof SOLAR_TERMS)[number]["hanja"];
+export interface SolarTerm {
+    name: SolarTermName;
+    hanja: SolarTermHanja;
+    longitude: number;
+}
+export interface SolarTermDateInfo {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+}
+export interface SolarTermInfo {
+    /** Current solar term (the one that has passed) */
+    current: SolarTerm;
+    /** Date when the current solar term started */
+    currentDate: SolarTermDateInfo;
+    /** Milliseconds timestamp of current solar term (for calculations) */
+    currentMillis: number;
+    /** Days elapsed since the current solar term */
+    daysSinceCurrent: number;
+    /** Next solar term (upcoming) */
+    next: SolarTerm;
+    /** Date when the next solar term will start */
+    nextDate: SolarTermDateInfo;
+    /** Milliseconds timestamp of next solar term (for calculations) */
+    nextMillis: number;
+    /** Days until the next solar term */
+    daysUntilNext: number;
+    /** Previous "節" (Jie) - the solar term that marks month boundary (for major luck calculation) */
+    prevJie: SolarTerm;
+    /** Date of previous Jie */
+    prevJieDate: SolarTermDateInfo;
+    /** Milliseconds timestamp of previous Jie */
+    prevJieMillis: number;
+    /** Next "節" (Jie) - the solar term that marks month boundary (for major luck calculation) */
+    nextJie: SolarTerm;
+    /** Date of next Jie */
+    nextJieDate: SolarTermDateInfo;
+    /** Milliseconds timestamp of next Jie */
+    nextJieMillis: number;
+}
+export declare function analyzeSolarTerms<T>(adapter: DateAdapter<T>, dtLocal: T): SolarTermInfo;
+/**
+ * Get all solar term dates for a given year
+ */
+export declare function getSolarTermsForYear<T>(adapter: DateAdapter<T>, year: number, timezone: string): Array<{
+    term: SolarTerm;
+    date: SolarTermDateInfo;
+}>;
+//# sourceMappingURL=solar-terms.d.ts.map

package/dist/core/solar-terms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solar-terms.d.ts","sourceRoot":"","sources":["../../src/core/solar-terms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBd,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AACjE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AAEnE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,OAAO,EAAE,SAAS,CAAC;IACnB,+CAA+C;IAC/C,WAAW,EAAE,iBAAiB,CAAC;IAC/B,sEAAsE;IACtE,aAAa,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC;IACzB,iCAAiC;IACjC,IAAI,EAAE,SAAS,CAAC;IAChB,+CAA+C;IAC/C,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,iGAAiG;IACjG,OAAO,EAAE,SAAS,CAAC;IACnB,2BAA2B;IAC3B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,6FAA6F;IAC7F,OAAO,EAAE,SAAS,CAAC;IACnB,uBAAuB;IACvB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;CACvB;AAuMD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,aAAa,CA0EvF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,KAAK,CAAC;IACP,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,iBAAiB,CAAC;CACzB,CAAC,CAuBD"}