mingpan 0.1.1 → 0.1.2

package/dist/services/liuyao/types.d.ts

@@ -0,0 +1,154 @@
+/**
+ * 六爻服務類型定義
+ *
+ * 設計原則：
+ * - 排盤層：MCP 負責，輸出確定性結構
+ * - 斷卦層：交給 Agent/LLM
+ * - v1 只支持手動輸入爻值（確定性優先）
+ */
+/** 爻值：6=老陰(動), 7=少陽(靜), 8=少陰(靜), 9=老陽(動) */
+export type YaoValue = 6 | 7 | 8 | 9;
+/** 爻的陰陽 */
+export type YinYang = '陽' | '陰';
+/** 五行 */
+export type WuXing = '金' | '木' | '水' | '火' | '土';
+/** 六親 */
+export type LiuQin = '父母' | '兄弟' | '子孫' | '妻財' | '官鬼';
+/** 六神 */
+export type LiuShen = '青龍' | '朱雀' | '勾陳' | '螣蛇' | '白虎' | '玄武';
+/** 飛伏關係 */
+export type FeiShenRelation = '飛生伏' | '飛克伏' | '伏生飛' | '伏克飛' | '比和';
+/** 進退神類型 */
+export type JinTuiShenType = '進神' | '退神' | null;
+/** 旺衰狀態 */
+export type WangShuaiState = '旺' | '相' | '休' | '囚' | '死';
+/** 天干 */
+export type TianGan = '甲' | '乙' | '丙' | '丁' | '戊' | '己' | '庚' | '辛' | '壬' | '癸';
+/** 地支 */
+export type DiZhi = '子' | '丑' | '寅' | '卯' | '辰' | '巳' | '午' | '未' | '申' | '酉' | '戌' | '亥';
+/** 八卦 */
+export type BaGua = '乾' | '兌' | '離' | '震' | '巽' | '坎' | '艮' | '坤';
+export interface LiuyaoInput {
+    /** 六個爻值（自下而上，初爻到上爻） */
+    yaoValues: [YaoValue, YaoValue, YaoValue, YaoValue, YaoValue, YaoValue];
+    /** 起卦時間（用於六神、旬空計算） */
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    /** 是否為農曆輸入，默認 false */
+    isLunar?: boolean;
+}
+export interface YaoInfo {
+    /** 爻位（1-6，自下而上） */
+    position: number;
+    /** 原始爻值 */
+    value: YaoValue;
+    /** 本卦陰陽 */
+    yinYang: YinYang;
+    /** 是否為動爻 */
+    isMoving: boolean;
+    /** 變卦陰陽（動爻才有） */
+    changedYinYang?: YinYang;
+    /** 納甲地支 */
+    naJia: DiZhi;
+    /** 納甲五行 */
+    naJiaWuXing: WuXing;
+    /** 變爻納甲地支（動爻才有） */
+    changedNaJia?: DiZhi;
+    /** 六親 */
+    liuQin: LiuQin;
+    /** 六神 */
+    liuShen: LiuShen;
+    /** 是否為世爻 */
+    isShiYao: boolean;
+    /** 是否為應爻 */
+    isYingYao: boolean;
+    /** 進退神（動爻才有） */
+    jinTuiShen?: JinTuiShenType;
+    /** 月建旺衰 */
+    wangShuaiByMonth?: WangShuaiState;
+    /** 日辰旺衰 */
+    wangShuaiByDay?: WangShuaiState;
+}
+export interface GuaInfo {
+    /** 卦名 */
+    name: string;
+    /** 上卦（外卦） */
+    upperGua: BaGua;
+    /** 下卦（內卦） */
+    lowerGua: BaGua;
+    /** 所屬卦宮 */
+    gong: BaGua;
+    /** 卦宮五行 */
+    gongWuXing: WuXing;
+    /** 世爻位置（1-6） */
+    shiYaoPosition: number;
+    /** 應爻位置（1-6） */
+    yingYaoPosition: number;
+    /** 卦序（在八宮中的位置：1-8） */
+    guaXu: number;
+    /** 是否為遊魂卦 */
+    isYouHun: boolean;
+    /** 是否為歸魂卦 */
+    isGuiHun: boolean;
+}
+export interface TimeInfo {
+    /** 公曆日期字符串 */
+    solarDate: string;
+    /** 農曆日期字符串 */
+    lunarDate: string;
+    /** 年干支 */
+    yearGanZhi: string;
+    /** 月干支（節氣月） */
+    monthGanZhi: string;
+    /** 日干支 */
+    dayGanZhi: string;
+    /** 時干支 */
+    hourGanZhi: string;
+    /** 日干 */
+    dayStem: TianGan;
+    /** 月建（地支） */
+    monthBranch: DiZhi;
+    /** 旬空（兩個地支） */
+    xunKong: [DiZhi, DiZhi];
+}
+export interface FuShenInfo {
+    /** 伏神六親 */
+    liuQin: LiuQin;
+    /** 伏神地支 */
+    diZhi: DiZhi;
+    /** 伏神五行 */
+    wuXing: WuXing;
+    /** 伏神所在爻位（1-6） */
+    position: number;
+    /** 飛神地支（該爻位的本卦納甲） */
+    feiShenDiZhi: DiZhi;
+    /** 飛神五行 */
+    feiShenWuXing: WuXing;
+    /** 飛伏關係 */
+    relation: FeiShenRelation;
+    /** 伏神月建旺衰 */
+    wangShuaiByMonth?: WangShuaiState;
+    /** 伏神日辰旺衰 */
+    wangShuaiByDay?: WangShuaiState;
+}
+export interface LiuyaoResult {
+    /** 時間信息 */
+    timeInfo: TimeInfo;
+    /** 本卦信息 */
+    benGua: GuaInfo;
+    /** 變卦信息（有動爻時才有） */
+    bianGua?: GuaInfo;
+    /** 六爻詳細信息（自下而上） */
+    yaoList: YaoInfo[];
+    /** 動爻位置列表（1-6） */
+    movingYaoPositions: number[];
+    /** 伏神列表（卦中缺失的六親） */
+    fuShenList: FuShenInfo[];
+}
+export interface LiuyaoServiceConfig {
+    /** 是否啟用調試模式 */
+    debug?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/liuyao/types.d.ts.map

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

package/dist/services/liuyao/types.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * 六爻服務類型定義
+ *
+ * 設計原則：
+ * - 排盤層：MCP 負責，輸出確定性結構
+ * - 斷卦層：交給 Agent/LLM
+ * - v1 只支持手動輸入爻值（確定性優先）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/services/liuyao/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/liuyao/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/dist/services/meihua/MeihuaService.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 梅花易數服務主類
+ *
+ * 提供統一的梅花易數排盤接口
+ *
+ * 設計原則：
+ * - 排盤層：輸出確定性結構
+ * - 斷卦層：交給 Agent/LLM
+ */
+import { MeihuaInput, MeihuaResult, MeihuaServiceConfig } from './types';
+export declare class MeihuaService {
+    private config;
+    constructor(config?: MeihuaServiceConfig);
+    /**
+     * 計算梅花易數排盤
+     */
+    calculate(input: MeihuaInput): MeihuaResult;
+    /**
+     * 時間起卦
+     */
+    private calculateByTime;
+    /**
+     * 數字起卦
+     */
+    private calculateByNumber;
+    /**
+     * 根據卦名獲取先天數
+     */
+    private getBaGuaNumberByName;
+}
+export declare const meihuaService: MeihuaService;
+//# sourceMappingURL=MeihuaService.d.ts.map

package/dist/services/meihua/MeihuaService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MeihuaService.d.ts","sourceRoot":"","sources":["../../../src/services/meihua/MeihuaService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,WAAW,EACX,YAAY,EACZ,mBAAmB,EAGpB,MAAM,SAAS,CAAC;AAQjB,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,GAAE,mBAAwB;IAO5C;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY;IAQ3C;;OAEG;IACH,OAAO,CAAC,eAAe;IAyGvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoFzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAO7B;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/services/meihua/MeihuaService.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * 梅花易數服務主類
+ *
+ * 提供統一的梅花易數排盤接口
+ *
+ * 設計原則：
+ * - 排盤層：輸出確定性結構
+ * - 斷卦層：交給 Agent/LLM
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.meihuaService = exports.MeihuaService = void 0;
+const lunar_javascript_1 = require("lunar-javascript");
+const QiguaCalculator_1 = require("./calculators/QiguaCalculator");
+const HuguaCalculator_1 = require("./calculators/HuguaCalculator");
+const BianguaCalculator_1 = require("./calculators/BianguaCalculator");
+const TiyongCalculator_1 = require("./calculators/TiyongCalculator");
+const bagua_1 = require("./data/bagua");
+const timeNormalization_1 = require("../../utils/timeNormalization");
+class MeihuaService {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            debug: false,
+            ...config,
+        };
+    }
+    /**
+     * 計算梅花易數排盤
+     */
+    calculate(input) {
+        if (input.method === 'time') {
+            return this.calculateByTime(input);
+        }
+        else {
+            return this.calculateByNumber(input);
+        }
+    }
+    /**
+     * 時間起卦
+     */
+    calculateByTime(input) {
+        const { year, month, day, hour, isLunar } = input;
+        if (!year || !month || !day || hour === undefined) {
+            throw new Error('時間起卦需要提供完整的年月日時');
+        }
+        // 處理時間（農曆轉公曆用於顯示）
+        const normalizedTime = (0, timeNormalization_1.normalizeBirthDateTime)({
+            year,
+            month,
+            day,
+            hour,
+            isLunar,
+        });
+        // 起卦計算（內部使用農曆）
+        const { qiGuaData, timeDetail, lunar } = QiguaCalculator_1.QiguaCalculator.fromTime(year, month, day, hour, isLunar);
+        // 獲取上下卦
+        const upperGuaInfo = (0, bagua_1.getBaGuaByNumber)(qiGuaData.upperGuaIndex);
+        const lowerGuaInfo = (0, bagua_1.getBaGuaByNumber)(qiGuaData.lowerGuaIndex);
+        // 構建本卦
+        const benGua = {
+            name: (0, bagua_1.getGua64Name)(upperGuaInfo.name, lowerGuaInfo.name),
+            upperGua: upperGuaInfo,
+            lowerGua: lowerGuaInfo,
+        };
+        // 計算變卦
+        const bianGuaResult = BianguaCalculator_1.BianguaCalculator.calculate(upperGuaInfo.name, lowerGuaInfo.name, qiGuaData.movingYao);
+        const bianUpperInfo = (0, bagua_1.getBaGuaByNumber)(this.getBaGuaNumberByName(bianGuaResult.upper));
+        const bianLowerInfo = (0, bagua_1.getBaGuaByNumber)(this.getBaGuaNumberByName(bianGuaResult.lower));
+        const bianGua = {
+            name: (0, bagua_1.getGua64Name)(bianGuaResult.upper, bianGuaResult.lower),
+            upperGua: bianUpperInfo,
+            lowerGua: bianLowerInfo,
+        };
+        // 計算互卦
+        const huGuaResult = HuguaCalculator_1.HuguaCalculator.calculate(upperGuaInfo.name, lowerGuaInfo.name);
+        const huUpperInfo = (0, bagua_1.getBaGuaByNumber)(this.getBaGuaNumberByName(huGuaResult.upper));
+        const huLowerInfo = (0, bagua_1.getBaGuaByNumber)(this.getBaGuaNumberByName(huGuaResult.lower));
+        const huGua = {
+            name: (0, bagua_1.getGua64Name)(huGuaResult.upper, huGuaResult.lower),
+            upperGua: huUpperInfo,
+            lowerGua: huLowerInfo,
+        };
+        // 計算體用
+        const tiYong = TiyongCalculator_1.TiyongCalculator.calculate(upperGuaInfo.wuXing, lowerGuaInfo.wuXing, qiGuaData.movingYao);
+        // 時間信息
+        const solar = lunar_javascript_1.Solar.fromYmdHms(normalizedTime.year, normalizedTime.month, normalizedTime.day, normalizedTime.hour, 0, 0);
+        return {
+            method: 'time',
+            qiGuaData,
+            timeDetail,
+            timeInfo: {
+                solarDate: `${normalizedTime.year}年${normalizedTime.month}月${normalizedTime.day}日`,
+                lunarDate: lunar.toString(),
+                yearGanZhi: `${lunar.getYearGan()}${lunar.getYearZhi()}`,
+            },
+            benGua,
+            bianGua,
+            huGua,
+            movingYao: qiGuaData.movingYao,
+            tiYong,
+        };
+    }
+    /**
+     * 數字起卦
+     */
+    calculateByNumber(input) {
+        const { upperNumber, lowerNumber, yaoNumber } = input;
+        if (!upperNumber || !lowerNumber) {
+            throw new Error('數字起卦需要提供上卦數和下卦數');
+        }
+        // 起卦計算
+        const qiGuaData = QiguaCalculator_1.QiguaCalculator.fromNumber(upperNumber, lowerNumber, yaoNumber);
+        // 獲取上下卦
+        const upperGuaInfo = (0, bagua_1.getBaGuaByNumber)(qiGuaData.upperGuaIndex);
+        const lowerGuaInfo = (0, bagua_1.getBaGuaByNumber)(qiGuaData.lowerGuaIndex);
+        // 構建本卦
+        const benGua = {
+            name: (0, bagua_1.getGua64Name)(upperGuaInfo.name, lowerGuaInfo.name),
+            upperGua: upperGuaInfo,
+            lowerGua: lowerGuaInfo,
+        };
+        // 計算變卦
+        const bianGuaResult = BianguaCalculator_1.BianguaCalculator.calculate(upperGuaInfo.name, lowerGuaInfo.name, qiGuaData.movingYao);
+        const bianUpperInfo = (0, bagua_1.getBaGuaByNumber)(this.getBaGuaNumberByName(bianGuaResult.upper));
+        const bianLowerInfo = (0, bagua_1.getBaGuaByNumber)(this.getBaGuaNumberByName(bianGuaResult.lower));
+        const bianGua = {
+            name: (0, bagua_1.getGua64Name)(bianGuaResult.upper, bianGuaResult.lower),
+            upperGua: bianUpperInfo,
+            lowerGua: bianLowerInfo,
+        };
+        // 計算互卦
+        const huGuaResult = HuguaCalculator_1.HuguaCalculator.calculate(upperGuaInfo.name, lowerGuaInfo.name);
+        const huUpperInfo = (0, bagua_1.getBaGuaByNumber)(this.getBaGuaNumberByName(huGuaResult.upper));
+        const huLowerInfo = (0, bagua_1.getBaGuaByNumber)(this.getBaGuaNumberByName(huGuaResult.lower));
+        const huGua = {
+            name: (0, bagua_1.getGua64Name)(huGuaResult.upper, huGuaResult.lower),
+            upperGua: huUpperInfo,
+            lowerGua: huLowerInfo,
+        };
+        // 計算體用
+        const tiYong = TiyongCalculator_1.TiyongCalculator.calculate(upperGuaInfo.wuXing, lowerGuaInfo.wuXing, qiGuaData.movingYao);
+        // 當前時間作為記錄
+        const now = new Date();
+        const solar = lunar_javascript_1.Solar.fromDate(now);
+        const lunar = solar.getLunar();
+        return {
+            method: 'number',
+            qiGuaData,
+            timeInfo: {
+                solarDate: `${solar.getYear()}年${solar.getMonth()}月${solar.getDay()}日`,
+                lunarDate: lunar.toString(),
+                yearGanZhi: `${lunar.getYearGan()}${lunar.getYearZhi()}`,
+            },
+            benGua,
+            bianGua,
+            huGua,
+            movingYao: qiGuaData.movingYao,
+            tiYong,
+        };
+    }
+    /**
+     * 根據卦名獲取先天數
+     */
+    getBaGuaNumberByName(name) {
+        const map = {
+            '乾': 1, '兌': 2, '離': 3, '震': 4,
+            '巽': 5, '坎': 6, '艮': 7, '坤': 8,
+        };
+        return map[name];
+    }
+}
+exports.MeihuaService = MeihuaService;
+// 導出單例
+exports.meihuaService = new MeihuaService();
+//# sourceMappingURL=MeihuaService.js.map

