@ihsandeen/aya 1.0.0

package/CONTRIBUTING.md

@@ -0,0 +1,39 @@
+# Contributing to the Book of Deeds 📚
+
+> "When a person dies, his deeds come to an end except for three: Sadaqah Jariyah (a continuous charity), or knowledge from which benefit is gained, or a righteous child who prays for him." (Muslim)
+
+Assalamu Alaikum wa Rahmatullah wa Barakatuh! 👋
+
+We are incredibly humbled that you want to contribute to `aya`. Think of every line of code you write here as a form of **Sadaqah Jariyah**—knowledge that will benefit others long after we are gone.
+
+Whether you're fixing a bug (removing a bad habit), adding a feature (learning a new Sunnah), or improving documentation (sharing Ilm), your efforts are recorded not just in `git log`, but in a Record far more permanent.
+
+## 🌟 The Code of Conduct (Adab)
+
+Just as we have Adab in our daily lives, we have Adab in our code:
+
+1.  **Ikhlas (Sincerity)**: Code with the intention to help others.
+2.  **Ihsan (Excellence)**: Write clean, readable, and efficient code. "Allah has prescribed Ihsan in all things."
+3.  **Respect**: Treat fellow contributors with kindness and patience.
+
+## 🛠️ How to Contribute
+
+1.  **Fork the Repository**: Create your own copy of the project.
+2.  **Create a Branch**: `git checkout -b feature/amazing-feature`.
+3.  **Code with Ihsan**: Implement your changes.
+4.  **Test**: Ensure your changes don't break existing functionality.
+5.  **Commit**: `git commit -m "feat: Add new prayer time calculation"`.
+6.  **Push**: `git push origin feature/amazing-feature`.
+7.  **Open a Pull Request**: Submit your PR (Make a Dua for its acceptance!).
+
+## 🐛 Found a Bug?
+
+If you find a bug, please open an issue. Consider it a form of *Naseehah* (advice) to the maintainers. Be gentle in your description, and we will try our best to fix it InshaAllah.
+
+## 💡 Feature Requests
+
+Have an idea to make this tool better for the Ummah? Open an issue and let's discuss! We love hearing how we can improve.
+
+---
+
+May Allah accept your contributions and place them heavy on your scale of good deeds. Ameen.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shajedul Karim
+
+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,141 @@
+# aya
+
+> "And We have fastened every man's deeds to his neck, and on the Day of Resurrection, We shall bring out for him a book which he will find wide open." (17:13)
+
+Listen, we need to talk.
+
+We live in a world of inputs and outputs. We spend our days in the terminal, typing commands, expecting results, fixing bugs, and pushing code. We are obsessed with our GitHub contribution graphs. We worry about our commit history. We stress over merge conflicts.
+
+**But have you ever stopped to think?**
+
+What about the repository of your life? What about the "issues" in your heart that have been open for years? What about the "commits" that the Angels are recording right now, at this very second?
+
+That's why we built **aya**.
+
+---
+
+## 💡 The "Insider" Story: Why We Built This
+
+You want to know the truth? This isn't just another developer tool. It’s a response to a modern problem.
+
+We live in a time where we are hyper-connected to our repositories but disconnected from our purpose. We track every line of code, but we lose track of our spiritual state.
+
+We realized something profound: **We are optimizing our code, but we are not optimizing our lives.**
+
+The idea is simple yet radical: What if the very tools we use to build the dunya could be used to build our akhirah? What if `git status` could remind you of your status with Allah?
+
+That is why **aya** exists. It is a bridge. It takes the language you already know—`git`, `status`, `push`, `pull`—and reorients it to help you track the most important project you will ever work on: **Your Soul.**
+
+---
+
+## ❓ Why "aya"?
+
+People ask me, "Why did you call it aya?"
+
+Look at the linguistics. In Arabic, **Ayah** (آية) doesn't just mean a "verse" of the Quran. It means a **Sign**. It means a **Miracle**. It means **Evidence**.
+
+Every line of code you write can be an *ayah*—a sign of Allah's perfection. Every bug you fix can be a lesson. The sun is an ayah. The wind is an ayah. And this tool? It's a humble attempt to turn your terminal into a series of *ayat*—reminders that point you back to Him.
+
+---
+
+## 🚀 Quick Start (Bismillah)
+
+You want to get started? Bismillah. It’s simple.
+
+```bash
+# 1. Install it globally (make it part of your system)
+npm install -g @ihsandeen/aya
+
+# 2. Set your intention (Niyyah) for the session
+aya init
+
+# 3. Check your connection to the Heavens
+aya status
+```
+
+---
+
+## 🔄 The Workflow (The Real Daily Grind)
+
+You see, the life of a believer is a constant cycle. It's not a straight line. We mapped this spiritual reality to your developer workflow.
+
+| Command | The Spiritual Reality (The "Why") |
+| :--- | :--- |
+| `aya init` | **Niyyah (Intention)**<br>Before you write a single line of code, ask yourself: *Who is this for?* If it's for ego, it's wasted. If it's for Allah, even a `console.log` becomes worship. This command sets that frame. |
+| `aya status` | **Salah & Connection Check**<br>You run `git status` to see changed files. `aya status` checks your *connection to the Divine*. It tells you: "Your heart is currently on branch 'dunya'." It checks if you've missed prayers. It's a reality check. Are you online with Allah, or did you timeout? |
+| `aya diff` | **The Precision of Divine Speech**<br>This isn't comparing two files. This is comparing *words*. Why did Allah use *this* specific word here and not its synonym? `aya diff` challenges you with linguistic nuances. It shows you that the Quran isn't just poetry; it's precision engineering. |
+| `aya commit` | **Amal (Deed)**<br>Every smile, every charity, every moment of patience—that's a commit. And unlike git, you can't `reset --hard` these commits once the time passes. Make them count. |
+| `aya push` | **Dua (Supplication)**<br>You have anxieties? You have bugs you can't fix? Push them up. The Server is always listening. The bandwidth is infinite. |
+| `aya pull` | **Rizq (Provision)**<br>We think we generate success. No. We just pull from the provision that was already written. Ask for guidance, and pull it down. |
+| `aya blame` | **Nafs (Self-Reproach)**<br>When code breaks, we check `git blame` to find the culprit. The believer looks in the mirror. *Nafs al-Lawwama*—the self-reproaching soul. It's healthy to admit your faults. |
+| `aya repo` | **Kitab (Book of Deeds)**<br>Imagine if you could see your Book of Deeds right now. This command opens a UI to visualize your spiritual contributions. It's eye-opening. |
+
+---
+
+## 🛠️ The Toolkit (Equip Yourself)
+
+A believer doesn't go into the battlefield unarmed. You need tools. You need reminders.
+
+### 🕌 Worship & Practice
+| Command | Why you need this |
+| :--- | :--- |
+| `aya prayers` | Because *Salah* is the anchor. If this slips, everything slips. |
+| `aya qibla` | Wherever you are, you need to know which way is Home 🕋. |
+| `aya adhan` | Sometimes we get so lost in the code, we need a call to come back to success. |
+| `aya wudu` | It's not just washing limbs. It's washing away the minor sins of the last few hours. |
+| `aya tasbih` | Keep your tongue moist. It's light on the tongue, heavy on the scale. |
+| `aya fast` | Discipline the body to feed the soul. It's a detox. |
+| `aya zakat` | Your wealth isn't yours. You're just the manager. Purify it. |
+| `aya friday` | The best day the sun has risen upon. Don't treat it like just another Friday. |
+
+### 📖 Knowledge & Reflection (Tadabbur)
+| Command | Why you need this |
+| :--- | :--- |
+| `aya tafsir` | Don't just read the Quran. *Understand* it. Dive deep. |
+| `aya memorize` | Carrying the Words of Allah in your chest is a protection. |
+| `aya seek` | Knowledge is an ocean. Start swimming. |
+| `aya names` | You can't love someone you don't know. Learn His Names. |
+| `aya parable` | Allah uses metaphors so we can understand complex realities. |
+| `aya history` | We stand on the shoulders of giants. Know your legacy. |
+| `aya hero` | The Sahaba were real people with real struggles. Learn from them. |
+| `aya sunnah` | The Prophet (pbuh) was the walking Quran. Follow his footsteps. |
+
+### 🧠 Mindset & Character
+| Command | Why you need this |
+| :--- | :--- |
+| `aya journal` | Writing is a way to shackle fleeting wisdom. Document your journey. |
+| `aya sabr` | Patience isn't passive. It's active endurance. It's grit. |
+| `aya shukr` | Gratitude is the key to increase. You want more? Be grateful. |
+| `aya adab` | You can have all the knowledge, but if you have no manners, you have nothing. |
+| `aya invest` | "Shall I tell you of a trade that will save you?" Invest in your Akhirah. |
+| `aya sleep` | Even your sleep can be worship. Prepare for the minor death. |
+
+### 🌍 World & Signs (Ayat)
+| Command | Why you need this |
+| :--- | :--- |
+| `aya nature` | Look at the sky. Look at the trees. They are all submitting. Are you? |
+| `aya anatomy` | Look at your own hands. The complexity is a sign of the Designer. |
+| `aya scene` | Visualize the Day of Judgment. It puts your compile errors in perspective. |
+| `aya lens` | Shift your perspective. See the world through the lens of the Believer. |
+| `aya mirror` | The believer is a mirror to his brother. What do you reflect? |
+| `aya sound` | Let the recitation of the Quran soothe your heart. |
+| `aya hijri` | Step out of the Gregorian construct. Live by the moon. |
+
+---
+
+## 🤝 Contributing (Sadaqah Jariyah)
+
+Listen, this project isn't about me. It's about *us*. It's a **Sadaqah Jariyah**—a continuing charity. Imagine someone using this tool and remembering Allah because of a line of code you wrote. That's a reward that continues even after you're gone.
+
+**Want to earn that reward?** 👇
+
+1.  **Clone it**: `git clone https://github.com/ihsandeen/aya.git`
+2.  **Install it**: `npm install`
+3.  **Build it**: `npm run build`
+4.  **Link it**: `npm link`
+
+If you find a bug, fix it. If you have an idea, build it. Do it with *Ihsan* (excellence).
+
+---
+
+*May Allah accept this humble effort from us and make it a witness for us on the Day of Judgment.* 🤲

