panchang-ts 0.3.0 → 0.4.0

package/README.md

@@ -22,6 +22,7 @@ Works offline in React Native (Hermes), Node.js, and browsers.
 - **Instant mode:** Elements active at an exact moment (birth charts, muhurta selection)
 - **3 ayanamsa systems:** Lahiri (default), B.V. Raman, KP (Krishnamurti)
 - **3 languages:** English, Sanskrit (Devanagari), Hindi
+- **Jyotish (Vedic astrology):** Janam Kundli with Lagna, 12 houses (whole-sign), all 9 graha positions, Navamsa (D-9) chart, Vimshottari Dasha with Antardasha breakdown
 - **React Native compatible:** Pure JS math, no native modules, tested on Hermes
 - **Fast:** ~0.1 ms names-only on Node.js; <100 ms on budget Android (Hermes)
 - **Typed:** Full TypeScript types for every result and option
@@ -185,6 +186,77 @@ const result = getDailyPanchang(
 
 ---
 
+### `computeKundli(birthDateUtc, location, options?)`
+
+Compute a complete Janam Kundli (Vedic birth chart).
+
+```typescript
+import { computeKundli } from 'panchang-ts';
+
+const kundli = computeKundli(
+  new Date('1990-06-15T08:30:00Z'),            // UTC birth moment
+  { latitude: 18.5204, longitude: 73.8567 },   // birth location
+  { ayanamsa: 'lahiri', language: 'en' },
+);
+
+// Ascendant
+console.log(kundli.lagna.name);                // "Karka" (Cancer)
+console.log(kundli.lagnaLongitude);            // 95.4 (sidereal degrees)
+
+// Planetary positions
+const sun = kundli.grahas.sun;
+console.log(sun.rashi.name);                   // "Mithuna"
+console.log(sun.nakshatra.name);               // "Ardra"
+console.log(sun.degreeInRashi);                // 24.3
+console.log(sun.isRetrograde);                 // false
+
+// Houses (whole-sign)
+kundli.houses.forEach(h => {
+  console.log(`House ${h.number}: ${h.rashi.name} — ${h.planets.join(', ')}`);
+});
+
+// Navamsa (D-9) chart
+console.log(kundli.navamsa.lagna.name);        // Navamsa lagna sign
+kundli.navamsa.positions.forEach(p => {
+  console.log(p.planet, '→', p.rashi.name);
+});
+
+// Vimshottari Dasha
+const dasha = kundli.dasha;
+console.log(dasha.currentMahaDashaLord);       // e.g. "Jupiter"
+dasha.mahaDashas.forEach(md => {
+  console.log(md.lord, md.startDate, '→', md.endDate, `(${md.years}y)`);
+  md.antarDashas.forEach(ad => {
+    console.log('  ', ad.lord, ad.startDate, '→', ad.endDate);
+  });
+});
+
+// Full birth Panchang is also included
+console.log(kundli.birthPanchang.tithi.name);  // Tithi at birth
+```
+
+**Returns: `KundliResult`**
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `lagnaLongitude` | `number` | Sidereal longitude of the Ascendant in degrees [0, 360) |
+| `lagna` | `RashiInfo` | Ascendant zodiac sign |
+| `houses` | `KundliHouse[]` | 12 houses; House 1 = Lagna sign (whole-sign system) |
+| `grahas` | `PlanetaryPositions` | All 9 graha positions with rashi, nakshatra, house, retrograde flag |
+| `navamsa` | `NavamsaChart` | D-9 divisional chart with Lagna and all planet positions |
+| `dasha` | `VimshottariDashaResult` | Full Vimshottari Dasha sequence from birth with Antardasha breakdown |
+| `birthPanchang` | `InstantPanchangResult` | Complete Panchang at the birth moment |
+
+**`KundliOptions`** (optional):
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `ayanamsa` | `'lahiri' \| 'raman' \| 'krishnamurti'` | `'lahiri'` | Ayanamsa system |
+| `language` | `'en' \| 'sa' \| 'hi'` | `'en'` | Language for names |
+| `computeDasha` | `boolean` | `true` | Set `false` to skip Vimshottari Dasha computation |
+
+---
+
 ### `getInstantPanchang(date, location, options?)`
 
 Returns the single Panchang element active at an exact UTC moment.
@@ -259,6 +331,9 @@ import {
   computeRahuKalam, computeGulikaKalam, computeYamaganda,
   computeAbhijitMuhurta, computeBrahmaMuhurta,
   computeGowriPanchangam,
+  // Jyotish
+  computePlanetaryPositions, computeVimshottariDasha, computeLagnaLongitude,
+  GRAHA_ABBR,
 } from 'panchang-ts';
 
 // Sunrise/sunset
@@ -292,6 +367,21 @@ const gowri = computeGowriPanchangam(sunrise, sunset, nextSunrise, varaIndex,
 );
 // gowri.day  → 8 GowriSlot (sunrise → sunset)
 // gowri.night → 8 GowriSlot (sunset → next sunrise)
+
+// Planetary positions (all 9 grahas, sidereal)
+const grahas = computePlanetaryPositions(birthDate, 'lahiri');
+console.log(grahas.jupiter.rashi.name);  // e.g. "Dhanu"
+console.log(grahas.saturn.isRetrograde); // true/false
+console.log(GRAHA_ABBR['Jupiter']);      // "Ju"
+
+// Lagna (Ascendant) longitude — useful when building a custom chart renderer
+const lagnaLon = computeLagnaLongitude(birthDate, latitude, longitude, 'lahiri');
+
+// Vimshottari Dasha — pass birth date and Moon's sidereal longitude
+const moonLon = getSiderealMoonLongitude(birthDate, 'lahiri');
+const dasha = computeVimshottariDasha(birthDate, moonLon);
+console.log(dasha.currentMahaDashaLord);   // e.g. "Rahu"
+console.log(dasha.mahaDashas[0]!.antarDashas[0]!.lord); // e.g. "Rahu"
 ```
 
 ---
@@ -444,6 +534,74 @@ interface FestivalInfo {
 //   Pradosha:  Krishna Trayodashi only (tithi 27)
 //   Sankranti: Sun within 1° past a rashi boundary (degInRashi < 1.0)
 //   Fixed festivals (e.g. Diwali): matched by chandramasa index + tithi index; skipped during Adhika months
+
+// ── Jyotish (Vedic astrology) ────────────────────────────────────────────────
+
+type GrahaName = 'Sun' | 'Moon' | 'Mars' | 'Mercury' | 'Jupiter' | 'Venus' | 'Saturn' | 'Rahu' | 'Ketu';
+
+interface GrahaPosition {
+  planet: GrahaName;
+  siderealLongitude: number;   // degrees [0, 360)
+  rashi: RashiInfo;            // zodiac sign
+  degreeInRashi: number;       // degrees within sign [0, 30)
+  nakshatra: NakshatraInfo;    // nakshatra + pada + completion %
+  isRetrograde: boolean;       // always false for Sun/Moon; always true for Rahu/Ketu
+  house: number;               // 1–12 (whole-sign system, relative to Lagna)
+}
+
+interface PlanetaryPositions {
+  sun: GrahaPosition; moon: GrahaPosition; mars: GrahaPosition;
+  mercury: GrahaPosition; jupiter: GrahaPosition; venus: GrahaPosition;
+  saturn: GrahaPosition; rahu: GrahaPosition; ketu: GrahaPosition;
+}
+
+interface KundliHouse {
+  number: number;    // 1–12
+  rashi: RashiInfo;  // sign on this house cusp
+  planets: string[]; // short abbreviations: "Su", "Mo", "Ma", "Me", "Ju", "Ve", "Sa", "Ra", "Ke"
+}
+
+interface NavamsaPosition {
+  planet: GrahaName;
+  rashi: RashiInfo;  // D-9 (Navamsa) sign for this planet
+}
+
+interface NavamsaChart {
+  positions: NavamsaPosition[];
+  lagna: RashiInfo;  // Navamsa Lagna sign
+}
+
+type DashaLord = 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
+
+interface AntarDasha {
+  lord: DashaLord;
+  startDate: Date;
+  endDate: Date;
+}
+
+interface MahaDasha {
+  lord: DashaLord;
+  startDate: Date;
+  endDate: Date;
+  years: number;           // full duration in years (proportional for the first/partial dasha)
+  antarDashas: AntarDasha[];
+}
+
+interface VimshottariDashaResult {
+  currentMahaDashaLord: DashaLord;  // active Mahadasha as of today
+  currentIndex: number;              // index into mahaDashas
+  mahaDashas: MahaDasha[];           // 9-entry sequence starting from birth
+}
+
+interface KundliResult {
+  lagnaLongitude: number;        // sidereal ascendant in degrees [0, 360)
+  lagna: RashiInfo;              // ascendant sign
+  houses: KundliHouse[];         // 12 houses (whole-sign)
+  grahas: PlanetaryPositions;    // all 9 graha positions
+  navamsa: NavamsaChart;         // D-9 chart
+  birthPanchang: InstantPanchangResult;
+  dasha: VimshottariDashaResult;
+}
 ```
 
 ---
@@ -554,6 +712,12 @@ occurs within the search window (this is normal for the Moon).
 
 ---
 
+## Acknowledgements
+
+- **[astronomy-engine](https://github.com/cosinekitty/astronomy)** by Don Cross — the sole runtime dependency. Provides the astronomical algorithms used for sunrise/sunset, moonrise/moonset, and planetary longitude calculations. MIT licensed.
+
+---
+
 ## License
 
 MIT

package/dist/index.cjs

@@ -1372,6 +1372,10 @@ function sidereal_time(time) {
   }
   return sidereal_time_cache.st;
 }
+function SiderealTime(date) {
+  const time = MakeTime(date);
+  return sidereal_time(time);
+}
 function terra(observer, st) {
   const phi = observer.latitude * DEG2RAD;
   const sinphi = Math.sin(phi);
@@ -2262,6 +2266,13 @@ function Search(f, t1, t2, options) {
     return null;
   }
 }
+function EclipticLongitude(body, date) {
+  if (body === Body.Sun)
+    throw "Cannot calculate heliocentric longitude of the Sun.";
+  const hv = HelioVector(body, date);
+  const eclip = Ecliptic(hv);
+  return eclip.elon;
+}
 var AtmosphereInfo = class {
   constructor(pressure, temperature, density) {
     this.pressure = pressure;
@@ -2530,6 +2541,12 @@ function normalize360(degrees) {
   if (r === 0) return 0;
   return r < 0 ? r + 360 : r;
 }
+function degToRad(degrees) {
+  return degrees * (Math.PI / 180);
+}
+function radToDeg(radians) {
+  return radians * (180 / Math.PI);
+}
 
 // src/astronomy/moon.ts
 function getSiderealMoonLongitude(date, ayanamsaType) {
@@ -3994,6 +4011,295 @@ function getDailyPanchang(date, location, options) {
     }
   };
 }
+
+// src/jyotish/planets.ts
+var GRAHA_ABBR = {
+  Sun: "Su",
+  Moon: "Mo",
+  Mars: "Ma",
+  Mercury: "Me",
+  Jupiter: "Ju",
+  Venus: "Ve",
+  Saturn: "Sa",
+  Rahu: "Ra",
+  Ketu: "Ke"
+};
+function meanObliquity(T) {
+  return 23.439291111 - 0.013004167 * T - 164e-9 * T * T + 504e-9 * T * T * T;
+}
+function getTropicalPlanetLongitude(body, date) {
+  return EclipticLongitude(body, MakeTime(date));
+}
+function isRetrograde(body, date) {
+  const dt = 36e5;
+  const lon0 = EclipticLongitude(body, MakeTime(new Date(date.getTime() - dt)));
+  const lon1 = EclipticLongitude(body, MakeTime(new Date(date.getTime() + dt)));
+  let delta = lon1 - lon0;
+  if (delta > 180) delta -= 360;
+  if (delta < -180) delta += 360;
+  return delta < 0;
+}
+function getTrueRahuLongitudeTropical(date) {
+  const T = (dateToJulianDay(date) - 2451545) / 36525;
+  const omega = 125.04455501 - 1934.13626197 * T + 207765e-8 * T * T;
+  const F = normalize360(
+    93.27191028 + 483202.0175233 * T - 36825e-7 * T * T + 3083e-9 * T * T * T
+  );
+  const F_rad = F * Math.PI / 180;
+  const correction = -1.4979 * Math.sin(2 * F_rad) - 0.15 * Math.sin(0 * F_rad + Math.PI * 2 * (357.5 / 360)) - 0.1226 * Math.sin(2 * (omega * Math.PI / 180)) + 0.1176 * Math.sin(2 * F_rad - 2 * (omega * Math.PI / 180));
+  return normalize360(omega + correction / 60);
+}
+function buildGrahaPosition(planet, siderealLon, isRetro, nakshatraNameFn, rashiNameFn) {
+  const rashiIndex = Math.floor(siderealLon / 30);
+  const degreeInRashi = siderealLon - rashiIndex * 30;
+  const nakIdx = Math.floor(siderealLon / NAKSHATRA_SPAN);
+  return {
+    planet,
+    siderealLongitude: siderealLon,
+    rashi: { index: rashiIndex, name: rashiNameFn(rashiIndex) },
+    degreeInRashi,
+    nakshatra: computeNakshatraFromLongitude(siderealLon, nakshatraNameFn(nakIdx)),
+    isRetrograde: isRetro,
+    house: 0
+    // assigned later in computeKundli
+  };
+}
+var identity = (idx) => String(idx);
+function computePlanetaryPositions(date, ayanamsaType, nakshatraName = identity, rashiName = identity) {
+  const ayanamsa = computeAyanamsa(date, ayanamsaType);
+  const toSidereal = (tropical) => normalize360(tropical - ayanamsa);
+  const sunSid = getSiderealSunLongitude(date, ayanamsaType);
+  const moonSid = getSiderealMoonLongitude(date, ayanamsaType);
+  const marsTrop = getTropicalPlanetLongitude(Body.Mars, date);
+  const mercTrop = getTropicalPlanetLongitude(Body.Mercury, date);
+  const jupTrop = getTropicalPlanetLongitude(Body.Jupiter, date);
+  const venTrop = getTropicalPlanetLongitude(Body.Venus, date);
+  const satTrop = getTropicalPlanetLongitude(Body.Saturn, date);
+  const rahuTrop = getTrueRahuLongitudeTropical(date);
+  const ketuTrop = normalize360(rahuTrop + 180);
+  const marsRetro = isRetrograde(Body.Mars, date);
+  const mercRetro = isRetrograde(Body.Mercury, date);
+  const jupRetro = isRetrograde(Body.Jupiter, date);
+  const venRetro = isRetrograde(Body.Venus, date);
+  const satRetro = isRetrograde(Body.Saturn, date);
+  const g = (planet, sid, retro) => buildGrahaPosition(planet, sid, retro, nakshatraName, rashiName);
+  return {
+    sun: g("Sun", sunSid, false),
+    moon: g("Moon", moonSid, false),
+    mars: g("Mars", toSidereal(marsTrop), marsRetro),
+    mercury: g("Mercury", toSidereal(mercTrop), mercRetro),
+    jupiter: g("Jupiter", toSidereal(jupTrop), jupRetro),
+    venus: g("Venus", toSidereal(venTrop), venRetro),
+    saturn: g("Saturn", toSidereal(satTrop), satRetro),
+    rahu: g("Rahu", toSidereal(rahuTrop), true),
+    // always retrograde
+    ketu: g("Ketu", toSidereal(ketuTrop), true)
+  };
+}
+
+// src/jyotish/lagna.ts
+function computeLagnaLongitude(date, latitude, longitude, ayanamsaType) {
+  const gastHours = SiderealTime(MakeTime(date));
+  const last_deg = normalize360(gastHours * 15 + longitude);
+  const T = (dateToJulianDay(date) - 2451545) / 36525;
+  const eps_deg = meanObliquity(T);
+  const ramc = degToRad(last_deg);
+  const eps = degToRad(eps_deg);
+  const phi = degToRad(latitude);
+  const y = -Math.cos(ramc);
+  const x = Math.sin(ramc) * Math.cos(eps) + Math.tan(phi) * Math.sin(eps);
+  let tropicalAsc = normalize360(radToDeg(Math.atan2(y, x)));
+  const mcRaw = radToDeg(Math.atan2(Math.tan(ramc), Math.cos(eps)));
+  const mc = normalize360(
+    last_deg < 180 ? normalize360(mcRaw) : normalize360(mcRaw + 180)
+  );
+  const diff = normalize360(tropicalAsc - mc);
+  if (diff < 90 || diff > 270) {
+    tropicalAsc = normalize360(tropicalAsc + 180);
+  }
+  const ayanamsa = computeAyanamsa(date, ayanamsaType);
+  return normalize360(tropicalAsc - ayanamsa);
+}
+function navamsaRashi(siderealLongitude) {
+  const rashiIdx = Math.floor(siderealLongitude / 30);
+  const degInRashi = siderealLongitude - rashiIdx * 30;
+  const navamsaIndex = Math.floor(degInRashi / (30 / 9));
+  const NAVAMSA_STARTS = [0, 9, 6, 3, 0, 9, 6, 3, 0, 9, 6, 3];
+  return (NAVAMSA_STARTS[rashiIdx] + navamsaIndex) % 12;
+}
+function rashiFromLongitude(lon, nameFn) {
+  const index = Math.floor(lon / 30);
+  return { index, name: nameFn(index) };
+}
+
+// src/jyotish/dasha.ts
+var DASHA_YEARS = {
+  Ketu: 7,
+  Venus: 20,
+  Sun: 6,
+  Moon: 10,
+  Mars: 7,
+  Rahu: 18,
+  Jupiter: 16,
+  Saturn: 19,
+  Mercury: 17
+};
+var DASHA_ORDER = [
+  "Ketu",
+  "Venus",
+  "Sun",
+  "Moon",
+  "Mars",
+  "Rahu",
+  "Jupiter",
+  "Saturn",
+  "Mercury"
+];
+var NAKSHATRA_LORD = [
+  "Ketu",
+  "Venus",
+  "Sun",
+  "Moon",
+  "Mars",
+  "Rahu",
+  "Jupiter",
+  "Saturn",
+  "Mercury",
+  "Ketu",
+  "Venus",
+  "Sun",
+  "Moon",
+  "Mars",
+  "Rahu",
+  "Jupiter",
+  "Saturn",
+  "Mercury",
+  "Ketu",
+  "Venus",
+  "Sun",
+  "Moon",
+  "Mars",
+  "Rahu",
+  "Jupiter",
+  "Saturn",
+  "Mercury"
+];
+var MS_PER_YEAR = 365.25 * 24 * 3600 * 1e3;
+function computeVimshottariDasha(birthDate, moonSiderealLon) {
+  const nakIdx = Math.floor(moonSiderealLon / NAKSHATRA_SPAN);
+  const degInNak = moonSiderealLon - nakIdx * NAKSHATRA_SPAN;
+  const elapsedFraction = degInNak / NAKSHATRA_SPAN;
+  const startLord = NAKSHATRA_LORD[nakIdx];
+  const startLordIdx = DASHA_ORDER.indexOf(startLord);
+  const startLordYears = DASHA_YEARS[startLord];
+  const balanceMs = (1 - elapsedFraction) * startLordYears * MS_PER_YEAR;
+  const mahaDashas = [];
+  let cursor = new Date(birthDate.getTime());
+  for (let i = 0; i < 9; i++) {
+    const lordIdx = (startLordIdx + i) % 9;
+    const lord = DASHA_ORDER[lordIdx];
+    const years = DASHA_YEARS[lord];
+    const durationMs = i === 0 ? balanceMs : years * MS_PER_YEAR;
+    const startDate = new Date(cursor.getTime());
+    const endDate = new Date(cursor.getTime() + durationMs);
+    const antarDashas = buildAntarDashas(lord, startDate, durationMs);
+    mahaDashas.push({ lord, startDate, endDate, years, antarDashas });
+    cursor = endDate;
+  }
+  const now = /* @__PURE__ */ new Date();
+  const currentIndex = mahaDashas.findIndex(
+    (md) => now >= md.startDate && now < md.endDate
+  );
+  return {
+    currentMahaDashaLord: mahaDashas[Math.max(0, currentIndex)].lord,
+    currentIndex: Math.max(0, currentIndex),
+    mahaDashas
+  };
+}
+function buildAntarDashas(mahaLord, mahaStart, mahaDurationMs) {
+  const mahaIdx = DASHA_ORDER.indexOf(mahaLord);
+  const antarDashas = [];
+  let cursor = new Date(mahaStart.getTime());
+  for (let i = 0; i < 9; i++) {
+    const antarLordIdx = (mahaIdx + i) % 9;
+    const antarLord = DASHA_ORDER[antarLordIdx];
+    const antarYears = DASHA_YEARS[antarLord];
+    const antarMs = antarYears / 120 * mahaDurationMs;
+    const startDate = new Date(cursor.getTime());
+    const endDate = new Date(cursor.getTime() + antarMs);
+    antarDashas.push({ lord: antarLord, startDate, endDate });
+    cursor = endDate;
+  }
+  return antarDashas;
+}
+
+// src/jyotish/kundli.ts
+function computeKundli(birthDateUtc, location, options) {
+  validateDate(birthDateUtc);
+  validateLocation(location);
+  const ayanamsa = options?.ayanamsa ?? "lahiri";
+  const lang = options?.language ?? "en";
+  const doDasha = options?.computeDasha !== false;
+  const rashiName = (idx) => resolveMasaName(idx, lang);
+  const nakshatraName = (idx) => resolveNakshatraName(idx, lang);
+  const birthPanchang = getInstantPanchang(birthDateUtc, location, {
+    ayanamsa,
+    language: lang,
+    computeEndTimes: options?.computeEndTimes ?? false,
+    precision: options?.precision
+  });
+  const grahas = computePlanetaryPositions(birthDateUtc, ayanamsa, nakshatraName, rashiName);
+  const lagnaLon = computeLagnaLongitude(
+    birthDateUtc,
+    location.latitude,
+    location.longitude,
+    ayanamsa
+  );
+  const lagna = rashiFromLongitude(lagnaLon, rashiName);
+  const lagnaRashiIdx = lagna.index;
+  const houses = Array.from({ length: 12 }, (_, i) => {
+    const houseRashiIdx = (lagnaRashiIdx + i) % 12;
+    return {
+      number: i + 1,
+      rashi: { index: houseRashiIdx, name: rashiName(houseRashiIdx) },
+      planets: []
+    };
+  });
+  const grahaList = Object.values(grahas);
+  for (const graha of grahaList) {
+    const houseNumber = (graha.rashi.index - lagnaRashiIdx + 12) % 12 + 1;
+    graha.house = houseNumber;
+    houses[houseNumber - 1].planets.push(GRAHA_ABBR[graha.planet]);
+  }
+  const navamsa = buildNavamsaChart(grahas, lagnaLon, rashiName);
+  const dasha = doDasha ? computeVimshottariDasha(birthDateUtc, birthPanchang.siderealMoon) : { currentMahaDashaLord: "Sun", currentIndex: 0, mahaDashas: [] };
+  return {
+    lagnaLongitude: lagnaLon,
+    lagna,
+    houses,
+    grahas,
+    navamsa,
+    birthPanchang,
+    dasha
+  };
+}
+function buildNavamsaChart(grahas, lagnaLon, rashiName) {
+  const grahaList = Object.values(grahas);
+  const positions = grahaList.map((g) => ({
+    planet: g.planet,
+    rashi: {
+      index: navamsaRashi(g.siderealLongitude),
+      name: rashiName(navamsaRashi(g.siderealLongitude))
+    }
+  }));
+  return {
+    positions,
+    lagna: {
+      index: navamsaRashi(lagnaLon),
+      name: rashiName(navamsaRashi(lagnaLon))
+    }
+  };
+}
 /*! Bundled license information:
 
 astronomy-engine/esm/astronomy.js:
@@ -4032,12 +4338,17 @@ astronomy-engine/esm/astronomy.js:
    *)
 */
 
+exports.GRAHA_ABBR = GRAHA_ABBR;
 exports.PanchangError = PanchangError;
 exports.computeAbhijitMuhurta = computeAbhijitMuhurta;
 exports.computeBrahmaMuhurta = computeBrahmaMuhurta;
 exports.computeGowriPanchangam = computeGowriPanchangam;
 exports.computeGulikaKalam = computeGulikaKalam;
+exports.computeKundli = computeKundli;
+exports.computeLagnaLongitude = computeLagnaLongitude;
+exports.computePlanetaryPositions = computePlanetaryPositions;
 exports.computeRahuKalam = computeRahuKalam;
+exports.computeVimshottariDasha = computeVimshottariDasha;
 exports.computeYamaganda = computeYamaganda;
 exports.getAyanamsa = computeAyanamsa;
 exports.getDailyPanchang = getDailyPanchang;

package/dist/index.d.cts

@@ -277,6 +277,157 @@ declare function getInstantPanchang(date: Date, location: GeoLocation, options?:
  */
 declare function getDailyPanchang(date: Date, location: GeoLocation, options: PanchangOptions): DailyPanchangResult;
 
+type GrahaName = 'Sun' | 'Moon' | 'Mars' | 'Mercury' | 'Jupiter' | 'Venus' | 'Saturn' | 'Rahu' | 'Ketu';
+interface GrahaPosition {
+    /** Planet name in English */
+    planet: GrahaName;
+    /** Sidereal ecliptic longitude in degrees [0, 360) */
+    siderealLongitude: number;
+    /** Zodiac sign the planet occupies */
+    rashi: RashiInfo;
+    /** Degrees within the sign [0, 30) */
+    degreeInRashi: number;
+    /** Nakshatra the planet occupies */
+    nakshatra: NakshatraInfo;
+    /**
+     * True when the planet appears to move retrograde (west relative to stars).
+     * Always false for Sun and Moon (they never retrograde).
+     * Rahu/Ketu are always retrograde by definition.
+     */
+    isRetrograde: boolean;
+    /** 1-based house number where this planet sits (set after house assignment) */
+    house: number;
+}
+interface PlanetaryPositions {
+    sun: GrahaPosition;
+    moon: GrahaPosition;
+    mars: GrahaPosition;
+    mercury: GrahaPosition;
+    jupiter: GrahaPosition;
+    venus: GrahaPosition;
+    saturn: GrahaPosition;
+    rahu: GrahaPosition;
+    ketu: GrahaPosition;
+}
+interface KundliHouse {
+    /** 1–12 */
+    number: number;
+    /** Zodiac sign on the cusp of this house */
+    rashi: RashiInfo;
+    /** Short planet abbreviations occupying this house (e.g. "Su", "Mo") */
+    planets: string[];
+}
+interface NavamsaPosition {
+    planet: GrahaName;
+    /** Navamsa rashi (D-9 sign) */
+    rashi: RashiInfo;
+}
+interface NavamsaChart {
+    positions: NavamsaPosition[];
+    /** Navamsa Lagna rashi */
+    lagna: RashiInfo;
+}
+interface KundliResult {
+    /** Sidereal longitude of the Ascendant in degrees [0, 360) */
+    lagnaLongitude: number;
+    /** Ascendant sign */
+    lagna: RashiInfo;
+    /** 12 houses, 1st house = lagna sign */
+    houses: KundliHouse[];
+    /** All 9 graha positions with house assignments */
+    grahas: PlanetaryPositions;
+    /** Navamsa (D-9) divisional chart */
+    navamsa: NavamsaChart;
+    /** Full Panchang at the birth moment */
+    birthPanchang: InstantPanchangResult;
+    /** Vimshottari Dasha from birth */
+    dasha: VimshottariDashaResult;
+}
+type DashaLord = 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
+interface AntarDasha {
+    lord: DashaLord;
+    startDate: Date;
+    endDate: Date;
+}
+interface MahaDasha {
+    lord: DashaLord;
+    startDate: Date;
+    endDate: Date;
+    /** Duration in years */
+    years: number;
+    antarDashas: AntarDasha[];
+}
+interface VimshottariDashaResult {
+    /** The current active Mahadasha lord */
+    currentMahaDashaLord: DashaLord;
+    /** Index into mahaDashas of the current mahadasha */
+    currentIndex: number;
+    /**
+     * Full 120-year sequence starting from birth.
+     * The first entry is the dasha active at birth (possibly mid-cycle).
+     */
+    mahaDashas: MahaDasha[];
+}
+
+interface KundliOptions extends InstantPanchangOptions {
+    /**
+     * When true, compute Vimshottari Dasha periods.
+     * Slightly more expensive. Default: true.
+     */
+    computeDasha?: boolean;
+}
+/**
+ * Compute a complete Janam Kundli (birth chart).
+ *
+ * Returns planetary positions, Lagna, 12 houses, Navamsa (D-9) chart,
+ * Vimshottari Dasha periods, and the full birth Panchang.
+ *
+ * @param birthDateUtc  UTC birth moment. For times stored as "local time in UTC"
+ *                      (the panchang-ts convention), pass the Date as-is.
+ * @param location      Birth location coordinates.
+ * @param options       Optional ayanamsa, language, computeDasha flag.
+ */
+declare function computeKundli(birthDateUtc: Date, location: GeoLocation, options?: KundliOptions): KundliResult;
+
+declare const GRAHA_ABBR: Record<GrahaName, string>;
+/**
+ * Compute geocentric sidereal positions for all 9 grahas.
+ *
+ * @param date          UTC instant.
+ * @param ayanamsaType  Ayanamsa system.
+ * @param nakshatraName Function returning the Nakshatra name for an index.
+ * @param rashiName     Function returning the Rashi name for an index.
+ */
+declare function computePlanetaryPositions(date: Date, ayanamsaType: AyanamsaType, nakshatraName?: (idx: number) => string, rashiName?: (idx: number) => string): PlanetaryPositions;
+
+/**
+ * Compute the complete Vimshottari Dasha sequence from the birth moment.
+ *
+ * @param birthDate          UTC birth time.
+ * @param moonSiderealLon    Sidereal longitude of the Moon at birth [0, 360).
+ */
+declare function computeVimshottariDasha(birthDate: Date, moonSiderealLon: number): VimshottariDashaResult;
+
+/**
+ * Compute the sidereal longitude of the Lagna (Ascendant) for a given
+ * UTC birth time and observer location.
+ *
+ * Algorithm (Meeus, Astronomical Algorithms, Ch. 14):
+ *   1. GAST  = SiderealTime(date) in hours → degrees
+ *   2. LAST  = GAST + observerLongitude (in degrees)
+ *   3. RAMC  = LAST (Right Ascension of the Midheaven Culminating)
+ *   4. tan(λ_asc) = -cos(RAMC) / (sin(RAMC)·cos(ε) + tan(φ)·sin(ε))
+ *      where ε = mean obliquity, φ = geographic latitude
+ *   5. Sidereal Lagna = normalize(λ_asc − ayanamsa)
+ *
+ * @param date          UTC birth moment.
+ * @param latitude      Observer geographic latitude in degrees (−90 to +90).
+ * @param longitude     Observer geographic longitude in degrees (−180 to +180).
+ * @param ayanamsaType  Ayanamsa correction system.
+ * @returns             Sidereal ascendant longitude [0, 360).
+ */
+declare function computeLagnaLongitude(date: Date, latitude: number, longitude: number, ayanamsaType: AyanamsaType): number;
+
 /**
  * Compute sunrise nearest to (and after) the given UTC search start.
  *
@@ -436,4 +587,4 @@ declare class PanchangError extends Error {
     constructor(message: string, code: PanchangErrorCode);
 }
 
-export { type AyanamsaType, type ChandraMasaInfo, type ChoghadiyaInfo, type ChoghadiyaQuality, type ChoghadiyaSlot, type DailyKaranaInfo, type DailyNakshatraInfo, type DailyPanchangResult, type DailyTithiInfo, type DailyYogaInfo, type FestivalInfo, type GeoLocation, type GowriInfo, type GowriSlot, type HoraInfo, type HoraSlot, type InstantPanchangOptions, type InstantPanchangResult, type KaranaInfo, type Language, type MasaInfo, type NakshatraInfo, PanchangError, type PanchangErrorCode, type PanchangOptions, type Precision, type RashiInfo, type SamvatInfo, type SpecialYogaInfo, type TimePeriod, type TithiInfo, type VaraInfo, type YogaInfo, computeAbhijitMuhurta, computeBrahmaMuhurta, computeGowriPanchangam, computeGulikaKalam, computeRahuKalam, computeYamaganda, computeAyanamsa as getAyanamsa, getDailyPanchang, getInstantPanchang, getMoonrise, getMoonset, getSiderealMoonLongitude, getSiderealSunLongitude, computeSunrise as getSunrise, computeSunset as getSunset };
+export { type AntarDasha, type AyanamsaType, type ChandraMasaInfo, type ChoghadiyaInfo, type ChoghadiyaQuality, type ChoghadiyaSlot, type DailyKaranaInfo, type DailyNakshatraInfo, type DailyPanchangResult, type DailyTithiInfo, type DailyYogaInfo, type DashaLord, type FestivalInfo, GRAHA_ABBR, type GeoLocation, type GowriInfo, type GowriSlot, type GrahaName, type GrahaPosition, type HoraInfo, type HoraSlot, type InstantPanchangOptions, type InstantPanchangResult, type KaranaInfo, type KundliHouse, type KundliOptions, type KundliResult, type Language, type MahaDasha, type MasaInfo, type NakshatraInfo, type NavamsaChart, type NavamsaPosition, PanchangError, type PanchangErrorCode, type PanchangOptions, type PlanetaryPositions, type Precision, type RashiInfo, type SamvatInfo, type SpecialYogaInfo, type TimePeriod, type TithiInfo, type VaraInfo, type VimshottariDashaResult, type YogaInfo, computeAbhijitMuhurta, computeBrahmaMuhurta, computeGowriPanchangam, computeGulikaKalam, computeKundli, computeLagnaLongitude, computePlanetaryPositions, computeRahuKalam, computeVimshottariDasha, computeYamaganda, computeAyanamsa as getAyanamsa, getDailyPanchang, getInstantPanchang, getMoonrise, getMoonset, getSiderealMoonLongitude, getSiderealSunLongitude, computeSunrise as getSunrise, computeSunset as getSunset };

package/dist/index.d.ts

@@ -277,6 +277,157 @@ declare function getInstantPanchang(date: Date, location: GeoLocation, options?:
  */
 declare function getDailyPanchang(date: Date, location: GeoLocation, options: PanchangOptions): DailyPanchangResult;
 
+type GrahaName = 'Sun' | 'Moon' | 'Mars' | 'Mercury' | 'Jupiter' | 'Venus' | 'Saturn' | 'Rahu' | 'Ketu';
+interface GrahaPosition {
+    /** Planet name in English */
+    planet: GrahaName;
+    /** Sidereal ecliptic longitude in degrees [0, 360) */
+    siderealLongitude: number;
+    /** Zodiac sign the planet occupies */
+    rashi: RashiInfo;
+    /** Degrees within the sign [0, 30) */
+    degreeInRashi: number;
+    /** Nakshatra the planet occupies */
+    nakshatra: NakshatraInfo;
+    /**
+     * True when the planet appears to move retrograde (west relative to stars).
+     * Always false for Sun and Moon (they never retrograde).
+     * Rahu/Ketu are always retrograde by definition.
+     */
+    isRetrograde: boolean;
+    /** 1-based house number where this planet sits (set after house assignment) */
+    house: number;
+}
+interface PlanetaryPositions {
+    sun: GrahaPosition;
+    moon: GrahaPosition;
+    mars: GrahaPosition;
+    mercury: GrahaPosition;
+    jupiter: GrahaPosition;
+    venus: GrahaPosition;
+    saturn: GrahaPosition;
+    rahu: GrahaPosition;
+    ketu: GrahaPosition;
+}
+interface KundliHouse {
+    /** 1–12 */
+    number: number;
+    /** Zodiac sign on the cusp of this house */
+    rashi: RashiInfo;
+    /** Short planet abbreviations occupying this house (e.g. "Su", "Mo") */
+    planets: string[];
+}
+interface NavamsaPosition {
+    planet: GrahaName;
+    /** Navamsa rashi (D-9 sign) */
+    rashi: RashiInfo;
+}
+interface NavamsaChart {
+    positions: NavamsaPosition[];
+    /** Navamsa Lagna rashi */
+    lagna: RashiInfo;
+}
+interface KundliResult {
+    /** Sidereal longitude of the Ascendant in degrees [0, 360) */
+    lagnaLongitude: number;
+    /** Ascendant sign */
+    lagna: RashiInfo;
+    /** 12 houses, 1st house = lagna sign */
+    houses: KundliHouse[];
+    /** All 9 graha positions with house assignments */
+    grahas: PlanetaryPositions;
+    /** Navamsa (D-9) divisional chart */
+    navamsa: NavamsaChart;
+    /** Full Panchang at the birth moment */
+    birthPanchang: InstantPanchangResult;
+    /** Vimshottari Dasha from birth */
+    dasha: VimshottariDashaResult;
+}
+type DashaLord = 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
+interface AntarDasha {
+    lord: DashaLord;
+    startDate: Date;
+    endDate: Date;
+}
+interface MahaDasha {
+    lord: DashaLord;
+    startDate: Date;
+    endDate: Date;
+    /** Duration in years */
+    years: number;
+    antarDashas: AntarDasha[];
+}
+interface VimshottariDashaResult {
+    /** The current active Mahadasha lord */
+    currentMahaDashaLord: DashaLord;
+    /** Index into mahaDashas of the current mahadasha */
+    currentIndex: number;
+    /**
+     * Full 120-year sequence starting from birth.
+     * The first entry is the dasha active at birth (possibly mid-cycle).
+     */
+    mahaDashas: MahaDasha[];
+}
+
+interface KundliOptions extends InstantPanchangOptions {
+    /**
+     * When true, compute Vimshottari Dasha periods.
+     * Slightly more expensive. Default: true.
+     */
+    computeDasha?: boolean;
+}
+/**
+ * Compute a complete Janam Kundli (birth chart).
+ *
+ * Returns planetary positions, Lagna, 12 houses, Navamsa (D-9) chart,
+ * Vimshottari Dasha periods, and the full birth Panchang.
+ *
+ * @param birthDateUtc  UTC birth moment. For times stored as "local time in UTC"
+ *                      (the panchang-ts convention), pass the Date as-is.
+ * @param location      Birth location coordinates.
+ * @param options       Optional ayanamsa, language, computeDasha flag.
+ */
+declare function computeKundli(birthDateUtc: Date, location: GeoLocation, options?: KundliOptions): KundliResult;
+
+declare const GRAHA_ABBR: Record<GrahaName, string>;
+/**
+ * Compute geocentric sidereal positions for all 9 grahas.
+ *
+ * @param date          UTC instant.
+ * @param ayanamsaType  Ayanamsa system.
+ * @param nakshatraName Function returning the Nakshatra name for an index.
+ * @param rashiName     Function returning the Rashi name for an index.
+ */
+declare function computePlanetaryPositions(date: Date, ayanamsaType: AyanamsaType, nakshatraName?: (idx: number) => string, rashiName?: (idx: number) => string): PlanetaryPositions;
+
+/**
+ * Compute the complete Vimshottari Dasha sequence from the birth moment.
+ *
+ * @param birthDate          UTC birth time.
+ * @param moonSiderealLon    Sidereal longitude of the Moon at birth [0, 360).
+ */
+declare function computeVimshottariDasha(birthDate: Date, moonSiderealLon: number): VimshottariDashaResult;
+
+/**
+ * Compute the sidereal longitude of the Lagna (Ascendant) for a given
+ * UTC birth time and observer location.
+ *
+ * Algorithm (Meeus, Astronomical Algorithms, Ch. 14):
+ *   1. GAST  = SiderealTime(date) in hours → degrees
+ *   2. LAST  = GAST + observerLongitude (in degrees)
+ *   3. RAMC  = LAST (Right Ascension of the Midheaven Culminating)
+ *   4. tan(λ_asc) = -cos(RAMC) / (sin(RAMC)·cos(ε) + tan(φ)·sin(ε))
+ *      where ε = mean obliquity, φ = geographic latitude
+ *   5. Sidereal Lagna = normalize(λ_asc − ayanamsa)
+ *
+ * @param date          UTC birth moment.
+ * @param latitude      Observer geographic latitude in degrees (−90 to +90).
+ * @param longitude     Observer geographic longitude in degrees (−180 to +180).
+ * @param ayanamsaType  Ayanamsa correction system.
+ * @returns             Sidereal ascendant longitude [0, 360).
+ */
+declare function computeLagnaLongitude(date: Date, latitude: number, longitude: number, ayanamsaType: AyanamsaType): number;
+
 /**
  * Compute sunrise nearest to (and after) the given UTC search start.
  *
@@ -436,4 +587,4 @@ declare class PanchangError extends Error {
     constructor(message: string, code: PanchangErrorCode);
 }
 
-export { type AyanamsaType, type ChandraMasaInfo, type ChoghadiyaInfo, type ChoghadiyaQuality, type ChoghadiyaSlot, type DailyKaranaInfo, type DailyNakshatraInfo, type DailyPanchangResult, type DailyTithiInfo, type DailyYogaInfo, type FestivalInfo, type GeoLocation, type GowriInfo, type GowriSlot, type HoraInfo, type HoraSlot, type InstantPanchangOptions, type InstantPanchangResult, type KaranaInfo, type Language, type MasaInfo, type NakshatraInfo, PanchangError, type PanchangErrorCode, type PanchangOptions, type Precision, type RashiInfo, type SamvatInfo, type SpecialYogaInfo, type TimePeriod, type TithiInfo, type VaraInfo, type YogaInfo, computeAbhijitMuhurta, computeBrahmaMuhurta, computeGowriPanchangam, computeGulikaKalam, computeRahuKalam, computeYamaganda, computeAyanamsa as getAyanamsa, getDailyPanchang, getInstantPanchang, getMoonrise, getMoonset, getSiderealMoonLongitude, getSiderealSunLongitude, computeSunrise as getSunrise, computeSunset as getSunset };
+export { type AntarDasha, type AyanamsaType, type ChandraMasaInfo, type ChoghadiyaInfo, type ChoghadiyaQuality, type ChoghadiyaSlot, type DailyKaranaInfo, type DailyNakshatraInfo, type DailyPanchangResult, type DailyTithiInfo, type DailyYogaInfo, type DashaLord, type FestivalInfo, GRAHA_ABBR, type GeoLocation, type GowriInfo, type GowriSlot, type GrahaName, type GrahaPosition, type HoraInfo, type HoraSlot, type InstantPanchangOptions, type InstantPanchangResult, type KaranaInfo, type KundliHouse, type KundliOptions, type KundliResult, type Language, type MahaDasha, type MasaInfo, type NakshatraInfo, type NavamsaChart, type NavamsaPosition, PanchangError, type PanchangErrorCode, type PanchangOptions, type PlanetaryPositions, type Precision, type RashiInfo, type SamvatInfo, type SpecialYogaInfo, type TimePeriod, type TithiInfo, type VaraInfo, type VimshottariDashaResult, type YogaInfo, computeAbhijitMuhurta, computeBrahmaMuhurta, computeGowriPanchangam, computeGulikaKalam, computeKundli, computeLagnaLongitude, computePlanetaryPositions, computeRahuKalam, computeVimshottariDasha, computeYamaganda, computeAyanamsa as getAyanamsa, getDailyPanchang, getInstantPanchang, getMoonrise, getMoonset, getSiderealMoonLongitude, getSiderealSunLongitude, computeSunrise as getSunrise, computeSunset as getSunset };

package/dist/index.js

@@ -1370,6 +1370,10 @@ function sidereal_time(time) {
   }
   return sidereal_time_cache.st;
 }
+function SiderealTime(date) {
+  const time = MakeTime(date);
+  return sidereal_time(time);
+}
 function terra(observer, st) {
   const phi = observer.latitude * DEG2RAD;
   const sinphi = Math.sin(phi);
@@ -2260,6 +2264,13 @@ function Search(f, t1, t2, options) {
     return null;
   }
 }
+function EclipticLongitude(body, date) {
+  if (body === Body.Sun)
+    throw "Cannot calculate heliocentric longitude of the Sun.";
+  const hv = HelioVector(body, date);
+  const eclip = Ecliptic(hv);
+  return eclip.elon;
+}
 var AtmosphereInfo = class {
   constructor(pressure, temperature, density) {
     this.pressure = pressure;
@@ -2528,6 +2539,12 @@ function normalize360(degrees) {
   if (r === 0) return 0;
   return r < 0 ? r + 360 : r;
 }
+function degToRad(degrees) {
+  return degrees * (Math.PI / 180);
+}
+function radToDeg(radians) {
+  return radians * (180 / Math.PI);
+}
 
 // src/astronomy/moon.ts
 function getSiderealMoonLongitude(date, ayanamsaType) {
@@ -3992,6 +4009,295 @@ function getDailyPanchang(date, location, options) {
     }
   };
 }
+
+// src/jyotish/planets.ts
+var GRAHA_ABBR = {
+  Sun: "Su",
+  Moon: "Mo",
+  Mars: "Ma",
+  Mercury: "Me",
+  Jupiter: "Ju",
+  Venus: "Ve",
+  Saturn: "Sa",
+  Rahu: "Ra",
+  Ketu: "Ke"
+};
+function meanObliquity(T) {
+  return 23.439291111 - 0.013004167 * T - 164e-9 * T * T + 504e-9 * T * T * T;
+}
+function getTropicalPlanetLongitude(body, date) {
+  return EclipticLongitude(body, MakeTime(date));
+}
+function isRetrograde(body, date) {
+  const dt = 36e5;
+  const lon0 = EclipticLongitude(body, MakeTime(new Date(date.getTime() - dt)));
+  const lon1 = EclipticLongitude(body, MakeTime(new Date(date.getTime() + dt)));
+  let delta = lon1 - lon0;
+  if (delta > 180) delta -= 360;
+  if (delta < -180) delta += 360;
+  return delta < 0;
+}
+function getTrueRahuLongitudeTropical(date) {
+  const T = (dateToJulianDay(date) - 2451545) / 36525;
+  const omega = 125.04455501 - 1934.13626197 * T + 207765e-8 * T * T;
+  const F = normalize360(
+    93.27191028 + 483202.0175233 * T - 36825e-7 * T * T + 3083e-9 * T * T * T
+  );
+  const F_rad = F * Math.PI / 180;
+  const correction = -1.4979 * Math.sin(2 * F_rad) - 0.15 * Math.sin(0 * F_rad + Math.PI * 2 * (357.5 / 360)) - 0.1226 * Math.sin(2 * (omega * Math.PI / 180)) + 0.1176 * Math.sin(2 * F_rad - 2 * (omega * Math.PI / 180));
+  return normalize360(omega + correction / 60);
+}
+function buildGrahaPosition(planet, siderealLon, isRetro, nakshatraNameFn, rashiNameFn) {
+  const rashiIndex = Math.floor(siderealLon / 30);
+  const degreeInRashi = siderealLon - rashiIndex * 30;
+  const nakIdx = Math.floor(siderealLon / NAKSHATRA_SPAN);
+  return {
+    planet,
+    siderealLongitude: siderealLon,
+    rashi: { index: rashiIndex, name: rashiNameFn(rashiIndex) },
+    degreeInRashi,
+    nakshatra: computeNakshatraFromLongitude(siderealLon, nakshatraNameFn(nakIdx)),
+    isRetrograde: isRetro,
+    house: 0
+    // assigned later in computeKundli
+  };
+}
+var identity = (idx) => String(idx);
+function computePlanetaryPositions(date, ayanamsaType, nakshatraName = identity, rashiName = identity) {
+  const ayanamsa = computeAyanamsa(date, ayanamsaType);
+  const toSidereal = (tropical) => normalize360(tropical - ayanamsa);
+  const sunSid = getSiderealSunLongitude(date, ayanamsaType);
+  const moonSid = getSiderealMoonLongitude(date, ayanamsaType);
+  const marsTrop = getTropicalPlanetLongitude(Body.Mars, date);
+  const mercTrop = getTropicalPlanetLongitude(Body.Mercury, date);
+  const jupTrop = getTropicalPlanetLongitude(Body.Jupiter, date);
+  const venTrop = getTropicalPlanetLongitude(Body.Venus, date);
+  const satTrop = getTropicalPlanetLongitude(Body.Saturn, date);
+  const rahuTrop = getTrueRahuLongitudeTropical(date);
+  const ketuTrop = normalize360(rahuTrop + 180);
+  const marsRetro = isRetrograde(Body.Mars, date);
+  const mercRetro = isRetrograde(Body.Mercury, date);
+  const jupRetro = isRetrograde(Body.Jupiter, date);
+  const venRetro = isRetrograde(Body.Venus, date);
+  const satRetro = isRetrograde(Body.Saturn, date);
+  const g = (planet, sid, retro) => buildGrahaPosition(planet, sid, retro, nakshatraName, rashiName);
+  return {
+    sun: g("Sun", sunSid, false),
+    moon: g("Moon", moonSid, false),
+    mars: g("Mars", toSidereal(marsTrop), marsRetro),
+    mercury: g("Mercury", toSidereal(mercTrop), mercRetro),
+    jupiter: g("Jupiter", toSidereal(jupTrop), jupRetro),
+    venus: g("Venus", toSidereal(venTrop), venRetro),
+    saturn: g("Saturn", toSidereal(satTrop), satRetro),
+    rahu: g("Rahu", toSidereal(rahuTrop), true),
+    // always retrograde
+    ketu: g("Ketu", toSidereal(ketuTrop), true)
+  };
+}
+
+// src/jyotish/lagna.ts
+function computeLagnaLongitude(date, latitude, longitude, ayanamsaType) {
+  const gastHours = SiderealTime(MakeTime(date));
+  const last_deg = normalize360(gastHours * 15 + longitude);
+  const T = (dateToJulianDay(date) - 2451545) / 36525;
+  const eps_deg = meanObliquity(T);
+  const ramc = degToRad(last_deg);
+  const eps = degToRad(eps_deg);
+  const phi = degToRad(latitude);
+  const y = -Math.cos(ramc);
+  const x = Math.sin(ramc) * Math.cos(eps) + Math.tan(phi) * Math.sin(eps);
+  let tropicalAsc = normalize360(radToDeg(Math.atan2(y, x)));
+  const mcRaw = radToDeg(Math.atan2(Math.tan(ramc), Math.cos(eps)));
+  const mc = normalize360(
+    last_deg < 180 ? normalize360(mcRaw) : normalize360(mcRaw + 180)
+  );
+  const diff = normalize360(tropicalAsc - mc);
+  if (diff < 90 || diff > 270) {
+    tropicalAsc = normalize360(tropicalAsc + 180);
+  }
+  const ayanamsa = computeAyanamsa(date, ayanamsaType);
+  return normalize360(tropicalAsc - ayanamsa);
+}
+function navamsaRashi(siderealLongitude) {
+  const rashiIdx = Math.floor(siderealLongitude / 30);
+  const degInRashi = siderealLongitude - rashiIdx * 30;
+  const navamsaIndex = Math.floor(degInRashi / (30 / 9));
+  const NAVAMSA_STARTS = [0, 9, 6, 3, 0, 9, 6, 3, 0, 9, 6, 3];
+  return (NAVAMSA_STARTS[rashiIdx] + navamsaIndex) % 12;
+}
+function rashiFromLongitude(lon, nameFn) {
+  const index = Math.floor(lon / 30);
+  return { index, name: nameFn(index) };
+}
+
+// src/jyotish/dasha.ts
+var DASHA_YEARS = {
+  Ketu: 7,
+  Venus: 20,
+  Sun: 6,
+  Moon: 10,
+  Mars: 7,
+  Rahu: 18,
+  Jupiter: 16,
+  Saturn: 19,
+  Mercury: 17
+};
+var DASHA_ORDER = [
+  "Ketu",
+  "Venus",
+  "Sun",
+  "Moon",
+  "Mars",
+  "Rahu",
+  "Jupiter",
+  "Saturn",
+  "Mercury"
+];
+var NAKSHATRA_LORD = [
+  "Ketu",
+  "Venus",
+  "Sun",
+  "Moon",
+  "Mars",
+  "Rahu",
+  "Jupiter",
+  "Saturn",
+  "Mercury",
+  "Ketu",
+  "Venus",
+  "Sun",
+  "Moon",
+  "Mars",
+  "Rahu",
+  "Jupiter",
+  "Saturn",
+  "Mercury",
+  "Ketu",
+  "Venus",
+  "Sun",
+  "Moon",
+  "Mars",
+  "Rahu",
+  "Jupiter",
+  "Saturn",
+  "Mercury"
+];
+var MS_PER_YEAR = 365.25 * 24 * 3600 * 1e3;
+function computeVimshottariDasha(birthDate, moonSiderealLon) {
+  const nakIdx = Math.floor(moonSiderealLon / NAKSHATRA_SPAN);
+  const degInNak = moonSiderealLon - nakIdx * NAKSHATRA_SPAN;
+  const elapsedFraction = degInNak / NAKSHATRA_SPAN;
+  const startLord = NAKSHATRA_LORD[nakIdx];
+  const startLordIdx = DASHA_ORDER.indexOf(startLord);
+  const startLordYears = DASHA_YEARS[startLord];
+  const balanceMs = (1 - elapsedFraction) * startLordYears * MS_PER_YEAR;
+  const mahaDashas = [];
+  let cursor = new Date(birthDate.getTime());
+  for (let i = 0; i < 9; i++) {
+    const lordIdx = (startLordIdx + i) % 9;
+    const lord = DASHA_ORDER[lordIdx];
+    const years = DASHA_YEARS[lord];
+    const durationMs = i === 0 ? balanceMs : years * MS_PER_YEAR;
+    const startDate = new Date(cursor.getTime());
+    const endDate = new Date(cursor.getTime() + durationMs);
+    const antarDashas = buildAntarDashas(lord, startDate, durationMs);
+    mahaDashas.push({ lord, startDate, endDate, years, antarDashas });
+    cursor = endDate;
+  }
+  const now = /* @__PURE__ */ new Date();
+  const currentIndex = mahaDashas.findIndex(
+    (md) => now >= md.startDate && now < md.endDate
+  );
+  return {
+    currentMahaDashaLord: mahaDashas[Math.max(0, currentIndex)].lord,
+    currentIndex: Math.max(0, currentIndex),
+    mahaDashas
+  };
+}
+function buildAntarDashas(mahaLord, mahaStart, mahaDurationMs) {
+  const mahaIdx = DASHA_ORDER.indexOf(mahaLord);
+  const antarDashas = [];
+  let cursor = new Date(mahaStart.getTime());
+  for (let i = 0; i < 9; i++) {
+    const antarLordIdx = (mahaIdx + i) % 9;
+    const antarLord = DASHA_ORDER[antarLordIdx];
+    const antarYears = DASHA_YEARS[antarLord];
+    const antarMs = antarYears / 120 * mahaDurationMs;
+    const startDate = new Date(cursor.getTime());
+    const endDate = new Date(cursor.getTime() + antarMs);
+    antarDashas.push({ lord: antarLord, startDate, endDate });
+    cursor = endDate;
+  }
+  return antarDashas;
+}
+
+// src/jyotish/kundli.ts
+function computeKundli(birthDateUtc, location, options) {
+  validateDate(birthDateUtc);
+  validateLocation(location);
+  const ayanamsa = options?.ayanamsa ?? "lahiri";
+  const lang = options?.language ?? "en";
+  const doDasha = options?.computeDasha !== false;
+  const rashiName = (idx) => resolveMasaName(idx, lang);
+  const nakshatraName = (idx) => resolveNakshatraName(idx, lang);
+  const birthPanchang = getInstantPanchang(birthDateUtc, location, {
+    ayanamsa,
+    language: lang,
+    computeEndTimes: options?.computeEndTimes ?? false,
+    precision: options?.precision
+  });
+  const grahas = computePlanetaryPositions(birthDateUtc, ayanamsa, nakshatraName, rashiName);
+  const lagnaLon = computeLagnaLongitude(
+    birthDateUtc,
+    location.latitude,
+    location.longitude,
+    ayanamsa
+  );
+  const lagna = rashiFromLongitude(lagnaLon, rashiName);
+  const lagnaRashiIdx = lagna.index;
+  const houses = Array.from({ length: 12 }, (_, i) => {
+    const houseRashiIdx = (lagnaRashiIdx + i) % 12;
+    return {
+      number: i + 1,
+      rashi: { index: houseRashiIdx, name: rashiName(houseRashiIdx) },
+      planets: []
+    };
+  });
+  const grahaList = Object.values(grahas);
+  for (const graha of grahaList) {
+    const houseNumber = (graha.rashi.index - lagnaRashiIdx + 12) % 12 + 1;
+    graha.house = houseNumber;
+    houses[houseNumber - 1].planets.push(GRAHA_ABBR[graha.planet]);
+  }
+  const navamsa = buildNavamsaChart(grahas, lagnaLon, rashiName);
+  const dasha = doDasha ? computeVimshottariDasha(birthDateUtc, birthPanchang.siderealMoon) : { currentMahaDashaLord: "Sun", currentIndex: 0, mahaDashas: [] };
+  return {
+    lagnaLongitude: lagnaLon,
+    lagna,
+    houses,
+    grahas,
+    navamsa,
+    birthPanchang,
+    dasha
+  };
+}
+function buildNavamsaChart(grahas, lagnaLon, rashiName) {
+  const grahaList = Object.values(grahas);
+  const positions = grahaList.map((g) => ({
+    planet: g.planet,
+    rashi: {
+      index: navamsaRashi(g.siderealLongitude),
+      name: rashiName(navamsaRashi(g.siderealLongitude))
+    }
+  }));
+  return {
+    positions,
+    lagna: {
+      index: navamsaRashi(lagnaLon),
+      name: rashiName(navamsaRashi(lagnaLon))
+    }
+  };
+}
 /*! Bundled license information:
 
 astronomy-engine/esm/astronomy.js:
@@ -4030,4 +4336,4 @@ astronomy-engine/esm/astronomy.js:
    *)
 */
 
-export { PanchangError, computeAbhijitMuhurta, computeBrahmaMuhurta, computeGowriPanchangam, computeGulikaKalam, computeRahuKalam, computeYamaganda, computeAyanamsa as getAyanamsa, getDailyPanchang, getInstantPanchang, getMoonrise, getMoonset, getSiderealMoonLongitude, getSiderealSunLongitude, computeSunrise as getSunrise, computeSunset as getSunset };
+export { GRAHA_ABBR, PanchangError, computeAbhijitMuhurta, computeBrahmaMuhurta, computeGowriPanchangam, computeGulikaKalam, computeKundli, computeLagnaLongitude, computePlanetaryPositions, computeRahuKalam, computeVimshottariDasha, computeYamaganda, computeAyanamsa as getAyanamsa, getDailyPanchang, getInstantPanchang, getMoonrise, getMoonset, getSiderealMoonLongitude, getSiderealSunLongitude, computeSunrise as getSunrise, computeSunset as getSunset };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "panchang-ts",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Pure TypeScript Hindu Panchang calculations. Tithi, Nakshatra, Yoga, Karana, Vara, and more. Offline-first, React Native compatible.",
   "author": "Ishank",
   "license": "MIT",