package/dist/services/meihua/MeihuaService.js.map

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

package/dist/services/meihua/calculators/BianguaCalculator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 變卦計算器
+ *
+ * 變卦：動爻陰陽反轉
+ */
+import { BaGuaName } from '../types';
+export declare class BianguaCalculator {
+    /**
+     * 計算變卦
+     *
+     * @param upperGua 上卦
+     * @param lowerGua 下卦
+     * @param movingYao 動爻位置（1-6，自下而上）
+     * @returns 變卦的上下卦
+     */
+    static calculate(upperGua: BaGuaName, lowerGua: BaGuaName, movingYao: number): {
+        upper: BaGuaName;
+        lower: BaGuaName;
+    };
+}
+//# sourceMappingURL=BianguaCalculator.d.ts.map

package/dist/services/meihua/calculators/BianguaCalculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BianguaCalculator.d.ts","sourceRoot":"","sources":["../../../../src/services/meihua/calculators/BianguaCalculator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrC,qBAAa,iBAAiB;IAC5B;;;;;;;OAOG;IACH,MAAM,CAAC,SAAS,CACd,QAAQ,EAAE,SAAS,EACnB,QAAQ,EAAE,SAAS,EACnB,SAAS,EAAE,MAAM,GAChB;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE;CA6B1C"}