package/dist/commands/adab.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.adabCommand = 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.adabCommand = new commander_1.Command('adab')
+    .description('The Manners Engine (Relationships)')
+    .action(async () => {
+    (0, printer_1.printCommandHeader)('adab');
+    const { relation } = await inquirer_1.default.prompt([{
+            type: 'list',
+            name: 'relation',
+            message: 'Select a relationship to improve:',
+            choices: nak_1.adabData.map(r => r.relation)
+        }]);
+    const data = nak_1.adabData.find(r => r.relation === relation);
+    if (data) {
+        console.log(chalk_1.default.blue.bold(`\n  Relationship: ${data.relation}`));
+        console.log(chalk_1.default.yellow(`  Quranic Keyword: ${data.arabicKeyword} (${data.meaning})`));
+        console.log(chalk_1.default.white(`  Practice: ${data.practice}\n`));
+    }
+});

package/dist/commands/adhan.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.adhanCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const child_process_1 = require("child_process");
+const os_1 = __importDefault(require("os"));
+const printer_1 = require("../utils/printer");
+exports.adhanCommand = new commander_1.Command('adhan')
+    .description('Call to Prayer (Adhan) - Plays audio or shows text')
+    .option('-s, --silent', 'Show text only, do not play audio')
+    .action(async (options) => {
+    (0, printer_1.printCommandHeader)('adhan');
+    console.log(chalk_1.default.green.bold('\n  Allahu Akbar, Allahu Akbar\n'));
+    const lines = [
+        { arabic: 'الله أكبر الله أكبر', translation: 'God is the Greatest, God is the Greatest' },
+        { arabic: 'أشهد أن لا إله إلا الله', translation: 'I bear witness that there is no god except God' },
+        { arabic: 'أشهد أن محمدا رسول الله', translation: 'I bear witness that Muhammad is the Messenger of God' },
+        { arabic: 'حي على الصلاة', translation: 'Hasten to the prayer' },
+        { arabic: 'حي على الفلاح', translation: 'Hasten to success' },
+        { arabic: 'الله أكبر الله أكبر', translation: 'God is the Greatest, God is the Greatest' },
+        { arabic: 'لا إله إلا الله', translation: 'There is no god except God' }
+    ];
+    // Print Adhan beautifully with delays
+    for (const line of lines) {
+        console.log(chalk_1.default.yellow.bold(line.arabic));
+        console.log(chalk_1.default.gray(line.translation));
+        console.log('');
+        await new Promise(resolve => setTimeout(resolve, 1500));
+    }
+    if (!options.silent) {
+        const spinner = (0, ora_1.default)('Playing Adhan...').start();
+        // Attempt to play a system sound
+        try {
+            if (os_1.default.platform() === 'darwin') {
+                // macOS
+                (0, child_process_1.exec)('afplay /System/Library/Sounds/Glass.aiff');
+            }
+            else if (os_1.default.platform() === 'linux') {
+                // Linux (try paplay or aplay)
+                (0, child_process_1.exec)('paplay /usr/share/sounds/freedesktop/stereo/complete.oga || aplay /usr/share/sounds/alsa/Front_Center.wav');
+            }
+            else if (os_1.default.platform() === 'win32') {
+                // Windows
+                // PowerShell beep
+                (0, child_process_1.exec)('powershell -c "(New-Object Media.SoundPlayer \'C:\\Windows\\Media\\notify.wav\').PlaySync();"');
+            }
+        }
+        catch (e) {
+            // Ignore errors if sound fails
+        }
+        spinner.succeed('Adhan completed.');
+    }
+});

