mingpan 0.1.1 → 0.1.3

package/dist/services/liuyao/calculators/LiushenCalculator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 六神計算器
+ *
+ * 六神（六獸）按日干起：
+ * - 甲乙日：青龍起初爻
+ * - 丙丁日：朱雀起初爻
+ * - 戊日：勾陳起初爻
+ * - 己日：螣蛇起初爻
+ * - 庚辛日：白虎起初爻
+ * - 壬癸日：玄武起初爻
+ *
+ * 順序：青龍 → 朱雀 → 勾陳 → 螣蛇 → 白虎 → 玄武
+ */
+import { TianGan, LiuShen } from '../types';
+export declare class LiushenCalculator {
+    /**
+     * 計算某爻的六神
+     * @param dayStem 日干
+     * @param position 爻位（1-6，自下而上）
+     */
+    static calculate(dayStem: TianGan, position: number): LiuShen;
+    /**
+     * 計算全卦六爻的六神
+     * @param dayStem 日干
+     * @returns 六爻六神（自下而上）
+     */
+    static calculateAll(dayStem: TianGan): LiuShen[];
+}
+//# sourceMappingURL=LiushenCalculator.d.ts.map

package/dist/services/liuyao/calculators/LiushenCalculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiushenCalculator.d.ts","sourceRoot":"","sources":["../../../../src/services/liuyao/calculators/LiushenCalculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAmB5C,qBAAa,iBAAiB;IAC5B;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAO7D;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE;CAOjD"}

package/dist/services/liuyao/calculators/LiushenCalculator.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * 六神計算器
+ *
+ * 六神（六獸）按日干起：
+ * - 甲乙日：青龍起初爻
+ * - 丙丁日：朱雀起初爻
+ * - 戊日：勾陳起初爻
+ * - 己日：螣蛇起初爻
+ * - 庚辛日：白虎起初爻
+ * - 壬癸日：玄武起初爻
+ *
+ * 順序：青龍 → 朱雀 → 勾陳 → 螣蛇 → 白虎 → 玄武
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiushenCalculator = void 0;
+/** 六神順序 */
+const LIUSHEN_ORDER = ['青龍', '朱雀', '勾陳', '螣蛇', '白虎', '玄武'];
+/** 日干對應的起始六神索引 */
+const STEM_TO_START_INDEX = {
+    '甲': 0, // 青龍
+    '乙': 0, // 青龍
+    '丙': 1, // 朱雀
+    '丁': 1, // 朱雀
+    '戊': 2, // 勾陳
+    '己': 3, // 螣蛇
+    '庚': 4, // 白虎
+    '辛': 4, // 白虎
+    '壬': 5, // 玄武
+    '癸': 5, // 玄武
+};
+class LiushenCalculator {
+    /**
+     * 計算某爻的六神
+     * @param dayStem 日干
+     * @param position 爻位（1-6，自下而上）
+     */
+    static calculate(dayStem, position) {
+        const startIndex = STEM_TO_START_INDEX[dayStem];
+        // 初爻為起始六神，依次向上
+        const index = (startIndex + position - 1) % 6;
+        return LIUSHEN_ORDER[index];
+    }
+    /**
+     * 計算全卦六爻的六神
+     * @param dayStem 日干
+     * @returns 六爻六神（自下而上）
+     */
+    static calculateAll(dayStem) {
+        const results = [];
+        for (let i = 1; i <= 6; i++) {
+            results.push(this.calculate(dayStem, i));
+        }
+        return results;
+    }
+}
+exports.LiushenCalculator = LiushenCalculator;
+//# sourceMappingURL=LiushenCalculator.js.map

