/**
 * @file 单宫门星神关系分析
 * @description 分析一个宫位内八门、九星、八神之间的五行生克关系，
 * 判断宫位内部的和谐程度，为宫位能量解读提供基础。
 *
 * 古籍依据：
 *   - 《烟波钓叟歌》：「九星八门八神配五行，生克判吉凶」
 *   - 《奇门遁甲秘籍大全·门星神合参章》：「门为事体，星为事主，神为事机。
 *     三者相生则吉，比和则顺，相克则阻。」
 *   - 《遁甲演义》：「凡门星神三者比和，此宫为吉；三者相克，此宫大凶；
 *     凡生我者为恩，克我者为仇，我生者为泄，我克者为制。」
 *
 * 门星神三者的五行生克是判断宫位能量是否协调的核心：
 *   - 比和（同五行）：相互支持，和谐稳定
 *   - 相生（我生/生我）：有助力或宣泄，整体偏正
 *   - 相克（我克/克我）：有压制或反抗，有矛盾张力
 */
import type { QimenJiuGongGe } from '../../../../types/divination';
/**
 * 获取八门的五行属性
 *
 * @param door 八门名称（如 "休门"、"生门"）
 * @returns 对应的五行（"水"、"火"、"木"、"金"、"土"）
 *
 * @example
 * ```ts
 * getDoorElement('休门'); // '水'
 * getDoorElement('景门'); // '火'
 * ```
 */
export declare function getDoorElement(door: string): string;
/**
 * 获取九星的五行属性
 *
 * @param star 九星名称（如 "天蓬"、"天芮"）
 * @returns 对应的五行（"水"、"火"、"木"、"金"、"土"）
 *
 * @example
 * ```ts
 * getStarElement('天蓬'); // '水'
 * getStarElement('天英'); // '火'
 * ```
 */
export declare function getStarElement(star: string): string;
/**
 * 获取八神的五行属性
 *
 * @param god 八神名称（如 "值符"、"螣蛇"）
 * @returns 对应的五行（"水"、"火"、"木"、"金"、"土"）
 *
 * @example
 * ```ts
 * getGodElement('值符'); // '土'
 * getGodElement('螣蛇'); // '火'
 * getGodElement('太阴'); // '金'
 * ```
 */
export declare function getGodElement(god: string): string;
/** 单对关系结果 */
export interface PairRelation {
    /** 第一个元素名称（门/星/神） */
    first: string;
    /** 第二个元素名称（门/星/神） */
    second: string;
    /** 第一个元素的五行 */
    firstElement: string;
    /** 第二个元素的五行 */
    secondElement: string;
    /** 关系类型：比和（同五行）、相生、相克 */
    relation: '比和' | '相生' | '相克';
    /** 关系的中文描述 */
    description: string;
}
/** 宫位内所有关系的综合分析结果 */
export interface PalaceRelationsResult {
    /** 门与星的关系 */
    doorStar: PairRelation;
    /** 门与神的关系 */
    doorGod: PairRelation;
    /** 星与神的关系 */
    starGod: PairRelation;
    /** 整体和谐等级 */
    harmony: '和谐' | '有拉扯' | '冲突';
    /** 三组可复核关系的分类计数。 */
    relationCounts: {
        supporting: number;
        controlling: number;
    };
    /** @deprecated 仅为兼容旧调用保留；解释与提示词不得展示为吉凶强度。 */
    score: number;
    /** 整体关系的中文描述 */
    description: string;
}
/**
 * 分析单个宫位中门、星、神之间的两两五行关系
 *
 * 逐一计算门与星、门与神、星与神的五行生克，汇总得到宫位内部能量状态。
 * 门星神三者的和谐程度决定了该宫位行事是否顺畅：
 *   - 和谐：多数为相生或比和，能量协同，利于在该宫方位行事
 *   - 有拉扯：生克参半，有助力也有阻力，需要具体分析矛盾项
 *   - 冲突：多数为相克，矛盾突出，在该宫方位易生阻碍
 *
 * @param palace 宫位数据（须含 renPan.door、tianPan.star、shenPan.god）
 * @returns 包含三对关系详情、综合等级和评分的结果对象
 *
 * @example
 * ```ts
 * const result = analyzePalaceRelations(jiuGongGe[0]);
 * // {
 * //   doorStar: { first: '休门', second: '天蓬', firstElement: '水', secondElement: '水', relation: '比和', description: '...' },
 * //   harmony: '和谐',
 * //   score: 3,
 * //   description: '该宫门星神三者关系和谐，利于行事。'
 * // }
 * ```
 */
export declare function analyzePalaceRelations(palace: Pick<QimenJiuGongGe, 'renPan' | 'tianPan' | 'shenPan'>): PalaceRelationsResult;
/**
 * 获取宫位门星神三者的整体和谐评分
 *
 * 评分规则（-3 ~ +3，整数）：
 *   门-星：比和 +1 | 相生 +1 | 相克 -1
 *   门-神：比和 +1 | 相生 +1 | 相克 -1
 *   星-神：比和 +1 | 相生 +1 | 相克 -1
 *
 * 分值含义：
 *   +3 ~ +2：能量协同，吉顺
 *   +1 ~ -1：有拉扯，需具体分析
 *   -2 ~ -3：能量冲突，多阻碍
 *
 * @param palace 宫位数据（须含 renPan.door、tianPan.star、shenPan.god）
 * @returns 和谐评分，-3（最冲突）到 +3（最和谐）
 *
 * @example
 * ```ts
 * const score = getPalaceHarmony(jiuGongGe[1]); // 返回 -1, 2, 等
 * ```
 */
export declare function getPalaceHarmony(palace: Pick<QimenJiuGongGe, 'renPan' | 'tianPan' | 'shenPan'>): number;