package/dist/commands/anatomy.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.anatomyCommand = 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.anatomyCommand = new commander_1.Command('anatomy')
+    .description('The Spiritual Function of Body Parts')
+    .action(async () => {
+    (0, printer_1.printCommandHeader)('anatomy');
+    const { part } = await inquirer_1.default.prompt([{
+            type: 'list',
+            name: 'part',
+            message: 'Select a body part to understand its spiritual role:',
+            choices: nak_1.anatomyData.map(p => p.part)
+        }]);
+    const data = nak_1.anatomyData.find(p => p.part === part);
+    if (data) {
+        console.log(chalk_1.default.blue.bold(`\n  ${data.part} (${data.arabic})`));
+        console.log(chalk_1.default.white(`  Function: ${data.function}`));
+        console.log(chalk_1.default.green(`  Spiritual Role: ${data.spiritualRole}`));
+        console.log(chalk_1.default.gray(`\n  Reflection:\n  ${data.reflection}\n`));
+    }
+});

package/dist/commands/blame.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blameCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const printer_1 = require("../utils/printer");
+const boxen_1 = __importDefault(require("boxen"));
+exports.blameCommand = new commander_1.Command('blame')
+    .description('Self-reflection tool (Muhasabah)')
+    .action(() => {
+    (0, printer_1.printCommandHeader)('blame');
+    console.log((0, boxen_1.default)(chalk_1.default.red.bold(' git blame? No. ') + '\n' +
+        chalk_1.default.yellow(" It wasn't the compiler. It wasn't the PM. ") + '\n\n' +
+        chalk_1.default.white.italic('"Nay, man is evidence against himself." (75:14)'), {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'double',
+        borderColor: 'red',
+        title: 'Muhasabah (Self-Audit)',
+        titleAlignment: 'center'
+    }));
+    console.log(chalk_1.default.cyan(' ➜ Take a breath.'));
+    console.log(chalk_1.default.cyan(' ➜ Say Astaghfirullah.'));
+    console.log(chalk_1.default.cyan(' ➜ Debug with a clear heart.'));
+    console.log('');
+});

