sunnah 1.4.0 → 1.5.0

package/books/jami-al-tirmidhi/README.md

@@ -0,0 +1,201 @@
+<div align="center">
+
+<h1>
+  <img src="https://em-content.zobj.net/source/apple/391/mosque_1f54c.png" width="36" />
+  &nbsp;jami-al-tirmidhi
+</h1>
+
+<p align="center">
+  <strong>The complete Jami al-Tirmidhi — 3,956 hadiths, full Arabic & English.</strong><br />
+  Offline-first · zero dependencies · published on both <strong>npm</strong> and <strong>PyPI</strong>.
+</p>
+
+<br />
+
+<p>
+  <a href="https://www.npmjs.com/package/jami-al-tirmidhi">
+    <img src="https://img.shields.io/npm/v/jami-al-tirmidhi?style=for-the-badge&logo=npm&logoColor=white&color=CB3837&labelColor=1a1a1a" />
+  </a>
+  &nbsp;
+  <a href="https://pypi.org/project/jami-al-tirmidhi/">
+    <img src="https://img.shields.io/pypi/v/jami-al-tirmidhi?style=for-the-badge&logo=pypi&logoColor=white&color=3775A9&labelColor=1a1a1a" />
+  </a>
+  &nbsp;
+  <a href="https://github.com/SENODROOM/jami-al-tirmidhi/blob/main/LICENSE">
+    <img src="https://img.shields.io/github/license/SENODROOM/jami-al-tirmidhi?style=for-the-badge&logo=gnu&logoColor=white&color=A42E2B&labelColor=1a1a1a" />
+  </a>
+</p>
+
+<p>
+  <img src="https://img.shields.io/badge/Node.js-%3E%3D18-339933?style=for-the-badge&logo=node.js&logoColor=white&labelColor=1a1a1a" />
+  &nbsp;
+  <img src="https://img.shields.io/badge/Python-%3E%3D3.8-3776AB?style=for-the-badge&logo=python&logoColor=white&labelColor=1a1a1a" />
+  &nbsp;
+  <img src="https://img.shields.io/badge/Zero-Dependencies-00C853?style=for-the-badge&logoColor=white&labelColor=1a1a1a" />
+  &nbsp;
+  <img src="https://img.shields.io/badge/TypeScript-Typed-3178C6?style=for-the-badge&logo=typescript&logoColor=white&labelColor=1a1a1a" />
+</p>
+
+</div>
+
+---
+
+## ✨ Features
+
+| | Feature | Details |
+|---|---|---|
+| 📚 | **Complete Collection** | All 3,956 authentic hadiths from Jami al-Tirmidhi |
+| 🌐 | **Bilingual** | Full Arabic text + English translation |
+| ⚡ | **Offline-first** | Data bundled — no CDN needed |
+| 🔧 | **Zero Dependencies** | Nothing extra to install |
+| 🔍 | **Full-text Search** | Search English text and narrator names instantly |
+| 🖥️ | **CLI** | Terminal access with Arabic/English/both flags |
+| ⚛️ | **React Hook** | One command generates `useTirmidhi()` |
+| 🐍 | **Python** | Identical API — same camelCase method names |
+| 📘 | **TypeScript** | Full type definitions included |
+
+---
+
+## 🚀 Installation
+
+```bash
+npm install jami-al-tirmidhi       # JS local
+npm install -g jami-al-tirmidhi    # JS global CLI
+pip install jami-al-tirmidhi       # Python
+```
+
+---
+
+## 🟨 JavaScript / Node.js
+
+```javascript
+const tirmidhi = require('jami-al-tirmidhi');  // CJS
+import tirmidhi from 'jami-al-tirmidhi';       // ESM
+
+tirmidhi.get(1)
+tirmidhi.getByChapter(1)
+tirmidhi.search('prayer')
+tirmidhi.search('prayer', 5)
+tirmidhi.getRandom()
+tirmidhi[0]
+tirmidhi.length
+tirmidhi.metadata
+tirmidhi.chapters
+tirmidhi.find(h => h.id === 23)
+tirmidhi.filter(h => h.chapterId === 1)
+tirmidhi.slice(0, 10)
+```
+
+---
+
+## ⚛️ React
+
+```bash
+cd my-react-app
+tirmidhi --react    # generates src/hooks/useTirmidhi.js
+```
+
+```jsx
+import { useTirmidhi } from '../hooks/useTirmidhi';
+
+function HadithOfTheDay() {
+  const tirmidhi = useTirmidhi();
+  if (!tirmidhi) return <p>Loading...</p>;
+  const h = tirmidhi.getRandom();
+  return <div><strong>{h.english.narrator}</strong><p>{h.english.text}</p></div>;
+}
+```
+
+---
+
+## 🐍 Python
+
+```python
+from jami_al_tirmidhi import Tirmidhi
+
+tirmidhi = Tirmidhi()
+
+tirmidhi.get(1)
+tirmidhi.getByChapter(1)
+tirmidhi.search("prayer")
+tirmidhi.search("prayer", limit=5)
+tirmidhi.getRandom()
+tirmidhi[0]
+tirmidhi.length
+tirmidhi.find(lambda h: h.id == 23)
+tirmidhi.filter(lambda h: h.chapterId == 1)
+tirmidhi.slice(0, 10)
+
+# Custom path
+tirmidhi = Tirmidhi(data_path="/path/to/tirmidhi.json")
+```
+
+---
+
+## 🖥️ CLI
+
+```bash
+tirmidhi 1
+tirmidhi 2345 -a           # Arabic only
+tirmidhi 2345 -b           # Arabic + English
+tirmidhi 23 34             # Hadith 34 within chapter 23
+tirmidhi --search "prayer"
+tirmidhi --search "fasting" --all
+tirmidhi --chapter 1
+tirmidhi --random
+tirmidhi --react
+tirmidhi --version
+```
+
+---
+
+## 📂 Structure
+
+```
+jami-al-tirmidhi/
+├── data/
+│   ├── tirmidhi.json          ← source of truth (replace with your real data)
+│   ├── tirmidhi.json.gz       ← generated (shipped in packages)
+│   └── chapters/              ← generated (gitignored)
+├── bin/index.js               ← CLI
+├── src/                       ← JS source
+├── types/index.d.ts
+├── python/jami_al_tirmidhi/   ← Python package
+├── scripts/build.mjs
+├── examples/
+├── docs/
+└── tests/
+```
+
+---
+
+## 🔧 Development
+
+```bash
+# Place your real tirmidhi.json in data/
+node scripts/build.mjs    # compress, generate chapters/, copy to python/
+
+# Test locally before publishing
+python -m build --wheel
+python -m zipfile -l dist\jami_al_tirmidhi-1.0.0-py3-none-any.whl | findstr "tirmidhi.json.gz"
+pip install dist\jami_al_tirmidhi-1.0.0-py3-none-any.whl --force-reinstall
+tirmidhi 23
+```
+
+Publishing is automatic via GitHub Actions on every GitHub Release.
+
+---
+
+## 📄 License
+
+GNU Affero General Public License v3.0 (AGPL-3.0)
+
+---
+
+<div align="center">
+
+**Made with ❤️ for the Muslim community · Seeking knowledge together**
+
+[![Stars](https://img.shields.io/github/stars/SENODROOM/jami-al-tirmidhi?style=for-the-badge&logo=github&logoColor=white&color=f0c040&labelColor=1a1a1a)](https://github.com/SENODROOM/jami-al-tirmidhi/stargazers)
+
+</div>

package/books/jami-al-tirmidhi/bin/index.js

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+// CLI for jami-al-tirmidhi
+
+import fs   from 'fs';
+import zlib from 'zlib';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { Tirmidhi } from '../src/index.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname  = path.dirname(__filename);
+const pkg        = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
+
+function loadData() {
+  const gzPath   = path.join(__dirname, '..', 'data', 'tirmidhi.json.gz');
+  const jsonPath = path.join(__dirname, '..', 'data', 'tirmidhi.json');
+  if (fs.existsSync(gzPath))   return JSON.parse(zlib.gunzipSync(fs.readFileSync(gzPath)).toString('utf8'));
+  if (fs.existsSync(jsonPath)) return JSON.parse(fs.readFileSync(jsonPath, 'utf8'));
+  throw new Error('Data file not found. Expected data/tirmidhi.json.gz or data/tirmidhi.json');
+}
+
+const tirmidhiData = loadData();
+const _byId        = new Map();
+const _byChapter   = new Map();
+tirmidhiData.hadiths.forEach(h => {
+  _byId.set(h.id, h);
+  if (!_byChapter.has(h.chapterId)) _byChapter.set(h.chapterId, []);
+  _byChapter.get(h.chapterId).push(h);
+});
+
+const tirmidhi = new Tirmidhi(tirmidhiData);
+export default tirmidhi;
+export { Tirmidhi };
+
+const c = { reset:'\x1b[0m',bold:'\x1b[1m',dim:'\x1b[2m',green:'\x1b[32m',yellow:'\x1b[33m',cyan:'\x1b[36m',magenta:'\x1b[35m',blue:'\x1b[34m',red:'\x1b[31m',gray:'\x1b[90m' };
+const clr=(col,t)=>`${col}${t}${c.reset}`;
+const bold=t=>clr(c.bold,t),green=t=>clr(c.green,t),yellow=t=>clr(c.yellow,t),cyan=t=>clr(c.cyan,t),magenta=t=>clr(c.magenta,t),gray=t=>clr(c.gray,t),red=t=>clr(c.red,t),blue=t=>clr(c.blue,t),dim=t=>clr(c.dim,t);
+
+function highlight(text,term){if(!term)return text;const re=new RegExp(`(${term.replace(/[.*+?^${}()|[\]\\]/g,'\\$&')})`,'gi');return text.replace(re,`\x1b[1m\x1b[33m$1\x1b[0m`);}
+function wrap(text,width=72,indent=''){const words=text.split(' '),lines=[];let line='';for(const word of words){if((line+' '+word).trim().length>width){if(line)lines.push(indent+line.trim());line=word;}else{line=(line+' '+word).trim();}}if(line)lines.push(indent+line.trim());return lines.join('\n');}
+function isRunDirectly(){if(!process.argv[1])return false;const argv1=path.resolve(process.argv[1]).toLowerCase().replace(/\\/g,'/');const self=__filename.toLowerCase().replace(/\\/g,'/');const base=path.basename(argv1).replace(/\.js$/,'');return argv1===self||base==='tirmidhi';}
+
+if(isRunDirectly()){
+const rawArgs=process.argv.slice(2);
+const flags=rawArgs.filter(a=>a.startsWith('-'));
+const numArgs=rawArgs.filter(a=>!a.startsWith('-'));
+const wantsHelp=flags.some(f=>f==='-h'||f==='--help');
+const wantsVersion=flags.some(f=>f==='-v'||f==='--version');
+const wantsReact=flags.some(f=>f==='--react');
+const wantsRandom=flags.some(f=>f==='--random'||f==='-r');
+const wantsAll=flags.some(f=>f==='--all');
+const showArabic=flags.some(f=>f==='-a'||f==='--arabic');
+const showBoth=flags.some(f=>f==='-b'||f==='--both');
+const printArabic=showArabic||showBoth;
+const printEnglish=!showArabic||showBoth;
+const searchIdx=rawArgs.findIndex(a=>a==='--search'||a==='-s');
+const searchQuery=searchIdx!==-1&&rawArgs[searchIdx+1]&&!rawArgs[searchIdx+1].startsWith('-')?rawArgs[searchIdx+1]:null;
+const chapterIdx=rawArgs.findIndex(a=>a==='--chapter'||a==='-c');
+const chapterArg=chapterIdx!==-1&&rawArgs[chapterIdx+1]&&!rawArgs[chapterIdx+1].startsWith('-')?parseInt(rawArgs[chapterIdx+1]):null;
+const DIV=gray('─'.repeat(60)),DIV2=gray('═'.repeat(60));
+
+if(wantsVersion){console.log('');console.log('  '+bold(cyan('jami-al-tirmidhi'))+gray(' v'+pkg.version));console.log('  '+gray('Total hadiths : ')+yellow(tirmidhiData.hadiths.length.toLocaleString()));console.log('  '+gray('Total chapters: ')+yellow(tirmidhiData.chapters.length.toLocaleString()));console.log('  '+gray('Author        : ')+cyan('Imam Abu Isa Muhammad al-Tirmidhi'));console.log('');process.exit(0);}
+if(wantsRandom){printHadith(tirmidhiData.hadiths[Math.floor(Math.random()*tirmidhiData.hadiths.length)]);process.exit(0);}
+
+if(chapterArg!==null){
+  const hadiths=_byChapter.get(chapterArg)||[];
+  const chapter=tirmidhiData.chapters.find(c=>c.id===chapterArg);
+  if(!hadiths.length){console.log('\n'+red('  No chapter found with id '+chapterArg)+'\n');process.exit(1);}
+  console.log('');console.log(DIV2);
+  console.log(bold(cyan('  Chapter '+chapterArg))+(chapter?gray(' — ')+yellow(chapter.english):''));
+  if(chapter?.arabic)console.log('  '+magenta(chapter.arabic));
+  console.log(gray('  '+hadiths.length+' hadiths'));console.log(DIV2);
+  hadiths.forEach(h=>printHadith(h));process.exit(0);
+}
+
+if(searchQuery!==null){
+  const start=Date.now(),ql=searchQuery.toLowerCase();
+  const results=tirmidhiData.hadiths.filter(h=>h.english?.text?.toLowerCase().includes(ql)||h.english?.narrator?.toLowerCase().includes(ql));
+  const elapsed=Date.now()-start;
+  console.log('');console.log(DIV2);
+  console.log(bold(cyan('  Search: '))+yellow('"'+searchQuery+'"')+gray('  —  ')+green(results.length+' results')+gray('  ('+elapsed+'ms)'));
+  console.log(DIV2);
+  if(!results.length){console.log('\n  '+red('No hadiths found for: ')+yellow('"'+searchQuery+'"')+'\n');process.exit(0);}
+  const limit=wantsAll?results.length:Math.min(5,results.length);
+  results.slice(0,limit).forEach((hadith,i)=>{
+    const chapter=tirmidhiData.chapters.find(c=>c.id===hadith.chapterId);
+    console.log('');
+    console.log(bold(green('  #'+(i+1)))+gray('  Hadith '+hadith.id)+gray('  |  Chapter: ')+cyan(hadith.chapterId)+(chapter?gray(' — ')+dim(chapter.english):''));
+    if(hadith.english?.narrator)console.log('  '+bold(yellow('Narrator: '))+magenta(hadith.english.narrator));
+    if(hadith.english?.text)console.log('  '+wrap(highlight(hadith.english.text,searchQuery),68,'  ').trimStart());
+    console.log(DIV);
+  });
+  if(!wantsAll&&results.length>5){console.log('');console.log('  '+gray('Showing ')+cyan('5')+gray(' of ')+yellow(results.length)+gray(' results.  ')+bold(blue('Run with --all to see all results')));console.log('  '+dim('tirmidhi --search "'+searchQuery+'" --all'));console.log('');}
+  process.exit(0);
+}
+
+if(wantsReact){
+  const cwd=process.cwd(),srcDir=path.join(cwd,'src'),hooksDir=path.join(srcDir,'hooks');
+  const pkgPath=path.join(cwd,'package.json');
+  if(!fs.existsSync(pkgPath)){console.error(red('  \u2717 No package.json found.'));process.exit(1);}
+  const projectPkg=JSON.parse(fs.readFileSync(pkgPath,'utf8'));
+  const deps={...projectPkg.dependencies,...projectPkg.devDependencies};
+  if(!deps['react']){console.error(red('  \u2717 React not found.'));process.exit(1);}
+  if(!fs.existsSync(srcDir)){console.error(red('  \u2717 No src/ directory found.'));process.exit(1);}
+  if(!fs.existsSync(hooksDir))fs.mkdirSync(hooksDir,{recursive:true});
+  const CDN='https://cdn.jsdelivr.net/npm/jami-al-tirmidhi@'+pkg.version+'/data/tirmidhi.json.gz';
+  const hookFile=path.join(hooksDir,'useTirmidhi.js');
+  const hookSrc="// Auto-generated by: tirmidhi --react\nimport { useState, useEffect } from 'react';\nconst CDN = '"+CDN+"';\nlet _cache=null,_promise=null;\nconst _subs=new Set();\nfunction _load(){if(_cache)return Promise.resolve(_cache);if(_promise)return _promise;_promise=fetch(CDN).then(r=>r.arrayBuffer()).then(buf=>{const stream=new DecompressionStream('gzip');const writer=stream.writable.getWriter();const reader=stream.readable.getReader();writer.write(new Uint8Array(buf));writer.close();const chunks=[];return(function pump(){return reader.read().then(({done,value})=>{if(done){const text=new TextDecoder().decode(new Uint8Array(chunks.reduce((a,b)=>[...a,...b],[])));const data=JSON.parse(text);const hadiths=data.hadiths;const _byId=new Map();hadiths.forEach(h=>_byId.set(h.id,h));_cache=Object.assign([],hadiths,{metadata:data.metadata,chapters:data.chapters,get:id=>_byId.get(id),getByChapter:id=>hadiths.filter(h=>h.chapterId===id),search:(q,limit=0)=>{const ql=q.toLowerCase();const r=hadiths.filter(h=>h.english?.text?.toLowerCase().includes(ql)||h.english?.narrator?.toLowerCase().includes(ql));return limit>0?r.slice(0,limit):r;},getRandom:()=>hadiths[Math.floor(Math.random()*hadiths.length)]});_subs.forEach(fn=>fn(_cache));_subs.clear();return _cache;}chunks.push(value);return pump();});})();});return _promise;}\n_load();\nexport function useTirmidhi(){const[tirmidhi,setTirmidhi]=useState(_cache);useEffect(()=>{if(_cache){setTirmidhi(_cache);}else{_subs.add(setTirmidhi);return()=>_subs.delete(setTirmidhi);}},[]);return tirmidhi;}\nexport default useTirmidhi;\n";
+  fs.writeFileSync(hookFile,hookSrc,'utf8');
+  console.log('\n  '+green('\u2713')+bold(' Generated: ')+cyan('src/hooks/useTirmidhi.js')+'\n');
+  process.exit(0);
+}
+
+if(wantsHelp||(numArgs.length===0&&!searchQuery&&chapterArg===null&&!wantsRandom)){
+  console.log('');console.log('  '+bold(cyan('Jami al-Tirmidhi CLI'))+gray('  v'+pkg.version));console.log('');
+  console.log('  '+bold('Usage:'));
+  console.log('    '+cyan('tirmidhi')+yellow(' <hadithId>')+gray('                   Show hadith by global ID'));
+  console.log('    '+cyan('tirmidhi')+yellow(' <chapterId> <hadithId>')+gray('       Show hadith within a chapter'));
+  console.log('    '+cyan('tirmidhi')+green(' --search')+yellow(' "<query>"')+gray('            Search hadiths (top 5)'));
+  console.log('    '+cyan('tirmidhi')+green(' --search')+yellow(' "<query>"')+green(' --all')+gray('    Show all results'));
+  console.log('    '+cyan('tirmidhi')+green(' --chapter')+yellow(' <id>')+gray('              List all hadiths in a chapter'));
+  console.log('    '+cyan('tirmidhi')+green(' --random')+gray('                   Show a random hadith'));
+  console.log('');
+  console.log('  '+bold('Language flags:')+gray('  (default = English only)'));
+  console.log('    '+green('-a')+gray(', ')+green('--arabic')+gray('   Arabic only'));
+  console.log('    '+green('-b')+gray(', ')+green('--both')+gray('     Arabic + English'));
+  console.log('');
+  console.log('  '+bold('Other:'));
+  console.log('    '+green('--react')+gray('    Generate useTirmidhi React hook'));
+  console.log('    '+green('-v')+gray(', ')+green('--version')+gray(' Show version'));
+  console.log('    '+green('-h')+gray(', ')+green('--help')+gray('    Show this help'));
+  console.log('');process.exit(0);
+}
+
+function printHadith(hadith){
+  if(!hadith){console.log('\n  '+red('Hadith not found.')+'\n');process.exit(1);}
+  const chapter=tirmidhiData.chapters?.find(c=>c.id===hadith.chapterId);
+  console.log('');console.log(DIV2);
+  const headerEn=bold(cyan('Hadith #'+hadith.id))+gray('  |  Chapter: ')+cyan(hadith.chapterId)+(chapter?.english?gray(' — ')+yellow(chapter.english):'');
+  const headerAr=bold(magenta('\u062d\u062f\u064a\u062b #'+hadith.id))+gray('  |  \u0628\u0627\u0628: ')+magenta(hadith.chapterId)+(chapter?.arabic?gray(' \u2014 ')+magenta(chapter.arabic):'');
+  console.log('  '+(printArabic&&!printEnglish?headerAr:headerEn));
+  console.log(DIV2);
+  if(printEnglish){if(hadith.english?.narrator)console.log('  '+bold(yellow('Narrator: '))+magenta(hadith.english.narrator));if(hadith.english?.text){console.log('');console.log(wrap(hadith.english.text,68,'  '));}}
+  if(printArabic){if(printEnglish)console.log('\n'+DIV);if(hadith.arabic){console.log('');console.log('  '+magenta(hadith.arabic));}}
+  console.log('');console.log(DIV2);console.log('');
+}
+
+function resolveHadith(){
+  if(numArgs.length===1){const id=parseInt(numArgs[0]);if(isNaN(id))return null;return _byId.get(id)||null;}
+  if(numArgs.length===2){
+    const chapterId=parseInt(numArgs[0]),hadithNum=parseInt(numArgs[1]);
+    if(isNaN(chapterId)||isNaN(hadithNum))return null;
+    const inChapter=_byChapter.get(chapterId);
+    if(!inChapter?.length){console.log('\n  '+red('No chapter found with id '+chapterId+'.')+'\n');process.exit(1);}
+    return inChapter.find(h=>h.id===hadithNum)??inChapter[hadithNum-1]??null;
+  }
+  return null;
+}
+
+if(numArgs.length>0){
+  const hadith=resolveHadith();
+  if(!hadith){console.log('\n  '+red('Invalid arguments.')+' Run '+cyan('tirmidhi --help')+' for usage.\n');process.exit(1);}
+  printHadith(hadith);
+}
+}

package/books/jami-al-tirmidhi/examples/express/server.js

@@ -0,0 +1,7 @@
+import express from 'express';
+import tirmidhi from 'jami-al-tirmidhi';
+const app = express();
+app.get('/api/hadith/random', (_, res) => res.json(tirmidhi.getRandom()));
+app.get('/api/hadith/:id', (req, res) => { const h = tirmidhi.get(parseInt(req.params.id)); h ? res.json(h) : res.status(404).json({error:'Not found'}); });
+app.get('/api/search', (req, res) => res.json(tirmidhi.search(req.query.q||'', parseInt(req.query.limit)||0)));
+app.listen(3000, () => console.log('Jami al-Tirmidhi API at http://localhost:3000'));

package/books/jami-al-tirmidhi/examples/node-commonjs/example.js

@@ -0,0 +1,7 @@
+'use strict';
+const tirmidhi = require('jami-al-tirmidhi');
+console.log('Total hadiths:', tirmidhi.length);
+const h = tirmidhi.get(1);
+console.log('Hadith #1:', h.english.narrator, '-', h.english.text.slice(0,60)+'...');
+console.log('Search "prayer":', tirmidhi.search('prayer').length, 'results');
+console.log('Random:', tirmidhi.getRandom().id);

package/books/jami-al-tirmidhi/examples/node-esm/example.mjs

@@ -0,0 +1,6 @@
+import tirmidhi from 'jami-al-tirmidhi';
+console.log('Total hadiths:', tirmidhi.length);
+console.log('Title:', tirmidhi.metadata.english.title);
+const h = tirmidhi.get(1);
+console.log('Hadith #1:', h.english.narrator, '-', h.english.text.slice(0,60)+'...');
+console.log('Chapter 1 hadiths:', tirmidhi.getByChapter(1).length);

package/books/jami-al-tirmidhi/examples/react/HadithExample.jsx

@@ -0,0 +1,17 @@
+// Run `tirmidhi --react` in your project first
+import { useState } from 'react';
+import { useTirmidhi } from '../hooks/useTirmidhi';
+
+export function HadithOfTheDay() {
+  const tirmidhi = useTirmidhi();
+  if (!tirmidhi) return <p>Loading...</p>;
+  const h = tirmidhi.getRandom();
+  return (<div><strong>{h.english.narrator}</strong><p>{h.english.text}</p></div>);
+}
+
+export function HadithSearch() {
+  const tirmidhi = useTirmidhi();
+  const [results, setResults] = useState([]);
+  if (!tirmidhi) return <p>Loading...</p>;
+  return (<><input placeholder="Search..." onChange={e => setResults(tirmidhi.search(e.target.value, 20))} />{results.map(h => <div key={h.id}><p>{h.english.text}</p></div>)}</>);
+}

package/books/jami-al-tirmidhi/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "jami-al-tirmidhi",
+  "version": "1.0.1",
+  "description": "Complete Jami al-Tirmidhi. Offline-first, zero dependencies. CLI + Node + React/Vue/Vite.",
+  "type": "module",
+  "main": "./src/index.cjs",
+  "module": "./src/index.browser.js",
+  "types": "./types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "browser": "./src/index.browser.js",
+      "require": "./src/index.cjs",
+      "import": "./src/index.node.js"
+    },
+    "./data/chapters/*": "./data/chapters/*"
+  },
+  "bin": {
+    "tirmidhi": "bin/index.js"
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "prepublishOnly": "node scripts/build.mjs"
+  },
+  "keywords": [
+    "islam",
+    "hadith",
+    "tirmidhi",
+    "jami",
+    "sunan",
+    "sunnah",
+    "json",
+    "arabic",
+    "english",
+    "quran",
+    "react",
+    "hook"
+  ],
+  "author": "muhammadsaadamin",
+  "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SENODROOM/jami-al-tirmidhi.git"
+  },
+  "bugs": {
+    "url": "https://github.com/SENODROOM/jami-al-tirmidhi/issues"
+  },
+  "homepage": "https://github.com/SENODROOM/jami-al-tirmidhi#readme",
+  "files": [
+    "src/",
+    "types/",
+    "bin/index.js",
+    "data/tirmidhi.json.gz"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/books/jami-al-tirmidhi/src/index.cjs

@@ -0,0 +1,52 @@
+// CommonJS entry — require('jami-al-tirmidhi')
+'use strict';
+const fs   = require('fs');
+const zlib = require('zlib');
+const path = require('path');
+
+function loadData() {
+  const gzPath   = path.join(__dirname, '..', 'data', 'tirmidhi.json.gz');
+  const jsonPath = path.join(__dirname, '..', 'data', 'tirmidhi.json');
+  if (fs.existsSync(gzPath))   return JSON.parse(zlib.gunzipSync(fs.readFileSync(gzPath)).toString('utf8'));
+  if (fs.existsSync(jsonPath)) return JSON.parse(fs.readFileSync(jsonPath, 'utf8'));
+  throw new Error('Data file not found. Expected data/tirmidhi.json.gz or data/tirmidhi.json');
+}
+const tirmidhiData = loadData();
+
+class Tirmidhi {
+  constructor(tirmidhiData) {
+    this._hadiths = tirmidhiData.hadiths;
+    return new Proxy(this._hadiths, {
+      get: (target, prop) => {
+        if (!isNaN(prop))   return target[parseInt(prop)];
+        if (prop in target) return target[prop];
+        switch (prop) {
+          case 'metadata':     return tirmidhiData.metadata;
+          case 'chapters':     return tirmidhiData.chapters;
+          case 'get':          return (id) => this._hadiths.find(h => h.id === id);
+          case 'getByChapter': return (id) => this._hadiths.filter(h => h.chapterId === id);
+          case 'search':       return (q, limit = 0) => {
+            const ql = q.toLowerCase();
+            const r  = this._hadiths.filter(h =>
+              h.english?.text?.toLowerCase().includes(ql) ||
+              h.english?.narrator?.toLowerCase().includes(ql)
+            );
+            return limit > 0 ? r.slice(0, limit) : r;
+          };
+          case 'getRandom': return () => this._hadiths[Math.floor(Math.random() * this._hadiths.length)];
+          case 'length':    return target.length;
+          default:          return target[prop];
+        }
+      },
+      ownKeys: (target) => [
+        'length',
+        ...Array.from({ length: target.length }, (_, i) => String(i)),
+        'metadata', 'chapters', 'get', 'getByChapter', 'search', 'getRandom'
+      ]
+    });
+  }
+}
+const tirmidhi = new Tirmidhi(tirmidhiData);
+module.exports = tirmidhi;
+module.exports.Tirmidhi = Tirmidhi;
+module.exports.default  = tirmidhi;

package/books/jami-al-tirmidhi/src/index.js

@@ -0,0 +1,35 @@
+// ESM browser-safe entry (class only — no data)
+export class Tirmidhi {
+  constructor(tirmidhiData) {
+    this._hadiths = tirmidhiData.hadiths;
+    return new Proxy(this._hadiths, {
+      get: (target, prop) => {
+        if (!isNaN(prop))   return target[parseInt(prop)];
+        if (prop in target) return target[prop];
+        switch (prop) {
+          case 'metadata':     return tirmidhiData.metadata;
+          case 'chapters':     return tirmidhiData.chapters;
+          case 'get':          return (id) => this._hadiths.find(h => h.id === id);
+          case 'getByChapter': return (id) => this._hadiths.filter(h => h.chapterId === id);
+          case 'search':       return (q, limit = 0) => {
+            const ql = q.toLowerCase();
+            const r  = this._hadiths.filter(h =>
+              h.english?.text?.toLowerCase().includes(ql) ||
+              h.english?.narrator?.toLowerCase().includes(ql)
+            );
+            return limit > 0 ? r.slice(0, limit) : r;
+          };
+          case 'getRandom': return () => this._hadiths[Math.floor(Math.random() * this._hadiths.length)];
+          case 'length':    return target.length;
+          default:          return target[prop];
+        }
+      },
+      ownKeys: (target) => [
+        'length',
+        ...Array.from({ length: target.length }, (_, i) => String(i)),
+        'metadata', 'chapters', 'get', 'getByChapter', 'search', 'getRandom'
+      ]
+    });
+  }
+}
+export default Tirmidhi;

package/books/jami-al-tirmidhi/src/index.node.js

@@ -0,0 +1,18 @@
+// Node ESM entry
+import fs   from 'fs';
+import zlib from 'zlib';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { Tirmidhi } from './index.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+function loadData() {
+  const gzPath   = path.join(__dirname, '..', 'data', 'tirmidhi.json.gz');
+  const jsonPath = path.join(__dirname, '..', 'data', 'tirmidhi.json');
+  if (fs.existsSync(gzPath))   return JSON.parse(zlib.gunzipSync(fs.readFileSync(gzPath)).toString('utf8'));
+  if (fs.existsSync(jsonPath)) return JSON.parse(fs.readFileSync(jsonPath, 'utf8'));
+  throw new Error('Data file not found. Expected data/tirmidhi.json.gz or data/tirmidhi.json');
+}
+export { Tirmidhi };
+export default new Tirmidhi(loadData());

