Metadata-Version: 2.4
Name: garhwali
Version: 1.3.0
Summary: Garhwali (गढ़वाली) Language Library: 2.39M+ Inflections, Multi-dialect Translation, NLP Toolkit, and Himalayan Culture
Home-page: https://github.com/infoakshatsinghbisht-eng/garhwali-language-library
Author: Akshat Singh Bisht
Author-email: Akshat Singh Bisht <infoakshatsinghbisht@gmail.com>
Maintainer: Akshat Singh Bisht
Maintainer-email: Akshat Singh Bisht <infoakshatsinghbisht@gmail.com>
Project-URL: Homepage, https://akshatsinghbisht.com/
Project-URL: GitHub, https://github.com/infoakshatsinghbisht-eng/garhwali-language-library
Project-URL: LinkedIn, https://www.linkedin.com/in/akshat-singh-bisht-digital-performance-marketing-specialist/
Project-URL: Amazon Author, https://www.amazon.com/stores/Akshat-Singh-Bisht/author/B0D5TYDT28
Project-URL: ResearchGate, https://www.researchgate.net/profile/Akshat-Bisht-8
Project-URL: Bug Tracker, https://github.com/infoakshatsinghbisht-eng/garhwali-language-library/issues
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: author
Dynamic: home-page
Dynamic: maintainer
Dynamic: requires-python

# 🏔️ Garhwali (गढ़वाली) Language Library

