astrology-insights 2.1.0 → 2.3.0

package/dist/core/constants.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * Panchang constants — astronomical degrees, names, and lookup tables.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RASHIS = exports.KARANA_NAMES_FIXED = exports.KARANA_NAMES_REPEATING = exports.YOGA_NAMES = exports.NAKSHATRAS = exports.TITHI_NAMES = exports.normalizeAngle = exports.DEGREES_PER_RASHI = exports.DEGREES_PER_YOGA = exports.DEGREES_PER_PADA = exports.DEGREES_PER_NAKSHATRA = exports.DEGREES_PER_TITHI = void 0;
+// ---------------------------------------------------------------------------
+// Degree constants
+// ---------------------------------------------------------------------------
+exports.DEGREES_PER_TITHI = 12;
+exports.DEGREES_PER_NAKSHATRA = 13.333333;
+exports.DEGREES_PER_PADA = 3.333333;
+exports.DEGREES_PER_YOGA = 13.333333;
+exports.DEGREES_PER_RASHI = 30;
+// ---------------------------------------------------------------------------
+// Helper
+// ---------------------------------------------------------------------------
+function normalizeAngle(angle) {
+    let normalized = angle % 360;
+    if (normalized < 0) {
+        normalized += 360;
+    }
+    return normalized;
+}
+exports.normalizeAngle = normalizeAngle;
+// ---------------------------------------------------------------------------
+// Tithi names (30 total: 15 Shukla + 15 Krishna)
+// Index 0-14 = Shukla Paksha; index 15-29 = Krishna Paksha
+// The 15th tithi of each paksha is Purnima / Amavasya respectively.
+// ---------------------------------------------------------------------------
+exports.TITHI_NAMES = [
+    // Shukla Paksha (1–15)
+    'Shukla Pratipada',
+    'Shukla Dwitiya',
+    'Shukla Tritiya',
+    'Shukla Chaturthi',
+    'Shukla Panchami',
+    'Shukla Shashthi',
+    'Shukla Saptami',
+    'Shukla Ashtami',
+    'Shukla Navami',
+    'Shukla Dashami',
+    'Shukla Ekadashi',
+    'Shukla Dwadashi',
+    'Shukla Trayodashi',
+    'Shukla Chaturdashi',
+    'Purnima',
+    // Krishna Paksha (1–15)
+    'Krishna Pratipada',
+    'Krishna Dwitiya',
+    'Krishna Tritiya',
+    'Krishna Chaturthi',
+    'Krishna Panchami',
+    'Krishna Shashthi',
+    'Krishna Saptami',
+    'Krishna Ashtami',
+    'Krishna Navami',
+    'Krishna Dashami',
+    'Krishna Ekadashi',
+    'Krishna Dwadashi',
+    'Krishna Trayodashi',
+    'Krishna Chaturdashi',
+    'Amavasya',
+];
+// ---------------------------------------------------------------------------
+// Nakshatras (27)
+// ---------------------------------------------------------------------------
+exports.NAKSHATRAS = [
+    { name: 'Ashwini', lord: 'Ketu', deity: 'Ashwini Kumaras' },
+    { name: 'Bharani', lord: 'Venus', deity: 'Yama' },
+    { name: 'Krittika', lord: 'Sun', deity: 'Agni' },
+    { name: 'Rohini', lord: 'Moon', deity: 'Brahma' },
+    { name: 'Mrigashira', lord: 'Mars', deity: 'Soma' },
+    { name: 'Ardra', lord: 'Rahu', deity: 'Rudra' },
+    { name: 'Punarvasu', lord: 'Jupiter', deity: 'Aditi' },
+    { name: 'Pushya', lord: 'Saturn', deity: 'Brihaspati' },
+    { name: 'Ashlesha', lord: 'Mercury', deity: 'Nagas' },
+    { name: 'Magha', lord: 'Ketu', deity: 'Pitrs' },
+    { name: 'Purva Phalguni', lord: 'Venus', deity: 'Bhaga' },
+    { name: 'Uttara Phalguni', lord: 'Sun', deity: 'Aryaman' },
+    { name: 'Hasta', lord: 'Moon', deity: 'Savitar' },
+    { name: 'Chitra', lord: 'Mars', deity: 'Vishvakarma' },
+    { name: 'Swati', lord: 'Rahu', deity: 'Vayu' },
+    { name: 'Vishakha', lord: 'Jupiter', deity: 'Indragni' },
+    { name: 'Anuradha', lord: 'Saturn', deity: 'Mitra' },
+    { name: 'Jyeshtha', lord: 'Mercury', deity: 'Indra' },
+    { name: 'Mula', lord: 'Ketu', deity: 'Nirriti' },
+    { name: 'Purva Ashadha', lord: 'Venus', deity: 'Apah' },
+    { name: 'Uttara Ashadha', lord: 'Sun', deity: 'Vishvedevas' },
+    { name: 'Shravana', lord: 'Moon', deity: 'Vishnu' },
+    { name: 'Dhanishtha', lord: 'Mars', deity: 'Vasus' },
+    { name: 'Shatabhisha', lord: 'Rahu', deity: 'Varuna' },
+    { name: 'Purva Bhadrapada', lord: 'Jupiter', deity: 'Ajaikapat' },
+    { name: 'Uttara Bhadrapada', lord: 'Saturn', deity: 'Ahirbudhnya' },
+    { name: 'Revati', lord: 'Mercury', deity: 'Pushan' },
+];
+// ---------------------------------------------------------------------------
+// Yoga names (27)
+// ---------------------------------------------------------------------------
+exports.YOGA_NAMES = [
+    'Vishkumbha',
+    'Preeti',
+    'Ayushman',
+    'Saubhagya',
+    'Shobhana',
+    'Atiganda',
+    'Sukarman',
+    'Dhriti',
+    'Shoola',
+    'Ganda',
+    'Vriddhi',
+    'Dhruva',
+    'Vyaghata',
+    'Harshana',
+    'Vajra',
+    'Siddhi',
+    'Vyatipata',
+    'Variyan',
+    'Parigha',
+    'Shiva',
+    'Siddha',
+    'Sadhya',
+    'Shubha',
+    'Shukla',
+    'Brahma',
+    'Indra',
+    'Vaidhriti',
+];
+// ---------------------------------------------------------------------------
+// Karana names
+// ---------------------------------------------------------------------------
+/** 7 movable (repeating) karanas */
+exports.KARANA_NAMES_REPEATING = [
+    'Bava',
+    'Balava',
+    'Kaulava',
+    'Taitila',
+    'Garija',
+    'Vanija',
+    'Vishti',
+];
+/** 4 fixed karanas (occur once per lunar month at the end) */
+exports.KARANA_NAMES_FIXED = [
+    'Shakuni',
+    'Chatushpad',
+    'Naga',
+    'Kimstughna',
+];
+// ---------------------------------------------------------------------------
+// Rashis (12)
+// ---------------------------------------------------------------------------
+exports.RASHIS = [
+    { name: 'Aries', sanskritName: 'Mesha', lord: 'Mars', element: 'Fire' },
+    { name: 'Taurus', sanskritName: 'Vrishabha', lord: 'Venus', element: 'Earth' },
+    { name: 'Gemini', sanskritName: 'Mithuna', lord: 'Mercury', element: 'Air' },
+    { name: 'Cancer', sanskritName: 'Karka', lord: 'Moon', element: 'Water' },
+    { name: 'Leo', sanskritName: 'Simha', lord: 'Sun', element: 'Fire' },
+    { name: 'Virgo', sanskritName: 'Kanya', lord: 'Mercury', element: 'Earth' },
+    { name: 'Libra', sanskritName: 'Tula', lord: 'Venus', element: 'Air' },
+    { name: 'Scorpio', sanskritName: 'Vrishchika', lord: 'Mars', element: 'Water' },
+    { name: 'Sagittarius', sanskritName: 'Dhanu', lord: 'Jupiter', element: 'Fire' },
+    { name: 'Capricorn', sanskritName: 'Makara', lord: 'Saturn', element: 'Earth' },
+    { name: 'Aquarius', sanskritName: 'Kumbha', lord: 'Saturn', element: 'Air' },
+    { name: 'Pisces', sanskritName: 'Meena', lord: 'Jupiter', element: 'Water' },
+];

