garhwali 1.0.0__tar.gz

garhwali-1.0.0/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: garhwali
+Version: 1.0.0
+Summary: Garhwali (गढ़वाली) Language Library: 300k+ words, NLP toolkit, multi-dialect translation and Himalayan lore
+Home-page: https://github.com/infoakshatsinghbisht-eng/garhwali-language-library
+Author: Akshat Singh Bisht
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Dynamic: home-page
+Dynamic: requires-python
+
+# 🏔️ Garhwali (गढ़वाली) Language Library
+
+A comprehensive Python library, NLP toolkit, and cultural heritage engine for the **Garhwali Language (गढ़वाली भाषा)** — spoken by over 3 million people across Uttarakhand's Garhwal Himalayas (Pauri, Chamoli, Tehri, Uttarkashi, Rudraprayag, Dehradun, and Haridwar).
+
+---
+
+## 🌟 Key Features
+
+1. **📚 300,000+ Inflected Word Forms**:
+   - High-performance morphological engine covering noun declensions, pronoun cases, verb tenses/aspects, and postpositional compounds.
+2. **🔄 Multi-Strategy Translator**:
+   - Fast, accurate translation across **English $\leftrightarrow$ Garhwali**, **Hindi $\leftrightarrow$ Garhwali**, and **Hinglish $\leftrightarrow$ Garhwali**.
+3. **🏔️ Dialect Support**:
+   - **Srinagariya** (Standard Pauri Garhwal)
+   - **Rathwali / Tehri** (Tehri Garhwal)
+   - **Salani** (Southern Pauri / Kotdwar)
+   - **Badhani** (Chamoli / Alaknanda Valley)
+4. **🗣️ Phonetics & Syllable Engine**:
+   - Native syllabification, Devanagari $\leftrightarrow$ Romanized phonetic transliteration.
+5. **📜 Himalayan Lore & Culture**:
+   - Proverbs (*अखाण / पखाण*), Interactive Riddles (*आणा*), 12 Garhwali Months & 6 Ritus, Festivals (*Phooldei, Igas Bagwal, Nanda Devi Raj Jat*), and classic folk literature (*Chaita ki Chaitwali, Bedu Pako*).
+6. **🔢 Garhwali Numbers**:
+   - Converts any integer into Garhwali words, ordinals, and Devanagari numerals.
+7. **🎙️ Voice Synthesis SSML & Audio**:
+   - Himalayan pitch envelope generator, SSML formatter, and uncompressed PCM WAV synthesis.
+
+---
+
+## 🚀 Installation & Usage
+
+```bash
+pip install garhwali
+```
+
+### Quick Python Example
+
+```python
+import garhwali
+
+# 1. Translate English or Hinglish to Garhwali
+res = garhwali.translate("Where is mom?")
+print(res.text)  # "ईजा कहाँ छ?"
+
+res_hinglish = garhwali.translate("are yah chal kyon nahin raha hai")
+print(res_hinglish.text)  # "अरे यो किलै नि चलनो छ?"
+
+# 2. Dialect variations
+print(garhwali.translate("What is your name?", dialect="rathwali").text)  # "तमरो नाव क्या छ?"
+print(garhwali.translate("What is your name?", dialect="salani").text)    # "तुमारू नाव क्या छ?"
+
+# 3. Numbers to Garhwali words
+print(garhwali.num_to_words(2026))  # "दुई हजार छब्बीस"
+print(garhwali.to_devanagari_numerals(2026))  # "२०२६"
+
+# 4. Phonetics & Syllables
+print(garhwali.syllables("गढ़वाली"))  # ['गढ़', 'वा', 'ली']
+print(garhwali.devanagari_to_latin("ईजा कहाँ छ?"))  # "Ija kahaan chha?"
+
+# 5. Culture & Calendar
+print(garhwali.get_current_season())  # {'name_garhwali': 'सरद', 'english': 'Autumn'}
+print(garhwali.proverbs.all()[0]["garhwali"])  # "अपणी घाम मा कुकुर भी राजा।"
+```
+
+---
+
+## 🧪 Testing
+
+```bash
+python -m unittest discover tests
+```
+
+---
+
+## 📄 License
+MIT License. Open-source for the preservation and advancement of Himalayan languages.

garhwali-1.0.0/README.md

