@ihsandeen/aya 1.0.0

package/dist/commands/nazm.js

@@ -0,0 +1,100 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nazmCommand = 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.nazmCommand = new commander_1.Command('nazm')
+    .description('The Symmetry Visualizer (Ring Structure)')
+    .argument('[surah]', 'The Surah to visualize (e.g. fatiha)')
+    .action((surah) => {
+    (0, printer_1.printCommandHeader)('nazm');
+    const data = nak_1.nazmData.find(d => d.surah.toLowerCase().includes(surah?.toLowerCase() || 'fatiha'));
+    if (!data) {
+        console.log(chalk_1.default.red('Symmetry structure not found for that Surah.'));
+        console.log(chalk_1.default.gray('Currently available: Al-Fatiha'));
+        return;
+    }
+    console.clear();
+    console.log(chalk_1.default.green.bold(`\n  Aya Nazm: ${data.surah}`));
+    console.log(chalk_1.default.gray(data.description));
+    console.log(chalk_1.default.gray('----------------------------------------\n'));
+    const lines = data.ayahs;
+    const connections = data.connections;
+    const center = data.center;
+    // 1. Sort connections by size (distance) -> smallest first (innermost)
+    const sortedConns = [...connections].sort((a, b) => {
+        const distA = Math.abs(a[1] - a[0]);
+        const distB = Math.abs(b[1] - b[0]);
+        return distA - distB;
+    });
+    const maxLineLen = 50; // Truncate text for display
+    const padding = 2;
+    lines.forEach((line, index) => {
+        const ayahNum = index + 1;
+        // Prepare text part
+        let textPart = `${ayahNum}. ${line}`;
+        if (textPart.length > maxLineLen) {
+            textPart = textPart.substring(0, maxLineLen - 3) + '...';
+        }
+        textPart = textPart.padEnd(maxLineLen + padding);
+        // Prepare tracks
+        const tracks = [];
+        let activeConnIdx = -1;
+        for (let i = 0; i < sortedConns.length; i++) {
+            const [start, end] = sortedConns[i];
+            const min = Math.min(start, end);
+            const max = Math.max(start, end);
+            if (ayahNum === min) {
+                tracks[i] = '┐';
+                activeConnIdx = i;
+            }
+            else if (ayahNum === max) {
+                tracks[i] = '┘';
+                activeConnIdx = i;
+            }
+            else if (ayahNum > min && ayahNum < max) {
+                tracks[i] = '│';
+            }
+            else {
+                tracks[i] = ' ';
+            }
+        }
+        // Build the visual string
+        let visual = '';
+        for (let i = 0; i < sortedConns.length; i++) {
+            const char = tracks[i];
+            const isTarget = i === activeConnIdx;
+            const isInner = i < activeConnIdx;
+            // If this track is the target (start/end), we connect to it
+            if (isTarget) {
+                visual += chalk_1.default.cyan('──' + char);
+            }
+            // If this track is inner to the target, we draw a line through it
+            else if (isInner && activeConnIdx !== -1) {
+                // Verify we are not overwriting a vertical line (should not happen in proper nesting)
+                if (char === '│')
+                    visual += chalk_1.default.cyan('──│'); // Crossing?
+                else
+                    visual += chalk_1.default.cyan('───');
+            }
+            // If this track is outer or unrelated
+            else {
+                if (char === '│')
+                    visual += chalk_1.default.cyan('  │');
+                else
+                    visual += '   ';
+            }
+        }
+        // Add center marker if applicable
+        if (center && ayahNum === center) {
+            visual += chalk_1.default.yellow('  <<  The Heart');
+        }
+        console.log(textPart + visual);
+    });
+    console.log('');
+});

package/dist/commands/parable.js