package/dist/core/karana.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateKarana = void 0;
+const constants_1 = require("./constants");
+const DEGREES_PER_KARANA = 6;
+function calculateKarana(sunLongitude, moonLongitude) {
+    const diff = (0, constants_1.normalizeAngle)(moonLongitude - sunLongitude);
+    const karanaIndex = Math.floor(diff / DEGREES_PER_KARANA);
+    const posInKarana = diff - (karanaIndex * DEGREES_PER_KARANA);
+    const progress = (posInKarana / DEGREES_PER_KARANA) * 100;
+    let name;
+    if (karanaIndex === 0) {
+        name = 'Kimstughna';
+    }
+    else if (karanaIndex >= 57) {
+        name = constants_1.KARANA_NAMES_FIXED[karanaIndex - 57];
+    }
+    else {
+        name = constants_1.KARANA_NAMES_REPEATING[(karanaIndex - 1) % 7];
+    }
+    return { name, number: karanaIndex + 1, progress: Math.round(progress * 10) / 10 };
+}
+exports.calculateKarana = calculateKarana;

package/dist/core/nakshatra.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateNakshatra = void 0;
+const constants_1 = require("./constants");
+function calculateNakshatra(moonLongitude) {
+    const lon = (0, constants_1.normalizeAngle)(moonLongitude);
+    const nakshatraIndex = Math.floor(lon / constants_1.DEGREES_PER_NAKSHATRA);
+    const posInNakshatra = lon - (nakshatraIndex * constants_1.DEGREES_PER_NAKSHATRA);
+    const pada = Math.min(Math.floor(posInNakshatra / constants_1.DEGREES_PER_PADA) + 1, 4);
+    const posInPada = posInNakshatra - ((pada - 1) * constants_1.DEGREES_PER_PADA);
+    const nk = constants_1.NAKSHATRAS[nakshatraIndex];
+    const progress = (posInNakshatra / constants_1.DEGREES_PER_NAKSHATRA) * 100;
+    const padaProgress = (posInPada / constants_1.DEGREES_PER_PADA) * 100;
+    return {
+        name: nk.name, number: nakshatraIndex + 1, pada,
+        lord: nk.lord, deity: nk.deity,
+        progress: Math.round(progress * 10) / 10,
+        padaProgress: Math.round(padaProgress * 10) / 10,
+    };
+}
+exports.calculateNakshatra = calculateNakshatra;

