jyotish-calc 1.2.0 → 1.3.0

package/README.md

@@ -16,6 +16,7 @@ npm install jyotish-calc
 ## Features
 
 - **Graha Calculations**: Calculate positions and aspects of the nine planets (grahas)
+- **Panchanga**: Complete Vedic calendar with tithi, nakshatra, yoga, karana, vaara, muhurtas
 - **Special Lagnas**: Calculate Bhava Lagna, Hora Lagna, Ghati Lagna, etc.
 - **Upagrahas**: Calculate shadow planets like Gulika, Mandi, Dhuma, etc.
 - **Ashtakavarga**: Complete BAV and SAV calculations with house strength analysis
@@ -30,6 +31,7 @@ jyotish
 ├── index.js            # Main entry point
 ├── package.json        # Package configuration
 └── src
+   ├── panchanga        # Panchanga (Vedic calendar/almanac)
    ├── ashtakavarga     # Ashtakavarga (BAV & SAV) calculations
    ├── lagnas           # Special Lagna calculations
    ├── upagrahas        # Upagraha calculations
@@ -43,6 +45,7 @@ jyotish
    └── utils            # Helper utilities
 ```
 
+
 ## Usage
 
 ### Basic Planetary Positions
@@ -163,8 +166,30 @@ const allPoints = {
 const d9Chart = vargas.calculateVargaChart(allPoints, 'D9');
 ```
 
+### Panchanga (Vedic Calendar)
+
+Complete Vedic almanac with all 5 elements, muhurtas, and calendar functions.
+
+```javascript
+const { panchanga } = require('jyotish-calc');
+
+const panchangaData = panchanga.calculatePanchanga({
+    year: 1998, month: 9, date: 11,
+    hour: 4, min: 30, sec: 0,
+    lat: 13.0827, lng: 80.2707, timezone: 5.5
+});
+
+console.log(panchangaData.sunrise);   // {time: 5.97, string: "05:57:55 AM"}
+console.log(panchangaData.tithi);     // {number: 21, name: "Shashthi", paksha: "Krishna"}
+console.log(panchangaData.nakshatra); // {number: 2, name: "Bharani", pada: 4}
+console.log(panchangaData.yoga);      // {number: 13, name: "Vyaghata"}
+console.log(panchangaData.vaara);     // {name: "Friday", nameSanskrit: "Shukravara"}
+console.log(panchangaData.muhurtas.raahuKaalam); // {start: "10:34 AM", end: "12:05 PM"}
+```
+
 ### Ashtakavarga
 
