panchang-ts 2.1.0 → 3.0.0

package/README.md

@@ -20,6 +20,7 @@ Works offline in React Native (Hermes), Node.js, and browsers.
   - [When to use `getInstantPanchang` vs `getDailyPanchang`](#when-to-use-getinstantpanchang-vs-getdailypanchang)
   - [Options](#options)
   - [Low-level Utilities](#low-level-utilities)
+  - [Birth Chart (Kundli) API](#birth-chart-kundli-api)
 - [Types](#types)
 - [React Native / Hermes](#react-native--hermes)
 - [Accuracy](#accuracy)
@@ -72,7 +73,11 @@ console.log(result.moonrise);                 // Date | null
 
 // Muhurta & inauspicious periods
 console.log(result.brahmaMuhurta);            // { start: Date, end: Date }
+console.log(result.madhyahna);                // solar noon ±24 min
 console.log(result.rahuKalam);                // { start: Date, end: Date }
+console.log(result.anandadiYoga.name);        // "Ananda" (Vara × Nakshatra cycle)
+console.log(result.gandaMula.active);         // false (or true with severity)
+console.log(result.varjyam);                  // { start, end } | null
 
 // Choghadiya — 8 daytime slots
 result.choghadiya.day.forEach(slot => {
@@ -181,13 +186,13 @@ Tithi, Nakshatra, Yoga, Karana, Vara — with transition times throughout the da
 Chandra Masa with Adhika (leap month) detection, both **Purnimanta** (North Indian, default) and **Amanta** (South Indian) systems, Vikram Samvat, Shaka Samvat.
 
 ### Muhurta & Auspicious Timing
-Brahma Muhurta, Abhijit Muhurta, Vijaya Muhurta (11th day-muhurta), Godhuli (sunset muhurta), Nishita (midnight muhurta, used for Shivaratri), nakshatra-keyed Amrit Kala. Choghadiya (16 slots), Gowri Panchangam / Nalla Neram (16 slots), Hora (24 planetary hours), Dur Muhurta (2 inauspicious windows).
+Brahma Muhurta, Abhijit Muhurta, Vijaya Muhurta (11th day-muhurta), Godhuli (sunset muhurta), Nishita (midnight muhurta, used for Shivaratri), **Madhyahna** (solar noon ±24 min ritual window), **Pratah Sandhya** / **Sayahna Sandhya** (asymmetric dawn / dusk twilight windows, width = `nightDuration / 10` — ~62–81 min depending on season, ending *at* sunrise / starting *at* sunset; matches DrikPanchang within ±2 min), classical aliases `dinamanaMinutes` / `ratrimanaMinutes`, nakshatra-keyed Amrit Kala. Choghadiya (16 slots), Gowri Panchangam / Nalla Neram (16 slots), Hora (24 planetary hours), Dur Muhurta (2 inauspicious windows), **Do Ghati Muhurta** (15 day + 15 night ~48-min slots, deity-keyed, no vara rotation), **Panchaka Rahita Muhurta** (slices of the day free of Panchaka), **Anandadi Yoga** (28-name Vara × Nakshatra cycle).
 
 ### Inauspicious Periods
-Rahu Kalam, Gulika Kalam, Yamaganda, Panchaka detection, Bhadra Kala (Vishti karana window with earth / heaven / paatal location).
+Rahu Kalam, Gulika Kalam, Yamaganda, Panchaka detection, Bhadra Kala (Vishti karana window with earth / heaven / paatal location), **Varjyam** (BPHS-keyed forbidden ~96-min window per nakshatra), **Ganda Mula** (Moon in the 6 root nakshatras — Ashwini / Ashlesha / Magha / Jyeshtha / Mula / Revati — with `mild` / `severe` severity).
 
 ### Special Yogas & Festivals
-Amrit Siddhi, Sarvartha Siddhi, Ravi Pushya, Guru Pushya yoga detection.
+Amrit Siddhi, Sarvartha Siddhi, Ravi Pushya, Guru Pushya, **Dwipushkar**, **Tripushkar**, **Jwalamukhi**, **Aadal**, **Vidaal**, **Ravi** yoga detection.
 
 **80+ festivals** spanning pan-Indian, regional, and classical observances:
 
@@ -204,7 +209,10 @@ Amrit Siddhi, Sarvartha Siddhi, Ravi Pushya, Guru Pushya yoga detection.
 Solar & lunar eclipse detection with subtype (partial / total / annular / penumbral), magnitude at peak, observer-horizon visibility, and pre-eclipse **sutak** impurity window.
 
 ### Jyotish (Vedic Astrology)
-All 9 graha positions (geocentric, sidereal) with rashi, nakshatra, pada, and retrograde status. Vimshottari Dasha with Antardasha breakdown — from a birth moment alone or from an explicit Moon longitude. Chandra Balam (transit-Moon favorability relative to janma rashi).
+All 9 graha positions (geocentric, sidereal) with rashi, nakshatra, pada, and retrograde status. Vimshottari Dasha with Antardasha and **Pratyantar** (third-level) breakdown — from a birth moment alone or from an explicit Moon longitude. Chandra Balam (transit-Moon favorability relative to janma rashi). **Tarabala** (9-tara cycle — Janma, Sampat, Vipat, Kshema, Pratyari, Sadhaka, Vadha, Mitra, Ati-Mitra — keyed off janma nakshatra; parallel to Chandra Balam). Optional `nodeType: 'true'` for Rahu/Ketu replaces the mean-node default with Meeus's dominant periodic correction (~±0.6° vs ±2° worst-case for the mean node).
+
+### Birth Chart (Kundli)
+Full natal-chart foundation built on top of the planetary engine: sidereal **Lagna** (ascendant) via Meeus eq. 13.6 (atan2 form); **Bhava** (12 houses) under three configurable house systems — `'whole-sign'` (default classical Vedic), `'equal'`, or `'placidus-kp'`; full **D1 (Rashi)** and **D9 (Navamsa)** charts placing all 9 grahas with house assignments; **Ashtakoot Guna Milan** (36-point marriage compatibility); **Mangal Dosha** (Manglik affliction with cancellations); **Sade Sati** (current Saturn-arc phase + arc start/end dates within ±2 days); **Planetary dignity** (exalted / debilitated / moolatrikona / own / friend / neutral / enemy per BPHS Ch.3-4).
 
 ### Astronomy
 Sunrise, Sunset, Moonrise, Moonset, Chandra Rashi (Moon sign), Surya Nakshatra. Cross-verified across diaspora locations (New York, London, Sydney, Dubai, Singapore) including DST transitions via IANA timezone strings.
@@ -213,7 +221,7 @@ Sunrise, Sunset, Moonrise, Moonset, Chandra Rashi (Moon sign), Surya Nakshatra.
 2 languages: **English** and **Hindi** (Devanagari). All returned display strings respect the `language` option.
 
 ### Configuration
-3 ayanamsa systems (Lahiri, B.V. Raman, KP), 2 masa systems (Purnimanta, Amanta), adjustable precision, optional fast mode (`computeEndTimes: false` for ~5x speedup).
+5 ayanamsa systems (Lahiri, B.V. Raman, KP, **True Chitrapaksha**, **Thirukanitham**), 2 masa systems (Purnimanta, Amanta), 3 house systems (whole-sign, equal, Placidus-KP), adjustable precision, optional fast mode (`computeEndTimes: false` for ~5x speedup).
 
 ---
 
@@ -268,16 +276,27 @@ const result = getDailyPanchang(
 | `moonrise` | `Date \| null` | Moonrise; `null` if none that day |
 | `moonset` | `Date \| null` | Moonset; `null` if none that day |
 | `panchaka` | `boolean` | `true` when Moon is in last 5 nakshatras |
+| `panchakaRahita` | `TimePeriod[]` | Slices of the Hindu day FREE of Panchaka; `[]` when Panchaka pervades the entire day |
+| `doGhatiMuhurta` | `DoGhatiInfo` | 15 day + 15 night ~48-min deity-keyed slots covering sunrise→sunset and sunset→nextSunrise |
+| `gandaMula` | `GandaMulaInfo` | Moon-in-root-nakshatra detection at sunrise; `active: false` for the 21 non-root nakshatras |
+| `anandadiYoga` | `AnandadiYogaInfo` | Vara × Nakshatra 28-name cycle yoga at sunrise |
 | `specialYogas` | `SpecialYogaInfo[]` | Auspicious yogas active today |
 | `durMuhurta` | `[TimePeriod, TimePeriod]` | Two inauspicious ~48-min windows |
 | `vijayaMuhurta` | `TimePeriod` | Vijaya Muhurta — 11th day-muhurta, auspicious for success |
 | `godhuliMuhurta` | `TimePeriod` | Godhuli ("cow-dust") — sunset muhurta, auspicious for ceremonies |
 | `nishitaMuhurta` | `TimePeriod` | Nishita — midnight muhurta, used for Shivaratri and nocturnal rites |
+| `madhyahna` | `TimePeriod` | Madhyahna — solar noon as a ±24-min ritual window (one classical muhurta wide) |
+| `pratahSandhya` | `TimePeriod` | Dawn-twilight ritual window — three nighttime ghatikas ending *at* sunrise (asymmetric; width = `nightDuration / 10` ≈ 62–81 min) |
+| `sayahnaSandhya` | `TimePeriod` | Dusk-twilight ritual window — three nighttime ghatikas starting *at* sunset (asymmetric; width = `nightDuration / 10`) |
+| `dinamanaMinutes` | `number` | Classical alias of `dayDurationMinutes` (sunrise → sunset) |
+| `ratrimanaMinutes` | `number` | Classical alias of `nightDurationMinutes` (sunset → next sunrise) |
 | `amritKala` | `TimePeriod \| null` | Amrit Kala — nakshatra-specific auspicious window (null when nakshatra has none) |
+| `varjyam` | `TimePeriod \| null` | Varjyam (Vishaghati / Nakshatra Thyajyam) — BPHS-keyed forbidden ~96-min window; `null` when none overlaps the Hindu day |
 | `bhadra` | `BhadraInfo \| null` | Bhadra Kala (Vishti karana) window overlapping this Hindu day, or `null` |
 | `eclipse` | `EclipseInfo \| null` | Solar/lunar eclipse overlapping this Hindu day with sutak window, or `null` |
 | `festivals` | `FestivalInfo[]` | Festivals / observances today (filtered by `region` option) |
 | `chandraBalam` | `ChandraBalamInfo?` | Transit-Moon favorability — only present when `janmaRashi` option is passed |
+| `tarabala` | `TarabalaInfo?` | 9-tara cycle position — only present when `janmaNakshatra` option is passed |
 | `ayanamsa` | `number` | Ayanamsa in degrees at sunrise |
 | `siderealSunAtSunrise` | `number` | Sun sidereal longitude at sunrise (degrees) |
 | `siderealMoonAtSunrise` | `number` | Moon sidereal longitude at sunrise (degrees) |
@@ -323,9 +342,12 @@ console.log(result.panchaka);               // false
 | `chandraRashi` | `RashiInfo` | Moon's zodiac sign |
 | `suryaNakshatra` | `RashiInfo` | Sun's nakshatra |
 | `panchaka` | `boolean` | `true` when Moon is in last 5 nakshatras |
+| `gandaMula` | `GandaMulaInfo` | Moon-in-root-nakshatra detection at the queried instant |
+| `anandadiYoga` | `AnandadiYogaInfo` | Vara × Nakshatra 28-name cycle yoga at the queried instant |
 | `specialYogas` | `SpecialYogaInfo[]` | Auspicious yogas at this moment |
 | `festivals` | `FestivalInfo[]` | Festivals / observances at this moment (see caveat below) |
 | `chandraBalam` | `ChandraBalamInfo?` | Transit-Moon favorability — only present when `janmaRashi` option is passed |
+| `tarabala` | `TarabalaInfo?` | 9-tara cycle position — only present when `janmaNakshatra` option is passed |
 | `ayanamsa` | `number` | Ayanamsa in degrees |
 | `siderealSun` | `number` | Sun sidereal longitude (degrees) |
 | `siderealMoon` | `number` | Moon sidereal longitude (degrees) |
@@ -366,6 +388,7 @@ Both functions share the same core astronomy, but `getDailyPanchang` operates on
 | `masaSystem` | `'purnimanta' \| 'amanta'` | `'purnimanta'` | Lunar month naming system. Purnimanta (North Indian) or Amanta (South Indian). |
 | `region` | `FestivalRegion` | `'all'` | Scopes regional festival variants (Pongal, Vishu, Gudi Padwa, Lohri, Govardhan Puja, Bonalu, …) to a specific Indian state. See [`FestivalRegion`](#types) for the full list. Pre-v2.1 values (`'tamil'`, `'bengal'`, `'north-india'`) are still accepted but emit a deprecation warning; removal in v3. Pan-Indian festivals and the canonical `sankranti` event emit regardless of this setting. |
 | `janmaRashi` | `number` | _(omitted)_ | Native's birth Moon rashi index (0 = Mesha … 11 = Meena). When provided, the result includes `chandraBalam`. |
+| `janmaNakshatra` | `number` | _(omitted)_ | Native's birth Moon nakshatra index (0 = Ashwini … 26 = Revati). When provided, the result includes `tarabala`. |
 
 **`InstantPanchangOptions`** (optional for `getInstantPanchang`): same as above but without `timezone` (instant mode works in UTC).
 
@@ -385,6 +408,9 @@ import {
   computeAbhijitMuhurta, computeBrahmaMuhurta,
   computeVijayaMuhurta, computeGodhuliMuhurta,
   computeNishitaMuhurta, computeAmritKala,
+  computeMadhyahna, computePratahSandhya, computeSayahnaSandhya,
+  computeVarjyam, computeGandaMula,
+  computeAnandadiYoga, computePanchakaRahita, computeDoGhati,
   computeGowriPanchangam,
   // Eclipses (signature: (fromUtc, location, withinDays))
   getUpcomingSolarEclipse, getUpcomingLunarEclipse, getEclipseDuringDay,
@@ -392,6 +418,7 @@ import {
   computePlanetaryPositions,
   computeVimshottariDasha, computeVimshottariDashaFromBirth,
   computeChandraBalam,
+  computeTarabala,
   GRAHA_ABBR,
 } from 'panchang-ts';
 
@@ -444,8 +471,122 @@ const cb = computeChandraBalam(3 /* Karka */, 6 /* Tula */);
 console.log(cb.house);        // 4
 console.log(cb.quality);      // "weak"
 console.log(cb.englishName);  // "Ashubha"
+
+// Tarabala — 9-tara cycle from janma nakshatra → transit Moon nakshatra.
+// Inputs are 0-indexed nakshatra (0 = Ashwini ... 26 = Revati).
+const tb = computeTarabala(0 /* janma: Ashwini */, 4 /* transit: Mrigashira */);
+console.log(tb.taraIndex);    // 4
+console.log(tb.englishName);  // "Pratyari"
+console.log(tb.quality);      // "inauspicious"
+```
+
+---
+
+### Birth Chart (Kundli) API
+
+Vedic kundli foundation. Each helper is independent — calling birth-chart APIs
+does **not** add any work to `getDailyPanchang`.
+
+```typescript
+import {
+  computeLagna, computeBhava,
+  computeRashiChart, computeNavamsa,
+  computeAshtakoot, computeMangalDosha, computeSadeSati,
+  computeDignity, computeVimshottariPratyantar,
+  computeVimshottariDashaFromBirth,
+} from 'panchang-ts';
+
+const birth = new Date('1995-08-15T05:30:00Z');           // 11:00 IST
+const loc   = { latitude: 28.6139, longitude: 77.2090 };  // New Delhi
+
+// 1. Lagna (sidereal ascendant)
+const lagna = computeLagna(birth, loc, 'lahiri', 'en');
+//   → { siderealLongitude, rashi: { index, name }, degreeInRashi,
+//        nakshatra: { index, name }, pada }
+
+// 2. Bhava (12 houses) under any of three systems
+const houses = computeBhava(birth, loc, { houseSystem: 'whole-sign' });
+//   → { system, houses: HouseInfo[12], ascendantLongitude, mcLongitude }
+//   - 'whole-sign'  (default) — each rashi is one house, cusps at 0°
+//   - 'equal'       — each house spans 30° starting at lagna's exact degree
+//   - 'placidus-kp' — true cuspal positions; throws PanchangError('CIRCUMPOLAR')
+//                     above ~|66.5°| latitude
+
+// 3. D1 (Rashi) chart — lagna + bhava + 9 grahas with house placement
+const d1 = computeRashiChart(birth, loc, { houseSystem: 'whole-sign' });
+//   → { divisional: 'D1', lagna, bhava, planets: PlanetPlacement[9] }
+d1.planets.find((p) => p.planet === 'Jupiter')?.house;   // e.g. 5
+d1.planets.find((p) => p.planet === 'Saturn')?.isRetrograde;
+
+// 4. D9 (Navamsa) chart — classical sign-based per-rashi-type rule
+const d9 = computeNavamsa(birth, loc);
+//   → { divisional: 'D9', lagnaRashi, planets: PlanetPlacement[9] }
+
+// 5. Ashtakoot Guna Milan — 36-point marriage compatibility from natal Moons
+const ashtakoot = computeAshtakoot(
+  { rashi: 4, nakshatra: 9 },   // boy:  Simha / Magha
+  { rashi: 0, nakshatra: 1 },   // girl: Mesha / Bharani
+);
+//   → { totalScore: 0..36, koots: KootScore[8], cancellations: string[] }
+//   koots in canonical order: Varna, Vashya, Tara, Yoni, Graha Maitri, Gana,
+//   Bhakoot, Nadi (max scores 1, 2, 3, 4, 5, 6, 7, 8 respectively)
+
+// 6. Mangal Dosha (Manglik) — checks Mars from lagna, Moon, and Venus
+const mangal = computeMangalDosha(d1);
+//   → { afflicted: boolean,
+//        fromLagna: { afflicted, house }, fromMoon: ..., fromVenus: ...,
+//        cancellations: string[] }
+
+// 7. Sade Sati — Saturn currently transiting 12th, 1st, or 2nd from natal Moon
+const sadeSati = computeSadeSati(d1.planets[1]!.rashi.index, new Date());
+//   → { active, phase: 1|2|3|null, currentArcStart, currentArcEnd, nextArcStart }
+
+// 8. Planetary dignity (BPHS Ch.3-4)
+computeDignity('Mars',    0);   // 'moolatrikona' (Aries)
+computeDignity('Mars',    9);   // 'exalted' (Capricorn)
+computeDignity('Sun',     6);   // 'debilitated' (Libra)
+computeDignity('Saturn', 10);   // 'moolatrikona' (Aquarius)
+
+// 9. Pratyantar (3rd-level) Vimshottari sub-sub-periods
+const dasha = computeVimshottariDashaFromBirth(birth);
+const firstAntar = dasha.mahaDashas[0]!.antarDashas[0]!;
+const pratyantars = computeVimshottariPratyantar(firstAntar);
+//   → PratyantarDasha[9] — 9 sub-sub-periods covering the antardasha proportionally
 ```
 
+**Ayanamsa options** — any birth-chart helper accepts the new
+`'true-chitra'` (True Chitrapaksha — Spica-anchored) or `'thirukanitham'`
+(South Indian Tamil-Vakya tradition) ayanamsas in addition to the original
+`'lahiri'`, `'raman'`, `'krishnamurti'`. Pass via the `options.ayanamsa`
+field on `BirthChartOptions`.
+
+**True Rahu/Ketu node** — `computePlanetaryPositions(date, ayanamsa, …, 'true')`
+or `options.nodeType: 'true'` on the chart helpers replaces the mean-node
+default with Meeus's dominant periodic correction (`-1.4979°·sin(2D-2F)`).
+Typical accuracy improves from ±0.5° (worst ±2°) on the mean node to
+±0.6° on the true node.
+
+**Documented limitations:**
+
+- **Mangal Dosha cancellations**: only Mars in own sign (Aries/Scorpio) or
+  exalted (Capricorn). Other classical cancellations — mutual Mangalik,
+  Mars-Jupiter aspect, Mars-Saturn conjunction — are not applied.
+- **Sade Sati boundary precision**: ±1-2 days. Saturn retrograde re-crossings
+  of a rashi boundary within a 90-day window are absorbed; longer dips are
+  treated as boundary events. Both first-touch and permanent-ingress
+  conventions are within tolerance.
+- **Placidus-KP**: throws `PanchangError('CIRCUMPOLAR')` at high latitudes
+  where the cusp's semi-diurnal arc doesn't exist. Use `'whole-sign'` or
+  `'equal'` north of the Arctic Circle / south of the Antarctic Circle.
+- **Navamsa (D9)**: longitude is scaled (3°20' source arc → 30° D9 arc) so
+  `degreeInRashi` is meaningful within the navamsa rashi. Houses are
+  whole-sign relative to the navamsa lagna (the classical Vedic convention).
+- **Ashtakoot Vashya koot**: simplified single-vashya per rashi (half-sign
+  nuance — e.g. Sagittarius's centaur first half — is collapsed).
+- **True node**: only the dominant Meeus Ch.47 perturbation term is applied.
+  Higher-order (sub-arcminute) corrections are omitted; for KP-style
+  sub-arcminute work, use a dedicated KP node calculator.
+
 ---
 
 ## Types
@@ -594,8 +735,16 @@ interface HoraInfo {
 
 ```typescript
 interface SpecialYogaInfo {
-  name: string;    // e.g. "Guru Pushya Yoga"
-  type: 'amrit_siddhi' | 'sarvartha_siddhi' | 'ravi_pushya' | 'guru_pushya';
+  name: string;    // e.g. "Guru Pushya Yoga", "Dwipushkar Yoga"
+  type:
+    | 'amrit_siddhi' | 'sarvartha_siddhi' | 'ravi_pushya' | 'guru_pushya'
+    // Vara × Tithi × Nakshatra patterns + Moon-from-Sun distance yogas
+    | 'dwipushkar'   // Bhadra-tithi + Bhadra-vara + nakshatra ∈ {Mrigashira, Chitra, Dhanishtha} — actions doubled
+    | 'tripushkar'   // same Bhadra-tithi/vara + nakshatra ∈ {Krittika, Punarvasu, U.Phalguni, Vishakha, U.Ashadha, P.Bhadrapada} — actions tripled
+    | 'jwalamukhi'   // inauspicious — tithi × nakshatra lookup per Muhurta-chintamani 6.32
+    | 'aadal'        // auspicious — Moon-from-Sun nakshatra-distance (28-scheme) ∈ {2,7,9,14,16,21,23,28}
+    | 'vidaal'       // inauspicious — Moon-from-Sun nakshatra-distance (28-scheme) ∈ {3,6,10,13,17,20,24,27}
+    | 'ravi';        // auspicious — Moon-from-Sun nakshatra-distance (27-scheme) ∈ {4,6,9,10,13,20}
 }
 
 interface FestivalInfo {
@@ -753,6 +902,15 @@ interface ChandraBalamInfo {
   englishName: string;                 // "Shubha" | "Ashubha"
   name: string;                        // localized
 }
+
+interface TarabalaInfo {
+  taraIndex: number;                   // 0..8 — position in the 9-tara cycle from janma nakshatra
+  englishName: string;                 // "Janma" | "Sampat" | "Vipat" | "Kshema" | "Pratyari"
+                                       // | "Sadhaka" | "Vadha" | "Mitra" | "Ati-Mitra"
+  name: string;                        // localized
+  quality: 'auspicious' | 'inauspicious';
+                                       // 'inauspicious' for Vipat (2) / Pratyari (4) / Vadha (6); rest auspicious
+}
 ```
 </details>
 
@@ -788,10 +946,10 @@ InteractionManager.runAfterInteractions(() => {
 
 ## Accuracy
 
-5,073 tests passing, including fixtures cross-verified against
-reference panchang calculations spanning 2025–2026 across Delhi, Chennai,
-New York, London, Sydney, Dubai, and Singapore (diaspora fixtures cover
-DST transitions on `America/New_York`).
+6,912 tests passing across 74 files, including fixtures cross-verified
+against reference panchang calculations spanning 2025–2026 across 10
+Indian cities, plus New York, London, Sydney, Dubai, and Singapore
+(diaspora fixtures cover DST transitions on `America/New_York`).
 
 | Element | Accuracy | Validation |
 |---------|----------|------------|
@@ -802,9 +960,19 @@ DST transitions on `America/New_York`).
 | Ayanamsa | ±0.005° vs Swiss Ephemeris | Unit tests |
 | Planetary positions (Sun–Saturn) | **±0.02° vs reference sidereal** | Fixtures |
 | Planetary positions (Rahu/Ketu, mean node) | ≤0.5° typical; ±2° tolerance to absorb mean-vs-true drift | Fixtures |
+| Planetary positions (Rahu/Ketu, true node — `nodeType: 'true'`) | ≤0.6° typical (Meeus periodic correction) | Fixtures |
 | Rashi / Nakshatra / Retrograde flag | Exact match vs reference | Fixtures |
 | Festival dates | 12 cross-verified festivals (2025–2026) — see caveats below | Fixtures |
 | Choghadiya / Hora / Gowri slots | Derived from sunrise/sunset — inherits ±2 min | — |
+| Madhyahna midpoint, Anandadi Yoga name, Ganda Mula active flag | **Exact match across 50 reference fixtures** (10 cities × 5 dates) | Cross-verify suite |
+| Pratah / Sayahna Sandhya start + end | **±2 min** across all 50 fixtures | Cross-verify suite |
+| Varjyam start + end | **±2 min** on every fixture where the library emits a non-null window (≥30 of 50 emit; transition days return `null` by design) | Cross-verify suite |
+| Lagna (ascendant) sidereal longitude | Cross-checked against Jagannath Hora reference charts | Birth-chart fixtures |
+| D1 (Rashi) & D9 (Navamsa) house placements | Exact match vs reference for 9-graha placement | Birth-chart fixtures |
+| Ashtakoot Guna Milan total score | ±1 point per pair across 30+ matched pairs | Match fixtures |
+| Sade Sati arc start / end | ±1–2 days vs authoritative ephemerides | Saturn-transit fixtures |
+
+**Detection sourcing notes.** **Aadal / Vidaal** follow the classical Moon-from-Sun nakshatra-distance rule (AstroShastra, HoraSarvam, Ernst Wilhelm), NOT the popular Tamil-Vakya weekday rule used by some online panchangs — output may therefore differ from sites that use the weekday rule. **Varjyam** emits the sunrise-anchored nakshatra's window only — printed panchangs may show a second window on nakshatra-transition days. **Do Ghati Muhurta** does not rotate by weekday: the same 30-name deity-keyed sequence applies every day, verified against multiple reference sources for distinct weekdays.
 
 ### Festival Detection — Documented Tradeoff