package/dist/core/rashi.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateRashi = void 0;
+const constants_1 = require("./constants");
+function calculateRashi(longitude) {
+    const lon = (0, constants_1.normalizeAngle)(longitude);
+    const rashiIndex = Math.floor(lon / constants_1.DEGREES_PER_RASHI);
+    const degree = lon - (rashiIndex * constants_1.DEGREES_PER_RASHI);
+    const rashi = constants_1.RASHIS[rashiIndex];
+    return {
+        name: rashi.name,
+        lord: rashi.lord,
+        degree: Math.round(degree * 10) / 10,
+        number: rashiIndex + 1,
+    };
+}
+exports.calculateRashi = calculateRashi;

package/dist/core/tithi.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateTithi = void 0;
+const constants_1 = require("./constants");
+// Bare tithi names (without paksha prefix) for both halves.
+// Index 0–14: Shukla Paksha tithis; index 15–29: Krishna Paksha tithis.
+// Purnima (index 14) and Amavasya (index 29) have no paksha prefix.
+const BARE_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',
+];
+function calculateTithi(sunLongitude, moonLongitude) {
+    const diff = (0, constants_1.normalizeAngle)(moonLongitude - sunLongitude);
+    const tithiIndex = Math.floor(diff / constants_1.DEGREES_PER_TITHI);
+    const progress = ((diff % constants_1.DEGREES_PER_TITHI) / constants_1.DEGREES_PER_TITHI) * 100;
+    const isShukla = tithiIndex < 15;
+    const paksha = isShukla ? 'Shukla' : 'Krishna';
+    const pakshaNumber = isShukla ? tithiIndex + 1 : tithiIndex - 15 + 1;
+    const baseName = BARE_TITHI_NAMES[tithiIndex];
+    // Purnima and Amavasya are standalone names; all others get paksha prefix.
+    const name = (baseName === 'Purnima' || baseName === 'Amavasya')
+        ? baseName
+        : `${paksha} ${baseName}`;
+    return {
+        name,
+        number: pakshaNumber,
+        tithiIndex: tithiIndex + 1,
+        paksha,
+        progress: Math.round(progress * 10) / 10,
+    };
+}
+exports.calculateTithi = calculateTithi;