package/dist/commands/commit.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commitCommand = void 0;
+const commander_1 = require("commander");
+const inquirer_1 = __importDefault(require("inquirer"));
+const chalk_1 = __importDefault(require("chalk"));
+const printer_1 = require("../utils/printer");
+const logger_1 = require("../utils/logger");
+exports.commitCommand = new commander_1.Command('commit')
+    .description('Commit a good deed or intention')
+    .option('-m, --message <message>', 'The deed you commit to')
+    .action(async (options) => {
+    (0, printer_1.printCommandHeader)('commit');
+    let message = options.message;
+    if (!message) {
+        const answers = await inquirer_1.default.prompt([
+            {
+                type: 'input',
+                name: 'message',
+                message: 'What good deed are you committing to today?',
+                validate: (input) => input.length > 0 ? true : 'Please enter a valid commitment.'
+            }
+        ]);
+        message = answers.message;
+    }
+    // Log the commit using our new utility
+    const commit = logger_1.logger.logCommit(message);
+    const totalDeeds = logger_1.logger.getTotalDeeds();
+    // NAK Style Output
+    console.log(chalk_1.default.gray(`[main ${commit.hash}] Commit confirmed.`));
+    console.log(chalk_1.default.green(' Angels are recording. 📝'));
+    console.log(chalk_1.default.cyan(` + 1 good deed added to your scale.`));
+    // Encouragement based on total deeds
+    let encouragement = "";
+    if (totalDeeds % 10 === 0)
+        encouragement = chalk_1.default.yellow.bold(" MashaAllah! A milestone reached!");
+    else if (totalDeeds === 1)
+        encouragement = chalk_1.default.yellow.bold(" Bismillah! Your first step.");
+    console.log(chalk_1.default.white(` Total good deeds recorded: ${chalk_1.default.bold(totalDeeds)}`) + encouragement);
+    console.log(chalk_1.default.dim('\n"Verily, the good deeds remove the evil deeds." (11:114)'));
+});

