@ihsandeen/aya 1.0.0

package/src/commands/parable.ts

@@ -0,0 +1,360 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { printCommandHeader } from '../utils/printer';
+
+interface Parable {
+  name: string;
+  surah: string;
+  ayah: string;
+  title: string;
+  animate: () => Promise<void>;
+}
+
+const sleep = (ms: number) => new Promise(r => setTimeout(r, ms));
+
+const spiderParable: Parable = {
+  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.gray(frame));
+      await sleep(800);
+    }
+
+    await sleep(500);
+    console.log(chalk.white.italic('\n"The example of those who take allies other than Allah..."'));
+    await sleep(2500);
+    console.log(chalk.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.gray(frame));
+      await sleep(400); // Slower crumble to be visible
+    }
+
+    console.clear();
+    console.log(chalk.red.bold('\nThe web is gone.'));
+    await sleep(1000);
+    console.log(chalk.white.bold('\n"And indeed, the weakest of houses is the house of the spider." (29:41)'));
+    console.log(chalk.gray('\nLesson: Reliance on anything other than Allah is like leaning on a spider web.'));
+  }
+};
+
+const rainParable: Parable = {
+  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.blue(frame));
+            await sleep(200);
+        }
+    }
+    
+    // Final growth
+    console.clear();
+    console.log(chalk.green(rainFrames[3]));
+    
+    await sleep(1000);
+    console.log(chalk.green.bold('\nLife springs forth.'));
+    console.log(chalk.white.italic('\n"And Allah sees what you do. Sincerity makes even small deeds grow like a garden after rain."'));
+  }
+};
+
+const lightParable: Parable = {
+  name: 'light',
+  surah: 'An-Nur',
+  ayah: '24:35',
+  title: 'Light upon Light',
+  animate: async () => {
+    const lampFrames = [
+      `
+      ✨
+     🕯️
+    💡
+   🌟
+    `,
+    `
+     ✨
+    🕯️
+     💡
+    🌟
+    `,
+    `
+      ✨
+     🕯️
+    💡
+   🌟
+    `,
+    `
+    ✨
+     🕯️
+      💡
+       🌟
+    `
+    ];
+
+    console.log(chalk.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.yellow : chalk.yellowBright;
+        console.log(color.bold(frame));
+        await sleep(200);
+    }
+    
+    console.log(chalk.white.italic('\n"Light upon light. Allah guides to His light whom He wills."'));
+  }
+};
+
+const ropeParable: Parable = {
+  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.blue(frame));
+      await sleep(800);
+    }
+
+    await sleep(500);
+    console.log(chalk.yellow('\nImagine if everyone let go... 💔'));
+    await sleep(2000);
+    console.log(chalk.green('\nBut if we hold tight... 🤝'));
+    await sleep(1000);
+
+    console.log(chalk.white.italic('\n"And hold firmly to the rope of Allah all together and do not become divided." (3:103)'));
+    console.log(chalk.gray('\nTadabbur: The "Rope" is the Quran/Covenant. Holding it *together* is our only safety from the pit of fire.'));
+  }
+};
+
+const treeParable: Parable = {
+    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.green(frame));
+            await sleep(800);
+        }
+        console.log(chalk.white.italic('\n"A good word is like a good tree, its root is firm and its branches are in the sky."'));
+    }
+}
+
+
+const parables: Parable[] = [spiderParable, rainParable, lightParable, ropeParable, treeParable];
+
+export const parableCommand = new Command('parable')
+  .description('Visual Quranic Metaphors (Animated)')
+  .argument('[name]', 'Name of the parable (e.g., spider, rain, light)')
+  .action(async (name) => {
+    printCommandHeader('parable');
+    let selectedParable;
+
+    if (name) {
+      selectedParable = parables.find(p => p.name.toLowerCase() === name.toLowerCase());
+      if (!selectedParable) {
+        console.log(chalk.red('Parable not found.'));
+        return;
+      }
+    } else {
+      const answers = await inquirer.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.green.bold(`\n${selectedParable.title}`));
+      console.log(chalk.gray(`Surah ${selectedParable.surah} (${selectedParable.ayah})`));
+      await sleep(1500);
+      await selectedParable.animate();
+    }
+  });

package/src/commands/prayers.ts