package/dist/core/yoga.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateYoga = void 0;
+const constants_1 = require("./constants");
+function calculateYoga(sunLongitude, moonLongitude) {
+    const sum = (0, constants_1.normalizeAngle)(sunLongitude + moonLongitude);
+    const yogaIndex = Math.floor(sum / constants_1.DEGREES_PER_YOGA);
+    const posInYoga = sum - (yogaIndex * constants_1.DEGREES_PER_YOGA);
+    const progress = (posInYoga / constants_1.DEGREES_PER_YOGA) * 100;
+    return {
+        name: constants_1.YOGA_NAMES[yogaIndex],
+        number: yogaIndex + 1,
+        progress: Math.round(progress * 10) / 10,
+    };
+}
+exports.calculateYoga = calculateYoga;

package/dist/panchang/src/birthchart/analysis/aspects.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Vedic Planetary Aspects (Graha Drishti)
+ *
+ * Every planet fully aspects the 7th house from its position.
+ * Mars, Jupiter, Saturn, Rahu, and Ketu have additional special aspects.
+ */
+export interface PlanetaryAspect {
+    planet: string;
+    aspectsHouse: number;
+    aspectsPlanets: string[];
+    aspectType: 'full' | 'three_quarter' | 'half' | 'quarter';
+    strength: number;
+}
+export interface AspectResult {
+    aspects: PlanetaryAspect[];
+    houseAspects: Record<number, {
+        aspectedBy: string[];
+    }>;
+}
+export interface AspectPlanetInput {
+    name: string;
+    houseNumber: number;
+}
+export declare function calculateAspects(planets: AspectPlanetInput[]): AspectResult;