[![PyPI Version](https://img.shields.io/pypi/v/garhwali.svg)](https://pypi.org/project/garhwali/)
[![PyPI Downloads](https://img.shields.io/pypi/dm/garhwali.svg)](https://pypi.org/project/garhwali/)
[![Python Versions](https://img.shields.io/pypi/pyversions/garhwali.svg)](https://pypi.org/project/garhwali/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![GitHub Repository](https://img.shields.io/badge/GitHub-garhwali--language--library-blue.svg)](https://github.com/infoakshatsinghbisht-eng/garhwali-language-library)
[![Website](https://img.shields.io/badge/Website-akshatsinghbisht.com-orange.svg)](https://akshatsinghbisht.com/)
[![LinkedIn](https://img.shields.io/badge/LinkedIn-Akshat_Singh_Bisht-0077b5.svg)](https://www.linkedin.com/in/akshat-singh-bisht-digital-performance-marketing-specialist/)
[![ResearchGate](https://img.shields.io/badge/ResearchGate-Akshat_Bisht-00ccbb.svg)](https://www.researchgate.net/profile/Akshat-Bisht-8)
[![Amazon Author](https://img.shields.io/badge/Amazon-Author_Page-FF9900.svg)](https://www.amazon.com/stores/Akshat-Singh-Bisht/author/B0D5TYDT28?ref=sr_ntt_srch_lnk_1&qid=1789906571&sr=8-1&shoppingPortalEnabled=true)

A comprehensive Python library, NLP toolkit, and computational linguistics engine for the **Garhwali Language (गढ़वाली भाषा)** — spoken by over 3 million people across Uttarakhand's Garhwal Himalayas (Pauri, Tehri, Chamoli, Uttarkashi, Rudraprayag, Dehradun, and Haridwar).

---

## 🌟 Key Capabilities & Modules

1. **📚 2,390,000+ Morphological Word Forms (`garhwali.lexicon.morphology`)**:
   - Dynamic inflectional engine covering noun declensions (8 cases $\times$ gender $\times$ number), pronoun cases, full verb aspectual/temporal matrices, and postpositional compounds across 5 dialects.
2. **🔄 Multi-Dialect Translation Engine (`garhwali.translator`)**:
   - Fast, rule-based & phonetic translation across **English $\leftrightarrow$ Garhwali**, **Hindi $\leftrightarrow$ Garhwali**, and **Hinglish $\leftrightarrow$ Garhwali**.
   - Supports 5 distinct dialect regions:
     - **Srinagariya** (Standard Pauri Garhwal)
     - **Rathwali** (Eastern Pauri / Rath region)
     - **Tehri** (Tehri Garhwal & Bhagirathi Valley)
     - **Salani** (Southern Pauri / Kotdwar)
     - **Badhani** (Chamoli / Alaknanda Valley)
3. **📖 3,619+ Verified Lexical Lemmas (`garhwali.lexicon.dictionary`)**:
   - Richly categorized vocabulary database with dialect variants across 27 domains:
     - **Kinship & Family**: *बुबा, दद्दा, भुली, दीदी, भुलू, नौनी, नौना, ब्वारी, जंवाई, कक्यो, काकी, मामा, मामी, बूबू, दादी, नाती, सौरास, मैत, ध्याणी, समधी, जेठ, देवर, ननद, साला, साली, पुरखा*
     - **Marriage & Wedding Culture**: *ब्याव, मंगणी, बन्ना, बन्नी, धूली-अर्घ, मंगल-गीत, कन्यादान, फेरा, बिदाई, रौंतेली, बरात, जनेती, नथुली, गुलोबंद, पिछौड़ा, अरसा, नेग, न्यौता*
     - **Social Relationships**: *दगाड़ी, संगी, पड़ोसी, पाहुणा, सयाणा, अणजाण, गौंंत्यार, जैती, कौथिग्यार*
     - **Traditional Occupations & Crafts**: *अनवाल, घस्यारी, औजी, ढकी, जगरिया, डांगरिया, तामटा, ओढ़, हलिया, घट्ट्या*
     - **Household, Kitchen & Architecture**: *तिबारी, खोली, पाथर, भकार, ओखली, मूसल, सिलबट्टा, जांदो, दातुलि, गागरी, चिमटा, कंडी, चलनी, दीया*
     - **Traditional Cuisine & Condiments**: *काफ़ुली, चैनसूं, झोली, थटवाणी, चुड़कानी, गुटका, बाड़ी, सिंगोरी, पिस्यूं-लूण, भात, जख्या, फरन, गंधरायण, भंगजीरा*
     - **Nature, Weather & Geography**: *बुग्याल, गधेरा, सेरा, ओड्यार, हिंवल, बयार, कुहासा, छरछरा, ढुंगो, माटी, धारो, नौला, गाड़, खड्ड, चोटी, बादल, बिजुली, उज्यालो, अन्हारो*
     - **Fauna & Wildlife**: *घुरल, कस्तूरी-मृग, गुलदार, मोनाल, हिलांस, काकड़, जुँक, गौ, बल्द, भैंसी, बाछो, बाखरो, कुक्कुर, बिलाव, घोड़ो, खच्चर, स्याल, बांदर, काग, चील, उल्लू, तितली, माछी*
     - **Ethnobotanical Trees & Plants**: *बाँझ, मोरू, खर्सू, बुरांश, सिमरू, देवदार, चीड़, कैल, भोजपत्र, पंया, भीमल, खरिक, उतीस, तिमरू, बेल, मालू, ब्रह्मकमल, फेनकमल, जटामांसी, कूट, अतीस, मीठा-बिख, सलामपंजा, कीड़ाजड़ी, काफल, हिसालू, किल्मोड़ा, बेडू, तिमला, कंडाली, लिंगुड़ा, मंडुवा, झंगोरा, मर्सा, उगल, गहत, भट्ट*
     - **Body, Health & Emotions**: *मुंड, खुट्टा, मया, नराई, रिस, औखद, चरण, पसीना, स्वाभिमान*
     - **Numbers, Time & Seasons**: *ब्याली, आजि, काल, रूड़ी, चौमासा, स्यूंंद, एक से सौ तक संख्याएँ, पहिलो, दूसरो, तीसरो*
     - **Modern Technology & Digital**: *चलभाष, संगणक, अंतरजाल, जालस्थल, अनुप्रयोग, कृत्रिम-बुद्धिमत्ता, साइबर-सुरक्षा*
     - **Governance, Law & Public Services**: *पटवारी, प्रधान, कचहरी, दरखास्त, रपट, कानून, आपातकाल*
     - **School & Education**: *स्कूल, पाटी (स्लेट), खड़िया (चाक), कलम, दवात, सिहाई (स्याही), कापी, पोथी (किताब), मास्टरजी, विद्यार्थी, इम्तिहान (परीक्षा), नतीजा, छुट्टी, घंटी, हाजिरी, गृहकार्य, वजीफा (छात्रवृत्ति)*
     - **Government Jobs & Employment**: *सरकारी-नौकरी, भर्ती (रैली), साक्षात्कार (इंटरव्यू), तरक्की (पदोन्नति), बदली (स्थानांतरण), पेंशन, हाकिम (साहब/अफसर), बाबू (क्लर्क), चपरासी (अर्दली)*
     - **Business, Trading & Commerce**: *ब्योपार, दूकानदार, थोक-ब्योपार, फुटकर, पूँजी, मुनाफा, घाटो (नुकसान), मंडी, पर्चा (बिल), रसीद, साझेदारी, उधार, साहूकार (महाजन)*
     - **Job Scams, Corruption & Crime**: *घपलो (घोटाला), पर्चा-लीक (पेपर लीक), घूस (रिश्वत), भ्रष्टाचार, दलाल (बिचौलिया), फर्जी (जाली), धोखो, डाका (डकैती), लूट, चोर, सेंधमारी, जेबकतरा, उगाही, थाना, थानेदार, गिरफ्तारी, हथकड़ी, हवालात, जमानत, बयान (गवाही), सजा, मुजरिम (दोषी), मुकद्दमा (केस)*
     - **Office Supplies & Things**: *नस्ती (फाइल/मिसिल), रजिस्टर, मोहर (सील), लिफाफा, नत्थी (टैगिंग), मेज, कुर्सी*
     - **Home Furniture & Household**: *खाट (चारपाई), पलंग, गद्दा, सिरहाना (तकिया), रजाई, कंबल, चादर, अलमारी, सीसा (दर्पण), बुहारी (झाड़ू), पोछा, बाल्टी, मग्गो, अरगनी (डोरी), संदूक (बक्सा), ताला, कुंजी (चाबी), चटाई, पीढ़ा (पाटा)*
     - **Crockery & Kitchen Utensils**: *थाली, कटोरा, कचौड़ी (कटोरी), गिलास, प्याला (कप), तश्तरी (प्लेट), जग, चमचा, काँटा, चाकू, पतीला (भगोना), कड़ाही, ढक्कन, कद्दूकस, छिलनी, छलनी, चकला, बेलन, मटका (घड़ा), सुराही, डिब्बा (टिफिन), सँड़सी, तवा*
     - **Children: Stages, Movement, Babble & Games**: *लल्ला (शिशु), पालना, लोरी, स्तनपान, घुटन्यूं-चलणु (घुटनों के बल चलना), डगमग-चलणु (डगमगाते कदम), रून-झुन (घुंघरू चाल), तोतलो-बोलणु (तोतली बोली), किलकारी, बिलखणु (सिसकना), मचलणु (बालहठ), चिपकणु (मां से लिपटना), कांख (गोद/कमर), कंचा, स्टापू, लट्टू, पतंग, झूला, कूदणु, छलांग-मारणु, ठोकर-खाणु*
     - **Childhood Life-Cycle Rituals**: *नामकरण (११वें दिन का संस्कार), झडूला (चूड़ाकर्म/मुंडन), अन्नप्राशन (पसनी/खीर चटाना), कर्णवेध (कान छेदन), विद्यारंभ (अक्षरारंभ), नजर-उतारणु (बुरी नजर उतारना)*
     - **Literature & Song Extractions**: *मंडाण, अचरी, जागर, भैलो, छंतोली, पव्वाड़ा, झुमेलो, गूल, भड़, रणसिंघा, भंकोरा, छैला, बांद, बांसुरी, नाद, दीप, डोली, मेढ़ा, सुदिन, सुहाग, शहनाई, छिल्ला, पूड़ी, शगुन, पराक्रम, बलिदान, वास, वंदना, संकट, शरण, कौथिग, डंका, घुंघरू, शिखर, सागर, चिनहार, गदा, बाण, धनुष, अमृत, कमाई, निर्भय, चौंफुला, थड्या, गौंत, गोबर, लीपणा, छींटा, जातरा, धियान, आशीर्वाद, असीस*
4. **🗺️ Sacred Geography & Places of Garhwal (`garhwali.culture.places`)**:
   - Comprehensive catalogue of **48 documented sacred landmarks** across all 7 districts of Garhwal:
     - **Panch Kedar (पंच केदार)**: Kedarnath, Madhyamaheshwar, Tungnath, Rudranath, Kalpeshwar.
     - **Panch Badri (पंच बद्री)**: Badrinath, Adi Badri, Bhavishya Badri, Vriddha Badri, Dhyan Badri.
     - **Panch Prayag (पंच प्रयाग)**: Devprayag, Rudraprayag, Karnaprayag, Nandaprayag, Vishnuprayag.
     - **High Alpine Bugyals**: Auli, Chopta, Dayara, Bedni.
     - **Historic Towns & Cultural Centers**: Srinagar Garhwal, Joshimath, Gopeshwar, Pauri, Uttarkashi, Ukhimath, Guptkashi, Rishikesh, Haridwar, Khirsu.
     - **Sacred Mountains & Shrines**: Surkanda Devi, Chandrabadani, Kunjapuri, Dhari Devi, Triyuginarayan, Khait Parvat, Hanol Mahasu.
5. **🙏 Local Deities, Shrines & Jagar Lore (`garhwali.culture.deities`)**:
   - Structured records of **18 canonical Garhwali deities**:
     - *Dhari Devi, Botha Mahasu, Chalda Mahasu, Sem Mukhem Nagaraja, Danda Nagaraja, Nanda Devi, Latu Devta, Kandoliya Devta, Surkanda Devi, Chandrabadani Devi, Kunjapuri Devi, Jwalpa Devi, Ghandiyal Devta, Bhumyal Devta (Kshetrapal), Bhairav Devta, Aanchhariyan (Alpine Fairies), Guru Gorakhnath, Pandav Devtas*.
     - Contains iconographies, legends, traditional invocations (जागर बोल), and cultural significance.
6. **👥 Garhwali Surnames, Clans & Social Concepts (`garhwali.culture.surnames`)**:
   - Comprehensive cataloguing of **24 documented heritage lineages**:
     - **Brahmin Clans**: *Khanduri, Nautiyal, Bahuguna, Gairola, Uniyal, Semwal, Dimri, Bhatt, Thapliyal, Raturi, Dhasmana, Chamoli*.
     - **Rajput / Kshatriya Clans**: *Panwar, Negi, Rawat, Bisht, Bhandari, Chauhan, Bartwal, Gusain, Aswal, Kathait, Sajwan, Kaintura, Rana*.
     - **Alpine Transhumant Communities**: *Marchha, Tolchha, Jadh*.
     - **Shilpkar & Artisan Lineages**: *Auji / Das, Tamta, Dhaki, Beda, Lohar*.
     - **Garhwali Social Concepts**: *Thokdaar, Gauntyaar / Sayana, Bhad (वीर भड़), Jagariya, Dangariya, Dhol Sagar, Beda-Vart, Jaiti, Dhandak*.
7. **🌿 Himalayan Ethnobotanical Flora (`garhwali.culture.flora`)**:
   - Master catalogue of **30+ indigenous trees, alpine herbs, wild fruits, and crops** of Garhwal:
     - Botanical families, habitat altitudes, traditional uses, temple offerings, and cultural folklore.
8. **🪔 Temple Implements, Vessels & Ritual Objects (`garhwali.culture.rituals`)**:
   - Catalogue of **24 sacred implements, vessels, hawan paraphernalia, and attire**:
     - *Pithya, Akshat, Dhago/Kalawa, Janyo, Tamakundi, Dhoopdani, Panchaarti, Shankh, Garud-Ghanti, Havan Kund, Sruva & Sruk, Samidha, Doli, Chhantoli, Chaunr, Nishan, Dhol, Damau, Ransingha, Bhankora, Kansya Thali, Tehri Nath, Guloband, Hansuli, Dhagula, Rot, Arsa, Malu Pattal & Duna*.
9. **🎶 Complete Folk Songs Corpus & Digital Archives (`garhwali.culture.folklore`)**:
   - **20 Complete Authenticated Garhwali Songs** saved as full text in `data_sources/raw_texts/songs/` and catalogued in `songs.json`:
     - *Bedu Pako Baramasa, Chaita Ki Chaitwali, Thando Re Thando Mera Pahada Ko Paani, Ghughuti Na Baas Mait Ki, Dhari Devi Jagar, Nanda Raj Jat, Mangal Geet, Igas Bagwal, Phooldei Chham Chham, Maletha Ki Gool (Madho Singh Bhandari), Jeetu Bagdwal, Surkanda Mata Vandana, Saruli Meru Jiya Lagi, Hilaans Pakhi, Chhori Garhwali, Jai Badrinath Kedarnath, Tehri Doobon, Buransh Phooli Ge, Pandav Nritya Mandaan, Kodu Jhangora Khani*.
   - **7 Active Digital Heritage Archives** indexed in `digital_sources.json`.
10. **📚 Master Garhwali Bibliography & Literature (`garhwali.culture.bibliography` & `literature`)**:
    - **231 Canonical Books Catalogued** across works written in Garhwali, grammar/linguistics treatises, and cultural studies.
    - **6 Classical Folk Epics (पवाड़े)**, **4 Canonical Poems**, and **10 Distinguished Authors**.
11. **📖 86 Complete Full-Text Digital Books & Page Reader (`garhwali.culture.books`)**:
    - **23,856 Complete Digitized Pages** available page-by-page directly in Python:
      - *Sir George Grierson (1916)*: Linguistic Survey of India (Central Pahari / Garhwali) — 977 pages
      - *Pandit Ganga Datt Upreti (1894)*: Proverbs & Folklore of Kumaun and Garhwal — 398 pages
      - *Rev. E.S. Oakley & Tara Dutt Gairola (1935)*: Himalayan Folklore — 313 pages
      - *Dr. Govind Chatak (1959)*: Garhwali Bhasha (Linguistic & Grammatical Study) — 102 pages
      - *Dr. Govind Chatak (1958)*: Gadwali Lok Gathayen (Pawada & Jagar Epics) — 114 pages
      - *Dr. Haridatta Bhatt 'Shailesh' (1976)*: Garhwali Bhasha Aur Uska Sahitya — 128 pages
      - *Dr. Gunanand Juyal (1967)*: Madhya Pahadi Bhasha (Central Pahari Phonology & Morphology) — 117 pages
      - *Shyam Chand Negi (1954)*: Gadwali Sahitya (Anthology & Critical History) — 151 pages
      - *Pt. Govind Prasad Ghildyal (1928)*: Garhwali Bhasha Aur Uska Vyakaran — 84 pages
      - *Pt. Hari Krishna Raturi (1928)*: Garhwal Ka Itihas (Ancient Inscriptions & Clans) — 381 pages
      - *Pt. Ganga Datt Upreti (1894)*: Proverbs & Folklore (Extended Edition) — 398 pages
      - *Dr. Govind Chatak (1956)*: Garhwali Lok Geet (Folk Songs of Garhwal) — 114 pages
      - *Shanti Chaudhary (1994)*: Garhwali Lokkala (Aipan, Murals & Ritual Arts) — 110 pages
      - *Edwin T. Atkinson (1882)*: The Himalayan Districts of the North-Western Provinces (Vol. 1) — 955 pages
      - *Edwin T. Atkinson (1884)*: The Himalayan Districts of the North-Western Provinces (Vol. 2) — 1,389 pages
      - *Edwin T. Atkinson (1883)*: Notes on the History of the Himalayan Districts — 684 pages
      - *Dr. Shiv Prasad Dabral 'Charan' (1961)*: Shri Uttarakhand Yatra Darshan — 451 pages
      - *Dr. Shiv Prasad Dabral 'Charan' (1971)*: Uttarakhand Ka Itihas (Bhag 1: Pragaithihasik Kaal) — 596 pages
      - *Dr. Shiv Prasad Dabral 'Charan' (1973)*: Uttarakhand Ka Itihas (Bhag 3: Garhwal Ka Naveen Itihas) — 624 pages
      - *E. K. Pauw (1896)*: Report on the Tenth Settlement of the Garhwal District — 662 pages
      - *H. G. Walton (1910)*: British Garhwal: A Gazetteer — 347 pages
      - *Pati Ram (1916)*: Garhwal: Ancient and Modern — 363 pages
      - *Rev. T. Grahame Bailey (1908)*: The Languages of the Northern Himalayas — 285 pages
      - *Rev. T. Grahame Bailey (1915)*: Linguistic Studies from the Himalayas — 267 pages
      - *L. D. Joshi (1929)*: The Khasa Family Law in the Himalayan Districts — 434 pages
      - *Mukandi Lal (1968)*: Garhwal Painting (Mola Ram & Garhwali School of Art) — 128 pages
      - *Dr. Siddheshwar Verma (1978)*: Pahari Language: A Linguistic Analysis — 97 pages
      - *Central Hindi Directorate (1989)*: Pahari-Hindi Shabdkosh — 123 pages
      - *George William Traill (1828)*: Statistical Sketch of Kumaon and Garhwal — 680 pages
      - *Pandit Ganga Datt Upreti (1900)*: Hill Dialects of the Kumaun Division (Central Pahari) — 119 pages
      - *H. G. Walton (1911)*: Dehra Dun: A Gazetteer (Vol. 1) — 441 pages
      - *Dr. Siddheshwar Verma (2004)*: Pahari Dictionary of 27 North-Western Himalayan Dialects — 395 pages
      - *Indian Institute of Advanced Study (2002)*: Pahari Bhasha Tatha Sahitya — 210 pages
      - *Dr. Shiv Prasad Dabral 'Charan' (1965)*: Uttarakhand Ke Bhotantik: Alaknanda Upatyaka Mein Pravas (Bhag 2) — 177 pages
      - *Edwin T. Atkinson (1886)*: The Himalayan Districts of the North-Western Provinces (Vol. 3) — 899 pages
      - *V. A. Stowell (1916)*: Kumaun Rulings for Civil Courts (Customary Law) — 185 pages
      - *Government of North-Western Provinces (1842)*: Historical Papers Relating to Kumaun and Garhwal 1809-1842 — 307 pages
      - *Rev. E. S. Oakley & Tara Dutt Gairola (1935)*: Himalayan Folklore (Extended Archival Edition) — 313 pages
      - *Dr. Siddheshwar Verma (2003)*: Dr. Siddheshwar Varma's Pahari Dictionary (Vol. 1) — 372 pages
      - *Imperial Gazetteer of India (1905)*: Imperial Gazetteer of India: Kumaun Division (Garhwal) — 69 pages
      - *A. L. Mumm (1909)*: Five Months in the Himalaya: Mountain Travel in Garhwal — 211 pages
      - *Government of United Provinces (1919)*: Kumaun and Garhwal: Local Customs and Usages — 105 pages
      - *Dr. Siddheshwar Verma (2003)*: Dr. Siddheshwar Varma's Pahari Dictionary (Part 3) — 270 pages
      - *Rev. E. S. Oakley (1920)*: Himalayan Folklore: Legends and Traditions of Kumaon and Garhwal — 269 pages
      - *T. R. Joshi (1911)*: Dictionary of Pahari Dialects of the Western and Central Himalayas — 154 pages
      - *Gypsy Davy and Lady Ba (1927)*: The Himalayan Letters of Gypsy Davy and Lady Ba (Garhwal Pilgrimage) — 319 pages
      - *Charles A. Sherring (1906)*: Western Tibet and the British Borderland: Garhwal and Bhotia Customs — 304 pages
      - *J. H. Batten (1851)*: Official Reports on the Province of Kumaon and Garhwal — 620 pages
      - *Dr. Harshwanti Bisht (1994)*: Tourism in Garhwal Himalaya: Pilgrimage, Culture and Economy — 215 pages
      - *Garhwal Exploration Society (1986)*: Peaks and Passes of the Garhwal Himalaya — 161 pages
      - *H. P. Bhatt et al. (1992)*: Garhwal Himalaya: Nature, Culture and Society — 143 pages
      - *Dr. Siddheshwar Varma (2003)*: Dr. Siddheshwar Varma's Pahari Dictionary of 27 Dialects (Part 2) — 72 pages
      - *Language Division, Govt. of India (2023)*: Linguistic Survey of India: Pahari Dialects — 596 pages
      - *Dr. Omkareshwor Shrestha (2000)*: A Grammar of Pahari: Phonology, Morphology and Syntax — 217 pages
      - *Todd Lewis (1995)*: The Himalayas: History, Anthropology, and Religion — 140 pages
      - *André Roch (1947)*: Garhwal Himalaya: Mountain Expeditions and High Passes — 131 pages
      - *BVP Research Collection (1998)*: Himachali and Pahari Shabdawali — 25 pages
      - *J. B. Auden (1936)*: The Structure of the Himalaya in Garhwal — 38 pages
      - *Sir George Grierson (1916)*: LSI Pahari Languages and Gujuri (IGNCA Edition) — 770 pages
      - *Forest Department (1897)*: Working Plan of the Tehri-Garhwal Leased Forests — 186 pages
      - *Iqbal Nazish (1995)*: Chalyaan Suraan: Pahari Rhythms, Songs and Verses — 57 pages
      - *N. S. Bhandari et al. (1946)*: Snow Balls of Garhwal: Folk Songs and Ballads — 50 pages
      - *Himalayan Natural History Society (1969)*: Birds and Natural History of Lower Garhwal — 38 pages
      - *A. W. Ibbotson (1933)*: Eleventh Revenue Settlement of Garhwal District — 26 pages
      - *Frank S. Smythe (1932)*: Kamet Conquered: Exploration in the Garhwal Himalaya and the Valley of Flowers — 378 pages
      - *Pt. Hariram Sharma (1938)*: Badrinath-Kedarnath Yatra: Holy Pilgrimage in the Garhwal Himalayas — 91 pages
      - *Frank S. Smythe (1932)*: Explorations in Garhwal around Kamet (Geographical Journal) — 31 pages
      - *Dr. Mohammad Ishaq Khan (1978)*: History of Srinagar: Socio-Cultural Change in the Central and Northern Himalayas — 319 pages
      - *Parvez Maanoos (2020)*: Parbaton Ki Khushbu: Selected Pahari Mountain Tales, Folklore and Idioms — 57 pages
      - *Swami Sivananda (1966)*: Himalayan Forest Hermitage: Health, Nature and Sacred Living in Garhwal — 183 pages
      - *Swami Prabodhanand (1961)*: Across Gangotri Glaciers: Explorations in Northern Garhwal — 50 pages
      - *Shiv Kumar Painuli et al. (2000)*: Shri Nanda Devi Raj Jat: The Royal Himalayan Pilgrimage of Garhwal — 23 pages
      - *Eric Shipton (1936)*: Nanda Devi: Exploration of the Great Himalayan Sanctuary — 235 pages
      - *Eric Shipton (1935)*: Nanda Devi and the Ganges Watershed: Mountain Topography of Garhwal — 33 pages
      - *Zoological Survey of India (1997)*: Fauna of Nanda Devi Biosphere Reserve: Wildlife and Avifauna — 116 pages
      - *K. S. Negi et al. (1985)*: Flora of Khatling Glacier in the Garhwal Himalaya (District Tehri) — 19 pages
      - *H. G. Ross (1874)*: Settlement of Pargana Jaunsar-Bawar: Customary Law and Land Tenure — 114 pages
      - *Dr. D. N. Majumdar (1960)*: Himalayan Polyandry: Kinship, Culture and Social Structure in Jaunsar-Bawar — 538 pages
      - *G. F. Hearth (1889)*: Working Plan of the Deoban Range, Jaunsar Forest Division — 391 pages
      - *Pt. Devendranath Sharma (1955)*: Himtirth Badrinath: The Holy Himalayan Sanctum and Sacred Geography — 39 pages
      - *H. W. Tilman (1937)*: The Ascent of Nanda Devi: First Historic Ascent of the Sanctuary Peak — 232 pages
      - *J. J. Languepin (1956)*: To Kiss High Heaven: Nanda Devi and Trishul Himalayan Expeditions — 176 pages
    - Full search API across all 23,856 pages with text snippets, keywords, and chapter detection.
12. **⚖️ Split-Ergativity & SOV Syntax Validator (`garhwali.grammar.syntax`)**:
    - Enforces authentic Central Pahari ergative case markings (`-न / -ले` in transitive perfective clauses).
13. **🔢 Garhwali Numbers Engine (`garhwali.numbers`)**:
    - Converts any integer (0 to 1 crore) into Garhwali words, ordinals, and Devanagari numerals.
14. **🎙️ Voice Synthesis & SSML (`garhwali.voice`)**:
    - Himalayan pitch envelope generator, SSML formatter, and uncompressed PCM WAV synthesis.

---

## 🚀 Installation & Quick Start

```bash
pip install garhwali
```

### 💻 Python Usage Examples

```python
import garhwali

# ==================== 1. SACRED GEOGRAPHY & PLACES ====================
print(f"Total documented places: {len(garhwali.PlacesTreasury.list())}")

# Panch Kedar
for kedar in garhwali.PlacesTreasury.panch_kedar():
    print(f"- {kedar.name_garhwali} ({kedar.district}): {kedar.title}")

# Panch Badri & Panch Prayag
badris = garhwali.PlacesTreasury.panch_badri()
prayags = garhwali.PlacesTreasury.panch_prayag()

# Lookup specific place
dhari = garhwali.PlacesTreasury.get("dhari_devi")
print(dhari.spiritual_or_historical_significance)

# ==================== 2. LOCAL DEITIES & SHRINES ====================
deity = garhwali.DeitiesTreasury.get("botha_mahasu")
print(deity.name_garhwali)  # "बोथा महासू"
print(deity.invocation_or_jagar)

# ==================== 3. SURNAMES & SOCIAL STRUCTURE ====================
bhandari = garhwali.SurnamesTreasury.get("bhandari")
print(bhandari.title)  # "Hereditary Royal Treasurers & Legendary Heroic Warriors (Bhad)"
print(bhandari.notable_historical_figures)

# Garhwali social concepts
concepts = garhwali.SurnamesTreasury.social_concepts()
print(concepts["bhad"]["meaning_english"])  # "Legendary Epic Warrior / Champion Hero"

# ==================== 4. HIMALAYAN FLORA & ETHNOBOTANY ====================
buransh = garhwali.FloraTreasury.get("buransh")
print(buransh.scientific_name)  # "Rhododendron arboreum"
print(buransh.cultural_folklore)

# ==================== 5. TEMPLE IMPLEMENTS & RITUALS ====================
dhol = garhwali.RitualsTreasury.get("dhol")
print(dhol.sacred_purpose)
print(dhol.cultural_context)

# ==================== 6. COMPLETE SONGS CORPUS ====================
song = garhwali.FolkloreTreasury.get_song("GSN-0001")
print(song.title)  # "बेडू पाको बारामासा"
for verse in song.verses:
    print(f"  {verse}")

# Digital archive repositories
archives = garhwali.FolkloreTreasury.list_sources()
print(f"Active preservation repositories: {len(archives)}")

# ==================== 7. VOCABULARY & DICTIONARY ====================
word = garhwali.lookup("काफ़ुली")
print(word)
# {'garhwali': 'काफ़ुली', 'hindi': 'काफ़ुली (पालक-मेथी का गाढ़ा साग)', 'category': 'food', ...}

# ==================== 8. BIBLIOGRAPHY & LITERATURE ====================
chatak_books = garhwali.search_books("चातक")
for b in chatak_books:
    print(f"- {b.title} ({b.year}) by {b.author}")

# ==================== 9. FULL-TEXT BOOKS & PAGE-BY-PAGE READER ====================
print(f"Total digitized pages in library: {garhwali.BooksCorpus.total_pages_in_library()}")

# Read page 15 of Grierson's 1916 Linguistic Survey of India
page = garhwali.read_book_page("grierson_1916_central_pahari", 15)
print(f"Page {page.page_number}:\n{page.snippet(max_chars=300)}")

# Search across all 13 digitised books
results = garhwali.search_digital_books("माधो सिंह भण्डारी")
for r in results[:3]:
    print(f"[{r.book_title} - Page {r.page_number}]: {r.snippet}")

# ==================== 10. COMPUTATIONAL CORPUS & NLP FRAMEWORK ====================
# 20-Pillar Computational Taxonomy
taxonomy = garhwali.get_corpus_taxonomy()
print(f"Total Computational Pillars: {len(taxonomy.list_pillars())}")
pillar_novel = taxonomy.get_pillar("novels")
print(f"Pillar 1: {pillar_novel.name_garhwali} - {pillar_novel.description}")

# Annotated Sentence Corpus (Tokens, UPOS, Morphology, Translations, Citations)
sents = garhwali.get_sentence_corpus().all()
print(f"Total Annotated Sentences: {len(sents)}")
s1 = garhwali.get_annotated_sentence("sent_001")
print(f"Text: {s1.text}")
print(f"Tokens: {s1.tokens}")
print(f"UPOS: {s1.pos}")
print(f"Hindi: {s1.translation_hi}")
print(f"English: {s1.translation_en}")

# Split for Model Training / Evaluation (Train / Val / Test)
splits = garhwali.SentenceCorpus.train_test_split(train_ratio=0.8, val_ratio=0.1, test_ratio=0.1)
print(f"Train: {len(splits['train'])}, Val: {len(splits['validation'])}, Test: {len(splits['test'])}")

# Comprehensive Idioms & Proverbs Corpus (10-Field Schema)
idioms = garhwali.get_idiom_corpus()
sample_idiom = idioms.get("idh_001")
print(f"Idiom: {sample_idiom.idiom} ({sample_idiom.transliteration})")
print(f"Figurative: {sample_idiom.figurative_meaning}")
print(f"Hindi Equivalent: {sample_idiom.hindi_equivalent}")
print(f"English Gloss: {sample_idiom.english_gloss}")
print(f"Example: {sample_idiom.example_sentence}")

# ==================== 11. MULTI-DIALECT TRANSLATION ====================
res = garhwali.translate("Where are you from?", dialect="tehri")
print(res.text)  # "तुमु कथी बटी छा?"
```

---

## 🧪 Testing

The library includes a comprehensive unit test suite covering all modules:

```bash
python -m unittest discover -s tests -v
```

All 86 unit tests pass with 100% success across:
- `test_garhwali_core.py` (Version, exports, top-level APIs)
- `test_garhwali_corpus.py` (20-pillar taxonomy, annotated sentence corpus, UPOS tags, train/val/test splits, idioms & proverbs, strict bibliography separation)
- `test_garhwali_books.py` (Full-text digital books, 3,076 pages, page-by-page reader API)
- `test_garhwali_lexicon.py` (Dictionary lookup, search, 27 categories, dialect variants)
- `test_garhwali_grammar.py` (Morphology engine, noun declensions, verb conjugations, syntax)
- `test_garhwali_translator.py` (Multi-dialect translations, rule engine)
- `test_garhwali_culture.py` (Bibliography treasury, folk epics, canonical authors, poems)
- `test_garhwali_places.py` (Panch Kedar, Panch Badri, Panch Prayag, districts, search)
- `test_garhwali_deities.py` (Deity categories, invocations, shrines, search)
- `test_garhwali_surnames.py` (Clans, gotras, historical figures, social concepts)
- `test_garhwali_flora.py` (Ethnobotany, scientific names, habitats, cultural lore)
- `test_garhwali_rituals.py` (Ritual items, implements, vessels, sacred attire)
- `test_garhwali_folklore.py` (Folk songs, verses, translation, digital sources)

---

## 👤 Author & Creator Profile

* **Creator & Author**: **Akshat Singh Bisht**
* **Official Website**: [https://akshatsinghbisht.com/](https://akshatsinghbisht.com/)
* **Email**: [infoakshatsinghbisht@gmail.com](mailto:infoakshatsinghbisht@gmail.com)
* **LinkedIn**: [Akshat Singh Bisht on LinkedIn](https://www.linkedin.com/in/akshat-singh-bisht-digital-performance-marketing-specialist/)
* **Amazon Author Profile**: [Akshat Singh Bisht on Amazon](https://www.amazon.com/stores/Akshat-Singh-Bisht/author/B0D5TYDT28?ref=sr_ntt_srch_lnk_1&qid=1789906571&sr=8-1&shoppingPortalEnabled=true)
* **ResearchGate**: [Akshat Bisht on ResearchGate](https://www.researchgate.net/profile/Akshat-Bisht-8)
* **GitHub**: [@infoakshatsinghbisht-eng](https://github.com/infoakshatsinghbisht-eng)
* **Repository**: [https://github.com/infoakshatsinghbisht-eng/garhwali-language-library](https://github.com/infoakshatsinghbisht-eng/garhwali-language-library)
* **PyPI Package**: [https://pypi.org/project/garhwali/](https://pypi.org/project/garhwali/)

---

## 📄 License
This project is licensed under the **MIT License** — dedicated to the computational preservation, linguistic research, and cultural advancement of the Himalayan languages of Uttarakhand.