package/dist/services/liuyao/calculators/LiushenCalculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiushenCalculator.js","sourceRoot":"","sources":["../../../../src/services/liuyao/calculators/LiushenCalculator.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAIH,WAAW;AACX,MAAM,aAAa,GAAc,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEtE,kBAAkB;AAClB,MAAM,mBAAmB,GAA4B;IACnD,GAAG,EAAE,CAAC,EAAE,KAAK;IACb,GAAG,EAAE,CAAC,EAAE,KAAK;IACb,GAAG,EAAE,CAAC,EAAE,KAAK;IACb,GAAG,EAAE,CAAC,EAAE,KAAK;IACb,GAAG,EAAE,CAAC,EAAE,KAAK;IACb,GAAG,EAAE,CAAC,EAAE,KAAK;IACb,GAAG,EAAE,CAAC,EAAE,KAAK;IACb,GAAG,EAAE,CAAC,EAAE,KAAK;IACb,GAAG,EAAE,CAAC,EAAE,KAAK;IACb,GAAG,EAAE,CAAC,EAAE,KAAK;CACd,CAAC;AAEF,MAAa,iBAAiB;IAC5B;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,OAAgB,EAAE,QAAgB;QACjD,MAAM,UAAU,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAChD,eAAe;QACf,MAAM,KAAK,GAAG,CAAC,UAAU,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAC9C,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,OAAgB;QAClC,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAzBD,8CAyBC"}

package/dist/services/liuyao/calculators/NajiaCalculator.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 納甲計算器
+ *
+ * 京房納甲體系：
+ * - 根據卦象確定每爻的地支
+ * - 地支決定五行屬性
+ */
+import { BaGua, DiZhi, WuXing, YaoValue, YinYang } from '../types';
+export interface NaJiaResult {
+    /** 地支 */
+    diZhi: DiZhi;
+    /** 五行 */
+    wuXing: WuXing;
+}
+export declare class NajiaCalculator {
+    /**
+     * 計算單爻的納甲
+     * @param position 爻位（1-6，自下而上）
+     * @param upperGua 上卦
+     * @param lowerGua 下卦
+     */
+    static calculate(position: number, upperGua: BaGua, lowerGua: BaGua): NaJiaResult;
+    /**
+     * 計算全卦六爻的納甲
+     * @param upperGua 上卦
+     * @param lowerGua 下卦
+     * @returns 六爻納甲結果（自下而上）
+     */
+    static calculateAll(upperGua: BaGua, lowerGua: BaGua): NaJiaResult[];
+    /**
+     * 根據爻值數組獲取上下卦
+     * @param yaoValues 六爻值（自下而上）
+     *
+     * 注意：BINARY_TO_BAGUA 的定義是"下爻是最高位"
+     * 例如：震 = 0b100 = 4，表示下爻阳(1)、中爻阴(0)、上爻阴(0)
+     * 計算方式：下爻*4 + 中爻*2 + 上爻*1
+     */
+    static getGuaFromYaoValues(yaoValues: YaoValue[]): {
+        upper: BaGua;
+        lower: BaGua;
+    };
+    /**
+     * 獲取爻的陰陽
+     */
+    static getYinYang(yaoValue: YaoValue): YinYang;
+    /**
+     * 判斷是否為動爻
+     */
+    static isMoving(yaoValue: YaoValue): boolean;
+    /**
+     * 獲取動爻變化後的陰陽
+     */
+    static getChangedYinYang(yaoValue: YaoValue): YinYang | undefined;
+}
+//# sourceMappingURL=NajiaCalculator.d.ts.map

package/dist/services/liuyao/calculators/NajiaCalculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NajiaCalculator.d.ts","sourceRoot":"","sources":["../../../../src/services/liuyao/calculators/NajiaCalculator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGnE,MAAM,WAAW,WAAW;IAC1B,SAAS;IACT,KAAK,EAAE,KAAK,CAAC;IACb,SAAS;IACT,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,eAAe;IAC1B;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,GAAG,WAAW;IAejF;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,GAAG,WAAW,EAAE;IAQpE;;;;;;;OAOG;IACH,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE;IAejF;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAI9C;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAI5C;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS;CAKlE"}