package/dist/services/meihua/calculators/BianguaCalculator.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * 變卦計算器
+ *
+ * 變卦：動爻陰陽反轉
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BianguaCalculator = void 0;
+const bagua_1 = require("../data/bagua");
+class BianguaCalculator {
+    /**
+     * 計算變卦
+     *
+     * @param upperGua 上卦
+     * @param lowerGua 下卦
+     * @param movingYao 動爻位置（1-6，自下而上）
+     * @returns 變卦的上下卦
+     */
+    static calculate(upperGua, lowerGua, movingYao) {
+        // 獲取六爻的陰陽
+        const lowerBits = [...bagua_1.BAGUA_BINARY[lowerGua]];
+        const upperBits = [...bagua_1.BAGUA_BINARY[upperGua]];
+        // 組合成六爻數組
+        const sixYao = [...lowerBits, ...upperBits];
+        // 動爻反轉（movingYao 是 1-6，索引是 0-5）
+        const yaoIndex = movingYao - 1;
+        sixYao[yaoIndex] = !sixYao[yaoIndex];
+        // 拆分回上下卦
+        const newLowerBits = [
+            sixYao[0],
+            sixYao[1],
+            sixYao[2],
+        ];
+        const newUpperBits = [
+            sixYao[3],
+            sixYao[4],
+            sixYao[5],
+        ];
+        return {
+            upper: (0, bagua_1.binaryToBaGua)(newUpperBits),
+            lower: (0, bagua_1.binaryToBaGua)(newLowerBits),
+        };
+    }
+}
+exports.BianguaCalculator = BianguaCalculator;
+//# sourceMappingURL=BianguaCalculator.js.map

