/**
 * @file 七政四余流曜、行限出生时间整秒区间
 * @description 在固定 UTC+8 的本命候选区间内逐秒核验流曜、行限与周期事件，
 *              只保留离散分支首尾完整盘和连续事实，避免保存全部出生样本。
 */
import { type QizhengBirthRangeContinuousFact } from './birth-range';
import type { QizhengInput, QizhengResult } from './index';
import type { QizhengPeriodEvent, QizhengPeriodMode } from './period-events';
export type QizhengFlowBirthRangeSource = {
    startTimestamp: number;
    endTimestamp: number;
    endExclusive: true;
    timezone: 'Asia/Shanghai';
    offsetHours: 8;
};
export type QizhengFlowBirthRangeOptions = {
    onProgress?: (completed: number, total: number) => void;
    signal?: AbortSignal;
};
export type QizhengFlowBirthRangeContinuousFact = QizhengBirthRangeContinuousFact;
export type QizhengFlowBirthRangeEventFact = {
    /** 不含四舍五入时间的稳定事件身份；序号区分同一身份的多次出现。 */
    identity: string;
    kind: QizhengPeriodEvent['kind'];
    movingStar: string;
    targetStar?: string;
    aspectType?: string;
    aspectDirection?: '正向' | '逆向';
    stationDirection?: '逆行' | '顺行';
    palace?: string;
    signBranch?: string;
    firstUtcMs: number;
    lastUtcMs: number;
    minUtcMs: number;
    maxUtcMs: number;
    sampleCount: number;
    firstDateTime: string;
    lastDateTime: string;
};
export type QizhengFlowBirthRangeBranch = {
    startTimestamp: number;
    endTimestamp: number;
    endExclusive: true;
    sampleCount: number;
    representative: QizhengResult;
    last: QizhengResult;
    /** 流曜吊照、目标连续量和周期事件出现时刻的逐段事实。 */
    continuous: QizhengFlowBirthRangeContinuousFact[];
    periodEvents: {
        mode: QizhengPeriodMode;
        startDateTime: string;
        endDateTime: string;
        events: QizhengFlowBirthRangeEventFact[];
    };
};
export type QizhengFlowBirthRange = {
    coverage: 'flow';
    status: 'stable' | 'conditional';
    source: QizhengFlowBirthRangeSource;
    resolutionSeconds: 1;
    sampleCount: number;
    target: {
        mode: QizhengPeriodMode;
        year: number;
        month: number;
        day: number;
        hour: number;
        minute: number;
        timestampNote: string;
        startUtcTimestamp: number;
        endUtcTimestamp: number;
    };
    branches: QizhengFlowBirthRangeBranch[];
};
/** 逐出生整秒计算流曜、行限和周期事件的完整范围。 */
export declare function generateQizhengFlowBirthRange(input: QizhengInput, source: QizhengFlowBirthRangeSource, options?: QizhengFlowBirthRangeOptions): QizhengFlowBirthRange;