package/dist/services/liuyao/calculators/NajiaCalculator.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * 納甲計算器
+ *
+ * 京房納甲體系：
+ * - 根據卦象確定每爻的地支
+ * - 地支決定五行屬性
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NajiaCalculator = void 0;
+const guagong_1 = require("../data/guagong");
+class NajiaCalculator {
+    /**
+     * 計算單爻的納甲
+     * @param position 爻位（1-6，自下而上）
+     * @param upperGua 上卦
+     * @param lowerGua 下卦
+     */
+    static calculate(position, upperGua, lowerGua) {
+        const isOuter = position > 3;
+        const gua = isOuter ? upperGua : lowerGua;
+        const positionInGua = isOuter ? position - 3 : position;
+        const naJiaData = guagong_1.NAJIA_TABLE[gua];
+        const arr = isOuter ? naJiaData.outer : naJiaData.inner;
+        const diZhi = arr[positionInGua - 1];
+        return {
+            diZhi,
+            wuXing: guagong_1.DIZHI_WUXING[diZhi],
+        };
+    }
+    /**
+     * 計算全卦六爻的納甲
+     * @param upperGua 上卦
+     * @param lowerGua 下卦
+     * @returns 六爻納甲結果（自下而上）
+     */
+    static calculateAll(upperGua, lowerGua) {
+        const results = [];
+        for (let i = 1; i <= 6; i++) {
+            results.push(this.calculate(i, upperGua, lowerGua));
+        }
+        return results;
+    }
+    /**
+     * 根據爻值數組獲取上下卦
+     * @param yaoValues 六爻值（自下而上）
+     *
+     * 注意：BINARY_TO_BAGUA 的定義是"下爻是最高位"
+     * 例如：震 = 0b100 = 4，表示下爻阳(1)、中爻阴(0)、上爻阴(0)
+     * 計算方式：下爻*4 + 中爻*2 + 上爻*1
+     */
+    static getGuaFromYaoValues(yaoValues) {
+        // 將爻值轉換為陰陽（6,8=陰，7,9=陽）
+        const yinYang = yaoValues.map(v => v === 7 || v === 9);
+        // 計算下卦（初爻到三爻）- 初爻(下爻)是最高位 (bit 2)
+        const lowerBinary = (yinYang[0] ? 4 : 0) + (yinYang[1] ? 2 : 0) + (yinYang[2] ? 1 : 0);
+        // 計算上卦（四爻到上爻）- 四爻(下爻)是最高位 (bit 2)
+        const upperBinary = (yinYang[3] ? 4 : 0) + (yinYang[4] ? 2 : 0) + (yinYang[5] ? 1 : 0);
+        return {
+            upper: guagong_1.BINARY_TO_BAGUA[upperBinary],
+            lower: guagong_1.BINARY_TO_BAGUA[lowerBinary],
+        };
+    }
+    /**
+     * 獲取爻的陰陽
+     */
+    static getYinYang(yaoValue) {
+        return (yaoValue === 7 || yaoValue === 9) ? '陽' : '陰';
+    }
+    /**
+     * 判斷是否為動爻
+     */
+    static isMoving(yaoValue) {
+        return yaoValue === 6 || yaoValue === 9;
+    }
+    /**
+     * 獲取動爻變化後的陰陽
+     */
+    static getChangedYinYang(yaoValue) {
+        if (!this.isMoving(yaoValue))
+            return undefined;
+        // 動爻陰陽反轉
+        return yaoValue === 9 ? '陰' : '陽';
+    }
+}
+exports.NajiaCalculator = NajiaCalculator;
+//# sourceMappingURL=NajiaCalculator.js.map

