tithi_engine 2.0.1

Accurate Vedic tithi, lunar month, and festival date calculator for any city worldwide. Pure Dart, no dependencies, 200-year accuracy (1900–2100).

Changelog

2.0.1

Tooling/formatting only — no API or behavior change (golden hash ef8a845c5a74b8c6 unchanged).

• Apply dart format to all sources (2.0.0 shipped unformatted files, costing pub.dev points).
• Add tools/preflight.sh (format → analyze --fatal-infos → test → publish dry-run) and make CI run the format check first with --fatal-infos.
• Exclude dev-only tools/ and coverage/ from the published package via .pubignore.

2.0.0

Major redesign: a single public entry point and registration-based city data, mirroring the Java tithi-engine. Numerical output is unchanged — a facade-driven golden parity test reproduces the locked characterization hash ef8a845c5a74b8c6 (39,710 lines) bit-for-bit.

Breaking changes

• Panchang is the single public entry point. The barrel (package:tithi_engine/tithi_engine.dart) no longer exports the engine internals — TithiCalculator, the tithi-number utilities (getTithiName / getPaksha / tithiInPaksha / calculateTithi), convertMonth, and the free functions findFestivalDate / findRecurringDates. Drive everything through Panchang (dateFor / recurringDates / …).
• Panchang requires a city-data registrar list; the zero-arg constructor is removed:

  Panchang(List<void Function()> data, {MonthSystem system = MonthSystem.purnimant})
  // e.g. Panchang([registerAllCities])  or  Panchang([registerIndia])
  

  This makes it impossible to construct a Panchang without city data (no silent Meeus fallback) while letting the tree-shaker drop unused cities.
• City data is registration-based. The core holds a mutable registry that consumers populate via data packs; the static all-cities registry is gone.
  • package:tithi_engine/data/all.dart → registerAllCities() (all 230 cities)
  • package:tithi_engine/data/india.dart → registerIndia() (30 cities; region pack)
  • A city that is never registered resolves to empty corrections (Meeus fallback).
  • Subset win: importing only data/india.dart compiles to ~112 KB JS vs ~404 KB for all-cities (−72%) — the tree-shaker drops unused cities.

Added

• Panchang.forDate(date, city, {utcOffset}) — time-of-day (birth-time) precision.
• Panchang.recurringDates(festival, year, city) → List<FestivalDate>.
• Panchang.transitionTime(date, {utcOffset}) — intra-day tithi transition moment.
• TithiInfo.fromStored({tithiNumber, month, storedSystem, isAdhika, displaySystem}) — render a saved tithi, with optional Purnimant↔Amant month-name conversion.
• Re-exported tithiNames (the 15 canonical names).
• Region data packs + registerCity / idempotent registrars.

Performance

• Per-city LunarMonthResolver caching: non-default cities no longer rebuild the resolver (and recompute month spans) on every call. Month-grid latency for non-default cities dropped ~27–54× (e.g. Seattle 53,168 → 993 µs/grid); all cities now converge to ~1 ms/grid.

Tests

• Public-API + day-level coverage (getDate/findNext/transitionTime, time-of-day forDate, TithiInfo.fromStored, Meeus fallback, registry contract, day-level vriddhi/kshaya). Core line coverage ~87%, 520 tests.

1.0.9

• Fix kshaya tithi detection at 30→1 wraparound (Shukla Pratipada)
• Fix kshaya detection at month span start (e.g. Krishna Pratipada in Purnimant)
• Affected: findInYear now correctly returns the previous day for skipped tithis

1.0.8

• Fix medellín directory encoding issue (CI)
• 230 cities total

1.0.7

• Add 21 cities (230 total): Honolulu, Tampa, Pittsburgh, Columbus, Indianapolis, Kansas City, St. Louis, Sacramento, Halifax, Regina, Gothenburg, Lyon, Naples, Zagreb, Krakow, Thessaloniki, Porto, Rotterdam, Beirut, Ankara, Redmond

1.0.0

• Initial release
• Tithi calculation: date → tithi number, name, paksha, lunar month
• Festival dates with muhurta rules (nishita, madhyahna, pradosh, sunrise)
• Month resolution: adhika/kshaya detection, Purnimant & Amant systems
• Date finding: tithi → Gregorian date(s) in any year
• 157 supported cities with per-city sunrise corrections
• 200-year accuracy (1900–2100), validated against Swiss Ephemeris

1.0.6

• Fix dart format for all generated files
• CI green (actions/checkout@v5)

1.0.5

• Fix LICENSE: use exact canonical Apache 2.0 text from apache.org

1.0.4

• Fix LICENSE recognition (full Apache 2.0 text for pub.dev detection)
• Fix all static analysis issues (50/50 pub.dev score)

1.0.3

• Reduce package size by 67% (1.8 MB → 586 KB) by stripping date comments from correction files
• No API or behavior change

1.0.2

• Expand city coverage from 157 → 209 cities worldwide
• New regions: Pakistan (3), Caribbean (5), Africa (7), Europe (12), Americas (12), Asia (4), Oceania (3)
• All new cities verified 100% accurate against Swiss Ephemeris (1900–2100)

1.0.1

• Export additional symbols: getPaksha, tithiInPaksha, calculateTithi, convertMonth