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

- 新增日月食中心带、偏食带、阴影足迹、等时线、食分线及升落边界计算，支持极区与混合食拓扑
- 新增日食单时刻阴影求解器、站心状态查询、批量采样和 ΔT 覆盖接口
- 重构恒星与行星月掩路径，补充有限盘面接触、站心修正、掩带宽度、极区投影及升落边界
- 扩展 SVG 与 GeoJSON 输出，支持详细面板、全球/极区/地球投影、边界闭合、时间标记和拓扑签名
- 扩展日月食候选搜索、局地搜索、沙罗序列预计算与范围外推，补充系列锚点和成员一致性校验
- 补齐古历纪年、儒略历独有闰日、多公历候选、历法改革跨日及精确日期运算接口
- 优化 ΔT、章动、恒星时、月球地平线、事件根搜索和本地星历缓存，降低重复计算开销并提升边界稳定

basic/greatest_time_contour_test.go

@@ -0,0 +1,66 @@
+package basic
+
+import (
+	"testing"
+	"time"
+)
+
+// 对齐网格是导出行为（等时线按整刻度取值）的契约，取值本身写成字面量以免与实际生成函数互相自证。
+func TestGreatestTimeContourAlignedLevelsGridContracts(t *testing.T) {
+	tt := func(hour, minute int) float64 {
+		return TD2UT(Date2JDE(time.Date(2024, 1, 1, hour, minute, 0, 0, time.UTC)), true)
+	}
+	cases := []struct {
+		name       string
+		start, end float64
+		step       time.Duration
+		maxLevels  int
+		want       []string
+	}{
+		{
+			name: "起点在刻度之间时从下一个整刻度开始", start: tt(0, 7), end: tt(2, 7),
+			step: 30 * time.Minute, maxLevels: 64,
+			want: []string{"2024-01-01T00:30:00Z", "2024-01-01T01:00:00Z", "2024-01-01T01:30:00Z", "2024-01-01T02:00:00Z"},
+		},
+		{
+			name: "起点恰在刻度上时不重复生成该刻度", start: tt(0, 30), end: tt(2, 0),
+			step: 30 * time.Minute, maxLevels: 64,
+			want: []string{"2024-01-01T00:30:00Z", "2024-01-01T01:00:00Z", "2024-01-01T01:30:00Z", "2024-01-01T02:00:00Z"},
+		},
+		{
+			name: "终点恰在刻度上时包含终点", start: tt(0, 7), end: tt(1, 30),
+			step: 30 * time.Minute, maxLevels: 64,
+			want: []string{"2024-01-01T00:30:00Z", "2024-01-01T01:00:00Z", "2024-01-01T01:30:00Z"},
+		},
+		{
+			name: "上限截断", start: tt(0, 7), end: tt(5, 7),
+			step: 30 * time.Minute, maxLevels: 3,
+			want: []string{"2024-01-01T00:30:00Z", "2024-01-01T01:00:00Z", "2024-01-01T01:30:00Z"},
+		},
+		{
+			name: "窗口内没有整刻度时为空", start: tt(0, 1), end: tt(0, 20),
+			step: time.Hour, maxLevels: 64,
+			want: nil,
+		},
+		{
+			name: "非正步长或倒置窗口为空", start: tt(0, 7), end: tt(2, 7),
+			step: 0, maxLevels: 64, want: nil,
+		},
+	}
+	for _, testCase := range cases {
+		levels := greatestTimeContourAlignedLevels(testCase.start, testCase.end, testCase.step, testCase.maxLevels)
+		if len(levels) != len(testCase.want) {
+			t.Fatalf("%s: %d levels, want %d", testCase.name, len(levels), len(testCase.want))
+		}
+		for index, level := range levels {
+			got := level.at.UTC().Format(time.RFC3339)
+			if got != testCase.want[index] {
+				t.Fatalf("%s: level %d at %s, want %s", testCase.name, index, got, testCase.want[index])
+			}
+			// 标注时刻与求根时刻必须成对：TT 往返 1 ULP 内一致。
+			if roundTrip := greatestTimeContourUTCToTT(level.at); roundTrip != level.tt {
+				t.Fatalf("%s: level %d tt %.9f != %.9f", testCase.name, index, level.tt, roundTrip)
+			}
+		}
+	}
+}