package/dist/services/liuyao/calculators/NajiaCalculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NajiaCalculator.js","sourceRoot":"","sources":["../../../../src/services/liuyao/calculators/NajiaCalculator.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAGH,6CAA2F;AAS3F,MAAa,eAAe;IAC1B;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,QAAgB,EAAE,QAAe,EAAE,QAAe;QACjE,MAAM,OAAO,GAAG,QAAQ,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC1C,MAAM,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAExD,MAAM,SAAS,GAAG,qBAAW,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC;QACxD,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;QAErC,OAAO;YACL,KAAK;YACL,MAAM,EAAE,sBAAY,CAAC,KAAK,CAAC;SAC5B,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,QAAe,EAAE,QAAe;QAClD,MAAM,OAAO,GAAkB,EAAE,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,mBAAmB,CAAC,SAAqB;QAC9C,wBAAwB;QACxB,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAEvD,kCAAkC;QAClC,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvF,kCAAkC;QAClC,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEvF,OAAO;YACL,KAAK,EAAE,yBAAe,CAAC,WAAW,CAAC;YACnC,KAAK,EAAE,yBAAe,CAAC,WAAW,CAAC;SACpC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,QAAkB;QAClC,OAAO,CAAC,QAAQ,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAkB;QAChC,OAAO,QAAQ,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAkB;QACzC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/C,SAAS;QACT,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACpC,CAAC;CACF;AAjFD,0CAiFC"}

package/dist/services/liuyao/calculators/WangshuaiCalculator.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 旺衰計算器
+ *
+ * 理論來源：五行旺相休囚死（《淮南子》以來的傳統理論）
+ *
+ * 核心規則（以月令/日辰地支所屬五行為基準）：
+ * - 旺：與月令/日辰同五行
+ * - 相：月令/日辰所生之五行
+ * - 休：生月令/日辰之五行
+ * - 囚：克月令/日辰之五行
+ * - 死：被月令/日辰所克之五行
+ *
+ * 簡化口訣：
+ * - 臨我者旺（同我）
+ * - 我生者相
+ * - 生我者休
+ * - 克我者囚
+ * - 我克者死
+ */
+import { DiZhi, WuXing, WangShuaiState } from '../types';
+export declare class WangshuaiCalculator {
+    /**
+     * 計算爻的旺衰狀態
+     *
+     * @param yaoWuXing 爻的五行
+     * @param lingDiZhi 月令或日辰的地支
+     * @returns 旺衰狀態
+     */
+    static calculate(yaoWuXing: WuXing, lingDiZhi: DiZhi): WangShuaiState;
+    /**
+     * 獲取旺衰說明
+     */
+    static getDescription(state: WangShuaiState): string;
+    /**
+     * 判斷是否為旺相（有力）
+     */
+    static isStrong(state: WangShuaiState): boolean;
+    /**
+     * 判斷是否為休囚死（無力）
+     */
+    static isWeak(state: WangShuaiState): boolean;
+}
+//# sourceMappingURL=WangshuaiCalculator.d.ts.map

package/dist/services/liuyao/calculators/WangshuaiCalculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WangshuaiCalculator.d.ts","sourceRoot":"","sources":["../../../../src/services/liuyao/calculators/WangshuaiCalculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAqBzD,qBAAa,mBAAmB;IAC9B;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,cAAc;IAgCrE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;IAWpD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO;IAI/C;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO;CAG9C"}

