@gracefullight/saju 0.2.0 → 0.3.0

package/README.en.md

@@ -15,7 +15,13 @@
 - **Solar Time Correction** - Optional mean solar time adjustment based on longitude
 - **Tree-shakeable** - Import only what you need
 - **Fully Typed** - Complete TypeScript definitions
-- **Well Tested** - 85+ tests with 91%+ coverage
+- **Well Tested** - 180+ tests with 91%+ coverage
+- **Ten Gods Analysis** - Detailed ten gods and five elements distribution with hidden stems
+- **Strength Assessment** - 9-level strength analysis with monthly strength (得令), root strength (通根), transparency (透干), and hidden stem weights (本中餘氣)
+- **Relations Analysis** - Combinations, clashes, harms, punishments with transformation (化) status and conditions
+- **Major/Yearly Luck** - Solar term (節氣) based accurate luck start calculation, major luck and yearly luck based on gender and year pillar
+- **Yongshen Extraction** - Favorable element recommendation following 格局→抑扶→調候 priority with fortune enhancement guide
+- **Solar Terms Analysis** - Current/next solar term info with elapsed days calculation
 
 ## What is Saju (四柱)?
 
@@ -56,6 +62,39 @@ pnpm add date-fns date-fns-tz
 
 ## Quick Start
 
+```typescript
+import { DateTime } from "luxon";
+import { createLuxonAdapter } from "@gracefullight/saju/adapters/luxon";
+import { getSaju, STANDARD_PRESET } from "@gracefullight/saju";
+
+const adapter = await createLuxonAdapter();
+
+const birthDateTime = DateTime.fromObject(
+  { year: 2000, month: 1, day: 1, hour: 18, minute: 0 },
+  { zone: "Asia/Seoul" }
+);
+
+// getSaju: Calculate pillars, ten gods, strength, relations, yongshen, solar terms, major luck, yearly luck all at once
+const result = getSaju(adapter, birthDateTime, {
+  longitudeDeg: 126.9778,
+  gender: "male",  // Required: needed for major luck calculation
+  preset: STANDARD_PRESET,
+  currentYear: 2024,  // For default yearly luck range (optional)
+  yearlyLuckRange: { from: 2024, to: 2030 },  // Specify yearly luck range directly (optional)
+});
+
+console.log(result.pillars);     // { year: "己卯", month: "丙子", ... }
+console.log(result.tenGods);     // Ten gods and hidden stems analysis
+console.log(result.strength);    // Strength assessment (e.g., "weak")
+console.log(result.relations);   // Relations analysis
+console.log(result.yongShen);    // Yongshen and fortune tips
+console.log(result.solarTerms);  // Solar term info (current/next term, elapsed days)
+console.log(result.majorLuck);   // Major luck info
+console.log(result.yearlyLuck);  // Yearly luck info
+```
+
+### Calculate Four Pillars Only
+
 ```typescript
 import { DateTime } from "luxon";
 import { createLuxonAdapter } from "@gracefullight/saju/adapters/luxon";
@@ -74,24 +113,6 @@ const result = getFourPillars(adapter, birthDateTime, {
 });
 
 console.log(result);
-// {
-//   year: "己卯",    // Year Pillar (Heavenly Stem + Earthly Branch)
-//   month: "丙子",   // Month Pillar
-//   day: "辛巳",     // Day Pillar
-//   hour: "戊戌",    // Hour Pillar
-//   lunar: {
-//     lunarYear: 1999,
-//     lunarMonth: 11,
-//     lunarDay: 25,
-//     isLeapMonth: false
-//   },
-//   meta: {
-//     solarYearUsed: 1999,
-//     sunLonDeg: 280.9,
-//     effectiveDayDate: { year: 2000, month: 1, day: 1 },
-//     adjustedDtForHour: "2000-01-01T18:00:00.000+09:00"
-//   }
-// }
 ```
 
 ## Usage
