moon-sighting-dart/CHANGELOG.md
2026-05-29 06:34:31 -04:00

1.3 KiB

Changelog

All notable changes to this project will be documented in this file.

The format follows Keep a Changelog. This project adheres to Semantic Versioning.

[1.0.0] - 2026-05-25

Added

  • Initial public release.
  • getMoonPhase — returns moon phase name and illumination percentage for any date.
  • getMoonPosition — computes topocentric altitude and azimuth using Meeus Chapter 47 algorithms.
  • getMoon — combined output: phase, position, and illumination in one call.
  • getMoonVisibilityEstimate — Yallop and Odeh crescent visibility criteria.
  • nearestNewMoon — finds the next or previous new moon from a given date.
  • arcvMinimum — polynomial helper for Yallop arc of vision minimum.
  • distanceKm — lunar distance in kilometres.
  • Meeus lite algorithms (Astronomical Algorithms, Jean Meeus, 2nd ed.) — no JPL ephemeris dependency.
  • Pure Dart implementation. Zero runtime dependencies.
  • Dart SDK ^3.7.0 compatibility.
  • 64 unit tests covering all 7 SPORT features.

Notes

This package uses Meeus lite algorithms with approximately 0.3 degree positional accuracy. The companion JavaScript package (moon-sighting on npm) uses JPL DE442S ephemeris for sub-arcminute precision. Use the JS package when observatory-grade accuracy is required.