panchang-ts 2.0.1 → 2.4.0

package/README.md

@@ -72,7 +72,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 => {
@@ -139,6 +143,37 @@ console.log(amanta.chandramasa.name);         // Amanta month name
 console.log(amanta.chandramasa.system);       // "amanta"
 ```
 
+### Regional Festival Filtering
+
+The `region` option scopes regional festival variants to one Indian state.
+Pan-Indian festivals (Diwali, Holi, Raksha Bandhan, the canonical
+`sankranti` event, …) emit regardless.
+
+```typescript
+// Default — every regional variant emits on Makar Sankranti day:
+const all = getDailyPanchang(jan14, chennai, { timezone: 330 });
+all.festivals.map(f => f.name);
+// → ["Sankranti", "Makar Sankranti", "Pongal", "Uttarayan",
+//    "Magh Bihu", "Ayyappa Makara Jyothi"]
+
+// Scope to Tamil Nadu — drops Bihu/Ayyappa/Uttarayan:
+const tn = getDailyPanchang(jan14, chennai, { timezone: 330, region: 'tamil-nadu' });
+tn.festivals.map(f => f.name);
+// → ["Sankranti", "Makar Sankranti", "Pongal"]
+
+// Lohri fires on the Hindu day BEFORE Makara transit, scoped to Punjab/
+// Haryana/Himachal — no extra wiring required, just the region option:
+const lohri = getDailyPanchang(jan13, amritsar, { timezone: 330, region: 'punjab' });
+lohri.festivals.some(f => f.name === 'Lohri');  // true
+
+// Pre-v2.1 region values still work but log a one-shot deprecation warning:
+getDailyPanchang(date, loc, { timezone: 330, region: 'tamil' });
+// console.warn: [panchang-ts] FestivalRegion 'tamil' is deprecated;
+//               use 'tamil-nadu'. Legacy value will be removed in v3.
+```
+
+See [`FestivalRegion`](#types) for the full state-slug list (21 states + `'nepal'`).
+
 ---
 
 ## Features
@@ -150,20 +185,21 @@ 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.
 
-**60+ festivals** spanning pan-Indian, regional, and classical observances:
+**80+ festivals** spanning pan-Indian, regional, and classical observances:
 
 - **Ekadashi** — 26 named variants (Putrada, Shat Tila, Nirjala, Devshayani, etc.) with **Smarta / Vaishnava split** via Dashami-viddha rule; Smarta fast emits a `deferralDate` for Dwadashi.
 - **Pradosha** — 7 weekday-qualified variants (Som Pradosh, Bhauma Pradosh, Shani Pradosh, etc.) firing on both Shukla & Krishna paksha.
-- **Sankranti** — transit-based solar-month boundary detection plus regional variants (**Pongal**, **Vishu**, **Baisakhi**, **Magh Bihu**, **Ayyappa Makara Jyothi**) scoped by the `region` option.
+- **Sankranti** — transit-based solar-month boundary detection plus regional variants (**Pongal**, **Vishu**, **Baisakhi**, **Pohela Boishakh**, **Bohag Bihu**, **Magh Bihu**, **Kati Bihu**, **Uttarayan**, **Ayyappa Makara Jyothi**, **Raja Sankranti**, **Harela**, **Sair**, **Singh Sankranti**) scoped by the `region` option. **Lohri** fires on the Hindu day immediately preceding Makara Sankranti under Punjab/Haryana/Himachal scopes.
 - **Canonical-time classical festivals** — Ganesh Chaturthi (madhyahna), Shivaratri (nishita), Diwali, Holi, Raksha Bandhan (Bhadra-aware, suppressed when Bhadra straddles Purnima), Karva Chauth (chandrodaya), Janmashtami, Dussehra, Navaratri, Ram Navami, Hanuman Jayanti, **Akshaya Tritiya & Parashurama Jayanti** (madhyahna-vyapini, co-emitted on Vaishakha Shukla Tritiya), Makar Sankranti.
+- **Regional festivals (v2.1)** — **Gudi Padwa** (Maharashtra/Goa), **Gangaur** (Rajasthan), **Karaga** (Karnataka), **Bonalu** (Telangana, recurring Sundays in Ashadha), **Varamahalakshmi** (last Friday of Shravana Shukla before Purnima, Karnataka/AP/Telangana/Tamil Nadu), **Bathukamma** (Telangana — Engili Pula + Saddula markers), **Hariyali / Kajari / Hartalika Teej**, **Govardhan Puja**, **Bhai Dooj**, **Phagli** (Himachal), **Jagannath Rath Yatra** (pan-Indian, Ashadha Shukla Dwitiya), **Raja Parba** 3-day arc (Odisha — Pahili / Sankranti / Basi) — all filtered by per-state allow-lists on the rule.
 - **Regional & seasonal** — Chhath (4-day sequence), Vat Savitri, Upakarma (3 shakha variants via nakshatra+chandraMasa), Onam (nakshatra+solarMasa).
 - **Monthly observances** — Masik Shivaratri, Vinayaka Chaturthi (suppressed in Maha-month), **Masik Karthigai** (any day Krittika nakshatra prevails — sampled at sunrise / midday / sunset / nishita), Pushya days, Shravan Somvar and other month+weekday patterns.
 - Adhika (leap) months auto-skipped for tithi-based rules; Purnimanta naming respected.
@@ -172,7 +208,7 @@ 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 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).
 
 ### 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.
@@ -236,16 +272,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) |
@@ -291,9 +338,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) |
@@ -332,8 +382,9 @@ Both functions share the same core astronomy, but `getDailyPanchang` operates on
 | `computeEndTimes` | `boolean` | `true` | Set `false` for ~5x faster, names-only output |
 | `precision` | `'standard' \| 'high'` | `'standard'` | Binary-search iterations (15 vs 25). High precision is rarely needed. |
 | `masaSystem` | `'purnimanta' \| 'amanta'` | `'purnimanta'` | Lunar month naming system. Purnimanta (North Indian) or Amanta (South Indian). |
-| `region` | `FestivalRegion` | `'all'` | Scopes regional festival variants (Pongal, Vishu, Baisakhi, Bihu, Ayyappa, etc.). See [`FestivalRegion`](#types) for supported values. The canonical pan-Indian `sankranti` event is always emitted regardless. |
+| `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).
 