@@ -206,12 +227,27 @@ Traditional interpretation with Zi hour (23:00) day boundary and solar time corr
 }
 ```
 
-#### Deprecated Aliases
-- `presetA` → Use `STANDARD_PRESET`
-- `presetB` → Use `TRADITIONAL_PRESET`
-
 ### Core Functions
 
+#### `getSaju(adapter, datetime, options)`
+
+Calculate all saju analysis results (pillars, ten gods, strength, relations, yongshen, solar terms, major luck, yearly luck) at once.
+
+```typescript
+function getSaju<T>(
+  adapter: DateAdapter<T>,
+  dtLocal: T,
+  options: {
+    longitudeDeg: number;
+    gender: "male" | "female";  // Required
+    tzOffsetHours?: number;
+    preset?: typeof STANDARD_PRESET;
+    currentYear?: number;  // For default yearly luck range
+    yearlyLuckRange?: { from: number; to: number };  // Specify yearly luck range directly
+  }
+): SajuResult;
+```
+
 #### `getFourPillars(adapter, datetime, options)`
 
 Calculate all four pillars (year, month, day, hour).
@@ -425,6 +461,109 @@ function effectiveDayDate<T>(
 }
 ```
 
+### Analysis Functions
+
+#### `analyzeTenGods(year, month, day, hour)`
+
+Analyzes ten gods and hidden stems of the four pillars.
+
+```typescript
+function analyzeTenGods(
+  year: string,
+  month: string,
+  day: string,
+  hour: string
+): FourPillarsTenGods;
+```
+
+#### `analyzeStrength(year, month, day, hour)`
+
+Assesses the strength of the day master on a 7-level scale.
+
+```typescript
+function analyzeStrength(
+  year: string,
+  month: string,
+  day: string,
+  hour: string
+): StrengthResult;
+```
+
+#### `analyzeRelations(year, month, day, hour)`
+
+Analyzes combinations, clashes, harms, and punishments between stems and branches.
+
+```typescript
+function analyzeRelations(
+  year: string,
+  month: string,
+  day: string,
+  hour: string
+): RelationsResult;
+```
+
+#### `calculateMajorLuck(adapter, datetime, gender, year, month)`
+
+Calculates major luck periods and starting age.
+
+```typescript
+function calculateMajorLuck<T>(
+  adapter: DateAdapter<T>,
+  birthDateTime: T,
+  gender: "male" | "female",
+  yearPillar: string,
+  monthPillar: string
+): MajorLuckResult;
+```
+
+#### `analyzeYongShen(year, month, day, hour)`
+
+Extracts favorable elements considering suppression and climate adjustment.
+
+```typescript
+function analyzeYongShen(
+  year: string,
+  month: string,
+  day: string,
+  hour: string
+): YongShenResult;
+```
+
+#### `analyzeSolarTerms(adapter, datetime)`
+
+Calculates current and next solar term info with elapsed days.
+
+```typescript
+function analyzeSolarTerms<T>(
+  adapter: DateAdapter<T>,
+  dtLocal: T
+): SolarTermInfo;
+```
+
+**Returns:**
+```typescript
+{
+  current: { name: "소한", hanja: "小寒", longitude: 285 },
+  currentDate: { year: 2024, month: 1, day: 6, hour: 5, minute: 30 },
+  daysSinceCurrent: 5,
+  next: { name: "대한", hanja: "大寒", longitude: 300 },
+  nextDate: { year: 2024, month: 1, day: 20, hour: 12, minute: 15 },
+  daysUntilNext: 10
+}
+```
+
+#### `getSolarTermsForYear(adapter, year, timezone)`
+
+Calculates all 24 solar terms for a specific year.
+
+```typescript
+function getSolarTermsForYear<T>(
+  adapter: DateAdapter<T>,
+  year: number,
+  timezone: string
+): Array<{ term: SolarTerm; date: {...} }>;
+```
+
 ## Advanced Usage
 
 ### Solar Time Correction
@@ -499,6 +638,85 @@ Common city longitudes for reference:
 
 ## Examples
 
