rajasthani 1.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (88) hide show
  1. rajasthani-1.0.0/DOCUMENTATION.md +353 -0
  2. rajasthani-1.0.0/LICENSE +21 -0
  3. rajasthani-1.0.0/MANIFEST.in +7 -0
  4. rajasthani-1.0.0/PKG-INFO +163 -0
  5. rajasthani-1.0.0/README.md +128 -0
  6. rajasthani-1.0.0/pyproject.toml +36 -0
  7. rajasthani-1.0.0/rajasthani/__init__.py +436 -0
  8. rajasthani-1.0.0/rajasthani/cli.py +166 -0
  9. rajasthani-1.0.0/rajasthani/constants.py +274 -0
  10. rajasthani-1.0.0/rajasthani/culture/__init__.py +90 -0
  11. rajasthani-1.0.0/rajasthani/culture/architecture.py +95 -0
  12. rajasthani-1.0.0/rajasthani/culture/attire.py +77 -0
  13. rajasthani-1.0.0/rajasthani/culture/cuisine.py +102 -0
  14. rajasthani-1.0.0/rajasthani/culture/data/bibliography.json +32 -0
  15. rajasthani-1.0.0/rajasthani/culture/data/folk_songs.json +47 -0
  16. rajasthani-1.0.0/rajasthani/culture/deities.py +103 -0
  17. rajasthani-1.0.0/rajasthani/culture/literature.py +78 -0
  18. rajasthani-1.0.0/rajasthani/culture/music.py +145 -0
  19. rajasthani-1.0.0/rajasthani/culture/ornaments.py +487 -0
  20. rajasthani-1.0.0/rajasthani/culture/places.py +93 -0
  21. rajasthani-1.0.0/rajasthani/culture/rituals.py +340 -0
  22. rajasthani-1.0.0/rajasthani/grammar/__init__.py +130 -0
  23. rajasthani-1.0.0/rajasthani/grammar/adjectives.py +53 -0
  24. rajasthani-1.0.0/rajasthani/grammar/adverbs.py +50 -0
  25. rajasthani-1.0.0/rajasthani/grammar/causatives.py +46 -0
  26. rajasthani-1.0.0/rajasthani/grammar/deliberative.py +31 -0
  27. rajasthani-1.0.0/rajasthani/grammar/honorifics.py +40 -0
  28. rajasthani-1.0.0/rajasthani/grammar/inceptive.py +19 -0
  29. rajasthani-1.0.0/rajasthani/grammar/negation.py +46 -0
  30. rajasthani-1.0.0/rajasthani/grammar/nouns.py +155 -0
  31. rajasthani-1.0.0/rajasthani/grammar/obligative.py +24 -0
  32. rajasthani-1.0.0/rajasthani/grammar/postpositions.py +58 -0
  33. rajasthani-1.0.0/rajasthani/grammar/presumptive.py +24 -0
  34. rajasthani-1.0.0/rajasthani/grammar/pronouns.py +202 -0
  35. rajasthani-1.0.0/rajasthani/grammar/syntax.py +1086 -0
  36. rajasthani-1.0.0/rajasthani/grammar/verbs.py +241 -0
  37. rajasthani-1.0.0/rajasthani/grammar/voice.py +54 -0
  38. rajasthani-1.0.0/rajasthani/kinship.py +701 -0
  39. rajasthani-1.0.0/rajasthani/lexicon/__init__.py +32 -0
  40. rajasthani-1.0.0/rajasthani/lexicon/data/idioms.json +474 -0
  41. rajasthani-1.0.0/rajasthani/lexicon/data/phrases.json +184 -0
  42. rajasthani-1.0.0/rajasthani/lexicon/data/proverbs.json +422 -0
  43. rajasthani-1.0.0/rajasthani/lexicon/data/riddles.json +252 -0
  44. rajasthani-1.0.0/rajasthani/lexicon/data/words.json +19615 -0
  45. rajasthani-1.0.0/rajasthani/lexicon/dictionary.py +245 -0
  46. rajasthani-1.0.0/rajasthani/lexicon/morphology.py +71 -0
  47. rajasthani-1.0.0/rajasthani/linguistics/__init__.py +28 -0
  48. rajasthani-1.0.0/rajasthani/linguistics/bis_tagger.py +77 -0
  49. rajasthani-1.0.0/rajasthani/linguistics/dialectology.py +71 -0
  50. rajasthani-1.0.0/rajasthani/linguistics/ergativity.py +31 -0
  51. rajasthani-1.0.0/rajasthani/linguistics/reduplication.py +63 -0
  52. rajasthani-1.0.0/rajasthani/numbers/__init__.py +26 -0
  53. rajasthani-1.0.0/rajasthani/numbers/converter.py +292 -0
  54. rajasthani-1.0.0/rajasthani/phonetics.py +281 -0
  55. rajasthani-1.0.0/rajasthani/translator/__init__.py +20 -0
  56. rajasthani-1.0.0/rajasthani/translator/engine.py +106 -0
  57. rajasthani-1.0.0/rajasthani/translator/llm_adapter.py +39 -0
  58. rajasthani-1.0.0/rajasthani/translator/pivot.py +109 -0
  59. rajasthani-1.0.0/rajasthani/translator/rule_based.py +323 -0
  60. rajasthani-1.0.0/rajasthani/voice/__init__.py +20 -0
  61. rajasthani-1.0.0/rajasthani/voice/engine.py +41 -0
  62. rajasthani-1.0.0/rajasthani/voice/synthesizer.py +73 -0
  63. rajasthani-1.0.0/rajasthani/web/__init__.py +6 -0
  64. rajasthani-1.0.0/rajasthani/web/app.py +202 -0
  65. rajasthani-1.0.0/rajasthani/web/static/app.js +220 -0
  66. rajasthani-1.0.0/rajasthani/web/static/index.html +276 -0
  67. rajasthani-1.0.0/rajasthani/web/static/style.css +408 -0
  68. rajasthani-1.0.0/rajasthani.egg-info/PKG-INFO +163 -0
  69. rajasthani-1.0.0/rajasthani.egg-info/SOURCES.txt +86 -0
  70. rajasthani-1.0.0/rajasthani.egg-info/dependency_links.txt +1 -0
  71. rajasthani-1.0.0/rajasthani.egg-info/entry_points.txt +2 -0
  72. rajasthani-1.0.0/rajasthani.egg-info/top_level.txt +1 -0
  73. rajasthani-1.0.0/requirements.txt +1 -0
  74. rajasthani-1.0.0/setup.cfg +4 -0
  75. rajasthani-1.0.0/setup.py +55 -0
  76. rajasthani-1.0.0/tests/test_constants.py +36 -0
  77. rajasthani-1.0.0/tests/test_culture.py +85 -0
  78. rajasthani-1.0.0/tests/test_grammar.py +84 -0
  79. rajasthani-1.0.0/tests/test_kinship.py +38 -0
  80. rajasthani-1.0.0/tests/test_lexicon.py +64 -0
  81. rajasthani-1.0.0/tests/test_linguistics.py +37 -0
  82. rajasthani-1.0.0/tests/test_numbers.py +44 -0
  83. rajasthani-1.0.0/tests/test_phonetics.py +42 -0
  84. rajasthani-1.0.0/tests/test_sentence_formation.py +60 -0
  85. rajasthani-1.0.0/tests/test_translation_benchmark.py +54 -0
  86. rajasthani-1.0.0/tests/test_translator.py +44 -0
  87. rajasthani-1.0.0/tests/test_ultimate_features.py +319 -0
  88. rajasthani-1.0.0/tests/test_voice.py +24 -0
