import type { AstrolabeData } from '../types/divination'; export type AstrolabePeriodScopeMode = 'yearly' | 'monthly' | 'daily'; export declare const ASTROLABE_PERIOD_CONTEXT_POINT_NAMES: readonly ["Sun", "Moon", "Mercury", "Venus", "Mars", "Jupiter", "Saturn", "Uranus", "Neptune", "Pluto", "North Node", "South Node", "Ascendant", "Midheaven"]; export type AstrolabePeriodContextPointName = (typeof ASTROLABE_PERIOD_CONTEXT_POINT_NAMES)[number]; export type AstrolabePeriodContext = { timezone: number; timeZoneId?: string; points: Array<{ name: AstrolabePeriodContextPointName; longitude: number; }>; houseCusps: [ number, number, number, number, number, number, number, number, number, number, number, number ]; }; export type AstrolabePeriodDate = { year: number; month: number; day: number; }; export type AstrolabePeriodBatchInput = { start: AstrolabePeriodDate; endExclusive: AstrolabePeriodDate; }; export type AstrolabePeriodBatchRange = { startDate: string; endDate: string; endExclusive: true; }; export type AstrolabePeriodBatch = { scopeStartDate: string; scopeEndDate: string; range: AstrolabePeriodBatchRange; nextRange: AstrolabePeriodBatchRange | null; }; export type AstrolabePeriodBatchResult = { kind: 'astrolabe-period-batch'; scope: AstrolabePeriodScopeMode; target: string; parentRange: AstrolabePeriodBatchRange; range: AstrolabePeriodBatchRange; nextRange: AstrolabePeriodBatchRange | null; timezone: number; timeZoneId?: string; sampleStepDays: number; events: AstrolabePeriodEvent[]; }; export type AstrolabePeriodEventKind = '行运相位' | '天象相位' | '停逆' | '换座' | '换宫' | '朔望' | '交食'; export interface AstrolabePeriodEvent { key: string; kind: AstrolabePeriodEventKind; julianDate: number; dateTime: string; promptText: string; movingPoint: string; targetPoint?: string; aspectName?: string; signName?: string; house?: number; stationDirection?: '逆行' | '顺行'; lunationName?: '朔' | '望' | '上弦' | '下弦'; /** 朔望触碰本命点的结构化事实;旧文本只采用按偏差排序的前两项。 */ lunationTouches?: AstrolabeLunationNatalTouch[]; /** 全部通过朔望容许度的本命触碰事实;旧手工事件可省略,核心生成结果始终提供。 */ lunationTouchCandidates?: AstrolabeLunationTouchCandidate[]; eclipseName?: string; } export type AstrolabeLunationAspectName = '合相' | '刑相' | '冲相'; export type AstrolabeLunationNatalTouch = { key?: string; pointName: string; pointLabel: string; aspectName: AstrolabeLunationAspectName; aspectSymbol: string; exactAngle: number; actualAngle: number; deviation: number; allowedOrb: number; }; export type AstrolabeLunationTouchCandidate = AstrolabeLunationNatalTouch & { /** 由本命点和精确相位组成、跨取样时刻稳定的机器身份。 */ key: string; }; export interface AstrolabePeriodTransitGroup { key: string; movingPoint: string; targetPoint: string; aspectName: string; events: AstrolabePeriodEvent[]; promptText: string; } export interface AstrolabePeriodWindow { startDateTime: string; endDateTime: string; eventKeys: string[]; promptText: string; } export interface AstrolabePeriodAxisItem { key: string; promptText: string; /** 归组主轴展开后的事件成员;单事件主轴包含自身 key。 */ eventKeys?: string[]; } export interface AstrolabePeriodEventCollection { startDateTime: string; endDateTime: string; timezoneLabel: string; events: AstrolabePeriodEvent[]; groups: AstrolabePeriodTransitGroup[]; windows: AstrolabePeriodWindow[]; axis: AstrolabePeriodAxisItem[]; promptText: string; batch?: AstrolabePeriodBatch; } declare const YEARLY_BODIES: readonly ["Jupiter", "Saturn", "Uranus", "Neptune", "Pluto", "North Node"]; declare const MONTHLY_EXTRA_BODIES: readonly ["Mars", "Venus", "Mercury", "Sun"]; type MovingBodyName = (typeof YEARLY_BODIES)[number] | (typeof MONTHLY_EXTRA_BODIES)[number] | 'Moon'; type BodyPosition = { longitude: number; speed: number; }; /** 单次范围扫描复用精确星历输入;不缓存本命相位、宫位或触碰结论。 */ export declare class AstrolabePeriodCalculationCache { private readonly positions; private readonly solarEclipses; private readonly lunarEclipses; position(name: MovingBodyName, jd: number): BodyPosition; solar(start: number, end: number): { julianDate: number; type: "total" | "annular" | "hybrid" | "partial"; }[]; lunar(start: number, end: number): { julianDate: number; type: "total" | "partial" | "penumbral"; }[]; } export type AstrolabePeriodBuildOptions = { batch?: AstrolabePeriodBatchInput; calculationCache?: AstrolabePeriodCalculationCache; }; type AstrolabePeriodSource = AstrolabeData | AstrolabePeriodContext; export declare function resolveAstrolabePeriodWindow(source: AstrolabePeriodSource, scope: AstrolabePeriodScopeMode, target: { year: number; month: number; day: number; }, batch?: AstrolabePeriodBatchInput): { start: import("../calendar").CivilTimeResolution; end: import("../calendar").CivilTimeResolution; scopeStart: import("../calendar").CivilTimeResolution; scopeEnd: import("../calendar").CivilTimeResolution; startJd: number; endJd: number; scopeStartJd: number; scopeEndJd: number; timezoneLabel: string; startDateTime: string; endDateTime: string; batch: { scopeStartDate: string; scopeEndDate: string; range: { startDate: string; endDate: string; endExclusive: true; }; nextRange: AstrolabePeriodBatchRange | null; } | undefined; }; export declare function buildAstrolabePeriodContext(data: AstrolabeData): AstrolabePeriodContext; export declare function validateAstrolabePeriodContext(value: unknown): AstrolabePeriodContext; export declare function mergeAstrolabePeriodEvents(groups: AstrolabePeriodEvent[][]): AstrolabePeriodEvent[]; export declare function scoreAstrolabePeriodEvent(event: AstrolabePeriodEvent): number; export declare function buildAstrolabePeriodEventLayers(events: AstrolabePeriodEvent[], startDateTime: string, endDateTime: string, scope: AstrolabePeriodScopeMode): { groups: AstrolabePeriodTransitGroup[]; windows: AstrolabePeriodWindow[]; axis: AstrolabePeriodAxisItem[]; promptText: string; }; export declare function mergeAstrolabePeriodCollections(collections: AstrolabePeriodEventCollection[], scope?: AstrolabePeriodScopeMode): AstrolabePeriodEventCollection | undefined; export declare function buildAstrolabePeriodEvents(data: AstrolabeData, scope: AstrolabePeriodScopeMode, target: { year: number; month: number; day: number; }, options?: AstrolabePeriodBuildOptions): AstrolabePeriodEventCollection; export declare function buildAstrolabePeriodEventsFromContext(context: AstrolabePeriodContext, scope: AstrolabePeriodScopeMode, target: { year: number; month: number; day: number; }, options: { batch: AstrolabePeriodBatchInput; }): AstrolabePeriodEventCollection; export declare function buildAstrolabePeriodBatchResult(context: AstrolabePeriodContext, scope: AstrolabePeriodScopeMode, target: { year: number; month: number; day: number; }, targetText: string, batch: AstrolabePeriodBatchInput): AstrolabePeriodBatchResult; export {};