Skip to content

Latest commit

 

History

History
570 lines (459 loc) · 32.9 KB

CHANGELOG.md

File metadata and controls

570 lines (459 loc) · 32.9 KB

Change Log

All notable changes to the "codetune" extension will be documented in this file.

[1.1.0] - 2026-03-04

Smart Focus Mode

  • Coding-Aware Notifications: Extension now monitors typing activity and automatically pauses Islamic reminders while you are actively coding — no more mid-keystroke popups
  • Auto-Resume: Deferred notifications are delivered shortly after you stop typing (configurable threshold)
  • Quiet Hours: Fully silent mode during configurable night hours (default 10 PM – 7 AM)
  • Memory-Safe: All setInterval / event listener references properly disposed on extension deactivation

Spiritual Progress Dashboard (New UI Component)

  • Daily Goals: Visual progress bars for Quran listening minutes and Dhikr count — logged via custom modal (no blocked prompt())
  • Streak Tracker: Consecutive-day streak with midnight-safe date comparison (toDateString())
  • Achievements System: Unlockable badges — "First Step" (day 1), "One Week Warrior" (7 days), "Month Master" (30 days), "Legend" (90 days)
  • Weekly Summary: 7-day activity heatmap rendered fully in the webview
  • All-Time Stats: Total Quran minutes, Dhikr count, and personal best streak
  • Motivational Messages: Dynamic messages that change based on streak length and recent activity
  • Bridge Fixed: Dashboard now communicates with SpiritualTracker (Extension Host) via postMessage → activityBarView.ts → response → updateFromPayload()

Error Recovery UI (New UI Component)

  • Offline Screen: Dedicated "You're Offline" panel that appears when navigator.onLine is false
  • Pending Retry Queue: Failed operations queued and retried automatically on reconnect
  • Error History: Recent errors displayed with type badges (network / timeout / auth / unknown)
  • Clear History: Confirmation-dialog-backed clear button using VS Code native dialog via postMessage
  • Fixed: Removed duplicate acquireVsCodeApi() call (can only be called once per webview — now uses window.vscode set by activityBar.js)

Backend Reliability

  • RetryManager: Exponential backoff (base 1s → max 30s) with ±10% jitter to avoid thundering herd; configurable max retries; AbortController for timeout safety
  • ErrorReporter: Categorizes errors (network / timeout / auth / unknown); translates raw errors to user-friendly messages; keeps capped history (max 50); logs via structured Logger
  • SpiritualTracker: Local globalState persistence for Quran minutes, Dhikr count, streak, and daily entries; midnight-safe streak calculation
  • TrackerInsights: Achievement engine, weekly stats aggregator, motivational message generator — all pure logic, fully unit-tested

Security & Code Quality

  • XSS Protection: All dynamic HTML in trackerDashboard.js and errorRecovery.js passes through sanitizeText() — escapes & < > " '
  • No Inline Event Handlers: All onclick="" replaced with addEventListener for CSP compliance
  • URI Registration Fixed: errorRecovery.js added to activityBarView.ts URI replacement chain (was missing — VS Code would block the script)
  • HTML Mount Points: Added #tracker-dashboard-mount and #error-recovery-mount containers to activityBar.html
  • Script Tags Added: trackerDashboard.js and errorRecovery.js now properly loaded with CSP nonce in activityBar.html

Testing

  • 28 Unit Tests Added: Full coverage of RetryManager, ErrorReporter, SpiritualTracker, TrackerInsights, SmartNotifications, FridayReminders, XSS sanitization, WebView message routing, and network detection logic
  • TypeScript: tsc --noEmit → 0 errors
  • ESLint: 0 warnings, 0 errors

[1.0.0] - 2026-01-17

MAJOR RELEASE: CodeTune 1.0.0 - Production Ready Islamic Development Environment

CodeTune is now stable and production-ready! This major version bump represents the culmination of extensive development, testing, and refinement.

