feat: 完善日月食与月掩几何链路并扩展历法接口

- 新增日月食中心带、偏食带、阴影足迹、等时线、食分线及升落边界计算，支持极区与混合食拓扑 - 新增日食单时刻阴影求解器、站心状态查询、批量采样和 ΔT 覆盖接口 - 重构恒星与行星月掩路径，补充有限盘面接触、站心修正、掩带宽度、极区投影及升落边界 - 扩展 SVG 与 GeoJSON 输出，支持详细面板、全球/极区/地球投影、边界闭合、时间标记和拓扑签名 - 扩展日月食候选搜索、局地搜索、沙罗序列预计算与范围外推，补充系列锚点和成员一致性校验 - 补齐古历纪年、儒略历独有闰日、多公历候选、历法改革跨日及精确日期运算接口 - 优化 ΔT、章动、恒星时、月球地平线、事件根搜索和本地星历缓存，降低重复计算开销并提升边界稳定
2026-09-17 12:27:40 +08:00
parent 9ee2163cc7
commit 2bf8478639
428 changed files with 85981 additions and 7998 deletions
@@ -0,0 +1,98 @@
+package basic
+
+import (
+	"math"
+	"testing"
+)
+
+// 未发生阶段的接触时刻必须是 NaN：JD 0 是 −4713-11-24 的真实时刻，不能当“无此阶段”的哨兵。
+
+func TestLunarEclipseAbsentPhasesAreNaN(t *testing.T) {
+	eclipse := LunarEclipse(2458860.0)
+	if eclipse.Type != LunarEclipsePenumbral {
+		t.Fatalf("type = %s, want %s", eclipse.Type, LunarEclipsePenumbral)
+	}
+	if !eclipse.HasPenumbral || eclipse.HasPartial || eclipse.HasTotal {
+		t.Fatalf("unexpected flags: %+v", eclipse)
+	}
+	for name, value := range map[string]float64{
+		"PartialStart": eclipse.PartialStart,
+		"PartialEnd":   eclipse.PartialEnd,
+		"TotalStart":   eclipse.TotalStart,
+		"TotalEnd":     eclipse.TotalEnd,
+	} {
+		if !math.IsNaN(value) {
+			t.Fatalf("%s = %.12f, want NaN", name, value)
+		}
+	}
+	for name, value := range map[string]float64{
+		"PenumbralStart": eclipse.PenumbralStart,
+		"PenumbralEnd":   eclipse.PenumbralEnd,
+		"Maximum":        eclipse.Maximum,
+	} {
+		if !isFiniteFloat(value) {
+			t.Fatalf("%s = %v, want a finite contact", name, value)
+		}
+	}
+}
+
+func TestLunarEclipseWithoutEclipseHasNoContacts(t *testing.T) {
+	// 2025-01-13 的望月没有月食（半影食分 < 0）。
+	eclipse := LunarEclipse(JDECalc(2025, 1, 13))
+	if eclipse.Type != LunarEclipseNone {
+		t.Fatalf("type = %s, want %s", eclipse.Type, LunarEclipseNone)
+	}
+	if eclipse.HasPenumbral || eclipse.HasPartial || eclipse.HasTotal {
+		t.Fatalf("unexpected flags: %+v", eclipse)
+	}
+	for name, value := range map[string]float64{
+		"PenumbralStart": eclipse.PenumbralStart,
+		"PenumbralEnd":   eclipse.PenumbralEnd,
+		"PartialStart":   eclipse.PartialStart,
+		"PartialEnd":     eclipse.PartialEnd,
+		"TotalStart":     eclipse.TotalStart,
+		"TotalEnd":       eclipse.TotalEnd,
+	} {
+		if !math.IsNaN(value) {
+			t.Fatalf("%s = %.12f, want NaN", name, value)
+		}
+	}
+	if !isFiniteFloat(eclipse.Maximum) {
+		t.Fatalf("Maximum = %v, want the geometric extremum", eclipse.Maximum)
+	}
+}
+
+func TestLunarEclipseTotalKeepsAllContactsFinite(t *testing.T) {
+	eclipse := LunarEclipse(JDECalc(2025, 3, 14))
+	if eclipse.Type != LunarEclipseTotal || !eclipse.HasPenumbral || !eclipse.HasPartial || !eclipse.HasTotal {
+		t.Fatalf("unexpected result: %+v", eclipse)
+	}
+	contacts := []float64{
+		eclipse.PenumbralStart, eclipse.PartialStart, eclipse.TotalStart,
+		eclipse.Maximum,
+		eclipse.TotalEnd, eclipse.PartialEnd, eclipse.PenumbralEnd,
+	}
+	for i, value := range contacts {
+		if !isFiniteFloat(value) {
+			t.Fatalf("contact %d = %v, want finite", i, value)
+		}
+		if i > 0 && value <= contacts[i-1] {
+			t.Fatalf("contacts not increasing at %d: %v", i, contacts)
+		}
+	}
+}
+
+func TestLunarEclipseDiagramSkipsAbsentPhases(t *testing.T) {
+	diagram := LunarEclipseDiagram(2458860.0, LunarEclipseDiagramOptions{})
+	if len(diagram.Points) == 0 {
+		t.Fatalf("penumbral eclipse diagram should still have path points")
+	}
+	for _, point := range diagram.Points {
+		if !isFiniteFloat(point.JDE) || !isFiniteFloat(point.X) || !isFiniteFloat(point.Y) {
+			t.Fatalf("non-finite diagram point: %+v", point)
+		}
+	}
+	if empty := LunarEclipseDiagram(JDECalc(2025, 1, 13), LunarEclipseDiagramOptions{}); len(empty.Points) != 0 {
+		t.Fatalf("eclipse-free diagram should have no points, got %d", len(empty.Points))
+	}
+}