package/books/jami-al-tirmidhi/types/index.d.ts

@@ -0,0 +1,28 @@
+export interface HadithEnglish { narrator: string; text: string; }
+export interface Hadith { id: number; chapterId: number; arabic: string; english: HadithEnglish; }
+export interface Chapter { id: number; arabic: string; english: string; }
+export interface Metadata {
+  id: number; length: number;
+  arabic:  { title: string; author: string; introduction: string };
+  english: { title: string; author: string; introduction: string };
+}
+export interface TirmidhiData { metadata: Metadata; chapters: Chapter[]; hadiths: Hadith[]; }
+export interface TirmidhiInstance extends ArrayLike<Hadith> {
+  [index: number]: Hadith;
+  readonly length: number;
+  readonly metadata: Metadata;
+  readonly chapters: Chapter[];
+  get(id: number): Hadith | undefined;
+  getByChapter(chapterId: number): Hadith[];
+  search(query: string, limit?: number): Hadith[];
+  getRandom(): Hadith;
+  find(predicate: (h: Hadith) => boolean): Hadith | undefined;
+  filter(predicate: (h: Hadith) => boolean): Hadith[];
+  map<T>(cb: (h: Hadith, i: number) => T): T[];
+  forEach(cb: (h: Hadith, i: number) => void): void;
+  slice(start?: number, end?: number): Hadith[];
+}
+export declare class Tirmidhi { constructor(data: TirmidhiData); }
+export declare function loadTirmidhi(): Promise<TirmidhiInstance>;
+declare const tirmidhi: TirmidhiInstance;
+export default tirmidhi;