Complete Architecture Overhaul

  • Stable 1.0.0 Release: Extension is now production-ready with comprehensive testing and documentation
  • Professional Logging System: Implemented structured logging with debug/production modes
  • Clean Codebase: Removed all console spam and implemented proper error handling
  • TypeScript Excellence: Full TypeScript implementation with proper type safety

Complete Internationalization (5 Languages)

  • Arabic (العربية): Full native Arabic support with proper RTL layout
  • Russian (Русский): Complete Russian localization
  • French (Français): Full French translations
  • Spanish (Español): Comprehensive Spanish support
  • English: Enhanced English localization with improved terminology

Hijri Date Accuracy & Islamic Calendar

  • Umm al-Qura Calendar: Replaced approximation with official Saudi Islamic calendar
  • 2-Day Offset Fix: Corrected Hijri date display (was showing '1 Sha'ban' instead of '28 Rajab')
  • Extension-Host Calculations: Moved Islamic calculations to VS Code backend for accuracy
  • Accurate Prayer Times: Enhanced Adhan library integration with Egyptian calculation method

Critical Bug Fixes & UI Improvements

  • Statistics Icon Toggle: Fixed statistics mode switching (Quran Listening ↔ Quran Time)
  • Sandboxing Fixes: Replaced browser confirm() dialogs with VS Code native dialogs
  • Localization Timing: Fixed race condition in localization data loading
  • Webview Communication: Enhanced message passing between webview and extension
  • Event Listener Management: Proper cleanup and re-attachment of dynamic listeners

Professional Features & Enhancements

  • Smart Prayer Notifications: Context-aware prayer time reminders
  • Friday Surah Intelligence: Auto-show Friday Surah section only when relevant
  • Daily Prayer Goals Reset: Automatic daily reset for prayer tracking
  • Enhanced Statistics: Comprehensive Quran listening analytics
  • Performance Monitoring: Built-in performance tracking and optimization

Quality Assurance & Stability

  • Zero Console Spam: Clean production logging with debug mode available
  • Error Resilience: Comprehensive error handling throughout the application
  • Data Persistence: Robust localStorage with corruption prevention
  • Cross-Platform: Tested and working on Windows, macOS, and Linux

UI/UX Polish & Accessibility

  • Glassmorphism Design: Beautiful modern interface with smooth animations
  • Responsive Layout: Mobile-friendly design that adapts to screen sizes
  • Accessibility: Full keyboard navigation and screen reader support
  • Dark/Light Themes: Perfect theme integration with VS Code

Package Configuration Perfection

  • Proper Activation Events: Automatic activation (no explicit events needed)
  • Version 1.0.0: Official stable release designation
  • Complete Dependencies: All required packages properly specified
  • Marketplace Ready: Fully compliant with VS Code Marketplace requirements

Spiritual & Developer Impact

  • Islamic Community: Provides authentic Islamic tools for Muslim developers worldwide
  • Developer Productivity: Helps maintain spiritual balance during coding sessions
  • Cultural Integration: Appropriate Islamic accommodations in development environments
  • Global Accessibility: Works in all timezones with automatic localization

Enterprise-Grade Architecture

  • Modular Components: Clean separation of concerns with reusable components
  • Message Passing: Robust webview-extension communication architecture
  • State Management: Professional state handling with persistence
  • Error Boundaries: Graceful error handling and recovery

Comprehensive Documentation

  • Complete Changelog: Detailed change history for all versions
  • Professional README: Comprehensive installation and usage guide
  • Configuration Guide: Detailed settings documentation
  • Troubleshooting: Complete problem-solving guide

Community & Open Source

  • MIT License: Permissive open source license
  • GitHub Integration: Proper repository structure and documentation
  • Contributing Guidelines: Clear contribution process for community
  • Issue Tracking: Proper bug reporting and feature request system

[0.0.7] - 2025-12-20

MAJOR BREAKTHROUGH: Serverless Islamic App Architecture

Complete Server Removal & Self-Contained Operation

  • Eliminated External Server Dependency: Removed all localhost:3000 API calls and server requirements
  • Extension-Only Architecture: All Islamic calculations now run locally within VS Code extension
  • Offline Functionality: Full prayer times, location detection, and Islamic features work without internet
  • Zero External Dependencies: No more CORS issues, network failures, or server maintenance

Advanced Prayer Time Calculation Engine

  • Adhan Library Integration: Implemented professional Islamic prayer calculation using Adhan npm package
  • Egyptian Calculation Method: Uses authentic Egyptian prayer time calculation methodology
  • Real-time Location Processing: Automatic prayer times based on detected user location
  • Precise Astronomical Calculations: Accurate sunrise/sunset and prayer time computations

** Intelligent IP-Based Location Detection System**

  • Automatic User Location: Detects user location via IP geolocation (ip-api.com) without user permission
  • Seamless Location Updates: Location detected automatically on first use with persistent storage
  • Global Coverage: Works worldwide with automatic timezone and coordinate detection
  • Privacy-Conscious Design: Uses public IP data only, no GPS or hardware access required

** Revolutionary Message-Passing Architecture**

  • Extension-Host Calculations: Moved all Islamic computations to VS Code extension backend
  • Webview-Extension Communication: Robust message passing between UI and calculation engine
  • Asynchronous Processing: Non-blocking prayer calculations with proper error handling
  • Cross-Platform Compatibility: Works identically on Windows, macOS, and Linux

Console Optimization & Developer Experience

  • Clean Console Output: Eliminated "Unknown message type" errors in developer console

  • Proper Message Routing: Prayer tracker messages handled by appropriate components

  • Debug-Friendly Logging: Comprehensive logging for location and prayer time operations

  • Error Resilience: Graceful error handling for all network and calculation operations

    User Experience Improvements

  • Instant Prayer Times: Prayer times calculated immediately without API calls

  • Automatic Location Setup: No manual city selection required - works out of the box

  • Reliable Offline Operation: All features work without internet connectivity

  • Global Islamic Community Support: Accurate prayer times for Muslims worldwide

Quality Assurance & Stability

  • Comprehensive Testing: All location detection and prayer calculation scenarios tested
  • Error Boundary Implementation: Robust error handling for edge cases and network failures
  • Data Persistence: Location and prayer preferences maintained across VS Code sessions
  • Backward Compatibility: Existing user data and settings preserved during upgrade

Spiritual & Cultural Impact

  • Accessible Islamic Tools: Makes Islamic practices more accessible to global Muslim developers
  • Technology-Enabled Worship: Leverages modern development tools for spiritual enhancement
  • Cultural Workplace Integration: Appropriate spiritual accommodations in coding environments
  • Community Standards Compliance: Follows Islamic calculation methodologies and practices

Enhanced Islamic Interface Organization

  • Islamic Information Card: Purely informational (Hijri date, prayer times)
  • Islamic Dhikr & Counters Card: Dedicated spiritual practice hub
  • Logical Content Separation: Information and practice components properly distinguished

Technical Implementation

  • State Management Architecture: Modular Counter System with robust localStorage integration
  • User Experience Engineering: Instant visual feedback with smooth animations and accessibility features
  • Cultural & Linguistic Excellence: Authentic Arabic phrases with proper Islamic terminology
  • Performance Optimization: Efficient DOM updates with minimal layout reflow

Spiritual User Benefits

  • Personal Islamic Practice Tracker: Comprehensive dhikr hub for spiritual habits
  • Integration with Developer Workflow: Islamic remembrance in coding environment
  • Work-Life Balance: Healthy integration of spiritual practices in professional environment

Data Integrity & Privacy

  • Local Storage Architecture: All spiritual data stored exclusively on local machine
  • Privacy by Design: Zero external data transmission or cloud synchronization

Islamic Community Impact

  • Modern Islamic Applications: Contemporary tools for traditional Islamic practices
  • Technology-Enabled Worship: Digital capabilities for spiritual enhancement
  • Community Accessibility: Makes Islamic practices more accessible through modern interfaces

UI/UX Enhancements

  • Custom Islamic Icon: SVG icon with coding brackets and Islamic crescent moon design
  • What's New Modal: Dynamic modal showing recent updates and coming features
  • Simplified Settings: Removed Advanced Settings section for cleaner user experience

[0.0.6] - 2025-10-31

Critical Bug Fixes & System Stability

Quran Player Critical Fixes

  • Modal Control System Overhaul: Fixed Quran reader modal controls not working by implementing proper event listeners
  • Surah Selection Bug: Resolved issue where wrong surah number was being sent to playback system
  • Playback Options Modal: Fixed showPlaybackOptionsModal to properly store selected surah before playback
  • Ayah Progression Logic: Corrected playNextAyah method call and logic for smooth ayah-by-ayah playback
  • Full Surah Playback: Changed default reciter from ar.alafasy to ar.abdulbasitmurattal for complete surah support
  • Modal Event Listeners: Moved modal close event listeners from settings.js to audioPlayer.js for proper functionality

Auto-Reading System Enhancements

  • Adaptive Speed Detection: Implemented intelligent auto-reading speed detection system
  • Specific Speed Intervals: Added precise auto-reading speeds (slow=8s, normal=4s, fast=2s, very fast=1s, default=4x)
  • Button State Management: Fixed auto-reading button disabled state and added comprehensive debug logging
  • JavaScript Error Resolution: Fixed 'updateAutoPlaySetting is not defined' error in inline event handlers

Internationalization & Localization

  • Russian Language Support: Complete Russian translations for VS Code extension strings and UI components
  • French Language Support: Full French translations for extension commands and webview interface
  • Spanish Language Support: Comprehensive Spanish translations for all user-facing strings
  • Secure Localization Loading: Implemented backend-to-webview secure data transfer for translation files
  • Language Detection Logic: Enhanced language detection for Russian, French, and Spanish locales
  • Undefined Parameter Handling: Added proper validation and fallback for undefined language parameters

Development Environment Improvements

  • Enhanced Launch Configurations: Created comprehensive launch.json for advanced debugging scenarios
  • Build Task Automation: Implemented enhanced tasks.json with build, test, and server management tasks
  • Server Configuration Cleanup: Removed YouTube/Spotify references from server configuration
  • Component Architecture Fixes: Resolved infinite recursion bug between activityBar and settings components
  • HTML Structure Corrections: Added missing surahModalContent element in activityBar.html
  • Command Registration: Properly registered codeTune.openSettings command in package.json

Technical Architecture Refinements

  • Error Handling & Logging: Added comprehensive console logging throughout audio playback flow
  • Message Passing Architecture: Implemented handleMessage method in AudioPlayerComponent for extension communication
  • Modal Testing Framework: Verified both Quran Reader and Quran Listening modal opening/closing functionality
  • Codebase Analysis: Complete analysis of Quran player implementation for architectural improvements

Quality Assurance & Testing

  • Modal Functionality Testing: Comprehensive testing of both modal opening and closing operations
  • Playback Mode Verification: Tested both full-surah and ayah-by-ayah playback modes through VS Code debugging
  • Cross-Component Integration: Validated proper communication between all UI components
  • Error Resilience: Enhanced system stability with better error handling and validation

[0.0.5] - 2025-10-06

MAJOR ENHANCEMENT: Interactive Prayer Time System + Islamic Goals Tracker

Smart Prayer Time Notifications

  • Automated Prayer Alerts: Real-time notifications when prayer time arrives
  • Interactive Confirmation Modals: Beautiful modal dialogs asking "Did you pray [PrayerName]?"
  • Bilingual Notification System: Full English/Arabic support for all prayer notifications
  • Automatic Goal Completion: User confirmation automatically marks prayers as completed in Islamic Goals

Prayer Confirmation Modal Features

  • "Yes, I prayed" Button: Automatically checks off the corresponding prayer in goals tracker
  • "Not yet" Button: Dismisses notification without marking as completed
  • Prayer Time Integration: Linked directly to existing prayer countdown system
  • Responsive Modal Design: Beautiful glassmorphism design matching app theme

Islamic Goals Tracker

  • Daily Prayer Completion: Visual checkboxes for all 5 daily prayers (Fajr, Dhuhr, Asr, Maghrib, Isha)
  • Live Progress Indicator: Real-time completion percentage display (0/5 completed)
  • Persistent Goal Storage: Prayer completion status survives VS Code restarts
  • Visual Goal Management: Easy-to-use checkbox interface with completed state styling

Progress Calculation System

  • Dynamic Percentage Display: "{completed}/5 ({percentage}%)" format with live updates
  • Automatic Achievement Tracking: Goals update instantly when prayers are confirmed
  • Completion State Management: Visual indicators for completed vs. incomplete prayers
  • Cross-Session Continuity: Goal progress maintained across VS Code sessions

Major Feature: Islamic Dhikr & Counters System

Enhanced Istighfar Counter Suite

  • Two Essential Istighfar Phrases: Seeking forgiveness through repentance
  • أَسْتَغْفِرُ اللَّهَ (Astaghfirullah - I seek Allah's forgiveness)
  • سُبْحَانَكَ اللَّهُمَّ وَبِحَمْدِكَ (Subhanakallahumma - Glory be to You O Allah and praise)

Popular Adhkar Collections

  • Four Essential Adhkar Phrases: Daily Islamic remembrance phrases
  • أَعُوذُ بِاللَّهِ مِنَ الشَّيْطَانِ الرَّجِيمِ (I seek refuge in Allah from Satan)
  • رَبِّ اغْفِرْ لِي وَلِوَالِدَيَّ (My Lord, forgive me and my parents)
  • حَسْبِيَ اللَّهُ وَنِعْمَ الْوَكِيلُ (Allah is sufficient and the best Disposer)
  • لَا حَوْلَ وَلَا قُوَّةَ إِلَّا بِاللَّهِ (No power nor strength except with Allah)

Complete Tasbih Counter Suite

  • Traditional Arabic Dhikr Phrases: Four essential Islamic remembrance phrases
  • سُبْحَانَ اللَّهِ (Subhanallah - Glory be to Allah) - Glory and magnificence recital
  • الْحَمْدُ لِلَّهِ (Alhamdulillah - Praise be to Allah) - Gratitude expression
  • لَا إِلَهَ إِلَّا اللَّهُ (La ilaha illallah - No god but Allah) - Testament of faith
  • اللَّهُ أَكْبَرُ (Allahu Akbar - Allah is the Greatest) - Supreme greatness affirmation

Enhanced Salawat Counter

  • Relocated from Islamic Information to Counter Suite: Moved to Islamic Dhikr & Counters card for logical grouping
  • Intelligent Daily Targets: Context-aware goal setting (11 regular, 24 Fridays, 100 Ramadan)
  • Interactive Increment System: One-click blessing counting with immediate visual feedback
  • Automatic Special Day Detection: Friday and Ramadan automatic target adjustments

Interactive Counter Interface

  • Individual Increment Buttons: Dedicated "+" buttons for each dhikr phrase
  • Real-time Count Updates: Live counter displays with persistent storage
  • Visual Feedback: Smooth animations and hover effects for all counter buttons
  • Cross-Session Persistence: Counts survive VS Code restarts and system updates

Comprehensive Reset Management

  • Individual Counter Reset: Each tasbih counter maintains independent counting sessions
  • Bulk Reset Functionality: "Reset All" button clears all counters with confirmation dialog
  • Safe Reset Process: User consent required to prevent accidental data loss

Beautiful Dhikr Interface Design

  • Purple Gradient Theme: Distinctive 🧿 icon and purple-pink gradient header
  • Organized Section Layout: Clean separation between different dhikr categories
  • Arabic Typography: Professional Arabic text rendering with proper directional support
  • Responsive Grid System: Adapts beautifully to different screen sizes and layouts

Spiritual Practice Protection

  • Data Persistence: All counter values saved securely with localStorage
  • State Recovery: Counts automatically restored when reopening VS Code
  • Error Resilience: Counter system continues working even if individual operations fail
  • Privacy Focused: All spiritual data stored locally, never transmitted

Enhanced Islamic Interface Organization

  • Islamic Information Card: Purely informational (Hijri date, prayer times)
  • Islamic Dhikr & Counters Card: Dedicated spiritual practice hub
  • Logical Content Separation: Information and practice components properly distinguished

Technical Implementation

State Management Architecture

  • Modular Counter System: Separate methods for salawat and tasbih counter management
  • Event-Driven Updates: Real-time UI updates triggered by counter increment actions
  • Persistent Data Layer: Robust localStorage integration with error handling
  • Clean Code Organization: Well-structured JavaScript classes with clear separation of concerns

User Experience Engineering

  • Instant Visual Feedback: Immediate counter updates with smooth animations
  • Accessibility Features: Keyboard accessible buttons with proper focus management
  • Cross-Platform Compatibility: Works seamlessly on Windows, macOS, and Linux
  • Performance Optimized: Efficient DOM updates with minimal layout reflow

Cultural & Linguistic Excellence

  • Authentic Arabic Phrases: Correctly written Islamic terms with proper diacritics
  • Contextual Help: Tooltip explanations for each Arabic phrase in English
  • Islamic Tradition Compliance: Following established Islamic dhikr practices
  • Multilingual Friendly: Prepared for future Arabic localization expansion

Spiritual User Benefits

Personal Islamic Practice Tracker

  • Comprehensive Dhikr Hub: All major Islamic remembrance activities in one convenient location
  • Motivational Counting: Visual progress encouragement for spiritual habits
  • Flexible Usage: Counts as many times as desired without artificial limitations
  • Islamic Goal Setting: Encourage frequent recitation through daily target system

Integration with Developer Workflow

  • Code Meditation Sessions: Islamic remembrance integrated into coding environment
  • Productivity Enhancement: Spiritual breaks enhance focus and mental clarity
  • Cultural Workplace Support: Appropriate spiritual accommodation for Muslim developers
  • Work-Life Balance: Healthy integration of spiritual practices into professional environment

Data Integrity & Privacy

Local Storage Architecture

  • Secure Local Persistence: All spiritual data stored exclusively on local machine
  • Automatic Backup: Counter values automatically preserved across sessions
  • Corruption Prevention: Validation layers prevent data loss and corruption
  • Privacy by Design: Zero external data transmission or cloud synchronization

Islamic Community Impact

Digital Islamic Tools Ecosystem

  • Modern Islamic Applications: Contemporary tools for traditional Islamic practices
  • Technology-Enabled Worship: Leverage digital capabilities for spiritual enhancement
  • Community Accessibility: Make Islamic practices more accessible through modern interfaces
  • Educational Value: Help Muslims learn and practice traditional Islamic remembrances

[0.0.4] - 2025-10-01

Major Feature: Intelligent Auto-Reading Quran Reader

Auto-Reading System

  • Smart Page Auto-Turning: Automatically advances to next page when scrolling reaches the bottom
  • Versatile Speed Controls: Four reading speeds (🐢 Slow 0.5x, 🚶 Normal 1x, 🏃 Fast 1.5x, 🐇 Very Fast 2x)
  • Automatic Surah Progression: Automatically advances to next Surah after completing current one
  • User Consent Protection: Prompts for user confirmation before advancing to different Surahs

Interactive Controls

  • Auto-Reading Toggle: Master switch to enable/disable entire auto-reading functionality
  • Play/Pause Controls: Start, pause, and resume auto-scrolling at any time
  • Speed Selection Buttons: Visual speed selector with active state highlighting
  • Responsive UI: Auto-reading controls adapt to mobile/tablet layouts

User Experience Features

  • "Auto Reading Active" Indicator: Real-time status showing in Quran reader modal
  • Smooth Auto-Scrolling: Continuous, gentle scrolling through verses without jarring jumps
  • Keyboard Integration: Spacebar toggles play/pause when reader modal is open
  • Progress Saving: Automatically saves reading progress at every page transition

Safety & Control Features

  • Manual Override: Users can manually navigate pages while auto-reading is active
  • End-of-Content Protection: Handles end of Quran gracefully with celebratory messages
  • Non-Blocking Operation: Auto-reading operates independently of other UI functions
  • Graceful Error Handling: Continues working even if individual operations fail

Enhanced Quran Reader

  • Keyboard Navigation: Full keyboard control (arrows, Home, End, Page Up/Down)
  • Manual Controls: Traditional navigation buttons for manual page turning
  • Reading Statistics: Tracks reading sessions, pages read, and time spent
  • Cross-Session Continuity: Remembers where you left off reading

Visual Enhancements

Auto-Reading UI Components

  • Animated Toggle Button: Spinning icon when auto-reading mode is enabled
  • Speed Button States: Active speed buttons glow with accent colors
  • Modal Status Indication: Visual indicators show current auto-reading status
  • Responsive Controls: Auto-reading controls stack appropriately on small screens

Quran Reader Improvements

  • Enhanced Verse Display: Better Arabic typography with Quranic calligraphy fonts
  • Improved Navigation: Clear page counters and intuitive navigation controls
  • Reading Progress: Visual progress indication and bookmarking system
  • Touch-Friendly Design: Large buttons and appropriate spacing for mobile use

Technical Architecture

Auto-Reading Algorithm

  • Smart Interval Management: Calculates optimal scroll intervals based on user speed preferences
  • Page Boundary Detection: Accurate detection of page scroll boundaries with safety buffers
  • Event-Driven Architecture: Graceful handling of page changes and loading delays
  • Performance Optimized: Efficient DOM manipulation with minimal UI blocking

State Management

  • Persistent Auto-Reading Settings: Remembers speed preferences and enabled state
  • Cross-Session Continuity: Maintains reading position across VS Code sessions
  • Error Resilience: Continues operation even when individual components fail
  • Clean State Transitions: Proper cleanup when switching between reading modes

User Experience Refinements

Inclusive Design Considerations

  • Accessibility Features: Full keyboard navigation and screen reader friendly
  • User Consent Patterns: Clear dialogs for major transitions with informative messaging
  • Progressive Enhancement: Works with or without advanced features enabled
  • Error Prevention: Validation and safety checks prevent accidental disruption

Cultural Sensitivity

  • Respectful Content Handling: Appropriate confirmations for transitioning between sacred texts
  • Islamic Context Awareness: designed with Islamic recitation practices in mind
  • Community Standards: Aligns with digital Quran presentation best practices

[0.0.3] - 2025-09-28

Major Feature: Internal Audio Playback

  • Replaced External Browser Playback: Quran audio now plays directly within VS Code instead of opening external browser tabs
  • HTML5 Audio Integration: Added native <audio> element to webview with full playback controls
  • Real-time Progress Tracking: Live progress bar, time display, and seeking functionality
  • Audio Event Handling: Proper play/pause/ended event management with UI updates

Comprehensive Settings Interface

  • Integrated Settings: Moved settings from separate webview to within the activity bar
  • Back Button Navigation: Seamless navigation between main player and settings views
  • Organized Sections: Five distinct settings categories with clear visual separation

Audio Settings

  • Quran Reciter selection (Mishary Rashid Alafasy, Abdul Rahman Al-Sudais, Saad Al-Ghamidi, Maher Al-Mueaqly)
  • Audio Quality options (32kbps, 48kbps, 64kbps, 128kbps, 192kbps)

Playback Settings

  • Default Playback Mode (Full Surah / Ayah by Ayah)
  • Auto-play on Startup toggle

Appearance Settings

  • Theme selection (Auto, Light Theme, Dark Theme) with immediate switching
  • Compact Mode toggle
  • Show Notifications toggle
  • Language selection (Auto Detect, English, العربية) with immediate UI updates

Islamic Reminders

  • Enable/Disable reminders toggle
  • Reminder Interval selection (5min, 15min, 30min, 1hr, 2hr, 4hr)
  • Reminder Types filtering (Adia, Ahadis, Islamic Wisdom)
  • Working Hours Only restriction (9 AM - 6 PM)
  • Individual Prayer reminders (Fajr, Dhuhr, Asr, Maghrib, Isha)

Advanced Settings

  • Cache Size configuration (50MB, 100MB, 200MB, 500MB)
  • Download Timeout settings (10s, 30s, 60s, 120s)
  • Retry Attempts configuration (1, 2, 3, 5 attempts)

Fixed Critical Issues

  • Islamic Reminders Integration: Fixed message passing between webview and extension for real-time reminder control
  • Settings Persistence: Proper localStorage integration with VSCode configuration sync
  • Language Switching: Immediate UI language updates without VS Code restart
  • Theme Switching: Instant theme changes with proper CSS class management
  • Webview-Extension Communication: Robust message handling for all settings operations

UI/UX Enhancements

  • Settings View Styling: Beautiful glassmorphism design matching the main interface
  • Responsive Layout: Mobile-friendly settings interface
  • Visual Feedback: Success notifications for all setting changes
  • Save/Reset Functionality: Manual save and reset to defaults options
  • Loading States: Proper loading indicators and error handling

Technical Improvements

  • Message Passing Architecture: Enhanced webview-to-extension communication
  • Settings Management: Centralized settings handling with proper validation
  • Audio System: Complete audio playback system with event-driven UI updates
  • Localization System: Improved language switching with global state management
  • Error Handling: Comprehensive error handling for all audio and settings operations

Content & Features

  • Islamic Content Database: Expanded collection of Adia, Ahadis, and Islamic wisdom
  • Prayer Time Integration: Real-time prayer countdown with Islamic calendar
  • Hijri Date Display: Accurate Islamic calendar date showing
  • Multi-language Support: Full Arabic and English localization

[0.0.2] - 2025-09-27

Added

  • Dedicated Settings Webview: Complete settings interface with organized sections for audio, playback, appearance, and advanced options
  • Settings Command: New codeTune.openSettings command to open the settings panel
  • Theme Toggle Notifications: Theme changes now show VS Code notifications instead of in-webview notifications
  • Separate File Architecture: Refactored from hardcoded HTML to separate HTML, CSS, and JS files for better maintainability
  • Modern UI Components: Enhanced activity bar with glassmorphism effects, smooth animations, and responsive design
  • Keyboard Shortcuts: Added keyboard navigation support (spacebar, arrow keys, etc.)
  • Settings Persistence: Auto-save functionality with localStorage integration
  • Professional Styling: Modern CSS with custom properties, gradients, and hover effects

Changed

  • Architecture Refactor: Moved from monolithic HTML to modular file structure
  • UI Improvements: Enhanced visual design with better spacing, colors, and interactions
  • Notification System: Theme changes now use VS Code's native notification system
  • Code Organization: Better separation of concerns between UI components

Fixed

  • Duplicate Function Implementation: Resolved TypeScript compilation error with duplicate _getHtmlForWebview methods
  • Webview Panel Removal: Removed unused PlayerWebviewPanel and QuranWebviewPanel classes
  • Command Registration: Cleaned up package.json commands and removed unused entries
  • Settings Button Functionality: Fixed settings button to properly open the dedicated settings webview

Technical Improvements

  • File Structure: Organized UI files in src/ui/ directory
  • Type Safety: Improved TypeScript types and error handling
  • Build Process: Optimized compilation and packaging process
  • Code Quality: Enhanced ESLint configuration and code standards

[0.0.1] - 2025-09-26

Added

  • Initial release of CodeTune extension
  • Basic Quran player functionality
  • Activity bar integration
  • Basic command palette integration