@@ -0,0 +1,75 @@
+# 🏔️ Garhwali (गढ़वाली) Language Library
+
+A comprehensive Python library, NLP toolkit, and cultural heritage engine for the **Garhwali Language (गढ़वाली भाषा)** — spoken by over 3 million people across Uttarakhand's Garhwal Himalayas (Pauri, Chamoli, Tehri, Uttarkashi, Rudraprayag, Dehradun, and Haridwar).
+
+---
+
+## 🌟 Key Features
+
+1. **📚 300,000+ Inflected Word Forms**:
+   - High-performance morphological engine covering noun declensions, pronoun cases, verb tenses/aspects, and postpositional compounds.
+2. **🔄 Multi-Strategy Translator**:
+   - Fast, accurate translation across **English $\leftrightarrow$ Garhwali**, **Hindi $\leftrightarrow$ Garhwali**, and **Hinglish $\leftrightarrow$ Garhwali**.
+3. **🏔️ Dialect Support**:
+   - **Srinagariya** (Standard Pauri Garhwal)
+   - **Rathwali / Tehri** (Tehri Garhwal)
+   - **Salani** (Southern Pauri / Kotdwar)
+   - **Badhani** (Chamoli / Alaknanda Valley)
+4. **🗣️ Phonetics & Syllable Engine**:
+   - Native syllabification, Devanagari $\leftrightarrow$ Romanized phonetic transliteration.
+5. **📜 Himalayan Lore & Culture**:
+   - Proverbs (*अखाण / पखाण*), Interactive Riddles (*आणा*), 12 Garhwali Months & 6 Ritus, Festivals (*Phooldei, Igas Bagwal, Nanda Devi Raj Jat*), and classic folk literature (*Chaita ki Chaitwali, Bedu Pako*).
+6. **🔢 Garhwali Numbers**:
+   - Converts any integer into Garhwali words, ordinals, and Devanagari numerals.
+7. **🎙️ Voice Synthesis SSML & Audio**:
+   - Himalayan pitch envelope generator, SSML formatter, and uncompressed PCM WAV synthesis.
+
+---
+
+## 🚀 Installation & Usage
+
+```bash
+pip install garhwali
+```
+
+### Quick Python Example
+
+```python
+import garhwali
+
+# 1. Translate English or Hinglish to Garhwali
+res = garhwali.translate("Where is mom?")
+print(res.text)  # "ईजा कहाँ छ?"
+
+res_hinglish = garhwali.translate("are yah chal kyon nahin raha hai")
+print(res_hinglish.text)  # "अरे यो किलै नि चलनो छ?"
+
+# 2. Dialect variations
+print(garhwali.translate("What is your name?", dialect="rathwali").text)  # "तमरो नाव क्या छ?"
+print(garhwali.translate("What is your name?", dialect="salani").text)    # "तुमारू नाव क्या छ?"
+
+# 3. Numbers to Garhwali words
+print(garhwali.num_to_words(2026))  # "दुई हजार छब्बीस"
+print(garhwali.to_devanagari_numerals(2026))  # "२०२६"
+
+# 4. Phonetics & Syllables
+print(garhwali.syllables("गढ़वाली"))  # ['गढ़', 'वा', 'ली']
+print(garhwali.devanagari_to_latin("ईजा कहाँ छ?"))  # "Ija kahaan chha?"
+
+# 5. Culture & Calendar
+print(garhwali.get_current_season())  # {'name_garhwali': 'सरद', 'english': 'Autumn'}
+print(garhwali.proverbs.all()[0]["garhwali"])  # "अपणी घाम मा कुकुर भी राजा।"
+```
+
+---
+
+## 🧪 Testing
+
+```bash
+python -m unittest discover tests
+```
+
+---
+
+## 📄 License
+MIT License. Open-source for the preservation and advancement of Himalayan languages.

garhwali-1.0.0/garhwali/__init__.py