package/dist/services/liuyao/calculators/WangshuaiCalculator.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * 旺衰計算器
+ *
+ * 理論來源：五行旺相休囚死（《淮南子》以來的傳統理論）
+ *
+ * 核心規則（以月令/日辰地支所屬五行為基準）：
+ * - 旺：與月令/日辰同五行
+ * - 相：月令/日辰所生之五行
+ * - 休：生月令/日辰之五行
+ * - 囚：克月令/日辰之五行
+ * - 死：被月令/日辰所克之五行
+ *
+ * 簡化口訣：
+ * - 臨我者旺（同我）
+ * - 我生者相
+ * - 生我者休
+ * - 克我者囚
+ * - 我克者死
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WangshuaiCalculator = void 0;
+const guagong_1 = require("../data/guagong");
+/** 五行相生：A 生 B */
+const SHENG = {
+    '金': '水',
+    '水': '木',
+    '木': '火',
+    '火': '土',
+    '土': '金',
+};
+/** 五行相剋：A 克 B */
+const KE = {
+    '金': '木',
+    '木': '土',
+    '土': '水',
+    '水': '火',
+    '火': '金',
+};
+class WangshuaiCalculator {
+    /**
+     * 計算爻的旺衰狀態
+     *
+     * @param yaoWuXing 爻的五行
+     * @param lingDiZhi 月令或日辰的地支
+     * @returns 旺衰狀態
+     */
+    static calculate(yaoWuXing, lingDiZhi) {
+        const lingWuXing = guagong_1.DIZHI_WUXING[lingDiZhi];
+        // 同五行 = 旺
+        if (yaoWuXing === lingWuXing) {
+            return '旺';
+        }
+        // 令生爻 = 相（爻得生）
+        if (SHENG[lingWuXing] === yaoWuXing) {
+            return '相';
+        }
+        // 爻生令 = 休（爻洩氣）
+        if (SHENG[yaoWuXing] === lingWuXing) {
+            return '休';
+        }
+        // 爻克令 = 囚（爻耗力）
+        if (KE[yaoWuXing] === lingWuXing) {
+            return '囚';
+        }
+        // 令克爻 = 死（爻受制）
+        if (KE[lingWuXing] === yaoWuXing) {
+            return '死';
+        }
+        // 不應該到這裡
+        return '休';
+    }
+    /**
+     * 獲取旺衰說明
+     */
+    static getDescription(state) {
+        const descriptions = {
+            '旺': '當令，力量最強',
+            '相': '得生，力量次強',
+            '休': '洩氣，力量平平',
+            '囚': '耗力，力量較弱',
+            '死': '受制，力量最弱',
+        };
+        return descriptions[state];
+    }
+    /**
+     * 判斷是否為旺相（有力）
+     */
+    static isStrong(state) {
+        return state === '旺' || state === '相';
+    }
+    /**
+     * 判斷是否為休囚死（無力）
+     */
+    static isWeak(state) {
+        return state === '休' || state === '囚' || state === '死';
+    }
+}
+exports.WangshuaiCalculator = WangshuaiCalculator;
+//# sourceMappingURL=WangshuaiCalculator.js.map

package/dist/services/liuyao/calculators/WangshuaiCalculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WangshuaiCalculator.js","sourceRoot":"","sources":["../../../../src/services/liuyao/calculators/WangshuaiCalculator.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAGH,6CAA+C;AAE/C,iBAAiB;AACjB,MAAM,KAAK,GAA2B;IACpC,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;CACT,CAAC;AAEF,iBAAiB;AACjB,MAAM,EAAE,GAA2B;IACjC,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;CACT,CAAC;AAEF,MAAa,mBAAmB;IAC9B;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,SAAiB,EAAE,SAAgB;QAClD,MAAM,UAAU,GAAG,sBAAY,CAAC,SAAS,CAAC,CAAC;QAE3C,UAAU;QACV,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,OAAO,GAAG,CAAC;QACb,CAAC;QAED,eAAe;QACf,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO,GAAG,CAAC;QACb,CAAC;QAED,eAAe;QACf,IAAI,KAAK,CAAC,SAAS,CAAC,KAAK,UAAU,EAAE,CAAC;YACpC,OAAO,GAAG,CAAC;QACb,CAAC;QAED,eAAe;QACf,IAAI,EAAE,CAAC,SAAS,CAAC,KAAK,UAAU,EAAE,CAAC;YACjC,OAAO,GAAG,CAAC;QACb,CAAC;QAED,eAAe;QACf,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,GAAG,CAAC;QACb,CAAC;QAED,SAAS;QACT,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,KAAqB;QACzC,MAAM,YAAY,GAAmC;YACnD,GAAG,EAAE,SAAS;YACd,GAAG,EAAE,SAAS;YACd,GAAG,EAAE,SAAS;YACd,GAAG,EAAE,SAAS;YACd,GAAG,EAAE,SAAS;SACf,CAAC;QACF,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAqB;QACnC,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAqB;QACjC,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC;IACzD,CAAC;CACF;AAnED,kDAmEC"}

