v2.3.0

Added

• Waveform Stability (Anti-Jitter):
  • Quantized Max-Sampling: Implemented a specialized bucketing strategy that locks visual segments to integer peak boundaries, eliminating the "jiggling" artifact during high-zoom panning.
  • Sub-Pixel Interpolation: Added a hybrid rendering mode that switches to raw peak drawing at extreme zoom levels (>20x) and linear interpolation for buttery-smooth visual flow.
• Extraction Hardening:
  • Deadlock Resolution: Refactored FFmpeg integration to actively drain stderr, preventing process hangs on long-form audio files (30m+).
  • Sample Alignment Fix: Introduced a carry-over buffer for odd-byte chunks to ensure bit-perfect 16-bit PCM alignment during streaming analysis.
  • Progress Telemetry: Added real-time extraction progress updates to the system logs (e.g., Extraction progress: 50000 / 175000).
• Shortcuts & Efficiency:
  • L Key: Added a dedicated hotkey to toggle the System Log overlay.
  • Ctrl + Scroll: Documented and refined the mouse-wheel zoom interaction in the shortcuts dialog.
• UI Stability:
  • Fixed-Width Timecode: Wrapped the primary time display in a constant-width container (210px) to prevent layout shifting/jittering as milliseconds update.
  • Lexend Unification: Standardized all numerical indicators (zoom level, duration, timestamps) to use Lexend for maximum readability.

v2.2.3

[2.2.3] - 2025-12-29

Added

• In-App Log Viewer: Added a new diagnostic console accessible via a "System Logs" terminal icon.
  • Captures all application logs from startup (including FFmpeg extraction data).
  • Branded console aesthetic with Fira Code typography and crimson highlighting.
  • Persistent logs available on both the Home Page and within the Studio session.
• Smooth Audio Scrubbing: Refactored the waveform scrubber to eliminate audio jitters. The playhead now moves instantaneously with the mouse, while the actual audio seek is deferred until the drag completes.

[2.2.2] - 2025-12-29

Fixed

• Memory Stabilization: Resolved a 700MB+ RAM spike in Release mode by restoring surgical optimizations:
  • Implemented a 1MB file-size threshold (approx. 1 min of audio) to automatically switch from memory-loading to disk-streaming.
  • Refactored waveform extraction to stream raw audio in 64KB chunks, preventing large-file buffering in the Dart heap.

[2.2.1] - 2025-12-29

Added

• Premium Branding: Enhanced Home Page with high-fidelity "Book-and-Pulse" logo in a modern rounded frame.
• Visual Identity: Integrated branded icons into the Startup Screen and Windows Taskbar.
• Deployment Strategy: Switched to Inno Setup for a simplified, certificate-free Windows installation experience.

Changed

• High-Res Iconography: Upgraded the icon generation system to support 256px ultra-high-resolution output.
• UI Refinements: Adjusted logo sizing and spacing for optimal optical balance.

[2.2.0] - 2025-12-23

Added

• Session Restoration System: Added "RESUME EXISTING SESSION" functionality on the Home Page, allowing operators to pick up exactly where they left off with full state recovery (selected verse, tab index, and synchronization progress).
• Advanced Audio Safety Guard:
  • Intelligent Relinking: If an audio file has been moved on disk, the system prompts the user to relocate it by name.
  • Three-Tier Verification: Implemented a safety pipeline that checks for filename perfect matches, provides warnings for fuzzy matches, and enforces a "Hard Block" duration check if the new audio is shorter than existing synchronization timestamps.
• Studio Lifecycle Management:
  • Added "Exit to Main Menu" with a multi-choice safety dialog (Save, Discard, or Cancel).
  • Integrated native window-close interception to ensure background engines (SoLoud, FFmpeg) are terminated reliably on application exit.
• Granular Progress Visualization:
  • Added an "Overall Completion" tracker with a large progress indicator in the Verse Sidebar.
  • Implemented persistent sync-percentage displays and mini-progress bars for every verse in the navigation list.
  • Visual indicators now highlight 100% completed verses in "Success Green."

Fixed

• Metadata Robustness: Resolved an issue where project files would save with an "unknown" audio filename. The system now intelligently derives the filename from the path via the path package.
• Process Cleanup: Fixed a critical bug where background services would persist in the Task Manager after the application window was closed.
• Memory Optimization: Refactored FFmpeg extraction to be more stable and balanced the audio engine's memory footprint for long-form sessions.

[2.1.0] - 2025-12-28

Added

• Studio Save System: Full project state persistence (.json) with support for manual and automatic saving.
• Karaoke Style Preview Mode: A new tabbed interface to preview synchronization in real-time with verse-based highlighting.
• Dynamic Lock: Preview mode is protected by a 50% synchronization threshold per verse to ensure data quality.
• Tabbed UI: Professional tabbed interface for switching between "Synchronization" and "Preview" modes.
• Hotkeys: Added Ctrl+S (Save) and refined Space/Enter behavior for seamless mode switching.

Changed

• UI Refinement: Compacted the control hub and word grid to maximize screen real estate on smaller displays.
• Button Styling: Simplified "Save Session" to "Save" and standardized icon prominent colors.
• Model Efficiency: Refactored internal models to be immutable for better Riverpod performance.

Fixed

• Fixed alignment gaps in the right-side studio panel for a pixel-perfect layout.
• Corrected hover splash layering on active Crimson-themed buttons.
• Resolved "Silent Fail" typos in the export logging.