@@ -0,0 +1,332 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parableCommand = 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(r => setTimeout(r, ms));
+const spiderParable = {
+    name: 'spider',
+    surah: 'Al-Ankabut',
+    ayah: '29:41',
+    title: 'The House of the Spider',
+    animate: async () => {
+        console.clear();
+        const frames = [
+            `
+      / \\
+     /   \\
+    /     \\
+   /_______\\
+  |         |
+  |         |
+      `,
+            `
+      / \\
+     /   \\
+    /  🕷️  \\
+   /_______\\
+  |         |
+  |         |
+      `,
+            `
+      / \\
+     / 🪰 \\
+    /  🕷️  \\
+   /_______\\
+  |         |
+  |         |
+      `
+        ];
+        // Build the web
+        for (const frame of frames) {
+            console.clear();
+            console.log(chalk_1.default.gray(frame));
+            await sleep(800);
+        }
+        await sleep(500);
+        console.log(chalk_1.default.white.italic('\n"The example of those who take allies other than Allah..."'));
+        await sleep(2500);
+        console.log(chalk_1.default.white.italic('"...is that of the spider who builds a house."'));
+        await sleep(2500);
+        // Crumble animation
+        const crumblingFrames = [
+            `
+      / \\
+     / 🪰 \\
+    /  🕷️  \\
+   /_______\\
+  |         |
+  |         |
+      `,
+            `
+      / \\
+     /    \\
+    /  🕷️   \\
+   /       \\
+  |         |
+  |         |
+      `,
+            `
+      / 
+     /    
+       🕷️   
+   /       
+            |
+  |         
+      `,
+            `
+      
+     
+       🕷️   
+   
+            
+  
+      `,
+            `
+      
+     
+          
+   
+            
+  
+      `
+        ];
+        for (const frame of crumblingFrames) {
+            console.clear();
+            console.log(chalk_1.default.gray(frame));
+            await sleep(400); // Slower crumble to be visible
+        }
+        console.clear();
+        console.log(chalk_1.default.red.bold('\nThe web is gone.'));
+        await sleep(1000);
+        console.log(chalk_1.default.white.bold('\n"And indeed, the weakest of houses is the house of the spider." (29:41)'));
+        console.log(chalk_1.default.gray('\nLesson: Reliance on anything other than Allah is like leaning on a spider web.'));
+    }
+};
+const rainParable = {
+    name: 'rain',
+    surah: 'Al-Baqarah',
+    ayah: '2:265',
+    title: 'The Heavy Rain',
+    animate: async () => {
+        console.clear();
+        const clouds = `
+      ☁️   ☁️    ☁️
+    `;
+        console.log(clouds);
+        await sleep(1000);
+        const rainFrames = [
+            `
+      ☁️   ☁️    ☁️
+      💧   💧    💧
+      `,
+            `
+      ☁️   ☁️    ☁️
+      
+      💧   💧    💧
+      `,
+            `
+      ☁️   ☁️    ☁️
+      
+      
+      💧   💧    💧
+      `,
+            `
+      ☁️   ☁️    ☁️
+      
+      
+      🌱   🌱    🌱
+      ========
+      `
+        ];
+        for (let i = 0; i < 4; i++) { // Loop rain a few times
+            for (const frame of rainFrames.slice(0, 3)) {
+                console.clear();
+                console.log(chalk_1.default.blue(frame));
+                await sleep(200);
+            }
+        }
+        // Final growth
+        console.clear();
+        console.log(chalk_1.default.green(rainFrames[3]));
+        await sleep(1000);
+        console.log(chalk_1.default.green.bold('\nLife springs forth.'));
+        console.log(chalk_1.default.white.italic('\n"And Allah sees what you do. Sincerity makes even small deeds grow like a garden after rain."'));
+    }
+};
+const lightParable = {
+    name: 'light',
+    surah: 'An-Nur',
+    ayah: '24:35',
+    title: 'Light upon Light',
+    animate: async () => {
+        const lampFrames = [
+            `
+      ✨
+     🕯️
+    💡
+   🌟
+    `,
+            `
+     ✨
+    🕯️
+     💡
+    🌟
+    `,
+            `
+      ✨
+     🕯️
+    💡
+   🌟
+    `,
+            `
+    ✨
+     🕯️
+      💡
+       🌟
+    `
+        ];
+        console.log(chalk_1.default.white.italic('\n"Allah is the Light of the heavens and the earth."'));
+        await sleep(1500);
+        for (let i = 0; i < 10; i++) {
+            console.clear();
+            const frame = lampFrames[i % lampFrames.length];
+            // Randomly colorize for flickering effect
+            const color = Math.random() > 0.5 ? chalk_1.default.yellow : chalk_1.default.yellowBright;
+            console.log(color.bold(frame));
+            await sleep(200);
+        }
+        console.log(chalk_1.default.white.italic('\n"Light upon light. Allah guides to His light whom He wills."'));
+    }
+};
+const ropeParable = {
+    name: 'rope',
+    surah: 'Ali \'Imran',
+    ayah: '3:103',
+    title: 'The Rope of Allah',
+    animate: async () => {
+        console.clear();
+        const frames = [
+            `
+      
+      
+      
+      
+      (   ALL   )
+       \\_______/
+      `,
+            `
+          |
+          |
+      
+      
+      (   ALL   )
+       \\_______/
+      `,
+            `
+          |
+          |
+          |
+          |
+      (   ALL   )
+       \\_______/
+      `,
+            `
+          |
+          |
+         /|\\
+        / | \\
+       /  |  \\
+      ( 🤝 ALL 🤝 )
+       \\_______/
+      `
+        ];
+        for (const frame of frames) {
+            console.clear();
+            console.log(chalk_1.default.blue(frame));
+            await sleep(800);
+        }
+        await sleep(500);
+        console.log(chalk_1.default.yellow('\nImagine if everyone let go... 💔'));
+        await sleep(2000);
+        console.log(chalk_1.default.green('\nBut if we hold tight... 🤝'));
+        await sleep(1000);
+        console.log(chalk_1.default.white.italic('\n"And hold firmly to the rope of Allah all together and do not become divided." (3:103)'));
+        console.log(chalk_1.default.gray('\nTadabbur: The "Rope" is the Quran/Covenant. Holding it *together* is our only safety from the pit of fire.'));
+    }
+};
+const treeParable = {
+    name: 'tree',
+    surah: 'Ibrahim',
+    ayah: '14:24',
+    title: 'The Good Tree',
+    animate: async () => {
+        const frames = [
+            `
+            . (seed)
+            `,
+            `
+            🌱
+            `,
+            `
+            🌿
+            |
+            `,
+            `
+           🌳
+           |
+           |
+            `,
+            `
+           🌳🌳
+           ||
+           ||
+          root
+            `
+        ];
+        for (const frame of frames) {
+            console.clear();
+            console.log(chalk_1.default.green(frame));
+            await sleep(800);
+        }
+        console.log(chalk_1.default.white.italic('\n"A good word is like a good tree, its root is firm and its branches are in the sky."'));
+    }
+};
+const parables = [spiderParable, rainParable, lightParable, ropeParable, treeParable];
+exports.parableCommand = new commander_1.Command('parable')
+    .description('Visual Quranic Metaphors (Animated)')
+    .argument('[name]', 'Name of the parable (e.g., spider, rain, light)')
+    .action(async (name) => {
+    (0, printer_1.printCommandHeader)('parable');
+    let selectedParable;
+    if (name) {
+        selectedParable = parables.find(p => p.name.toLowerCase() === name.toLowerCase());
+        if (!selectedParable) {
+            console.log(chalk_1.default.red('Parable not found.'));
+            return;
+        }
+    }
+    else {
+        const answers = await inquirer_1.default.prompt([
+            {
+                type: 'list',
+                name: 'parable',
+                message: 'Choose a parable to visualize:',
+                choices: parables.map(p => p.name)
+            }
+        ]);
+        selectedParable = parables.find(p => p.name === answers.parable);
+    }
+    if (selectedParable) {
+        console.clear();
+        console.log(chalk_1.default.green.bold(`\n${selectedParable.title}`));
+        console.log(chalk_1.default.gray(`Surah ${selectedParable.surah} (${selectedParable.ayah})`));
+        await sleep(1500);
+        await selectedParable.animate();
+    }
+});

