@ihsandeen/aya 1.0.0

package/dist/commands/qibla.js

@@ -0,0 +1,118 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.qiblaCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const axios_1 = __importDefault(require("axios"));
+const config_1 = require("../utils/config");
+const ora_1 = __importDefault(require("ora"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const printer_1 = require("../utils/printer");
+exports.qiblaCommand = new commander_1.Command('qibla')
+    .description('Find the direction and distance to the Kaaba')
+    .action(async () => {
+    (0, printer_1.printCommandHeader)('qibla');
+    let config = (0, config_1.getConfig)();
+    let city = config.location?.city;
+    let country = config.location?.country;
+    if (!city || !country) {
+        console.log(chalk_1.default.yellow('Location not configured.'));
+        const answers = await inquirer_1.default.prompt([
+            { type: 'input', name: 'city', message: 'Enter your city:' },
+            { type: 'input', name: 'country', message: 'Enter your country:' }
+        ]);
+        city = answers.city;
+        country = answers.country;
+    }
+    const spinner = (0, ora_1.default)(`Locating Kaaba from ${city}, ${country}...`).start();
+    try {
+        // 1. Get coordinates for the city
+        const response = await axios_1.default.get('http://api.aladhan.com/v1/timingsByCity', {
+            params: { city, country }
+        });
+        const meta = response.data.data.meta;
+        const lat = meta.latitude;
+        const long = meta.longitude;
+        // 2. Get Qibla direction
+        const qiblaResponse = await axios_1.default.get(`http://api.aladhan.com/v1/qibla/${lat}/${long}`);
+        const direction = qiblaResponse.data.data.direction; // Degrees from North
+        spinner.stop();
+        console.clear();
+        console.log(chalk_1.default.green.bold('\n  Qibla Finder'));
+        console.log(chalk_1.default.gray('----------------------------------------'));
+        console.log(chalk_1.default.white(`Location: ${chalk_1.default.bold(city)}, ${country}`));
+        console.log(chalk_1.default.white(`Coordinates: ${lat}, ${long}`));
+        console.log(chalk_1.default.cyan.bold(`Qibla Direction: ${Math.round(direction)}° from North (Clockwise)`));
+        console.log('');
+        // Calculate Distance (Haversine Formula)
+        // Kaaba coordinates: 21.4225° N, 39.8262° E
+        const kaabaLat = 21.4225;
+        const kaabaLong = 39.8262;
+        const distance = getDistanceFromLatLonInKm(lat, long, kaabaLat, kaabaLong);
+        console.log(chalk_1.default.blue(`Distance to Kaaba: ${Math.round(distance).toLocaleString()} km`));
+        console.log('');
+        // ASCII Compass Visualization
+        drawCompass(direction);
+        console.log('');
+        console.log(chalk_1.default.gray('Turn your face towards the Sacred Mosque.'));
+        console.log(chalk_1.default.italic('"So turn your face toward al-Masjid al-Haram." (2:144)'));
+    }
+    catch (error) {
+        spinner.fail('Could not calculate Qibla.');
+        console.error(chalk_1.default.red('Please check your internet connection or location settings.'));
+    }
+});
+function drawCompass(degree) {
+    const needle = getArrow(degree);
+    const compass = `
+      N
+      |
+  W --+-- E
+      |
+      S
+  `;
+    // We can't easily rotate the whole compass in ASCII without complex logic.
+    // Instead, we show the needle direction relative to North.
+    console.log(chalk_1.default.yellow.bold('      N'));
+    console.log(chalk_1.default.yellow.bold('      |'));
+    // Show the direction arrow
+    console.log(chalk_1.default.green.bold(`      ${needle}  (${Math.round(degree)}°)`));
+    console.log(chalk_1.default.yellow.bold('      |'));
+}
+function getArrow(degree) {
+    const normalized = (degree % 360 + 360) % 360;
+    if (normalized >= 337.5 || normalized < 22.5)
+        return '^';
+    if (normalized >= 22.5 && normalized < 67.5)
+        return '/';
+    if (normalized >= 67.5 && normalized < 112.5)
+        return '>';
+    if (normalized >= 112.5 && normalized < 157.5)
+        return '\\';
+    if (normalized >= 157.5 && normalized < 202.5)
+        return 'v';
+    if (normalized >= 202.5 && normalized < 247.5)
+        return '/';
+    if (normalized >= 247.5 && normalized < 292.5)
+        return '<';
+    if (normalized >= 292.5 && normalized < 337.5)
+        return '\\';
+    return '^';
+}
+function getDistanceFromLatLonInKm(lat1, lon1, lat2, lon2) {
+    const R = 6371; // Radius of the earth in km
+    const dLat = deg2rad(lat2 - lat1); // deg2rad below
+    const dLon = deg2rad(lon2 - lon1);
+    const a = Math.sin(dLat / 2) * Math.sin(dLat / 2) +
+        Math.cos(deg2rad(lat1)) * Math.cos(deg2rad(lat2)) *
+            Math.sin(dLon / 2) * Math.sin(dLon / 2);
+    const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+    const d = R * c; // Distance in km
+    return d;
+}
+function deg2rad(deg) {
+    return deg * (Math.PI / 180);
+}

package/dist/commands/repo.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.repoCommand = void 0;
+const commander_1 = require("commander");
+const server_1 = require("../server");
+const child_process_1 = require("child_process");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const printer_1 = require("../utils/printer");
+exports.repoCommand = new commander_1.Command('repo')
+    .description('The Book of Deeds UI (Visualize your journey)')
+    .action(async () => {
+    (0, printer_1.printCommandHeader)('repo');
+    const spinner = (0, ora_1.default)('Opening your Book of Deeds in the browser...').start();
+    try {
+        const port = await (0, server_1.startServer)();
+        const url = `http://localhost:${port}/repo`;
+        spinner.succeed(chalk_1.default.green('Book of Deeds is open!'));
+        console.log(chalk_1.default.cyan(`  ➜  ${url}`));
+        console.log(chalk_1.default.dim('  (Press Ctrl+C to close the connection)'));
+        // Open browser based on OS
+        const start = (process.platform == 'darwin' ? 'open' : process.platform == 'win32' ? 'start' : 'xdg-open');
+        (0, child_process_1.exec)(`${start} ${url}`);
+        // Keep the process alive is handled by the server.listen() inside startServer
+        // We don't need to do anything else, the node process will stay alive.
+    }
+    catch (error) {
+        spinner.fail('Could not open Book of Deeds.');
+        console.error(error);
+    }
+});

package/dist/commands/sabr.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sabrCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const nak_1 = require("../data/nak");
+const printer_1 = require("../utils/printer");
+exports.sabrCommand = new commander_1.Command('sabr')
+    .description('The Patience Diagnostic')
+    .action(async () => {
+    (0, printer_1.printCommandHeader)('sabr');
+    const { situation } = await inquirer_1.default.prompt([{
+            type: 'list',
+            name: 'situation',
+            message: 'What are you struggling with?',
+            choices: nak_1.sabrData.map(s => ({
+                name: `${s.type} (${s.arabic})`,
+                value: s.type
+            }))
+        }]);
+    const data = nak_1.sabrData.find(s => s.type === situation);
+    if (data) {
+        console.log(chalk_1.default.blue.bold(`\n  Diagnosis: ${data.type} (${data.arabic})`));
+        console.log(chalk_1.default.white(`  Definition: ${data.description}`));
+        console.log(chalk_1.default.gray(`  Example: ${data.example}`));
+        console.log(chalk_1.default.green('\n  Prescription: "Indeed, Allah is with the patient." (2:153)\n'));
+    }
+});

package/dist/commands/scene.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sceneCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const nak_1 = require("../data/nak");
+const printer_1 = require("../utils/printer");
+const sleep = (ms) => new Promise(resolve => setTimeout(resolve, ms));
+exports.sceneCommand = new commander_1.Command('scene')
+    .description('The Cinematic Visualizer (Tadabbur in 4K)')
+    .argument('[ref]', 'The Ayah reference (e.g. 82:1)')
+    .action(async (ref) => {
+    (0, printer_1.printCommandHeader)('scene');
+    let data = ref
+        ? nak_1.sceneData.find(s => s.ref.includes(ref) || s.surah.toLowerCase().includes(ref))
+        : null;
+    if (!data && ref) {
+        console.log(chalk_1.default.red('Scene not found for that reference.'));
+    }
+    if (!data) {
+        const { choice } = await inquirer_1.default.prompt([{
+                type: 'list',
+                name: 'choice',
+                message: 'Select a scene to visualize:',
+                choices: nak_1.sceneData.map(s => ({
+                    name: `${s.surah} (${s.ayah}): ${s.title}`,
+                    value: s
+                }))
+            }]);
+        data = choice;
+    }
+    if (!data)
+        return;
+    console.clear();
+    console.log(chalk_1.default.red.bold(`\n  Aya Scene: ${data.title}`));
+    console.log(chalk_1.default.gray(`Surah ${data.surah} (${data.ayah})\n`));
+    // Display Lighting and Audio first to set the mood
+    console.log(chalk_1.default.yellow('  Lighting: ') + chalk_1.default.white(data.lighting));
+    console.log(chalk_1.default.cyan('  Audio:    ') + chalk_1.default.white(data.audio));
+    console.log(chalk_1.default.gray('----------------------------------------\n'));
+    console.log(chalk_1.default.white.bold('  Shot List:'));
+    // Animate shots sequentially
+    for (let i = 0; i < data.shots.length; i++) {
+        const shot = data.shots[i];
+        await sleep(1000);
+        console.log(chalk_1.default.green(`\n[${i + 1}] ${shot.type}`));
+        console.log(chalk_1.default.white(`    ${shot.description}`));
+    }
+    console.log('');
+});

package/dist/commands/seek.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.seekCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const nak_1 = require("../data/nak");
+const printer_1 = require("../utils/printer");
+exports.seekCommand = new commander_1.Command('seek')
+    .description('Contextual Quranic Search')
+    .action(async () => {
+    (0, printer_1.printCommandHeader)('seek');
+    const { topic } = await inquirer_1.default.prompt([{
+            type: 'list',
+            name: 'topic',
+            message: 'What topic are you looking for?',
+            choices: nak_1.searchData.map(s => s.keyword)
+        }]);
+    const data = nak_1.searchData.find(s => s.keyword === topic);
+    if (data) {
+        console.log(chalk_1.default.blue.bold(`\n  Topic: ${data.keyword}`));
+        console.log(chalk_1.default.green(`  Ayah: ${data.ayah}`));
+        console.log(chalk_1.default.white(`  Context (The "Why"): ${data.context}\n`));
+    }
+});

package/dist/commands/shukr.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shukrCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const nak_1 = require("../data/nak");
+const printer_1 = require("../utils/printer");
+exports.shukrCommand = new commander_1.Command('shukr')
+    .description('The Gratitude Reality Check')
+    .action(() => {
+    (0, printer_1.printCommandHeader)('shukr');
+    console.log(chalk_1.default.yellow.bold('\n  The 3 Levels of Shukr (Gratitude)\n'));
+    nak_1.shukrData.forEach((level) => {
+        console.log(chalk_1.default.blue.bold(`  Level: ${level.level}`));
+        console.log(chalk_1.default.white(`  ${level.description}`));
+        console.log(chalk_1.default.green(`  Reality: ${level.reality}\n`));
+    });
+    console.log(chalk_1.default.gray('  "If you are grateful, I will surely increase you." (14:7)'));
+});

package/dist/commands/sleep.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleepCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const nak_1 = require("../data/nak");
+const printer_1 = require("../utils/printer");
+exports.sleepCommand = new commander_1.Command('sleep')
+    .description('The Minor Death (Sleep Adhkar)')
+    .action(async () => {
+    (0, printer_1.printCommandHeader)('sleep');
+    console.clear();
+    console.log(chalk_1.default.blue.bold('\n  The Minor Death (An-Nawm)\n'));
+    console.log(chalk_1.default.gray('  "Allah takes the souls at the time of their death, and those that do not die [He takes] during their sleep." (39:42)\n'));
+    nak_1.sleepData.forEach(s => {
+        console.log(chalk_1.default.yellow.bold(`  ${s.title}`));
+        console.log(chalk_1.default.green(`  "${s.arabic}"`));
+        console.log(chalk_1.default.white(`  "${s.translation}"`));
+        console.log(chalk_1.default.cyan.italic(`  Reflection: ${s.reflection}\n`));
+    });
+    console.log(chalk_1.default.gray('  Good night. Reset your intentions for the resurrection (tomorrow).'));
+    console.log('\n');
+});

package/dist/commands/sound.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.soundCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const nak_1 = require("../data/nak");
+const printer_1 = require("../utils/printer");
+exports.soundCommand = new commander_1.Command('sound')
+    .description('Phonetic Storytelling (Tajweed as Tafsir)')
+    .argument('[ref]', 'The Ayah reference (e.g. 100:1)')
+    .action((ref) => {
+    (0, printer_1.printCommandHeader)('sound');
+    // If no ref, show available?
+    if (!ref) {
+        console.log(chalk_1.default.yellow('Please provide an Ayah reference to analyze.'));
+        console.log(chalk_1.default.gray('Available examples: 100:1, 113:1'));
+        return;
+    }
+    const data = nak_1.soundData.find(d => d.ref === ref || `${d.surah}:${d.ayah}` === ref);
+    if (!data) {
+        console.log(chalk_1.default.red('Sound analysis not found for that Ayah.'));
+        console.log(chalk_1.default.gray('Currently available: 100:1 (Al-Adiyat), 113:1 (Al-Falaq)'));
+        return;
+    }
+    console.clear();
+    console.log(chalk_1.default.cyan.bold(`\n  Aya Sound: ${data.surah} (${data.ayah})`));
+    console.log(chalk_1.default.white.italic(`"${data.text}"`));
+    console.log(chalk_1.default.gray('----------------------------------------\n'));
+    console.log(chalk_1.default.green.bold('Phonetic Analysis:'));
+    console.log(chalk_1.default.white(data.analysis));
+    console.log('');
+});

package/dist/commands/status.js

@@ -0,0 +1,109 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.statusCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const axios_1 = __importDefault(require("axios"));
+const date_fns_1 = require("date-fns");
+const config_1 = require("../utils/config");
+const ora_1 = __importDefault(require("ora"));
+const printer_1 = require("../utils/printer");
+const boxen_1 = __importDefault(require("boxen"));
+exports.statusCommand = new commander_1.Command('status')
+    .description('Check your spiritual status (prayer times)')
+    .action(async () => {
+    (0, printer_1.printCommandHeader)('status');
+    const config = (0, config_1.getConfig)();
+    const city = config.location?.city || 'Mecca';
+    const country = config.location?.country || 'Saudi Arabia';
+    const spinner = (0, ora_1.default)(`Pinging the heavens for ${city}, ${country}...`).start();
+    try {
+        const response = await axios_1.default.get('http://api.aladhan.com/v1/timingsByCity', {
+            params: {
+                city,
+                country,
+                method: 2, // ISNA
+            }
+        });
+        const timings = response.data.data.timings;
+        const hijri = response.data.data.date.hijri;
+        const prayerNames = ['Fajr', 'Dhuhr', 'Asr', 'Maghrib', 'Isha'];
+        const now = new Date();
+        let nextPrayer = null;
+        let nextPrayerTime = null;
+        let missedPrayersCount = 0;
+        // Find next prayer logic...
+        for (const name of prayerNames) {
+            const timeStr = timings[name];
+            const [hours, minutes] = timeStr.split(':').map(Number);
+            const prayerDate = new Date();
+            prayerDate.setHours(hours, minutes, 0, 0);
+            if (prayerDate > now) {
+                if (!nextPrayer) {
+                    nextPrayer = name;
+                    nextPrayerTime = prayerDate;
+                }
+            }
+            else {
+                missedPrayersCount++;
+            }
+        }
+        if (!nextPrayer) {
+            nextPrayer = 'Fajr';
+            const timeStr = timings['Fajr'];
+            const [hours, minutes] = timeStr.split(':').map(Number);
+            const prayerDate = new Date();
+            prayerDate.setDate(prayerDate.getDate() + 1);
+            prayerDate.setHours(hours, minutes, 0, 0);
+            nextPrayerTime = prayerDate;
+        }
+        spinner.stop();
+        // NAK Style Status Output
+        console.log((0, boxen_1.default)(chalk_1.default.bold.green(` 🕌 Spiritual Status Report `) + '\n' +
+            chalk_1.default.dim(` Location: ${city}, ${country} `) + '\n' +
+            chalk_1.default.dim(` Date: ${hijri.day} ${hijri.month.en} ${hijri.year} AH `), {
+            padding: 1,
+            margin: 1,
+            borderStyle: 'round',
+            borderColor: 'green',
+        }));
+        console.log(chalk_1.default.bold.blue('📡 Connection Status:'));
+        console.log(` Your heart is currently on branch ${chalk_1.default.green("'dunya'")}.`);
+        if (missedPrayersCount > 0) {
+            console.log(chalk_1.default.yellow(` Warning: ${missedPrayersCount} prayer times missed.`));
+            console.log(chalk_1.default.cyan(` Suggestion: run 'aya wudu' to refresh session.`));
+        }
+        console.log('');
+        if (nextPrayer && nextPrayerTime) {
+            const diff = (0, date_fns_1.differenceInMinutes)(nextPrayerTime, now);
+            const hours = Math.floor(diff / 60);
+            const mins = diff % 60;
+            let timeString = '';
+            if (hours > 0)
+                timeString += `${hours}h `;
+            timeString += `${mins}m`;
+            console.log(chalk_1.default.bold.yellow('⏳ Next Obligatory Commit:'));
+            console.log(`   ${chalk_1.default.cyan.bold(nextPrayer)} is due in ${chalk_1.default.yellow.bold(timeString)}`);
+            console.log(chalk_1.default.italic.gray('   "Indeed, prayer has been decreed upon the believers a decree of specified times." (4:103)'));
+        }
+        console.log('');
+        console.log(chalk_1.default.bold.white('📅 Today\'s Schedule (The Daily Sprint):'));
+        prayerNames.forEach(name => {
+            const isNext = name === nextPrayer;
+            const color = isNext ? chalk_1.default.green.bold : chalk_1.default.white;
+            const marker = isNext ? chalk_1.default.yellow(' ← UP NEXT') : '';
+            const time = timings[name];
+            // Simple formatting
+            console.log(`   ${color(name.padEnd(10))} ${time} ${marker}`);
+        });
+        console.log('');
+        console.log(chalk_1.default.gray('(Run "aya init" to re-calibrate your location coordinates)'));
+    }
+    catch (error) {
+        spinner.fail('Connection lost.');
+        console.error(chalk_1.default.red('Could not fetch prayer times. Please check your network connection.'));
+    }
+});

package/dist/commands/sunnah.js

@@ -0,0 +1,24 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sunnahCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const nak_1 = require("../data/nak");
+const printer_1 = require("../utils/printer");
+exports.sunnahCommand = new commander_1.Command('sunnah')
+    .description('Daily Micro-Ibadaat Habits')
+    .action(async () => {
+    (0, printer_1.printCommandHeader)('sunnah');
+    console.clear();
+    console.log(chalk_1.default.green.bold('\n  Daily Sunnah Habits (Micro-Ibadaat)\n'));
+    nak_1.sunnahData.forEach(s => {
+        console.log(chalk_1.default.yellow.bold(`  ${s.action} `) + chalk_1.default.gray(`(${s.category})`));
+        console.log(chalk_1.default.cyan(`  Impact: ${s.impact}`));
+        console.log(chalk_1.default.white.italic(`  ${s.description}\n`));
+    });
+    console.log(chalk_1.default.gray('  "He who revives my Sunnah has loved me..."'));
+    console.log('\n');
+});

package/dist/commands/tafsir.js

@@ -0,0 +1,89 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tafsirCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const tafsir_1 = require("../data/tafsir");
+const printer_1 = require("../utils/printer");
+exports.tafsirCommand = new commander_1.Command('tafsir')
+    .description('Interactive linguistic deep dive (Tadabbur)')
+    .argument('[query]', 'The specific surah/ayah to study (e.g. 93:3, fatiha, ikhlas)')
+    .action(async (query) => {
+    (0, printer_1.printCommandHeader)('tafsir');
+    let selectedTafsir;
+    if (query) {
+        const q = query.toLowerCase();
+        selectedTafsir = tafsir_1.tafsirData.find(t => t.surah.toLowerCase().includes(q) ||
+            `${t.ayah}` === q ||
+            (query.includes(':') && `${t.surah}:${t.ayah}`.includes(q)) || // weak check, but okay
+            (query.includes(':') && t.ayah === parseInt(query.split(':')[1]) && t.surah.toLowerCase().includes(query.split(':')[0])) // better check? No, surah is a name in data
+        );
+        // Better matching logic
+        if (!selectedTafsir) {
+            // Try to match "93:3" style
+            if (query.includes(':')) {
+                const [s, a] = query.split(':');
+                // We don't have surah numbers in data, only names. 
+                // But let's check if user typed "duha:3"
+                selectedTafsir = tafsir_1.tafsirData.find(t => t.surah.toLowerCase().includes(s) && t.ayah.toString() === a);
+            }
+        }
+        // Hardcoded fallback for specific numbers if they were in the original code
+        // 93:3 -> Ad-Duhaa
+        if (!selectedTafsir && query === '93:3')
+            selectedTafsir = tafsir_1.tafsirData.find(t => t.surah === 'Ad-Duhaa');
+        if (!selectedTafsir && query === '1:5')
+            selectedTafsir = tafsir_1.tafsirData.find(t => t.surah === 'Al-Fatiha');
+        if (!selectedTafsir && query === '103:1')
+            selectedTafsir = tafsir_1.tafsirData.find(t => t.surah === 'Al-Asr');
+        if (!selectedTafsir && query === '112:1')
+            selectedTafsir = tafsir_1.tafsirData.find(t => t.surah === 'Al-Ikhlas');
+        if (!selectedTafsir && query === '113:1')
+            selectedTafsir = tafsir_1.tafsirData.find(t => t.surah === 'Al-Falaq');
+        if (!selectedTafsir && query === '114:1')
+            selectedTafsir = tafsir_1.tafsirData.find(t => t.surah === 'An-Nas');
+        if (!selectedTafsir) {
+            console.log(chalk_1.default.red('Tafsir not found for that Ayah.'));
+            console.log(chalk_1.default.gray('Available: Ad-Duhaa (93:3), Al-Fatiha (1:5), Al-Asr (103:1), Al-Ikhlas (112:1), Al-Falaq (113:1), An-Nas (114:1)'));
+            return;
+        }
+    }
+    else {
+        // Interactive menu if no argument provided
+        const answers = await inquirer_1.default.prompt([
+            {
+                type: 'list',
+                name: 'selectedTafsirIndex',
+                message: 'Choose a Surah/Ayah to study:',
+                choices: tafsir_1.tafsirData.map((t, index) => ({
+                    name: `${t.surah} (Ayah ${t.ayah})`,
+                    value: index
+                }))
+            }
+        ]);
+        selectedTafsir = tafsir_1.tafsirData[answers.selectedTafsirIndex];
+    }
+    if (!selectedTafsir)
+        return;
+    console.clear();
+    console.log(chalk_1.default.green.bold(`\n  Tafsir: Surah ${selectedTafsir.surah}, Ayah ${selectedTafsir.ayah}`));
+    console.log(chalk_1.default.gray('Take a deep breath. Let the words sink in.\n'));
+    for (const step of selectedTafsir.steps) {
+        await inquirer_1.default.prompt([{
+                type: 'input',
+                name: 'continue',
+                message: chalk_1.default.yellow.bold(step.word),
+                suffix: chalk_1.default.gray(' (Press Enter to reveal meaning)')
+            }]);
+        console.log(chalk_1.default.cyan(`Meaning: ${step.meaning}`));
+        console.log(chalk_1.default.white(step.explanation));
+        console.log(chalk_1.default.gray('----------------------------------------'));
+    }
+    console.log(chalk_1.default.green.bold('\n  Final Reflection:'));
+    console.log(chalk_1.default.white.italic(selectedTafsir.finalThought));
+    console.log('');
+});

package/dist/commands/tasbih.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tasbihCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const printer_1 = require("../utils/printer");
+const sleep = (ms) => new Promise(resolve => setTimeout(resolve, ms));
+exports.tasbihCommand = new commander_1.Command('tasbih')
+    .description('Digital Counter (Tasbih)')
+    .action(async () => {
+    (0, printer_1.printCommandHeader)('tasbih');
+    let count = 0;
+    console.clear();
+    console.log(chalk_1.default.cyan.bold('\n  Digital Tasbih'));
+    console.log(chalk_1.default.gray('Press ENTER to count. Type "reset" to reset. Ctrl+C to exit.\n'));
+    // We need a loop to handle inputs
+    while (true) {
+        const { input } = await inquirer_1.default.prompt([{
+                type: 'input',
+                name: 'input',
+                message: `Count: ${chalk_1.default.green.bold(count)}  Wait for prompt...`,
+                default: '',
+                prefix: '' // Remove prefix
+            }]);
+        if (input.toLowerCase() === 'reset') {
+            count = 0;
+        }
+        else if (input.toLowerCase() === 'exit' || input.toLowerCase() === 'q') {
+            break;
+        }
+        else {
+            count++;
+        }
+        console.clear();
+        console.log(chalk_1.default.cyan.bold('\n  Digital Tasbih'));
+        console.log(chalk_1.default.gray('Press ENTER to count. Type "reset" to reset. Type "exit" to quit.\n'));
+        console.log(chalk_1.default.green.bold(`Current Count: ${count}`));
+        // Simple feedback
+        if (count % 33 === 0 && count > 0) {
+            console.log(chalk_1.default.yellow('  SubhanAllah / Alhamdulillah / Allahu Akbar (33 completed)'));
+        }
+        if (count % 100 === 0 && count > 0) {
+            console.log(chalk_1.default.magenta('  100 Completed! May Allah accept it.'));
+        }
+    }
+});

package/dist/commands/wudu.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wuduCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const nak_1 = require("../data/nak");
+const printer_1 = require("../utils/printer");
+exports.wuduCommand = new commander_1.Command('wudu')
+    .description('The Spiritual Detox (Washing away sins)')
+    .action(() => {
+    (0, printer_1.printCommandHeader)('wudu');
+    console.log(chalk_1.default.cyan.bold('\n  Wudu: The Spiritual Detox\n'));
+    nak_1.wuduData.forEach((step, index) => {
+        console.log(chalk_1.default.blue.bold(`  ${index + 1}. ${step.step}`));
+        console.log(chalk_1.default.white(`     Physical: ${step.physical}`));
+        console.log(chalk_1.default.green(`     Spiritual: ${step.spiritual}\n`));
+    });
+    console.log(chalk_1.default.gray('  "Oh Allah, make me of those who repent and those who purify themselves."'));
+});