@@ -0,0 +1,60 @@
+# -*- coding: utf-8 -*-
+"""
+Garhwali (गढ़वाली) Language Library.
+Comprehensive NLP and Cultural Heritage toolkit for the Garhwali Language:
+- 300,000+ Inflected Word Forms
+- Multi-dialect Translation (Srinagariya, Rathwali, Tehri, Salani, Badhani)
+- Phonetics & Syllabification
+- Case Declensions & Verb Conjugations
+- Himalayan Calendar, Proverbs (अखाण/पखाण), Riddles (आणा), Literature
+- Voice Synthesis & SSML
+"""
+
+__version__ = "1.0.0"
+__author__ = "Akshat Singh Bisht"
+
+from .translator.engine import translate, TranslationResult
+from .lexicon.dictionary import GarhwaliDictionary
+from .lexicon.morphology import get_morphology_engine, MorphAnalysis
+from .phonetics import devanagari_to_latin, latin_to_devanagari, syllables
+from .numbers.converter import num_to_words, to_devanagari_numerals, ordinal
+from .culture.calendar import GARHWALI_MONTHS, GARHWALI_RITUS, get_current_season
+from .culture.festivals import list_festivals
+from .culture.literature import poems, epics, authors
+from .voice.engine import GarhwaliVoiceSynthesizer
+
+# Global instances for simple top-level access
+_DICT = GarhwaliDictionary()
+phrases = type("Phrases", (), {"all": _DICT.all_phrases, "random": _DICT.random_phrase})()
+proverbs = type("Proverbs", (), {"all": _DICT.all_proverbs, "random": _DICT.random_proverb})()
+riddles = type("Riddles", (), {"all": _DICT.all_riddles, "random": _DICT.random_riddle})()
+
+def lookup(word: str):
+    return _DICT.lookup(word)
+
+def search(query: str):
+    return _DICT.search(query)
+
+def analyze(word: str):
+    engine = get_morphology_engine()
+    return engine.analyze(word)
+
+def total_word_forms() -> int:
+    return get_morphology_engine().total_forms_count()
+
+def get_months():
+    return GARHWALI_MONTHS
+
+def get_seasons():
+    return GARHWALI_RITUS
+
+__all__ = [
+    "translate", "TranslationResult",
+    "lookup", "search", "analyze", "total_word_forms",
+    "syllables", "devanagari_to_latin", "latin_to_devanagari",
+    "num_to_words", "to_devanagari_numerals", "ordinal",
+    "get_months", "get_seasons", "get_current_season",
+    "list_festivals", "poems", "epics", "authors",
+    "phrases", "proverbs", "riddles",
+    "GarhwaliVoiceSynthesizer"
+]

garhwali-1.0.0/garhwali/cli.py

@@ -0,0 +1,75 @@
+# -*- coding: utf-8 -*-
+r"""Garhwali CLI tool with UTF-8 support on all platforms."""
+
+import sys
+import argparse
+from pathlib import Path
+
+# Ensure UTF-8 output on Windows consoles
+if hasattr(sys.stdout, "reconfigure"):
+    try:
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+    except Exception:
+        pass
+
+import garhwali
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="garhwali",
+        description="Garhwali (गढ़वाली) Language Library & Multi-Dialect Tool"
+    )
+    subparsers = parser.add_subparsers(dest="command", help="Available commands")
+
+    # translate
+    t_parser = subparsers.add_parser("translate", help="Translate English/Hindi/Hinglish to Garhwali")
+    t_parser.add_argument("text", type=str, help="Text to translate")
+    t_parser.add_argument("--dialect", "-d", type=str, default="srinagariya",
+                          choices=["srinagariya", "rathwali", "tehri", "salani", "badhani"],
+                          help="Garhwali dialect variant")
+
+    # lookup
+    l_parser = subparsers.add_parser("lookup", help="Look up a Garhwali word")
+    l_parser.add_argument("word", type=str, help="Word to look up")
+
+    # num
+    n_parser = subparsers.add_parser("num", help="Convert numbers to Garhwali words")
+    n_parser.add_argument("value", type=int, help="Integer value")
+
+    # culture
+    c_parser = subparsers.add_parser("culture", help="Explore Garhwali culture, proverbs, and calendar")
+
+    args = parser.parse_args()
+
+    if args.command == "translate":
+        res = garhwali.translate(args.text, dialect=args.dialect)
+        print(f"\nGarhwali [{res.dialect}]: {res.text}")
+        print(f"Confidence: {res.confidence * 100:.1f}% | Target: {res.target_lang}")
+    elif args.command == "lookup":
+        d = garhwali.lookup(args.word)
+        if d:
+            print(f"\nWord: {d.get('garhwali')}")
+            print(f"Hindi: {d.get('hindi')}")
+            print(f"English: {d.get('english')}")
+            print(f"POS: {d.get('pos')}")
+            if "dialect_variants" in d:
+                print(f"Dialects: {d['dialect_variants']}")
+        else:
+            print(f"Word '{args.word}' not found in dictionary.")
+    elif args.command == "num":
+        w = garhwali.num_to_words(args.value)
+        d = garhwali.to_devanagari_numerals(args.value)
+        print(f"\nNumber: {args.value} ({d})")
+        print(f"Garhwali words: {w}")
+    elif args.command == "culture":
+        s = garhwali.get_current_season()
+        print(f"\nCurrent Himalayan Ritu: {s.get('name_garhwali')} ({s.get('name_hindi')}) - {s.get('english_season')}")
+        print("\nRandom Garhwali Proverb (पखाणा):")
+        p = garhwali.proverbs.random()
+        print(f"  \"{p.get('pakhana')}\"")
+        print(f"  Meaning: {p.get('meaning')}")
+    else:
+        parser.print_help()
+
+if __name__ == "__main__":
+    main()