package/dist/commands/diff.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.diffCommand = 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.diffCommand = new commander_1.Command('diff')
+    .description('The "Almost" Word (Synonym Challenge)')
+    .action(async () => {
+    (0, printer_1.printCommandHeader)('diff');
+    console.clear();
+    console.log(chalk_1.default.yellow.bold('\n  Aya Diff: The Precision of Divine Speech'));
+    console.log(chalk_1.default.gray('Why did Allah use *this* word and not *that* one?\n'));
+    // Select a random challenge or iterate? Let's just pick one for now or loop.
+    // Let's loop through all available challenges.
+    for (const challenge of nak_1.diffData) {
+        console.log(chalk_1.default.white.bold(`Prompt: "${challenge.prompt}"`));
+        const answer = await inquirer_1.default.prompt([{
+                type: 'list',
+                name: 'choice',
+                message: 'Which word is used in the Quran?',
+                choices: challenge.options.map(o => ({
+                    name: o.label,
+                    value: o.value
+                }))
+            }]);
+        const selected = challenge.options.find(o => o.value === answer.choice);
+        const isCorrect = selected?.isCorrect;
+        if (isCorrect) {
+            console.log(chalk_1.default.green.bold('\n  Correct!'));
+        }
+        else {
+            console.log(chalk_1.default.red.bold(`\n  Not quite. The Quran uses: ${challenge.reveal}`));
+        }
+        console.log(chalk_1.default.cyan.italic(`\n  Lesson: ${challenge.lesson}`));
+        console.log(chalk_1.default.gray('----------------------------------------\n'));
+        // Pause before next?
+        const { next } = await inquirer_1.default.prompt([{
+                type: 'confirm',
+                name: 'next',
+                message: 'Next challenge?',
+                default: true
+            }]);
+        if (!next)
+            break;
+        console.clear();
+    }
+    console.log(chalk_1.default.yellow('End of challenges. SubhanAllah!'));
+});

