/** * @file 应期判断(《奇门遁甲大全》应期章、《奇门旨归》) * @description 综合对象宫位与盘内条件判断应期节奏与触发条件: * 1. 已选事项用神 → 按阴阳遁内外宫取远近基线 * 2. 未选事项用神 → 仅以值符落宫作通用参考 * 3. 事项用神与值符分宫时,值符落宫 → 辅助基线 * 4. 值使落宫数 → 辅助基线 * 5. 马星加快、基准宫位落空则待填实/冲实、伏吟延迟、反吟加快 * 6. 格局只作快慢辅助,不机械换算固定天数 */ export interface YingQiEstimate { /** 旧版固定天数下界;不再生成,仅保留类型兼容 */ minDays?: number; /** 旧版固定天数上界;不再生成,仅保留类型兼容 */ maxDays?: number; /** 应期节奏 */ rhythm: '快' | '中' | '慢'; /** 判断依据列表 */ sources: string[]; /** 可以据盘复核的触发条件 */ triggerConditions: string[]; /** 不确定性与解释边界 */ limitations: string[]; /** 综合描述 */ description: string; } /** * 估算应期 * * @param jiuGongGe - 九宫格宫位资料 * @param useShenPalace - 已按事项选定的用神落宫;省略时仅回退到值符通用参考 * @param options - 可选参数 * @returns 应期估算结果 * * @example * ```ts * const result = estimateYingQi(jiuGongGe, 3, { * isFuyin: false, * isFanyin: true, * hasHorse: false, * hasVoid: true, * zhiFuLandingPalace: 1, * zhiShiLandingPalace: 8, * classicPatterns: [{ name: '青龙返首', tone: 'good' }], * voidBranches: ['寅', '卯'], * }); * ``` */ export declare function estimateYingQi(jiuGongGe: Array<{ gong: number; }>, useShenPalace?: number, options?: { /** 是否伏吟 */ isFuyin?: boolean; /** 是否反吟 */ isFanyin?: boolean; /** 是否有马星冲动 */ hasHorse?: boolean; /** 基准宫位是否逢空亡;有事项用神时指用神,否则指值符通用参考 */ hasVoid?: boolean; /** 值符落宫 */ zhiFuLandingPalace?: number; /** 值使落宫 */ zhiShiLandingPalace?: number; /** 经典格局列表 */ classicPatterns?: Array<{ name: string; tone: 'good' | 'bad' | 'neutral'; /** 未填宫位表示全局格局;填宫位时仅作用于该宫。 */ palace?: number; }>; /** 命中基准宫位的空亡地支列表(用于细化说明填实时间) */ voidBranches?: string[]; /** 是否阳遁;用于按冬至/夏至后内外宫判断应期远近 */ isYangDun?: boolean; }): YingQiEstimate;