Metadata-Version: 2.4
Name: kumaoni
Version: 1.3.0
Summary: Kumaoni (कुमाऊँनी) Language Standard Library: 515,000+ Inflections, Cultural Heritage, Sacred Flora & Temples, and Universal Translation
Home-page: https://github.com/infoakshatsinghbisht-eng/kumaoni-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/kumaoni-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/kumaoni-language-library/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Text Processing :: Linguistic
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: maintainer
Dynamic: requires-python

# Kumaoni (कुमाऊँनी) Language Library for Python

[![Author & Creator](https://img.shields.io/badge/Author%20%26%20Creator-Akshat%20Singh%20Bisht-orange.svg?style=for-the-badge&logo=person)](https://akshatsinghbisht.com/)
[![Website](https://img.shields.io/badge/Official%20Website-akshatsinghbisht.com-blue?style=for-the-badge&logo=googlechrome&logoColor=white)](https://akshatsinghbisht.com/)
[![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/akshat-singh-bisht-digital-performance-marketing-specialist/)
[![ResearchGate](https://img.shields.io/badge/ResearchGate-Publications-00CCBB?style=for-the-badge&logo=researchgate&logoColor=white)](https://www.researchgate.net/profile/Akshat-Bisht-8)
[![Amazon Author](https://img.shields.io/badge/Amazon-Author%20Page-FF9900?style=for-the-badge&logo=amazon&logoColor=white)](https://www.amazon.com/stores/Akshat-Singh-Bisht/author/B0D5TYDT28?ref=sr_ntt_srch_lnk_1&qid=1789906571&sr=8-1&shoppingPortalEnabled=true)
[![GitHub](https://img.shields.io/badge/GitHub-Profile-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/infoakshatsinghbisht-eng)
[![Python](https://img.shields.io/badge/Python-3.8%2B-blue.svg?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/)
[![Tests](https://img.shields.io/badge/Tests-86%20Passing-brightgreen.svg?style=for-the-badge&logo=pytest&logoColor=white)](tests/)
[![Lexicon Forms](https://img.shields.io/badge/Lexicon%20Forms-500%2C000%2B-success.svg?style=for-the-badge)](https://github.com/infoakshatsinghbisht-eng/kumaoni-language-library)
[![Base Lemmas](https://img.shields.io/badge/Base%20Lemmas-8%2C105%2B-blueviolet.svg?style=for-the-badge)](kumaoni/lexicon/data/words.json)
[![Cataloged Books](https://img.shields.io/badge/Cataloged%20Books-409%20Volumes-teal.svg?style=for-the-badge)](kumaoni/culture/data/bibliography.json)
[![Primary Digitized Texts](https://img.shields.io/badge/Primary%20Digitized%20Texts-295%20Texts-darkblue.svg?style=for-the-badge)](data_sources/raw_texts/)

[![Sacred Flora](https://img.shields.io/badge/Sacred%20Flora-43%20Species-forestgreen.svg?style=for-the-badge)](kumaoni/culture/flora.py)

[![Temple Rituals](https://img.shields.io/badge/Temple%20%26%20Rituals-43%20Implements-darkorange.svg?style=for-the-badge)](kumaoni/culture/rituals.py)
[![Sacred Geography](https://img.shields.io/badge/Sacred%20Geography-47%20Places-crimson.svg?style=for-the-badge)](kumaoni/culture/places.py)
[![Surnames & Clans](https://img.shields.io/badge/Surnames%20%26%20Clans-33%20Lineages-indigo.svg?style=for-the-badge)](kumaoni/culture/surnames.py)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](LICENSE)

A standard-library-style Python package for the **Kumaoni language** (कुमाऊँनी / Central Pahari). Designed to be as simple, fast, and comprehensive for Kumaoni as Python's built-in `math` library is for mathematics.

This library empowers developers to build **web applications, mobile apps, educational tools, chatbots**, and perform **universal translation from any language of the world into Kumaoni**.

> 📖 **Full Reference Manual**: Check out [DOCUMENTATION.md](file:///c:/Users/digit_lgfi273/OneDrive/Desktop/kumaoni%20language%20library/DOCUMENTATION.md) for the exhaustive guide, complete API references, grammatical rules, and application recipes.

---

## 🌟 Key Features

1. **Universal Multi-Language Translator**
   - Translate from **any world language** (English, French, Spanish, German, Japanese, Russian, Arabic, Hindi, Bengali, etc.) into Kumaoni.
   - Multi-tiered architecture: Offline rule-based engine + Zero-key universal world language bridge + Neural AI adapter (Gemini / OpenAI).

2. **Morphological Verb Conjugation & Syntax Engine**
   - Automatically conjugates regular and irregular Kumaoni verbs (e.g., `खाण` to eat, `जाण` to go, `करण` to do, `रौण` to stay, `हिटण` to walk, `मरण` to die, `बगण` to flow).
   - Handles tenses (Present, Past, Future, Continuous, Past Continuous `खाण लाग्यो छ्यो`), Habitual Past (`habitual_past` - `खांदो`, `खांदी`, `खांदा`), Presumptive Mood (`presumptive` - `खाणो होलो`, `गयो होलो`), person (1st, 2nd, 3rd), gender (Masculine/Feminine), and honorific forms.
   - **Presumptive & Epistemic Potential Mood** (`presumptive_verb`, `presumptive_clause`, `is_presumptive` - inferential conjecture and epistemic presumption in `-नो/-नी/-ना` or `-ओ/-ई/-या` + copula `होलो/होली/होला/होलूँ` e.g. `ऊ पढनो होलो।`, `चेली गीत गानी होली।`, `ऊ घर गयो होलो।`, `ईजा आई होली।` - Sir George Grierson 1916 & Dr. D. D. Sharma 1987).
   - **Deontic & Compulsive Obligative Modality** (`obligative_verb`, `obligative_clause`, `is_obligative` - dative agent obligation and moral necessity in infinitive `-ण/-णो` + `पड़न्छ/पड़ो/पड़लो` or `चैये` e.g. `मैंकणी जाण पड़न्छ।`, `उकणी अल्मोड़ा जाण पड़ो।`, `तुमकणी भोल औण पड़लो।`, `हमकणी सच बोलणो चैये।` - Rev. S. H. Kellogg 1893 & Dr. Trilochan Pandey 1977).
   - **Dative Subject Experiencer & Cognitive Predicates** (`dative_subject`, `experiencer_clause`, `dative_knowledge_clause` - physiological/emotional state predicates e.g. `मैंकणी भ्योक लागी छ`, `उकणी त्यास लागी`, `हमकणी जाड़ लागो`, and abilitative knowledge expressions e.g. `मैंकणी कुमाऊँनी आँछ`, `उकणी गीत गाण आँछ` - Sir George Abraham Grierson 1916 & Dr. D. D. Sharma 1987).
   - **Inceptive Aspect & Phrasal Auxiliary with 'लागण'** (`inceptive_verb`, `inceptive_clause`, `is_inceptive` - synthetic inceptive action marker in `-ण + लागण` e.g. `पाणि बरसण लागो`, `ऊ रोण लागी`, `लोग हँसण लागा`, `राधा गीत गाण लागी` - Rev. S. H. Kellogg 1893 & Dr. D. D. Sharma 1987).
   - **Deliberative & Consultative Subjunctive Mood** (`deliberative_verb`, `deliberative_question`, `hortative_proposal` - consultative questions e.g. `मैं के करूँ?`, `हम कबे हिँडौं?`, `मैं घर जाऊँ?` and collaborative invitations `चालो, घर जाऔं!`, `चालो, काज करौं!` - Samuel H. Kellogg 1893 & Sir George Grierson 1916).
   - **Purposive Spatial Supine & Allative Infinitive** (`purposive_supine`, `supine_motion_clause`, `is_supine` - synthetic motion-toward-action marker in `-णै` e.g. `घास कापणै गयो`, `पाणि भरणै गई`, `काफल तोडणै जाला`, `पढणै आयो` - Rev. S. H. Kellogg 1893 & Dr. D. D. Sharma 1987).
   - **Synthetic Passive Verb Derivation** (`synthetic_passive` - `मारिण`, `खाइण`, `देखिण`, `सुणिण`, `बोलिण`, `करिण` - Dr. Siddheshwar Varma 1978).
   - **Iterative / Frequentative Conjunctive Participle** (`iterative_conjunctive` - `हिटि-हिटिबेर`, `खाई-खाईबेर`, `देखी-देखीबेर`, `सोची-सोचीबेर` - Dr. D.D. Sharma 1987).
   - **Echo-Word Reduplication & Decompounder** (`echo_word`, `split_echo_word` - `भात-शात`, `पाणि-शाणि`, `रोटी-वोटी`).
   - **Emphatic Focus & Additive Clitics** (`emphatic_clitic` - exclusive `घरै`, `आजै`, `अबै` vs inclusive `घरौ`, `आजौ`, `हमौ`).
   - **Honorific Respect Particles & Address** (`honorific_address` - `इजाज्यू`, `बाबूज्यू`, `दाज्यू`, `इजाज्यू ठै`, `हो सा`).
   - **Inceptive / Inchoative Aspect** (`inceptive_aspect` - `खाण लागो`, `खाण लागी`, `खाण लागा`, `जाण लागो` - Dr. D.D. Sharma 1987).
   - **Continuative / Stative Aspect** (`continuative_aspect` - `खाँदै रयो`, `खाँदै रै`, `खाँदै रया`, `करदै रयो` - Rev. S. H. Kellogg 1893).
   - **Completive Compound Verb Vectors** (`completive_aspect` - Terminative `-भ्याण` e.g. `खाईभ्यायो`, `करिभ्यायो`; Irreversible Abandonment `-छोडण` e.g. `मारीछोड़ो`, `तोड़ीछोड़ी`; Capability `-सकण` e.g. `खाईसको` - Sir George Grierson 1916 & Dr. Trilochan Pandey 1977).
   - **Optative & Benedictive Mood** (`optative_mood` - blessings & prayers e.g. `भगवान भलो करौ`, `सदा सुखी रया`, `जी रया`, `फलो-फूलो` - Grierson 1916 & Pandey 1977).
   - **Concomitant & Simultaneous Participles** (`concomitant_participle` - simultaneous `-तेरी` e.g. `हिटतेरी`, `खातेरी`, `जातेरी`; immediate punctual `-नै` e.g. `देखनै`, `सुणनै`, `औनै` - Rev. S. H. Kellogg 1893 & Dr. D.D. Sharma 1987).
   - **Indefinite Pronouns & Adverbial Clitics** (`indefinite_pronoun` - `कोइ`, `केइ`, `कतै`, `कबै`, `कसिइ`, `कतुकि` - T. Grahame Bailey 1915 & Grierson 1916).
   - **Additive / Inclusive Focus Enclitic** (`additive_focus_clitic` - `-ल`/`-लै` e.g. `मैंलै`, `तूलै`, `ऊलै`, `हमलै`, `घरैलै`, `आजलै` - Bailey 1915 & Grierson 1916).
   - **Onomatopoeic Reduplication & Sound Symbolism** (`onomatopoeic_reduplication` - `कल-कल`, `झर-झर`, `ठन-ठन`, `धम-धम`, `झिल-मिल`, `सर-सर`, `भक-भक` - Dr. D.D. Sharma 1987 & Dr. Trilochan Pandey 1977).
   - **Evidential & Dubitative Mood** (`dubitative_evidential` - evidential hearsay `गयो खै`, `आयो खै` vs speculative dubitative `औलो क्यां`, `जालो क्यां` - Grierson 1916 & Dr. D.D. Sharma 1987).
   - **Intensive Adjective Reduplication** (`intensive_reduplication` - `रातो-रात`, `कालो-कटुक`, `धौलो-धुत्तु`, `मीठो-मुरमुट`, `तीतो-ततुक`, `ठूलो-ठाठ`, `सीलो-सट्ट`, `तातो-ततुक` - Dr. Siddheshwar Varma 1978 & Dr. Trilochan Pandey 1977).
   - **Approximative & Diminutive Modifiers** (`approximative_modifier` - quantitative `-क` / `-एक` e.g. `कतिक`, `यतिक`, `उतिक`, `थोड़क`, `अलिकति`, `एक-क`, `दश-एक` vs diminutive `-सी` e.g. `नान-सी`, `ठूल-सी`, `मठु-सी`, `रात-सी` - T. Grahame Bailey 1915 & Grierson 1916).
   - **Temporal Connector Clauses** (`temporal_connector` - sequential after `खाए पाछी`, `गए पाछी`, `आए पाछी`, `करे पाछी`; prior before `खाण पैली`, `जाण पैली`, `औण पैली`; duration until `औण तक`, `जाण तक` - Rev. S. H. Kellogg 1893 & Dr. D.D. Sharma 1987).
   - **Quotative & Reportative Clauses** (`quotative_reportative` - complementizer `-भणी` / `-भणिबेर` e.g. `ऊ औलो भणी कयो`, `मैं घर जालूँ भणी सोचो`, `पाणि बरसन लागो भणी सुणो` - Sir George Grierson 1916 & Dr. D.D. Sharma 1987).
   - **Comparative, Superlative & Intensive Degrees** (`comparative_degree` - comparative `रामहैं ठूलो`, `याहैं मीठो`; superlative `सबहैं भलो`, `सबहैं ठूलो`; absolute intensive `बड़ मीठो`, `घण कठिन` - Rev. S. H. Kellogg 1893 & Dr. D.D. Sharma 1987).
   - **Iterative & Reduplicative Adverbs** (`iterative_reduplicative_adverb` - continuous manner `मठु-मठु`, `धिरै-धिरै`, `बेग-बेग`, `साँच-साँच`; temporal frequency `घरि-घरि`, `दिन-दिन`, `ब्याले-ब्याले`, `सबै-सबै`; spatial repetition `डांड-डांड`, `घर-घर`, `गाँव-गाँव` - Rev. S. H. Kellogg 1893 & Dr. D.D. Sharma 1987).
   - **Concessive Complex Clauses** (`concessive_clause` - conditional concessive `भले पाणि बरसो, तैले मैं जालूँ।`; classical `यद्यपि ऊ दुर्बल छ, तैले काम करलो।`; enclitic `कहे तैले नी सुणो।` - Pt. Ganga Datt Upreti 1894 & Dr. D.D. Sharma 1987).
   - **Purposive Infinitival Clauses** (`purposive_clause` - infinitival purpose `खाण कणी आयो`, `जाण कै उठो`, `करण हुणि`, `पढण खातिर गयो` - Sir George Grierson 1916 & Rev. S. H. Kellogg 1893).
   - **Equative & Manner Clauses** (`manner_clause` - equative similes `बाघ जसो बळवान`, `बर्फ जसि धौलि`, `फूल जसो कोमल`; pronominal manner `या जसो`, `उ जसो`, `तु जसो` - Rev. S. H. Kellogg 1893 & Dr. D.D. Sharma 1987).
   - **Durative & Participial Adverbs** (`participial_adverb` - simultaneous action `खांदै-खांदै`, `हिटदै-हिटदै`, `रोन्दै-रोन्दै`, `हंसदै-हंसदै`; matrix action `हिटदै-हिटदै थक्यो` - Rev. S. H. Kellogg 1893 & Dr. D.D. Sharma 1987).
   - **Counterfactual Past Conditionals** (`counterfactual_past` - unfulfilled past conditions `जै तू औंदो, त मैं जाँदो।`, `जै पाणि बरसंदो, त फसल भली हुँदी।` - Rev. S. H. Kellogg 1893 & Sir George Grierson 1916).
   - **Proportional Correlatives** (`proportional_correlative` - progressive proportional clauses `जतुक मिहनत करला, ततुक फल पाला।`, `जितुक घाम लागलो, तितुक तातो होलो।`, `जतु खाला, तितु पचै सकला।` - Rev. S. H. Kellogg 1893 & Dr. D. D. Sharma 1987).
   - **Adversative & Disjunctive Coordination** (`adversative_coordination` - disjunctive and adversative coordinating syntax `तू जा, नी त ऊ औलो।`, `मिहनत करो, नी त नुकसान होलो।`, `भलो छ, पण कठिन छ।`, `बिमार छ्यो, तब लै काम कर्यो।` - Rev. S. H. Kellogg 1893 & Dr. D. D. Sharma 1987).
   - **Distributive Numerals & Quantitative Reduplication** (`distributive_numeral` - distributive counting `एक-एक रोटी`, `दु-दु किताब`, `पाँच-पाँच`, `दश-दश रुप्या`, `आध-आध सेब`, `थोड़-थोड़` - Rev. S. H. Kellogg 1893 & Dr. D. D. Sharma 1987).
   - **Attributive Past Participial Adjectives** (`attributive_participle` - adjective agreement in number and gender `पाको काफल`, `पक्या काफल`, `पाकी खुमानी`, `सुत्यो बालक`, `सुत्या बालक`, `सुती चेली`, `मर्यो बांदर`, `फूटी गागरी` - Sir George Grierson 1916 & Dr. D. D. Sharma 1987).
   - **Temporal Correlatives** (`temporal_correlative` - duration and temporal limit correlatives `जब तक तू रौला, तब तक मैं रौलूँ।`, `जाब तक पाणि बरसो, ताब तक घर रया।`, `जब तलक काम नी भयो, तब तलक झनि जाया।`, `जैल तक घाम छ, तैल तक हिंडा।` - Sir George Grierson 1916 & Dr. D. D. Sharma 1987).
   - **Evaluative Infinitival Constructions** (`evaluative_infinitival` - locative verbal noun with qualitative attribute `खाण म मीठो`, `देखण म भलो`, `करण म सजिलो`, `बोलण म मधुर`, `हिटण म कठिन`, `पढण म सरल` - Sir George Grierson 1916 & Dr. D. D. Sharma 1987).
   - **Limitative & Restrictive Constructions** (`limitative_restrictive` - restrictive syntax `पाणि रौत`, `भात रौत`, `खाली पाणि`, `खोल्ली दूध`, `एक दिन मात्र`, `योइच` - Sir George Grierson 1916 & Dr. D. D. Sharma 1987).
   - **Directional & Allative Postpositions** (`directional_allative` - motion and orientation towards landmark `घर कानि`, `पहाड़ कानि`, `बाजार कानि`, `उत्तर बगै`, `डाँड़ बगै`, `स्कूल तर्फ` - Sir George Grierson 1916 & Dr. D. D. Sharma 1987).
   - **Frequentative & Habitual Auxiliary Aspect** (`frequentative_aspect` - habitual auxiliary constructions with `करण` / `करो` e.g. `खायो करण`, `खाया करो`, `पढ्यो करण`, `पढ्या करो`, `हिट्या करो`, `गयो करण` - Sir George Grierson 1916 & Dr. D. D. Sharma 1987).
   - **Spatial Orientation & Proximity Postpositions** (`spatial_orientation` - hill proximity, trans-montane, and cis-fluvial relational adverbs `नेड़`, `नजीक`, `पार`, `वार`, `दूर` e.g. `घर नेड़`, `गाँव नेड़`, `नदी पार`, `डाँड़ पार`, `नदी वार` - Sir George Grierson 1916 & Rev. S. H. Kellogg 1893).
   - **Comitative & Associative Constructions** (`comitative_clause` - accompaniment and companionship syntax with `दगड़`, `दगड़े`, `सिती`, `संग`, `साथ` e.g. `ईजा दगड़`, `ईजा दगड़े`, `राम सिती`, `मित्र संग`, `ईजा दगड़ हिटण` - Sir George Grierson 1916 & Dr. D. D. Sharma 1987).
   - **Causal & Consequential Clauses** (`causal_clause` - reason, cause, and logical consequence syntax with `किलैकि`, `जैलैकि`, `-ले`, `मारे`, `यैलै` e.g. `ऊ नि आयो किलैकि बिमार छ्यो।`, `जैलैकि पाणि बरसो, तैलै घर रया।`, `बिमार हुणले ऊ नि आयो।`, `डरक मारे काँपण लागो।` - Sir George Grierson 1916 & Rev. S. H. Kellogg 1893).
   - **Permissive & Concessive Aspect** (`permissive_aspect` - permissive verbal compound syntax with auxiliary `दिण` e.g. `खाण दिण`, `जाण दिण`, `जाण दियो`, `जाण दिया`, `बोलण दिया` - Sir George Grierson 1916 & Dr. D. D. Sharma 1987).
   - **Relative Spatial Comparison & Elevation Postpositions** (`spatial_comparative` - relative elevation, depth, and spatial precedence syntax with `माथि`, `तलि`, `भितर`, `भैर`, `पार`, `अगाड़ि`, `पछाड़ि` e.g. `गाँव बटि माथि`, `घर बटि तलि`, `गाँव बटि भैर`, `डाँड़ बटि पार`, `स्कूल बटि अगाड़ि` - Sir George Grierson 1916 & Dr. D. D. Sharma 1987).
   - **Inclinational & Desiderative Constructions** (`inclinational_desiderative` - urge, inclination, and desire to perform an action with `मन्` / `मन` e.g. `खाणो मन् छ`, `जाणो मन् छ`, `जाणो मन् छ्यो`, `खाणो मन् न्ही`, `मैंकणी जाणो मन् छ`, `पढणक मन छ` - Rev. S. H. Kellogg 1893 & Dr. D. D. Sharma 1987).
   - **Animate Locative & Allative Relations** (`animate_locative` - presence at or motion toward human/animate reference points with `ठै`, `हाँ`, `कहाँ`, `पाख` e.g. `ईजा ठै`, `दाज्यू ठै`, `ईजा हाँ`, `पण्डितजी कहाँ`, `डॉक्टर ठै जाण`, `पण्डितजी ठै रौण` - Sir George Grierson 1916 & Dr. D. D. Sharma 1987).
   - **Passive-Instrumental Agent Constructions** (`agentive_passive` - marking personal agent with `-क हाथि`, `-क हाथ`, `-क द्वारा` e.g. `रामक हाथि काम भयो`, `ईजाक हाथि भात बण्यो`, `मास्साबक हाथ चिट्ठी लेखी`, `सरकारक द्वारा सड़क बणी` - Sir George Grierson 1916 & Dr. D. D. Sharma 1987).
   - **Habitual Agentive Participles** (`habitual_agent` - habitual nouns and tendencies with `-णिया` / `-न्या` / `-वाल` e.g. `बोलणिया`, `हिटणिया`, `खाणिया`, `रोणिया`, `हंसणिया`, `पढणिया`, `बोलन्या`, `बोलणि` - Rev. S. H. Kellogg 1893 & Dr. D. D. Sharma 1987).
   - **Similative Manner Comparisons** (`similative_manner` - similes and manner modification with `जसो` / `जसा` / `जसि` / `जै` / `कस` e.g. `चाँद जसो`, `फूल जसो`, `ईजा जसि`, `तारा जसा`, `म्यर जसो`, `त्यर जसो`, `फूल जै` - Sir George Grierson 1916 & Dr. D. D. Sharma 1987).
   - **Dative Experiencer Constructions** (`experiencer_dative` - involuntary sensations, psychological states, hunger, cold, ailments with dative `-कणी` / `-णी` e.g. `मैंकणी भूख लागी`, `रामकणी जाड़ लागो`, `ईजाकणी खुसी भई`, `तूकणी नींद आन्छ`, `हमकणी तिस लागी` - Rev. S. H. Kellogg 1893 & Sir George Grierson 1916).
   - **Infinitival Oblique Verbal Nouns** (`infinitival_oblique` - gerundial case inflection before postpositions e.g. `खाणा कणी`, `जाणा कणी`, `खाणा ले`, `बोलणा म`, `जाणा बटि`, `पढणा को` - Sir George Grierson 1916 & Dr. D. D. Sharma 1987).
   - **Anterior Sequential Participles** (`anterior_sequential` - immediate anteriority with `-बेर` / `-कन` e.g. `खाईबेर`, `जाईबेर`, `करिबेर`, `सुणिबेर`, `देखिबेर`, `खाइकन` - Rev. S. H. Kellogg 1893 & Grierson 1916).
   - **Iterative & Echo Reduplication** (`iterative_reduplication` - distributive and manner reduplication `ठुल-ठुल`, `नान-नान`, `धिरै-धिरै`, continuous participle `खाँदा-खाँदा`, `जाँदा-जाँदा`, expressive echo pairs `रोटी-वोटी`, `चा-वा`, `भात-सात`, `पाणि-शाणि` - Sir George Grierson 1916 & Dr. D. D. Sharma 1987).
   - **Motion & Directional Perfective Aspect** (`motion_perfective` - directional and sudden completive aspect with `-गो` / `-गई` / `-ग्या` / `-ग्यो` e.g. `खाई-गो`, `खाई-गई`, `खाई-ग्या`, `गई-गो`, `आई-गो`, `भागी-गो`, `मरी-गो`, `खाई-ग्यो` - Sir George Grierson 1916 & Rev. S. H. Kellogg 1893 §432).
   - **Conative Aspect / Attempted Action** (`conative_aspect` - trial and attempted action with auxiliary `देखण` e.g. `खाण देख्यो`, `खाण देखी`, `खाण देखिया`, `मैले खाण देख्यो`, `रामले जाण देख्यो` - Sir George Grierson 1916 & Dr. D. D. Sharma 1987).
   - **Locative Attributive & Demonyms** (`locative_attributive` - place-origin modifiers and demonyms with `-क` / `-को` / `-इया` / `-वाल` e.g. `पहाड़क फल`, `अल्मोड़क बालमिठाई`, `गाँव को मान्छे`, `डाँड़क घाम`, `अल्मोड़िया`, `पहाड़िया`, `गाँववाल मान्छे` - Rev. S. H. Kellogg 1893 & Grierson 1916).
   - **Abilitative & Potential Mood** (`abilitative_potential` - capability and potentiality auxiliary with `सकण` e.g. `खाई सक्यो`, `खाई सकी`, `खाई सक्या`, `जाई सक्यो`, `करि सक्यो`, `खाई सकछ`, `खाई सकलो`, `मै खाई सक्यूँ`, `राम खाई सक्यो` - Rev. S. H. Kellogg 1893 §432 & Sir George Grierson 1916).
   - **Prohibitive & Negative Imperative Syntax** (`prohibitive_negative_imperative` - authentic Central Pahari prohibitive command syntax with `झनि` / `झन्` / `झिन` e.g. `झनि खा`, `झनि खाया`, `झनि जा`, `झनि जाया`, `झनि कर`, `झनि करा`, `झनि रो`, `झन् बोल`, `झन् सुणा` - Rev. S. H. Kellogg 1893 §430 & Grierson 1916).
   - **Compulsive & Inevitable Future Aspect** (`compulsive_future` - necessitative future syntax with inflected verbal noun in `-णो`/`-णी`/`-णा` + `होलो` and dative subject `-कणी` e.g. `खाणो होलो`, `खाणी होली`, `खाणा होला`, `मैंकणी खाणो होलो`, `रामकणी जाणो होलो`, `तुमकणी करणो होलो` - Rev. S. H. Kellogg 1893 §433 & Sir George Grierson 1916 p. 132).
   - **Ablative Trajectory & Origin Enclitics** (`ablative_trajectory` - spatial origin, waypoints, and transit trajectories with `बटि`, `बटिन`, `हें`, `हैं` e.g. `अल्मोड़ा बटि`, `गाँव बटि शहर`, `पहाड़ बटि धुरा हुइबेर तराई`, `घर बटिन`, `अल्मोड़ा हें` - Rev. S. H. Kellogg 1893 §428 & J. O'B. Beckett 1874).
    - **Reportative Evidential Syntax** (`reportative_evidential` - authentic Central Pahari secondhand hearsay and folk transmission syntax with `कन`, `भणी`, `कूनी` e.g. `ऊ औलो कन`, `पाणि बरसन लागो कन`, `बाघ आयो कन`, `ईजा कूनी ऊ औलो`, `मास्साब कूनी काम करो` - Sir George Grierson 1916 p. 136 & Dr. D. D. Sharma 1987).
    - **Instrumental Means & Tool-Agent Syntax** (`instrumental_means` - physical implement and tool-agent syntax with instrumental postpositions `ले`, `ल`, `हाथि` e.g. `दाँतीले घास कापण`, `कुदालीले खेत जोतण`, `कलमले चिट्ठी लिखण`, `हाथल`, `कलमक हाथि लिखण` - Rev. S. H. Kellogg 1893 §426 & Grierson 1916).
    - **Benefactive & Purposive Syntax** (`benefactive_clause` - authentic Central Pahari benefactive and on-behalf-of syntax with `हुणि`, `हुनि`, `खातिर`, `कणी` e.g. `ईजा हुणि`, `बालक हुणि दूध ल्यायो`, `गाँव खातिर`, `म्यर हुणि`, `त्यर हुणि`, `हमार हुणि` - Pt. Govind Ballabh Pant 1922 §6 & Rev. S. H. Kellogg 1893 §435).
    - **Interrogative Tag & Confirmation Clitics** (`interrogative_tag` - authentic Central Pahari confirmation question tags seeking validation with `ना`, `कि`, `खै`, `होला` e.g. `तू घर जाँदै छे, ना?`, `ऊ आयो कि?`, `काम भयो खै?`, `भात खायो, ना?`, `घाम लागलो होला?` - Sir George Grierson 1916 p. 126 & Dr. D. D. Sharma 1987).
    - **Purposive Motion & Translocative Horizon Syntax** (`purposive_motion` - authentic Central Pahari purposive motion auxiliary combining infinitives in `-ण` with motion verbs `गयो`/`गई`/`ग्या` or `आयो`/`आई`/`आया` e.g. `भरण गयो`, `कापण गई`, `देखण ग्या`, `खाण आयो`, `ईजा भरण गई`, `बालक पढण गयो` - Rev. S. H. Kellogg 1893 §436 & Grierson 1916 p. 129).
    - **Similative Equative Particle Syntax** (`similative_equative` - authentic Central Pahari equative and resembling syntax with gender/number-agreeing particle `जौंक`/`जौंका`/`जौंकि` e.g. `चाँद जौंक`, `फूल जौंक`, `बर्फ जौंकि`, `तारा जौंका`, `बिजली जौंकि`, `बाघ जौंक` - Sir George Grierson 1916 p. 124 & Dr. D. D. Sharma 1987 p. 142).
    - **Habitual & Frequentative Compound Verbs** (`habitual_frequentative` - authentic Central Pahari habitual syntax combining verbal nouns in `-णो`/`-नो` with auxiliary `करण` e.g. `जाणो करण`, `पढणो करँछ`, `करणो कर्यो`, `देखणो करी`, `औणो कर्या`, `बोलणो करलो`, `बालक पढणो करँछ` - Sir George Grierson 1916 p. 131 & Dr. D. D. Sharma 1987 p. 217).
    - **Dubitative & Speculative Modality Syntax** (`dubitative_speculation` - authentic Central Pahari epistemic doubt and speculative presumption with particle `क्यां` or agreement marker `होलो`/`होली`/`होला` e.g. `क्यां ऊ आलो`, `क्यां घाम लागलो`, `क्यां सच हो`, `ऊ घर पुजिगो होलो`, `ईजा आलि होली`, `सब आया होला` - Sir George Grierson 1916 p. 133 & Dr. D. D. Sharma 1987 p. 154).
    - **Contrafactual & Past Conditional Clauses** (`contrafactual_conditional` - authentic Central Pahari unfulfilled conditional syntax with participle in `-तो`/`-ती`/`-ता` e.g. `जै औंतो, त खाँतो`, `जै जाँती, त देखंती`, `जै बालक पढंतो, त पास हुंतो`, `जै औंता, त मिलंता`, `जै पाणि बरसतो, त फसल भली हुंती` - Sir George Grierson 1916 p. 130 & Dr. D. D. Sharma 1987 p. 156).
    - **Purposive Infinitive Syntax** (`purposive_infinitive` - authentic Central Pahari purposive infinitive constructions with `-कणी` / `-हुणि` / `-खातिर` e.g. `देखण कणी`, `खाण कणी`, `पढण हुणि`, `पाणि भरण कणी`, `बालक पढण कणी आयो`, `घास कापण खातिर` - Rev. S. H. Kellogg 1893 §436 & Grierson 1916 p. 129).
    - **Cohortative & Hortative 1st-Person Imperatives** (`cohortative_imperative` - authentic Central Pahari 1st-person plural cohortative imperative in `-ऊं`/`-ऊँ`/`-औं` with motion prefixes `हिँडो`/`चालो` e.g. `जाऊँ`, `खाऊँ`, `चालो करूँ`, `हिँडो देखूँ`, `बोलूँ`, `चालो काम करूँ` - Sir George Grierson 1916 p. 127 & Rev. S. H. Kellogg 1893 §430).
    - **Distributive Nominal & Adverbial Reduplication** (`distributive_reduplication` - authentic Central Pahari distributive iteration expressing 'in every / from each' with optional locative marker `म` e.g. `गाँव-गाँव`, `घर-घर`, `गाँव-गाँव म`, `खेत-खेत`, `डाली-डाली`, `साल-साल`, `दिन-दिन` - Sir George Grierson 1916 p. 124 & Dr. D. D. Sharma 1987 p. 148).
    - **Aversive & Preventative Apprehensive Syntax** (`aversive_preventative` - authentic Central Pahari warning or apprehensive syntax with `न तर` / `नै तर` / `कथै` e.g. `जल्दी चाल, न तर गाड़ी छूटी जालि`, `संभालिबेर हिट, न तर खसि जाला`, `दवाई खा, नै तर रोग बढि जालो`, `छातो लै जा, कथै पाणि जन बरसो` - Sir George Grierson 1916 p. 129 & Dr. D. D. Sharma 1987 p. 156).
    - **Destinative & Benefactive Postpositional Syntax** (`destinative_postposition` - authentic Central Pahari intended recipient/purpose syntax with `-खातिर` / `-हुणि` / `-लागि` / `-कणी` e.g. `ईजा खातिर`, `ऊ ईजा खातिर फल ल्यायो`, `बालक हुणि दूध दियो`, `पहाड़ लागि`, `हमरा हुणि`, `मेरा खातिर`, `सबनले गाँव कणी काम कर्यो` - Sir George Grierson 1916 p. 115 & Dr. D. D. Sharma 1987 p. 138).
    - **Impersonal & Abilitative Passive of Inability** (`impersonal_abilitative` - authentic Central Pahari physical incapacity or involuntary ability syntax with ablative agent in `-बटि` / `-ले` and passive in `-इन्छ` e.g. `मैबटि नी हिटिन्छ`, `बुढाबटि नी देखिन्छ`, `उनबटि नी खाइन्छ`, `हामबटि नी करिन्छ`, `मैबटि हिटिन्छ` - Sir George Grierson 1916 p. 128 & Dr. D. D. Sharma 1987 p. 172).
    - **Disjunctive Alternative & Dubitative Choice Syntax** (`alternative_disjunctive` - authentic Central Pahari disjunctive and alternative choice syntax with `कि ... कि`, `या ... या`, `चाहे ... चाहे`, `कि न्ही` e.g. `कि आज आलो, कि भोल आलो`, `कि तू खा, कि मैं खाँछू`, `या काम कर, या घर जा`, `ऊ आलो कि न्ही` - Sir George Grierson 1916 p. 132 & Dr. D. D. Sharma 1987 p. 158).
    - **Iterative & Frequentative Converb Reduplication** (`frequentative_converb` - authentic Central Pahari converb reduplication expressing continuous, prolonged, or habitual action with `-इ-इ बेर` or durative `-दा-दा` e.g. `हिटि-हिटि बेर`, `हिटि-हिटि बेर थकि गयो`, `रोइ-रोइ बेर आँखि सूजी गै`, `खाइ-खाइ बेर`, `हिट्दा-हिट्दा`, `खाँदा-खाँदा अघा गयो`, `हिटिबेर-हिटिबेर` - Sir George Grierson 1916 p. 120 & Rev. S. H. Kellogg 1893 p. 339).
    - **Acquisitive Opportunity Potential Construction** (`acquisitive_potential` - authentic Central Pahari opportunity and permission compound syntax with infinitive in `-ण` + auxiliary `पैण` / `पाण` e.g. `देखण पैण`, `देखण पायो`, `जाण नी पायो`, `जाण नी पैंछ`, `मैले देखण पायो`, `रामले जाण नी पायो`, `उनले खाण पायो` - Sir George Grierson 1916 p. 121 & Rev. S. H. Kellogg 1893 p. 344).
   - **Reflexive & Reciprocal Syntax** (`reflexive_pronoun`, `reflexive_possessive`, `reciprocal_construction` - `आपू`, `आपै`, `आपण`, `आपस म बात करण`).
   - **Dialectal Past Formations** (`dialectal_past` - Central `खायो`, Western `खांदो छो`, Eastern `खायगो`).


   - Complete pronoun declensions across Personal, Demonstrative, Interrogative (`को`/`क्या`), Relative (`जो`), Correlative (`सो`), and Indefinite (`कोइ`/`केइ`) cases.
   - Auxiliary substantive verb (`छ-` / to be) conjugation, Central Kumaoni past substantive forms (`छ्यो` / `छी` / `छ्या` / `छ्यूँ`), negative substantive copula paradigm (`न्ह-` / `न्हूँ`, `न्है`, `न्ह`, `न्हन`, `न्हां` - Grierson 1916), and authentic emphatic clitic attachment (`emphatic` - `म्यरै`, `आजै`, `घरि`, `उई` - Mohan Upreti 1969 & D.D. Sharma 1985).

3. **Kumaoni Numbers & Numerals**
   - Converts any integer (0 to 1,000,000,000+) to Kumaoni words in Devanagari or Romanized script.
   - Converts Kumaoni words back to numbers.
   - Supports ordinals (1st `पैलो`, 2nd `दुसर`, 3rd `तेसर`...), customary fractions (`आधो`, `पाव`, `पौण`, `सवा`, `डेढ़`), and Devanagari numerals (`०१२३४५६७८९`).

4. **100,000+ Words Morphological Paradigm Engine & Lemmatizer**
   - Synthesizes and indexes **455,530+ unique authenticated Kumaoni word forms** across verbal paradigms (Present, Past, Future, Continuous, Imperatives, Causatives, Participles, Agentives), nominal declensions (Direct, Plural, Oblique, Case postpositions bound/spaced, Diminutives, Echo words), and adjectival agreements.
   - Sub-millisecond `kumaoni.lemmatize()` and `kumaoni.analyze()` for inflected surface forms.
   - Seamless dictionary lookups: querying inflected forms like `खान्छू`, `ग्यूँ`, `ईजा कणी`, or `घरबटि` resolves directly to their base lemmas and definitions.

5. **Rich Lexicon & Dictionary (7,531+ Authenticated Base Lemmas)**
   - Search across Kumaoni, English, and Hindi.
   - Sourced from 205 digitized primary source books (>152.7 MB / 145.6+ MB) including A. E. Osmaston's *Forest Flora for Kumaon (1927)*, Kenneth Mason's *Abode of Snow: Himalayan Exploration (1955)*, Sir George Abraham Grierson's *Linguistic Survey of India Vol. 9 Pt. 4: Central Pahari / Kumaoni & Garhwali (1916)*, *A Dictionary of Pahari Dialects (1909)*, Swami Vivekananda's *Lectures from Colombo to Almora (1904)*, Thomas Grahame Bailey's *The Languages of the Northern Himalayas (1908)*, Swami Pranavananda's *Kailash-Manasarovar (1949)*, H. R. Nevill's *Nainital: A Gazetteer (1904)*, Brian H. Hodgson's *Miscellaneous Essays on Himalayan Languages (1880)*, J. F. Duthie's *Flora of the Siwalik and Sub-Himalayan Tracts (1903)*, Bharat Ratna Pt. Govind Ballabh Pant's *Forest Problems in Kumaon (1922)*, J. H. Rivett-Carnac's *Archaeological Notes on Ancient Sculpturings on Rocks in Kumaon (1879)*, J. H. Batten's *Official Reports on the Province of Kumaon (1878)*, J. M. Clay's *Nainital: A Historical Sketch (1928)*, Jim Corbett's *Man-eaters of Kumaon (1944 complete DLI edition)*, Karl Khandalavala's *Pahari Miniature Painting (1958)*, Dr. B. N. Goswamy's *Pahari Paintings of the Nala-Damayanti Theme (1975)*, Edwin T. Atkinson's *Himalayan Gazetteer Vol. XI (1884), Vol. XII (1886) & Vol. X (1882)*, George William Traill's *Statistical Sketch of Kumaon (1851)*, Rev. E. S. Oakley & Tara Dutt Gairola's *Himalayan Folklore (1935)*, Thomas Grahame Bailey's *Linguistic Studies from the Himalayas (1915)*, H. G. Walton's *Almora Gazetteer (1911)*, Dr. S. D. Pant's *The Social Economy of the Himalayans: Kumaon (1935)*, Mahapandit Rahul Sankrityayan's *Himalaya Parichay: Kumaon (1953)*, Dr. Panna Lall's *Kumaun: Local Customs (1920)*, H. W. Tilman & Dr. T. G. Longstaff's *The Ascent of Nanda Devi (1937)*, Dr. B. P. Saksena's *Historical Papers Relating to Kumaun (1956)*, Charles A. Sherring's *Western Tibet and the British Borderland (1906)*, Bishop Reginald Heber's *Narrative of a Journey through the Upper Provinces of India (1828)*, William Moorcroft & George Trebeck's *Travels in the Himalayan Provinces (1841)*, Esha Basanti Joshi's *Uttar Pradesh District Gazetteers: Almora (1981)*, Grierson's *Linguistic Survey of India*, Pilgrim (Peter Barron)'s *Notes of Wanderings in the Himmala (1844)*, E. C. M. Browne's *Among the Bhotiyas (1900)*, Frank S. Smythe's *The Valley of Flowers (1938)* and *Kamet Conquered (1932)*, George William Traill's *Statistical Report on the Bhotia Mehals of Kamaon (1832)*, Tara Dutt Gairola & Drake-Brockman's *Selected Revenue Decisions of Kumaun (1938)*, Major K. C. Praval's *Valour Triumphs: History of the Kumaon Regiment (1976)*, Deputy Surgeon-General W. Walker's *Angling in the Kumaun Lakes (1888)*, Pt. Badri Datt Pandey's *History of Kumaun (Vol. 1, 1993)* & *Kumaun ka Itihas (1937)*, V. A. Stowell's *Land Tenures of Kumaun (1937)*, Dr. Kanti Prasad Nautiyal's *Archaeology of Kumaon (1969)*, Rev. James Kennedy's *Life and Work in Kumaon (1884)*, J. O. B. Beckett's *Settlement Report (1874)*, Namita Gokhale's *Mountain Echoes (1998)*, Dr. Siddheshwar Varma's *The Pahari Language (1978)*, Strachey & Duthie's *Plants of Kumaon (1906)*, Oakley's *Holy Himalaya (1905)*, Ganga Datt Upreti's *Proverbs & Folklore (1894)*, Dr. Trilochan Pandey's *Kumaoni Bhasha Aur Sahitya (1977)*, Dr. Gunanand Juyal's *Madhya Pahadi Bhasha (1967)*, Rev. S. H. Kellogg's *Grammar (1893)*, and UOU's *Kumaoni Bhasha Sahitya (AECC-K-101)*.
   - Richly categorized by Himalayan wildlife & forest lore (`काकड़`, `घुरड़`, `थार`, `सराव`, `कस्तूरी-मृग`, `भालू-खोड़`, `गुलदार`, `बाघ-डगर`, `लंगूर-हूक`, `पग-मार्क`, `माचाण`, `शिकारी-बाण`, `बाण-पथ`, `ढाब`, `गहना`, `डबका`), high alpine flora & glaciers (`फेन-कमल`, `कस्तूरी-कमल`, `नील-पोस्त`, `ब्रह्म-कमल-फूल`, `पदम-पंखुड़ी`, `धूंपी`, `भोज-पत्र-वन`, `कनक-फूल`, `बर्फानी-घास`, `हिमानी-धारा`, `हिमोढ़`, `हिम-दरार`, `हिम-शिखर`, `हिम-पात`, `बर्फ-आंधी`, `कड़ाक`, `तुषार-पात`, `कुहासा`, `धुंधली`, `मेघ-गर्जन`), travel, porters & brides (`झांपान-सवार`, `डांडी-सवार`, `पिट्ठू-भार`, `डाक-बंगला`, `चट्टी`, `सराय`, `घाट-नौका`, `झूला-पुल`, `सांगो`, `काठ-पुल`, `बाटा-कंडार`, `बाटा-छाप`, `पथिक`, `अगुवा`, `डाक-हरकारा`, `घंटी-नाद`, `खच्चर-कतार`, `बोझिया`, `पहाड़ी-लाठी`, `कंठ-हार`, `हँसुली-गहना`, `नथ-गहना`, `पौंछी-कंगन`, `झुमके-बाली`, `मुरकी`, `कंडूला`, `धागुल`, `बिछुआ`, `रंग्वाली`, `पिछौड़ा-वस्त्र`, `घाघरा`, `आँगड़ी`), trans-Himalayan commerce & alpine passes (`धुरा`, `बगड़`, `चुंग`, `दस्पाति`, `पांखी`, `थुलमा`, `चुटकै`, `दन`, `झब्बू`, `जुब्बू`, `गियाक`, `लोधी`, `कुथ`, `जम्बू`, `गंदरायणी`, `कटुकी`, `फरण`, `मावा`, `सांग्या`, `हुणिया`, `हुंडेश`), hill limnology & ichthyology (`महासीर`, `असेला`, `डांगी`, `मांझी`, `बंसी`, `ताल`), martial traditions & ballads (`रणबंका`, `नाद`, `नगाड़ा`, `निशान`, `रणसिंगा`, `रणभूमि`, `हुड़का`, `हुड़किया`, `डंगरिया`, `जागरिया`, `वीर-गाथा`), customary land tenures & irrigation (`संजायत`, `सिरतान`, `खायकर`, `हिस्यादार`, `रोत`, `जागीर`, `दस्तूर`, `सयाना`, `बूढ़ा`, `जमींदार`, `मालगुजार`, `पड़ताल`, `खसरा`, `खतौनी`, `मुआफी`, `तामपत्र`, `शिलापट्ट`, `गूल`, `उखाड़`, `तलाव`, `खील`, `हिस्यादारी`), mountain architecture & implements (`धौली`, `काली-माटी`, `कठिया`, `सिंमार`, `गाड़-गदेर`, `धारे-नौले`, `चौखट`, `खोली`, `पैंथा`, `टिबारे`, `घट्ट`, `घटवार`, `पुंगड़ा`, `क्यारी`, `रोपण`, `हल्या`, `बैल-जोत`, `जुवा`, `हल`, `फाल`, `मैय`, `दंत्याव`, `कुटला`, `कुदाल`, `बसुला`, `रंदा`, `दातुली`, `आंसी`, `किलामो`, `गौशाल`, `गोठ`, `चाख`, `मंजुल`, `पाथरी`, `ढुंगा`, `गारा`, `काठ`, `चीड़-काठ`, `देवदार-काठ`, `सुरई`, `मोहरू`, `खर्सू`, `बांज-काठ`, `अंगू-काठ`), mountain grains & wild foods (`भंगजीरा`, `जख्या`, `गौहत`, `भट्ट`, `रांगी`, `मडुवा-आटा`, `झंगोरा`, `कौणी`, `चीना`, `उवा`, `फाफर`, `ओगल`, `चौलाई`, `रामदाना`, `पिनालू`, `गाबा`, `गेठी`, `तरूड़`, `लिंगुड़ा`, `कंडाली`, `तिमिला`, `बेदू-फल`, `हिसालू-फल`, `काफल-फल`, `घिघारू-फल`, `मलू`), and dairy vessels & measures (`पतरोल`, `दौणी`, `ठेकी`, `मथणी`, `नेती`, `पल्ले`, `नाली`, `दूण`, `बिशी`).
   - Sourced and enriched with core poetic terms from the *Kumaoni Digital Heritage Corpus* and complete song verses (`मैता`, `हियो`, `नराई`, `जुन्याली`, `दगड़िया`, `बाना`, `जोबन`, `फाग`, `चीर`, `दमुवां`, `अबीर`, `चुनर`, `छैला`, `सिलिंग`, `लिबोंग`, `पाती`, `झुरण`, `पीर`, `सुरति`, `कजला`, `मुखड़ी`, `बैरी`, `बण`, `छ्वोरी`, `पधान`, `झुमुका`, `नथुली`, `पौंछी`, `हंसुली`, `घस्यारी`, `रोपाई`, `कौतुक`, `झोड़ा`, `चाँचरी`, `छपेली`, `न्योली`, `हुड़को`, `बाँसुरी`, `मुरुलि`, `ककड़ी`, `लौंग`, `पिछौड़ा`, `बुराँश`, `फ्यूँली`, `घस्यारी-गीत`, `रौंक`).
   - Enriched with **traditional folk musical instruments & performance** (`हुड़का`, `दमुवां`, `रणसिंगा`, `तुरही`, `डौंर`, `कांसी की थाली`, `मसकबीन`, `मोचंग`, `हुड़किया`, `डांगरिया`, `जागरिया`), **marriage ceremonies & rituals** (`ब्यो` / `ब्याह`, `जन्यांत`, `जंत`, `जन्यांती`, `धुलिअर्घ`, `पिथ्याँ`, `रंग्वाली पिछौड़ा`, `अंचल`, `रतजगा`, `मातृका पूजा`, `शकुनाखर`, `भातखाई`, `गौना`, `सौरास`, `मैत`, `दामकाज`), **extended kinship, family & social relations** (`बड़ाबाबु`, `बड़ीईजा`, `काका`, `काकी`, `मामा`, `मामी`, `मौसा`, `मौसी`, `फुफा`, `फूफू`, `भाणज`, `भाणजी`, `सौर्या`, `सासू`, `जेठ`, `जेठानी`, `देवर`, `देवरानी`, `नणद`, `नंदोई`, `साला`, `साली`, `साढू`, `गौंत्यार`, `हितैषी`, `नातेदार`, `कुटुंब`, `खानदान`, `ब्वारी`, `ज्वै`, `सैं`, `दाजु`, `बौजू`, `बैणी`, `भै`), **sacred Himalayan geography** (`धाम`, `देवाल`, `मन्दिरा`, `थान`, `द्युप्त`, `नौला`, `धारा`, `कुंड`, `संगम`, `प्रयाग`, `तीरथ`, `परिक्रमा`, `जात`, `डोलि`, `निशान`, `हिमनद`, `डांडा`, `धुरा`), and **historical Kumaoni surnames & clans** (`पंत`, `जोशी`, `पाण्डे`, `उप्रेती`, `तिवारी`, `पाठक`, `भट्ट`, `बिष्ट`, `रावत`, `नेगी`, `मेहरा`, `फर्त्याल`, `भंडारी`, `कार्की`, `रौतेला`, `मनराल`, `बोरा`, `अधिकारी`, `मेहता`, `दानू`, `कोरंगा`, `पांगती`, `मर्तोलिया`, `टम्टा`, `आर्य`).
   - Phonetic Latin transliteration and Devanagari script normalization.

6. **Folklore, Folk Songs & Classical Holi Corpus (20 Songs, 20 Holi Songs & 8 Digital Archives)**
   - **20 Traditional & Recorded Folk Songs (`KSN-0001` to `KSN-0020`)**: Complete multi-stanza authentic lyrics, Devanagari verses, English translations, cultural context, and themes (*Bedu Pako Baro Masa*, *Ghughuti Na Basa*, *Kafal Pako Chait*, *Myar Shobhani Hosyaara*, *Teri Khuti Meri Salaam*, *Maathu Maathu Hitaili Meri Baana*, *Yo Baato Ka Jaanya*, *Jhan Diya Bojyoon Chhaana Bilori*, Gopal Babu Goswami classics: *Kaile Baaji Muruli*, *Haay Teri Rumaala*, *Chhooti Ge Nainitaal*, *O Bhina Kasak*, etc.).
   - **20 Classical Kumaoni Holi Songs (`KHL-0001` to `KHL-0020`)**: Preserved across *Baithaki Holi*, *Khadi Holi*, and *Mahila Holi* mapped to classical Hindustani raags (*Khamaj*, *Kafi*, *Dhrupad/Dhamar*, *Desh/Sorath*, *Bhairavi*, *Pilu*, *Bihag*, *Yaman*, *Jhinjhoti*, *Kalyan*).
   - **8 Active Digital Heritage Archives (`SRC-001` to `SRC-008`)**: Cataloguing primary repositories including *Internet Archive Kumaoni & Pahari Primary Texts*, *Kumauni Archives*, *Kumaoni Holi Archive*, *Kumauni.in*, *Uttarakhand Library Hub*, *Open Library*, *Google Books*, and *Creative Uttarakhand*.

7. **Local Deities of Kumaon (40 Supreme Gods & Goddesses / लोक देवी-देवता)**
   - Dedicated programmatic registry `kumaoni.deities` with complete oral history, shrines, iconography, and invocation jagars across 5 categories:
     - **Nyaya Devta (Gods of Justice)**: *Golu Devta* (Chitai, Ghorakhal, Chamarkhan), *Kotgari Devi* (Pankhu, Thal).
     - **Kuldevi / Shakti (Mother Goddesses)**: *Nanda Devi & Sunanda Devi* (Almora, Nanda Kot), *Maa Barahi Devi* (Devidhura), *Maa Purnagiri Devi* (Tanakpur), *Kasar Devi* (Almora), *Jhula Devi* (Ranikhet), *Naina Devi* (Nainital), *Kot Bhramari* (Baijnath / Garur), *Dunagiri Devi* (Dwarahat), *Syahi Devi* (Shitlakhet).
     - **Gram Devta & Kshetrapal (Territorial & Village Guardians)**: *Bhumia Devta* (Universal village hearth guardian), *Bholanath* (Almora), *Kailpal Devta*, *Saim Devta* & *Jhakar Saim*, *Chipla Kedar* (Dharchula alpine tarn), *Gabla Devta* (Johar & Darma passes), *Chhurmal Devta*, *Khandanath*, *Masan Devta*, *Ranbhoot*, *Bhairav Devta*.
     - **Jagar Deities & Heroic Spirits**: *Ganganath* (Katarmal), *Kalbisht / Kaluwa* (Binsar), *Airy Devta*, *Chaumu Devta*, *Lakhia Bhoot* (Sor Hillyatra), *Jiya Rani* (Queen warrior of Ranibagh), *Haru Devta*, *Nagaraja & Panchnag* (Berinag, Sem Mukhem), *Ghatku Devta*, *Narsingh Devta*, *Ainchari* (Fairy nymphs), *Balchan & Dhannar*, *Malushahi & Rajula*.

8. **Traditional Festivals & Historic Melas (40 Major Celebrations)**
   - Full calendar details, rituals, regional significance, and search via `kumaoni.festivals.search(q)`:
     - *Harela*, *Phool Dei*, *Ghughutiya / Uttarayani Mela*, *Olgia / Ghee Sankranti*, *Nanda Devi Mela*, *Khatarwa*, *Saatu-Aathu (Gaura-Mahesh)*, *Bagwal of Devidhura*, *Syalde-Bikhoti (Dwarahat)*, *Jageshwar Shravani Mela*, *Purnagiri Mela*, *Kainchi Dham Mela (15 June)*, *Kumaoni Baithaki & Khadi Holi*, *Hillyatra (Pithoragarh)*, *Chaitol*, *Somnath Mela (Masi)*, *Chhipla Jaat*, *Bagnath Shivratri Mela*, *Kailpal Mela*, *Nanda Raj Jaat*, *Kandali Festival (Chaudas 12-yr bloom)*, *Jauljibi Mela (Indo-Tibetan-Nepali confluence)*, *Thal Mela (Baisakhi)*, *Gananath Mela (Kartik Purnima fertility vigils)*, *Chaiti Mela (Kashipur)*, *Mostamanu Mela (Pithoragarh rain god)*, *Bhitauli (Chaitra sisters gift)*, *Janopunyu (Raksha Bandhan)*, *Vat Savitri*, *Basant Panchami*, *Kot Bhramari Mela*, *Chitai Golu Mela*, *Ganga Dussehra*, *Kumaoni Diwali Bhelo*, *Dronagiri Mela*, *Devidhura Ashtami*, *Ghantakarna Mela*, *Malushahi Mela*, *Berinag Nagpanchami*, *Rung Kirji & Gabla Puja*.

9. **Sacred Geography, Temples & Himalayan Landscape (47 Sacred Places)**
   - Complete architectural, spiritual, and geographical registry via `kumaoni.places`:
     - **Temples & Sacred Dhams (22 shrines)**: *Jageshwar Dham* (124 stone temples, 8th Jyotirlinga), *Baijnath*, *Bagnath* (Saryu-Gomti confluence), *Patal Bhuvaneshwar* (subterranean cave), *Chitai Golu Devta* (temple of bells and justice), *Katarmal Sun Temple* (Bara Aditya), *Kasar Devi* (Crank's Ridge geomagnetic belt), *Haat Kalika Gangolihat*, *Maa Barahi Devidhura*, *Maa Purnagiri*, *Kainchi Dham* (Neem Karoli Baba ashram), *Dunagiri*, *Binsar Mahadev*, *Mukteshwar*, *Naina Devi*, *Kot Bhramari*, *Mostamanu*, etc.
     - **Rivers & Holy Sangams (10 waterways)**: *Saryu*, *Gomti*, *Kali / Sharda*, *Gori Ganga*, *Eastern Ramganga*, *Kosi*, *Gaula*, *Bageshwar Sangam*, *Jauljibi Sangam*, *Pancheshwar Sangam*.
     - **Alpine Peaks & Glaciers (7 massifs)**: *Nanda Devi* (7,816m), *Trishul* (7,120m), *Panchachuli* (6,904m), *Om Parvat* (6,191m), *Adi Kailash* (5,945m), *Pindari Glacier*, *Milam Glacier*.
     - **Historic Valleys & Towns (8 centers)**: *Johar Valley*, *Darma Valley*, *Vyas Valley*, *Almora*, *Nainital*, *Champawat*, *Munsyari*, *Dwarahat*.

10. **Kumaoni Surnames, Clans, Lineages & Social Structure (33 Surnames & 8 Social Concepts)**
   - Comprehensive sociological and genealogical registry via `kumaoni.surnames`:
     - **Brahmin Clans**: *Pant* (Jaideo Pant lineage, Shandilya gotra, royal physicians and poets), *Joshi* (Garga/Kaushika gotra, Diwans and astrologers), *Pandey / Pande* (Bharadwaj gotra, preceptors and historians), *Upreti* (Uprara origin, authors and priests), *Tiwari / Tripathi*, *Pathak*, *Bhatt* (Jageshwar temple priests), *Upadhyay*, *Sanwal*, *Kholiya*.
     - **Kshatriya / Rajput Clans**: *Bisht* (Vishisht title, feudal commanders), *Rawat* (feudal chiefs and explorers), *Negi* (military officers holding Neg perquisites), *Mehra / Mahara* (leaders of historic Mahara faction), *Fartyal* (leaders of Fartyal faction), *Bhandari* (treasury custodians, hero Kalu Bhandari), *Karki*, *Rautela* (Chand princes), *Chand* (sovereign dynasty), *Manral* (Katyuri princes), *Bora*, *Adhikari*, *Mehta*, *Danu*, *Koranga*.
     - **Shauka / Alpine Bhotia Clans**: *Pangtey* (Milam/Johar scholars and merchants), *Martolia* (Martoli village beneath Nanda Devi), *Rawat (Johari)* (Pandit Nain Singh Rawat, Survey of India explorer), *Jangpangi*, *Garbiyal*.
     - **Shilpkar & Artisan Clans**: *Tamta* (Almora master coppersmiths & social reform leaders), *Arya* (freedom movement pioneers), *Lohar* (agricultural ironsmiths).
     - **Social Concepts**: *Thaat* (ancestral landed estate), *Thaatwaan* (original landholder), *Dhadha* (factional court alliances), *Gauntyaar* (fellow villagers), *Biraadari* (clan brotherhood), *Gotra*, *Neg-Jog*, *Jajmaani*.

11. **Himalayan Ethnobotany & Sacred Flora (71 Species / हिमालयी वनस्पति व पादप)**
    - Comprehensive botanical, ecological, and spiritual registry via `kumaoni.flora`:
      - **Sacred & Ritual Trees (14 species)**: *Banjh* (Quercus leucotrichophora - mother oak of water aquifers), *Buransh* (Rhododendron arboreum - state tree), *Deodar* (Cedrus deodara - Jageshwar sacred grove), *Panya / Padam* (Prunus cerasoides - hawan samidha), *Surai* (Cupressus torulosa - temple spires), *Bhojpatra* (Betula utilis - sacred birch bark), *Ringal* (Thamnocalamus spathiflorus - Nanda Devi umbrella basketry), *Bheemal* (Grewia optiva - winter fodder & selu ropes), *Pipal*, *Bar / Bargad*, *Utees* (Alnus nepalensis - Himalayan alder), *Semal* (Bombax ceiba - red silk cotton), *Toon* (Toona ciliata - red cedar for temple doors), *Reetha* (Sapindus mukorossi - soapnut cleanser for murtis), *Aanwla* (Phyllanthus emblica - Amla Navami sacred tree).
      - **Sacred Alpine Flowers & Herbs (11 species)**: *Brahmakamal* (Saussurea obvallata - supreme offering to Nanda Devi & Shiva), *Phen Kamal*, *Kasturi Kamal*, *Phyunli* (Reinwardtia indica - spring flower of Phool Dei), *Tulsi* (courtyard chauris), *Bithar / Dhoop* (Juniperus indica - alpine smudge incense), *Guchhi* (Morchella esculenta - wild Himalayan morel), *Dhatura*, *Bhang*, *Kunja* (Himalayan wild white rose), *Genda* (Marigold deity garlands).
      - **Medicinal & High-Altitude Aromatics (11 species)**: *Jatamansi / Balbachh* (Himalayan spikenard incense), *Dhoop-lakdi* (Jurinea macrocephala), *Guggul*, *Gandrayani* (Angelica glauca), *Jambu / Faran* (Allium stracheyi), *Jakhya* (Cleome viscosa), *Kutki* (Picrorhiza kurroa), *Ateesh*, *Chirayata*, *Kapur Kachari* (Hedychium spicatum - perfumed ginger-lily root for hawan), *Harad* (Terminalia chebula), *Baheda* (Terminalia bellirica), *Thuner* (Taxus wallichiana - Himalayan yew).
      - **Wild Mountain Fruits & Shrubs (20 species)**: *Kafal* (Myrica esculenta - iconic spring berry), *Bedu* (Ficus palmata - wild fig), *Timul* (Ficus auriculata - eco-friendly feast leaf plates), *Kilmoda* (Berberis asiatica), *Hisolu* (golden raspberry), *Akhod* (Walnut), *Choolu* (wild apricot temple lamp oil), *Galgal* (mountain lemon), *Daam* (wild sour pomegranate), *Aadu* (peach), *Khumaani* (apricot), *Pulam* (plum), *Maalta* (hill blood orange), *Sisoon / Bichhu Ghas* (stinging nettle), *Gethi* (air potato), *Tarur* (wild forest yam), *Maalu* (camel's foot creeper for leaf plates), *Chyoon* (wild oak mushrooms), *Linguda* (fiddlehead fern).
      - **Sacred Grasses, Millets & Crops (12 species)**: *Kush* (Desmostachya bipinnata - sacrificial Pavitri ring), *Durva / Doob* (Ganesha green shoots), *Jhangora* (Barnyard fasting millet), *Maduwa / Koda* (Finger millet), *Bhatt* (Black soybean), *Bhaang* (Cannabis sativa seeds for chutney & fiber), *Bhangjeera* (Perilla frutescens aromatic seeds), *Gaderi / Pinalu* (Colocasia taro tuber), *Rai / Rayas* (pungent mustard greens), *Kauni* (foxtail millet), *Cheena* (proso millet), *Gahat / Kulath*.

12. **Temple Implements, Sacred Paraphernalia & Rituals (69 Sacred Items / मन्दिर व पूजा सामग्री)**
    - Programmatic cataloguing of temple architecture, vessels, and sacred implements via `kumaoni.rituals`:
      - **Sacred Marks & Consecrated Threads (10 items)**: *Pithyan* (sacred vermilion-turmeric forehead mark), *Akshat* (unbroken raw rice), *Kalawa / Mauli / Rakshasutra* (protective wrist thread), *Janeu / Yajnopavita* (initiatory three-strand thread), *Roli*, *Chandan*, *Bhabhoot / Bhasma* (holy ash from temple dhooni), *Baati* (hand-rolled cotton lamp wick), *Jantar / Taweez* (consecrated protective silver amulet), *Kaali Dori* (consecrated black protective thread for infants).
      - **Vessels & Consecrated Offerings (16 items)**: *Panchapatra* (copper ritual tumbler), *Aachmani* (libation spoon), *Argha* (Shivalinga drip vessel), *Kalash* (Varuna cosmic pot), *Aarti ki Thali*, *Dhoopdani* (brass incense burner), *Rot* (thick wheat-jaggery bhog of Bhumia & Golu), *Panchamrit* (5 sacred elixirs), *Batasha*, *Deewa / Deeyo* (consecrated clay/brass oil lamp), *Dhupeli* (incense brazier), *Kamandal* (ascetic holy water vessel), *Pattal* (leaf plate from Malu leaves), *Dona* (folded leaf cup for panchamrit), *Dhaar* (continuous milk/water libation over Shivalinga), *Tarpan Paatra* (copper libation dish for pitrus).
      - **Hawan & Sacrificial Paraphernalia (7 items)**: *Hawankund* (pyramidal copper altar), *Samidha* (dried twigs of wild cherry, pipal, and oak), *Sruwa* (long carved wooden ghee ladle), *Sruch*, *Kapoor* (pure white camphor ignited during Maha Aarti), *Loban* (purifying benzoin resin), *Guggal* (sacred bdellium gum).
      - **Temple Insignia & Votive Offerings (12 items)**: *Ghant / Ghanti* (temple brass bells, thousands offered at Chitai), *Shankha* (dawn/dusk aarti conch), *Trishul* (sacred iron trident), *Bana / Nishan* (temple processional flag), *Paati* (judicial prayer petitions pinned at Chitai Golu Devta), *Chanwar* (yak-tail whisk), *Chhatra* (silver deity canopy), *Doli* (sacred palanquin), *Jhaanjh* (heavy brass clash-cymbals), *Jhaanjhar* (melodious temple rim cymbals), *Chimta* (Nath yogi sacred tongs), *Dhwaj / Neja* (triangular deity flag and lance).
      - **Jagar & Shamanic Implements (7 items)**: *Hurka* (hourglass drum played by Jagariya), *Daur* (rattle drum), *Kansi ki Thali* (bell-metal plate inducing trance in Dangariya), *Bagambar* (meditation seat), *Saangal* (sacred iron trance chains), *Damru* (hourglass drum of Lord Shiva), *Morpankh Jhaad* (peacock-feather healing blessing whisk).
      - **Sacred Attire & Ornaments (8 items)**: *Rangwali Pichhaura* (traditional dotted saffron stole), *Aanchal* (sacred nuptial knot cloth), *Khadaun* (wooden ritual sandals), *Baagh-Nakh* (silver tiger-claw pendant for children), *Suhaag Pitaari* (wicker bridal cosmetics casket), *Nath / Nathuli* (monumental gold nose ring), *Paunchi* (gold bead velvet bracelet), *Guloband* (traditional gold and velvet choker).
      - **Sacred Water & Sanctum Features (9 items)**: *Naula* (sacred stone spring stepwell with serpent shrine), *Dhaara* (carved stone spout), *Dhooni* (perpetual ascetic ash fire), *Pindi* (natural stone idol), *Thaan* (open-air village hearth shrine), *Dewaal* (stone temple complex), *Gangajal*, *Kusha Asan* (sacred grass seat), *Bhandaar* (consecrated temple storehouse).

13. **School, Jobs, Governance, Home, Crockery, Child Lifecycle & Movement Vocabulary**
    - **School & Education**: *ईस्कूल* (school), *चटशाल* (traditional primary pathshala), *मास्साब* (schoolmaster), *गुरुजी* (preceptor), *च्यला-च्यली* (pupil boy/girl), *पाथरी* (stone slate), *बत्ती* (slate pencil), *दुधि-खड़िया* (white chalk), *मसवाणी* (inkpot), *मसि* (pine lampblack ink), *नरकट* (reed pen), *कागत* (paper), *पोथी* (manuscript), *चोपड़ी* (exercise notebook), *झोली* (satchel), *बस्ता*, *घंटी*, *बांचण* (to read aloud), *घोटण* (to memorize by rote), *परखा* (exam), *गुणी*, *पठवार*.
    - **Jobs, Government Service & Administration**: *सरकारी नौकरी* (coveted government job), *सर्करी नकर* (public servant), *रोजगार*, *तलब* / *तनख्वाह* (monthly salary), *ब्याण* (daily wage), *पैंसन* (pension), *भत्ता* (allowance), *हाकिम* (magistrate), *अफसर* (officer), *पटवारी* (hill revenue & police officer), *कानूनगो*, *बाबू* (office clerk), *मुंशी* (court scribe), *चपरासी* (peon), *कचहरी* (district court), *दफ्तर* (office), *तहसील*, *ठाणा*, *अर्जी* (petition), *दरखास्त* (application), *मिसिल* (court case file), *मोहर* (official seal), *दस्तखत* (signature), *अंगूठा छापो* (thumb impression), *बही-खाता* (ledger), *टिकट* (revenue stamp).
    - **Business, Commerce & Trade**: *ब्यापार* (trade), *कारोबार*, *दुकान*, *बणिया* (grocer), *महाजन* / *साहुकार* (moneylender), *गराक* (customer), *सौदा* (bargain deal), *बयाना* (advance payment), *पूँजी* (capital), *लागत*, *नफा* / *मुनाफा* (profit), *तोटा* / *घाटा* (loss), *उधारी*, *ऋण*, *सूद*, *ब्याज*, *बट्टा* (discount), *तराजू-बाँट* (weighing scale & weights), *शौका ब्यापारी* (historic trans-Himalayan merchant).
    - **Crime, Corruption, Scams & Justice**: *घूस* / *रिश्वत* (bribe), *डाली-भेंट* (customary bureaucratic extortion), *हाथ गरम करण* (to grease palm), *घोटाला* (financial scam), *गोलमाल* (fraudulent foul play), *ठग* (swindler), *ठगी* (swindle), *छल-कपट*, *धोखाधड़ी*, *जालसाजी* (forgery), *हक मारण* (usurping rights), *चूंघण* (extortion), *चोरी*, *चोर*, *डाका* (dacoity), *डकैत*, *लूट-खसोट*, *सेंध मारण* (burglary through wall), *जेबकटो* (pickpocket), *हथकड़ी* (handcuffs), *हवालात* (lockup), *कैदखाना* (jail), *मुलजिम* (accused), *गवाह* / *गवाही*, *फैसला*, *सजा*, *जमानत*.
    - **Home Things, Kitchenware, Utensils & Crockery**: *भाण्ड* / *बासन* (utensils & crockery), *गागर* / *ताँबी* (large hammered copper spring water vessel), *फुंगई* (small brass pitcher), *लोटा*, *मटुको* (earthen clay pot), *हँड़िया* (clay stew pot), *थलिया* (dinner plate), *बटकी* (bell-metal bowl), *डब्बू* (deep ladle), *कड़छी*, *छयो* (flat wooden rice paddle), *तवा*, *कड़ाही*, *चिमटो* (hearth tongs), *सँड़ासी* (pot pincers), *फुकणी* (hearth blowpipe), *सिल-लोटा* (granite grinding stone & roller), *जांतो* (stone rotary quern), *ढीकी* (foot-operated paddy pounder), *ठेकी* (wooden butter-churning cylinder), *मधानी* (churner rod), *नेती* (churning cords), *सुपो* (winnowing scoop), *डलिया*, *डोका* (conical back-basket), *नाम* (tumpline headstrap), *मोष्ट* / *मौहट* (hemp/straw sitting mat), *पीढ़ा* (wooden stool), *चुलहो* (clay kitchen hearth), *ओदान* (iron hearth trivet), *कौलो* (burning embers), *छार* (wood ash), *ताखली* (wall niche), *सन्दूक* (timber heirloom chest), *खाट*, *गूंदड़ो* (patchwork quilt), *तुषक* (mattress), *कुचो* (grass broom), *ताला-कुंजी*, *गोठ* (ground-floor stable), *मांज* (upper residential floor), *तिबारी* (carved balcony).
    - **Children, Infancy, Movements, Baby Rites & Games**: *नान्तिन* (children), *नानिन* (tiny infant), *दूधपितो* (nursing baby), *नानबाबू*, *नानिबेटी*, *दुलारो*, *हियाक टुको* (piece of heart), *चुलबुलो*, *ढीठ*, *गाथुली सरण* (baby crawling on belly), *घुटन हिटण* (crawling on knees), *लडबड हिटण* (taking unsteady first toddler steps), *डगमग हिटण*, *ठुमक-ठुमक हिटण* (joyful toddler stomping steps), *तुत-तुत बोलण* (baby babbling), *तोतलौण* (toddler lisp), *च्याँखटण* (shrill crying), *बिलखण* (sobbing), *राँव-राँव करण* (whimpering), *कोल्यों बैठण* (cuddled in mother's lap), *काँखड़ी लैण* (carrying on hip), *पुठ्याव लैण* (piggyback), *अँगूठो चूसण*, *मुसकौण*, *कुलकुलौण*, *घूघूती बासुती* (clapping rhyme), *निनूड़ी* (cradle lullaby), *न्वाण* (11th-day naming rite), *छठी* (6th-night destiny rite), *पास्नी* / *भात-ख्वाई* (first cereal feeding at 6 months), *ज्यूँड़ कापण* (temple tonsure / mundan), *कान छेकण* (ear piercing), *नजर उतारण* (dispelling evil eye), *कालो टीको*, *गण्डो* (consecrated black thread), *बाघ-नख* (silver tiger claw pendant), *घुघुता* (necklace pastries on Kauva Tyar), *खिलोना* (wooden toy), *भौंरो* (spinning top), *गुल्ली-डण्डा*, *गीटी* (five stones), *बाटी* (marbles), *छुक-छिपाणी* (hide-and-seek).
      - **Jagar & Shamanic Implements (5 items)**: *Hurka* (hourglass drum played by Jagariya), *Daur* (rattle drum), *Kansi ki Thali* (bell-metal plate inducing trance in Dangariya), *Bagambar* (meditation seat), *Saangal* (sacred iron trance chains).
      - **Sacred Water & Sanctum Features (7 items)**: *Naula* (sacred stone spring stepwell with serpent shrine), *Dhaara* (carved stone spout), *Dhooni* (perpetual ascetic ash fire), *Pindi* (natural stone idol), *Thaan* (open-air village hearth shrine), *Dewaal* (stone temple complex), *Gangajal*.
      - **Sacred Attire & Knots (2 items)**: *Rangwali Pichhaura* (traditional dotted saffron stole), *Aanchal* (sacred nuptial knot cloth).

13. **Cultural Treasury & Master Bibliography (अखाण, आणा, लोकगीत, महागाथा & ग्रन्थ-सूची)**
   - **85+ Authentic Proverbs (*Akhaan*)**: From Pt. Ganga Datt Upreti (1894), UOU AECC-K-101 (2020), and living oral lore with literal, figurative, Hindi, and English equivalents.
   - **157+ Authentic Idioms & Folk Phrases (*Muhavare & Batkoli*)**: From oral conversations and UOU syllabus Unit 5.
   - **43+ Traditional Riddles (*Aan / Aana*)**: Folk puzzles with hints, cultural context, and solutions.
   - **129+ Master Catalogued Books & Bibliography**: Programmatic query interface `kumaoni.bibliography`.
   - **20+ Canonical Authors & Scholars**: Biographies and historical profiles.
   - **8 Monumental Folk Epics & Ballads**: *Malushahi-Rajula*, *Ajuva Bafaul*, *Golu Devta*, *Jiya Rani*, *Veer Balak Haru Singh Heet*, *Amar Gopichand Yogi*, *Kalu Bhandari*, and *Ganganath*.

14. **Interactive Developer Playground & CLI**
   - Built-in command line interface (`kumaoni translate`, `kumaoni lookup`, `kumaoni number`, `kumaoni bibliography`).
   - Modern glassmorphism web playground running locally with zero dependencies.

---

## 🚀 Installation

Install via pip directly from PyPI:

```bash
pip install kumaoni
```

Or install from GitHub source in development mode:

```bash
git clone https://github.com/infoakshatsinghbisht-eng/kumaoni-language-library.git
cd kumaoni-language-library
pip install -e .
```

---

## 📖 Quickstart Guide

### 1. Universal Translation

```python
import kumaoni

# Translate from English to Kumaoni
result = kumaoni.translate("Where is the hospital?", source="en")
print(result)            # Output: अस्पताल कतुक दूर छ?
print(result.romanized)  # Output: Aspataal katuk door chha?

# Translate from any world language (e.g., French, Spanish, Hindi)
fr_result = kumaoni.translate("Comment allez-vous?", source="fr")
print(fr_result)         # Output: कस छू तुम?

hi_result = kumaoni.translate("मुझे पानी चाहिए।", source="hi")
print(hi_result)         # Output: मैंकणी पाणि चाही।
```

### 2. Verb Conjugator

```python
import kumaoni
from kumaoni.constants import Tense, Gender

# Conjugate 'जाण' (to go) in the past tense for 1st person
past_form = kumaoni.conjugate("जाण", tense=Tense.PAST, person=1, gender=Gender.MASCULINE)
print(past_form)  # Output: 'ग्यूँ' (I went)

# Conjugate 'खाण' (to eat) in the future tense
future_form = kumaoni.conjugate("खाण", tense=Tense.FUTURE, person=1)
print(future_form)  # Output: 'खालूँ' (I will eat)

# Auxiliary verb 'to be' (छ-)
is_form = kumaoni.conjugate_to_be(tense=Tense.PRESENT, person=3)
print(is_form)  # Output: 'छ' (is)

# Morphological Participles & Agent Nouns
print(kumaoni.conjunctive_participle("खाण"))  # 'खाईबेर' (having eaten)
print(kumaoni.agent_noun("गाण"))              # 'गाण्या' (singer)
print(kumaoni.imperative("औण", polite=True))  # 'आया' (please come)

# Causatives & Compound Verbs
print(kumaoni.causative("करण", degree=1))     # 'करौण' (to make someone do)
print(kumaoni.causative("खाण", degree=1))     # 'खिलाण' (to feed)
print(kumaoni.compound_verb("खाण", "हाल्ण"))  # 'खाईहाल्ण' (to eat up completely)

# Passive & Medio-Passive (Inability with -बटि)
print(kumaoni.passive("करण"))                 # 'कर्यो जान्छ' (is done)
print(kumaoni.medio_passive_inability("मैं", "हिंण")) # 'मैंबटि हिंड्यो नी जाँछ।'

# SOV Sentence Builder & Conditionals
sent = kumaoni.build_sentence(subject="राम", direct_object="भात", verb="खाण")
print(sent)  # 'राम भात खान्छ।'

cond = kumaoni.conditional("बरखा होली", "हम घर म रौला")
print(cond)  # 'जै बरखा होली, त हम घर म रौला।'

# Relative-Correlative Clauses (सम्बन्धवाचक रचना)
print(kumaoni.relative_correlative("मेहनत करलो", "फल पालो", marker_type="who"))
# Output: 'जो मेहनत करलो, सो फल पालो।'

# Prohibitive Commands (निषेधात्मक आज्ञा - झनि)
print(kumaoni.prohibitive("जाण", polite=True))  # 'झनि जाया' (Please do not go)
print(kumaoni.prohibitive("रोण", polite=True))  # 'झनि रोया' (Please don't cry)

# Modals: Ability, Obligation, and Desideratives
print(kumaoni.modal_ability("मैं", "हिंण"))           # 'मैं हिंडि सकन्छू।' (I can walk)
print(kumaoni.modal_obligation("तुम", "काम करण"))     # 'तुमकणी काम करण चाही।' (You should work)
print(kumaoni.modal_obligation("मैं", "जाण", strong=True)) # 'मैंकणी जाण पडलो।' (I will have to go)
print(kumaoni.modal_desiderative("मैं", "भात खाण"))  # 'मैं भात खाण चान्छू।' (I want to eat food)

# Interrogative Questions (प्रश्नवाचक रचना)
print(kumaoni.interrogative_sentence("कहाँ", subject="अस्पताल"))  # 'अस्पताल कहाँ छ?'
print(kumaoni.interrogative_sentence("क्या", subject="तुमार नाम")) # 'तुमार नाम क्या छ?'
```


### 3. Numbers & Devanagari Numerals

```python
import kumaoni

# Integer to Kumaoni words
print(kumaoni.num_to_words(42))                     # 'बयालीस'
print(kumaoni.num_to_words(108, script="latin"))     # 'ek sau aath'

# Ordinals & fractions
print(kumaoni.ordinal(1))                           # 'पैलो' (1st)
print(kumaoni.ordinal(2))                           # 'दुसर' (2nd)
print(kumaoni.fraction(1, 2))                       # 'आधो' (half)

# Devanagari numerals
print(kumaoni.to_devanagari_numerals(2026))         # '२०२६'
print(kumaoni.from_devanagari_numerals("२०२६"))       # 2026

# Words back to numbers
print(kumaoni.words_to_num("बयालीस"))                 # 42
```

### 4. Dictionary & Lexicon Search

```python
import kumaoni

# Exact lookup
word = kumaoni.lookup("ईजा")
print(f"{word.kumaoni} -> {word.english} ({word.hindi})")
# Output: 'ईजा -> mother (माँ)'

# Cross-language search
results = kumaoni.search("water")
for w in results:
    print(f"{w.kumaoni} ({w.roman}): {w.english}")
# Output: 'पाणि (paani): water'
```

### 5. Morphological Lemmatizer & Analyzer (400,000+ Words)

```python
import kumaoni

# Check total synthesized and indexed full-form vocabulary
print(kumaoni.total_word_forms())  # Output: 443,356+ words

# Lemmatize inflected verb forms, case-marked nouns, or postpositions
print(kumaoni.lemmatize("खान्छू"))    # 'खाण' (to eat)
print(kumaoni.lemmatize("जाँला"))     # 'जाण' (to go)
print(kumaoni.lemmatize("घरबटि"))     # 'घर' (house)
print(kumaoni.lemmatize("ईजा कणी"))   # 'ईजा' (mother)

# Deep morphological analysis (extracts tense, person, case, number, lemma)
analyses = kumaoni.analyze("खान्छू")
for a in analyses:
    print(f"Lemma: {a.lemma}, POS: {a.pos}, Tense: {a.tense}, Person: {a.person}, Number: {a.number}")
# Output: Lemma: खाण, POS: verb_finite, Tense: present, Person: 1, Number: sg

# Seamless dictionary lookup on inflected words
w = kumaoni.lookup("खान्छू")
print(f"Resolved to: {w.kumaoni} -> {w.english}")  # Resolved to: खाण -> to eat
```

### 6. Script & Phonetics

```python
import kumaoni

# Transliterate English phonetics to Devanagari
print(kumaoni.transliterate("Jai Dev, dajyu kas chou?", to_script="devanagari"))
# Output: 'जय देव, दाज्यू कस छौ?'

# Transliterate Devanagari to Romanized
print(kumaoni.transliterate("पैलाग भुली", to_script="latin"))
# Output: 'pailag bhuli'
```

### 7. Cultural Heritage, Literature & Folklore

```python
import kumaoni

# Access Folk Epics (Pauwada / Bhad)
malushahi = kumaoni.literature.get_epic("malushahi")
print(malushahi.title_kumaoni)        # 'राजुला मालूशाही'
print(malushahi.synopsis)

# Explore Traditional Valley Poetry (Nyoli / Jhora)
bedu_pako = kumaoni.literature.poems()[0]
print(bedu_pako.title_kumaoni)        # 'बेड़ू पाको बारह मासा'
print(bedu_pako.verses_kumaoni[0])    # 'बेड़ू पाको बारह मासा, ओ नरण काफल पाको चैत, मेरी छैला!'

# Canonical Kumaoni Authors & Poets (Gumani Pant, Gaurda, Dr. Charu Chandra Pande)
gumani = kumaoni.literature.get_author("gumani_pant")
print(f"{gumani.name_kumaoni} ({gumani.era}): {gumani.significance}")

# Random proverb (Akhaan) & riddle (Aana)
proverb = kumaoni.proverbs.random()
print("Akhaan:", proverb["kumaoni"], "->", proverb["figurative_meaning"])

riddle = kumaoni.riddles.random()
print("Aana:", riddle["riddle"], "-> Answer:", riddle["answer_kumaoni"])

# Traditional Kumaoni festival information
harela = kumaoni.festivals.get("harela")
print(harela.description)

# Explore Traditional Folk Songs & Holi Music
bedu_song = kumaoni.folklore.song("KSN-0001")
print(bedu_song.title, "->", bedu_song.english_translation)

# Classical Kumaoni Baithaki & Khadi Holi songs
khamaj_holi = kumaoni.folklore.holi_songs(raag="Khamaj")
for h in khamaj_holi:
    print(f"[{h.id}] {h.title} ({h.form}, Raag {h.raag})")

# Active Digital Heritage Archives
archives = kumaoni.folklore.sources()
print(f"Preserved archives: {len(archives)} repositories")

# Local Kumaoni Deities & Shrines
golu = kumaoni.deities.get("golu_devta")
print(f"{golu.name_kumaoni}: {golu.title}")
print(f"Primary Shrines: {', '.join(golu.primary_shrines)}")
print(f"Jagar Invocation: {golu.invocation_or_jagar}")

# Sacred Geography & Himalayan Temples (47 Shrines & Landmarks)
jageshwar = kumaoni.places.get("jageshwar_dham")
print(f"{jageshwar.name_kumaoni} ({jageshwar.district}): {jageshwar.spiritual_significance}")
nanda_peak = kumaoni.places.get("nanda_devi_peak")
print(f"{nanda_peak.name_kumaoni} ({nanda_peak.altitude}): {nanda_peak.description}")

# Kumaoni Surnames, Clans & Social Concepts (33 Surnames, 8 Social Concepts)
pant = kumaoni.surnames.get("pant")
print(f"{pant.surname_kumaoni}: {pant.title} | Gotras: {', '.join(pant.gotras)}")
bisht = kumaoni.surnames.get("bisht")
print(f"{bisht.surname_kumaoni}: {bisht.title} | Origin: {bisht.ancestral_villages_or_origin}")
print("Thaatwan Institution:", kumaoni.surnames.social_concepts()["thatwan"]["meaning"])

# Himalayan Ethnobotany & Sacred Trees (43 Plants)
buransh = kumaoni.flora.get("buransh")
print(f"{buransh.name_kumaoni} ({buransh.scientific_name}): {buransh.spiritual_and_temple_significance}")
brahmakamal = kumaoni.flora.get("brahmakamal")
print(f"{brahmakamal.name_kumaoni} (Alt: {brahmakamal.habitat_altitude}): {brahmakamal.traditional_uses}")

# Temple Implements & Sacred Ritual Objects (43 Items)
pithyan = kumaoni.rituals.get("pithyan")
print(f"{pithyan.name_kumaoni}: {pithyan.sacred_purpose} | Material: {pithyan.traditional_material}")
rot = kumaoni.rituals.get("rot")
print(f"{rot.name_kumaoni}: {rot.cultural_context}")
```

---

## 📋 Comprehensive API Function Reference

All key functions are directly accessible via `import kumaoni`:

| Category | Function / Property | Description |
|---|---|---|
| **Translation** | `kumaoni.translate(text, source='en', target='kumaoni')` | Translate from 100+ world languages into Kumaoni. |
| **Voice & Speech** | `kumaoni.voice_translate(text, ...)` | Voice translation pipeline (text + IPA phonetic script + audio). |
| | `kumaoni.voice.phrases()` | Get categorized authentic conversational phrases. |
| **Dictionary & Search** | `kumaoni.lookup(word)` | Search base dictionary definitions (Kumaoni, Hindi, English). |
| | `kumaoni.search(query)` | Multi-result search in vocabulary database. |
| **Morphology (300k+ Forms)** | `kumaoni.lemmatize(word)` | Reduces inflected forms (`खान्छू`, `घरबटि`) to base dictionary lemma. |
| | `kumaoni.analyze(word)` | Deep grammatical analysis (POS, tense, case, gender, person). |
| | `kumaoni.total_word_forms()` | Count of indexed morphological forms (300,000+). |
| **Verb Conjugation** | `kumaoni.conjugate(verb, tense, person, ...)` | Conjugates verbs across Present, Past, Future, Continuous. |
| | `kumaoni.conjugate_to_be(tense, person, ...)`| Conjugates auxiliary substantive verb (`छ-` / to be). |
| | `kumaoni.imperative(verb, honorific=...)` | Forms imperative commands (`खा`, `खाओ`, `खाइये`). |
| | `kumaoni.causative(verb, degree=1)` | Forms 1st and 2nd degree causative verbs (`खवाण`, `खववाण`). |
| | `kumaoni.passive(verb, tense=...)` | Forms passive voice constructions. |
| | `kumaoni.conjunctive_participle(verb)` | Conjunctive participle 'having done' (`खाईकन`, `जाईकन`). |
| | `kumaoni.agent_noun(verb)` | Agentive noun 'the one who does' (`खन्या`, `जन्या`). |
| | `kumaoni.compound_verb(main, vector, ...)` | Aspectual compound verbs (`खा ल्हियो`). |
| | `kumaoni.prohibitive(verb, honorific=...)` | Negative prohibitive commands (`झन् खा`). |
| | `kumaoni.modal_ability(verb, subject=...)` | Modal ability 'can do' (`सकण`). |
| | `kumaoni.modal_obligation(verb, subject=...)`| Modal obligation 'must / should do' (`पड़ण`). |
| | `kumaoni.modal_desiderative(verb, ...)` | Modal desiderative 'wants to do' (`चाण`). |
| **Grammar & Syntax** | `kumaoni.build_sentence(sub, verb, obj, ...)`| Generates grammatically aligned SOV sentences. |
| | `kumaoni.conditional(cond, conseq)` | Conditional sentences (`अगर... तब...`). |
| | `kumaoni.relative_correlative(rel, corr)` | Relative-correlative clauses (`जो... सो...`). |
| | `kumaoni.interrogative_sentence(sub, ...)` | Question sentences (`कहाँ`, `कबे`, `क्योँ`, `को`). |
| | `kumaoni.echo_word(word)` | Reduplicative echo words (`भात-व़ात`, `किताब-सिताब`). |
| **Nouns & Declension** | `kumaoni.pluralize(noun, gender=...)` | Pluralizes nouns by declension class. |
| | `kumaoni.decline_noun(noun, case, ...)` | Declines nouns into grammatical cases. |
| | `kumaoni.to_oblique(noun, ...)` | Oblique stem for postpositions. |
| | `kumaoni.attach_case(noun, case, ...)` | Attaches vibhakti case markers to noun. |
| | `kumaoni.get_marker(case)` | Returns case marker postposition (`-ले`, `-कणी`, `-बटि`, `-म`). |
| | `kumaoni.get_pronoun(person, case, ...)` | Resolves personal pronouns across cases. |
| | `kumaoni.to_feminine(word)` / `to_masculine` | Converts gender forms of nouns/adjectives. |
| | `kumaoni.make_diminutive(noun)` | Diminutive affection forms (`गाड़` ➔ `गड्यूल`). |
| **Numbers & Fractions** | `kumaoni.num_to_words(number)` | Integer to Kumaoni words (`108` ➔ `'एक सौ आठ'`). |
| | `kumaoni.words_to_num(words)` | Kumaoni number words to integer. |
| | `kumaoni.to_devanagari_numerals(n)` | Converts number to Devanagari numerals (`२०२६`). |
| | `kumaoni.from_devanagari_numerals(s)` | Devanagari numerals back to integer. |
| | `kumaoni.ordinal(n)` | Ordinals (`पैलो`, `दुसर`, `तेसर`, `चौथ`). |
| | `kumaoni.fraction(val)` | Fractions (`आधो`, `पाव`, `सवा`, `डेढ़`, `ढाई`). |
| **Phonetics & Script** | `kumaoni.transliterate(text, to_script=...)`| Two-way Devanagari ↔ Latin/Roman transliteration. |
| | `kumaoni.devanagari_to_latin(text)` | Transliterates Devanagari into Latin phonetic script. |
| | `kumaoni.latin_to_devanagari(text)` | Converts Romanized Kumaoni input to Devanagari. |
| | `kumaoni.normalize(text)` | Normalizes Devanagari diacritics and nuktas. |
| | `kumaoni.detect_script(text)` | Detects `'devanagari'`, `'latin'`, or `'mixed'`. |
| | `kumaoni.tokenize(text)` / `syllables(text)`| Tokenizes words and splits phonetic syllables. |
| **Culture & Literature** | `kumaoni.proverbs.all()` / `.random()` | 85+ Proverbs (*Akhaan*) with literal & cultural meanings. |
| | `kumaoni.riddles.all()` / `.random()` | 43+ Traditional Riddles (*Aana*) with hints & answers. |
| | `kumaoni.phrases.all()` / `.random()` | 157+ Conversational phrases, idioms (*Muhavare*) & blessings. |
| | `kumaoni.bibliography.list(category=...)` | 114+ Master Catalogued Books (in Kumaoni, grammar, criticism). |
| | `kumaoni.bibliography.stats()` / `.search(q)` | Summary statistics and keyword search across master corpus. |
| | `kumaoni.folklore.songs()` / `.song(id)` | 20 Catalogued Folk & Recorded Songs with lyrics & English meanings. |
| | `kumaoni.folklore.holi_songs()` / `.holi_song(id)` | 20 Classical Kumaoni Holi Songs (Baithaki, Khadi, Mahila) + Raags. |
| | `kumaoni.folklore.sources()` / `.stats()` | 7 Digital Heritage Archives & corpus statistics. |
| | `kumaoni.deities.list()` / `.get(name_or_id)` | 40 Supreme Local Deities (Golu Devta, Nanda Devi, Bholanath, Bhumia...). |
| | `kumaoni.deities.search(q)` / `.stats()` | Search deities across 5 categories by shrine, title, legend. |
| | `kumaoni.festivals.list()` / `.get(name)` | 40 Traditional Festivals & Melas (*Harela*, *Khatarwa*, *Bagwal*, *Hillyatra*...). |
| | `kumaoni.festivals.search(q)` | Search festivals by district, lunar tithi, or keyword. |
| | `kumaoni.places.list()` / `.get(id)` | 47 Sacred Temples, Rivers, Glaciers & Valleys (Jageshwar, Baijnath, Nanda Devi...). |
| | `kumaoni.places.search(q)` / `.stats()` | Search holy geography by district, deity, or spiritual significance. |
| | `kumaoni.surnames.list()` / `.get(id)` | 33 Lineage Surnames & Clans (Pant, Joshi, Bisht, Rawat, Negi, Pangtey, Tamta...). |
| | `kumaoni.surnames.social_concepts()` | 8 Fundamental Kumaoni social concepts (*Thaat*, *Thaatwaan*, *Dhadha*, *Gauntyaar*...). |
| | `kumaoni.flora.list()` / `.get(id)` | 71 Sacred Trees, Alpine Flowers, & Medicinal Herbs (Banjh, Buransh, Brahmakamal, Utees, Semal, Bhaang...). |
| | `kumaoni.flora.search(q)` / `.stats()` | Search ethnobotanical flora by traditional use, habitat altitude, or category. |
| | `kumaoni.rituals.list()` / `.get(id)` | 69 Temple Implements, Hawan Vessels, & Paraphernalia (Pithyan, Rot, Ghant, Deewa, Baati, Kapoor, Pattal, Nath...). |
| | `kumaoni.rituals.search(q)` / `.stats()` | Search ritual objects by material, sacred purpose, or associated deity/temple. |
| | `kumaoni.literature.epics()` / `.get_epic(id)`| 8 Folk Epics (*Malushahi-Rajula*, *Jiya Rani*, *Kalu Bhandari*). |
| | `kumaoni.literature.poems()` | Canonical Kumaoni poems & folk songs. |
| | `kumaoni.literature.authors()` / `.get_author(id)` | Biographies of 20+ canonical scholars & poets. |
| | `kumaoni.get_months()` / `get_seasons()` | Kumaoni solar calendar months & 6 traditional seasons. |
| | `kumaoni.get_current_season()` | Calculates active season for today's date. |

For exhaustive explanations and parameter details, see [DOCUMENTATION.md](file:///c:/Users/digit_lgfi273/OneDrive/Desktop/kumaoni%20language%20library/DOCUMENTATION.md).

---

## 💻 Command-Line Interface (CLI)

The library provides a CLI tool `kumaoni`:

```bash
# Translate text
kumaoni translate "Where does this road go?" --source en

# Dictionary lookup
kumaoni lookup "काफल"
kumaoni lookup "पिछौड़ा"

# Number to words
kumaoni number 108

# Verb conjugation
kumaoni conjugate "जाण" --tense past --person 1

# Random proverb / riddle
kumaoni proverb
kumaoni riddle
```

---

## 🖥️ Interactive Web Playground

Launch the interactive local web playground to test translation and explore the language in a browser:

```bash
python -m kumaoni.web.app 8080
```
Open [http://localhost:8080](http://localhost:8080) in your browser.

---

## 📂 Project Architecture

```
kumaoni/
├── __init__.py           # Unified top-level namespace (kumaoni.translate, folklore, literature, etc.)
├── constants.py          # Dialects, grammatical constants, solar calendar
├── phonetics.py          # Script transliteration, Devanagari normalizer
├── grammar/
│   ├── verbs.py          # Verb root extraction & conjugation engine
│   ├── nouns.py          # Noun morphology, pluralization, case declensions
│   ├── pronouns.py       # Pronoun tables across person, number, and case
│   └── postpositions.py  # Karaka markers (-ले, -कणी, -बटि, -म, etc.)
├── numbers/
│   └── converter.py      # Integer to words, ordinals, fractions, numerals
├── lexicon/
│   ├── dictionary.py     # Fast search across Devanagari, English, and Hindi
│   └── data/             # Curated JSON datasets (2,380+ base lemmas, 515,744+ word forms)
├── translator/
│   ├── engine.py         # Unified translation orchestrator
│   ├── rule_based.py     # Rule-based linguistic transfer & dialogue patterns
│   ├── pivot.py          # Universal multi-language bridge (Any Language -> Kumaoni)
│   └── llm_adapter.py    # Native Gemini/OpenAI neural integration
├── culture/
│   ├── deities.py        # 40 Local Deities & Shrines (Golu Devta, Nanda Devi, etc.)
│   ├── places.py         # 47 Sacred Temples, Rivers, Glaciers & Valleys
│   ├── surnames.py       # 33 Kumaoni Surnames, Clans & Social Concepts (Thaat, etc.)
│   ├── flora.py          # 71 Himalayan Sacred Trees, Alpine Flowers & Ethnobotany
│   ├── rituals.py        # 69 Temple Implements, Hawan Vessels & Paraphernalia
│   ├── festivals.py      # 40 Traditional Festivals & Historic Melas (Harela, etc.)
│   ├── calendar.py       # Kumaoni solar months & seasons
│   ├── literature.py     # Folk Epics (Malushahi, Bafaul), Nyoli, Jhora, Authors
│   ├── bibliography.py   # 114+ Catalogued Works (in Kumaoni, grammar, linguistics)
│   ├── folklore.py       # 20 Folk Songs, 20 Holi Songs, 7 Digital Archives
│   └── data/             # songs.json, holi_songs.json, digital_sources.json, books.json
├── voice/                # Phonetic speech synthesis & audio generation
├── cli.py                # Command-line interface
└── web/                  # Interactive developer playground
```

---

## 📚 Data Sources & Acknowledgments

This library synthesizes datasets and oral cultural heritage from:
- **eUttaranchal** (*Learn Kumaoni* linguistic lessons 1–3)
- **SpeakKumaoni** & **PahadiLingo** (Himalayan vocabulary & phonetic guides)
- **Kumauni Archives** & **Kumauni Culture** (Oral literature, e-books, e-magazines)
- **Linguistic Research**: Works of Dr. D.D. Sharma (*Linguistic Geography of Kumaun Himalayas*), Dr. Charu Chandra Pande, G.A. Grierson (*LSI*), Saraswati Kohli (*Kumaoni Kahavatein*), Gumani Pant, and Gaurda.

---

## 📜 License

MIT License &copy; 2026 Kumaoni Language Initiative. Open-source and free for all developers, linguists, and researchers.

---

## 👤 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)
* **Kumaoni Repository**: [https://github.com/infoakshatsinghbisht-eng/kumaoni-language-library](https://github.com/infoakshatsinghbisht-eng/kumaoni-language-library)
* **Garhwali Repository**: [https://github.com/infoakshatsinghbisht-eng/garhwali-language-library](https://github.com/infoakshatsinghbisht-eng/garhwali-language-library)
* **Garhwali PyPI**: [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.