package/dist/commands/prayers.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prayersCommand = 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 inquirer_1 = __importDefault(require("inquirer"));
+const config_1 = require("../utils/config");
+const printer_1 = require("../utils/printer");
+exports.prayersCommand = new commander_1.Command('prayers')
+    .description('Show Prayer Times')
+    .option('-c, --config', 'Configure location')
+    .action(async (options) => {
+    (0, printer_1.printCommandHeader)('prayers');
+    let config = (0, config_1.getConfig)();
+    if (options.config || !config.location?.city || !config.location?.country) {
+        const answers = await inquirer_1.default.prompt([
+            { type: 'input', name: 'city', message: 'Enter your city:', default: config.location?.city },
+            { type: 'input', name: 'country', message: 'Enter your country:', default: config.location?.country }
+        ]);
+        config.location = { city: answers.city, country: answers.country };
+        (0, config_1.setConfig)(config);
+    }
+    const { city, country } = config.location;
+    const spinner = (0, ora_1.default)(`Fetching prayer times for ${city}, ${country}...`).start();
+    try {
+        const response = await axios_1.default.get('http://api.aladhan.com/v1/timingsByCity', {
+            params: {
+                city,
+                country,
+                method: 2 // ISNA (can be configurable later)
+            }
+        });
+        spinner.stop();
+        const timings = response.data.data.timings;
+        const date = response.data.data.date.readable;
+        const hijri = response.data.data.date.hijri;
+        console.clear();
+        console.log(chalk_1.default.green.bold(`\n  Prayer Times for ${city}, ${country}`));
+        console.log(chalk_1.default.gray(`  ${date} | ${hijri.day} ${hijri.month.en} ${hijri.year}`));
+        console.log(chalk_1.default.gray('----------------------------------------'));
+        const prayers = [
+            { name: 'Fajr', time: timings.Fajr, icon: '[FAJR]' },
+            { name: 'Sunrise', time: timings.Sunrise, icon: '[SHRQ]' },
+            { name: 'Dhuhr', time: timings.Dhuhr, icon: '[DHUR]' },
+            { name: 'Asr', time: timings.Asr, icon: '[ASR ]' },
+            { name: 'Maghrib', time: timings.Maghrib, icon: '[MAGH]' },
+            { name: 'Isha', time: timings.Isha, icon: '[ISHA]' }
+        ];
+        prayers.forEach(p => {
+            console.log(`${p.icon}  ${chalk_1.default.bold(p.name.padEnd(10))} ${chalk_1.default.cyan(p.time)}`);
+        });
+        console.log('');
+    }
+    catch (error) {
+        spinner.fail('Failed to fetch prayer times.');
+        console.error(chalk_1.default.red('Please check your internet connection or location settings.'));
+    }
+});