garhwali-1.0.0/garhwali/constants.py

@@ -0,0 +1,56 @@
+# -*- coding: utf-8 -*-
+"""Garhwali Language Constants and Phoneme Definitions."""
+
+GARHWALI_VOWELS = ["अ", "आ", "इ", "ई", "उ", "ऊ", "ऋ", "ए", "ऐ", "ओ", "औ", "अं", "अः"]
+GARHWALI_MATRAS = ["ा", "ि", "ी", "ु", "ू", "ृ", "े", "ै", "ो", "ौ", "ं", "ः", "ँ", "्"]
+
+GARHWALI_CONSONANTS = [
+    "क", "ख", "ग", "घ", "ङ",
+    "च", "छ", "ज", "झ", "ञ",
+    "ट", "ठ", "ड", "ढ", "ण",
+    "त", "थ", "द", "ध", "न",
+    "प", "फ", "ब", "भ", "म",
+    "य", "र", "ल", "व", "श", "ष", "स", "ह",
+    "क्ष", "त्र", "ज्ञ", "ड़", "ढ़"
+]
+
+GARHWALI_DIALECTS = {
+    "srinagariya": "Srinagariya (Standard Pauri Garhwal)",
+    "rathwali": "Rathwali (Eastern Pauri / Tehri border)",
+    "tehri": "Tehri / Gangapariya (Tehri Garhwal)",
+    "salani": "Salani (Southern Pauri / Kotdwar)",
+    "badhani": "Badhani / Chamoli (Chamoli / Alaknanda Valley)",
+    "jaunsari_border": "Jaunsari / Rawalti affinity (Uttarkashi border)"
+}
+
+DEVANAGARI_TO_LATIN_MAP = {
+    "अ": "a", "आ": "aa", "इ": "i", "ई": "ee", "उ": "u", "ऊ": "oo", "ऋ": "ri",
+    "ए": "e", "ऐ": "ai", "ओ": "o", "औ": "au", "अं": "an", "अः": "ah", "ँ": "n",
+    "क": "ka", "ख": "kha", "ग": "ga", "घ": "gha", "ङ": "nga",
+    "च": "cha", "छ": "chha", "ज": "ja", "झ": "jha", "ञ": "nya",
+    "ट": "ta", "ठ": "tha", "ड": "da", "ढ": "dha", "ण": "na",
+    "त": "ta", "थ": "tha", "द": "da", "ध": "dha", "न": "na",
+    "प": "pa", "फ": "pha", "ब": "ba", "भ": "bha", "म": "ma",
+    "य": "ya", "र": "ra", "ल": "la", "व": "va",
+    "श": "sha", "ष": "sha", "स": "sa", "ह": "ha",
+    "क्ष": "ksha", "त्र": "tra", "ज्ञ": "gya", "ड़": "ra", "ढ़": "rha",
+    "ा": "aa", "ि": "i", "ी": "ee", "ु": "u", "ू": "oo", "ृ": "ri",
+    "े": "e", "ै": "ai", "ो": "o", "ौ": "au", "ं": "n", "ः": "h", "्": ""
+}
+
+LATIN_TO_DEVANAGARI_MAP = {
+    "aa": "आ", "ee": "ई", "oo": "ऊ", "ai": "ऐ", "au": "औ",
+    "ka": "क", "kha": "ख", "ga": "ग", "gha": "घ",
+    "cha": "च", "chha": "छ", "ja": "ज", "jha": "झ",
+    "ta": "त", "tha": "थ", "da": "द", "dha": "ध", "na": "न",
+    "pa": "प", "pha": "फ", "ba": "ब", "bha": "भ", "ma": "म",
+    "ya": "य", "ra": "र", "la": "ल", "va": "व", "wa": "व",
+    "sha": "श", "sa": "स", "ha": "ह",
+    "a": "अ", "i": "इ", "u": "उ", "e": "ए", "o": "ओ"
+}
+
+GARHWALI_STOPWORDS = {
+    "छ", "छन", "छी", "छ्या", "छूँ", "छा", "मा", "माझ", "बटि", "से", "तैं",
+    "कणी", "कथै", "कु", "की", "का", "को", "दगड़", "सती", "यों", "वो",
+    "ऊ", "मैं", "हम", "तू", "तुम", "अपण", "अपुण", "ना", "नि", "नी", "झनि"
+}