@@ -353,6 +404,10 @@ import {
   computeAbhijitMuhurta, computeBrahmaMuhurta,
   computeVijayaMuhurta, computeGodhuliMuhurta,
   computeNishitaMuhurta, computeAmritKala,
+  // Phase 28 — daily-parity muhurtas + nakshatra-keyed inauspicious windows
+  computeMadhyahna, computePratahSandhya, computeSayahnaSandhya,
+  computeVarjyam, computeGandaMula,
+  computeAnandadiYoga, computePanchakaRahita, computeDoGhati,
   computeGowriPanchangam,
   // Eclipses (signature: (fromUtc, location, withinDays))
   getUpcomingSolarEclipse, getUpcomingLunarEclipse, getEclipseDuringDay,
@@ -360,6 +415,7 @@ import {
   computePlanetaryPositions,
   computeVimshottariDasha, computeVimshottariDashaFromBirth,
   computeChandraBalam,
+  computeTarabala,
   GRAHA_ABBR,
 } from 'panchang-ts';
 
@@ -412,6 +468,13 @@ 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"
 ```
 
 ---
@@ -562,8 +625,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'
+    // Phase 28-6 — 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 {
@@ -582,17 +653,56 @@ interface FestivalInfo {
   deferralDate?: Date;
 }
 
+// State-slug scheme. A caller sets `region` to limit regional variants to
+// their state; pan-Indian festivals (Holi, Diwali, Sankranti itself, …)
+// emit regardless.
 type FestivalRegion =
-  | 'all'           // default — emits every regional variant
-  | 'north-india'
-  | 'tamil'
-  | 'kerala'
-  | 'bengal'
-  | 'punjab'
-  | 'gujarat'
-  | 'assam'
-  | 'maharashtra';
+  | 'all'             // default — emits every regional variant
+  // South
+  | 'tamil-nadu' | 'kerala' | 'karnataka' | 'andhra-pradesh' | 'telangana'
+  // East
+  | 'west-bengal' | 'odisha' | 'assam' | 'bihar' | 'jharkhand'
+  // West
+  | 'gujarat' | 'maharashtra' | 'goa' | 'rajasthan'
+  // North / Central
+  | 'punjab' | 'haryana' | 'himachal-pradesh' | 'uttarakhand'
+  | 'uttar-pradesh' | 'madhya-pradesh'
+  // Neighbour
+  | 'nepal';
+
+// Pre-v2.1 identifiers. Accepted as input and mapped at call time; a
+// one-shot console warning fires per distinct legacy value. Removal in v3.
+//   'tamil'       → 'tamil-nadu'
+//   'bengal'      → 'west-bengal'
+//   'north-india' → 'all'       (Makar Sankranti is pan-Indian; use state
+//                                slugs for Lohri / Govardhan / Bhai Dooj)
+type LegacyFestivalRegion = 'tamil' | 'bengal' | 'north-india';
 ```
+
+**Region-scoped festivals** (non-exhaustive — see `src/core/festivals.ts`):
+
+| Region | Festival names (keys) |
+|---|---|
+| `tamil-nadu` | pongal, puthandu, varamahalakshmi |
+| `kerala` | vishu, ayyappa_makara_jyothi, onam *(solar-nakshatra)* |
+| `karnataka` | karaga, varamahalakshmi |
+| `andhra-pradesh` | varamahalakshmi |
+| `telangana` | bonalu, varamahalakshmi, bathukamma_start, bathukamma_saddula |
+| `west-bengal` | pohela_boishakh, bhai_dooj |
+| `odisha` | singh_sankranti, raja_pahili, raja_sankranti, raja_basi |
+| `assam` | bohag_bihu, magh_bihu, kati_bihu |
+| `bihar` | singh_sankranti, hariyali_teej, govardhan_puja, bhai_dooj |
+| `gujarat` | uttarayan, govardhan_puja, bhai_dooj |
+| `maharashtra` | gudi_padwa, hartalika_teej, bhai_dooj |
+| `goa` | gudi_padwa |
+| `rajasthan` | gangaur, hariyali_teej, kajari_teej, hartalika_teej, govardhan_puja, bhai_dooj |
+| `punjab` | baisakhi, lohri, govardhan_puja |
+| `haryana` | baisakhi, lohri, govardhan_puja, bhai_dooj |
+| `himachal-pradesh` | sair, phagli, lohri |
+| `uttarakhand` | harela |
+| `uttar-pradesh` | hariyali_teej, kajari_teej, hartalika_teej, govardhan_puja, bhai_dooj |
+| `madhya-pradesh` | hariyali_teej, kajari_teej, hartalika_teej |
+| `nepal` | singh_sankranti, bhai_dooj |
 </details>
 
 <details>
@@ -682,6 +792,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>
 
@@ -717,10 +836,11 @@ 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,048 tests passing across 61 files, including fixtures cross-verified
+against reference panchang calculations spanning 2025–2026 across 10
+Indian cities (Phase 28 cross-verify) plus New York, London, Sydney,
+Dubai, and Singapore (diaspora fixtures cover DST transitions on
+`America/New_York`).
 
 | Element | Accuracy | Validation |
 |---------|----------|------------|
@@ -734,6 +854,11 @@ DST transitions on `America/New_York`).
 | 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 Drik fixtures** (10 cities × 5 dates) | [phase28-cross-verify](tests/validation/phase28-cross-verify.test.ts) |
+| Pratah / Sayahna Sandhya start + end | **±2 min vs Drik** across all 50 fixtures | [phase28-cross-verify](tests/validation/phase28-cross-verify.test.ts) |
+| Varjyam start + end | **±2 min vs Drik** on every fixture where the library emits a non-null window (≥30 of 50 emit; transition days return `null` by design) | [phase28-cross-verify](tests/validation/phase28-cross-verify.test.ts) |
+
+**Phase 28 sourcing notes** (see [phase28-cross-verify.test.ts](tests/validation/phase28-cross-verify.test.ts) for per-feature findings): **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 — Drik publishes no algorithmic rule text for these and may use the weekday rule, so the library's output may differ from Drik's Aadal/Vidaal occurrence pages by design. **Varjyam** emits the sunrise-anchored nakshatra's window only (single-window contract per [src/core/varjyam.ts:31-38](src/core/varjyam.ts#L31-L38)) — 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 drikpanchang.com/muhurat/daily/do-ghati-muhurat.html for two distinct weekdays. Sourcing is cited inline in [src/core/doGhati.ts:3-21](src/core/doGhati.ts#L3-L21).
 
 ### Festival Detection — Documented Tradeoff