+### Major and Yearly Luck Calculation
+
+```typescript
+const saju = getSaju(adapter, dt, {
+  longitudeDeg: 126.9778,
+  gender: "female",
+  yearlyLuckRange: { from: 2024, to: 2030 }
+});
+
+// Check major luck
+console.log(saju.majorLuck.pillars); // Major luck pillars list
+console.log(saju.majorLuck.startAge); // Starting age for major luck
+
+// Check yearly luck
+saju.yearlyLuck.forEach(luck => {
+  console.log(`Year ${luck.year} (${luck.pillar}): Age ${luck.age}`);
+});
+```
+
+### Solar Terms Info
+
+```typescript
+const saju = getSaju(adapter, dt, {
+  longitudeDeg: 126.9778,
+  gender: "male",
+});
+
+// Current solar term
+console.log(saju.solarTerms.current.name);  // "소한"
+console.log(saju.solarTerms.current.hanja); // "小寒"
+console.log(saju.solarTerms.daysSinceCurrent); // 5 (days since term started)
+
+// Next solar term
+console.log(saju.solarTerms.next.name);     // "대한"
+console.log(saju.solarTerms.daysUntilNext); // 10 (days until next term)
+
+// Solar term dates
+console.log(saju.solarTerms.currentDate);   // { year: 2024, month: 1, day: 6, ... }
+console.log(saju.solarTerms.nextDate);      // { year: 2024, month: 1, day: 20, ... }
+```
+
+### Ten Gods and Five Elements Analysis
+
+```typescript
+import { analyzeTenGods, countElements } from "@gracefullight/saju";
+
+const tenGods = analyzeTenGods("己卯", "丙子", "辛巳", "戊戌");
+console.log(tenGods.dayMaster); // "辛"
+
+const elements = countElements(tenGods);
+console.log(elements); // { wood: 1, fire: 1, earth: 3, metal: 1, water: 2 }
+```
+
+### Strength and Yongshen Analysis
+
+```typescript
+import { analyzeStrength, analyzeYongShen, getElementRecommendations } from "@gracefullight/saju";
+
+const strength = analyzeStrength("己卯", "丙子", "辛巳", "戊戌");
+console.log(strength.level); // "weak"
+
+const yongShen = analyzeYongShen("己卯", "丙子", "辛巳", "戊戌");
+console.log(yongShen.primary); // Favorable element (e.g., "earth")
+
+const tips = getElementRecommendations(yongShen);
+console.log(tips.colors); // Lucky colors
+```
+
+### Relations Analysis
+
+```typescript
+import { analyzeRelations } from "@gracefullight/saju";
+
+const relations = analyzeRelations("己卯", "丙子", "辛巳", "戊戌");
+relations.clashes.forEach(c => {
+  console.log(`${c.positions[0]}-${c.positions[1]} branch clash: ${c.pair[0]}-${c.pair[1]}`);
+});
+```
+
 ### Calculate for Different Timezones
 
 ```typescript
@@ -606,7 +824,15 @@ packages/saju/
 │   │   ├── luxon.ts        # Luxon adapter
 │   │   └── date-fns.ts     # date-fns adapter
 │   ├── core/               # Core calculation logic
-│   │   └── four-pillars.ts # Main algorithms
+│   │   ├── four-pillars.ts # Four pillars calculation
+│   │   ├── ten-gods.ts     # Ten gods analysis
+│   │   ├── strength.ts     # Strength assessment
+│   │   ├── relations.ts    # Relations analysis
+│   │   ├── luck.ts         # Major/yearly luck
+│   │   ├── yongshen.ts     # Yongshen extraction
+│   │   ├── solar-terms.ts  # Solar terms calculation
+│   │   └── lunar.ts        # Lunar conversion
+│   ├── types/              # Type definitions
 │   ├── __tests__/          # Test suites
 │   └── index.ts            # Public API
 ├── dist/                   # Compiled output
@@ -723,7 +949,3 @@ This library is based on traditional Chinese calendar algorithms and astronomica
 - [Documentation](https://github.com/gracefullight/saju#readme)
 - [Issue Tracker](https://github.com/gracefullight/saju/issues)
 - [Discussions](https://github.com/gracefullight/saju/discussions)
-
----
-
-Made by [gracefullight](https://github.com/gracefullight)

package/README.md

@@ -15,7 +15,13 @@
 - **태양시 보정** - 경도 기반 평균 태양시 조정 옵션
 - **트리쉐이킹 지원** - 필요한 것만 import
 - **완전한 타입 지원** - TypeScript 정의 완비
-- **풍부한 테스트** - 85개 이상 테스트, 91% 이상 커버리지
+- **풍부한 테스트** - 180개 이상 테스트, 91% 이상 커버리지
+- **십신 분석** - 장간(藏干)을 포함한 상세 십신 및 오행 분포 분석
+- **신강/신약 판정** - 월령 득령(得令), 통근(通根), 투간(透干), 본중여기(本中餘氣) 가중치를 고려한 9단계 신강도 분석
+- **합충형파해** - 천간합, 육합, 삼합, 방합 및 충, 해, 형, 파 분석. 합(合)과 화(化) 성립 조건 분리 표기
+- **대운/세운 계산** - 절기(節氣) 기반 정확한 기운(起運) 계산, 성별 및 연간 음양을 고려한 대운 및 연도별 세운 계산
+- **용신 추출** - 격국(格局), 억부(抑扶), 조후(調候) 순서로 용신 추천 및 개운법 가이드
+- **절기 분석** - 현재/다음 절기 정보 및 경과일 계산
 
 ## 사주(四柱)란?
 
@@ -56,6 +62,39 @@ pnpm add date-fns date-fns-tz
 
 ## 빠른 시작
 
+```typescript
+import { DateTime } from "luxon";
+import { createLuxonAdapter } from "@gracefullight/saju/adapters/luxon";
+import { getSaju, STANDARD_PRESET } from "@gracefullight/saju";
+
+const adapter = await createLuxonAdapter();
+
+const birthDateTime = DateTime.fromObject(
+  { year: 2000, month: 1, day: 1, hour: 18, minute: 0 },
+  { zone: "Asia/Seoul" }
+);
+
+// getSaju: 사주 팔자, 십신, 신강약, 합충, 용신, 절기, 대운, 세운을 한 번에 계산
+const result = getSaju(adapter, birthDateTime, {
+  longitudeDeg: 126.9778,
+  gender: "male",  // 필수: 대운 계산에 필요
+  preset: STANDARD_PRESET,
+  currentYear: 2024,  // 세운 기본 범위 계산용 (선택)
+  yearlyLuckRange: { from: 2024, to: 2030 },  // 세운 범위 직접 지정 (선택)
+});
+
+console.log(result.pillars);     // { year: "己卯", month: "丙子", ... }
+console.log(result.tenGods);     // 십신 및 장간 분석
+console.log(result.strength);    // 신강/신약 판정 (예: "신약")
+console.log(result.relations);   // 합충형파해 분석
+console.log(result.yongShen);    // 용신 및 개운법
+console.log(result.solarTerms);  // 절기 정보 (현재/다음 절기, 경과일)
+console.log(result.majorLuck);   // 대운 정보
+console.log(result.yearlyLuck);  // 세운 정보
+```
+
+### 사주 팔자만 계산하기
+
 ```typescript
 import { DateTime } from "luxon";
 import { createLuxonAdapter } from "@gracefullight/saju/adapters/luxon";