garhwali-1.0.0/garhwali/culture/__init__.py

@@ -0,0 +1,12 @@
+# -*- coding: utf-8 -*-
+"""Garhwali Culture, Lore & Calendar Package."""
+
+from .calendar import GARHWALI_MONTHS, GARHWALI_RITUS, GARHWALI_DAYS, get_current_season
+from .festivals import GARHWALI_FESTIVALS, list_festivals
+from .literature import poems, epics, authors
+
+__all__ = [
+    "GARHWALI_MONTHS", "GARHWALI_RITUS", "GARHWALI_DAYS", "get_current_season",
+    "GARHWALI_FESTIVALS", "list_festivals",
+    "poems", "epics", "authors"
+]

garhwali-1.0.0/garhwali/culture/calendar.py

@@ -0,0 +1,51 @@
+# -*- coding: utf-8 -*-
+"""Garhwali Calendar, Months, Ritus, and Days of the Week."""
+
+import datetime
+from typing import Dict, List, Any, Optional, Tuple, Union, Set
+
+GARHWALI_MONTHS = {
+    1: {"name": "चैत", "english": "Chait", "gregorian": "Mid March - Mid April"},
+    2: {"name": "बैसाख", "english": "Baisakh", "gregorian": "Mid April - Mid May"},
+    3: {"name": "जेठ", "english": "Jeth", "gregorian": "Mid May - Mid June"},
+    4: {"name": "असाड़", "english": "Asadh", "gregorian": "Mid June - Mid July"},
+    5: {"name": "साउन", "english": "Saun", "gregorian": "Mid July - Mid August"},
+    6: {"name": "भादौ", "english": "Bhado", "gregorian": "Mid August - Mid September"},
+    7: {"name": "आसोज", "english": "Aasoj", "gregorian": "Mid September - Mid October"},
+    8: {"name": "कातिक", "english": "Katik", "gregorian": "Mid October - Mid November"},
+    9: {"name": "मंगसिर", "english": "Mangasir", "gregorian": "Mid November - Mid December"},
+    10: {"name": "पूस", "english": "Poos", "gregorian": "Mid December - Mid January"},
+    11: {"name": "माघ", "english": "Maagh", "gregorian": "Mid January - Mid February"},
+    12: {"name": "फागुन", "english": "Phagun", "gregorian": "Mid February - Mid March"}
+}
+
+GARHWALI_RITUS = {
+    "बसंत": {"hindi": "वसंत", "english": "Spring", "months": ["चैत", "बैसाख"]},
+    "रूड़ि": {"hindi": "ग्रीष्म", "english": "Summer", "months": ["जेठ", "असाड़"]},
+    "चौमास": {"hindi": "वर्षा", "english": "Monsoon / Rainy", "months": ["साउन", "भादौ"]},
+    "सरद": {"hindi": "शरद", "english": "Autumn", "months": ["आसोज", "कातिक"]},
+    "स्यूँद": {"hindi": "हेमंत", "english": "Early Winter", "months": ["मंगसिर", "पूस"]},
+    "जाड़": {"hindi": "शिशिर", "english": "Late Winter", "months": ["माघ", "फागुन"]}
+}
+
+GARHWALI_DAYS = {
+    "रविवार": "ऐतवार", "सोमवार": "सोमवार", "मंगलवार": "मंगर",
+    "बुधवार": "बुधवार", "गुरुवार": "बिफे", "शुक्रवार": "सुक्कुर", "शनिवार": "सनिच्चर"
+}
+
+def get_current_season() -> Dict[str, str]:
+    m = datetime.datetime.now().month
+    if m in (3, 4): return {"name_garhwali": "बसंत", "name_hindi": "वसंत", "english_season": "Spring"}
+    elif m in (5, 6): return {"name_garhwali": "रूड़ि", "name_hindi": "ग्रीष्म", "english_season": "Summer"}
+    elif m in (7, 8): return {"name_garhwali": "चौमास", "name_hindi": "वर्षा", "english_season": "Monsoon / Rainy"}
+    elif m in (9, 10): return {"name_garhwali": "सरद", "name_hindi": "शरद", "english_season": "Autumn"}
+    elif m in (11, 12): return {"name_garhwali": "स्यूँद", "name_hindi": "हेमंत", "english_season": "Early Winter"}
+    else: return {"name_garhwali": "जाड़", "name_hindi": "शिशिर", "english_season": "Late Winter"}
+
+def get_current_himalayan_month() -> Dict[str, Any]:
+    now = datetime.datetime.now()
+    # Himalayan months start approx mid-gregorian month
+    m_idx = now.month - 2
+    if m_idx < 1:
+        m_idx += 12
+    return GARHWALI_MONTHS[m_idx]