package/dist/services/meihua/calculators/BianguaCalculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BianguaCalculator.js","sourceRoot":"","sources":["../../../../src/services/meihua/calculators/BianguaCalculator.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAGH,yCAA4D;AAE5D,MAAa,iBAAiB;IAC5B;;;;;;;OAOG;IACH,MAAM,CAAC,SAAS,CACd,QAAmB,EACnB,QAAmB,EACnB,SAAiB;QAEjB,UAAU;QACV,MAAM,SAAS,GAAG,CAAC,GAAG,oBAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,CAAC,GAAG,oBAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;QAE9C,UAAU;QACV,MAAM,MAAM,GAAc,CAAC,GAAG,SAAS,EAAE,GAAG,SAAS,CAAC,CAAC;QAEvD,gCAAgC;QAChC,MAAM,QAAQ,GAAG,SAAS,GAAG,CAAC,CAAC;QAC/B,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAErC,SAAS;QACT,MAAM,YAAY,GAAgC;YAChD,MAAM,CAAC,CAAC,CAAC;YACT,MAAM,CAAC,CAAC,CAAC;YACT,MAAM,CAAC,CAAC,CAAC;SACV,CAAC;QACF,MAAM,YAAY,GAAgC;YAChD,MAAM,CAAC,CAAC,CAAC;YACT,MAAM,CAAC,CAAC,CAAC;YACT,MAAM,CAAC,CAAC,CAAC;SACV,CAAC;QAEF,OAAO;YACL,KAAK,EAAE,IAAA,qBAAa,EAAC,YAAY,CAAC;YAClC,KAAK,EAAE,IAAA,qBAAa,EAAC,YAAY,CAAC;SACnC,CAAC;IACJ,CAAC;CACF;AA1CD,8CA0CC"}

