widegita 0.1.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,336 @@
+# widegita
+
+[![npm](https://img.shields.io/npm/v/widegita)](https://www.npmjs.com/package/widegita)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Zero Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)](https://www.npmjs.com/package/widegita)
+
+TypeScript SDK for [WideGita](https://widegita.com) — access the Bhagavad Gita's 18 chapters and 6,308 verses across 9 commentator translations, 2,103 commentary entries from classical Acharyas, 10 principal Upanishads, all 196 Yoga Sutras of Patanjali, Hindu deities, philosophical concepts, and a comprehensive Sanskrit glossary. Zero runtime dependencies, uses native `fetch`.
+
+WideGita is part of the [WideHoly](https://wideholy.com) multi-religion scripture platform, providing structured access to Hindu sacred texts. The REST API serves verse-level data with Sanskrit originals, IAST transliterations, and multiple English translations from scholars including Swami Sivananda, Swami Gambhirananda, and Sri Ramanuja.
+
+> **Explore the Bhagavad Gita at [widegita.com](https://widegita.com)** — [Chapters](https://widegita.com/chapters/), [Commentaries](https://widegita.com/commentaries/), [Upanishads](https://widegita.com/upanishads/), [Yoga Sutras](https://widegita.com/yoga-sutras/), [Deities](https://widegita.com/deities/)
+
+## Table of Contents
+
+- [Install](#install)
+- [Quick Start](#quick-start)
+- [What You'll Find on WideGita](#what-youll-find-on-widegita)
+  - [Bhagavad Gita Chapters & Verses](#bhagavad-gita-chapters--verses)
+  - [Commentary Traditions](#commentary-traditions)
+  - [Upanishads](#upanishads)
+  - [Yoga Sutras of Patanjali](#yoga-sutras-of-patanjali)
+  - [Hindu Deities & Concepts](#hindu-deities--concepts)
+- [API Reference](#api-reference)
+- [TypeScript Types](#typescript-types)
+- [API Endpoints](#api-endpoints)
+- [Learn More About Hindu Scripture](#learn-more-about-hindu-scripture)
+- [Also Available for Python](#also-available-for-python)
+- [WideHoly Scripture Platform](#wideholy-scripture-platform)
+- [License](#license)
+
+## Install
+
+```bash
+npm install widegita
+```
+
+## Quick Start
+
+```typescript
+import { WideGita } from "widegita";
+
+const api = new WideGita();
+
+// Get chapter 2 — Sankhya Yoga (the Yoga of Knowledge)
+const chapter = await api.getChapter(2);
+console.log(chapter.name);        // "Sankhya Yoga"
+console.log(chapter.verse_count); // 72
+
+// Read the most famous verse: Bhagavad Gita 2.47
+// "You have a right to perform your prescribed duty,
+//  but you are not entitled to the fruits of action."
+const verse = await api.getVerse(2, 47);
+console.log(verse.text_sanskrit);
+console.log(verse.text);
+
+// Search across all 6,308 verses for references to dharma
+const results = await api.search("dharma");
+for (const v of results.results.slice(0, 5)) {
+  console.log(`${v.reference}: ${v.text.slice(0, 80)}...`);
+}
+
+// Explore Yoga Sutra 1.2 — Patanjali's definition of yoga
+const sutra = await api.getYogaSutra("1-2");
+console.log(sutra.translation_text);
+// "Yoga is the cessation of the modifications of the mind"
+```
+
+## What You'll Find on WideGita
+
+### Bhagavad Gita Chapters & Verses
+
+The Bhagavad Gita consists of 18 chapters, each representing a different yoga (path of spiritual practice). Set on the battlefield of Kurukshetra, the dialogue between Lord Krishna and the warrior Arjuna addresses fundamental questions of duty, righteousness, devotion, and liberation.
+
+| Ch | Name | Verses | Theme |
+|----|------|--------|-------|
+| 1 | Arjuna Vishada Yoga | 47 | The crisis of conscience on the battlefield |
+| 2 | Sankhya Yoga | 72 | The immortal Self, duty without attachment |
+| 3 | Karma Yoga | 43 | The path of selfless action |
+| 4 | Jnana Karma Sannyasa Yoga | 42 | Divine knowledge and renunciation |
+| 5 | Karma Sannyasa Yoga | 29 | Action vs. renunciation |
+| 6 | Dhyana Yoga | 47 | Meditation and self-mastery |
+| 7 | Jnana Vijnana Yoga | 30 | Knowledge of the Absolute |
+| 8 | Aksara Brahma Yoga | 28 | The imperishable Brahman |
+| 9 | Raja Vidya Raja Guhya Yoga | 34 | The royal knowledge and secret |
+| 10 | Vibhuti Yoga | 42 | Divine manifestations |
+| 11 | Vishvarupa Darshana Yoga | 55 | The cosmic form of Krishna |
+| 12 | Bhakti Yoga | 20 | The path of devotion |
+| 13 | Kshetra Kshetrajna Vibhaga Yoga | 35 | The field and the knower |
+| 14 | Gunatraya Vibhaga Yoga | 27 | The three gunas (qualities) |
+| 15 | Purushottama Yoga | 20 | The Supreme Person |
+| 16 | Daivasura Sampad Vibhaga Yoga | 24 | Divine and demoniac natures |
+| 17 | Shraddhatraya Vibhaga Yoga | 28 | Three types of faith |
+| 18 | Moksha Sannyasa Yoga | 78 | Liberation through renunciation |
+
+WideGita provides 6,308 verses across 9 commentator translations, each verse with the original Sanskrit text, IAST transliteration, and English translation.
+
+```typescript
+const api = new WideGita();
+
+// List all 18 chapters with verse counts and yoga names
+const chapters = await api.listChapters();
+for (const ch of chapters.results) {
+  console.log(`Ch ${ch.number}: ${ch.yoga_name} — ${ch.verse_count} verses`);
+}
+
+// Get verse with Sanskrit original and transliteration
+const verse = await api.getVerse(2, 47, "sivananda");
+console.log(verse.text_sanskrit);   // Original Devanagari
+console.log(verse.transliteration); // IAST romanization
+console.log(verse.text);            // English translation
+```
+
+Learn more: [Gita Chapters](https://widegita.com/chapters/) · [Verse Browser](https://widegita.com/verses/)
+
+### Commentary Traditions
+
+The Bhagavad Gita has been interpreted by the greatest minds of Indian philosophy. WideGita includes 2,103 commentary entries from 9 classical commentators spanning the major Vedantic traditions.
+
+| Commentator | Tradition | Period | Philosophy |
+|-------------|-----------|--------|------------|
+| Adi Shankaracharya | Advaita Vedanta | 8th century | Non-dualism (Brahman alone is real) |
+| Ramanujacharya | Vishishtadvaita | 11th century | Qualified non-dualism |
+| Madhvacharya | Dvaita Vedanta | 13th century | Dualism (jiva and Brahman are distinct) |
+| Swami Sivananda | Neo-Vedanta | 20th century | Practical synthesis of yoga paths |
+| Swami Gambhirananda | Advaita Vedanta | 20th century | Scholarly Shankara tradition |
+| Sri Abhinavagupta | Kashmir Shaivism | 10th century | Tantric non-dualism |
+| Vallabhacharya | Shuddhadvaita | 15th century | Pure non-dualism (devotion-centric) |
+| Sridhara Swami | Advaita Vedanta | 14th century | Bridge between Advaita and Bhakti |
+| Baladeva Vidyabhushana | Gaudiya Vaishnavism | 18th century | Acintya Bheda Abheda |
+
+```typescript
+const api = new WideGita();
+
+// List commentaries filtered by Advaita tradition
+const advaita = await api.listCommentaries({ tradition: "advaita" });
+for (const c of advaita.results) {
+  console.log(`${c.author} — ${c.name}`);
+}
+
+// Get Shankaracharya's commentary entries for chapter 2
+const entries = await api.getCommentaryEntries({
+  commentary__slug: "shankaracharya",
+  chapter__number: "2",
+});
+for (const e of entries.results.slice(0, 3)) {
+  console.log(`Verses ${e.verse_start}-${e.verse_end}: ${e.text.slice(0, 100)}...`);
+}
+```
+
+Learn more: [Commentary Traditions](https://widegita.com/commentaries/) · [Glossary of Terms](https://widegita.com/glossary/)
+
+### Upanishads
+
+The Upanishads are the philosophical culmination of the Vedas, exploring the nature of Brahman (ultimate reality), Atman (the Self), and the path to liberation. WideGita covers the 10 principal (Mukhya) Upanishads acknowledged by Adi Shankaracharya.
+
+| Upanishad | Veda | Key Teaching |
+|-----------|------|-------------|
+| Isha | Yajur Veda | The Lord pervades all; renunciation and enjoyment |
+| Kena | Sama Veda | The unknowable nature of Brahman |
+| Katha | Yajur Veda | Nachiketa's dialogue with Death; the immortal Self |
+| Prashna | Atharva Veda | Six questions on the nature of creation and prana |
+| Mundaka | Atharva Veda | Higher vs. lower knowledge; Brahman as the thread |
+| Mandukya | Atharva Veda | AUM and the four states of consciousness |
+| Taittiriya | Yajur Veda | Five sheaths (koshas) of the Self |
+| Aitareya | Rig Veda | Creation from Atman; the nature of consciousness |
+| Chandogya | Sama Veda | "Tat Tvam Asi" — Thou art That |
+| Brihadaranyaka | Yajur Veda | The largest Upanishad; Yajnavalkya's teachings |
+
+```typescript
+const api = new WideGita();
+
+// List only the 10 principal Upanishads
+const principal = await api.listUpanishads({ is_principal: "true" });
+for (const u of principal.results) {
+  console.log(`${u.name} (${u.sanskrit_name}) — ${u.veda}`);
+}
+
+// Get details for the Katha Upanishad
+const katha = await api.getUpanishad("katha");
+console.log(katha.description);
+```
+
+Learn more: [Upanishads](https://widegita.com/upanishads/) · [Hindu Concepts](https://widegita.com/concepts/)
+
+### Yoga Sutras of Patanjali
+
+The Yoga Sutras are 196 concise aphorisms compiled by the sage Patanjali, forming the foundational text of Raja Yoga. The text is divided into four padas (chapters).
+
+| Pada | Name | Sutras | Focus |
+|------|------|--------|-------|
+| 1 | Samadhi Pada | 51 | The nature of yoga and states of absorption |
+| 2 | Sadhana Pada | 55 | Practice: Kriya Yoga, the Eight Limbs (Ashtanga) |
+| 3 | Vibhuti Pada | 56 | Supernatural powers (siddhis) arising from practice |
+| 4 | Kaivalya Pada | 34 | Liberation — the isolation of pure consciousness |
+
+The Eight Limbs of Yoga (Ashtanga Yoga): Yama, Niyama, Asana, Pranayama, Pratyahara, Dharana, Dhyana, and Samadhi.
+
+```typescript
+const api = new WideGita();
+
+// List all sutras in Samadhi Pada (Chapter 1)
+const pada1 = await api.listYogaSutras({ pada: "1" });
+console.log(`Samadhi Pada: ${pada1.count} sutras`);
+
+// Get the famous definition of yoga (Sutra 1.2)
+// "Yogas chitta vritti nirodhah"
+const sutra = await api.getYogaSutra("1-2");
+console.log(sutra.text_sanskrit);
+console.log(sutra.translation_text);
+```
+
+Learn more: [Yoga Sutras](https://widegita.com/yoga-sutras/) · [Topics](https://widegita.com/topics/)
+
+### Hindu Deities & Concepts
+
+WideGita covers the major deities of the Hindu pantheon and core philosophical concepts that underpin the Gita's teachings. The deity database includes the Trimurti (Brahma, Vishnu, Shiva), their avatars, consorts, and associated traditions.
+
+| Concept | Sanskrit | Meaning |
+|---------|----------|---------|
+| Dharma | Dharma | Cosmic order, righteousness, duty |
+| Karma | Karma | Action and its consequences across lifetimes |
+| Moksha | Moksha | Liberation from the cycle of birth and death |
+| Atman | Atman | The eternal Self, identical with Brahman |
+| Brahman | Brahman | The ultimate, formless reality |
+| Maya | Maya | The illusory nature of the phenomenal world |
+
+```typescript
+const api = new WideGita();
+
+// List deities filtered by tradition
+const vaishnava = await api.listDeities({ tradition: "vaishnavism" });
+for (const d of vaishnava.results) {
+  console.log(`${d.name} (${d.sanskrit_name})`);
+}
+
+// List philosophical concepts and browse the Sanskrit glossary
+const concepts = await api.listConcepts({ category: "vedanta" });
+const glossary = await api.listGlossary();
+const topics = await api.listTopics();
+```
+
+Learn more: [Hindu Deities](https://widegita.com/deities/) · [Concepts](https://widegita.com/concepts/) · [Sanskrit Glossary](https://widegita.com/glossary/)
+
+## API Reference
+
+| Method | Arguments | Returns | Description |
+|--------|-----------|---------|-------------|
+| `new WideGita(baseUrl?)` | `baseUrl` | `WideGita` | Create API client |
+| `listChapters()` | — | `ListResponse<Chapter>` | List all 18 Gita chapters |
+| `getChapter(number)` | `number: number` | `Chapter` | Get chapter by number (1-18) |
+| `getVerse(chapter, verse, translation?)` | `chapter`, `verse`, `translation` | `Verse` | Get specific verse |
+| `search(query, limit?)` | `query: string`, `limit = 25` | `ListResponse<Verse>` | Search verse texts |
+| `listCommentaries(params?)` | `Record<string, string>` | `ListResponse<Commentary>` | List commentaries |
+| `getCommentaryEntries(params?)` | `Record<string, string>` | `ListResponse<CommentaryEntry>` | List commentary entries |
+| `listUpanishads(params?)` | `Record<string, string>` | `ListResponse<Upanishad>` | List Upanishads |
+| `getUpanishad(slug)` | `slug: string` | `Upanishad` | Get Upanishad by slug |
+| `listYogaSutras(params?)` | `Record<string, string>` | `ListResponse<YogaSutra>` | List Yoga Sutras |
+| `getYogaSutra(slug)` | `slug: string` | `YogaSutra` | Get Yoga Sutra by slug |
+| `listDeities(params?)` | `Record<string, string>` | `ListResponse<Deity>` | List Hindu deities |
+| `getDeity(slug)` | `slug: string` | `Deity` | Get deity by slug |
+| `listConcepts(params?)` | `Record<string, string>` | `ListResponse<Concept>` | List philosophical concepts |
+| `listTopics()` | — | `ListResponse<Topic>` | List Gita topics |
+| `listGlossary()` | — | `ListResponse<GlossaryTerm>` | List Sanskrit glossary terms |
+
+## TypeScript Types
+
+All response types are exported: `Chapter`, `Verse`, `Commentary`, `CommentaryEntry`, `Upanishad`, `YogaSutra`, `Deity`, `Concept`, `Topic`, `GlossaryTerm`, and `ListResponse<T>` (paginated wrapper with `count`, `next`, `previous`, `results`).
+
+```typescript
+import type { Chapter, Verse, ListResponse } from "widegita";
+```
+
+## API Endpoints
+
+Base URL: `https://widegita.com/api/v1/gita`
+
+| Endpoint | Description |
+|----------|-------------|
+| `GET /chapters/` | List all 18 Gita chapters |
+| `GET /chapters/{number}/` | Get chapter by number |
+| `GET /verses/?search=query` | List/search verses (filterable by chapter, translation) |
+| `GET /commentaries/` | List commentaries (filterable by tradition) |
+| `GET /commentary-entries/` | List commentary entries (filterable) |
+| `GET /upanishads/` | List Upanishads (filterable by veda, is_principal) |
+| `GET /upanishads/{slug}/` | Get Upanishad details |
+| `GET /yoga-sutras/` | List Yoga Sutras (filterable by pada) |
+| `GET /yoga-sutras/{slug}/` | Get Yoga Sutra details |
+| `GET /deities/{slug}/` | Get deity details |
+| `GET /concepts/` | List philosophical concepts |
+| `GET /topics/` | List Gita topics |
+| `GET /glossary/` | List Sanskrit glossary terms |
+
+Full API documentation at [widegita.com/developers/](https://widegita.com/developers/). OpenAPI 3.1 spec: [widegita.com/api/openapi.json](https://widegita.com/api/openapi.json).
+
+## Learn More About Hindu Scripture
+
+- **Chapters**: [All 18 Chapters](https://widegita.com/chapters/) · [Commentary Traditions](https://widegita.com/commentaries/)
+- **Texts**: [Upanishads](https://widegita.com/upanishads/) · [Yoga Sutras](https://widegita.com/yoga-sutras/)
+- **Reference**: [Hindu Deities](https://widegita.com/deities/) · [Concepts](https://widegita.com/concepts/) · [Sanskrit Glossary](https://widegita.com/glossary/)
+- **Explore**: [Topics](https://widegita.com/topics/) · [Translations](https://widegita.com/translations/)
+- **API**: [REST API Docs](https://widegita.com/developers/) · [OpenAPI Spec](https://widegita.com/api/openapi.json)
+- **Python**: [PyPI Package](https://pypi.org/project/widegita/)
+
+## Also Available for Python
+
+```bash
+pip install widegita[api]
+```
+
+```python
+from widegita import WideGita
+
+with WideGita() as api:
+    chapter = api.get_chapter(2)
+    verse = api.get_verse(2, 47)
+```
+
+See the [Python SDK on PyPI](https://pypi.org/project/widegita/).
+
+## WideHoly Scripture Platform
+
+Part of the [WideHoly](https://wideholy.com) open-source multi-religion scripture platform.
+
+| Package | PyPI | npm | Description |
+|---------|------|-----|-------------|
+| **widegita** | [PyPI](https://pypi.org/project/widegita/) | [npm](https://www.npmjs.com/package/widegita) | Bhagavad Gita, Upanishads, Yoga Sutras — [widegita.com](https://widegita.com) |
+| widebible | [PyPI](https://pypi.org/project/widebible/) | [npm](https://www.npmjs.com/package/widebible) | Bible books, chapters, verses — [widebible.com](https://widebible.com) |
+| widequran | [PyPI](https://pypi.org/project/widequran/) | [npm](https://www.npmjs.com/package/widequran) | Quran surahs, ayahs, tafsirs — [widequran.com](https://widequran.com) |
+| widetorah | [PyPI](https://pypi.org/project/widetorah/) | [npm](https://www.npmjs.com/package/widetorah) | Torah, Talmud, Mishnah — [widetorah.com](https://widetorah.com) |
+| widesutra | [PyPI](https://pypi.org/project/widesutra/) | [npm](https://www.npmjs.com/package/widesutra) | Buddhist sutras, Tipitaka — [widesutra.com](https://widesutra.com) |
+| wideholy | [PyPI](https://pypi.org/project/wideholy/) | [npm](https://www.npmjs.com/package/wideholy) | Unified hub for all 5 religions — [wideholy.com](https://wideholy.com) |
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "widegita",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for WideGita -- Bhagavad Gita chapters, verses, commentaries, Upanishads, Yoga Sutras, Hindu deities, and Sanskrit glossary",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "bhagavad-gita",
+    "gita",
+    "hinduism",
+    "scripture",
+    "upanishads",
+    "yoga-sutras",
+    "patanjali",
+    "vedanta",
+    "sanskrit",
+    "hindu-deities",
+    "krishna",
+    "commentary",
+    "dharma",
+    "karma",
+    "moksha",
+    "api-client",
+    "widegita",
+    "wideholy",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dobestan/widegita-js"
+  },
+  "homepage": "https://widegita.com",
+  "license": "MIT",
+  "author": "WideHoly",
+  "devDependencies": {
+    "tsup": "^8.0",
+    "typescript": "^5.7",
+    "vitest": "^3.0"
+  }
+}