garhwali-1.0.0/garhwali/culture/festivals.py

@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+"""Garhwali Festivals and Celebrations."""
+
+from typing import Dict, List, Any, Optional, Tuple, Union, Set
+
+GARHWALI_FESTIVALS = [
+    {
+        "name": "फूलदेई (Phooldei)",
+        "month": "चैत (Chait)",
+        "description": "Himalayan flower festival where children place freshly bloomed wild flowers (Buransh, Pyoli) on village doorsteps.",
+        "blessing": "फूल देई, छम्मा देई, दैणी द्वार, भर भकार!"
+    },
+    {
+        "name": "इगास बग्वाल (Igas Bagwal)",
+        "month": "कातिक (Katik)",
+        "description": "Celebrated 11 days after Diwali in Garhwal to welcome warrior hero Madho Singh Bhandari back from victorious battle.",
+        "tradition": "Spinning fire rope torch (भैलो / Bhelo) and community Raso-Thadya folk dances."
+    },
+    {
+        "name": "नंदा देवी राज जात (Nanda Devi Raj Jat)",
+        "month": "भादौ (Bhado)",
+        "description": "The Mahakumbh of the Himalayas — 280km pilgrimage trek across high Alpine meadows to Roopkund & Homkund.",
+        "tradition": "Led by the sacred four-horned ram (चौसिंग्या खाडू) honoring Goddess Nanda Devi."
+    },
+    {
+        "name": "बटर फेस्टिवल / अंदूड़ी उत्सव (Anduri Butter Festival)",
+        "month": "भादौ (Bhado)",
+        "description": "Celebrated in Dayara Bugyal meadow (Uttarkashi) where villagers play Holi with fresh milk, butter, and chaach to thank nature.",
+        "tradition": "Offering first dairy harvest to Lord Krishna and forest deities."
+    }
+]
+
+def list_festivals() -> List[Dict[str, Any]]:
+    return GARHWALI_FESTIVALS

garhwali-1.0.0/garhwali/culture/literature.py

@@ -0,0 +1,52 @@
+# -*- coding: utf-8 -*-
+"""Garhwali Folk Songs, Epics, Literature & Authors."""
+
+from typing import Dict, List, Any, Optional, Tuple, Union, Set
+
+POEMS = [
+    {
+        "title": "चैता की चैतवाली (Chaita Ki Chaitwali)",
+        "genre": "Folk Romance & Legend",
+        "description": "Classic ballad celebrating the return of springtime, blossoms of the rhododendron (Buransh), and Garhwali mountain heritage."
+    },
+    {
+        "title": "बेड़ू पाको बारामासा (Bedu Pako Baramasa)",
+        "genre": "Universal Uttarakhand Anthem",
+        "description": "Immortal folk song of the Himalayas describing wild Himalayan figs ripening across the 12 seasons of Garhwal & Kumaon."
+    }
+]
+
+EPICS = [
+    {
+        "title": "माधो सिंह भंडारी (Madho Singh Bhandari)",
+        "hero": "Madho Singh Bhandari (मलेथा का सेनापति)",
+        "theme": "Engineering marvel of digging the mountain canal of Maletha and ultimate courage in defending Garhwal Kingdom."
+    },
+    {
+        "title": "जीतू बगड़वाल (Jeetu Bagdwal)",
+        "hero": "Jeetu Bagdwal",
+        "theme": "Legendary flute player whose divine music enchanted the celestial fairies (आंछरियों) of the high Alpine bugyals."
+    }
+]
+
+AUTHORS = [
+    {
+        "name": "भजन सिंह 'सिंह' (Bhajan Singh 'Singh')",
+        "era": "1905-1996",
+        "work": "'सिंहनाद' (Singhnaad) and pioneer of modern Garhwali epic poetry and cultural philosophy."
+    },
+    {
+        "name": "चन्द्रकुंवर बर्त्वाल (Chandra Kunwar Bartwal)",
+        "era": "1919-1947",
+        "work": "'हिमवंत का कालिदास' — Legendary romantic and nature poet of Rudraprayag, Garhwal."
+    },
+    {
+        "name": "नरेन्द्र सिंह नेगी (Narendra Singh Negi)",
+        "era": "Contemporary",
+        "work": "'Garh-Gaurav' — Voice of Garhwal, songwriter and folk maestro chronicling the socio-cultural soul of Uttarakhand."
+    }
+]
+
+def poems() -> List[Dict[str, Any]]: return POEMS
+def epics() -> List[Dict[str, Any]]: return EPICS
+def authors() -> List[Dict[str, Any]]: return AUTHORS