package/dist/commands/pull.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.pullCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const gems_1 = require("../data/gems");
+const printer_1 = require("../utils/printer");
+exports.pullCommand = new commander_1.Command('pull')
+    .description('Pull a random ayah or hadith for reflection')
+    .action(async () => {
+    (0, printer_1.printCommandHeader)('pull');
+    const spinner = (0, ora_1.default)('Fetching divine wisdom...').start();
+    // Simulate a small delay for effect
+    await new Promise(resolve => setTimeout(resolve, 800));
+    const randomGem = gems_1.gems[Math.floor(Math.random() * gems_1.gems.length)];
+    spinner.succeed(chalk_1.default.green('Reflection loaded.'));
+    console.log('');
+    console.log(chalk_1.default.yellow.bold(`"${randomGem.text}"`));
+    console.log(chalk_1.default.gray(`— ${randomGem.source}`));
+    console.log('');
+    console.log(chalk_1.default.blue.bold('Language Gem:'));
+    console.log(chalk_1.default.white(randomGem.reflection));
+    console.log('');
+});

package/dist/commands/push.js

@@ -0,0 +1,156 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pushCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const printer_1 = require("../utils/printer");
+const boxen_1 = __importDefault(require("boxen"));
+// Store Duas in the local project scope (like Pull Requests)
+const DUA_FILE = path_1.default.join(process.cwd(), '.aya', 'duas.json');
+exports.pushCommand = new commander_1.Command('push')
+    .description('Push goodness to the world (Sadaqah/Du\'a) or your Dua Jar')
+    .action(async () => {
+    (0, printer_1.printCommandHeader)('push');
+    const choices = [
+        { name: '🌍 Push to Origin Jannah (Daily Sadaqah/Deed)', value: 'sadaqah' },
+        { name: '🏺 Push to Dua Jar (My Personal PRs)', value: 'dua' }
+    ];
+    const { mode } = await inquirer_1.default.prompt([
+        {
+            type: 'list',
+            name: 'mode',
+            message: 'Select your push target:',
+            choices
+        }
+    ]);
+    if (mode === 'sadaqah') {
+        showDailyDeed();
+    }
+    else {
+        await handleDuaJar();
+    }
+});
+function showDailyDeed() {
+    console.log(chalk_1.default.green.bold('\n🚀 Pushing to origin jannah...'));
+    const actions = [
+        {
+            text: "Make du'a for the oppressed around the world.",
+            link: "Prophet (saw) said: 'The du'a of a Muslim for his brother in his absence is readily accepted.'"
+        },
+        {
+            text: "Donate to a verified charity today.",
+            link: "LaunchGood.com / IslamicRelief.com"
+        },
+        {
+            text: "Call your parents.",
+            link: "Paradise lies at the feet of your mother."
+        },
+        {
+            text: "Remove something harmful from the path.",
+            link: "It is a branch of faith."
+        },
+        {
+            text: "Smile at your brother/sister.",
+            link: "It is a charity."
+        },
+        {
+            text: "Feed a stray cat or bird.",
+            link: "There is reward in serving every living liver."
+        }
+    ];
+    const randomAction = actions[Math.floor(Math.random() * actions.length)];
+    console.log((0, boxen_1.default)(chalk_1.default.white(`Action item: ${chalk_1.default.bold(randomAction.text)}`) + '\n' +
+        chalk_1.default.gray(randomAction.link), {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'yellow',
+        title: 'Daily Sadaqah Commit',
+        titleAlignment: 'center'
+    }));
+    console.log(chalk_1.default.yellow('Your code is temporary. Your impact is eternal.'));
+}
+async function handleDuaJar() {
+    const { action } = await inquirer_1.default.prompt([
+        {
+            type: 'list',
+            name: 'action',
+            message: 'Dua Jar Options:',
+            choices: [
+                { name: '📝 Add a new Dua (Open PR)', value: 'add' },
+                { name: '🤲 Pull a random Dua (Review)', value: 'pull' },
+                { name: '📜 List all Duas (Log)', value: 'list' }
+            ]
+        }
+    ]);
+    const duas = loadDuas();
+    if (action === 'add') {
+        const { duaText } = await inquirer_1.default.prompt([
+            {
+                type: 'input',
+                name: 'duaText',
+                message: 'Write your dua here:'
+            }
+        ]);
+        if (duaText.trim()) {
+            duas.push({
+                text: duaText,
+                date: new Date().toISOString()
+            });
+            saveDuas(duas);
+            console.log(chalk_1.default.green('\n✅ Dua pushed to the jar. May Allah accept it.'));
+        }
+    }
+    else if (action === 'pull') {
+        if (duas.length === 0) {
+            console.log(chalk_1.default.yellow('\nYour Dua Jar is empty. Add some duas first!'));
+        }
+        else {
+            const randomDua = duas[Math.floor(Math.random() * duas.length)];
+            console.log((0, boxen_1.default)(chalk_1.default.white.bold(`"${randomDua.text}"`) + '\n\n' +
+                chalk_1.default.gray(`(Added on ${new Date(randomDua.date).toLocaleDateString()})`), {
+                padding: 1,
+                margin: 1,
+                borderStyle: 'double',
+                borderColor: 'cyan',
+                title: '✨ A Dua from your Jar',
+                titleAlignment: 'center'
+            }));
+        }
+    }
+    else if (action === 'list') {
+        if (duas.length === 0) {
+            console.log(chalk_1.default.yellow('\nYour Dua Jar is empty.'));
+        }
+        else {
+            console.log(chalk_1.default.cyan('\n📜 Your Saved Duas:'));
+            duas.forEach((d, i) => {
+                console.log(chalk_1.default.white(`${i + 1}. ${d.text}`));
+            });
+        }
+    }
+}
+function loadDuas() {
+    if (fs_1.default.existsSync(DUA_FILE)) {
+        try {
+            return JSON.parse(fs_1.default.readFileSync(DUA_FILE, 'utf-8'));
+        }
+        catch (e) {
+            return [];
+        }
+    }
+    return [];
+}
+function saveDuas(duas) {
+    const dir = path_1.default.dirname(DUA_FILE);
+    if (!fs_1.default.existsSync(dir)) {
+        fs_1.default.mkdirSync(dir, { recursive: true });
+    }
+    fs_1.default.writeFileSync(DUA_FILE, JSON.stringify(duas, null, 2));
+}