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

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

eclipse/svg/doc.go

@@ -0,0 +1,58 @@
+// Package svg 生成日食与月食的 SVG 图件。
+//
+// 可降级的图层用 data-source 标注实际几何来源，取值词表如下；没有降级分支的图层不带该属性。
+//
+//	partial-band-union           偏食可见域填充：权威边界线材与瞬时足迹求并集
+//	sampled-footprint-sweep      偏食可见域填充：逐瞬时足迹扫掠（并集不可用时的降级）
+//	partial-band-contours        偏食可见域边界线
+//	rise-set-phase-lines         初亏、食甚、复圆的日升日落线
+//	magnitude-contours           地方最大食分等值线
+//	greatest-time-isochrones     食甚时刻等时线
+//	besselian-critical-envelope  中心食带：Bessel 临界包络
+//	paired-limit-chords          中心食带：南北限界弦带（包络不可用时的降级）
+//	sampled-open-sweep           中心食带：采样扫掠（前两者都不可用时的降级）
+//	central-path-limits          中心线与南北限界线
+//	penumbral-outlines           瞬时半影轮廓
+//	central-shadow-outlines      瞬时本影、反本影轮廓
+//	p1-p4-visibility-regions     月食可见性分区
+//	p1-p4-horizon-boundaries     月食 P1、P4 地平边界
+//
+// Package svg renders solar- and lunar-eclipse SVG charts. Degradable layers tag the geometry
+// source they actually used in data-source, using exactly the values above.
+package svg
+
+// data-source 词表，见包注释。
+const (
+	eclipseMapSourcePartialBandUnion       = "partial-band-union"
+	eclipseMapSourceSampledFootprintSweep  = "sampled-footprint-sweep"
+	eclipseMapSourcePartialBandContours    = "partial-band-contours"
+	eclipseMapSourceRiseSetPhaseLines      = "rise-set-phase-lines"
+	eclipseMapSourceMagnitudeContours      = "magnitude-contours"
+	eclipseMapSourceGreatestTimeIsochrones = "greatest-time-isochrones"
+	eclipseMapSourceBesselianEnvelope      = "besselian-critical-envelope"
+	eclipseMapSourcePairedLimitChords      = "paired-limit-chords"
+	eclipseMapSourceSampledOpenSweep       = "sampled-open-sweep"
+	eclipseMapSourceCentralPathLimits      = "central-path-limits"
+	eclipseMapSourcePenumbralOutlines      = "penumbral-outlines"
+	eclipseMapSourceCentralShadowOutlines  = "central-shadow-outlines"
+	eclipseMapSourceLunarVisibilityRegions = "p1-p4-visibility-regions"
+	eclipseMapSourceLunarHorizonBoundaries = "p1-p4-horizon-boundaries"
+)
+
+// eclipseMapDataSources 是全部合法取值，测试用它封闭词表。
+var eclipseMapDataSources = []string{
+	eclipseMapSourcePartialBandUnion,
+	eclipseMapSourceSampledFootprintSweep,
+	eclipseMapSourcePartialBandContours,
+	eclipseMapSourceRiseSetPhaseLines,
+	eclipseMapSourceMagnitudeContours,
+	eclipseMapSourceGreatestTimeIsochrones,
+	eclipseMapSourceBesselianEnvelope,
+	eclipseMapSourcePairedLimitChords,
+	eclipseMapSourceSampledOpenSweep,
+	eclipseMapSourceCentralPathLimits,
+	eclipseMapSourcePenumbralOutlines,
+	eclipseMapSourceCentralShadowOutlines,
+	eclipseMapSourceLunarVisibilityRegions,
+	eclipseMapSourceLunarHorizonBoundaries,
+}