@@ -0,0 +1,65 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import axios from 'axios';
+import ora from 'ora';
+import inquirer from 'inquirer';
+import { getConfig, setConfig } from '../utils/config';
+import { printCommandHeader } from '../utils/printer';
+
+export const prayersCommand = new Command('prayers')
+  .description('Show Prayer Times')
+  .option('-c, --config', 'Configure location')
+  .action(async (options) => {
+    printCommandHeader('prayers');
+    let config = getConfig();
+    
+    if (options.config || !config.location?.city || !config.location?.country) {
+       const answers = await inquirer.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 };
+      setConfig(config);
+    }
+
+    const { city, country } = config.location;
+    const spinner = ora(`Fetching prayer times for ${city}, ${country}...`).start();
+
+    try {
+      const response = await axios.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.green.bold(`\n  Prayer Times for ${city}, ${country}`));
+      console.log(chalk.gray(`  ${date} | ${hijri.day} ${hijri.month.en} ${hijri.year}`));
+      console.log(chalk.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.bold(p.name.padEnd(10))} ${chalk.cyan(p.time)}`);
+      });
+      console.log('');
+
+    } catch (error) {
+      spinner.fail('Failed to fetch prayer times.');
+      console.error(chalk.red('Please check your internet connection or location settings.'));
+    }
+  });

package/src/commands/pull.ts

@@ -0,0 +1,28 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { gems } from '../data/gems';
+import { printCommandHeader } from '../utils/printer';
+
+export const pullCommand = new Command('pull')
+  .description('Pull a random ayah or hadith for reflection')
+  .action(async () => {
+    printCommandHeader('pull');
+    const spinner = ora('Fetching divine wisdom...').start();
+    
+    // Simulate a small delay for effect
+    await new Promise(resolve => setTimeout(resolve, 800));
+    
+    const randomGem = gems[Math.floor(Math.random() * gems.length)];
+    
+    spinner.succeed(chalk.green('Reflection loaded.'));
+    console.log('');
+    
+    console.log(chalk.yellow.bold(`"${randomGem.text}"`));
+    console.log(chalk.gray(`— ${randomGem.source}`));
+    console.log('');
+    
+    console.log(chalk.blue.bold('Language Gem:'));
+    console.log(chalk.white(randomGem.reflection));
+    console.log('');
+  });

package/src/commands/push.ts

@@ -0,0 +1,171 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import fs from 'fs';
+import path from 'path';
+import { printCommandHeader } from '../utils/printer';
+import boxen from 'boxen';
+
+// Store Duas in the local project scope (like Pull Requests)
+const DUA_FILE = path.join(process.cwd(), '.aya', 'duas.json');
+
+export const pushCommand = new Command('push')
+  .description('Push goodness to the world (Sadaqah/Du\'a) or your Dua Jar')
+  .action(async () => {
+    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.prompt([
+      {
+        type: 'list',
+        name: 'mode',
+        message: 'Select your push target:',
+        choices
+      }
+    ]);
+
+    if (mode === 'sadaqah') {
+      showDailyDeed();
+    } else {
+      await handleDuaJar();
+    }
+  });
+
+function showDailyDeed() {
+  console.log(chalk.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(
+    boxen(
+      chalk.white(`Action item: ${chalk.bold(randomAction.text)}`) + '\n' +
+      chalk.gray(randomAction.link),
+      {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'yellow',
+        title: 'Daily Sadaqah Commit',
+        titleAlignment: 'center'
+      }
+    )
+  );
+
+  console.log(chalk.yellow('Your code is temporary. Your impact is eternal.'));
+}
+
+async function handleDuaJar() {
+  const { action } = await inquirer.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.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.green('\n✅ Dua pushed to the jar. May Allah accept it.'));
+    }
+  } else if (action === 'pull') {
+    if (duas.length === 0) {
+      console.log(chalk.yellow('\nYour Dua Jar is empty. Add some duas first!'));
+    } else {
+      const randomDua = duas[Math.floor(Math.random() * duas.length)];
+      
+      console.log(
+        boxen(
+          chalk.white.bold(`"${randomDua.text}"`) + '\n\n' +
+          chalk.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.yellow('\nYour Dua Jar is empty.'));
+    } else {
+      console.log(chalk.cyan('\n📜 Your Saved Duas:'));
+      duas.forEach((d, i) => {
+        console.log(chalk.white(`${i + 1}. ${d.text}`));
+      });
+    }
+  }
+}
+
+function loadDuas(): { text: string; date: string }[] {
+  if (fs.existsSync(DUA_FILE)) {
+    try {
+      return JSON.parse(fs.readFileSync(DUA_FILE, 'utf-8'));
+    } catch (e) {
+      return [];
+    }
+  }
+  return [];
+}
+
+function saveDuas(duas: { text: string; date: string }[]) {
+  const dir = path.dirname(DUA_FILE);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  fs.writeFileSync(DUA_FILE, JSON.stringify(duas, null, 2));
+}