@@ -74,24 +113,6 @@ const result = getFourPillars(adapter, birthDateTime, {
 });
 
 console.log(result);
-// {
-//   year: "己卯",    // 연주 (천간 + 지지)
-//   month: "丙子",   // 월주
-//   day: "辛巳",     // 일주
-//   hour: "戊戌",    // 시주
-//   lunar: {
-//     lunarYear: 1999,
-//     lunarMonth: 11,
-//     lunarDay: 25,
-//     isLeapMonth: false
-//   },
-//   meta: {
-//     solarYearUsed: 1999,
-//     sunLonDeg: 280.9,
-//     effectiveDayDate: { year: 2000, month: 1, day: 1 },
-//     adjustedDtForHour: "2000-01-01T18:00:00.000+09:00"
-//   }
-// }
 ```
 
 ## 사용법
@@ -206,12 +227,27 @@ const myAdapter: DateAdapter<MyDateType> = {
 }
 ```
 
-#### 사용 중단된 별칭
-- `presetA` → `STANDARD_PRESET` 사용 권장
-- `presetB` → `TRADITIONAL_PRESET` 사용 권장
-
 ### 핵심 함수
 
+#### `getSaju(adapter, datetime, options)`
+
+사주 분석의 모든 결과(팔자, 십신, 신강약, 합충, 용신, 대운)를 한 번에 계산합니다.
+
+```typescript
+function getSaju<T>(
+  adapter: DateAdapter<T>,
+  dtLocal: T,
+  options: {
+    longitudeDeg: number;
+    gender: "male" | "female";  // 필수
+    tzOffsetHours?: number;
+    preset?: typeof STANDARD_PRESET;
+    currentYear?: number;  // 세운 기본 범위 계산용
+    yearlyLuckRange?: { from: number; to: number };  // 세운 범위 직접 지정
+  }
+): SajuResult;
+```
+
 #### `getFourPillars(adapter, datetime, options)`
 
 네 기둥(연주, 월주, 일주, 시주) 모두 계산
