mingpan 0.1.1

package/dist/services/bazi/calculators/LiuYueCalculator.js

@@ -0,0 +1,338 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiuYueCalculator = void 0;
+const bazi_1 = require("../../../core/constants/bazi");
+const LuckCycleCalculator_1 = require("./LuckCycleCalculator");
+const solarTerms_1 = require("../../../core/calendar/solarTerms");
+// Extract simple arrays for easier usage
+const STEMS = bazi_1.HEAVENLY_STEMS.map(s => s.name);
+const BRANCHES = bazi_1.EARTHLY_BRANCHES.map(b => b.name);
+// Create stem-element mapping
+const STEM_ELEMENTS = bazi_1.HEAVENLY_STEMS.reduce((acc, stem) => {
+    acc[stem.name] = stem.element;
+    return acc;
+}, {});
+// Create branch-element mapping
+const BRANCH_ELEMENTS = bazi_1.EARTHLY_BRANCHES.reduce((acc, branch) => {
+    acc[branch.name] = branch.element;
+    return acc;
+}, {});
+// Solar term months - each month starts from a specific solar term (節)
+const MONTH_STARTING_SOLAR_TERMS = [
+    '立春', // 寅月
+    '惊蛰', // 卯月
+    '清明', // 辰月
+    '立夏', // 巳月
+    '芒种', // 午月
+    '小暑', // 未月
+    '立秋', // 申月
+    '白露', // 酉月
+    '寒露', // 戌月
+    '立冬', // 亥月
+    '大雪', // 子月
+    '小寒' // 丑月
+];
+/**
+ * Calculator for Liu Yue (流月) - Monthly Fortune Cycles
+ * Provides month-by-month analysis within a Liu Nian year
+ */
+class LiuYueCalculator {
+    luckCalculator;
+    constructor() {
+        this.luckCalculator = new LuckCycleCalculator_1.LuckCycleCalculator();
+    }
+    /**
+     * Calculate all Liu Yue for a specific year
+     */
+    calculateLiuYue(yearStem, yearBranch, dayMasterElement, yongShen, birthDate, currentYear) {
+        const months = [];
+        // Get all solar terms for the year
+        const yearSolarTerms = solarTerms_1.PreciseSolarTermCalculator.calculateYearSolarTerms(currentYear);
+        const nextYearSolarTerms = solarTerms_1.PreciseSolarTermCalculator.calculateYearSolarTerms(currentYear + 1);
+        // Calculate the stem for the first month (寅月)
+        const firstMonthStem = this.calculateFirstMonthStem(yearStem);
+        for (let i = 0; i < 12; i++) {
+            const monthBranch = BRANCHES[(i + 2) % 12]; // Start from 寅
+            const monthStemIndex = (STEMS.indexOf(firstMonthStem) + i) % 10;
+            const monthStem = STEMS[monthStemIndex];
+            // Calculate month dates based on solar terms
+            const { startDate, endDate, solarTermInfo } = this.getMonthDates(currentYear, i, yearSolarTerms, nextYearSolarTerms);
+            // Analyze month fortune
+            const analysis = this.analyzeMonth(monthStem, monthBranch, yearStem, yearBranch, dayMasterElement, yongShen);
+            months.push({
+                month: i + 1,
+                stem: monthStem,
+                branch: monthBranch,
+                startDate,
+                endDate,
+                fortune: analysis.fortune,
+                rating: analysis.rating,
+                mainInfluences: analysis.mainInfluences,
+                opportunities: analysis.opportunities,
+                challenges: analysis.challenges,
+                recommendations: analysis.recommendations,
+                healthFocus: analysis.healthFocus,
+                luckyDays: this.calculateLuckyDays(monthStem, monthBranch, dayMasterElement),
+                solarTerm: solarTermInfo // Store solar term info for display
+            });
+        }
+        return months;
+    }
+    /**
+     * Calculate the stem for the first month based on year stem
+     */
+    calculateFirstMonthStem(yearStem) {
+        const yearStemIndex = STEMS.indexOf(yearStem);
+        const rules = {
+            0: '丙', // 甲年
+            1: '戊', // 乙年
+            2: '庚', // 丙年
+            3: '壬', // 丁年
+            4: '甲', // 戊年
+            5: '丙', // 己年
+            6: '戊', // 庚年
+            7: '庚', // 辛年
+            8: '壬', // 壬年
+            9: '甲' // 癸年
+        };
+        return rules[yearStemIndex];
+    }
+    /**
+     * Get solar calendar dates for a Chinese month based on solar terms
+     */
+    getMonthDates(year, monthIndex, yearSolarTerms, nextYearSolarTerms) {
+        // Each Chinese month starts from a specific solar term (節)
+        const startingSolarTerm = MONTH_STARTING_SOLAR_TERMS[monthIndex];
+        const nextSolarTerm = MONTH_STARTING_SOLAR_TERMS[(monthIndex + 1) % 12];
+        // Find the starting solar term
+        // 注意：八字年从立春开始到次年立春前结束
+        // 丑月（monthIndex=11）的开始节气"小寒"在公历次年1月初，需要从下一年节气表查找
+        let startDate = null;
+        let solarTermInfo;
+        if (monthIndex === 11) {
+            // 丑月（小寒~立春）开始于公历次年1月
+            for (const term of nextYearSolarTerms) {
+                if (term.name === startingSolarTerm) {
+                    startDate = term.date;
+                    solarTermInfo = term;
+                    break;
+                }
+            }
+        }
+        else {
+            for (const term of yearSolarTerms) {
+                if (term.name === startingSolarTerm) {
+                    startDate = term.date;
+                    solarTermInfo = term;
+                    break;
+                }
+            }
+            // If not found in current year (e.g., 立春 might be in previous year)
+            if (!startDate && monthIndex === 0) {
+                const prevYearTerms = solarTerms_1.PreciseSolarTermCalculator.calculateYearSolarTerms(year - 1);
+                for (const term of prevYearTerms) {
+                    if (term.name === startingSolarTerm) {
+                        startDate = term.date;
+                        solarTermInfo = term;
+                        break;
+                    }
+                }
+            }
+        }
+        // Find the ending solar term
+        let endDate = null;
+        // First check current year
+        for (const term of yearSolarTerms) {
+            if (term.name === nextSolarTerm) {
+                // End date should be the moment before the next solar term starts
+                endDate = new Date(term.date.getTime() - 1);
+                break;
+            }
+        }
+        // If not found, or if endDate is before startDate (cross-year case like 子月 or 丑月),
+        // check next year
+        // 例如：子月从大雪(12/7)到小寒(次年1/5)，当年1月的小寒比大雪早，需要用次年的小寒
+        if (!endDate || (startDate && endDate.getTime() <= startDate.getTime())) {
+            for (const term of nextYearSolarTerms) {
+                if (term.name === nextSolarTerm) {
+                    // End date should be the moment before the next solar term starts
+                    endDate = new Date(term.date.getTime() - 1);
+                    break;
+                }
+            }
+        }
+        // Fallback to approximate dates if solar terms not found
+        if (!startDate) {
+            startDate = new Date(year, monthIndex + 1, 1);
+        }
+        if (!endDate) {
+            endDate = new Date(year, monthIndex + 2, 0);
+        }
+        return { startDate, endDate, solarTermInfo };
+    }
+    /**
+     * Analyze month fortune
+     */
+    analyzeMonth(monthStem, monthBranch, yearStem, yearBranch, dayMasterElement, yongShen) {
+        const monthElement = STEM_ELEMENTS[monthStem];
+        const monthBranchElement = BRANCH_ELEMENTS[monthBranch];
+        // Calculate fortune rating based on element compatibility
+        let rating = 50; // Base rating
+        // YongShen bonus
+        if (yongShen.includes(monthElement)) {
+            rating += 30;
+        }
+        // Element cycle bonus/penalty
+        const elementCycle = {
+            '木': '火', // Wood generates Fire
+            '火': '土', // Fire generates Earth
+            '土': '金', // Earth generates Metal
+            '金': '水', // Metal generates Water
+            '水': '木' // Water generates Wood
+        };
+        const elementControl = {
+            '木': '土', // Wood controls Earth
+            '土': '水', // Earth controls Water
+            '水': '火', // Water controls Fire
+            '火': '金', // Fire controls Metal
+            '金': '木' // Metal controls Wood
+        };
+        if (elementCycle[dayMasterElement] === monthElement) {
+            rating += 10; // Month supports day master
+        }
+        else if (elementCycle[monthElement] === dayMasterElement) {
+            rating += 15; // Day master receives support
+        }
+        else if (elementControl[monthElement] === dayMasterElement) {
+            rating -= 20; // Day master is controlled
+        }
+        else if (elementControl[dayMasterElement] === monthElement) {
+            rating += 5; // Day master controls month
+        }
+        // Ensure rating is within bounds
+        rating = Math.max(0, Math.min(100, rating));
+        // Analyze influences
+        const mainInfluences = [];
+        const opportunities = [];
+        const challenges = [];
+        const recommendations = [];
+        const healthFocus = [];
+        // Month-Year interaction
+        if (this.isHarmony(monthStem, yearStem)) {
+            mainInfluences.push('month_year_harmony');
+            opportunities.push('smooth_progress');
+        }
+        if (this.isClash(monthBranch, yearBranch)) {
+            mainInfluences.push('month_year_clash');
+            challenges.push('potential_conflicts');
+        }
+        // YongShen support
+        if (yongShen.includes(monthElement)) {
+            opportunities.push('yongshen_support');
+            recommendations.push('seize_opportunities');
+        }
+        else if (this.isUnfavorable(monthElement, yongShen)) {
+            challenges.push('unfavorable_element');
+            recommendations.push('stay_cautious');
+        }
+        // Health focus based on element
+        healthFocus.push(...this.getHealthFocus(monthElement));
+        // Fortune description
+        const fortune = this.getFortuneDescription(rating);
+        return {
+            fortune,
+            rating,
+            mainInfluences,
+            opportunities,
+            challenges,
+            recommendations,
+            healthFocus
+        };
+    }
+    /**
+     * Calculate lucky days within a month
+     */
+    calculateLuckyDays(monthStem, monthBranch, dayMasterElement) {
+        const luckyDays = [];
+        const monthElement = STEM_ELEMENTS[monthStem];
+        // Simplified lucky day calculation
+        // In production, calculate based on daily stems and branches
+        for (let day = 1; day <= 30; day++) {
+            if ((day % 6) === (STEMS.indexOf(monthStem) % 6)) {
+                luckyDays.push(day);
+            }
+        }
+        return luckyDays.slice(0, 5); // Return top 5 lucky days
+    }
+    /**
+     * Check if two stems are in harmony
+     */
+    isHarmony(stem1, stem2) {
+        const harmonies = {
+            '甲': '己', '己': '甲',
+            '乙': '庚', '庚': '乙',
+            '丙': '辛', '辛': '丙',
+            '丁': '壬', '壬': '丁',
+            '戊': '癸', '癸': '戊'
+        };
+        return harmonies[stem1] === stem2;
+    }
+    /**
+     * Check if two branches clash
+     */
+    isClash(branch1, branch2) {
+        const clashes = {
+            '子': '午', '午': '子',
+            '丑': '未', '未': '丑',
+            '寅': '申', '申': '寅',
+            '卯': '酉', '酉': '卯',
+            '辰': '戌', '戌': '辰',
+            '巳': '亥', '亥': '巳'
+        };
+        return clashes[branch1] === branch2;
+    }
+    /**
+     * Check if element is unfavorable
+     */
+    isUnfavorable(element, yongShen) {
+        const unfavorableMap = {
+            '木': ['金'],
+            '火': ['水'],
+            '土': ['木'],
+            '金': ['火'],
+            '水': ['土']
+        };
+        return yongShen.some(ys => unfavorableMap[ys]?.includes(element));
+    }
+    /**
+     * Get health focus areas based on element
+     */
+    getHealthFocus(element) {
+        const healthMap = {
+            '木': ['liver_health', 'eye_care', 'emotional_balance'],
+            '火': ['heart_health', 'blood_circulation', 'sleep_quality'],
+            '土': ['digestive_health', 'immune_system', 'grounding'],
+            '金': ['respiratory_health', 'skin_care', 'detoxification'],
+            '水': ['kidney_health', 'bone_strength', 'hydration']
+        };
+        return healthMap[element] || [];
+    }
+    /**
+     * Get fortune description based on rating
+     */
+    getFortuneDescription(rating) {
+        if (rating >= 85)
+            return '优秀';
+        if (rating >= 70)
+            return 'very_good';
+        if (rating >= 55)
+            return '良好';
+        if (rating >= 40)
+            return '一般';
+        if (rating >= 25)
+            return '挑战';
+        return '困难';
+    }
+}
+exports.LiuYueCalculator = LiuYueCalculator;
+//# sourceMappingURL=LiuYueCalculator.js.map

