@gracefullight/saju 0.4.1 → 0.5.0

package/dist/core/relations.js

@@ -1,4 +1,55 @@
-import { getBranchElement, getStemElement } from "./ten-gods";
+import { getBranchElement, getElementLabel, getStemElement } from "./ten-gods";
+export const RELATION_TYPE_KEYS = [
+    "stemCombination",
+    "sixCombination",
+    "tripleCombination",
+    "directionalCombination",
+    "clash",
+    "harm",
+    "punishment",
+    "destruction",
+];
+const RELATION_TYPE_DATA = {
+    stemCombination: { korean: "천간합", hanja: "天干合" },
+    sixCombination: { korean: "육합", hanja: "六合" },
+    tripleCombination: { korean: "삼합", hanja: "三合" },
+    directionalCombination: { korean: "방합", hanja: "方合" },
+    clash: { korean: "충", hanja: "沖" },
+    harm: { korean: "해", hanja: "害" },
+    punishment: { korean: "형", hanja: "刑" },
+    destruction: { korean: "파", hanja: "破" },
+};
+export function getRelationTypeLabel(key) {
+    const data = RELATION_TYPE_DATA[key];
+    return { key, ...data };
+}
+export const TRANSFORMATION_STATUS_KEYS = [
+    "combined",
+    "halfCombined",
+    "transformed",
+    "notTransformed",
+];
+const TRANSFORMATION_STATUS_DATA = {
+    combined: { korean: "합", hanja: "合" },
+    halfCombined: { korean: "반합", hanja: "半合" },
+    transformed: { korean: "화", hanja: "化" },
+    notTransformed: { korean: "불화", hanja: "不化" },
+};
+export function getTransformationStatusLabel(key) {
+    const data = TRANSFORMATION_STATUS_DATA[key];
+    return { key, ...data };
+}
+export const PUNISHMENT_TYPE_KEYS = ["ungrateful", "power", "rude", "self"];
+const PUNISHMENT_TYPE_DATA = {
+    ungrateful: { korean: "무은지형", hanja: "無恩之刑" },
+    power: { korean: "시세지형", hanja: "恃勢之刑" },
+    rude: { korean: "무례지형", hanja: "無禮之刑" },
+    self: { korean: "자형", hanja: "自刑" },
+};
+export function getPunishmentTypeLabel(key) {
+    const data = PUNISHMENT_TYPE_DATA[key];
+    return { key, ...data };
+}
 export const STEM_COMBINATIONS = [
     { stems: ["甲", "己"], resultElement: "earth" },
     { stems: ["乙", "庚"], resultElement: "metal" },
@@ -43,13 +94,13 @@ export const BRANCH_HARMS = [
     ["酉", "戌"],
 ];
 export const BRANCH_PUNISHMENTS = [
-    { branches: ["寅", "巳", "申"], type: "무은지형" },
-    { branches: ["丑", "戌", "未"], type: "시세지형" },
-    { branches: ["子", "卯"], type: "무례지형" },
-    { branches: ["辰", "辰"], type: "자형" },
-    { branches: ["午", "午"], type: "자형" },
-    { branches: ["酉", "酉"], type: "자형" },
-    { branches: ["亥", "亥"], type: "자형" },
+    { branches: ["寅", "巳", "申"], type: "ungrateful" },
+    { branches: ["丑", "戌", "未"], type: "power" },
+    { branches: ["子", "卯"], type: "rude" },
+    { branches: ["辰", "辰"], type: "self" },
+    { branches: ["午", "午"], type: "self" },
+    { branches: ["酉", "酉"], type: "self" },
+    { branches: ["亥", "亥"], type: "self" },
 ];
 export const BRANCH_DESTRUCTIONS = [
     ["子", "酉"],
@@ -80,15 +131,27 @@ function checkTransformationCondition(resultElement, monthBranch, allBranches, i
     const resultElementCount = branchElements.filter((e) => e === resultElement).length;
     const hasStrengthSupport = resultElementCount >= 2;
     if (!isComplete) {
-        return { status: "반합", reason: "불완전 합 - 일부 지지 부재" };
+        return {
+            status: getTransformationStatusLabel("halfCombined"),
+            reason: "불완전 합 - 일부 지지 부재",
+        };
     }
     if (hasMonthSupport) {
-        return { status: "화", reason: `월령(${monthBranch})이 ${resultElement}을(를) 지지` };
+        return {
+            status: getTransformationStatusLabel("transformed"),
+            reason: `월령(${monthBranch})이 ${resultElement}을(를) 지지`,
+        };
     }
     if (hasStrengthSupport) {
-        return { status: "화", reason: `${resultElement} 기세 충분(${resultElementCount}개)` };
+        return {
+            status: getTransformationStatusLabel("transformed"),
+            reason: `${resultElement} 기세 충분(${resultElementCount}개)`,
+        };
     }
-    return { status: "불화", reason: "월령 및 기세 미충족으로 화 불성립" };
+    return {
+        status: getTransformationStatusLabel("notTransformed"),
+        reason: "월령 및 기세 미충족으로 화 불성립",
+    };
 }
 function checkStemTransformationCondition(resultElement, monthBranch, allStems) {
     const supportedElements = MONTH_BRANCH_ELEMENT_SUPPORT[monthBranch] || [];
@@ -97,12 +160,21 @@ function checkStemTransformationCondition(resultElement, monthBranch, allStems)
     const resultElementCount = stemElements.filter((e) => e === resultElement).length;
     const hasStrengthSupport = resultElementCount >= 2;
     if (hasMonthSupport) {
-        return { status: "화", reason: `월령(${monthBranch})이 ${resultElement}을(를) 지지` };
+        return {
+            status: getTransformationStatusLabel("transformed"),
+            reason: `월령(${monthBranch})이 ${resultElement}을(를) 지지`,
+        };
     }
     if (hasStrengthSupport) {
-        return { status: "화", reason: `${resultElement} 기세 충분(${resultElementCount}개)` };
+        return {
+            status: getTransformationStatusLabel("transformed"),
+            reason: `${resultElement} 기세 충분(${resultElementCount}개)`,
+        };
     }
-    return { status: "불화", reason: "월령 및 기세 미충족으로 화 불성립" };
+    return {
+        status: getTransformationStatusLabel("notTransformed"),
+        reason: "월령 및 기세 미충족으로 화 불성립",
+    };
 }
 export function analyzeRelations(yearPillar, monthPillar, dayPillar, hourPillar) {
     const monthBranch = monthPillar[1];
@@ -134,10 +206,10 @@ export function analyzeRelations(yearPillar, monthPillar, dayPillar, hourPillar)
                     (s1.char === combo.stems[1] && s2.char === combo.stems[0])) {
                     const transform = checkStemTransformationCondition(combo.resultElement, monthBranch, allStemChars);
                     combinations.push({
-                        type: "천간합",
+                        type: getRelationTypeLabel("stemCombination"),
                         pair: [s1.char, s2.char],
                         positions: [s1.position, s2.position],
-                        resultElement: combo.resultElement,
+                        resultElement: getElementLabel(combo.resultElement),
                         transformStatus: transform.status,
                         transformReason: transform.reason,
                     });
@@ -154,10 +226,10 @@ export function analyzeRelations(yearPillar, monthPillar, dayPillar, hourPillar)
                     (b1.char === combo.branches[1] && b2.char === combo.branches[0])) {
                     const transform = checkTransformationCondition(combo.resultElement, monthBranch, allBranchChars, true);
                     combinations.push({
-                        type: "육합",
+                        type: getRelationTypeLabel("sixCombination"),
                         pair: [b1.char, b2.char],
                         positions: [b1.position, b2.position],
-                        resultElement: combo.resultElement,
+                        resultElement: getElementLabel(combo.resultElement),
                         transformStatus: transform.status,
                         transformReason: transform.reason,
                     });
@@ -167,7 +239,7 @@ export function analyzeRelations(yearPillar, monthPillar, dayPillar, hourPillar)
                 if ((b1.char === clash[0] && b2.char === clash[1]) ||
                     (b1.char === clash[1] && b2.char === clash[0])) {
                     clashes.push({
-                        type: "충",
+                        type: getRelationTypeLabel("clash"),
                         pair: [b1.char, b2.char],
                         positions: [b1.position, b2.position],
                     });
@@ -177,7 +249,7 @@ export function analyzeRelations(yearPillar, monthPillar, dayPillar, hourPillar)
                 if ((b1.char === harm[0] && b2.char === harm[1]) ||
                     (b1.char === harm[1] && b2.char === harm[0])) {
                     harms.push({
-                        type: "해",
+                        type: getRelationTypeLabel("harm"),
                         pair: [b1.char, b2.char],
                         positions: [b1.position, b2.position],
                     });
@@ -187,7 +259,7 @@ export function analyzeRelations(yearPillar, monthPillar, dayPillar, hourPillar)
                 if ((b1.char === dest[0] && b2.char === dest[1]) ||
                     (b1.char === dest[1] && b2.char === dest[0])) {
                     destructions.push({
-                        type: "파",
+                        type: getRelationTypeLabel("destruction"),
                         pair: [b1.char, b2.char],
                         positions: [b1.position, b2.position],
                     });
@@ -204,10 +276,10 @@ export function analyzeRelations(yearPillar, monthPillar, dayPillar, hourPillar)
             const isComplete = matched.length === 3;
             const transform = checkTransformationCondition(combo.resultElement, monthBranch, allBranchChars, isComplete);
             combinations.push({
-                type: "삼합",
+                type: getRelationTypeLabel("tripleCombination"),
                 branches: matched,
                 positions,
-                resultElement: combo.resultElement,
+                resultElement: getElementLabel(combo.resultElement),
                 isComplete,
                 transformStatus: transform.status,
                 transformReason: transform.reason,
@@ -222,10 +294,10 @@ export function analyzeRelations(yearPillar, monthPillar, dayPillar, hourPillar)
             const isComplete = matched.length === 3;
             const transform = checkTransformationCondition(combo.resultElement, monthBranch, allBranchChars, isComplete);
             combinations.push({
-                type: "방합",
+                type: getRelationTypeLabel("directionalCombination"),
                 branches: matched,
                 positions,
-                resultElement: combo.resultElement,
+                resultElement: getElementLabel(combo.resultElement),
                 isComplete,
                 transformStatus: transform.status,
                 transformReason: transform.reason,
@@ -235,17 +307,17 @@ export function analyzeRelations(yearPillar, monthPillar, dayPillar, hourPillar)
     for (const punishment of BRANCH_PUNISHMENTS) {
         const matched = punishment.branches.filter((b) => branchChars.includes(b));
         const isTriple = punishment.branches.length === 3;
-        const isSelfPunishment = punishment.type === "자형";
+        const isSelfPunishment = punishment.type === "self";
         if (isSelfPunishment) {
             const count = branchChars.filter((b) => b === punishment.branches[0]).length;
             if (count >= 2) {
                 punishments.push({
-                    type: "형",
+                    type: getRelationTypeLabel("punishment"),
                     branches: Array(count).fill(punishment.branches[0]),
                     positions: branches
                         .filter((b) => b.char === punishment.branches[0])
                         .map((b) => b.position),
-                    punishmentType: punishment.type,
+                    punishmentType: getPunishmentTypeLabel(punishment.type),
                 });
             }
         }
@@ -253,20 +325,20 @@ export function analyzeRelations(yearPillar, monthPillar, dayPillar, hourPillar)
             // biome-ignore lint/style/noNonNullAssertion: matched is filtered from branchChars, find is guaranteed
             const positions = matched.map((m) => branches.find((b) => b.char === m).position);
             punishments.push({
-                type: "형",
+                type: getRelationTypeLabel("punishment"),
                 branches: matched,
                 positions,
-                punishmentType: punishment.type,
+                punishmentType: getPunishmentTypeLabel(punishment.type),
             });
         }
         else if (!isTriple && matched.length === 2) {
             // biome-ignore lint/style/noNonNullAssertion: matched is filtered from branchChars, find is guaranteed
             const positions = matched.map((m) => branches.find((b) => b.char === m).position);
             punishments.push({
-                type: "형",
+                type: getRelationTypeLabel("punishment"),
                 branches: matched,
                 positions,
-                punishmentType: punishment.type,
+                punishmentType: getPunishmentTypeLabel(punishment.type),
             });
         }
     }

package/dist/core/sinsals.d.ts

@@ -1,19 +1,29 @@
-import type { PillarPosition } from "../types";
+import type { Label, PillarPosition } from "../types";
 export declare const SINSALS: readonly ["peachBlossom", "skyHorse", "floweryCanopy", "ghostGate", "solitaryStar", "widowStar", "heavenlyVirtue", "monthlyVirtue", "skyNoble", "moonNoble", "literaryNoble", "academicHall", "bloodKnife", "sixHarms", "whiteCloth", "heavenlyDoctor"];
-export type Sinsal = (typeof SINSALS)[number];
+export type SinsalKey = (typeof SINSALS)[number];
+/**
+ * @deprecated Use SinsalKey instead
+ */
+export type Sinsal = SinsalKey;
+export type SinsalType = "auspicious" | "inauspicious" | "neutral";
+export interface SinsalLabel extends Label<SinsalKey> {
+    meaning: string;
+    type: SinsalType;
+}
 export interface SinsalMatch {
-    sinsal: Sinsal;
+    sinsal: SinsalLabel;
     position: PillarPosition;
 }
 export interface SinsalResult {
     matches: SinsalMatch[];
-    summary: Partial<Record<Sinsal, PillarPosition[]>>;
+    summary: Partial<Record<SinsalKey, PillarPosition[]>>;
 }
 export declare function analyzeSinsals(yearPillar: string, monthPillar: string, dayPillar: string, hourPillar: string): SinsalResult;
-export declare const SINSAL_INFO: Record<Sinsal, {
+export declare const SINSAL_INFO: Record<SinsalKey, {
     korean: string;
     hanja: string;
     meaning: string;
-    type: "auspicious" | "inauspicious" | "neutral";
+    type: SinsalType;
 }>;
+export declare function getSinsalLabel(key: SinsalKey): SinsalLabel;
 //# sourceMappingURL=sinsals.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sinsals.d.ts","sourceRoot":"","sources":["../../src/core/sinsals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,eAAO,MAAM,OAAO,yPAiBV,CAAC;AAEX,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AA+L9C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;CACpD;AA6CD,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,YAAY,CAoId;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAC9B,MAAM,EACN;IACE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,YAAY,GAAG,cAAc,GAAG,SAAS,CAAC;CACjD,CAmFF,CAAC"}
+{"version":3,"file":"sinsals.d.ts","sourceRoot":"","sources":["../../src/core/sinsals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAErD,eAAO,MAAM,OAAO,yPAiBV,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,SAAS,CAAC;AAE/B,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,cAAc,GAAG,SAAS,CAAC;AAEnE,MAAM,WAAW,WAAY,SAAQ,KAAK,CAAC,SAAS,CAAC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;CAClB;AA+LD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;CACvD;AA6CD,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,YAAY,CAqId;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAC9B,SAAS,EACT;IACE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;CAClB,CAmFF,CAAC;AAEF,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,WAAW,CAS1D"}

package/dist/core/sinsals.js

@@ -192,26 +192,26 @@ const HEAVENLY_DOCTOR_MAP = {
     戌: "酉",
     亥: "戌",
 };
-function checkBranchBasedSinsal(baseBranch, targetBranches, positions, map, sinsal) {
+function checkBranchBasedSinsal(baseBranch, targetBranches, positions, map, sinsalKey) {
     const matches = [];
     const targetSinsal = map[baseBranch];
     if (targetSinsal) {
         targetBranches.forEach((branch, idx) => {
             if (branch === targetSinsal) {
-                matches.push({ sinsal, position: positions[idx] });
+                matches.push({ sinsal: getSinsalLabel(sinsalKey), position: positions[idx] });
             }
         });
     }
     return matches;
 }
-function checkStemBasedSinsal(baseStem, targetBranches, positions, map, sinsal) {
+function checkStemBasedSinsal(baseStem, targetBranches, positions, map, sinsalKey) {
     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] });
+                matches.push({ sinsal: getSinsalLabel(sinsalKey), position: positions[idx] });
             }
         });
     }
@@ -244,13 +244,14 @@ export function analyzeSinsals(yearPillar, monthPillar, dayPillar, hourPillar) {
     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 uniqueMatches = matches.filter((match, index, self) => index ===
+        self.findIndex((m) => m.sinsal.key === match.sinsal.key && m.position === match.position));
     const summary = {};
     for (const match of uniqueMatches) {
-        if (!summary[match.sinsal]) {
-            summary[match.sinsal] = [];
+        if (!summary[match.sinsal.key]) {
+            summary[match.sinsal.key] = [];
         }
-        summary[match.sinsal]?.push(match.position);
+        summary[match.sinsal.key]?.push(match.position);
     }
     return { matches: uniqueMatches, summary };
 }
@@ -337,3 +338,13 @@ export const SINSAL_INFO = {
         type: "auspicious",
     },
 };
+export function getSinsalLabel(key) {
+    const info = SINSAL_INFO[key];
+    return {
+        key,
+        korean: info.korean,
+        hanja: info.hanja,
+        meaning: info.meaning,
+        type: info.type,
+    };
+}

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

@@ -1,110 +1,23 @@
 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"];
+import type { Label } from "../types";
+export declare const SOLAR_TERM_KEYS: readonly ["minorCold", "majorCold", "springBegins", "rainWater", "awakeningInsects", "vernalEquinox", "pureBrightness", "grainRain", "summerBegins", "grainBuds", "grainInEar", "summerSolstice", "minorHeat", "majorHeat", "autumnBegins", "heatStops", "whiteDew", "autumnalEquinox", "coldDew", "frostDescends", "winterBegins", "minorSnow", "majorSnow", "winterSolstice"];
+export type SolarTermKey = (typeof SOLAR_TERM_KEYS)[number];
+export interface SolarTermLabel extends Label<SolarTermKey> {
+    longitude: number;
+}
+declare const SOLAR_TERM_DATA: Record<SolarTermKey, {
+    korean: string;
+    hanja: string;
+    longitude: number;
+}>;
+export declare function getSolarTermLabel(key: SolarTermKey): SolarTermLabel;
+export declare const SOLAR_TERMS: SolarTermLabel[];
+export type SolarTermName = (typeof SOLAR_TERM_DATA)[SolarTermKey]["korean"];
+export type SolarTermHanja = (typeof SOLAR_TERM_DATA)[SolarTermKey]["hanja"];
 export interface SolarTerm {
-    name: SolarTermName;
-    hanja: SolarTermHanja;
+    key: SolarTermKey;
+    korean: string;
+    hanja: string;
     longitude: number;
 }
 export interface SolarTermDateInfo {
@@ -152,4 +65,5 @@ export declare function getSolarTermsForYear<T>(adapter: DateAdapter<T>, year: n
     term: SolarTerm;
     date: SolarTermDateInfo;
 }>;
+export {};
 //# sourceMappingURL=solar-terms.d.ts.map

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

@@ -1 +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"}
+{"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;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,eAAO,MAAM,eAAe,iXAyBlB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,MAAM,WAAW,cAAe,SAAQ,KAAK,CAAC,YAAY,CAAC;IACzD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,QAAA,MAAM,eAAe,EAAE,MAAM,CAAC,YAAY,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CA0B7F,CAAC;AAEJ,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,cAAc,CAGnE;AAED,eAAO,MAAM,WAAW,kBAAuD,CAAC;AAEhF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC;AAC7E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC;AAE7E,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,YAAY,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,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"}

package/dist/core/solar-terms.js

@@ -1,33 +1,60 @@
-/**
- * 24 Solar Terms (二十四節氣)
- * Each term corresponds to a specific solar longitude
- */
-export const SOLAR_TERMS = [
-    { name: "소한", hanja: "小寒", longitude: 285 },
-    { name: "대한", hanja: "大寒", longitude: 300 },
-    { name: "입춘", hanja: "立春", longitude: 315 },
-    { name: "우수", hanja: "雨水", longitude: 330 },
-    { name: "경칩", hanja: "驚蟄", longitude: 345 },
-    { name: "춘분", hanja: "春分", longitude: 0 },
-    { name: "청명", hanja: "淸明", longitude: 15 },
-    { name: "곡우", hanja: "穀雨", longitude: 30 },
-    { name: "입하", hanja: "立夏", longitude: 45 },
-    { name: "소만", hanja: "小滿", longitude: 60 },
-    { name: "망종", hanja: "芒種", longitude: 75 },
-    { name: "하지", hanja: "夏至", longitude: 90 },
-    { name: "소서", hanja: "小暑", longitude: 105 },
-    { name: "대서", hanja: "大暑", longitude: 120 },
-    { name: "입추", hanja: "立秋", longitude: 135 },
-    { name: "처서", hanja: "處暑", longitude: 150 },
-    { name: "백로", hanja: "白露", longitude: 165 },
-    { name: "추분", hanja: "秋分", longitude: 180 },
-    { name: "한로", hanja: "寒露", longitude: 195 },
-    { name: "상강", hanja: "霜降", longitude: 210 },
-    { name: "입동", hanja: "立冬", longitude: 225 },
-    { name: "소설", hanja: "小雪", longitude: 240 },
-    { name: "대설", hanja: "大雪", longitude: 255 },
-    { name: "동지", hanja: "冬至", longitude: 270 },
+export const SOLAR_TERM_KEYS = [
+    "minorCold",
+    "majorCold",
+    "springBegins",
+    "rainWater",
+    "awakeningInsects",
+    "vernalEquinox",
+    "pureBrightness",
+    "grainRain",
+    "summerBegins",
+    "grainBuds",
+    "grainInEar",
+    "summerSolstice",
+    "minorHeat",
+    "majorHeat",
+    "autumnBegins",
+    "heatStops",
+    "whiteDew",
+    "autumnalEquinox",
+    "coldDew",
+    "frostDescends",
+    "winterBegins",
+    "minorSnow",
+    "majorSnow",
+    "winterSolstice",
 ];
+const SOLAR_TERM_DATA = {
+    minorCold: { korean: "소한", hanja: "小寒", longitude: 285 },
+    majorCold: { korean: "대한", hanja: "大寒", longitude: 300 },
+    springBegins: { korean: "입춘", hanja: "立春", longitude: 315 },
+    rainWater: { korean: "우수", hanja: "雨水", longitude: 330 },
+    awakeningInsects: { korean: "경칩", hanja: "驚蟄", longitude: 345 },
+    vernalEquinox: { korean: "춘분", hanja: "春分", longitude: 0 },
+    pureBrightness: { korean: "청명", hanja: "淸明", longitude: 15 },
+    grainRain: { korean: "곡우", hanja: "穀雨", longitude: 30 },
+    summerBegins: { korean: "입하", hanja: "立夏", longitude: 45 },
+    grainBuds: { korean: "소만", hanja: "小滿", longitude: 60 },
+    grainInEar: { korean: "망종", hanja: "芒種", longitude: 75 },
+    summerSolstice: { korean: "하지", hanja: "夏至", longitude: 90 },
+    minorHeat: { korean: "소서", hanja: "小暑", longitude: 105 },
+    majorHeat: { korean: "대서", hanja: "大暑", longitude: 120 },
+    autumnBegins: { korean: "입추", hanja: "立秋", longitude: 135 },
+    heatStops: { korean: "처서", hanja: "處暑", longitude: 150 },
+    whiteDew: { korean: "백로", hanja: "白露", longitude: 165 },
+    autumnalEquinox: { korean: "추분", hanja: "秋分", longitude: 180 },
+    coldDew: { korean: "한로", hanja: "寒露", longitude: 195 },
+    frostDescends: { korean: "상강", hanja: "霜降", longitude: 210 },
+    winterBegins: { korean: "입동", hanja: "立冬", longitude: 225 },
+    minorSnow: { korean: "소설", hanja: "小雪", longitude: 240 },
+    majorSnow: { korean: "대설", hanja: "大雪", longitude: 255 },
+    winterSolstice: { korean: "동지", hanja: "冬至", longitude: 270 },
+};
+export function getSolarTermLabel(key) {
+    const data = SOLAR_TERM_DATA[key];
+    return { key, ...data };
+}
+export const SOLAR_TERMS = SOLAR_TERM_KEYS.map((key) => getSolarTermLabel(key));
 function normDeg(x) {
     x %= 360;
     return x < 0 ? x + 360 : x;

package/dist/core/strength.d.ts

@@ -1,4 +1,12 @@
+import type { Label } from "../types";
+export declare const STRENGTH_LEVEL_KEYS: readonly ["extremelyWeak", "veryWeak", "weak", "neutralWeak", "neutral", "neutralStrong", "strong", "veryStrong", "extremelyStrong"];
+export type StrengthLevelKey = (typeof STRENGTH_LEVEL_KEYS)[number];
+export interface StrengthLevelLabel extends Label<StrengthLevelKey> {
+}
+export declare function getStrengthLevelLabel(key: StrengthLevelKey): StrengthLevelLabel;
+/** @deprecated Use StrengthLevelKey instead */
 export type StrengthLevel = "극약" | "태약" | "신약" | "중화신약" | "중화" | "중화신강" | "신강" | "태강" | "극왕";
+/** @deprecated Use STRENGTH_LEVEL_KEYS instead */
 export declare const STRENGTH_LEVELS: StrengthLevel[];
 export interface StrengthFactors {
     deukryeong: number;
@@ -9,7 +17,7 @@ export interface StrengthFactors {
     weakenCount: number;
 }
 export interface StrengthResult {
-    level: StrengthLevel;
+    level: StrengthLevelLabel;
     score: number;
     factors: StrengthFactors;
     description: string;

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

@@ -1 +1 @@
-{"version":3,"file":"strength.d.ts","sourceRoot":"","sources":["../../src/core/strength.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GACrB,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,IAAI,GACJ,MAAM,GACN,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;AAET,eAAO,MAAM,eAAe,EAAE,aAAa,EAU1C,CAAC;AAsKF,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,eAAe,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,cAAc,CAsGhB"}
+{"version":3,"file":"strength.d.ts","sourceRoot":"","sources":["../../src/core/strength.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGrC,eAAO,MAAM,mBAAmB,sIAUtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,MAAM,WAAW,kBAAmB,SAAQ,KAAK,CAAC,gBAAgB,CAAC;CAAG;AActE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,gBAAgB,GAAG,kBAAkB,CAG/E;AAED,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GACrB,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,IAAI,GACJ,MAAM,GACN,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;AAET,kDAAkD;AAClD,eAAO,MAAM,eAAe,EAAE,aAAa,EAU1C,CAAC;AAsKF,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,eAAe,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,cAAc,CAsGhB"}