garhwali-1.0.0/garhwali/grammar/__init__.py

@@ -0,0 +1,15 @@
+# -*- coding: utf-8 -*-
+"""Garhwali Grammar Package."""
+
+from .nouns import GarhwaliNoun, CORE_GARHWALI_NOUNS
+from .pronouns import GARHWALI_PRONOUNS_TABLE, get_pronoun_form
+from .verbs import GarhwaliVerb, CORE_GARHWALI_VERBS
+from .postpositions import GARHWALI_POSTPOSITIONS
+from .syntax import validate_sov_order
+
+__all__ = [
+    "GarhwaliNoun", "CORE_GARHWALI_NOUNS",
+    "GARHWALI_PRONOUNS_TABLE", "get_pronoun_form",
+    "GarhwaliVerb", "CORE_GARHWALI_VERBS",
+    "GARHWALI_POSTPOSITIONS", "validate_sov_order"
+]

garhwali-1.0.0/garhwali/grammar/nouns.py

@@ -0,0 +1,82 @@
+# -*- coding: utf-8 -*-
+"""Garhwali Noun Declension and Case Inflection Engine."""
+
+from typing import Dict, List, Any, Optional, Tuple, Union, Set
+
+class GarhwaliNoun:
+    def __init__(self, lemma: str, gender: str = "m", english: Optional[str] = None, hindi: Optional[str] = None):
+        self.lemma = lemma.strip()
+        self.gender = gender.lower()
+        self.english = english
+        self.hindi = hindi
+
+    def declensions(self) -> Dict[str, str]:
+        """Returns the full 8-case direct and oblique declension table."""
+        root = self.lemma
+        forms = {}
+        if self.gender == "m":
+            forms["direct_sg"] = root
+            forms["direct_pl"] = root + "ों" if not (root.endswith("ा") or root.endswith("ो") or root.endswith("ु")) else root[:-1] + "ा"
+            forms["oblique_sg"] = root[:-1] + "ा" if (root.endswith("ो") or root.endswith("ु")) else root
+            forms["oblique_pl"] = root[:-1] + "ौं" if (root.endswith("ा") or root.endswith("ो") or root.endswith("ु")) else root + "ौं"
+            forms["ergative_sg"] = forms["oblique_sg"] + "ले"
+            forms["ergative_pl"] = forms["oblique_pl"] + "ले"
+            forms["accusative_dative"] = forms["oblique_sg"] + " तैं"
+            forms["instrumental"] = forms["oblique_sg"] + " सेती"
+            forms["ablative"] = forms["oblique_sg"] + " बटी"
+            forms["genitive_m"] = forms["oblique_sg"] + " कु"
+            forms["genitive_f"] = forms["oblique_sg"] + " की"
+            forms["locative"] = forms["oblique_sg"] + " मा"
+            forms["vocative_sg"] = "हे " + forms["oblique_sg"] + "ा"
+        else: # Feminine
+            forms["direct_sg"] = root
+            forms["direct_pl"] = root + "याँ" if root.endswith("ी") else root + "ाँ"
+            forms["oblique_sg"] = root
+            forms["oblique_pl"] = root[:-1] + "यौं" if root.endswith("ी") else root + "ौं"
+            forms["ergative_sg"] = forms["oblique_sg"] + "ले"
+            forms["ergative_pl"] = forms["oblique_pl"] + "ले"
+            forms["accusative_dative"] = forms["oblique_sg"] + " तैं"
+            forms["instrumental"] = forms["oblique_sg"] + " सेती"
+            forms["ablative"] = forms["oblique_sg"] + " बटी"
+            forms["genitive_m"] = forms["oblique_sg"] + " कु"
+            forms["genitive_f"] = forms["oblique_sg"] + " की"
+            forms["locative"] = forms["oblique_sg"] + " मा"
+            forms["vocative_sg"] = "हे " + forms["oblique_sg"] + "े"
+        return forms
+
+CORE_GARHWALI_NOUNS = [
+    GarhwaliNoun("नौन", "m", english="boy", hindi="लड़का"),
+    GarhwaliNoun("नौनी", "f", english="girl", hindi="लड़की"),
+    GarhwaliNoun("घौर", "m", english="house", hindi="घर"),
+    GarhwaliNoun("गौं", "m", english="village", hindi="गाँव"),
+    GarhwaliNoun("डांडा", "m", english="mountain", hindi="पहाड़"),
+    GarhwaliNoun("धार", "f", english="mountain ridge", hindi="पहाड़ की चोटी"),
+    GarhwaliNoun("गाड़", "f", english="river", hindi="नदी"),
+    GarhwaliNoun("पाणि", "m", english="water", hindi="पानी"),
+    GarhwaliNoun("ब्वै", "f", english="mother", hindi="माँ"),
+    GarhwaliNoun("बुबा", "m", english="father", hindi="पिता"),
+    GarhwaliNoun("दादू", "m", english="elder brother", hindi="बड़ा भाई"),
+    GarhwaliNoun("दिदी", "f", english="elder sister", hindi="बड़ी बहन"),
+    GarhwaliNoun("भुला", "m", english="younger brother", hindi="छोटा भाई"),
+    GarhwaliNoun("भुली", "f", english="younger sister", hindi="छोटी बहन"),
+    GarhwaliNoun("बूबू", "m", english="grandfather", hindi="दादा जी"),
+    GarhwaliNoun("बौजी", "f", english="grandmother", hindi="दादी जी"),
+    GarhwaliNoun("कुकुर", "m", english="dog", hindi="कुत्ता"),
+    GarhwaliNoun("बिलाव", "m", english="cat", hindi="बिल्ली"),
+    GarhwaliNoun("गौई", "f", english="cow", hindi="गाय"),
+    GarhwaliNoun("बल्द", "m", english="ox", hindi="बैल"),
+    GarhwaliNoun("बाखरि", "f", english="goat", hindi="बकरी"),
+    GarhwaliNoun("भात", "m", english="rice", hindi="चावल / भात"),
+    GarhwaliNoun("रोटी", "f", english="bread", hindi="रोटी"),
+    GarhwaliNoun("च्या", "f", english="tea", hindi="चाय"),
+    GarhwaliNoun("दूद", "m", english="milk", hindi="दूध"),
+    GarhwaliNoun("घ्यू", "m", english="ghee", hindi="घी"),
+    GarhwaliNoun("गूर", "m", english="jaggery", hindi="गुड़"),
+    GarhwaliNoun("काफल", "m", english="bayberry", hindi="काफल"),
+    GarhwaliNoun("बुरांस", "m", english="rhododendron", hindi="बुरांश"),
+    GarhwaliNoun("बाट", "m", english="path", hindi="रास्ता"),
+    GarhwaliNoun("बदळ", "m", english="cloud", hindi="बादल"),
+    GarhwaliNoun("घाम", "f", english="sunlight", hindi="धूप"),
+    GarhwaliNoun("ह्यूंद", "m", english="snow", hindi="बर्फ"),
+    GarhwaliNoun("बौण", "m", english="forest", hindi="जंगल")
+]

