jyotish-calc 1.1.0

package/src/vargas/constants.js

@@ -0,0 +1,362 @@
+/**
+ * Divisional Charts (Vargas) Constants
+ * Definitions and sign classifications for Parashari Jyotish
+ */
+
+// ============================================================================
+// SIGN DATA
+// ============================================================================
+
+/**
+ * Sign names in full format
+ */
+const SIGNS = [
+    'Aries', 'Taurus', 'Gemini', 'Cancer',
+    'Leo', 'Virgo', 'Libra', 'Scorpio',
+    'Sagittarius', 'Capricorn', 'Aquarius', 'Pisces'
+];
+
+/**
+ * Sign abbreviations
+ */
+const SIGNS_SHORT = ['Ar', 'Ta', 'Ge', 'Cn', 'Le', 'Vi', 'Li', 'Sc', 'Sg', 'Cp', 'Aq', 'Pi'];
+
+/**
+ * Sign lords (planets ruling each sign)
+ */
+const SIGN_LORDS = {
+    0: 'Mars',      // Aries
+    1: 'Venus',     // Taurus
+    2: 'Mercury',   // Gemini
+    3: 'Moon',      // Cancer
+    4: 'Sun',       // Leo
+    5: 'Mercury',   // Virgo
+    6: 'Venus',     // Libra
+    7: 'Mars',      // Scorpio
+    8: 'Jupiter',   // Sagittarius
+    9: 'Saturn',    // Capricorn
+    10: 'Saturn',   // Aquarius
+    11: 'Jupiter'   // Pisces
+};
+
+// ============================================================================
+// SIGN CLASSIFICATIONS
+// ============================================================================
+
+/**
+ * Movable (Chara) signs - indices
+ */
+const MOVABLE_SIGNS = [0, 3, 6, 9]; // Aries, Cancer, Libra, Capricorn
+
+/**
+ * Fixed (Sthira) signs - indices
+ */
+const FIXED_SIGNS = [1, 4, 7, 10]; // Taurus, Leo, Scorpio, Aquarius
+
+/**
+ * Dual (Dwiswabhava) signs - indices
+ */
+const DUAL_SIGNS = [2, 5, 8, 11]; // Gemini, Virgo, Sagittarius, Pisces
+
+/**
+ * Odd (Masculine) signs - indices
+ */
+const ODD_SIGNS = [0, 2, 4, 6, 8, 10]; // Aries, Gemini, Leo, Libra, Sagittarius, Aquarius
+
+/**
+ * Even (Feminine) signs - indices
+ */
+const EVEN_SIGNS = [1, 3, 5, 7, 9, 11]; // Taurus, Cancer, Virgo, Scorpio, Capricorn, Pisces
+
+/**
+ * Fire signs - indices
+ */
+const FIRE_SIGNS = [0, 4, 8]; // Aries, Leo, Sagittarius
+
+/**
+ * Earth signs - indices
+ */
+const EARTH_SIGNS = [1, 5, 9]; // Taurus, Virgo, Capricorn
+
+/**
+ * Air signs - indices
+ */
+const AIR_SIGNS = [2, 6, 10]; // Gemini, Libra, Aquarius
+
+/**
+ * Water signs - indices
+ */
+const WATER_SIGNS = [3, 7, 11]; // Cancer, Scorpio, Pisces
+
+// ============================================================================
+// VARGA DEFINITIONS
+// ============================================================================
+
+/**
+ * All 21 divisional charts with metadata
+ */
+const VARGAS = {
+    D1: {
+        id: 'D1',
+        name: 'Rashi',
+        divisions: 1,
+        degreesPerDivision: 30,
+        focus: 'Overall life, body, health, general promise'
+    },
+    D2: {
+        id: 'D2',
+        name: 'Hora',
+        divisions: 2,
+        degreesPerDivision: 15,
+        focus: 'Wealth, prosperity, food, resources'
+    },
+    D3: {
+        id: 'D3',
+        name: 'Drekkana',
+        divisions: 3,
+        degreesPerDivision: 10,
+        focus: 'Siblings, courage, efforts'
+    },
+    D4: {
+        id: 'D4',
+        name: 'Chaturthamsha',
+        divisions: 4,
+        degreesPerDivision: 7.5,
+        focus: 'Fortune, property, fixed and movable assets'
+    },
+    D5: {
+        id: 'D5',
+        name: 'Panchamsha',
+        divisions: 5,
+        degreesPerDivision: 6,
+        focus: 'Purva punya, inherent talent, creative intelligence'
+    },
+    D6: {
+        id: 'D6',
+        name: 'Shashtamsha',
+        divisions: 6,
+        degreesPerDivision: 5,
+        focus: 'Diseases, obstacles, enemies, debt'
+    },
+    D7: {
+        id: 'D7',
+        name: 'Saptamsha',
+        divisions: 7,
+        degreesPerDivision: 30 / 7,
+        focus: 'Children, progeny, creativity passed to next generation'
+    },
+    D8: {
+        id: 'D8',
+        name: 'Ashtamsha',
+        divisions: 8,
+        degreesPerDivision: 3.75,
+        focus: 'Longevity, sudden events, transformations'
+    },
+    D9: {
+        id: 'D9',
+        name: 'Navamsha',
+        divisions: 9,
+        degreesPerDivision: 30 / 9,
+        focus: 'Marriage, spouse, dharma, inner strength, maturity of planets'
+    },
+    D10: {
+        id: 'D10',
+        name: 'Dashamsha',
+        divisions: 10,
+        degreesPerDivision: 3,
+        focus: 'Profession, status, karma in action'
+    },
+    D11: {
+        id: 'D11',
+        name: 'Rudramsha',
+        divisions: 11,
+        degreesPerDivision: 30 / 11,
+        focus: 'Gains, destruction, sudden rise or fall'
+    },
+    D12: {
+        id: 'D12',
+        name: 'Dvadashamsha',
+        divisions: 12,
+        degreesPerDivision: 2.5,
+        focus: 'Parents, ancestry, heredity, lineage'
+    },
+    D16: {
+        id: 'D16',
+        name: 'Shodasamsha',
+        divisions: 16,
+        degreesPerDivision: 1.875,
+        focus: 'Vehicles, comforts, luxuries'
+    },
+    D20: {
+        id: 'D20',
+        name: 'Vimsamsha',
+        divisions: 20,
+        degreesPerDivision: 1.5,
+        focus: 'Spiritual inclination, mantra, sadhana'
+    },
+    D24: {
+        id: 'D24',
+        name: 'Chaturvimshamsha',
+        divisions: 24,
+        degreesPerDivision: 1.25,
+        focus: 'Education, learning, scriptural knowledge'
+    },
+    D27: {
+        id: 'D27',
+        name: 'Saptavimshamsha',
+        divisions: 27,
+        degreesPerDivision: 30 / 27,
+        focus: 'Strengths and weaknesses, resilience, internal grit'
+    },
+    D30: {
+        id: 'D30',
+        name: 'Trimsamsha',
+        divisions: 30,
+        degreesPerDivision: 1,
+        focus: 'Mishaps, misfortunes, character, inner flaws'
+    },
+    D32: {
+        id: 'D32',
+        name: 'Trimshadvamsha',
+        divisions: 32,
+        degreesPerDivision: 30 / 32,
+        focus: 'Misfortunes, specific karmic debts, subtle strengths'
+    },
+    D40: {
+        id: 'D40',
+        name: 'Khavedamsha',
+        divisions: 40,
+        degreesPerDivision: 0.75,
+        focus: 'Auspicious and inauspicious results, family karma'
+    },
+    D45: {
+        id: 'D45',
+        name: 'Akshavedamsha',
+        divisions: 45,
+        degreesPerDivision: 30 / 45,
+        focus: 'Character, conduct, general auspiciousness'
+    },
+    D60: {
+        id: 'D60',
+        name: 'Shashtyamsha',
+        divisions: 60,
+        degreesPerDivision: 0.5,
+        focus: 'Past-life karma, fine destiny, minute strengths/weaknesses'
+    }
+};
+
+/**
+ * D30 Trimsamsha planet-based unequal segments for ODD signs
+ * Segment boundaries and their ruling planets/signs
+ */
+const TRIMSAMSHA_ODD = [
+    { start: 0, end: 5, planet: 'Mars', sign: 0 },      // 0°-5° → Aries
+    { start: 5, end: 10, planet: 'Saturn', sign: 10 },  // 5°-10° → Aquarius
+    { start: 10, end: 18, planet: 'Jupiter', sign: 8 }, // 10°-18° → Sagittarius
+    { start: 18, end: 25, planet: 'Mercury', sign: 2 }, // 18°-25° → Gemini
+    { start: 25, end: 30, planet: 'Venus', sign: 6 }    // 25°-30° → Libra
+];
+
+/**
+ * D30 Trimsamsha planet-based unequal segments for EVEN signs
+ * Reverse order from ODD signs
+ */
+const TRIMSAMSHA_EVEN = [
+    { start: 0, end: 5, planet: 'Venus', sign: 1 },     // 0°-5° → Taurus
+    { start: 5, end: 12, planet: 'Mercury', sign: 5 },  // 5°-12° → Virgo
+    { start: 12, end: 20, planet: 'Jupiter', sign: 11 }, // 12°-20° → Pisces
+    { start: 20, end: 25, planet: 'Saturn', sign: 9 },  // 20°-25° → Capricorn
+    { start: 25, end: 30, planet: 'Mars', sign: 7 }     // 25°-30° → Scorpio
+];
+
+/**
+ * D60 Shashtyamsha names (60 divisions with auspicious/inauspicious nature)
+ */
+const SHASHTYAMSHA_NAMES = [
+    { name: 'Ghora', nature: 'inauspicious' },
+    { name: 'Rakshasa', nature: 'inauspicious' },
+    { name: 'Deva', nature: 'auspicious' },
+    { name: 'Kubera', nature: 'auspicious' },
+    { name: 'Yaksha', nature: 'auspicious' },
+    { name: 'Kinnara', nature: 'auspicious' },
+    { name: 'Bhrashta', nature: 'inauspicious' },
+    { name: 'Kulaghna', nature: 'inauspicious' },
+    { name: 'Garala', nature: 'inauspicious' },
+    { name: 'Vahni', nature: 'inauspicious' },
+    { name: 'Maya', nature: 'inauspicious' },
+    { name: 'Purishaka', nature: 'inauspicious' },
+    { name: 'Apampati', nature: 'auspicious' },
+    { name: 'Marut', nature: 'auspicious' },
+    { name: 'Kaala', nature: 'inauspicious' },
+    { name: 'Sarpa', nature: 'inauspicious' },
+    { name: 'Amrita', nature: 'auspicious' },
+    { name: 'Indu', nature: 'auspicious' },
+    { name: 'Mridu', nature: 'auspicious' },
+    { name: 'Komala', nature: 'auspicious' },
+    { name: 'Heramba', nature: 'auspicious' },
+    { name: 'Brahma', nature: 'auspicious' },
+    { name: 'Vishnu', nature: 'auspicious' },
+    { name: 'Maheshwara', nature: 'auspicious' },
+    { name: 'Deva', nature: 'auspicious' },
+    { name: 'Ardra', nature: 'inauspicious' },
+    { name: 'Kalinasha', nature: 'auspicious' },
+    { name: 'Kshiteesa', nature: 'auspicious' },
+    { name: 'Kamalakara', nature: 'auspicious' },
+    { name: 'Gulika', nature: 'inauspicious' },
+    { name: 'Mrityu', nature: 'inauspicious' },
+    { name: 'Kaala', nature: 'inauspicious' },
+    { name: 'Davagni', nature: 'inauspicious' },
+    { name: 'Ghora', nature: 'inauspicious' },
+    { name: 'Yama', nature: 'inauspicious' },
+    { name: 'Kantaka', nature: 'inauspicious' },
+    { name: 'Sudha', nature: 'auspicious' },
+    { name: 'Amrita', nature: 'auspicious' },
+    { name: 'Poornachandra', nature: 'auspicious' },
+    { name: 'Vishadagdha', nature: 'inauspicious' },
+    { name: 'Kulanasha', nature: 'inauspicious' },
+    { name: 'Vamshakshaya', nature: 'inauspicious' },
+    { name: 'Utpata', nature: 'inauspicious' },
+    { name: 'Kaala', nature: 'inauspicious' },
+    { name: 'Saumya', nature: 'auspicious' },
+    { name: 'Komala', nature: 'auspicious' },
+    { name: 'Sheetala', nature: 'auspicious' },
+    { name: 'Karala', nature: 'inauspicious' },
+    { name: 'Chandramukhi', nature: 'auspicious' },
+    { name: 'Praveena', nature: 'auspicious' },
+    { name: 'Kalagni', nature: 'inauspicious' },
+    { name: 'Dandayudha', nature: 'inauspicious' },
+    { name: 'Nirmala', nature: 'auspicious' },
+    { name: 'Saumya', nature: 'auspicious' },
+    { name: 'Kroora', nature: 'inauspicious' },
+    { name: 'Atisheetala', nature: 'auspicious' },
+    { name: 'Amrita', nature: 'auspicious' },
+    { name: 'Payodhi', nature: 'auspicious' },
+    { name: 'Brahma', nature: 'auspicious' },
+    { name: 'Chandrarekha', nature: 'auspicious' }
+];
+
+module.exports = {
+    // Sign data
+    SIGNS,
+    SIGNS_SHORT,
+    SIGN_LORDS,
+
+    // Sign classifications
+    MOVABLE_SIGNS,
+    FIXED_SIGNS,
+    DUAL_SIGNS,
+    ODD_SIGNS,
+    EVEN_SIGNS,
+    FIRE_SIGNS,
+    EARTH_SIGNS,
+    AIR_SIGNS,
+    WATER_SIGNS,
+
+    // Varga definitions
+    VARGAS,
+
+    // Special varga data
+    TRIMSAMSHA_ODD,
+    TRIMSAMSHA_EVEN,
+    SHASHTYAMSHA_NAMES
+};

