/**
 * @file 奇门终身局动态扫描与事件聚类模块
 * @description 根据用户请求的时间区间（periodRange），按年扫描流年太岁引动、
 * 空亡填实、马星引动与年家盘叠合，并列出可复核的交节日与日支关系。
 */
import type { QimenData, QimenEventCluster, QimenLifetimeStage } from '../../../../types/divination';
export interface QimenDynamicTimeContext {
    /** 固定 UTC 偏移；存在 IANA 时区时由 timeZoneId 优先。 */
    timezone?: number;
    /** 目标年度沿用的 IANA 时区，按年度瞬时点重新读取历史偏移。 */
    timeZoneId?: string;
    /** 出生时间已经解析出的固定偏移，用于日期字符串带偏移但未单独传 timezone 的情况。 */
    fallbackOffsetMinutes?: number;
}
/** 校验动态流年区间；扫描能力最多覆盖起始年及其后30年。 */
export declare function validateLifetimePeriodRange(periodRange: unknown): asserts periodRange is {
    startDate: string;
    endDate: string;
};
/**
 * 扫描指定时间范围内的流年动态事件簇
 */
export declare function scanLifetimeDynamicEvents(baseChart: QimenData, stages: QimenLifetimeStage[], periodRange: {
    startDate: string;
    endDate: string;
}, method?: 'zhuanpan' | 'feipan', juMethod?: 'chaibu' | 'zhirun', timeContext?: QimenDynamicTimeContext): QimenEventCluster[];