package/dist/services/liuyao/calculators/XunkongCalculator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 旬空計算器
+ *
+ * 旬空（空亡）規則：
+ * - 六十甲子分為六旬，每旬十天
+ * - 每旬有兩個地支輪空（因為天干10個，地支12個）
+ *
+ * 六旬空亡表：
+ * - 甲子旬：戌亥空
+ * - 甲戌旬：申酉空
+ * - 甲申旬：午未空
+ * - 甲午旬：辰巳空
+ * - 甲辰旬：寅卯空
+ * - 甲寅旬：子丑空
+ */
+import { TianGan, DiZhi } from '../types';
+export declare class XunkongCalculator {
+    /**
+     * 計算旬空
+     * @param dayStem 日干
+     * @param dayBranch 日支
+     * @returns 空亡的兩個地支
+     */
+    static calculate(dayStem: TianGan, dayBranch: DiZhi): [DiZhi, DiZhi];
+    /**
+     * 判斷某地支是否空亡
+     */
+    static isKong(diZhi: DiZhi, xunKong: [DiZhi, DiZhi]): boolean;
+}
+//# sourceMappingURL=XunkongCalculator.d.ts.map

package/dist/services/liuyao/calculators/XunkongCalculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XunkongCalculator.d.ts","sourceRoot":"","sources":["../../../../src/services/liuyao/calculators/XunkongCalculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAiB1C,qBAAa,iBAAiB;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC;IAgBpE;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,OAAO;CAG9D"}

package/dist/services/liuyao/calculators/XunkongCalculator.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * 旬空計算器
+ *
+ * 旬空（空亡）規則：
+ * - 六十甲子分為六旬，每旬十天
+ * - 每旬有兩個地支輪空（因為天干10個，地支12個）
+ *
+ * 六旬空亡表：
+ * - 甲子旬：戌亥空
+ * - 甲戌旬：申酉空
+ * - 甲申旬：午未空
+ * - 甲午旬：辰巳空
+ * - 甲辰旬：寅卯空
+ * - 甲寅旬：子丑空
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XunkongCalculator = void 0;
+/** 天干索引 */
+const TIANGAN_INDEX = {
+    '甲': 0, '乙': 1, '丙': 2, '丁': 3, '戊': 4,
+    '己': 5, '庚': 6, '辛': 7, '壬': 8, '癸': 9,
+};
+/** 地支索引 */
+const DIZHI_INDEX = {
+    '子': 0, '丑': 1, '寅': 2, '卯': 3, '辰': 4, '巳': 5,
+    '午': 6, '未': 7, '申': 8, '酉': 9, '戌': 10, '亥': 11,
+};
+/** 地支數組 */
+const DIZHI_ARRAY = ['子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥'];
+class XunkongCalculator {
+    /**
+     * 計算旬空
+     * @param dayStem 日干
+     * @param dayBranch 日支
+     * @returns 空亡的兩個地支
+     */
+    static calculate(dayStem, dayBranch) {
+        const stemIndex = TIANGAN_INDEX[dayStem];
+        const branchIndex = DIZHI_INDEX[dayBranch];
+        // 計算該日所在旬的起始地支索引
+        // 旬首的地支索引 = (日支索引 - 日干索引 + 12) % 12
+        const xunStartBranchIndex = (branchIndex - stemIndex + 12) % 12;
+        // 空亡的兩個地支是旬首地支往前數10和11位
+        // 即 (旬首索引 + 10) % 12 和 (旬首索引 + 11) % 12
+        const kong1Index = (xunStartBranchIndex + 10) % 12;
+        const kong2Index = (xunStartBranchIndex + 11) % 12;
+        return [DIZHI_ARRAY[kong1Index], DIZHI_ARRAY[kong2Index]];
+    }
+    /**
+     * 判斷某地支是否空亡
+     */
+    static isKong(diZhi, xunKong) {
+        return xunKong.includes(diZhi);
+    }
+}
+exports.XunkongCalculator = XunkongCalculator;
+//# sourceMappingURL=XunkongCalculator.js.map