[2.0.0] - 2025-12-26

Major Production Milestone: This release transforms ChronoScript Studio into a hardened production environment, focusing on frame-accurate temporal precision and high-throughput studio workflows.

Added

• Frame-Accurate Seeking Fix:
  • Resolved a critical engine-level seeking mismatch caused by internal scaling math during variable-speed playback.
  • Implemented "Speed-Neutralization": a logic sandwich that temporarily resets play speed to 1.0x during seeks to ensure bit-perfect landing on absolute media timestamps.
  • Enforced LoadMode.memory for all audio ingestion to provide stable performance on Windows and eliminate compressed bitrate estimation jitters.
• Multi-Word Selection System:
  • Implemented industry-standard selection logic: Ctrl+Click for individual toggles and Shift+Click for range selection.
  • Refactored state management to utilize a highly efficient Set-based indexing for multi-selection.
  • Integrated a "Reset (N)" batch action, allowing operators to clear timestamps for a selected group of words in a single click.
  • Logic Lock: The "TRANSCRIBE" button now intelligently disables during multi-selection to prevent conflicting timing cues.
• Hotkey Reference & Accessibility:
  • Added a permanent keyboard icon to the status bar providing an on-demand reference for professional hotkeys (Space, Enter, P, and Arrows).
  • Standardized "Undo" and navigation shortcuts to align with professional production audio suites.

Changed

• Infrastructure Overhaul: Upgraded flutter_soloud (v3.x), window_manager (v0.5.x), and file_picker (v10.x) to their latest major versions for enhanced Windows stability.
• Design System Unification: Fully unified the "Crimson & Parchment" visual theme across all entry screens and modernized the README.md with technical architecture rationales.
• Technical Documentation: Formalized the design system logic and technical pillars in the project documentation.

v1.3.0

Added

• Custom Title Bar: Implemented a native-feel Crimson title bar with integrated window controls (Min/Max/Close) using window_manager.
• Reset Word: Added a "Reset Word" action in the control hub to clear timing data for specific words.
• Enhanced Hover Effects: Implemented system-wide interactive feedback for buttons, word cards, and sidebar items using InkWell and Material composites.

Changed

• UI Refinement: Renamed the "START" recording action to "TRANSCRIBE" for improved clarity.
• Layout Stability: Fixed width constraints for recording controls to prevent UI jitter during state transitions.
• Visual Polish: Adjusted color palettes for consistent branding across success indicators and highlights.
• Hover Logic: Refactored widget layering to ensure hover overlays are correctly painted over opaque backgrounds.
• Documentation: Updated README.md usage instructions to align with new UI labels.

v[1.2.0] - 2025-12-26 [dbc1aeb]

Added

• FFmpeg Integration: Introduced FfmpegWaveformService and PrerequisiteService to replace just_waveform. This enables high-performance peak extraction (4kHz sampling, 200-peak fixed resolution).
• Startup Workflow: Added StartupScreen to handle environment validation, FFmpeg detection, and provided user-oriented installation instructions.
• Hierarchical Navigation: Added VerseSidebar for multi-verse navigation and Verse model to support more complex document structures.
• UI Components: Implemented LiturgyControlHub and WaveformScrubber (via simple_timeline_scrubber.dart) to provide integrated playback controls.

Changed

• UI/UX Refactor: Comprehensive redesign of the interface and theme consistency.
• Performance Optimization: Enhanced WaveformPainter using RepaintBoundary and cached Paint objects to ensure smooth rendering.
• Improved Interaction: Centered and enlarged chain icons; functionalized the audio speed adjuster (0.5x - 1.5x).
• Code Maintenance: Hardened the codebase by updating deprecated members, implementing structured logging via the logging package, and cleaning up dependencies (path, logging).

Removed

• Redundancy: Deleted lib/ui/widgets/word_button.dart in favor of internal _WordCard implementation.
• Package Reduction: Removed just_waveform dependency due to compatibility issues.

v[1.1.1] - 2025-12-26 [02028a2]

Added

• Typography: Integrated toto_serif_ethiopic.ttf font asset to ensure consistent rendering of Ge'ez scripture.

Changed

• Linter Cleanup: Resolved numerous lint warnings and addressed deprecated members across the codebase.
• Stability: Refined font_service.dart, export_service.dart, and ingestion_service.dart to improve error handling and asset loading.

v[1.1.0] - 2025-12-25 [6e5ab2c]

Added

• Persistence: Implemented an auto-save system in TappingPage that triggers every 60 seconds; added saveAutoSave to ExportService using path_provider.

Changed

• Lifecycle Management: Improved state disposal and added missing dart:async imports.
• Workflow Finalization: Completed the verification mode logic and integrated native keyboard shortcuts for synchronization.

[1.0.0] - 2025-12-22 [5ff7694]

Added

• Initial Baseline: Established the Windows Desktop baseline with the 'Orthodox Vellum' high-contrast theme.
• Core Services:
  • IngestionService: Support for Ge'ez text and Markdown parsing.
  • AudioController: Native playback with variable speed and seek logic.
  • ExportService: Generation of sync.json and tagged Markdown files.
• Tapping Interface: Precision UI featuring 'Progressive Fill' visual feedback for real-time synchronization.
• Shortcuts: Integrated global hotkeys for Undo, Rewind, Play/Pause, and Footnote placement.
• Cleanup: Stripped unnecessary cross-platform boilerplate to focus exclusively on Windows Desktop performance.