package/dist/services/meihua/calculators/HuguaCalculator.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 互卦計算器
+ *
+ * 互卦取法：
+ * - 下卦：本卦 2、3、4 爻（自下而上）
+ * - 上卦：本卦 3、4、5 爻（自下而上）
+ */
+import { BaGuaName } from '../types';
+export declare class HuguaCalculator {
+    /**
+     * 計算互卦
+     *
+     * @param upperGua 上卦
+     * @param lowerGua 下卦
+     * @returns 互卦的上下卦
+     */
+    static calculate(upperGua: BaGuaName, lowerGua: BaGuaName): {
+        upper: BaGuaName;
+        lower: BaGuaName;
+    };
+}
+//# sourceMappingURL=HuguaCalculator.d.ts.map

package/dist/services/meihua/calculators/HuguaCalculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HuguaCalculator.d.ts","sourceRoot":"","sources":["../../../../src/services/meihua/calculators/HuguaCalculator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrC,qBAAa,eAAe;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,GAAG;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE;CA4BnG"}

package/dist/services/meihua/calculators/HuguaCalculator.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * 互卦計算器
+ *
+ * 互卦取法：
+ * - 下卦：本卦 2、3、4 爻（自下而上）
+ * - 上卦：本卦 3、4、5 爻（自下而上）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HuguaCalculator = void 0;
+const bagua_1 = require("../data/bagua");
+class HuguaCalculator {
+    /**
+     * 計算互卦
+     *
+     * @param upperGua 上卦
+     * @param lowerGua 下卦
+     * @returns 互卦的上下卦
+     */
+    static calculate(upperGua, lowerGua) {
+        // 獲取六爻的陰陽（自下而上：1-6 爻）
+        const lowerBits = bagua_1.BAGUA_BINARY[lowerGua]; // [1爻, 2爻, 3爻]
+        const upperBits = bagua_1.BAGUA_BINARY[upperGua]; // [4爻, 5爻, 6爻]
+        // 組合成六爻數組
+        const sixYao = [...lowerBits, ...upperBits];
+        // sixYao[0] = 初爻, sixYao[1] = 二爻, ..., sixYao[5] = 上爻
+        // 互卦下卦：2、3、4 爻（索引 1、2、3）
+        const huLowerBits = [
+            sixYao[1], // 二爻
+            sixYao[2], // 三爻
+            sixYao[3], // 四爻
+        ];
+        // 互卦上卦：3、4、5 爻（索引 2、3、4）
+        const huUpperBits = [
+            sixYao[2], // 三爻
+            sixYao[3], // 四爻
+            sixYao[4], // 五爻
+        ];
+        return {
+            upper: (0, bagua_1.binaryToBaGua)(huUpperBits),
+            lower: (0, bagua_1.binaryToBaGua)(huLowerBits),
+        };
+    }
+}
+exports.HuguaCalculator = HuguaCalculator;
+//# sourceMappingURL=HuguaCalculator.js.map