package/src/vargas/index.js

@@ -0,0 +1,121 @@
+/**
+ * Vargas Module - Divisional Charts for Vedic Astrology
+ * 
+ * Implements all 21 standard divisional charts (D1-D60) following Parashari tradition
+ * 
+ * Usage:
+ *   const { vargas } = require('jyotish-calculations');
+ *   
+ *   // Calculate Navamsha (D9) for a planet at 45°
+ *   const navamsha = vargas.calculateVarga(45, 'D9');
+ *   
+ *   // Calculate all vargas for a planet
+ *   const allVargas = vargas.calculateAllVargas(45);
+ *   
+ *   // Calculate varga chart for multiple planets
+ *   const chart = vargas.calculateVargaChart({
+ *     Sun: 45.5,
+ *     Moon: 120.3,
+ *     Mars: 200.7
+ *   }, 'D9');
+ */
+
+const { SIGNS, SIGNS_SHORT, VARGAS, SHASHTYAMSHA_NAMES } = require('./constants');
+
+const {
+    normalizeLongitude,
+    getSignIndex,
+    getDegreeInSign,
+    normalizeSign,
+    isOddSign,
+    isEvenSign,
+    isMovableSign,
+    isFixedSign,
+    isDualSign,
+    getSignQuality,
+    getElement,
+    getDivisionIndex
+} = require('./utils');
+
+const {
+    calculateVarga,
+    calculateAllVargas,
+    calculateVargaChart,
+    getVargaInfo,
+    getSupportedVargas,
+    calculateD1,
+    calculateD2,
+    calculateD3,
+    calculateD4,
+    calculateD5,
+    calculateD6,
+    calculateD7,
+    calculateD8,
+    calculateD9,
+    calculateD10,
+    calculateD11,
+    calculateD12,
+    calculateD16,
+    calculateD20,
+    calculateD24,
+    calculateD27,
+    calculateD30,
+    calculateD32,
+    calculateD40,
+    calculateD45,
+    calculateD60,
+    VARGA_CALCULATORS
+} = require('./varga');
+
+module.exports = {
+    // Main API
+    calculateVarga,
+    calculateAllVargas,
+    calculateVargaChart,
+    getVargaInfo,
+    getSupportedVargas,
+
+    // Individual varga calculators
+    calculateD1,
+    calculateD2,
+    calculateD3,
+    calculateD4,
+    calculateD5,
+    calculateD6,
+    calculateD7,
+    calculateD8,
+    calculateD9,
+    calculateD10,
+    calculateD11,
+    calculateD12,
+    calculateD16,
+    calculateD20,
+    calculateD24,
+    calculateD27,
+    calculateD30,
+    calculateD32,
+    calculateD40,
+    calculateD45,
+    calculateD60,
+
+    // Utility functions
+    normalizeLongitude,
+    getSignIndex,
+    getDegreeInSign,
+    normalizeSign,
+    isOddSign,
+    isEvenSign,
+    isMovableSign,
+    isFixedSign,
+    isDualSign,
+    getSignQuality,
+    getElement,
+    getDivisionIndex,
+
+    // Constants
+    SIGNS,
+    SIGNS_SHORT,
+    VARGAS,
+    SHASHTYAMSHA_NAMES,
+    VARGA_CALCULATORS
+};