garhwali-1.0.0/garhwali/grammar/postpositions.py

@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+"""Garhwali Postpositions and Case Markers."""
+
+GARHWALI_POSTPOSITIONS = {
+    "locative": {
+        "markers": ["मा", "माझ", "भीतर", "पर", "माथ"],
+        "meaning_hi": "में / पर / अंदर", "meaning_en": "in / on / inside / upon"
+    },
+    "ablative": {
+        "markers": ["बटि", "से", "ले"],
+        "meaning_hi": "से (स्थान या समय से)", "meaning_en": "from / since"
+    },
+    "dative_accusative": {
+        "markers": ["कणी", "कथै", "तैं", "कै"],
+        "meaning_hi": "को / के लिए", "meaning_en": "to / for / towards"
+    },
+    "genitive": {
+        "markers": ["कु", "की", "का", "को"],
+        "meaning_hi": "का / की / के", "meaning_en": "of / 's"
+    },
+    "instrumental_ergative": {
+        "markers": ["ले", "द्वारा"],
+        "meaning_hi": "ने / से / द्वारा", "meaning_en": "by / through"
+    },
+    "associative": {
+        "markers": ["दगड़", "सती", "साथ"],
+        "meaning_hi": "साथ / संग", "meaning_en": "with / along with"
+    }
+}