@@ -425,6 +461,109 @@ function effectiveDayDate<T>(
 }
 ```
 
+### 분석 함수
+
+#### `analyzeTenGods(year, month, day, hour)`
+
+사주 팔자의 십신과 지장간을 분석합니다.
+
+```typescript
+function analyzeTenGods(
+  year: string,
+  month: string,
+  day: string,
+  hour: string
+): FourPillarsTenGods;
+```
+
+#### `analyzeStrength(year, month, day, hour)`
+
+사주의 신강/신약을 9단계로 판정합니다.
+
+```typescript
+function analyzeStrength(
+  year: string,
+  month: string,
+  day: string,
+  hour: string
+): StrengthResult;
+```
+
+#### `analyzeRelations(year, month, day, hour)`
+
+천간과 지지의 합, 충, 형, 파, 해 관계를 분석합니다.
+
+```typescript
+function analyzeRelations(
+  year: string,
+  month: string,
+  day: string,
+  hour: string
+): RelationsResult;
+```
+
+#### `calculateMajorLuck(adapter, datetime, gender, year, month)`
+
+대운의 흐름과 시작 연령을 계산합니다.
+
+```typescript
+function calculateMajorLuck<T>(
+  adapter: DateAdapter<T>,
+  birthDateTime: T,
+  gender: "male" | "female",
+  yearPillar: string,
+  monthPillar: string
+): MajorLuckResult;
+```
+
+#### `analyzeYongShen(year, month, day, hour)`
+
+억부와 조후를 고려하여 용신과 희신을 추출합니다.
+
+```typescript
+function analyzeYongShen(
+  year: string,
+  month: string,
+  day: string,
+  hour: string
+): YongShenResult;
+```
+
+#### `analyzeSolarTerms(adapter, datetime)`
+
+현재 및 다음 절기 정보와 경과일을 계산합니다.
+
+```typescript
+function analyzeSolarTerms<T>(
+  adapter: DateAdapter<T>,
+  dtLocal: T
+): SolarTermInfo;
+```
+
+**반환값:**
+```typescript
+{
+  current: { name: "소한", hanja: "小寒", longitude: 285 },
+  currentDate: { year: 2024, month: 1, day: 6, hour: 5, minute: 30 },
+  daysSinceCurrent: 5,
+  next: { name: "대한", hanja: "大寒", longitude: 300 },
+  nextDate: { year: 2024, month: 1, day: 20, hour: 12, minute: 15 },
+  daysUntilNext: 10
+}
+```
+
+#### `getSolarTermsForYear(adapter, year, timezone)`
+
+특정 연도의 24절기 날짜를 모두 계산합니다.
+
+```typescript
+function getSolarTermsForYear<T>(
+  adapter: DateAdapter<T>,
+  year: number,
+  timezone: string
+): Array<{ term: SolarTerm; date: {...} }>;
+```
+
 ## 고급 사용법
 
 ### 태양시 보정
@@ -499,6 +638,85 @@ const result = getFourPillars(adapter, dt, {
 
 ## 예제
 
+### 대운과 세운 계산
+
+```typescript
+const saju = getSaju(adapter, dt, {
+  longitudeDeg: 126.9778,
+  gender: "female",
+  yearlyLuckRange: { from: 2024, to: 2030 }
+});
+
+// 대운 확인
+console.log(saju.majorLuck.pillars); // 대운 목록
+console.log(saju.majorLuck.startAge); // 대운 시작 나이
+
+// 세운 확인
+saju.yearlyLuck.forEach(luck => {
+  console.log(`${luck.year}년(${luck.pillar}): ${luck.age}세`);
+});
+```
+
+### 절기 정보 확인
+
+```typescript
+const saju = getSaju(adapter, dt, {
+  longitudeDeg: 126.9778,
+  gender: "male",
+});
+
+// 현재 절기
+console.log(saju.solarTerms.current.name);  // "소한"
+console.log(saju.solarTerms.current.hanja); // "小寒"
+console.log(saju.solarTerms.daysSinceCurrent); // 5 (절기 경과일)
+
+// 다음 절기
+console.log(saju.solarTerms.next.name);     // "대한"
+console.log(saju.solarTerms.daysUntilNext); // 10 (다음 절기까지 남은 일)
+
+// 절기 시작 날짜
+console.log(saju.solarTerms.currentDate);   // { year: 2024, month: 1, day: 6, ... }
+console.log(saju.solarTerms.nextDate);      // { year: 2024, month: 1, day: 20, ... }
+```
+
+### 십신 및 오행 분석
+
+```typescript
+import { analyzeTenGods, countElements } from "@gracefullight/saju";
+
+const tenGods = analyzeTenGods("己卯", "丙子", "辛巳", "戊戌");
+console.log(tenGods.dayMaster); // "辛"
+
+const elements = countElements(tenGods);
+console.log(elements); // { wood: 1, fire: 1, earth: 3, metal: 1, water: 2 }
+```
+
+### 신강약 및 용신 분석
+
+```typescript
+import { analyzeStrength, analyzeYongShen, getElementRecommendations } from "@gracefullight/saju";
+
+const strength = analyzeStrength("己卯", "丙子", "辛巳", "戊戌");
+console.log(strength.level); // "신약"
+
+const yongShen = analyzeYongShen("己卯", "丙子", "辛巳", "戊戌");
+console.log(yongShen.primary); // 용신 오행 (예: "earth")
+
+const tips = getElementRecommendations(yongShen);
+console.log(tips.colors); // 행운의 색상
+```
+
+### 합충형파해 분석
+
+```typescript
+import { analyzeRelations } from "@gracefullight/saju";
+
+const relations = analyzeRelations("己卯", "丙子", "辛巳", "戊戌");
+relations.clashes.forEach(c => {
+  console.log(`${c.positions[0]}-${c.positions[1]} 지지 충: ${c.pair[0]}-${c.pair[1]}`);
+});
+```
+
 ### 다양한 타임존에서 계산
 
 ```typescript
