dashaflow 1.0.0__tar.gz

dashaflow-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,32 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install -e ".[test]" || pip install -e .
+      - run: pip install pytest
+      - run: pytest tests/ -q
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

dashaflow-1.0.0/.gitignore

@@ -0,0 +1,21 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+*.so
+*.whl
+.pytest_cache/
+.tox/
+.venv/
+venv/
+env/
+*.env
+.idea/
+.vscode/
+*.swp
+*.swo
+*~

dashaflow-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Adarsh J
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dashaflow-1.0.0/PKG-INFO

@@ -0,0 +1,173 @@
+Metadata-Version: 2.4
+Name: dashaflow
+Version: 1.0.0
+Summary: Vedic astrology calculation engine — Swiss Ephemeris with Sidereal Lahiri ayanamsha
+Project-URL: Homepage, https://github.com/adarshj322/dashaflow
+Project-URL: Repository, https://github.com/adarshj322/dashaflow
+Project-URL: Issues, https://github.com/adarshj322/dashaflow/issues
+Author: Adarsh J
+License-Expression: MIT
+License-File: LICENSE
+Keywords: astrology,dashaflow,horoscope,jyotish,navamsha,vedic,vimshottari
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Religion
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Requires-Python: >=3.10
+Requires-Dist: pyswisseph>=2.10.3
+Requires-Dist: pytz>=2024.1
+Description-Content-Type: text/markdown
+
+# DashaFlow
+
+A Vedic astrology calculation engine for Python, built on the **Swiss Ephemeris** with **Sidereal Lahiri** ayanamsha. Rooted in *Brihat Parashara Hora Shastra* (BPHS) and B.V. Raman's *Hindu Predictive Astrology*.
+
+```bash
+pip install dashaflow
+```
+
+## Quick Start
+
+```python
+import dashaflow
+
+# Cast a natal chart
+chart = dashaflow.cast_chart("1990-04-15", "14:30", 28.6139, 77.2090, "Asia/Kolkata")
+
+print(chart["lagna"]["sign"])              # "Leo"
+print(chart["planets"]["Moon"]["nakshatra"])  # "Ashwini"
+print(chart["planets"]["Jupiter"]["dignity"]) # "exalted"
+print(chart["dashas"]["maha"]["planet"])      # Current Mahadasha lord
+print(chart["yogas"])                         # Detected yogas
+
+# Transits
+transit = dashaflow.cast_transit("2026-03-29", chart)
+print(transit["sade_sati"])
+
+# Compatibility (Person 1 = Male, Person 2 = Female)
+compat = dashaflow.calculate_compatibility(
+    "1990-04-15", "14:30", 28.61, 77.21, "Asia/Kolkata",
+    "1992-08-20", "09:15", 19.07, 72.87, "Asia/Kolkata",
+)
+print(f"Score: {compat['total']}/36")
+
+# Muhurtha (electional astrology)
+muhurtha = dashaflow.check_muhurtha("marriage", "2026-11-15", "10:30", 28.61, 77.21, "Asia/Kolkata")
+print(muhurtha["verdict"])  # "auspicious" / "mixed" / "inauspicious"
+
+# Career analysis
+career = dashaflow.analyze_career("1990-04-15", "14:30", 28.61, 77.21, "Asia/Kolkata")
+print(career["career_themes"])
+```
+
+## API
+
+### Top-Level Functions
+
+| Function | Description |
+|---|---|
+| `cast_chart(dob, time, lat, lon, timezone, query_date=None, ephe_path='')` | Complete natal chart — planets, dashas, yogas, ashtakavarga, shadbala, vargas, and more |
+| `cast_transit(transit_date, natal_chart, timezone="Asia/Kolkata")` | Planetary transits overlaid on natal chart with SAV points, Sade Sati, Rahu-Ketu axis |
+| `calculate_compatibility(dob1, time1, lat1, lon1, tz1, dob2, time2, lat2, lon2, tz2)` | 36-point Ashtakoot + extended kutas + Kuja Dosha |
+| `check_muhurtha(activity, date, time, lat, lon, timezone)` | Electional astrology for 6 activity types |
+| `analyze_career(dob, time, lat, lon, timezone)` | D10 Dashamsha career analysis with theme recommendations |
+
+### Sub-Module Access
+
+```python
+from dashaflow.dasha import calculate_dashas
+from dashaflow.matchmaking import calculate_ashtakoot
+from dashaflow.shadbala import calculate_shadbala
+from dashaflow.jaimini import calculate_jaimini_karakas, calculate_arudha_padas
+from dashaflow.yoga import detect_yogas, detect_kaal_sarpa
+from dashaflow.ashtakavarga import calculate_ashtakavarga
+```
+
+### `cast_chart()` Returns
+
+| Key | Description |
+|---|---|
+| `metadata` | DOB, time, coordinates, ayanamsha (Lahiri), query date |
+| `panchang` | Tithi, Vara, Nakshatra, Yoga, Karana |
+| `lagna` | Ascendant sign, degree, nakshatra, pada, D2–D60 signs |
+| `planets` | Per planet: sign, degree, house, nakshatra, pada, dignity, combustion, retrograde, digbala, aspects, 14 varga signs |
+| `dashas` | 5 levels: Maha, Antar, Pratyantar, Sukshma, Prana + 120-year timeline |
+| `yogas` | 24 types detected with forming planets and descriptions |
+| `ashtakavarga` | SAV, BAV, Prashtara (source-level bindus) |
+| `jaimini_karakas` | 7 Karakas by degree (Atmakaraka through Darakaraka) |
+| `shadbala` | Six-fold strength in Rupas + percentage + Ishta/Kashta Phala |
+| `bhava_chalit` | Equal-house Bhava Chalit with planet placements per bhava |
+| `avasthas` | Planetary age-states: Bala, Kumara, Yuva, Vriddha, Mrita |
+| `kaal_sarpa` | Kaal Sarpa Dosha detection (full/partial, ascending/descending) |
+| `graha_yuddha` | Planetary war — pairs within 1° with winner/loser |
+| `gandanta` | Planets at water-fire sign boundaries (karmic knots) |
+| `arudha_padas` | All 12 Arudha Padas (A1–A12) with BPHS exception rule |
+| `upapada` | Upapada Lagna (A12) with lord and 2nd from UL |
+| `karakamsha` | AK in Navamsha, Ishta Devata, planets in Karakamsha |
+
+## Features
+
+- **Natal Chart** — Lagna, 9 grahas, whole-sign houses, nakshatras with padas, dignities
+- **14 Divisional Charts** — D2, D3, D4, D7, D9, D10, D12, D16, D20, D24, D27, D30, D40, D60
+- **Planetary Strength** — Dignity (B.V. Raman), combustion (BPHS orbs), Digbala, Shadbala (6-fold), Ishta/Kashta Phala
+- **BPHS Aspects** — 7th for all, special aspects for Mars (4th/8th), Jupiter (5th/9th), Saturn (3rd/10th)
+- **Vimshottari Dasha** — 5 levels (Maha → Antar → Pratyantar → Sukshma → Prana), 120-year timeline
+- **24 Yoga Types** — Pancha Mahapurusha, Gajakesari, Budhaditya, Raj Yoga, Neecha Bhanga, Parivartana, Dhana, and more
+- **Ashtakavarga** — SAV, BAV, Prashtara (source-level bindu contributions)
+- **Jaimini** — 7 Karakas, Arudha Padas (A1–A12), Upapada Lagna, Karakamsha
+- **Compatibility** — 8 Ashtakoot kutas (36 pts) + Mahendra, Stree Deergha, Vedha, Rajju, Kuja Dosha
+- **Muhurtha** — 6 activity types with Panchang Suddhi and marriage doshas
+- **Career** — D10 analysis with planet-career significations and domain recommendations
+- **Bhava Chalit** — Equal-house chart from Lagna midpoint
+- **Avasthas** — 5 planetary age-states per BPHS
+- **Kaal Sarpa, Graha Yuddha, Gandanta** — Dosha and junction detection
+
+## Architecture
+
+```
+dashaflow/
+├── __init__.py         Public API (5 functions)
+├── vedic_calculator.py Core engine — Swiss Ephemeris computations
+├── constants.py        Zodiac, nakshatras, dignity tables
+├── nakshatra.py        Nakshatra lookup from longitude
+├── panchang.py         Tithi, Vara, Yoga, Karana
+├── yoga.py             24 yoga types + Kaal Sarpa, Graha Yuddha, Gandanta
+├── dasha.py            Vimshottari Dasha (5 levels)
+├── dignity.py          Dignity, combustion, digbala
+├── ashtakavarga.py     SAV, BAV, Prashtara
+├── jaimini.py          Karakas, Arudha Padas, Upapada, Karakamsha
+├── shadbala.py         Six-fold strength + Ishta/Kashta Phala
+├── matchmaking.py      16-factor compatibility + Kuja Dosha
+├── muhurtha.py         Electional astrology
+└── career.py           D10 career analysis
+```
+
+## Ayanamsha
+
+All calculations use **Lahiri (Chitrapaksha)** — the official standard of the Indian government and the most widely used system in Vedic astrology.
+
+## Extended Ephemeris
+
+The bundled Swiss Ephemeris files cover ~1800–2400 AD. For historical or far-future charts, download additional `.se1` files from [astro.com](https://www.astro.com/swisseph/) and pass the path:
+
+```python
+chart = dashaflow.cast_chart("1200-03-10", "12:00", 28.61, 77.21, "Asia/Kolkata",
+                              ephe_path="/path/to/extended/ephemeris")
+```
+
+## References
+
+- *Brihat Parashara Hora Shastra* — foundational text for Vedic astrology
+- *Hindu Predictive Astrology* — B.V. Raman
+- [Swiss Ephemeris](https://www.astro.com/swisseph/) — high-precision astronomical computation
+
+## License
+
+MIT
+

dashaflow-1.0.0/README.md

@@ -0,0 +1,147 @@
+# DashaFlow
+
+A Vedic astrology calculation engine for Python, built on the **Swiss Ephemeris** with **Sidereal Lahiri** ayanamsha. Rooted in *Brihat Parashara Hora Shastra* (BPHS) and B.V. Raman's *Hindu Predictive Astrology*.
+
+```bash
+pip install dashaflow
+```
+
+## Quick Start
+
+```python
+import dashaflow
+
+# Cast a natal chart
+chart = dashaflow.cast_chart("1990-04-15", "14:30", 28.6139, 77.2090, "Asia/Kolkata")
+
+print(chart["lagna"]["sign"])              # "Leo"
+print(chart["planets"]["Moon"]["nakshatra"])  # "Ashwini"
+print(chart["planets"]["Jupiter"]["dignity"]) # "exalted"
+print(chart["dashas"]["maha"]["planet"])      # Current Mahadasha lord
+print(chart["yogas"])                         # Detected yogas
+
+# Transits
+transit = dashaflow.cast_transit("2026-03-29", chart)
+print(transit["sade_sati"])
+
+# Compatibility (Person 1 = Male, Person 2 = Female)
+compat = dashaflow.calculate_compatibility(
+    "1990-04-15", "14:30", 28.61, 77.21, "Asia/Kolkata",
+    "1992-08-20", "09:15", 19.07, 72.87, "Asia/Kolkata",
+)
+print(f"Score: {compat['total']}/36")
+
+# Muhurtha (electional astrology)
+muhurtha = dashaflow.check_muhurtha("marriage", "2026-11-15", "10:30", 28.61, 77.21, "Asia/Kolkata")
+print(muhurtha["verdict"])  # "auspicious" / "mixed" / "inauspicious"
+
+# Career analysis
+career = dashaflow.analyze_career("1990-04-15", "14:30", 28.61, 77.21, "Asia/Kolkata")
+print(career["career_themes"])
+```
+
+## API
+
+### Top-Level Functions
+
+| Function | Description |
+|---|---|
+| `cast_chart(dob, time, lat, lon, timezone, query_date=None, ephe_path='')` | Complete natal chart — planets, dashas, yogas, ashtakavarga, shadbala, vargas, and more |
+| `cast_transit(transit_date, natal_chart, timezone="Asia/Kolkata")` | Planetary transits overlaid on natal chart with SAV points, Sade Sati, Rahu-Ketu axis |
+| `calculate_compatibility(dob1, time1, lat1, lon1, tz1, dob2, time2, lat2, lon2, tz2)` | 36-point Ashtakoot + extended kutas + Kuja Dosha |
+| `check_muhurtha(activity, date, time, lat, lon, timezone)` | Electional astrology for 6 activity types |
+| `analyze_career(dob, time, lat, lon, timezone)` | D10 Dashamsha career analysis with theme recommendations |
+
+### Sub-Module Access
+
+```python
+from dashaflow.dasha import calculate_dashas
+from dashaflow.matchmaking import calculate_ashtakoot
+from dashaflow.shadbala import calculate_shadbala
+from dashaflow.jaimini import calculate_jaimini_karakas, calculate_arudha_padas
+from dashaflow.yoga import detect_yogas, detect_kaal_sarpa
+from dashaflow.ashtakavarga import calculate_ashtakavarga
+```
+
+### `cast_chart()` Returns
+
+| Key | Description |
+|---|---|
+| `metadata` | DOB, time, coordinates, ayanamsha (Lahiri), query date |
+| `panchang` | Tithi, Vara, Nakshatra, Yoga, Karana |
+| `lagna` | Ascendant sign, degree, nakshatra, pada, D2–D60 signs |
+| `planets` | Per planet: sign, degree, house, nakshatra, pada, dignity, combustion, retrograde, digbala, aspects, 14 varga signs |
+| `dashas` | 5 levels: Maha, Antar, Pratyantar, Sukshma, Prana + 120-year timeline |
+| `yogas` | 24 types detected with forming planets and descriptions |
+| `ashtakavarga` | SAV, BAV, Prashtara (source-level bindus) |
+| `jaimini_karakas` | 7 Karakas by degree (Atmakaraka through Darakaraka) |
+| `shadbala` | Six-fold strength in Rupas + percentage + Ishta/Kashta Phala |
+| `bhava_chalit` | Equal-house Bhava Chalit with planet placements per bhava |
+| `avasthas` | Planetary age-states: Bala, Kumara, Yuva, Vriddha, Mrita |
+| `kaal_sarpa` | Kaal Sarpa Dosha detection (full/partial, ascending/descending) |
+| `graha_yuddha` | Planetary war — pairs within 1° with winner/loser |
+| `gandanta` | Planets at water-fire sign boundaries (karmic knots) |
+| `arudha_padas` | All 12 Arudha Padas (A1–A12) with BPHS exception rule |
+| `upapada` | Upapada Lagna (A12) with lord and 2nd from UL |
+| `karakamsha` | AK in Navamsha, Ishta Devata, planets in Karakamsha |
+
+## Features
+
+- **Natal Chart** — Lagna, 9 grahas, whole-sign houses, nakshatras with padas, dignities
+- **14 Divisional Charts** — D2, D3, D4, D7, D9, D10, D12, D16, D20, D24, D27, D30, D40, D60
+- **Planetary Strength** — Dignity (B.V. Raman), combustion (BPHS orbs), Digbala, Shadbala (6-fold), Ishta/Kashta Phala
+- **BPHS Aspects** — 7th for all, special aspects for Mars (4th/8th), Jupiter (5th/9th), Saturn (3rd/10th)
+- **Vimshottari Dasha** — 5 levels (Maha → Antar → Pratyantar → Sukshma → Prana), 120-year timeline
+- **24 Yoga Types** — Pancha Mahapurusha, Gajakesari, Budhaditya, Raj Yoga, Neecha Bhanga, Parivartana, Dhana, and more
+- **Ashtakavarga** — SAV, BAV, Prashtara (source-level bindu contributions)
+- **Jaimini** — 7 Karakas, Arudha Padas (A1–A12), Upapada Lagna, Karakamsha
+- **Compatibility** — 8 Ashtakoot kutas (36 pts) + Mahendra, Stree Deergha, Vedha, Rajju, Kuja Dosha
+- **Muhurtha** — 6 activity types with Panchang Suddhi and marriage doshas
+- **Career** — D10 analysis with planet-career significations and domain recommendations
+- **Bhava Chalit** — Equal-house chart from Lagna midpoint
+- **Avasthas** — 5 planetary age-states per BPHS
+- **Kaal Sarpa, Graha Yuddha, Gandanta** — Dosha and junction detection
+
+## Architecture
+
+```
+dashaflow/
+├── __init__.py         Public API (5 functions)
+├── vedic_calculator.py Core engine — Swiss Ephemeris computations
+├── constants.py        Zodiac, nakshatras, dignity tables
+├── nakshatra.py        Nakshatra lookup from longitude
+├── panchang.py         Tithi, Vara, Yoga, Karana
+├── yoga.py             24 yoga types + Kaal Sarpa, Graha Yuddha, Gandanta
+├── dasha.py            Vimshottari Dasha (5 levels)
+├── dignity.py          Dignity, combustion, digbala
+├── ashtakavarga.py     SAV, BAV, Prashtara
+├── jaimini.py          Karakas, Arudha Padas, Upapada, Karakamsha
+├── shadbala.py         Six-fold strength + Ishta/Kashta Phala
+├── matchmaking.py      16-factor compatibility + Kuja Dosha
+├── muhurtha.py         Electional astrology
+└── career.py           D10 career analysis
+```
+
+## Ayanamsha
+
+All calculations use **Lahiri (Chitrapaksha)** — the official standard of the Indian government and the most widely used system in Vedic astrology.
+
+## Extended Ephemeris
+
+The bundled Swiss Ephemeris files cover ~1800–2400 AD. For historical or far-future charts, download additional `.se1` files from [astro.com](https://www.astro.com/swisseph/) and pass the path:
+
+```python
+chart = dashaflow.cast_chart("1200-03-10", "12:00", 28.61, 77.21, "Asia/Kolkata",
+                              ephe_path="/path/to/extended/ephemeris")
+```
+
+## References
+
+- *Brihat Parashara Hora Shastra* — foundational text for Vedic astrology
+- *Hindu Predictive Astrology* — B.V. Raman
+- [Swiss Ephemeris](https://www.astro.com/swisseph/) — high-precision astronomical computation
+
+## License
+
+MIT
+

dashaflow-1.0.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "dashaflow"
+dynamic = ["version"]
+description = "Vedic astrology calculation engine — Swiss Ephemeris with Sidereal Lahiri ayanamsha"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Adarsh J" },
+]
+keywords = ["vedic", "astrology", "jyotish", "horoscope", "dashaflow", "vimshottari", "navamsha"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Astronomy",
+    "Topic :: Religion",
+]
+dependencies = [
+    "pyswisseph>=2.10.3",
+    "pytz>=2024.1",
+]
+
+[project.urls]
+Homepage = "https://github.com/adarshj322/dashaflow"
+Repository = "https://github.com/adarshj322/dashaflow"
+Issues = "https://github.com/adarshj322/dashaflow/issues"
+
+[tool.hatch.version]
+path = "src/dashaflow/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dashaflow"]

dashaflow-1.0.0/src/dashaflow/__init__.py

@@ -0,0 +1,241 @@
+"""
+DashaFlow — Vedic Astrology Calculation Engine
+===============================================
+
+Swiss Ephemeris with Sidereal Lahiri ayanamsha.
+Rooted in Brihat Parashara Hora Shastra (BPHS) and B.V. Raman's Hindu Predictive Astrology.
+
+Quick start::
+
+    import dashaflow
+
+    chart = dashaflow.cast_chart("1990-04-15", "14:30", 28.6139, 77.2090, "Asia/Kolkata")
+    print(chart["lagna"]["sign"])       # e.g. "Leo"
+    print(chart["planets"]["Moon"])      # full Moon data
+    print(chart["yogas"])               # detected yogas
+"""
+
+from ._version import __version__
+from ._validation import validate_birth_input
+from .vedic_calculator import calculate_vedic_chart, calculate_transit
+from .matchmaking import calculate_ashtakoot, calc_kuja_dosha, match_kuja_dosha
+from .muhurtha import evaluate_muhurtha, ACTIVITY_RULES
+from .career import analyze_career as _analyze_career_internal
+from .constants import ZODIAC_SIGNS
+
+__all__ = [
+    "__version__",
+    "cast_chart",
+    "cast_transit",
+    "calculate_compatibility",
+    "check_muhurtha",
+    "analyze_career",
+]
+
+
+def cast_chart(
+    dob: str,
+    time: str,
+    lat: float,
+    lon: float,
+    timezone: str,
+    query_date: str = None,
+    ephe_path: str = '',
+) -> dict:
+    """
+    Cast a complete Vedic natal chart (Sidereal Lahiri ayanamsha).
+
+    Returns a dict with: metadata, panchang, lagna, planets (with dignity,
+    combustion, aspects, 14 varga signs), dashas (5 levels), yogas (24 types),
+    ashtakavarga, jaimini_karakas, shadbala, bhava_chalit, avasthas,
+    kaal_sarpa, graha_yuddha, gandanta, arudha_padas, upapada, karakamsha.
+
+    Parameters
+    ----------
+    dob : str
+        Date of birth as "YYYY-MM-DD"
+    time : str
+        Time of birth as "HH:MM" (24-hour)
+    lat : float
+        Birth latitude (-90 to 90)
+    lon : float
+        Birth longitude (-180 to 180)
+    timezone : str
+        IANA timezone (e.g. "Asia/Kolkata")
+    query_date : str, optional
+        Date for Dasha lookup as "YYYY-MM-DD". Defaults to today.
+    ephe_path : str, optional
+        Path to Swiss Ephemeris data files. Defaults to '' (bundled).
+
+    Returns
+    -------
+    dict
+        Complete chart data.
+
+    Raises
+    ------
+    ValueError
+        If any input parameter is invalid.
+    """
+    validate_birth_input(dob, time, lat, lon, timezone)
+    return calculate_vedic_chart(
+        dob_str=dob,
+        time_str=time,
+        lat=lat,
+        lon=lon,
+        timezone_str=timezone,
+        query_date_str=query_date,
+        ephe_path=ephe_path,
+    )
+
+
+def cast_transit(
+    transit_date: str,
+    natal_chart: dict,
+    timezone: str = "Asia/Kolkata",
+) -> dict:
+    """
+    Calculate planetary transits overlaid on a natal chart.
+
+    Parameters
+    ----------
+    transit_date : str
+        Date to compute transits as "YYYY-MM-DD"
+    natal_chart : dict
+        Full dict output from cast_chart()
+    timezone : str, optional
+        IANA timezone. Defaults to "Asia/Kolkata".
+
+    Returns
+    -------
+    dict
+        Transit planets with house positions, SAV points, Sade Sati, Rahu-Ketu axis.
+    """
+    return calculate_transit(
+        transit_date_str=transit_date,
+        natal_chart=natal_chart,
+        timezone_str=timezone,
+    )
+
+
+def calculate_compatibility(
+    dob1: str, time1: str, lat1: float, lon1: float, tz1: str,
+    dob2: str, time2: str, lat2: float, lon2: float, tz2: str,
+) -> dict:
+    """
+    Calculate 36-point Ashtakoot compatibility + Kuja Dosha.
+
+    Person 1 = Male, Person 2 = Female (by tradition for accurate scoring).
+
+    Parameters
+    ----------
+    dob1, time1, lat1, lon1, tz1 : Birth details for Person 1 (Male)
+    dob2, time2, lat2, lon2, tz2 : Birth details for Person 2 (Female)
+
+    Returns
+    -------
+    dict
+        8 Ashtakoot kutas (36 pts), extended kutas (Mahendra, Stree Deergha,
+        Vedha, Rajju, etc.), Kuja Dosha analysis with compatibility verdict.
+    """
+    validate_birth_input(dob1, time1, lat1, lon1, tz1)
+    validate_birth_input(dob2, time2, lat2, lon2, tz2)
+
+    chart1 = calculate_vedic_chart(dob1, time1, lat1, lon1, tz1)
+    chart2 = calculate_vedic_chart(dob2, time2, lat2, lon2, tz2)
+
+    m_moon = chart1["planets"]["Moon"]
+    f_moon = chart2["planets"]["Moon"]
+
+    m_lon = ZODIAC_SIGNS.index(m_moon["sign"]) * 30 + m_moon["degree"]
+    f_lon = ZODIAC_SIGNS.index(f_moon["sign"]) * 30 + f_moon["degree"]
+
+    score = calculate_ashtakoot(m_lon, f_lon, male_chart=chart1, female_chart=chart2)
+
+    male_dosha = calc_kuja_dosha(chart1)
+    female_dosha = calc_kuja_dosha(chart2)
+    kuja_match = match_kuja_dosha(male_dosha["total_score"], female_dosha["total_score"])
+    score["kuja_dosha"] = {
+        "male": male_dosha,
+        "female": female_dosha,
+        "compatibility": kuja_match,
+    }
+
+    return score
+
+
+def check_muhurtha(
+    activity: str,
+    date: str,
+    time: str,
+    lat: float,
+    lon: float,
+    timezone: str,
+) -> dict:
+    """
+    Check if a date/time is auspicious for a specific activity.
+
+    Parameters
+    ----------
+    activity : str
+        One of: 'marriage', 'travel', 'business', 'education', 'house_entry', 'medical'
+    date : str
+        Date as "YYYY-MM-DD"
+    time : str
+        Time as "HH:MM" (24-hour)
+    lat : float
+        Location latitude
+    lon : float
+        Location longitude
+    timezone : str
+        IANA timezone string
+
+    Returns
+    -------
+    dict
+        Verdict (auspicious/mixed/inauspicious), score, factors, panchang_suddhi.
+    """
+    validate_birth_input(date, time, lat, lon, timezone)
+    if activity not in ACTIVITY_RULES:
+        raise ValueError(f"Unknown activity '{activity}'. Supported: {list(ACTIVITY_RULES.keys())}")
+
+    chart = calculate_vedic_chart(date, time, lat, lon, timezone)
+    panchang = chart.get("panchang", {})
+    planets = chart.get("planets", {})
+    lagna_sign = chart.get("lagna", {}).get("sign")
+    return evaluate_muhurtha(activity, panchang, planets, lagna_sign)
+
+
+def analyze_career(
+    dob: str,
+    time: str,
+    lat: float,
+    lon: float,
+    timezone: str,
+) -> dict:
+    """
+    Analyze career potential using the 10th house, D10 Dashamsha, and planetary significations.
+
+    Parameters
+    ----------
+    dob : str
+        Date of birth as "YYYY-MM-DD"
+    time : str
+        Time of birth as "HH:MM" (24-hour)
+    lat : float
+        Birth latitude
+    lon : float
+        Birth longitude
+    timezone : str
+        IANA timezone string
+
+    Returns
+    -------
+    dict
+        10th house analysis, D10 indicators, career themes, strength factors.
+    """
+    validate_birth_input(dob, time, lat, lon, timezone)
+    chart = calculate_vedic_chart(dob, time, lat, lon, timezone)
+    planets = chart.get("planets", {})
+    lagna_sign = chart.get("lagna", {}).get("sign")
+    return _analyze_career_internal(planets, lagna_sign)