package/dist/services/meihua/calculators/HuguaCalculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HuguaCalculator.js","sourceRoot":"","sources":["../../../../src/services/meihua/calculators/HuguaCalculator.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAGH,yCAA4D;AAE5D,MAAa,eAAe;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,QAAmB,EAAE,QAAmB;QACvD,sBAAsB;QACtB,MAAM,SAAS,GAAG,oBAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe;QACzD,MAAM,SAAS,GAAG,oBAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe;QAEzD,UAAU;QACV,MAAM,MAAM,GAAc,CAAC,GAAG,SAAS,EAAE,GAAG,SAAS,CAAC,CAAC;QACvD,sDAAsD;QAEtD,yBAAyB;QACzB,MAAM,WAAW,GAAgC;YAC/C,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK;YAChB,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK;YAChB,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK;SACjB,CAAC;QAEF,yBAAyB;QACzB,MAAM,WAAW,GAAgC;YAC/C,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK;YAChB,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK;YAChB,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK;SACjB,CAAC;QAEF,OAAO;YACL,KAAK,EAAE,IAAA,qBAAa,EAAC,WAAW,CAAC;YACjC,KAAK,EAAE,IAAA,qBAAa,EAAC,WAAW,CAAC;SAClC,CAAC;IACJ,CAAC;CACF;AApCD,0CAoCC"}