package/dist/commands/dua.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.duaCommand = 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.duaCommand = new commander_1.Command('dua')
+    .description('Prophetic Duas with Context & Backstory')
+    .action(async () => {
+    (0, printer_1.printCommandHeader)('dua');
+    const { situation } = await inquirer_1.default.prompt([{
+            type: 'list',
+            name: 'situation',
+            message: 'What are you feeling / facing?',
+            choices: nak_1.duaData.map(d => ({ name: d.situation, value: d }))
+        }]);
+    displayDua(situation);
+});
+function displayDua(dua) {
+    console.clear();
+    console.log(chalk_1.default.yellow.bold(`\n  The Dua of ${dua.prophet}`));
+    console.log(chalk_1.default.gray(`  Situation: ${dua.situation}\n`));
+    console.log(chalk_1.default.cyan.bold('  The Backstory (Context):'));
+    console.log(chalk_1.default.white(`  ${dua.context}\n`));
+    console.log(chalk_1.default.green.bold(`  "${dua.arabic}"`));
+    console.log(chalk_1.default.white.italic(`  "${dua.translation}"\n`));
+    console.log(chalk_1.default.magenta.bold('  The Gem:'));
+    console.log(chalk_1.default.white(`  ${dua.gem}\n`));
+}

package/dist/commands/fast.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fastCommand = 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.fastCommand = new commander_1.Command('fast')
+    .description('Sunnah Fasting Reminders & Spiritual Why')
+    .action(async () => {
+    (0, printer_1.printCommandHeader)('fast');
+    console.clear();
+    console.log(chalk_1.default.green.bold('\n  The Shield of Fasting (As-Sawm)\n'));
+    const today = new Date();
+    const day = today.getDay(); // 0 = Sun, 1 = Mon, 4 = Thu
+    // Check if tomorrow is Mon (1) or Thu (4)
+    const isSunnahTomorrow = day === 0 || day === 3;
+    const isSunnahToday = day === 1 || day === 4;
+    if (isSunnahToday) {
+        console.log(chalk_1.default.yellow.bold('  Today is a Sunnah fasting day! (Monday/Thursday)'));
+        console.log(chalk_1.default.gray('  "The gates of Paradise are opened..."\n'));
+    }
+    else if (isSunnahTomorrow) {
+        console.log(chalk_1.default.cyan.bold('  Tomorrow is a Sunnah fasting day! Prepare your Suhoor.'));
+    }
+    console.log(chalk_1.default.white.bold('  Why we fast (beyond Ramadan):'));
+    nak_1.fastData.forEach(f => {
+        console.log(chalk_1.default.blue.bold(`\n  ${f.type} (${f.when})`));
+        console.log(chalk_1.default.white(`  Reward: ${f.reward}`));
+        console.log(chalk_1.default.gray.italic(`  "${f.spiritualWhy}"`));
+    });
+    console.log('\n');
+});

package/dist/commands/friday.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fridayCommand = 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.fridayCommand = new commander_1.Command('friday')
+    .description('The Jumu\'ah Manager')
+    .action(() => {
+    (0, printer_1.printCommandHeader)('friday');
+    console.log(chalk_1.default.cyan.bold('\n  Friday (Jumu\'ah) Checklist & Reflections\n'));
+    nak_1.fridayData.forEach((item) => {
+        console.log(chalk_1.default.blue.bold(`  [ ] ${item.item}`));
+        console.log(chalk_1.default.white(`      Significance: ${item.significance}`));
+        console.log(chalk_1.default.gray(`      Deep Dive: ${item.nakNote}\n`));
+    });
+});