package/src/vargas/utils.js

@@ -0,0 +1,196 @@
+/**
+ * Varga Utility Functions
+ * Core helpers for divisional chart calculations
+ */
+
+const {
+    MOVABLE_SIGNS,
+    FIXED_SIGNS,
+    DUAL_SIGNS,
+    ODD_SIGNS,
+    EVEN_SIGNS,
+    FIRE_SIGNS,
+    EARTH_SIGNS,
+    AIR_SIGNS,
+    WATER_SIGNS
+} = require('./constants');
+
+/**
+ * Normalize longitude to 0-360 range
+ * @param {number} longitude - Longitude in degrees
+ * @returns {number} Normalized longitude (0-360)
+ */
+function normalizeLongitude(longitude) {
+    if (typeof longitude !== 'number' || isNaN(longitude)) {
+        throw new TypeError('Longitude must be a valid number');
+    }
+    return ((longitude % 360) + 360) % 360;
+}
+
+/**
+ * Get sign index (0-11) from longitude
+ * @param {number} longitude - Longitude in degrees (0-360)
+ * @returns {number} Sign index (0 = Aries, 11 = Pisces)
+ */
+function getSignIndex(longitude) {
+    const normalized = normalizeLongitude(longitude);
+    return Math.floor(normalized / 30);
+}
+
+/**
+ * Get degree within sign (0-30)
+ * @param {number} longitude - Longitude in degrees
+ * @returns {number} Degree within the sign (0-30)
+ */
+function getDegreeInSign(longitude) {
+    const normalized = normalizeLongitude(longitude);
+    return normalized % 30;
+}
+
+/**
+ * Normalize sign index to 0-11 range
+ * @param {number} signIndex - Sign index (can be any integer)
+ * @returns {number} Normalized sign index (0-11)
+ */
+function normalizeSign(signIndex) {
+    return ((signIndex % 12) + 12) % 12;
+}
+
+/**
+ * Check if sign is odd (masculine)
+ * @param {number} signIndex - Sign index (0-11)
+ * @returns {boolean}
+ */
+function isOddSign(signIndex) {
+    return ODD_SIGNS.includes(normalizeSign(signIndex));
+}
+
+/**
+ * Check if sign is even (feminine)
+ * @param {number} signIndex - Sign index (0-11)
+ * @returns {boolean}
+ */
+function isEvenSign(signIndex) {
+    return EVEN_SIGNS.includes(normalizeSign(signIndex));
+}
+
+/**
+ * Check if sign is movable (chara)
+ * @param {number} signIndex - Sign index (0-11)
+ * @returns {boolean}
+ */
+function isMovableSign(signIndex) {
+    return MOVABLE_SIGNS.includes(normalizeSign(signIndex));
+}
+
+/**
+ * Check if sign is fixed (sthira)
+ * @param {number} signIndex - Sign index (0-11)
+ * @returns {boolean}
+ */
+function isFixedSign(signIndex) {
+    return FIXED_SIGNS.includes(normalizeSign(signIndex));
+}
+
+/**
+ * Check if sign is dual (dwiswabhava)
+ * @param {number} signIndex - Sign index (0-11)
+ * @returns {boolean}
+ */
+function isDualSign(signIndex) {
+    return DUAL_SIGNS.includes(normalizeSign(signIndex));
+}
+
+/**
+ * Get sign quality (movable, fixed, or dual)
+ * @param {number} signIndex - Sign index (0-11)
+ * @returns {string} 'movable', 'fixed', or 'dual'
+ */
+function getSignQuality(signIndex) {
+    const normalized = normalizeSign(signIndex);
+    if (MOVABLE_SIGNS.includes(normalized)) return 'movable';
+    if (FIXED_SIGNS.includes(normalized)) return 'fixed';
+    return 'dual';
+}
+
+/**
+ * Get element type for a sign
+ * @param {number} signIndex - Sign index (0-11)
+ * @returns {string} 'fire', 'earth', 'air', or 'water'
+ */
+function getElement(signIndex) {
+    const normalized = normalizeSign(signIndex);
+    if (FIRE_SIGNS.includes(normalized)) return 'fire';
+    if (EARTH_SIGNS.includes(normalized)) return 'earth';
+    if (AIR_SIGNS.includes(normalized)) return 'air';
+    return 'water';
+}
+
+/**
+ * Check if sign is a fire sign
+ * @param {number} signIndex - Sign index (0-11)
+ * @returns {boolean}
+ */
+function isFireSign(signIndex) {
+    return FIRE_SIGNS.includes(normalizeSign(signIndex));
+}
+
+/**
+ * Check if sign is an earth sign
+ * @param {number} signIndex - Sign index (0-11)
+ * @returns {boolean}
+ */
+function isEarthSign(signIndex) {
+    return EARTH_SIGNS.includes(normalizeSign(signIndex));
+}
+
+/**
+ * Check if sign is an air sign
+ * @param {number} signIndex - Sign index (0-11)
+ * @returns {boolean}
+ */
+function isAirSign(signIndex) {
+    return AIR_SIGNS.includes(normalizeSign(signIndex));
+}
+
+/**
+ * Check if sign is a water sign
+ * @param {number} signIndex - Sign index (0-11)
+ * @returns {boolean}
+ */
+function isWaterSign(signIndex) {
+    return WATER_SIGNS.includes(normalizeSign(signIndex));
+}
+
+/**
+ * Calculate division index within a sign
+ * @param {number} degreeInSign - Degree within sign (0-30)
+ * @param {number} divisions - Number of divisions
+ * @returns {number} Division index (0 to divisions-1)
+ */
+function getDivisionIndex(degreeInSign, divisions) {
+    const degreesPerDivision = 30 / divisions;
+    let divIndex = Math.floor(degreeInSign / degreesPerDivision);
+    // Handle edge case at exactly 30°
+    if (divIndex >= divisions) divIndex = divisions - 1;
+    return divIndex;
+}
+
+module.exports = {
+    normalizeLongitude,
+    getSignIndex,
+    getDegreeInSign,
+    normalizeSign,
+    isOddSign,
+    isEvenSign,
+    isMovableSign,
+    isFixedSign,
+    isDualSign,
+    getSignQuality,
+    getElement,
+    isFireSign,
+    isEarthSign,
+    isAirSign,
+    isWaterSign,
+    getDivisionIndex
+};