@@ -0,0 +1,353 @@
1
+ # Rajasthani (राजस्थानी) Language Library - Documentation & Reference Manual
2
+
3
+ ## 1. Linguistic Overview & Classification
4
+ - **Macro-language ISO 639-3**: `raj`
5
+ - **Dialect ISO codes**:
6
+ - Marwari (Western Rajasthan - Jodhpur, Bikaner, Jaisalmer): `mwr`
7
+ - Mewari (South-Central - Udaipur, Chittorgarh): `mew`
8
+ - Dhundhari / Jaipuri (East-Central - Jaipur, Dausa): `dhd`
9
+ - Harauti (South-Eastern - Kota, Bundi): `hoj`
10
+ - Shekhawati (North-Central - Sikar, Jhunjhunu, Churu): `swv`
11
+ - Bagri (North-Western): `bgq`
12
+ - Wagdi (Southern): `wbr`
13
+ - Mewati (North-Eastern): `wtm`
14
+
15
+ ---
16
+
17
+ ## 2. Sentence Formation, Syntax & Conversion Engine
18
+
19
+ ### Rule 1: Canonical Constituent Word Order (SOV)
20
+ Rajasthani adheres strictly to Subject - Object - Verb word order:
21
+ $$\text{Subject} + (\text{Time/Location}) + \text{Indirect Object} + \text{Direct Object} + \text{Verb} + \text{Auxiliary}$$
22
+
23
+ *Example*:
24
+ `म्हूँ (S) सवेरै (Time) घर मांय (Loc) पोथी (O) पढ़ूँ हूँ (V).`
25
+ *(I read a book at home in the morning.)*
26
+
27
+ ### Rule 2: Split Ergativity in Past Tense (भूतकालिक सकर्मक क्रिया तालमेल)
28
+ 1. **Present, Continuous & Future Tenses**:
29
+ - Nominative alignment. The verb agrees with the Subject:
30
+ - `राम पोथी पढ़ै है।` *(Ram reads the book.)*
31
+ - `सीता पोथी पढ़ै है।` *(Sita reads the book.)*
32
+ 2. **Past Tense (with Transitive Verbs)**:
33
+ - Split ergative alignment. The Subject takes the Ergative marker `नै` (or pronominal forms `म्हैं` for I, `तैं` for thou, `उण` for that/he).
34
+ - The verb agrees with the **Direct Object** in gender and number:
35
+ - `राम नै पोथी पढ़ी।` *(Ram read the book - 'पढ़ी' is feminine agreeing with 'पोथी'.)*
36
+ - `राम नै आंबा खायो।` *(Ram ate the mango - 'खायो' is masculine singular.)*
37
+ - `म्हैं लाडू खाया।` *(I ate laddoos - 'खाया' is masculine plural.)*
38
+
39
+ ### Rule 3: Pronoun Clusivity (आपां vs. म्हें)
40
+ Rajasthani maintains the classical Indo-Aryan distinction between:
41
+ - **Inclusive 1st Person Plural (`आपां`)**: Speaker + Listener included (`आपां चालां` - let us all go together).
42
+ - **Exclusive 1st Person Plural (`म्हें`)**: Speaker + Companions, excluding listener (`म्हें जावांगा` - we are going, not you).
43
+ Use `rajasthani.convert_clusivity(sentence, inclusive=True/False)`.
44
+
45
+ ### Rule 4: Causative Alternations (प्रेरणार्थक क्रियावां)
46
+ Rajasthani features two systematic tiers of morphological causativization:
47
+ - **Level 1 (Direct Causative - प्रत्यक्ष प्रेरणार्थक)**: `करणो` $\rightarrow$ `करावणो`, `लिखणो` $\rightarrow$ `लिखावणो`, `खावणो` $\rightarrow$ `जिमावणो`.
48
+ - **Level 2 (Mediated Causative - अप्रत्यक्ष प्रेरणार्थक)**: `करणो` $\rightarrow$ `करवावणो`, `लिखणो` $\rightarrow$ `लिखवावणो`, `खावणो` $\rightarrow$ `जिमवावणो`.
49
+ Use `rajasthani.generate_causative(verb, level=1/2)`.
50
+
51
+ ### Rule 5: Compound Verbs & Aspectual Vectors (संयुक्त क्रियावां)
52
+ Vector auxiliaries attach to conjunctive participle stems to mark aspect and orientation:
53
+ - `लेणो` (Self-benefactive): `खाय लियो`, `बांच लियो`
54
+ - `देणो` (Outward action): `दे दीनो`, `बताय दीनो`
55
+ - `पड़णो` (Sudden/involuntary action): `चाल पड़्यो`, `हंस पड़्यो`
56
+ - `नांखणो` (Complete disposal / violent telicity): `मार नांख्यो`, `फैंक नांख्यो`
57
+ Use `rajasthani.build_compound_verb(main_verb, vector_verb, tense, gender, number)`.
58
+
59
+ ### Rule 6: Correlative Complex Sentences (मिश्र अर संयुक्त वाक्य)
60
+ Constructs authentic folk vat and literary correlatives:
61
+ - `conditional`: `जे... तो` (*जे मेह बरस्यो, तो फसल चोखी व्हैला।*)
62
+ - `temporal`: `जद... तद` (*जद सूरज ऊग्यो, तद अंधेरो मिट ग्यो।*)
63
+ - `relative`: `जको... वो` (*जको मेहनत करै है, वो सुखी रह्वै है।*)
64
+ - `spatial`: `जठै... वठै` (*जठै धर्मी राजा, वठै आनंद।*)
65
+ - `manner`: `जियां... तियां` (*जियां कह्यो, तियां कियो।*)
66
+ - `concessive`: `भले ही... पण` (*भले ही आंधी आवै, पण कदम नीं रुकसी।*)
67
+ Use `rajasthani.build_complex_sentence(sub_clause, main_clause, connector_type)`.
68
+
69
+ ### Rule 7: Past Counterfactual Conditionals (हेतुहेतुमद्भाव)
70
+ Constructs unfulfilled historical or hypothetical past conditions:
71
+ - `जे मेह बरसतो, तो अकाल नीं पड़तो।` *(If it had rained, there would have been no famine).*
72
+ Use `rajasthani.build_counterfactual_conditional(condition_clause, consequence_clause)`.
73
+
74
+ ### Rule 8: Imperative Directives & Politeness Registers
75
+ Four distinct social honorific tiers:
76
+ - `intimate` (तूं): `तूं लिख` / negative: `तूं मती लिख`
77
+ - `familiar` (तूं/थे): `तूं लिखो`
78
+ - `polite` (थे): `थे लिखो` / `थे बांचो`
79
+ - `honorific` (आप / हुकम): `आप विराजो सा` / `आप आरोगो सा` / `आप पधारो सा`
80
+ Use `rajasthani.build_imperative(verb, politeness_level, negative)`.
81
+
82
+ ### Rule 9: Benedictions, Wishes & Optatives (आशीर्वचन)
83
+ Constructs auspicious blessings and desires:
84
+ - `भगवान थारो भलो करै!` *(May God bless you!)*
85
+ Use `rajasthani.build_optative(subject, verb_phrase, blessing=True)`.
86
+
87
+ ### Rule 10: Classical Vat Narrative Story Builder (वात री बनावट)
88
+ Generates historical story discourse opening, body, and moral closure:
89
+ - `"एक समै री बात है। मरुधर देस मांय एक शूरवीर रजपूत रह्वै थो। तद उण धर्म री रक्षा खातर सीस कटाय दियो। कथा पूरी भई, आनंद मंगल भयो।"`
90
+ Use `rajasthani.build_vat_narrative(protagonist, setting, deed)`.
91
+
92
+ ### Rule 11: Synthetic Passive Voice (`-ईजै` / `-इजै`)
93
+ Transforms active sentences into passive or impersonal voice:
94
+ - `राम पोथी बांचै है` $\rightarrow$ `राम सूं पोथी बंचीजै है`
95
+ - `म्हैं काम कियो` $\rightarrow$ `म्हारै सूं काम करीज्यो`
96
+ Use `rajasthani.transform_voice(sentence, target_voice="passive")`.
97
+
98
+ ### Rule 12: Reduplicated Echo Words (अनुकरणवाचक शब्द)
99
+ Forms natural conversational echo formations:
100
+ - `रोटी` $\rightarrow$ `रोटी-ओटी`, `पाणी` $\rightarrow$ `पाणी-धाणी`, `चाय` $\rightarrow$ `चाय-वाय`
101
+ Use `rajasthani.build_echo_word(word)`.
102
+
103
+ ### Rule 13: Absolute Expressive Superlatives (सघन विशेषण)
104
+ Expresses absolute qualities in classic folklore style:
105
+ - `धोळो` $\rightarrow$ `धोळो-धम्मक` *(dazzling snow-white)*
106
+ - `काळो` $\rightarrow$ `काळो-भम्मक` *(pitch obsidian-black)*
107
+ - `मीठो` $\rightarrow$ `मीठो-मध` *(honey sweet)*
108
+ - `रातो` $\rightarrow$ `रातो-पीळो` *(crimson-red / enraged)*
109
+ Use `rajasthani.intensify_adjective(adjective)`.
110
+
111
+ ### Rule 14: Reported Speech in Vat Discourse (अप्रत्यक्ष कथन)
112
+ Transforms direct speech into indirect narrative reported speech:
113
+ - `राजा कह्यो कै वो काल जासी।`
114
+ Use `rajasthani.convert_reported_speech(speaker, direct_quote)`.
115
+
116
+ ### Rule 15: Rhetorical Tag Questions (कथनोपकथन)
117
+ Appends authentic Rajasthani tag question particles:
118
+ - `थे चालो हो, नीं?` / `थे चालो हो कांईं?`
119
+ Use `rajasthani.build_rhetorical_question(statement, tag_type="neen"/"kani"/"ke")`.
120
+
121
+ ### Rule 11: Absolute Expressive Superlatives (परम प्रकर्ष विशेषण)
122
+ Produces authentic reduplicated intensifying superlatives:
123
+ - `धोळो` $\rightarrow$ `धोळो-धम्मक` (dazzling milk-white)
124
+ - `काळो` $\rightarrow$ `काळो-भम्मक` (pitch-black)
125
+ - `पीळो` $\rightarrow$ `पीळो-पटक` (vibrant yellow)
126
+ - `रातो` $\rightarrow$ `रातो-चोळ` (deep vermilion blood-red)
127
+ - `मीठो` $\rightarrow$ `मीठो-मध` (honey-sweet)
128
+ - `खारो` $\rightarrow$ `खारो-खट` (briny saline)
129
+ - `कड़वो` $\rightarrow$ `कड़वो-झैर` (poisonous bitter)
130
+ Use `rajasthani.intensify_adjective(adjective)`.
131
+
132
+ ### Rule 12: Reduplicated Echo Words (अनुकरणात्मक प्रतिध्वनि शब्द)
133
+ Derives traditional echo-reduplication where onset consonants shift to vowel/o- or dh-:
134
+ - `रोटी` $\rightarrow$ `रोटी-ओटी`
135
+ - `पाणी` $\rightarrow$ `पाणी-धाणी`
136
+ - `चाय` $\rightarrow$ `चाय-वाय`
137
+ Use `rajasthani.build_echo_word(word)`.
138
+
139
+ ### Rule 13: Vat Narrative Reported Speech (आख्यानात्मक परोक्ष कथन)
140
+ Transforms direct speech into indirect narrative discourse as found in classical Vats:
141
+ - Direct: `राजा कह्यो, "म्हूँ काल जावूं।"`
142
+ - Reported: `राजा कह्यो कै वो काल जासी।`
143
+ Use `rajasthani.convert_reported_speech(speaker, direct_quote)`.
144
+
145
+ ### Rule 14: Rhetorical Question Tags (अनुप्रश्नात्मक पद)
146
+ Appends colloquial Rajasthani pragmatic tag particles:
147
+ - Tag `neen`: `थे चालो हो, नीं?`
148
+ - Tag `kani`: `थे चालो हो कांईं?`
149
+ - Tag `ke`: `थे चालो हो के?`
150
+ Use `rajasthani.build_rhetorical_question(statement, tag_type)`.
151
+
152
+ ### Rule 15: Royal Politeness & Deferential Register Elevation
153
+ Elevates basic sentences into royal / courtly Rajasthani address:
154
+ - Replaces basic verbs with royal verbs: `खावो/जीमो` $\rightarrow$ `आरोगो सा`, `बैठो` $\rightarrow$ `विराजो सा`, `आवो` $\rightarrow$ `पधारो सा`, `जावो` $\rightarrow$ `सिधावो सा`, `बोलो` $\rightarrow$ `फरमावो सा`, `सोवो` $\rightarrow$ `पोढो सा`.
155
+ - Injects honorific particles `सा` and `हुकम`.
156
+ Use `rajasthani.elevate_politeness(sentence, tier="royal")`.
157
+
158
+ ### Rule 16: Dubitative & Speculative Mood (संदेहवाचक वाक्य)
159
+ Constructs authentic speculative sentences using Rajasthani modal markers:
160
+ - `शायद काल मेह बरसैला।`
161
+ - `कदाच वो काल आवै।`
162
+ - `हो सकै वो बात सांची होवै।`
163
+ - `जाणै इन्द्रदेव प्रसन्न होया होवै।`
164
+ Use `rajasthani.build_dubitative_sentence(proposition, mood_marker)`.
165
+
166
+ ### Rule 17: Vat Narrative Discourse Connectives (कथा संयोजक)
167
+ Connects clauses into Vat prose discourse using classical connectives:
168
+ - Sequential: `तदन्तर` (`Clause 1। तदन्तर Clause 2।`)
169
+ - Consequential: `इण वास्तै` (`Clause 1, इण वास्तै Clause 2।`)
170
+ - Adversative: `पण` (`Clause 1, पण Clause 2।`)
171
+ - Simultaneous: `ज्यूं ही ... त्यूं ही` (`ज्यूं ही Clause 1, त्यूं ही Clause 2।`)
172
+ Use `rajasthani.connect_discourse(clauses, relation)`.
173
+
174
+ ### Rule 18: Ergative Past Transitive Construction & Alignment
175
+ Generates complete split-ergative clauses in past transitive contexts:
176
+ - Assigns ergative postposition `नै` or oblique pronoun (`म्हैं`, `तैं`, `उण`, `ईं`).
177
+ - Ensures the verb strictly agrees with the Direct Object in gender and number.
178
+ Use `rajasthani.apply_ergative_construction(subject, direct_object, verb, obj_gender, obj_number)`.
179
+
180
+ ### Rule 19: Adverbial Manner Correlatives (रीतिवाचक सापेक्ष वाक्य)
181
+ Constructs correlative clauses of manner using classical `जियां... तियां`:
182
+ - Formula: `जियां <manner>, तियां <result>।`
183
+ - Example: `जियां कह्यो, तियां कर्यो।`
184
+ Use `rajasthani.build_manner_correlative(manner_clause, result_clause)`.
185
+
186
+ ### Rule 20: Habitual & Frequentative Aspect (अभ्यासवाचक पक्ष)
187
+ Constructs habitual aspectual sentences using infinitive stems combined with `-वा लाग्यो`:
188
+ - Example: `वो रोज सवेरै पोथी बांचवा लाग्यो।`
189
+ Use `rajasthani.build_habitual_aspect(subject, verb, object_noun, frequency)`.
190
+
191
+ ### Rule 21: Interrogative Question Transformations (प्रश्नात्मक वाक्य रूपांतरण)
192
+ Transforms declarative sentences into polar (yes/no) or content (wh-) interrogatives:
193
+ - Polar: `कांईं राम पोथी पढ़ै है?`
194
+ - Content When: `राम कद जासी?`
195
+ - Content Who: `कूण काल जासी?`
196
+ - Content Where: `राम कठे जासी?`
197
+ Use `rajasthani.transform_interrogative(sentence, question_type, target_element)`.
198
+
199
+ ### Rule 22: Protective Negative Optatives (अपशकुन निवारक आशीर्वाद)
200
+ Constructs protective benedictions warding off calamity:
201
+ - Example: `भगवान थारो रो बुरो नीं करै!`
202
+ Use `rajasthani.build_negative_optative(target, calamity)`.
203
+
204
+ ### Rule 23: Compound Postposition Synthesis (संयुक्त परसर्ग)
205
+ Synthesizes complex compound postpositions attached to oblique stems:
206
+ - `रै सागै` (along with: `राम रै सागै`)
207
+ - `रै कारणै` (because of: `बरसात रै कारणै`)
208
+ - `रै बिना` (without: `पाणी रै बिना`)
209
+ - `रै खातर` (for the sake of: `मातृभूमि रै खातर`)
210
+ - `रै बद्लै` (instead of: `गेहूँ रै बद्लै`)
211
+ Use `rajasthani.attach_compound_postposition(noun, postposition)`.
212
+
213
+ ---
214
+
215
+ ## 3. Digitized Primary Corpus Sources (56 Files, ~64.02 MB, 53 Cataloged Works)
216
+ All full-text transcripts are indexed in `data_sources/corpus_catalog.json` and stored in `data_sources/raw_texts/`:
217
+ 1. `in.ernet.dli.2015.348143_sitaram_lalas_rajasthani_shabdkosh_vol4.txt` (8.67 MB): *Rajasthani Shabdkosh (Vol IV)*, Dr. Sitaram Lalas.
218
+ 2. `in.ernet.dli.2015.345984_sitaram_lalas_rajasthani_sabad_kos_vol2_pt1.txt` (7.18 MB): *Rajasthani Sabad Kos (Part 2-1)*, Dr. Sitaram Lalas.
219
+ 3. `in.ernet.dli.2015.345971_sitaram_lalas_rajasthani_sabad_kos_vol2.txt` (6.05 MB): *Rajasthani Sabad Kos (Part 2-2)*, Dr. Sitaram Lalas.
220
+ 4. `in.ernet.dli.2015.348199_2015.348199.Dhola-Maru_djvu.txt` (2.16 MB): *Dhola Maru Ra Dhoha*, Dr. Bhagwati Lal Rajpurohit.
221
+ 5. `maheshwari_rajasthani_bhasha_sahitya_1960.txt` (2.15 MB): *Rajasthani Bhasha Aur Sahitya*, Dr. Hiralal Maheshwari.
222
+ 6. `in.ernet.dli.2015.464090_detha_dictionary_rajasthani_proverbs.txt` (2.01 MB): *A Dictionary Of Rajasthani Proverbs*, Bijaydan Detha "Biji".
223
+ 7. `in.ernet.dli.2015.400763_rajasthani_kahawat_kosh.txt` (1.83 MB): *Rajasthani Kahawat Kosh*, Bhagirath Kanoria.
224
+ 8. `bhati_rajasthani_madhyakal_1954.txt` (1.77 MB): *Rajasthani Sahitya Ka Madhyakal*, Dr. Narayansingh Bhati.
225
+ 9. `in.ernet.dli.2015.314052_2015.314052.Kanhadade-Prabandha_djvu.txt` (1.75 MB): *Kanhadade Prabandha (Vol 1)*, Kavi Padmanabha.
226
+ 10. `in.ernet.dli.2015.443912_2015.443912.Rajasthani-Lok_djvu.txt` (1.69 MB): *Rajasthani Lok Sahitya Ki Saidhanti Vivechna*, Sohandan Charan.
227
+ 11. `in.ernet.dli.2015.345924_prakrit_apbransh_dingal_prabhav.txt` (1.63 MB): *Prakrit Aur Apbransh Ka Dingal Sahitya Par Prabhav*, Dr. Govardhan Sharma.
228
+ 12. `bhati_dingal_geet_sahitya_1961.txt` (1.41 MB): *Dingal Geet Sahitya*, Dr. Narayansingh Bhati.
229
+ 13. `in.ernet.dli.2015.321330_2015.321330.Rajasthani-Bhasha_djvu.txt` (1.35 MB): *Rajasthani Bhasha Aur Sahitya*, Dr. Narayansingh Bhati.
230
+ 14. `in.ernet.dli.2015.444415_marwari_vyapari.txt` (1.23 MB): *Marwari Vyapari*, Giriraj Shankar Sharma.
231
+ 15. `in.ernet.dli.2015.445998_rajasthani_gadh_vikas_aur_prakash_pt1.txt` (1.19 MB): *Rajasthani Gadh Vikas Aur Prakash Bhag 1*, Dr. Narendra Bhanawat.
232
+ 16. `in.ernet.dli.2015.545356_2015.545356.Krisan-Rukmani-Ri-Veli_djvu.txt` (1.15 MB): *Veli Krisan Rukmani Ri*, Rathore Prithviraj / Swami Narottamdas.
233
+ 17. `in.ernet.dli.2015.347988_rajasthani_sahitya_kosh_chand.txt` (1.13 MB): *Rajasthani Sahitya Kosh (Chhand Shastra)*, Dr. Narayansingh Bhati.
234
+ 18. `in.ernet.dli.2015.442001_rajasthan_ke_aitihasik_granth_sarvekshan.txt` (1.12 MB): *Rajasthan Ke Aitihasik Granthon Ka Sarvekshana*, Dr. Narayansingh Bhati.
235
+ 19. `in.ernet.dli.2015.347791_parmpara_rajasthani_baat_sangrah.txt` (1.08 MB): *Parmpara Rajasthani Baat-Sangrah*, Dr. Narayansingh Bhati.
236
+ 20. `in.ernet.dli.2015.309699_rajasthani_vratkathae_purohit.txt` (1.04 MB): *Rajasthani Vratkathae*, Mohanlal Purohit.
237
+ 21. `grierson_lsi_vol9_rajasthani_1908.txt` (1.03 MB): *LSI Vol. IX Part II: Rajasthani & Gujarati*, Sir George Grierson.
238
+ 22. `in.ernet.dli.2015.380463_...txt` (1.01 MB): *Veer Satsai*, Mahakavi Suryamal Misran.
239
+ 23. `padam_bhagat_rukamani_mangal_harji_ro_vyambalo_1977.txt` (1.00 MB): *Rukamani Mangal & Harji Ro Vyambalo*, Padam Bhagat.
240
+ 24. `in.ernet.dli.2015.538962_rajasthani_gadhya_sahitya_udbhava_vikas.txt` (924 KB): *Rajasthani Gadhya-Sahitya Udbhava Aur Vikas*, Dr. Shivswaroop Sharma.
241
+ 25. `in.ernet.dli.2015.306886_parampra_dingal_kosh.txt` (848 KB): *Parampra Dingal Kosh*, Dr. Narayansingh Bhati.
242
+ 26. `in.ernet.dli.2015.308999_rajasthani_sahitya_adi_kal.txt` (818 KB): *Rajasthani Sahitya Ka Adi Kal*, Dr. Narayansingh Bhati.
243
+ 27. `bhati_dingal_kosh_1978.txt` (788 KB): *Dingal Kosh*, Dr. Narayansingh Bhati.
244
+ 28. `ramkrishan_hindi_rajasthani_tulnatmak_1977.txt` (780 KB): *Hindi Aur Rajasthani Bhasha Ka Tulnatmak Adhyan*.
245
+ 29. `in.ernet.dli.2015.308096_...txt` (776 KB): *Rajasthani Vat Sahitya*, Dr. Poonam Daiya.
246
+ 30. `prabhakar_sahitya_sanskriti_1968.txt` (699 KB): *Rajasthani Sahitya Aur Sanskriti*, Manohar Prabhakar.
247
+ 31. `in.ernet.dli.2015.539046_dingal_me_veer_ras.txt` (622 KB): *Dingal Me Veer Ras*, Motilal Menariya.
248
+ 32. `in.ernet.dli.2015.443973_rajasthani_sanskrati_ra_chitram_mehar.txt` (590 KB): *Rajasthani Sanskrati Ra Chitram*, Jahur Khan Mehar.
249
+ 33. `in.ernet.dli.2015.442115_...txt` (577 KB): *Rajasthani Bhasha, Sahitya, Sanskriti*, Dr. Ramprasad Dadhich.
250
+ 34. `in.ernet.dli.2015.444852_dalpat_vilas_rawat_saraswat.txt` (544 KB): *Dalpat Vilas*, Rawat Saraswat.
251
+ 35. `in.ernet.dli.2015.443965_...txt` (539 KB): *Rajasthani Lok Sahitya Adhyan Ke Aayam*, Dr. Ramprasad Dadhich.
252
+ 36. `in.ernet.dli.2015.442351_parampra_mataji_ri_vachnika.txt` (477 KB): *Parampra - Mataji Ri Vachnika*, Jaychandra Jati.
253
+ 37. `saraswat_dingal_geet_1960.txt` (446 KB): *Dingal Geet*, Rawat Saraswat.
254
+ 38. `in.ernet.dli.2015.443715_sadayvts_veer_prabandh.txt` (414 KB): *Sadayvts Veer Prabandh*, Dr. Manjulal Majmudar.
255
+ 39. `in.ernet.dli.2015.444198_...txt` (395 KB): *Rajasthani Nibandh*, Manohar Sharma.
256
+ 40. `tessitori_veli_krisana_rukamani_ri_asiatic_1919.txt` (390 KB): *Veli Krisana Rukamani Ri (Asiatic Society Edition)*, Dr. L.P. Tessitori.
257
+ 41. `in.ernet.dli.2015.444365_...txt` (363 KB): *Rajasthani Kahani Sangrah (Jaagati Jot)*, Ramesh Dayal.
258
+ 42. `in.ernet.dli.2015.309837_rajasthani_bhag1_narottamdas_swami.txt` (361 KB): *Rajasthani (Bhag 1)*, Swami Narottamdas.
259
+ 43. `in.ernet.dli.2015.444217_rajasthan_ke_kavi_rawat_saraswat.txt` (334 KB): *Rajasthan Ke Kavi*, Rawat Saraswat.
260
+ 44. `in.ernet.dli.2015.401029_rajasthani_bheel_geet_pt2_sharma.txt` (331 KB): *Rajasthani Bheel Geet (Part 2)*, Giridhar Sharma.
261
+ 45. `in.ernet.dli.2015.444215_rohidai_ra_phool_manohar_sharma.txt` (308 KB): *Rohidai Ra Phool*, Dr. Manohar Sharma.
262
+ 46. `narsi_mehta_ka_bada_mamera_marwari.txt` (294 KB): *Narsi Mehta Ka Bada Mamera*, Ram Ratan Darak.
263
+ 47. `in.ernet.dli.2015.307534_rajasthani_lokotsav_gindaram_varma.txt` (268 KB): *Rajasthani Lokotsav*, Gindaram Varma.
264
+ 48. `in.ernet.dli.2015.550743_rajasthani_padh_sangrah_komal_kothari.txt` (256 KB): *Rajasthani Padh Sangrah*, Komal Kothari.
265
+ 49. `menariya_rajasthani_rooprekha_1953.txt` (254 KB): *Rajasthani Bhasha Ki Rooprekha*, Purushottam Menariya.
266
+ 50. `tessitori_vithu_sujo_chanda_rau_jeta_si_ro_1920.txt` (232 KB): *Chhanda Rau Jeta Si Ro*, Vithu Sujo / Dr. L.P. Tessitori.
267
+ 51. `in.ernet.dli.2015.547214_hadi_shatak_nathusingh_mahiyariya.txt` (146 KB): *Hadi Shatak*, Kavi Nathusingh Mahiyariya.
268
+ 52. `chatterji_rajasthani_bhasha_1949.txt` (108 KB): *Rajasthani Bhasha*, Dr. Suniti Kumar Chatterji.
269
+ 53. `chandra_singh_loo_1955.txt` (78 KB): *Loo (Ritu Kavya)*, Chandra Singh Birbhadur.
270
+ *(Total corpus: 56 files, 64.02 MB / 67,127,827 bytes across 53 cataloged works).*
271
+
272
+ ---
273
+
274
+ ## 4. Lexicon, Folklore & Cultural Heritage
275
+ - **Lexicon**: **1,813+ fully verified lemmas** with Devanagari, IAST romanization, detailed English meaning, Hindi gloss, grammatical POS, gender, dialect, and illustrative example sentences across 55+ domains.
276
+ - **Idioms (मुहावरा)**: **60 authentic idioms** with cultural contexts.
277
+ - **Proverbs (कहावत / औखाणा)**: **60 traditional proverbs** with translations and contexts.
278
+ - **Riddles (आड़ी / बुझावळ)**: **25 traditional riddles** with solutions and cultural metaphors.
279
+ - **Lifecycle Rituals (36 items)**: Birth, childhood, marriage, seasonal fasts, and memorial rites (`मायरो/भात`, `सामेलो`, `तोरण मारणो`, `बान बैठणो`, `रातीजगो`, `हथलेवो`, `कंकण-डोरा खोलणो`, `सीख/विदाई`, `मुकलावो`).
280
+ - **Traditional Ornaments (53 items)**: Head to toe (`रखड़ी`, `बोरलो`, `शीशफूल`, `मेमंद`, `नथ`, `बेसरी`, `आड़`, `तिमणियो`, `चंपाकली`, `हंसली`, `बाजूबंद`, `हाथीदांत रो चूड़ो`, `गोखरू`, `अरसी`, `कंदोरो`, `आंवळा`, `नेवरी`, `रमझोल`, `बिछिया`).
281
+ - **Extended Kinship (58 relations)**: Patrilineal, matrilineal, affinal, sworn, and ceremonial roles.
282
+ - **Traditional Ornaments (53 items)**: Head to toe (`रखड़ी`, `बोरलो`, `शीशफूल`, `मेमंद`, `नथ`, `बेसरी`, `आड़`, `तिमणियो`, `चंपाकली`, `हंसली`, `बाजूबंद`, `हाथीदांत रो चूड़ो`, `गोखरू`, `अरसी`, `कंदोरो`, `आंवळा`, `नेवरी`, `रमझोल`, `बिछिया`).
283
+ - **Extended Kinship (58 relations)**: Patrilineal, matrilineal, affinal, sworn, and ceremonial roles.
284
+
285
+ ---
286
+
287
+ ## 5. Web UI & REST API Endpoints
288
+ Run the built-in HTTP server:
289
+ ```bash
290
+ rajasthani web --port 8000
291
+ ```
292
+ Or programmatically:
293
+ ```python
294
+ import rajasthani
295
+ rajasthani.run_server(port=8000)
296
+ ```
297
+ Interactive Endpoints:
298
+ - `GET /api/translate?text=...&dialect=...` - Universal translator
299
+ - `GET /api/conjugate?verb=...&tense=...` - Morphological verb conjugator
300
+ - `GET /api/dictionary?q=...` - Full-text lexicon search (1,204+ words)
301
+ - `GET /api/numbers?val=...` - Number to Devanagari words & digits
302
+ - `GET /api/rituals?category=...` - Traditional lifecycle rituals (36 entries)
303
+ - `GET /api/ornaments?part=...` - Traditional jewelry (53 entries)
304
+ - `GET /api/syntax` - Structured syntax, split-ergativity, causatives, and dialect rules
305
+ - `GET /api/corpus` - Catalog of 40 digitized historical texts (48.72 MB)
306
+ - `GET /api/idioms` - Authentic idioms and sayings (52 entries)
307
+ - `GET /api/folklore` - Folk proverbs and riddles (62 entries)
308
+
309
+ ---
310
+
311
+ ## 6. Python API Reference
312
+ ```python
313
+ import rajasthani
314
+
315
+ # 1. Dictionary & Lexicon (1,204+ words)
316
+ w = rajasthani.lookup("सांग")
317
+ print(w.english) # "traditional Rajput iron lance or javelin wielded on horseback"
318
+
319
+ # 2. Syntax & Sentence Construction
320
+ s = rajasthani.hindi_to_rajasthani("मैं पानी पी रहा था", dialect=rajasthani.Dialect.MARWARI)
321
+ # -> "म्हूँ पाणी पी रह्यो थो"
322
+
323
+ # 3. Compound Verbs
324
+ cv = rajasthani.build_compound_verb("खाणो", vector_verb="लेणो", tense=rajasthani.Tense.PAST)
325
+ # -> "खाय लियो"
326
+
327
+ # 4. Complex Correlatives & Counterfactuals
328
+ sent = rajasthani.build_complex_sentence("मेह बरस्यो", "फसल चोखी व्हैला", connector_type="conditional")
329
+ # -> "जे मेह बरस्यो, तो फसल चोखी व्हैला।"
330
+
331
+ cf = rajasthani.build_counterfactual_conditional("मेह बरसतो", "अकाल नीं पड़तो")
332
+ # -> "जे मेह बरसतो, तो अकाल नीं पड़तो।"
333
+
334
+ # 5. Echo Words & Expressive Superlatives
335
+ echo = rajasthani.build_echo_word("रोटी") # "रोटी-ओटी"
336
+ intl = rajasthani.intensify_adjective("धोळो") # "धोळो-धम्मक"
337
+
338
+ # 6. Reported Speech & Rhetorical Questions
339
+ rep = rajasthani.convert_reported_speech("राजा", "म्हूँ काल जावूं") # "राजा कह्यो कै वो काल जासी।"
340
+ rq = rajasthani.build_rhetorical_question("थे चालो हो", tag_type="neen") # "थे चालो हो, नीं?"
341
+
342
+ # 7. Causatives & Imperatives
343
+ caus1 = rajasthani.generate_causative("करणो", level=1) # "करावणो"
344
+ imp_royal = rajasthani.build_imperative("बैठणो", politeness_level="honorific") # "आप विराजो सा"
345
+
346
+ # 8. Optatives & Folk Vat Narrative
347
+ blessing = rajasthani.build_optative("भगवान", "थारो भलो करै") # "भगवान थारो भलो करै!"
348
+ vat = rajasthani.build_vat_narrative("राव जेतासी", "बीकानेर दुर्ग", "शत्रु दल नै परास्त कियो")
349
+
350
+ # 9. Clusivity & Passive Voice
351
+ incl = rajasthani.convert_clusivity("हम चालेंगे", inclusive=True) # "आपां चालेंगे"
352
+ pass_sent = rajasthani.transform_voice("राम पोथी बांचै है") # "राम रै हाथूं पोथी बंचीजै है।"
353
+ ```
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Akshat Singh Bisht
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the Software), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,7 @@
1
+ include README.md
2
+ include LICENSE
3
+ include requirements.txt
4
+ include DOCUMENTATION.md
5
+ recursive-include rajasthani/lexicon/data *.json
6
+ recursive-include rajasthani/culture/data *.json
7
+ recursive-include rajasthani/web/static *.*
@@ -0,0 +1,163 @@
1
+ Metadata-Version: 2.4
2
+ Name: rajasthani
3
+ Version: 1.0.0
4
+ Summary: Rajasthani (राजस्थानी) Language Standard Library: Multi-Dialect Translation, Morphological Conjugation, Voice Processing & Cultural Heritage
5
+ Home-page: https://github.com/infoakshatsinghbisht-eng/Rajasthani-Language-Library
6
+ Author: Akshat Singh Bisht
7
+ Author-email: Akshat Singh Bisht <infoakshatsinghbisht@gmail.com>
8
+ Maintainer: Akshat Singh Bisht
9
+ Maintainer-email: infoakshatsinghbisht@gmail.com
10
+ License: MIT
11
+ Project-URL: Homepage, https://akshatsinghbisht.com/
12
+ Project-URL: GitHub, https://github.com/infoakshatsinghbisht-eng/Rajasthani-Language-Library
13
+ Project-URL: LinkedIn, https://www.linkedin.com/in/akshat-singh-bisht-digital-performance-marketing-specialist/
14
+ Project-URL: Amazon Author, https://www.amazon.com/stores/Akshat-Singh-Bisht/author/B0D5TYDT28
15
+ Project-URL: ResearchGate, https://www.researchgate.net/profile/Akshat-Bisht-8
16
+ Project-URL: Bug Tracker, https://github.com/infoakshatsinghbisht-eng/Rajasthani-Language-Library/issues
17
+ Classifier: Programming Language :: Python :: 3
18
+ Classifier: Programming Language :: Python :: 3.9
19
+ Classifier: Programming Language :: Python :: 3.10
20
+ Classifier: Programming Language :: Python :: 3.11
21
+ Classifier: Programming Language :: Python :: 3.12
22
+ Classifier: Programming Language :: Python :: 3.13
23
+ Classifier: License :: OSI Approved :: MIT License
24
+ Classifier: Operating System :: OS Independent
25
+ Classifier: Topic :: Text Processing :: Linguistic
26
+ Requires-Python: >=3.9
27
+ Description-Content-Type: text/markdown
28
+ License-File: LICENSE
29
+ Dynamic: author
30
+ Dynamic: home-page
31
+ Dynamic: license-file
32
+ Dynamic: maintainer
33
+ Dynamic: maintainer-email
34
+ Dynamic: requires-python
35
+
36
+ # Rajasthani (राजस्थानी) Language Library for Python
37
+
38
+ A standard-library-style computational linguistics toolkit, translator, and grammar engine for the **Rajasthani language** (`ISO 639-3: raj / mwr`).
39
+
40
+ ## Features
41
+
42
+ 1. **Universal Translation Engine (`rajasthani.translate`, `rajasthani.hindi_to_rajasthani`)**:
43
+ - Translate from English, Hindi, and world languages into Rajasthani.
44
+ - Dialect support: Marwari (`mwr`), Mewari (`mew`), Dhundhari (`dhd`), Harauti (`hoj`), Shekhawati (`swv`).
45
+ 2. **Morphological Verb Conjugator & Syntax Engine**:
46
+ - Conjugates verbs across tenses (Present, Past, Future, Continuous, Presumptive, Imperative).
47
+ - Compound verbs with aspectual vectors (`rajasthani.build_compound_verb` - `खाय लियो`, `दे दीनो`, `चाल पड़्यो`, `मार नांख्यो`).
48
+ - Correlative complex clauses (`rajasthani.build_complex_sentence` - `जे... तो`, `जद... तद`, `जको... वो`, `जठै... वठै`).
49
+ - Adverbial manner correlatives (`rajasthani.build_manner_correlative` - `जियां कह्यो, तियां कर्यो।`).
50
+ - Habitual / frequentative aspect builder (`rajasthani.build_habitual_aspect` - `वो रोज सवेरै पोथी बांचवा लाग्यो।`).
51
+ - Interrogative transformations (`rajasthani.transform_interrogative` - polar: `कांईं राम पोथी पढ़ै है?`, content: `राम कद जासी?`).
52
+ - Protective negative optatives (`rajasthani.build_negative_optative` - `भगवान थारो रो बुरो नीं करै!`).
53
+ - Compound postposition synthesis (`rajasthani.attach_compound_postposition` - `रै सागै`, `रै कारणै`, `रै बिना`, `रै खातर`).
54
+ - Past counterfactual conditionals (`rajasthani.build_counterfactual_conditional` - `जे मेह बरसतो, तो अकाल नीं पड़तो`).
55
+ - Benedictions and optative wishes (`rajasthani.build_optative` - `भगवान थारो भलो करै!`).
56
+ - Classical folk vat narrative builder (`rajasthani.build_vat_narrative` - authentic story discourse).
57
+ - Split ergativity past alignment with direct object agreement (`rajasthani.apply_ergative_construction` - `राम नै पोथी पढ़ी` vs `राम नै आंबा खायो`).
58
+ - Bidirectional passive/active voice transformation (`rajasthani.transform_voice` - `-ईजै` / `-इजै`).
59
+ - Politeness elevation into royal courtly register (`rajasthani.elevate_politeness` - `आरोगो सा हुकम`, `विराजो सा हुकम`).
60
+ - Dubitative / speculative mood sentence builder (`rajasthani.build_dubitative_sentence` - `शायद काल मेह बरसैला।`).
61
+ - Vat narrative discourse clause connectives (`rajasthani.connect_discourse` - `तदन्तर`, `इण वास्तै`, `पण`, `ज्यूं ही... त्यूं ही`).
62
+ - Reduplicated echo words (`rajasthani.build_echo_word` - `रोटी-ओटी`, `पाणी-धाणी`, `चाय-वाय`).
63
+ - Expressive absolute superlatives (`rajasthani.intensify_adjective` - `धोळो-धम्मक`, `काळो-भम्मक`, `मीठो-मध`).
64
+ - Narrative indirect reported speech (`rajasthani.convert_reported_speech` - `राजा कह्यो कै वो काल जासी।`).
65
+ - Rhetorical question tags (`rajasthani.build_rhetorical_question` - `... नीं?`, `... कांईं?`).
66
+ - Causative morphology derivation (`rajasthani.generate_causative` - `करावणो`, `करवावणो`, `जिमावणो`, `जिमवावणो`).
67
+ - Imperative directives across 4 politeness tiers (`rajasthani.build_imperative` - intimate, familiar, polite, honorific).
68
+ - Pronoun clusivity conversion (`rajasthani.convert_clusivity` - `आपां` inclusive vs `म्हे` exclusive).
69
+ 3. **Mega Lexicon, Idioms & Folklore**:
70
+ - **1,813+** cataloged and fully verified words with Devanagari, English, Hindi, POS, gender, dialect, and example sentences across 55+ categories.
71
+ - **60 authentic idioms** (मुहावरे) with cultural contexts.
72
+ - **60 traditional proverbs** (कहावतें / औखाणा).
73
+ - **25 folk riddles** (पहेलियाँ / आड़ी / बुझावळ).
74
+ 4. **Kinship & Clan Taxonomy (`rajasthani.resolve_kinship`)**:
75
+ - 58 distinct relationships across patrilineal, matrilineal, affinal (`साढू`, `नणदोई`, `ब्याई`, `ब्याण`), sworn (`धरम-भाई`, `पगड़ी-बदल भाई`), and wedding companions (`कामोतर`, `ओळंदी`).
76
+ 5. **Traditional Ornaments & Lifecycle Rituals (`rajasthani.culture`)**:
77
+ - 36 lifecycle rituals (जन्म, मुंडन, ब्याव, माहेरो, रातीजोगा, तोरण, सीख, मुकलावो).
78
+ - 53 traditional head-to-toe ornaments (`रखड़ी`, `बोरलो`, `शीशफूल`, `आड़`, `तिमणियो`, `गोखरू`, `आंवळा`, `रमझोल`, `बिछिया`).
79
+ 6. **Numbers & Numerals (`rajasthani.num_to_words`)**:
80
+ - Full integer to word conversion (0 to 100,000,000+), Devanagari numerals (०-९), ordinals, and fractions.
81
+ 7. **Digitized Primary Corpus (56 Historical Files, ~64.02 MB, 53 Cataloged Works)**:
82
+ - Complete transcripts in `data_sources/raw_texts/` including *A Dictionary Of Rajasthani Proverbs* (Bijaydan Detha "Biji"), *Rajasthani Vratkathae* (Mohanlal Purohit), *Rajasthani Sanskrati Ra Chitram* (Jahur Khan Mehar), *Dalpat Vilas* (Rawat Saraswat), *Rajasthani Sabad Kos* (Vols 2-1, 2-2 & 4 by Dr. Sitaram Lalas), *Rajasthani Kahawat Kosh* (Bhagirath Kanoria), *Parmpara Rajasthani Baat-sangrah* (Dr. Narayansingh Bhati), *Rajasthani Lokotsav* (Gindaram Varma), *Rajasthani Gadhya-Sahitya* (Dr. Shivswaroop Sharma), *Rajasthani Gadh Vikas Aur Prakash* (Dr. Narendra Bhanawat), *Rajasthani Padh Sangrah* (Komal Kothari), *Hadi Shatak* (Kavi Nathusingh), *Dhola Maru Ra Dhoha*, *Kanhadade Prabandha*, *Chhanda Rau Jeta Si Ro*, *Veli Krisan Rukmani Ri*, *Veer Satsai*, *Parampra Dingal Kosh*, and Grierson's *LSI*.
83
+ 8. **Interactive Web UI & CLI**:
84
+ - Built-in zero-dependency web server (`rajasthani web --port 8000`) with REST API and responsive 7-tab dashboard.
85
+ - **100 passing unit tests** verifying all grammar, lexicon, syntax, and folklore modules.
86
+
87
+ ## Installation
88
+
89
+ ```bash
90
+ pip install -e .
91
+ ```
92
+
93
+ ## Quick Start
94
+
95
+ ```python
96
+ import rajasthani
97
+
98
+ # 1. Translation & Conversion
99
+ print(rajasthani.translate("How are you?").text) # थें कियां हो सा?
100
+ print(rajasthani.hindi_to_rajasthani("मैं पानी पी रहा था")) # म्हूँ पाणी पी रह्यो थो
101
+
102
+ # 2. Causatives & Compound Verbs
103
+ print(rajasthani.generate_causative("करणो", level=1)) # करावणो
104
+ print(rajasthani.generate_causative("करणो", level=2)) # करवावणो
105
+ print(rajasthani.build_compound_verb("खाणो", vector_verb="लेणो", tense=rajasthani.Tense.PAST)) # खाय लियो
106
+
107
+ # 3. Correlative Sentences, Counterfactuals & Imperatives
108
+ print(rajasthani.build_complex_sentence("मेह बरस्यो", "फसल चोखी व्हैला", connector_type="conditional"))
109
+ # -> जे मेह बरस्यो, तो फसल चोखी व्हैला।
110
+ print(rajasthani.build_counterfactual_conditional("मेह बरसतो", "अकाल नीं पड़तो"))
111
+ # -> जे मेह बरसतो, तो अकाल नीं पड़तो।
112
+ print(rajasthani.build_imperative("बैठणो", politeness_level="honorific")) # आप विराजो सा
113
+
114
+ # 4. Optatives & Folk Vat Prose
115
+ print(rajasthani.build_optative("भगवान", "थारो भलो करै")) # भगवान थारो भलो करै!
116
+ print(rajasthani.build_vat_narrative("राव जेतासी", "बीकानेर दुर्ग", "शत्रु दल नै परास्त कियो"))
117
+
118
+ # 5. Clusivity & Passive Voice
119
+ print(rajasthani.convert_clusivity("हम सब साथ चलेंगे", inclusive=True)) # आपां सब साथ चलेंगे
120
+ print(rajasthani.transform_voice("राम पोथी बांचै है")) # राम रै हाथूं पोथी बंचीजै है।
121
+
122
+ # 6. Lexicon & Folklore
123
+ word = rajasthani.lookup("सांग")
124
+ print(word.english) # traditional Rajput iron lance or javelin wielded on horseback
125
+
126
+ # 7. Kinship & Culture
127
+ term = rajasthani.resolve_kinship("साढू")
128
+ print(term.english) # husband of one's wife's sister (co-brother-in-law)
129
+ ```
130
+
131
+ ## CLI Usage
132
+
133
+ ```bash
134
+ # Translation
135
+ rajasthani translate "How are you?"
136
+ rajasthani translate "Welcome" --dialect dhd
137
+
138
+ # Verb Conjugation
139
+ rajasthani conjugate खाणो --tense past --gender feminine
140
+
141
+ # Number conversion
142
+ rajasthani num 105
143
+
144
+ # Dictionary
145
+ rajasthani dict चोखो
146
+
147
+ # Kinship resolution
148
+ rajasthani kinship मामो
149
+
150
+ # Launch Local Web UI
151
+ rajasthani web --port 8000
152
+ ```
153
+
154
+ ## Running Tests
155
+
156
+ ```bash
157
+ python -m unittest discover -s tests -p "test_*.py"
158
+ ```
159
+ **84 unit tests pass in ~0.03s with 100% success rate.**
160
+
161
+ ## License
162
+
163
+ MIT License.