@@ -606,7 +824,15 @@ packages/saju/
 │   │   ├── luxon.ts        # Luxon 어댑터
 │   │   └── date-fns.ts     # date-fns 어댑터
 │   ├── core/               # 핵심 계산 로직
-│   │   └── four-pillars.ts # 메인 알고리즘
+│   │   ├── four-pillars.ts # 사주 팔자 계산
+│   │   ├── ten-gods.ts     # 십신 분석
+│   │   ├── strength.ts     # 신강/신약 판정
+│   │   ├── relations.ts    # 합충형파해 분석
+│   │   ├── luck.ts         # 대운/세운 계산
+│   │   ├── yongshen.ts     # 용신 추출
+│   │   ├── solar-terms.ts  # 절기 계산
+│   │   └── lunar.ts        # 음력 변환
+│   ├── types/              # 타입 정의
 │   ├── __tests__/          # 테스트 스위트
 │   └── index.ts            # 공개 API
 ├── dist/                   # 컴파일된 출력
@@ -723,7 +949,3 @@ MIT © [gracefullight](https://github.com/gracefullight)
 - [문서](https://github.com/gracefullight/saju#readme)
 - [이슈 트래커](https://github.com/gracefullight/saju/issues)
 - [토론](https://github.com/gracefullight/saju/discussions)
-
----
-
-Made by [gracefullight](https://github.com/gracefullight)

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

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

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

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

package/dist/__tests__/luck.test.js

@@ -0,0 +1,33 @@
+import { describe, it, expect } from "vitest";
+import { calculateYearlyLuck, getYearPillar } from "@/core/luck";
+describe("luck", () => {
+    describe("getYearPillar", () => {
+        it("returns correct pillar for 1984 (甲子)", () => {
+            expect(getYearPillar(1984)).toBe("甲子");
+        });
+        it("returns correct pillar for 2024 (甲辰)", () => {
+            expect(getYearPillar(2024)).toBe("甲辰");
+        });
+        it("returns correct pillar for 2000 (庚辰)", () => {
+            expect(getYearPillar(2000)).toBe("庚辰");
+        });
+    });
+    describe("calculateYearlyLuck", () => {
+        it("calculates yearly luck for a range", () => {
+            const result = calculateYearlyLuck(1990, 2020, 2025);
+            expect(result).toHaveLength(6);
+            expect(result[0].year).toBe(2020);
+            expect(result[5].year).toBe(2025);
+        });
+        it("includes correct age calculation", () => {
+            const result = calculateYearlyLuck(1990, 2020, 2020);
+            expect(result[0].age).toBe(31);
+        });
+        it("returns pillar, stem, and branch for each year", () => {
+            const result = calculateYearlyLuck(1990, 2024, 2024);
+            expect(result[0].pillar).toBe("甲辰");
+            expect(result[0].stem).toBe("甲");
+            expect(result[0].branch).toBe("辰");
+        });
+    });
+});

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

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

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

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