package/dist/services/meihua/calculators/QiguaCalculator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 起卦計算器
+ *
+ * 支持：
+ * - 時間起卦（農曆年月日時）
+ * - 數字起卦（兩數/三數）
+ */
+import { Lunar } from 'lunar-javascript';
+import { QiGuaData, TimeQiGuaDetail } from '../types';
+export declare class QiguaCalculator {
+    /**
+     * 時間起卦
+     *
+     * 算法口徑（農曆）- 標準梅花易數口徑：
+     * - 年數 = 農曆年地支序數（子=1, 丑=2, ..., 亥=12）
+     * - 月數 = 農曆月（1-12，閏月按本月算）
+     * - 日數 = 農曆日（1-30）
+     * - 時數 = 時辰地支序數（子=1, 丑=2, ..., 亥=12）
+     *
+     * - 上卦數 = (年數 + 月數 + 日數) % 8，餘 0 取 8
+     * - 下卦數 = (年數 + 月數 + 日數 + 時數) % 8，餘 0 取 8
+     * - 動爻 = (年數 + 月數 + 日數 + 時數) % 6，餘 0 取 6
+     *
+     * 參考：《梅花易數》原著、shu-var 開源項目
+     */
+    static fromTime(year: number, month: number, day: number, hour: number, isLunar?: boolean): {
+        qiGuaData: QiGuaData;
+        timeDetail: TimeQiGuaDetail;
+        lunar: Lunar;
+    };
+    /**
+     * 數字起卦
+     *
+     * - 上卦 = upperNumber % 8，餘 0 取 8
+     * - 下卦 = lowerNumber % 8，餘 0 取 8
+     * - 動爻 = yaoNumber % 6，餘 0 取 6（默認用 upper + lower）
+     */
+    static fromNumber(upperNumber: number, lowerNumber: number, yaoNumber?: number): QiGuaData;
+}
+//# sourceMappingURL=QiguaCalculator.d.ts.map

package/dist/services/meihua/calculators/QiguaCalculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QiguaCalculator.d.ts","sourceRoot":"","sources":["../../../../src/services/meihua/calculators/QiguaCalculator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAS,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AActD,qBAAa,eAAe;IAC1B;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,QAAQ,CACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,OAAe,GACvB;QAAE,SAAS,EAAE,SAAS,CAAC;QAAC,UAAU,EAAE,eAAe,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE;IAqDtE;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CACf,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,SAAS;CAab"}