+
 Complete strength assessment system.
 
 ```javascript

package/index.js

@@ -8,6 +8,7 @@ const strengths = require('./src/strengths/index');
 const lagnas = require('./src/lagnas/index');
 const upagrahas = require('./src/upagrahas/index');
 const ashtakavarga = require('./src/ashtakavarga/index');
+const panchanga = require('./src/panchanga/index');
 
 module.exports = {
     grahas,
@@ -19,5 +20,7 @@ module.exports = {
     strengths,
     lagnas,
     upagrahas,
-    ashtakavarga
+    ashtakavarga,
+    panchanga
 }
+

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jyotish-calc",
-  "version": "1.2.0",
-  "description": "Comprehensive Vedic Astrology library with Special Lagnas, Upagrahas, Ashtakavarga, Dashas, Vargas, and Shadbala",
+  "version": "1.3.0",
+  "description": "Comprehensive Vedic Astrology library with Panchanga, Special Lagnas, Upagrahas, Ashtakavarga, Dashas, Vargas, and Shadbala",
   "main": "index.js",
   "scripts": {
     "test": "jest",

package/src/panchanga/constants.js

@@ -0,0 +1,266 @@
+/**
+ * Panchanga Constants
+ * Core constants for Vedic calendar calculations
+ */
+
+// ============ ASTRONOMICAL CONSTANTS ============
+
+// Kali Yuga epoch - Julian Day Number for Feb 18, 3102 BCE
+const KALI_YUGA_JD = 588465.5;
+
+// Mahabharata date for special tithi handling
+const MAHABHARATA_JD = 588465.5;
+
+// Year lengths
+const SIDEREAL_YEAR = 365.256363;
+const TROPICAL_YEAR = 365.2421988;
+const SYNODIC_MONTH = 29.530588853;
+
+// Degree measures
+const ONE_TITHI = 12;           // 360/30 degrees
+const ONE_NAKSHATRA = 13.333333; // 360/27 degrees
+const ONE_YOGA = 13.333333;      // 360/27 degrees
+const ONE_PADA = 3.333333;       // 360/108 degrees
+
+// ============ PANCHANGA ELEMENT NAMES ============
+
+const TITHI_NAMES = [
+    'Pratipada', 'Dwitiya', 'Tritiya', 'Chaturthi', 'Panchami',
+    'Shashthi', 'Saptami', 'Ashtami', 'Navami', 'Dashami',
+    'Ekadashi', 'Dwadashi', 'Trayodashi', 'Chaturdashi', 'Purnima',
+    'Pratipada', 'Dwitiya', 'Tritiya', 'Chaturthi', 'Panchami',
+    'Shashthi', 'Saptami', 'Ashtami', 'Navami', 'Dashami',
+    'Ekadashi', 'Dwadashi', 'Trayodashi', 'Chaturdashi', 'Amavasya'
+];
+
+const NAKSHATRA_NAMES = [
+    'Ashwini', 'Bharani', 'Krittika', 'Rohini', 'Mrigashira',
+    'Ardra', 'Punarvasu', 'Pushya', 'Ashlesha', 'Magha',
+    'Purva Phalguni', 'Uttara Phalguni', 'Hasta', 'Chitra', 'Swati',
+    'Vishakha', 'Anuradha', 'Jyeshtha', 'Mula', 'Purva Ashadha',
+    'Uttara Ashadha', 'Shravana', 'Dhanishtha', 'Shatabhisha', 'Purva Bhadrapada',
+    'Uttara Bhadrapada', 'Revati'
+];
+
+const YOGA_NAMES = [
+    'Vishkambha', 'Priti', 'Ayushman', 'Saubhagya', 'Shobhana',
+    'Atiganda', 'Sukarma', 'Dhriti', 'Shoola', 'Ganda',
+    'Vriddhi', 'Dhruva', 'Vyaghata', 'Harshana', 'Vajra',
+    'Siddhi', 'Vyatipata', 'Variyan', 'Parigha', 'Shiva',
+    'Siddha', 'Sadhya', 'Shubha', 'Shukla', 'Brahma',
+    'Indra', 'Vaidhriti'
+];
+
+const KARANA_NAMES = [
+    'Kimstughna', 'Bava', 'Balava', 'Kaulava', 'Taitila',
+    'Garaja', 'Vanija', 'Vishti', 'Shakuni', 'Chatushpada', 'Naga'
+];
+
+const VAARA_NAMES = [
+    'Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'
+];
+
+const VAARA_NAMES_SANSKRIT = [
+    'Ravivara', 'Somavara', 'Mangalavara', 'Budhavara', 'Guruvara', 'Shukravara', 'Shanivara'
+];
+
+const PAKSHA_NAMES = ['Shukla', 'Krishna'];
+
+const LUNAR_MONTH_NAMES = [
+    'Chaitra', 'Vaishakha', 'Jyeshtha', 'Ashadha', 'Shravana', 'Bhadrapada',
+    'Ashwin', 'Kartik', 'Margashirsha', 'Pausha', 'Magha', 'Phalguna'
+];
+
+const SOLAR_MONTH_NAMES = [
+    'Mesha', 'Vrishabha', 'Mithuna', 'Karka', 'Simha', 'Kanya',
+    'Tula', 'Vrishchika', 'Dhanu', 'Makara', 'Kumbha', 'Meena'
+];
+
+const TAMIL_MONTH_NAMES = [
+    'Chithirai', 'Vaikasi', 'Aani', 'Aadi', 'Aavani', 'Purattasi',
+    'Aippasi', 'Karthigai', 'Margazhi', 'Thai', 'Maasi', 'Panguni'
+];
+
+const SAMVATSARA_NAMES = [
+    'Prabhava', 'Vibhava', 'Shukla', 'Pramodoota', 'Prajothpatti',
+    'Angirasa', 'Srimukha', 'Bhava', 'Yuva', 'Dhatru',
+    'Ishvara', 'Bahudhanya', 'Pramathi', 'Vikrama', 'Vrisha',
+    'Chitrabhanu', 'Svabhanu', 'Tarana', 'Parthiva', 'Vyaya',
+    'Sarvajit', 'Sarvadhari', 'Virodhi', 'Vikrita', 'Khara',
+    'Nandana', 'Vijaya', 'Jaya', 'Manmatha', 'Durmukhi',
+    'Hevilambi', 'Vilambi', 'Vikari', 'Sharvari', 'Plava',
+    'Shubhakrit', 'Shobhakrit', 'Krodhi', 'Vishvavasu', 'Parabhava',
+    'Plavanga', 'Kilaka', 'Saumya', 'Sadharana', 'Virodhikrit',
+    'Paridhaavi', 'Pramadicha', 'Ananda', 'Rakshasa', 'Nala',
+    'Pingala', 'Kalayukti', 'Siddharthi', 'Raudra', 'Durmathi',
+    'Dundubhi', 'Rudhirodgari', 'Raktakshi', 'Krodhana', 'Akshaya'
+];
+
+const RITU_NAMES = [
+    'Vasanta', 'Grishma', 'Varsha', 'Sharad', 'Hemanta', 'Shishira'
+];
+
+// ============ MUHURTA CONSTANTS ============
+
+// Trikalam offsets from sunrise (fraction of day)
+// Index by weekday: 0=Sunday, 1=Monday, ..., 6=Saturday
+const RAAHU_KAALAM_OFFSETS = [0.875, 0.125, 0.75, 0.5, 0.625, 0.375, 0.25];
+const GULIKAI_OFFSETS = [0.75, 0.625, 0.5, 0.375, 0.25, 0.125, 0.0];
+const YAMAGANDAM_OFFSETS = [0.5, 0.375, 0.25, 0.125, 0.0, 0.75, 0.625];
+
+// Durmuhurtam offsets from sunrise (in 1/12ths of day duration)
+// [offset1, offset2] - some days have only 1 durmuhurtam
+const DURMUHURTAM_OFFSETS = [
+    [10.4, 0.0],   // Sunday
+    [6.4, 8.8],    // Monday
+    [2.4, 4.8],    // Tuesday (second uses night duration)
+    [5.6, 0.0],    // Wednesday
+    [4.0, 8.8],    // Thursday
+    [2.4, 6.4],    // Friday
+    [1.6, 0.0]     // Saturday
+];
+
+// Gauri Choghadiya day table (1/8 of day, 8 periods)
+// 0=Udveg, 1=Char, 2=Labh, 3=Amrit, 4=Kaal, 5=Shubh, 6=Rog
+const GAURI_CHOGHADIYA_DAY = [
+    [0, 1, 2, 3, 4, 5, 6, 0], // Sunday
+    [3, 4, 5, 6, 0, 1, 2, 3], // Monday
+    [6, 0, 1, 2, 3, 4, 5, 6], // Tuesday
+    [2, 3, 4, 5, 6, 0, 1, 2], // Wednesday
+    [5, 6, 0, 1, 2, 3, 4, 5], // Thursday
+    [1, 2, 3, 4, 5, 6, 0, 1], // Friday
+    [4, 5, 6, 0, 1, 2, 3, 4]  // Saturday
+];
+
+const GAURI_CHOGHADIYA_NIGHT = [
+    [6, 5, 4, 3, 2, 1, 0, 6], // Sunday night
+    [2, 1, 0, 6, 5, 4, 3, 2], // Monday night
+    [5, 4, 3, 2, 1, 0, 6, 5], // Tuesday night
+    [1, 0, 6, 5, 4, 3, 2, 1], // Wednesday night
+    [4, 3, 2, 1, 0, 6, 5, 4], // Thursday night
+    [0, 6, 5, 4, 3, 2, 1, 0], // Friday night
+    [3, 2, 1, 0, 6, 5, 4, 3]  // Saturday night
+];
+
+const CHOGHADIYA_NAMES = ['Udveg', 'Char', 'Labh', 'Amrit', 'Kaal', 'Shubh', 'Rog'];
+
+// Planetary hora rulers by day (12 day + 12 night)
+// Order: Sun(0), Venus(5), Mercury(3), Moon(1), Saturn(6), Jupiter(4), Mars(2)
+const HORA_SEQUENCE = [0, 5, 3, 1, 6, 4, 2]; // Repeats
+
+// Day rulers for upagraha calculations (by weekday)
+const DAY_RULERS = [
+    [0, 1, 2, 3, 4, 5, 6, null], // Sunday: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, -
+    [1, 2, 3, 4, 5, 6, 0, null], // Monday
+    [2, 3, 4, 5, 6, 0, 1, null], // Tuesday
+    [3, 4, 5, 6, 0, 1, 2, null], // Wednesday
+    [4, 5, 6, 0, 1, 2, 3, null], // Thursday
+    [5, 6, 0, 1, 2, 3, 4, null], // Friday
+    [6, 0, 1, 2, 3, 4, 5, null]  // Saturday
+];
+
+const NIGHT_RULERS = [
+    [4, 5, 6, 0, 1, 2, 3, null], // Sunday night
+    [5, 6, 0, 1, 2, 3, 4, null], // Monday night
+    [6, 0, 1, 2, 3, 4, 5, null], // Tuesday night
+    [0, 1, 2, 3, 4, 5, 6, null], // Wednesday night
+    [1, 2, 3, 4, 5, 6, 0, null], // Thursday night
+    [2, 3, 4, 5, 6, 0, 1, null], // Friday night
+    [3, 4, 5, 6, 0, 1, 2, null]  // Saturday night
+];
+
+// ============ SPECIAL YOGA TABLES ============
+
+// Amrita Siddha Yoga - auspicious star-weekday combinations
+const AMRITA_SIDDHA_YOGA = {
+    0: [1, 6, 12, 17, 23], // Sunday: Bharani, Ardra, Hasta, Anuradha, Shatabhisha
+    1: [4, 9, 14, 19, 24], // Monday: Rohini, Ashlesha, Chitra, Mula, P.Bhadra
+    2: [3, 8, 13, 18, 23], // Tuesday: Krittika, Pushya, Hasta, Jyeshtha, Shatabhisha
+    3: [2, 7, 12, 17, 22], // Wednesday: Bharani, Punarvasu, Hasta, Anuradha, Shravana
+    4: [5, 10, 15, 20, 25], // Thursday: Mrigashira, Magha, Swati, P.Ashadha, U.Bhadra
+    5: [1, 6, 11, 16, 21], // Friday: Bharani, Ardra, U.Phalguni, Vishakha, U.Ashadha
+    6: [4, 9, 14, 19, 24]  // Saturday: Rohini, Ashlesha, Chitra, Mula, P.Bhadra
+};
+
+// Mrityu Yoga - inauspicious star-weekday combinations
+const MRITYU_YOGA = {
+    0: 14, // Sunday - Chitra
+    1: 7,  // Monday - Punarvasu
+    2: 4,  // Tuesday - Rohini
+    3: 13, // Wednesday - Hasta
+    4: 21, // Thursday - U.Ashadha
+    5: 22, // Friday - Shravana
+    6: 9   // Saturday - Ashlesha
+};
+
+// Dagdha Yoga - burnt combinations
+const DAGDHA_YOGA = {
+    0: 12, // Sunday - Hasta
+    1: 6,  // Monday - Ardra
+    2: 17, // Tuesday - Anuradha
+    3: 3,  // Wednesday - Krittika
+    4: 9,  // Thursday - Ashlesha
+    5: 18, // Friday - Jyeshtha
+    6: 22  // Saturday - Shravana
+};
+
+// ============ AYANAMSA CONSTANTS ============
+
+const AYANAMSA_MODES = {
+    FAGAN: 0,
+    LAHIRI: 1,
+    DELUCE: 2,
+    RAMAN: 3,
+    KP: 4,
+    KRISHNAMURTI: 5,
+    DJWHAL_KHUL: 6,
+    YUKTESHWAR: 7,
+    JN_BHASIN: 8,
+    BABYL_KUGLER1: 9,
+    BABYL_KUGLER2: 10,
+    BABYL_KUGLER3: 11,
+    BABYL_HUBER: 12,
+    TRUE_CITRA: 27,
+    TRUE_REVATI: 28,
+    TRUE_PUSHYA: 29
+};
+
+const DEFAULT_AYANAMSA = 'LAHIRI';
+
+// ============ SIGN CONSTANTS ============
+
+const SIGN_NAMES = [
+    'Aries', 'Taurus', 'Gemini', 'Cancer', 'Leo', 'Virgo',
+    'Libra', 'Scorpio', 'Sagittarius', 'Capricorn', 'Aquarius', 'Pisces'
+];
+
+const MOVABLE_SIGNS = [0, 3, 6, 9];   // Aries, Cancer, Libra, Capricorn
+const FIXED_SIGNS = [1, 4, 7, 10];    // Taurus, Leo, Scorpio, Aquarius
+const DUAL_SIGNS = [2, 5, 8, 11];     // Gemini, Virgo, Sagittarius, Pisces
+
+module.exports = {
+    // Astronomical
+    KALI_YUGA_JD, MAHABHARATA_JD, SIDEREAL_YEAR, TROPICAL_YEAR, SYNODIC_MONTH,
+    ONE_TITHI, ONE_NAKSHATRA, ONE_YOGA, ONE_PADA,
+
+    // Names
+    TITHI_NAMES, NAKSHATRA_NAMES, YOGA_NAMES, KARANA_NAMES,
+    VAARA_NAMES, VAARA_NAMES_SANSKRIT, PAKSHA_NAMES,
+    LUNAR_MONTH_NAMES, SOLAR_MONTH_NAMES, TAMIL_MONTH_NAMES,
+    SAMVATSARA_NAMES, RITU_NAMES, SIGN_NAMES,
+
+    // Muhurta tables
+    RAAHU_KAALAM_OFFSETS, GULIKAI_OFFSETS, YAMAGANDAM_OFFSETS,
+    DURMUHURTAM_OFFSETS,
+    GAURI_CHOGHADIYA_DAY, GAURI_CHOGHADIYA_NIGHT, CHOGHADIYA_NAMES,
+    HORA_SEQUENCE, DAY_RULERS, NIGHT_RULERS,
+
+    // Yoga tables
+    AMRITA_SIDDHA_YOGA, MRITYU_YOGA, DAGDHA_YOGA,
+
+    // Ayanamsa
+    AYANAMSA_MODES, DEFAULT_AYANAMSA,
+
+    // Signs
+    MOVABLE_SIGNS, FIXED_SIGNS, DUAL_SIGNS
+};

package/src/panchanga/index.js

@@ -0,0 +1,330 @@
+/**
+ * Panchanga Module - Main Entry Point
+ * Comprehensive Vedic Calendar/Almanac Calculations
+ * 
+ * Provides calculations for:
+ * - Panchangam (5 elements): Tithi, Nakshatra, Yoga, Karana, Vaara
+ * - Sunrise/Sunset and Moon rise/set
+ * - Lunar calendar with Adhika month detection
+ * - Solar calendar with Sankranti
+ * - Muhurtas (auspicious/inauspicious time periods)
+ * - Samvatsara (60-year cycle)
+ */
+
+// Core modules
+const constants = require('./constants');
+const utils = require('./utils');
+const sunriseSunset = require('./sunrise-sunset');
+
+// Panchanga elements
+const tithiModule = require('./tithi');
+const nakshatraModule = require('./nakshatra');
+const yogamModule = require('./yogam');
+const karanaModule = require('./karana');
+const vaaraModule = require('./vaara');
+
+// Calendar modules
+const lunarCalendar = require('./lunar-calendar');
+const solarCalendar = require('./solar-calendar');
+
+// Muhurtas
+const muhurtas = require('./muhurtas');
+
+/**
+ * Calculate complete Panchanga for a given date and place
+ * 
+ * IMPORTANT: Uses Vedic day (sunrise-to-sunrise).
+ * For times before sunrise, uses previous day's sunrise and vaara.
+ * 
+ * @param {object} birthData - {year, month, date, hour, min, sec, lat, lng, timezone}
+ * @returns {object} Complete panchanga data
+ */
+function calculatePanchanga(birthData) {
+    const { year, month, date, hour = 0, min = 0, sec = 0, lat, lng, timezone } = birthData;
+
+    const jd = utils.dateToJD(year, month, date, hour + min / 60 + sec / 3600);
+    const place = { latitude: lat, longitude: lng, timezone };
+    const currentTime = hour + min / 60 + sec / 3600;
+
+    // Calculate today's sunrise to determine Vedic day
+    const todaySunrise = sunriseSunset.sunrise(jd, place);
+
+    // Determine if birth is before sunrise (previous Vedic day)
+    const isBeforeSunrise = todaySunrise && currentTime < todaySunrise.hours;
+
+    // For Vedic day, if before sunrise, use previous day's sunrise
+    let vedicDayJD = jd;
+    let vedicSunrise, vedicSunset;
+
+    if (isBeforeSunrise) {
+        vedicDayJD = jd - 1; // Previous day
+        vedicSunrise = sunriseSunset.sunrise(vedicDayJD, place);
+        vedicSunset = sunriseSunset.sunset(vedicDayJD, place);
+    } else {
+        vedicSunrise = todaySunrise;
+        vedicSunset = sunriseSunset.sunset(jd, place);
+    }
+
+    // Calculate Vedic vaara (accounts for sunrise-based day)
+    const vedicVaaraData = vaaraModule.vedicVaara(jd, place, todaySunrise);
+
+    // Moon rise/set for the calendar date
+    const moonriseData = sunriseSunset.moonrise(jd, place);
+    const moonsetData = sunriseSunset.moonset(jd, place);
+
+    // IMPORTANT: Panchanga elements (tithi, nakshatra, yoga, karana) are calculated
+    // for the ACTUAL BIRTH MOMENT (jd), not the Vedic day start
+    // These elements reflect the astronomical positions at the exact time
+    const tithiData = tithiModule.tithi(jd, place);
+    const nakshatraData = nakshatraModule.nakshatra(jd, place);
+    const yogaData = yogamModule.yogam(jd, place);
+    const karanaData = karanaModule.karana(jd, place);
+
+    // Calendar data for the Vedic day
+    const lunarMonthData = lunarCalendar.lunarMonth(jd, place);
+    const solarMonthData = solarCalendar.raasi(jd, place);
+    const samvatsaraData = solarCalendar.samvatsara(jd, place);
+
+    // Muhurtas use the Vedic day's sunrise/sunset for time divisions
+    const raahuKaalam = muhurtas.raahuKaalam(vedicDayJD, place);
+    const yamagandaKaalam = muhurtas.yamagandaKaalam(vedicDayJD, place);
+    const gulikaiKaalam = muhurtas.gulikaiKaalam(vedicDayJD, place);
+    const abhijitMuhurta = muhurtas.abhijitMuhurta(vedicDayJD, place);
+    const brahmaMuhurta = muhurtas.brahmaMuhurta(vedicDayJD, place);
+    const durmuhurtamData = muhurtas.durmuhurtam(vedicDayJD, place);
+
+    // Calculate Vedic day length
+    const vedicDayLength = vedicSunset && vedicSunrise ?
+        vedicSunset.hours - vedicSunrise.hours : 12;
+    const vedicNightLength = 24 - vedicDayLength;
+
+    return {
+        date: { year, month, date },
+        time: { hour, min, sec },
+        place: { latitude: lat, longitude: lng, timezone },
+        julianDay: jd,
+        isBeforeSunrise,
+        vedicDate: isBeforeSunrise ? {
+            year: utils.jdToDate(vedicDayJD).year,
+            month: utils.jdToDate(vedicDayJD).month,
+            day: Math.floor(utils.jdToDate(vedicDayJD).day)
+        } : { year, month, day: date },
+
+        // Sun/Moon times (for Vedic day)
+        sunrise: vedicSunrise ? {
+            time: vedicSunrise.hours,
+            string: vedicSunrise.string,
+            string24: vedicSunrise.string24,
+            date: isBeforeSunrise ? `${month}/${date - 1}` : `${month}/${date}`
+        } : null,
+        sunset: vedicSunset ? {
+            time: vedicSunset.hours,
+            string: vedicSunset.string,
+            string24: vedicSunset.string24
+        } : null,
+        moonrise: moonriseData ? {
+            time: moonriseData.hours,
+            string: moonriseData.string
+        } : null,
+        moonset: moonsetData ? {
+            time: moonsetData.hours,
+            string: moonsetData.string
+        } : null,
+        dayLength: vedicDayLength,
+        nightLength: vedicNightLength,
+
+        // Panchanga (5 elements)
+        tithi: tithiData ? {
+            number: tithiData.number,
+            name: tithiData.name,
+            paksha: tithiData.paksha,
+            tithiInPaksha: tithiData.tithiInPaksha,
+            endTime: tithiData.endTimeString,
+            nextTithi: tithiData.nextTithi
+        } : null,
+
+        nakshatra: nakshatraData ? {
+            number: nakshatraData.number,
+            name: nakshatraData.name,
+            pada: nakshatraData.pada,
+            endTime: nakshatraData.endTimeString,
+            nextNakshatra: nakshatraData.nextNakshatra
+        } : null,
+
+        yoga: yogaData ? {
+            number: yogaData.number,
+            name: yogaData.name,
+            endTime: yogaData.endTimeString,
+            auspicious: yogaData.auspicious,
+            nextYoga: yogaData.nextYoga
+        } : null,
+
+        karana: karanaData ? {
+            number: karanaData.number,
+            name: karanaData.name,
+            type: karanaData.type,
+            endTime: karanaData.endTimeString,
+            isVishti: karanaData.isVishti
+        } : null,
+
+        vaara: vedicVaaraData ? {
+            number: vedicVaaraData.number,
+            name: vedicVaaraData.name,
+            nameSanskrit: vedicVaaraData.nameSanskrit,
+            ruler: vedicVaaraData.planetaryRuler.name,
+            isBeforeSunrise: vedicVaaraData.isBeforeSunrise
+        } : null,
+
+        // Calendar
+        lunarMonth: lunarMonthData ? {
+            number: lunarMonthData.number,
+            name: lunarMonthData.fullName,
+            isAdhika: lunarMonthData.isAdhika,
+            isNija: lunarMonthData.isNija
+        } : null,
+
+        solarMonth: solarMonthData ? {
+            number: solarMonthData.number,
+            name: solarMonthData.name,
+            signName: solarMonthData.signName,
+            sunLongitude: solarMonthData.sunLongitude
+        } : null,
+
+        samvatsara: samvatsaraData ? {
+            number: samvatsaraData.number,
+            name: samvatsaraData.name,
+            year: samvatsaraData.year
+        } : null,
+
+        // Muhurtas
+        muhurtas: {
+            raahuKaalam: raahuKaalam ? {
+                start: raahuKaalam.startString,
+                end: raahuKaalam.endString
+            } : null,
+            yamagandaKaalam: yamagandaKaalam ? {
+                start: yamagandaKaalam.startString,
+                end: yamagandaKaalam.endString
+            } : null,
+            gulikaiKaalam: gulikaiKaalam ? {
+                start: gulikaiKaalam.startString,
+                end: gulikaiKaalam.endString
+            } : null,
+            abhijitMuhurta: abhijitMuhurta ? {
+                start: abhijitMuhurta.startString,
+                end: abhijitMuhurta.endString
+            } : null,
+            brahmaMuhurta: brahmaMuhurta ? {
+                start: brahmaMuhurta.startString,
+                end: brahmaMuhurta.endString
+            } : null,
+            durmuhurtam: durmuhurtamData.map(d => ({
+                start: d.startString,
+                end: d.endString
+            }))
+        }
+    };
+}
+
+/**
+ * Get Panchanga for a specific Julian Day
+ * @param {number} jd - Julian Day Number
+ * @param {object} place - {latitude, longitude, timezone}
+ * @returns {object} Panchanga data
+ */
+function getPanchangaForJD(jd, place) {
+    const dateInfo = utils.jdToDate(jd);
+    return calculatePanchanga({
+        year: dateInfo.year,
+        month: dateInfo.month,
+        date: Math.floor(dateInfo.day),
+        hour: Math.floor(dateInfo.hour),
+        min: Math.floor((dateInfo.hour % 1) * 60),
+        sec: 0,
+        lat: place.latitude,
+        lng: place.longitude,
+        timezone: place.timezone
+    });
+}
+
+// Export all functions and constants
+module.exports = {
+    // Main calculation
+    calculatePanchanga,
+    getPanchangaForJD,
+
+    // Constants
+    ...constants,
+
+    // Utils
+    dateToJD: utils.dateToJD,
+    jdToDate: utils.jdToDate,
+    norm360: utils.norm360,
+    formatTime: utils.formatTime,
+
+    // Sunrise/Sunset
+    sunrise: sunriseSunset.sunrise,
+    sunset: sunriseSunset.sunset,
+    moonrise: sunriseSunset.moonrise,
+    moonset: sunriseSunset.moonset,
+    midday: sunriseSunset.midday,
+    midnight: sunriseSunset.midnight,
+    dayLength: sunriseSunset.dayLength,
+    nightLength: sunriseSunset.nightLength,
+    solarLongitude: sunriseSunset.solarLongitude,
+    lunarLongitude: sunriseSunset.lunarLongitude,
+
+    // Tithi
+    tithi: tithiModule.tithi,
+    lunarPhase: tithiModule.lunarPhase,
+    newMoon: tithiModule.newMoon,
+    fullMoon: tithiModule.fullMoon,
+    quickTithi: tithiModule.quickTithi,
+
+    // Nakshatra
+    nakshatra: nakshatraModule.nakshatra,
+    nakshatraPada: nakshatraModule.nakshatraPada,
+    quickNakshatra: nakshatraModule.quickNakshatra,
+    nakshatraLord: nakshatraModule.nakshatraLord,
+
+    // Yoga
+    yogam: yogamModule.yogam,
+    yogaPhase: yogamModule.yogaPhase,
+    isAuspiciousYoga: yogamModule.isAuspiciousYoga,
+
+    // Karana
+    karana: karanaModule.karana,
+    karanaFromTithi: karanaModule.karanaFromTithi,
+    isVishti: karanaModule.isVishti,
+
+    // Vaara
+    vaara: vaaraModule.vaara,
+    vedicVaara: vaaraModule.vedicVaara,
+
+    // Lunar Calendar
+    lunarMonth: lunarCalendar.lunarMonth,
+    lunarDate: lunarCalendar.lunarDate,
+    eraYears: lunarCalendar.eraYears,
+    ritu: lunarCalendar.ritu,
+
+    // Solar Calendar
+    raasi: solarCalendar.raasi,
+    tamilSolarMonthAndDate: solarCalendar.tamilSolarMonthAndDate,
+    samvatsara: solarCalendar.samvatsara,
+    previousSankranti: solarCalendar.previousSankranti,
+    nextSankranti: solarCalendar.nextSankranti,
+
+    // Muhurtas
+    trikalam: muhurtas.trikalam,
+    raahuKaalam: muhurtas.raahuKaalam,
+    yamagandaKaalam: muhurtas.yamagandaKaalam,
+    gulikaiKaalam: muhurtas.gulikaiKaalam,
+    abhijitMuhurta: muhurtas.abhijitMuhurta,
+    durmuhurtam: muhurtas.durmuhurtam,
+    brahmaMuhurta: muhurtas.brahmaMuhurta,
+    godhuliMuhurta: muhurtas.godhuliMuhurta,
+    vijayaMuhurta: muhurtas.vijayaMuhurta,
+    gauriChoghadiya: muhurtas.gauriChoghadiya,
+    amritKaalam: muhurtas.amritKaalam,
+    sandhyaPeriods: muhurtas.sandhyaPeriods
+};