• v0.1.1 Stable

    b612 released this 2026-05-03 20:12:20 +08:00 | 0 commits to master since this release

    中文

    Added

    • 新增水星、金星地心凌日查询能力,提供 NextTransit / LastTransit / ClosestTransit,返回一触、二触、凌甚、三触、四触、持续时间、最小角距离和视半径等信
      息。
    • basic 层新增通用 PlanetTransitResult,并提供水星/金星凌日搜索入口,供上层包复用。
    • eclipse 新增本地可见日全食、日环食、月全食专项搜索接口:
    • LastLocalTotalSolarEclipse / NextLocalTotalSolarEclipse / ClosestLocalTotalSolarEclipse
    • LastLocalAnnularSolarEclipse / NextLocalAnnularSolarEclipse / ClosestLocalAnnularSolarEclipse
    • LastLocalTotalLunarEclipse / NextLocalTotalLunarEclipse / ClosestLocalTotalLunarEclipse
    • 新接口返回 (info, ok),可明确区分“找到事件”和“搜索范围内无结果”。

    Changed

    • 优化日食、月食搜索流程:增加食季跳步和黄纬预筛,减少非食季朔望月的无效精算。
    • 沙罗周期匹配改用压缩锚点表快速匹配,并保留回退 walk 逻辑,提升查询效率且维持边界兼容。
    • 本地中心食搜索现在要求中心阶段可见,避免只在偏食阶段可见时误报为本地可见日全食/日环食/月全食。
    • README 中英文文档同步补充了中心食专项搜索接口、水星/金星凌日示例和能力清单。

    English

    Added

    • Added geocentric Mercury and Venus transit queries via NextTransit / LastTransit / ClosestTransit, returning first contact, second contact,
      greatest transit, third contact, fourth contact, duration, minimum separation, and apparent semidiameters.
    • Added the shared PlanetTransitResult type in basic, with Mercury/Venus transit search entry points for upper-layer packages.
    • Added dedicated local visible total solar eclipse, annular solar eclipse, and total lunar eclipse search APIs in eclipse:
    • LastLocalTotalSolarEclipse / NextLocalTotalSolarEclipse / ClosestLocalTotalSolarEclipse
    • LastLocalAnnularSolarEclipse / NextLocalAnnularSolarEclipse / ClosestLocalAnnularSolarEclipse
    • LastLocalTotalLunarEclipse / NextLocalTotalLunarEclipse / ClosestLocalTotalLunarEclipse
    • New search APIs return (info, ok) to distinguish found events from no result within the search range.

    Changed

    • Optimized solar and lunar eclipse search with eclipse-season skipping and latitude prefiltering, reducing unnecessary full calculations outside eclipse
      seasons.
    • Reworked Saros matching to use compressed anchor tables with a walk fallback, improving lookup efficiency while preserving edge-case compatibility.
    • Local central-eclipse searches now require the central phase to be visible, avoiding false positives where only the partial phase is observable.
    • Updated Chinese and English README files with central-eclipse search APIs, Mercury/Venus transit examples, and capability lists.
    Downloads