package/dist/services/bazi/calculators/LiuYueCalculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiuYueCalculator.js","sourceRoot":"","sources":["../../../../src/services/bazi/calculators/LiuYueCalculator.ts"],"names":[],"mappings":"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"}

package/dist/services/bazi/calculators/LuckCycleCalculator.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Luck Cycle Calculator
+ * Implements taro-bazi's complete luck cycle system
+ * Handles DaYun (大運), LiuNian (流年), LiuYue (流月), and LiuRi (流日)
+ */
+import { BaziChart, Gender } from '../types';
+export interface LuckSequence {
+    direction: 'forward' | 'backward';
+    startAge: number;
+    startDate: Date;
+    detailedStartTime?: {
+        years: number;
+        months: number;
+        days: number;
+        hours: number;
+    };
+    deliveryYears?: string[];
+    deliveryTiming?: string;
+}
+export interface DaYunPeriod {
+    index: number;
+    startAge: number;
+    endAge: number;
+    stemBranch: {
+        stem: string;
+        branch: string;
+    };
+    element: string;
+    yinYang: 'yin' | 'yang';
+    voidBranches?: string[];
+}
+export interface LiuNianYear {
+    year: number;
+    age: number;
+    stemBranch: {
+        stem: string;
+        branch: string;
+    };
+    element: string;
+    yinYang: 'yin' | 'yang';
+}
+export interface LiuYueMonth {
+    year: number;
+    month: number;
+    stemBranch: {
+        stem: string;
+        branch: string;
+    };
+    element: string;
+}
+export interface LiuRiDay {
+    date: Date;
+    stemBranch: {
+        stem: string;
+        branch: string;
+    };
+    element: string;
+}
+export declare class LuckCycleCalculator {
+    /**
+     * Calculate delivery stems based on birth year stem
+     * Returns the stems of years when DaYun changes
+     */
+    private static calculateDeliveryStems;
+    /**
+     * Calculate delivery timing based on solar term
+     * This should calculate the exact days after the solar term for delivery
+     */
+    private static calculateDeliveryTiming;
+    /**
+     * Calculate void branches (空亡) for a stem-branch combination
+     */
+    static calculateVoidBranches(stem: string, branch: string): string[];
+    /**
+     * Calculate luck sequence direction based on gender and year stem
+     * Male + Yang year OR Female + Yin year = Forward
+     * Male + Yin year OR Female + Yang year = Backward
+     */
+    static calLuckySequence(gender: Gender, yearStem: string): 'forward' | 'backward';
+    /**
+     * Calculate the starting age and date for luck cycles
+     * Based on distance to nearest solar term (forward or backward)
+     */
+    static calLuckyAge(birthDate: Date, gender: Gender, yearStem: string): LuckSequence;
+    /**
+     * Calculate complete list of 10-year luck pillars (大運)
+     * Usually calculates 8-10 periods covering 80-100 years
+     */
+    static calLuckyList(chart: BaziChart, gender: Gender, birthDate: Date, numberOfPeriods?: number): DaYunPeriod[];
+    /**
+     * Calculate fleeting year list (流年)
+     * Returns yearly pillars for specified years
+     */
+    static calFleetingYearList(birthYear: number, years: number[]): LiuNianYear[];
+    /**
+     * Calculate fleeting month list (流月)
+     * Returns monthly pillars for a specific year
+     */
+    static calFleetingMonthList(year: number): LiuYueMonth[];
+    /**
+     * Calculate fleeting day list (流日)
+     * Returns daily pillars for a specific month
+     */
+    static calFleetingDayList(year: number, month: number): LiuRiDay[];
+    /**
+     * Get current DaYun period for a specific age
+     */
+    static getCurrentDaYun(daYunList: DaYunPeriod[], age: number): DaYunPeriod | null;
+    /**
+     * Get current LiuNian for a specific year
+     */
+    static getCurrentLiuNian(birthYear: number, currentYear: number): LiuNianYear;
+    /**
+     * Calculate interaction between DaYun and LiuNian
+     * Returns analysis of their combined influence
+     */
+    static analyzeDaYunLiuNian(daYun: DaYunPeriod, liuNian: LiuNianYear): {
+        stemRelation: string;
+        branchRelation: string;
+        elementalBalance: string;
+    };
+}
+//# sourceMappingURL=LuckCycleCalculator.d.ts.map

package/dist/services/bazi/calculators/LuckCycleCalculator.d.ts.map

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