package/dist/commands/hero.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.heroCommand = 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 drawBar = (val, max = 10) => {
+    // Use simple ASCII blocks if needed, but standard ones are fine
+    const filledChar = '█';
+    const emptyChar = '░';
+    const filled = filledChar.repeat(val);
+    const empty = emptyChar.repeat(max - val);
+    // Color logic
+    let color = chalk_1.default.red;
+    if (val >= 8)
+        color = chalk_1.default.green;
+    else if (val >= 5)
+        color = chalk_1.default.yellow;
+    return `${color(filled)}${chalk_1.default.gray(empty)} ${val}/${max}`;
+};
+exports.heroCommand = new commander_1.Command('hero')
+    .description('The Prophet Profile (RPG Character Sheet)')
+    .argument('[name]', 'Name of the Prophet (e.g. Musa)')
+    .action(async (name) => {
+    (0, printer_1.printCommandHeader)('hero');
+    let data = name
+        ? nak_1.heroData.find(h => h.name.toLowerCase().includes(name.toLowerCase()))
+        : null;
+    if (!data && name) {
+        console.log(chalk_1.default.red('Profile not found for that Prophet.'));
+    }
+    if (!data) {
+        const { choice } = await inquirer_1.default.prompt([{
+                type: 'list',
+                name: 'choice',
+                message: 'Select a Prophet to view profile:',
+                choices: nak_1.heroData.map(h => ({
+                    name: h.name,
+                    value: h
+                }))
+            }]);
+        data = choice;
+    }
+    if (!data)
+        return;
+    console.clear();
+    console.log(chalk_1.default.cyan.bold(`\n  Aya Hero: ${data.name}`));
+    console.log(chalk_1.default.gray(`Title: ${data.title}\n`));
+    console.log(chalk_1.default.white.bold('  Stats:'));
+    console.log(`Strength:  ${drawBar(data.stats.strength)}`);
+    console.log(`Speech:    ${drawBar(data.stats.speech)}`);
+    console.log(`Patience:  ${drawBar(data.stats.patience)}`);
+    console.log(`Wisdom:    ${drawBar(data.stats.wisdom)}`);
+    console.log(chalk_1.default.gray('----------------------------------------'));
+    console.log(chalk_1.default.yellow.bold('\n  Special Ability:'));
+    console.log(chalk_1.default.white(data.specialAbility));
+    console.log(chalk_1.default.red.bold('\n  Weakness / Challenge:'));
+    console.log(chalk_1.default.white(data.weakness));
+    console.log(chalk_1.default.magenta.bold('\n  Arch-Nemesis:'));
+    console.log(chalk_1.default.white(data.archNemesis));
+    console.log(chalk_1.default.blue.bold('\n  Quranic Profile:'));
+    console.log(chalk_1.default.italic(data.quranicProfile));
+    console.log('');
+});

package/dist/commands/hijri.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hijriCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const axios_1 = __importDefault(require("axios"));
+const ora_1 = __importDefault(require("ora"));
+const date_fns_1 = require("date-fns");
+const printer_1 = require("../utils/printer");
+exports.hijriCommand = new commander_1.Command('hijri')
+    .description('Date Converter (Gregorian <-> Hijri)')
+    .option('-d, --date <date>', 'Date to convert (DD-MM-YYYY)')
+    .action(async (options) => {
+    (0, printer_1.printCommandHeader)('hijri');
+    const spinner = (0, ora_1.default)('Converting date...').start();
+    try {
+        const today = new Date();
+        const dateStr = options.date || (0, date_fns_1.format)(today, 'dd-MM-yyyy');
+        // Use Aladhan API for accurate conversion based on sighting adjustment if needed
+        const response = await axios_1.default.get(`http://api.aladhan.com/v1/gToH/${dateStr}`);
+        const data = response.data.data;
+        const hijri = data.hijri;
+        const gregorian = data.gregorian;
+        spinner.stop();
+        console.clear();
+        console.log(chalk_1.default.green.bold('\n  Islamic Date Converter'));
+        console.log(chalk_1.default.gray('----------------------------------------'));
+        console.log(chalk_1.default.white('Gregorian: ') + chalk_1.default.bold(`${gregorian.day} ${gregorian.month.en} ${gregorian.year}`));
+        console.log(chalk_1.default.yellow('Hijri:     ') + chalk_1.default.bold(`${hijri.day} ${hijri.month.en} ${hijri.year}`));
+        console.log(chalk_1.default.gray(`(${hijri.month.ar})`));
+        console.log('');
+        console.log(chalk_1.default.cyan(`Weekday:   ${hijri.weekday.en} (${hijri.weekday.ar})`));
+        console.log('');
+    }
+    catch (error) {
+        spinner.fail('Conversion failed.');
+        console.log(chalk_1.default.red('Please ensure date format is DD-MM-YYYY'));
+    }
+});