package/dist/services/liuyao/calculators/XunkongCalculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"XunkongCalculator.js","sourceRoot":"","sources":["../../../../src/services/liuyao/calculators/XunkongCalculator.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAIH,WAAW;AACX,MAAM,aAAa,GAA4B;IAC7C,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IACtC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;CACvC,CAAC;AAEF,WAAW;AACX,MAAM,WAAW,GAA0B;IACzC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IAC9C,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE;CACjD,CAAC;AAEF,WAAW;AACX,MAAM,WAAW,GAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAE1F,MAAa,iBAAiB;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,OAAgB,EAAE,SAAgB;QACjD,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,WAAW,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QAE3C,iBAAiB;QACjB,oCAAoC;QACpC,MAAM,mBAAmB,GAAG,CAAC,WAAW,GAAG,SAAS,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;QAEhE,wBAAwB;QACxB,wCAAwC;QACxC,MAAM,UAAU,GAAG,CAAC,mBAAmB,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;QACnD,MAAM,UAAU,GAAG,CAAC,mBAAmB,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;QAEnD,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAY,EAAE,OAAuB;QACjD,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;CACF;AA7BD,8CA6BC"}

package/dist/services/liuyao/data/guagong.d.ts

@@ -0,0 +1,94 @@
+/**
+ * 八宮卦數據
+ *
+ * 京房易學體系：
+ * - 八宮：乾、兌、離、震、巽、坎、艮、坤
+ * - 每宮八卦：本宮卦、一世、二世、三世、四世、五世、遊魂、歸魂
+ * - 世應規則：本宮卦世在六爻，一世世在初爻，依次類推
+ *
+ * 數據來源：京房納甲體系標準口徑
+ */
+import { BaGua, WuXing, DiZhi } from '../types';
+/**
+ * 八卦對應的二進制值（陽爻=1，陰爻=0，上爻是最高位）
+ *
+ * 八卦符號從下往上看（下爻、中爻、上爻）：
+ * - 乾 ☰ = 阳阳阳 -> 上爻*4 + 中爻*2 + 下爻*1 = 1*4 + 1*2 + 1*1 = 7
+ * - 兌 ☱ = 阴阳阳 -> 上爻*4 + 中爻*2 + 下爻*1 = 1*4 + 1*2 + 0*1 = 6
+ * - 離 ☲ = 阳阴阳 -> 上爻*4 + 中爻*2 + 下爻*1 = 1*4 + 0*2 + 1*1 = 5
+ * - 震 ☳ = 阴阴阳 -> 上爻*4 + 中爻*2 + 下爻*1 = 0*4 + 0*2 + 1*1 = 1 (錯誤！)
+ *
+ * 實際定義（與先天八卦數一致）：
+ * - 震 ☳ = 100 = 4
+ * - 艮 ☶ = 001 = 1
+ *
+ * 這是因為二進制表示是"上爻是最高位"，但八卦符號的閱讀順序是從下往上。
+ */
+export declare const BAGUA_BINARY: Record<BaGua, number>;
+/**
+ * 二進制值對應的八卦
+ *
+ * 計算方式：上爻*4 + 中爻*2 + 下爻*1
+ */
+export declare const BINARY_TO_BAGUA: Record<number, BaGua>;
+/** 八卦五行 */
+export declare const BAGUA_WUXING: Record<BaGua, WuXing>;
+/** 八卦符號 */
+export declare const BAGUA_SYMBOL: Record<BaGua, string>;
+export interface Gua64Info {
+    /** 卦名 */
+    name: string;
+    /** 上卦 */
+    upper: BaGua;
+    /** 下卦 */
+    lower: BaGua;
+    /** 所屬卦宮 */
+    gong: BaGua;
+    /** 卦序（1-8：本宮、一世、二世、三世、四世、五世、遊魂、歸魂） */
+    guaXu: number;
+    /** 世爻位置（1-6） */
+    shiYao: number;
+    /** 應爻位置（1-6） */
+    yingYao: number;
+}
+/**
+ * 六十四卦完整數據
+ * key = 上卦二進制 * 8 + 下卦二進制
+ */
+export declare const GUA64_DATA: Record<number, Gua64Info>;
+/**
+ * 京房納甲表
+ * 每個八卦的六爻對應的地支（自下而上：初爻到上爻）
+ *
+ * 規則：
+ * - 乾納甲壬，內卦子寅辰，外卦午申戌
+ * - 坤納乙癸，內卦未巳卯，外卦丑亥酉
+ * - 震納庚，內卦子寅辰，外卦午申戌
+ * - 巽納辛，內卦丑亥酉，外卦未巳卯
+ * - 坎納戊，內卦寅辰午，外卦申戌子
+ * - 離納己，內卦卯丑亥，外卦酉未巳
+ * - 艮納丙，內卦辰午申，外卦戌子寅
+ * - 兌納丁，內卦巳卯丑，外卦亥酉未
+ */
+export declare const NAJIA_TABLE: Record<BaGua, {
+    inner: [DiZhi, DiZhi, DiZhi];
+    outer: [DiZhi, DiZhi, DiZhi];
+}>;
+export declare const DIZHI_WUXING: Record<DiZhi, WuXing>;
+/**
+ * 根據上下卦獲取六十四卦信息
+ */
+export declare function getGua64Info(upper: BaGua, lower: BaGua): Gua64Info;
+/**
+ * 根據六爻陰陽獲取六十四卦信息
+ * @param yaoYinYang 六爻陰陽數組（自下而上，true=陽，false=陰）
+ */
+export declare function getGua64InfoByYao(yaoYinYang: [boolean, boolean, boolean, boolean, boolean, boolean]): Gua64Info;
+/**
+ * 獲取某爻的納甲地支
+ * @param gua 所屬八卦（上卦或下卦）
+ * @param position 爻位（1-3 為內卦，4-6 為外卦）
+ * @param isOuter 是否為外卦
+ */
+export declare function getNaJia(gua: BaGua, positionInGua: number, isOuter: boolean): DiZhi;
+//# sourceMappingURL=guagong.d.ts.map

package/dist/services/liuyao/data/guagong.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guagong.d.ts","sourceRoot":"","sources":["../../../../src/services/liuyao/data/guagong.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAMhD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAS9C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CASjD,CAAC;AAEF,WAAW;AACX,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAS9C,CAAC;AAEF,WAAW;AACX,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAS9C,CAAC;AAMF,MAAM,WAAW,SAAS;IACxB,SAAS;IACT,IAAI,EAAE,MAAM,CAAC;IACb,SAAS;IACT,KAAK,EAAE,KAAK,CAAC;IACb,SAAS;IACT,KAAK,EAAE,KAAK,CAAC;IACb,WAAW;IACX,IAAI,EAAE,KAAK,CAAC;IACZ,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAgKhD,CAAC;AAMF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAAC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;CAAE,CASrG,CAAC;AAMF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAa9C,CAAC;AAMF;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,SAAS,CAGlE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,CAa/G;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,KAAK,CAInF"}