Update CHANGELOG and RELEASE_NOTES for v4.0.5

Summarized all changes since v4.0.2, including Titan aspect ratio fixes, RAW orientation persistence, and temporary RAW toggle logic.

Author: justnullname

CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [4.0.5] - Precision & RAW Stability Fix
+**Release Date**: 2026-03-13
+
+### 🐛 Bug Fixes
+- **Titan Aspect Ratio**: Fixed a critical bug where images Viewed in Titan mode would report incorrect aspect ratios when re-viewed from cache (srcWidth/srcHeight persistence).
+- **RAW Orientation**: Resolved an issue where RAW files would lose their EXIF orientation when hitting the image cache or during pre-decoding (Propagated `exifOrientation` through heavy lane).
+- **RAW Stability**: Fixed a double-free crash that occurred when the embedded JPEG preview extraction failed for certain RAW files.
+
+### ✨ UX Improvements
+- **Temporary RAW Toggle**: The "RAW" button in the toolbar now only affects the current viewing session. It no longer modifies the global system default, ensuring settings revert to user preference on restart or navigation.
+- **Rendering**: Refined bitmap surface upgrades and texture promotion logic to eliminate micro-flicker during high-quality LOD transitions.
+- **Feedback**: Added "(Temporary)" tag to RAW toggle OSD messages for clearer state communication.
+
+
 ## [4.0.2] - Performance & Precision Refinement
 **Release Date**: 2026-03-10
 

RELEASE_NOTES.md

@@ -1,20 +1,25 @@
-# QuickView v4.0.2 - Performance & Stability Fixes
-**Release Date**: 2026-03-10
+# QuickView v4.0.5 - Precision & RAW Stability Fix
+**Release Date**: 2026-03-13
 
-This update focuses on refining the **Titan Engine** performance, optimizing **UX interaction**, and fixing several critical bugs discovered after the v4.0.0 milestone.
+This maintenance release addresses several deep-seated issues in the **Titan Engine**'s caching system and significantly improves **RAW file support** stability and correctness.
 
-### ⚡ UX & Interaction
--   **Smart 3-State Zoom**: Re-engineered the zoom toggle logic. Clicking now cycles through `Initial` -> `Fit Screen` -> `100%`, providing much smoother control over image sizing.
--   **No-Stutter Exit**: Solved the annoying window stutter/lag that occurred when closing the application via the `Esc` key.
+### 🚀 Key Fixes
 
-### 🚀 Titan Engine Refinements
--   **Wait Cursor Fix**: Corrected logic where the OS wait cursor would incorrectly flicker during background prefetching.
--   **Tile Triggering**: Optimized Titan tile activation by removing threshold quantization, ensuring seamless LOD transitions even for ultra-narrow images.
--   **Progress UI**: Enhanced the Titan loading progress bar for better visual performance and accuracy.
+- **Titan Cache Precision (Aspect Ratio Fix)**: 
+  We fixed a regression where ultra-large images (decoded via the Titan Engine) would display incorrect aspect ratios when re-opening them from the memory cache. The engine now explicitly tracks and preserves the original image's resolution (`srcWidth`/`srcHeight`) separately from the scaled preview tiles.
 
-### 🛠 Stability & Fixes
--   **SVG Scaling**: Fixed a bug where SVGs would randomly disappear when scaling at certain factors.
--   **Window Snap**: Resolved an issue where the window would creep downwards on systems with top-aligned taskbars.
--   **Gallery Sync**: Fixed HUD Gallery thumbnail desync when deleting images while the gallery is open.
+- **Persistent RAW Orientation**: 
+  RAW files now retain their correct orientation even when hitting the pre-decode cache. We re-engineered the orientation propagation logic to ensure EXIF metadata is preserved across all worker threads and deep-copy operations.
+
+- **RAW Decoder Stability**: 
+  Fixed a critical "Double Free" crash that could occur with certain RAW files when the embedded JPEG preview extraction failed.
+
+### ✨ UX & Interaction
+
+- **Smart RAW Toggle (Session-Only)**: 
+  The "RAW" button in the toolbar is now a **temporary session override**. Clicking it allows you to quickly toggle between "Embedded Preview" and "Full RAW Decode" for the current image without altering your global system defaults. Your permanent choice in the Settings menu remains untouched.
+
+- **Flicker-Free Transitions**: 
+  Refined the bitmap promotion logic to ensure that upgrading from a lower-LOD preview to a high-quality full-resolution image is completely seamless with zero visual flicker.
 
 ---