package/dist/panchang/src/birthchart/analysis/aspects.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Vedic Planetary Aspects (Graha Drishti)
+ *
+ * Every planet fully aspects the 7th house from its position.
+ * Mars, Jupiter, Saturn, Rahu, and Ketu have additional special aspects.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateAspects = void 0;
+// ── Aspect rules ─────────────────────────────────────────────────────────────
+/**
+ * Returns the Vedic house numbers (counted from the planet's house as 1)
+ * that a planet aspects, with strength.
+ * "7th house" means counting the planet's own house as 1.
+ */
+function getAspectedHouseNumbers(planetName) {
+    // All planets aspect the 7th house from their position
+    const aspects = [
+        { nthHouse: 7, type: 'full', strength: 100 },
+    ];
+    switch (planetName) {
+        case 'Mars':
+            aspects.push({ nthHouse: 4, type: 'full', strength: 100 }, { nthHouse: 8, type: 'full', strength: 100 });
+            break;
+        case 'Jupiter':
+            aspects.push({ nthHouse: 5, type: 'full', strength: 100 }, { nthHouse: 9, type: 'full', strength: 100 });
+            break;
+        case 'Saturn':
+            aspects.push({ nthHouse: 3, type: 'full', strength: 100 }, { nthHouse: 10, type: 'full', strength: 100 });
+            break;
+        case 'Rahu':
+        case 'Ketu':
+            aspects.push({ nthHouse: 5, type: 'full', strength: 100 }, { nthHouse: 9, type: 'full', strength: 100 });
+            break;
+    }
+    return aspects;
+}
+/**
+ * Given a base house and an nth-house count (Vedic style, where 1 = own house),
+ * return the absolute house number (1-12).
+ * E.g., nthHouse=7 from baseHouse=1 => house 7; nthHouse=7 from baseHouse=8 => house 2.
+ */
+function resolveHouse(baseHouse, nthHouse) {
+    return ((baseHouse - 1 + (nthHouse - 1)) % 12) + 1;
+}
+// ── Calculator ───────────────────────────────────────────────────────────────
+function calculateAspects(planets) {
+    // Build a map of house -> planets in that house
+    const housePlanets = {};
+    for (let h = 1; h <= 12; h++) {
+        housePlanets[h] = [];
+    }
+    for (const p of planets) {
+        housePlanets[p.houseNumber]?.push(p.name);
+    }
+    const aspects = [];
+    const houseAspects = {};
+    for (let h = 1; h <= 12; h++) {
+        houseAspects[h] = { aspectedBy: [] };
+    }
+    for (const planet of planets) {
+        const aspectRules = getAspectedHouseNumbers(planet.name);
+        for (const { nthHouse, type, strength } of aspectRules) {
+            const target = resolveHouse(planet.houseNumber, nthHouse);
+            const planetsInTarget = housePlanets[target] ?? [];
+            aspects.push({
+                planet: planet.name,
+                aspectsHouse: target,
+                aspectsPlanets: [...planetsInTarget],
+                aspectType: type,
+                strength,
+            });
+            houseAspects[target].aspectedBy.push(planet.name);
+        }
+    }
+    return { aspects, houseAspects };
+}
+exports.calculateAspects = calculateAspects;

package/dist/panchang/src/birthchart/analysis/dosha.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Dosha Analysis Module
+ *
+ * Detects and analyzes major Vedic astrology doshas:
+ * - Manglik (Kuja) Dosha
+ * - Kaal Sarp Dosha
+ * - Ganda Moola Dosha
+ * - Gandanta Analysis
+ */
+import type { GrahaPosition, HouseInfo, LagnaInfo } from '../types';
+export interface ManglikResult {
+    isManglik: boolean;
+    severity: 'none' | 'mild' | 'full';
+    marsHouse: number;
+    details: string;
+    cancellations: string[];
+}
+/**
+ * Detect Manglik (Kuja) Dosha from a birth chart.
+ */
+export declare function analyzeManglik(planets: GrahaPosition[], houses: HouseInfo[]): ManglikResult;
+export interface KaalSarpResult {
+    hasDosha: boolean;
+    type: string | null;
+    rahuHouse: number;
+    ketuHouse: number;
+    allPlanetsOnOneSide: boolean;
+    details: string;
+    affectedHouses: number[];
+}
+/**
+ * Detect Kaal Sarp Dosha.
+ *
+ * All 7 planets (Sun through Saturn) must be on one side of the Rahu-Ketu axis.
+ */
+export declare function analyzeKaalSarp(planets: GrahaPosition[], houses: HouseInfo[]): KaalSarpResult;
+export interface GandaMoolaResult {
+    hasDosha: boolean;
+    moonNakshatra: string;
+    moonPada: number;
+    affectedNakshatras: string[];
+    details: string;
+    severity: 'none' | 'mild' | 'severe';
+}
+/**
+ * Detect Ganda Moola Dosha based on Moon's nakshatra.
+ */
+export declare function analyzeGandaMoola(planets: GrahaPosition[]): GandaMoolaResult;
+export interface GandantaPlanet {
+    name: string;
+    signName: string;
+    degree: number;
+    type: 'nakshatra_gandanta' | 'rashi_gandanta' | 'tithi_gandanta';
+    details: string;
+}
+export interface GandantaResult {
+    hasGandanta: boolean;
+    planets: GandantaPlanet[];
+}
+/**
+ * Analyze Gandanta positions for all planets and Lagna.
+ */
+export declare function analyzeGandanta(planets: GrahaPosition[], lagna: LagnaInfo): GandantaResult;