1# Changelog
2
3All notable changes to this project will be documented in this file.
4
5## [Unreleased]
6
7## [0.12.1] - 2025-10-18
8
9### Added
10- **Favicon refactoring**: WebKitGTK FaviconDatabase as single source of truth, removing fragile file-based cache and ico/bmp conversion dependencies
11  - Native favicon detection and automatic PNG export at 32x32 for CLI (dmenu)
12  - SVG favicon rasterization support
13  - Async texture loading with callbacks for non-blocking UI updates
14  - FaviconService handles favicon collection across all panes
15
16### Changed
17- Removed old favicon cache system (go-ico, go-bmp dependencies)
18- Simplified omnibox favicon handling: uses database favicon_url only
19
20### Fixed
21- Mouse button navigation: Added support for hardware mouse buttons 8/9 (back/forward)
22- Touchpad gestures: Two-finger horizontal swipe for back/forward navigation
23- Web app shortcuts: Ctrl+C, Ctrl+V, Ctrl+A now work in Gmail, VSCode web, etc.
24- Dark mode flash on startup: Set GTK dark theme preference and WebView background color before window/content creation
25- Cmd+Q and window close button now trigger graceful shutdown instead of killing the browser process
26- WebView cleanup: Properly destroy WebViews to prevent memory leaks and duplicate handler registrations when closing stacked panes
27- CLI help: Running `dumber` without arguments now shows available commands (use `--gui` or `browse` to launch GUI)
28
29## [0.12.0] - 2025-10-16
30
31### Added
32- **Native favicon support**: WebKit FaviconDatabase integration with automatic detection and caching for all panes
33- ENV=dev support to isolate test builds from production config/data in .dev/dumber/ directory
34- Content filtering whitelist config (Twitch enabled by default)
35- `dumber config` command to open config file in $VISUAL/$EDITOR or print path with `--path`
36- **Native WebKit popup lifecycle**: Implemented WebKit's create/ready-to-show/close signals for proper popup management, eliminating manual WebView creation that bypassed WebKit's internal architecture
37- **Popup behavior configuration**: Added `popup_behavior` config with four modes: `split` (default), `stacked`, `tabbed`, and `windowed` for user control over popup placement
38- **Backend-driven pane mode**: Complete rewrite of pane mode from JavaScript to Go backend with native keyboard handling. Ctrl+P enters mode, x/l/r/d/u/arrows for actions, Escape exits. Blocks all other keys during mode.
39- **Pane mode visual border**: Zellij-style border around workspace root when pane mode is active, replacing old toast notification system. Uses GTK margins with configurable `pane_mode_border_color` (defaults to #FFA500 orange). Window background color shows through margins to create visible border effect
40
41### Changed
42- **Popup architecture refactoring**: Removed ~280 lines of JavaScript window.open interception in favor of WebKit's native popup signals. Popups now follow WebKitGTK's expected lifecycle instead of being intercepted and manually created
43- **GUI bootstrap refactoring**: Extracted 400+ lines of common initialization logic into reusable bootstrap.ts module shared between injected pages and special schemes (homepage, etc.)
44- **Workspace pane mode**: Moved ~450 lines of JavaScript state machine to Go backend for more reliable keyboard handling and eliminated race conditions between webviews
45
46### Fixed
47- **TLS certificate validation restored**: Re-implemented persistent certificate error handling (broken during gotk4 migration)
48  - Interactive three-option dialog: "Go Back", "Proceed Once (Unsafe)", and "Always Accept This Site"
49  - SQLite-based hostname decision storage (hostname-only matching - GIO certificate properties are unstable)
50  - Smart expiration: "Proceed Once" temporary (not stored), "Always Accept" persists for 30 days
51  - Automatic cleanup of expired validations on application startup
52  - **Known issue**: Accepted certificates not pre-loaded into WebKit session on startup - stored decisions only apply when TLS error occurs again
53- **Content blocking restored**: Re-implemented WebKit native ad/tracker blocking (broken during gotk4 migration) using UserContentFilterStore API
54- **Script injection spam**: Fixed 100+ duplicate "Sending color palettes" messages by injecting scripts only in top frame instead of all iframes
55- **Favicon race conditions**: Eliminated duplicate downloads and file handle errors via mutex protection and proper handler registration
56- **Homepage theme switching**: Fixed color palette application for proper light/dark mode transitions
57- **Workspace pane borders**: Hide active pane border when only one pane exists to match Zellij UX
58- Enabled missing WebKitGTK6 features: WebRTC, MediaSource, LocalStorage, WebAudio, MediaStream, Clipboard
59- Cosmetic filter duplicate injection in frames
60- Config file duplicate keys (snake_case/camelCase) by using Viper's SafeWriteConfigAs
61- Config not reading newly created default config file
62- Config writing to disk on every load/reload
63- **Popup SIGSEGV crashes**: Eliminated segmentation violations during popup lifecycle by respecting WebKit's signal-based popup management. Fixes OAuth popup crashes and GTK bloom filter corruption
64- **GTK focus event duplicates**: Added timestamp-based deduplication to prevent multiple focus enter/leave events in the same millisecond from WebKitGTK nested widgets
65- **Popup close behavior**: Fixed app exit when closing popups by excluding them from remaining pane count check
66- **Pane mode border cleanup**: Fixed border persisting after pane splits by saving container reference when applying margins. Ensures proper cleanup even when workspace tree structure changes during split operations
67- **Stacked pane active border**: Fixed active border incorrectly appearing on stacked pane containers instead of individual panes
68- **Stacked pane creation**: Fixed premature Realize() call causing widget lifecycle issues during stack creation
69- **Browser exit on last pane close**: Fixed browser not properly quitting when closing the last webview via Ctrl+P x by calling GTK main loop quit instead of window close
70- **Zoom level persistence restored**: Fixed per-domain zoom settings not being saved to database (broken during gotk4 migration). Added missing `notify::zoom-level` signal connection in setupEventHandlers to properly persist zoom changes
71
72## [0.11.0] - 2025-10-07
73
74### Added
75- **Auto-open omnibox on blank panes**: Omnibox automatically opens when a new pane is created with about:blank, providing immediate search/navigation access
76- **Configurable default zoom**: Added `default_zoom` config (defaults to 1.2/120%). Per-domain zoom still overrides this
77- **Pin/favorite sites**: Pin websites from history or quick access to prioritize them in "Jump back in" section. Uses localStorage persistence with star icons for pin/unpin actions
78- **Zellij-style stacked panes**: Added Ctrl+P → 's' to stack panes instead of splitting, with Alt+Up/Down navigation between stacked panes. Features collapsed page title bars showing  for inactive panes and full WebView interaction for the active pane. Includes GTK4 CSS styling for proper visual feedback
79- **Stacked pane favicons**: Title bars display site favicons with async caching. Click title bars to switch between stacked panes
80- **Color palette configuration**: Light and dark color palettes now configurable in `appearance` config with semantic tokens (background, surface, text, muted, accent, border). Injected as CSS custom properties at document start
81- **Search shortcut badges**: Visual badges in omnibox input showing active shortcut prefix (e.g., "gh:", "npm:") with description labels
82- **Search shortcuts API**: Frontend bridge to fetch search shortcuts from backend `/api/config` endpoint with automatic normalization
83
84### Changed
85- **Terminal-style UI theme**: Monospace fonts (JetBrains Mono, Fira Code), sharp corners (no border-radius), dashed borders, adjusted shadows and spacing throughout omnibox components
86- **History suggestions**: Use favicon from database when available, omit automatic search shortcuts from suggestions (rely on explicit prefix commands)
87- **Search shortcuts defaults**: Updated defaults to include ddg, go, mdn, npm packages while reordering others
88- **Chrome user agent**: Updated to version 141.0.0.0 for better site compatibility
89- **CSS color system**: Removed hardcoded theme colors, now use dynamic CSS custom properties from Go-injected palette
90- **History item layout**: Removed "• domain" from titles, now highlight domain within the full URL using same color as title text
91- **Quick access logic**: Removed 20-item limit, now shows all sites with 2+ visits (pinned sites bypass visit requirement)
92- **History pagination**: Show 15 items initially (up from 10) with "Show N more" button
93- **Homepage layout**: Redesigned with improved visual hierarchy and dynamic color tokens
94- **Favicon handlers**: All webviews now register favicon change handlers for consistent caching across panes
95
96### Fixed
97- **Mobile URL overflow**: Fixed long URLs breaking layout on narrow screens by adding proper width constraints and CSS fixes
98- **GTK shortcut GLib-CRITICAL error**: Fixed NULL string assertion in shortcut callback system
99- **SVG favicon handling**: Skip SVG favicons to prevent conversion errors (no raster conversion dependencies)
100- **Focus management architecture**: Refactored workspace focus system from `active` field to `currentlyFocused` with dedicated FocusManager for improved reliability and consistency across pane operations
101- **Stacked pane focus conflicts**: Fixed focus stealing issues in stacked panes by implementing focus-aware navigation that preserves active pane when spawning siblings
102- **WebView title updates**: Enhanced webview title change handling to properly update stacked pane title bars in addition to database storage
103- **GTK4 widget lifecycle**: Improved widget parenting/unparenting operations with proper GTK4 validation and automatic cleanup to prevent critical warnings
104- **Stacked pane close behavior**: Fixed remaining pane becoming non-interactable (gray background) when closing stacked panes via Ctrl+W or Ctrl+P+X. Added proper widget visibility restoration and focus management during stack-to-regular conversion
105- **Stacked pane title updates**: Fixed collapsed panes not showing current page titles when switching between stacked panes. Now follows Zellij-style layout where hidden panes display their up-to-date page titles in title bars with correct positioning above and below the active pane
106
107## [0.10.0] - 2025-09-24
108
109### Added
110- **Print functionality**: Added Ctrl+Shift+P shortcut to open native print dialogs from any pane. Ctrl+P is blocked at WebKit level to prevent conflicts with pane mode shortcuts
111- **WebKit native favicon detection**: Implemented WebKit's built-in favicon database for automatic favicon detection and URI storage. Enhanced favicon support for all formats (PNG, SVG, ICO) without external dependencies
112
113### Changed
114- **Homepage redesign**: Brutal design with component-scoped styling, dynamic height matching, inline domain-URL layout with fade effects, and tighter spacing
115
116### Fixed
117- **WebView teardown and memory management**: Implemented comprehensive cleanup system to prevent crashes during WebView destruction. Added JavaScript teardown functionality with cleanup handlers for all event listeners, intervals, and global state. Enhanced pane cleanup with proper controller detachment and GTK widget detachment sequencing. Added WebView validity checks before JavaScript evaluation and improved workspace manager pane closing logic with better popup handling
118- **Ctrl+W pane closing**: Fixed Ctrl+W shortcut to properly close active panes including popups. Implemented active WebView detection and proper popup vs regular pane handling via OnWorkspaceMessage for consistent cleanup
119- **WebView script injection segfault**: Fixed segmentation violation when injecting JavaScript into destroyed WebViews during message handling. Added IsDestroyed() safety check to prevent GTK widget corruption
120- **Alt+Arrow workspace navigation**: Fixed Alt+Arrow keys not working for pane navigation after WebView focus changes. Implemented C-level to GTK4 shortcut bridge that ensures workspace navigation works consistently across all panes
121- **Global shortcuts protection**: Fixed window shortcuts (Ctrl+L, Ctrl+F, F12) not working in new panes due to overly aggressive webpage protection. Window shortcuts now properly bubble up to GTK while pane shortcuts remain blocked from webpages. Resolves omnibox and developer tools not responding to keyboard shortcuts in newly created panes
122- **Omnibox keyboard event isolation**: Fixed keyboard event leakage from omnibox to underlying webpages that caused unintended page actions (e.g., typing 's' in omnibox triggering GitHub search). Implemented WebKit-level main-world event blocking that activates when omnibox opens, preventing page JavaScript from receiving keyboard events while preserving native GTK shortcuts (Ctrl+L, Ctrl+F, etc.) and omnibox functionality
123- **Active pane detection**: Replaced complex pane ID abstraction with persistent webview IDs, fixing omnibox unresponsiveness after navigation. Omnibox now works immediately after page navigation without requiring mouse movement
124- **Workspace architecture**: Simplified focus tracking by removing URI change handlers and pane ID injection complexity, improving reliability and reducing codebase by 85 lines
125- **WebView ID propagation**: Added webview ID request/response mechanism for stub builds to ensure JavaScript side knows its webview ID for proper focus validation
126- **Workspace theme integration**: Fixed white borders on inactive panes by implementing dynamic border colors based on GTK theme preference (dark mode: #333333 borders, light mode: #dddddd borders)
127- **GTK window background**: Added theme-aware window and pane background colors to prevent white bleeding through transparent elements
128- **Print dialog window handling**: Fixed GTK window destroy errors during WebView cleanup by only destroying windows when CreateWindow was actually enabled
129- **Modifier key logging noise**: Filtered out Ctrl, Shift, Alt, and Super key presses from accelerator miss logging to reduce console spam
130
131## [0.9.0] - 2025-09-22
132
133### Added
134- **Zellij-style workspace management**: Complete pane splitting system with binary tree layout, focus tracking, and Zellij-inspired keybindings (Ctrl+P for pane mode, arrow keys for splits, 'x' to close)
135- **Multi-pane WebView architecture**: Container-based widget management with proper reparenting, lifecycle handling, and per-pane controllers
136- **Window-level global shortcuts**: Centralized shortcut handling to prevent conflicts between multiple WebView instances
137- **Workspace configuration**: New config section with Zellij controls toggle, pane mode bindings, tab shortcuts, and popup behavior settings
138- **Configurable workspace styling**: Pane border appearance (width, color, transition duration, radius) now customizable via config with proper viewport stability
139- **Popup handling for tiling WM**: Complete popup window support where popups open as workspace panes instead of floating windows, respecting tiling window manager design principles
140- **Universal popup auto-close**: Popup windows (OAuth, window.open(), etc.) automatically close when JavaScript calls window.close(), providing standard browser behavior adapted for workspace panes
141- **Advanced popup deduplication system**: Intelligent duplicate popup prevention with SHA256 fingerprinting and 200ms debounce window to eliminate popup spam
142- **OAuth auto-close integration**: RFC 6749 compliant OAuth callback detection with automatic popup closure for seamless authentication flows
143- **Cross-WebView popup communication**: localStorage-based parent-popup bridge enabling proper `window.opener` functionality in tiling workspace environment
144- **WebView identity tracking**: Unique WebView ID system for precise popup targeting and enhanced debugging capabilities
145
146### Improved
147- WebKit integration now forces GPU compositing by default while still honoring explicit config overrides.
148- Smooth scrolling is enabled (when supported) so wheel and gesture animations feel closer to Chromium/Firefox.
149- Title updates, zoom persistence, and domain zoom lookups are now done off the GTK main thread with results marshalled back safely, eliminating UI hitches during navigation.
150- Added optional DOM-level zoom (enabled by default) to avoid native viewport rescaling; falls back to WebKit zoom if the CSS path fails.
151- DOM zoom now seeds the saved level before the first paint and reuses it during document-start scripts, preventing pages from flashing back to 100%.
152- Native accelerator bridge debounces duplicate GTK key events earlier, so Ctrl±/Ctrl+0 only fires once per physical key press.
153- Omnibox-triggered navigations now reuse the navigation controller, so saved zoom levels are applied before first paint and redundant lookups are avoided.
154- Configuration loading writes the missing `use_dom_zoom` flag into existing config files so DOM zoom defaults persist without manual edits.
155- Omnibox UI now relies on shared Tailwind theme tokens and the injected color-scheme service for light/dark parity.
156- Omnibox overlay now self-heals if hostile pages remove the injected shadow host, ensuring Ctrl/Cmd+L works everywhere.
157- Navigation shortcuts changed from Alt+Arrow to Ctrl/Cmd+Arrow for better workspace compatibility.
158- GUI components now support workspace-aware focus management with pane-specific event handling.
159- **Global zoom shortcuts**: Unified zoom handling at window level (Ctrl+/=/0/-) ensuring zoom applies to currently active pane in multi-pane workspace
160- **Workspace focus management**: Enhanced focus throttling (100ms) and active state tracking to prevent infinite loops and conflicts between panes
161- **Popup management**: Intelligent popup vs tab detection based on window features, with improved auto-close logic for OAuth and login flows
162- **Console logging**: WebView ID context injection for better debugging and log correlation across multiple panes
163
164### Changed
165- **Zoom shortcuts architecture**: Moved from per-WebView registration to centralized window-level handling for consistency with other global shortcuts
166
167## [0.8.0] - 2025-09-17
168
169### Added
170- **GTK color scheme bridge**: Dedicated document-start module keeps WebKit theme in sync with GTK preferences and exposes unified runtime updater
171- **Color scheme build pipeline**: Separate Vite entry produces reusable `color-scheme.js` asset shared between native and injected contexts
172- **Complete Svelte 5 GUI migration**: Omnibox and find components migrated from raw JavaScript to modern Svelte 5 with runes
173- **Tailwind CSS v4 integration**: Unified design system with PostCSS and JIT compilation
174- **TypeScript keyboard service**: Centralized shortcut management with full type safety
175- **Click-anywhere-to-close**: Omnibox closes when clicking outside for better UX
176- **Homepage Svelte 5 component**: New standalone homepage with history display and keyboard shortcuts reference
177- **Page generator system**: Vite plugin for generating dumb:// protocol pages (homepage, config, about) with extensible architecture
178- **History deletion API**: New DELETE endpoint at `/history/delete?id=N` for removing individual history entries
179- **Database migrations**: Embedded migrations now run automatically at startup to keep sqlite schema in sync
180- **Inline CSS type declarations**: Ambient module definitions for raw CSS imports improve TypeScript ergonomics in injected bundles
181- **Global Shadow DOM system**: Unified shadow host utility for component isolation with shared ShadowRoot and CSS reset management
182- **Unified page-world bridge**: Integrated API bridge with event-driven communication between page-world and isolated-world contexts
183
184### Improved
185- **Asset MIME detection**: Expanded scheme handler lookup covers fonts, images, and JSON to prevent incorrect `text/plain` responses
186- **Toast theming**: Runtime theme observer syncs toast styling with the browser's dark mode state for consistent visuals
187- **Shadow host styling**: Injected GUI now adopts Tailwind design tokens inside the shared shadow root with automatic dark-mode mirroring
188- **Omnibox/Find system**: Complete migration from 500-line raw JavaScript to modular Svelte 5 components
189- **Toast notifications**: Migrated from raw JavaScript to Svelte 5 components with proper animations
190- **GUI build pipeline**: Vite-based bundling with hot reload and TypeScript support
191- **Keyboard shortcuts**: Fixed Ctrl+F not working by adding missing 'f' key to keyboard dispatcher
192- **State management**: Proper cleanup between omnibox and find modes prevents state conflicts
193- **Homepage UX**: Enhanced layout with 70/30 flex ratio, compact keyboard shortcuts table, and statistics display
194- **Interactive delete**: History entries show trash icon on hover with smooth fade-out animation on deletion
195- **Top 5 most visited**: New section displaying frequently accessed sites with visit counts
196- **Performance**: Instant shortcut response with pre-mounted DOM elements
197
198### Changed
199- **Homepage icons**: Replaced Lucide dependency with inline SVG/Unicode fallbacks to shrink bundle size while debugging upstream build issues
200- **Major architecture shift**: Removed HTTP API routes in favor of direct WebKit message bridge communication for better performance and reduced complexity
201- **API token support**: Added optional API security configuration with token-based authentication system
202- **Shadow DOM improvements**: Enhanced isolation with WeakSet tracking to prevent duplicate reset injection and global shadow host utility for component sharing
203- **Message handler refactoring**: Unified keyboard shortcut forwarding between native handlers and GUI components with DOM event bridge
204- **Omnibox suggestions**: Native Go-based suggestion computation with search shortcuts and history integration, eliminating HTTP fetch dependencies
205- **Toast styling**: Migrated from Tailwind CSS classes to inline styles within component scope for better Shadow DOM compatibility and isolation
206- **JS to Svelte migration**: Replaced legacy inline injected scripts (see `pkg/webkit/ucm_js_cgo.go.deprecated`) with structured Svelte components mounted via the shared shadow root.
207
208### Fixed
209- **Service worker residue**: Homepage clears stale caches and unregisters old service workers to avoid 404s for legacy `_app` assets
210- **Keyboard debounce**: Native accelerator bridge filters duplicate shortcut events within 120ms for DOM and CGO handlers
211- **Ctrl+F shortcut**: Added missing 'f' key case in keyboard_cgo.go dispatcher
212- **Browser freeze**: Removed infinite loop in mode switching reactive effects
213- **State persistence**: Proper cleanup when switching between Ctrl+L and Ctrl+F modes
214- **Homepage protocol**: Fixed dumb://homepage not working after GUI migration with proper Svelte 5 component and API integration
215- **Omnibox positioning on homepage**: Fixed omnibox stuck in top-left corner by isolating homepage CSS styles and strengthening omnibox positioning with explicit fixed positioning and CSS isolation
216- **Find mode persistence**: Fixed find view persisting after pressing Esc when reopening with Ctrl+L by ensuring toggle() resets mode to 'omnibox'
217- **Favicon display**: Fixed missing favicons in homepage history after Svelte 5 migration by adding FaviconURL field to API response and implementing proper fallback display logic
218- **Homepage API communication**: Migrated from HTTP fetch to WebKit message bridge for all homepage API calls (history, stats, search) with proper callback handling and timeout management
219- **Omnibox accessibility**: Added keyboard navigation support with Tab/Enter activation for suggestion items and proper ARIA attributes for screen readers
220- **Omnibox suggestions race conditions**: Fixed timing issues where suggestions arrived before API was ready by implementing pending suggestions queue and proper event bridging between page-world and isolated-world contexts
221
222## [0.7.0] - 2025-09-14
223
224### Added
225- **Content blocking system**: Native WebKit ad blocking with EasyList integration, cosmetic filtering, and filter cache management
226- **Filter cache purging**: New `--filter-cache/-F` flag in purge command
227- **WebKit debug system**: Comprehensive debugging support with configurable categories for troubleshooting WebKit internal errors
228- **Enhanced error handling**: Robust content filter injection with retry mechanisms and graceful fallbacks
229- **Parallel compilation**: Multi-core GCC compilation support for faster builds
230
231### Improved
232- **Content filter timing**: Optimized script injection timing to prevent interference with WebKit preconnect operations
233- **Anti-breakage scriptlets**: Safer JavaScript modifications that avoid WebKit internal conflicts
234- **Build system**: Added parallel compilation with automatic core detection and success indicators
235- **Persistent TLS certificate validation system**:
236  - **Three-option certificate dialog**: "Go Back", "Proceed Once (Unsafe)", and "Always Accept This Site"
237  - **Database-backed certificate storage**: SQLite-based persistence for user certificate decisions with SHA256 certificate hashing
238  - **Smart decision handling**: Automatic application of stored decisions without repeated prompts
239  - **Temporary vs permanent choices**: "Proceed Once" expires after 24 hours, "Always Accept" persists indefinitely
240  - **Seamless user experience**: No more repetitive certificate warnings for trusted sites
241- **Performance-optimized WebKit memory configuration system**:
242  - **New `WebkitMemoryConfig`** configuration section with performance-focused defaults for faster page loading
243  - **Aggressive caching strategy**: `web_browser` cache model with page cache enabled for instant back/forward navigation
244  - **Balanced memory pressure management**: Conservative (40%), strict (60%), and kill (80%) thresholds optimized for performance vs stability
245  - **Smart garbage collection**: 2-minute JavaScript GC intervals with process recycling after 50 page loads
246  - **Reduced monitoring overhead**: 45-second memory monitoring intervals to minimize performance impact
247  - **Environment variable overrides**: All memory settings configurable via `DUMBER_*` environment variables (`DUMBER_CACHE_MODEL`, `DUMBER_MEMORY_CONSERVATIVE`, etc.)
248- **Early crash handling initialization**: Moved crash handler setup to application entry point for better crash recovery
249
250### Changed
251- **Modernized GTK dialog system**: Migrated from deprecated GTK 4.10 dialog functions to modern `GtkAlertDialog` API
252  - **Future-proof implementation**: Eliminated all deprecation warnings by replacing `gtk_message_dialog_*` and `gtk_dialog_*` functions
253  - **Async-first architecture**: Native async dialog handling with proper event loop integration
254  - **Improved accessibility**: Better screen reader support and GTK4 theme integration
255- **Major main.go refactoring**: Massive code reduction from 1071 lines to 61 lines (~95% reduction)
256  - **Extracted browser application logic** to dedicated `internal/app/browser` package for better separation of concerns
257  - **Streamlined entry point**: Clean main function focusing only on CLI vs GUI mode detection and application bootstrapping
258  - **Improved maintainability**: Modular architecture with clear responsibilities between CLI and browser components
259- **Refactored memory configuration architecture**:
260  - Integrated WebKit memory settings into unified config system with Viper environment variable bindings
261  - Eliminated redundant environment variable parsing in favor of centralized configuration management
262  - Simplified webview initialization with direct config-to-WebKit conversion
263- **Improved CLI logs command description**: Enhanced help text for better user experience
264
265## [0.6.0] - 2025-09-12
266
267### Added
268- **Smart AV1 codec negotiation system for YouTube high-resolution streaming**:
269  - **Resolution-aware MediaCapabilities API reporting**: Intelligent codec capability reporting based on video resolution, enabling YouTube to select optimal codecs for different quality levels
270  - **YouTube format manifest manipulation**: Real-time format list reordering to prioritize AV1 for ≤1080p content while allowing VP9 fallback for higher resolutions
271  - **Graduated codec preference system**: Smart localStorage preference (`2048`) instead of forced AV1 (`8192`), giving YouTube flexibility for optimal codec selection
272  - **4K HDR 60fps AV1 support**: Successfully enables YouTube delivery of premium quality 4K HDR content with AV1 codec, HDR10 (PQ) color space, and BT.2020 wide color gamut
273  - **Configurable AV1 resolution limits**: New `av1_max_resolution` config option with environment variable support (`DUMBER_AV1_MAX_RES`)
274  - **Automatic codec fallback logic**: Seamless VP9 fallback for resolutions where AV1 performance may be suboptimal
275  - **High bitrate streaming support**: Enables premium quality streaming (650+ Mbps) with proper buffer management
276  - Fixes previous limitation where forcing AV1 would cap YouTube playback at 1080p maximum
277- Page refresh functionality with standard keyboard shortcuts:
278  - **Ctrl+R** / **Cmd+R**: Reload current page
279  - **Ctrl+Shift+R** / **Cmd+Shift+R**: Hard reload (bypass cache)
280  - **F5**: Alternative reload key
281  - WebKit integration with proper `webkit_web_view_reload()` and `webkit_web_view_reload_bypass_cache()` calls
282- **Twitch theater mode and fullscreen stability fix**:
283  - **Complete removal of codec interference on Twitch**: Eliminates aggressive codec control that caused theater mode and fullscreen freezing
284  - **Native Twitch codec selection**: Allows Twitch to handle codec negotiation without browser intervention
285  - Fixes theater mode freeze and fullscreen black screen issues on Twitch
286
287### Fixed
288- Zoom level toast no longer shows on every page navigation within the same domain:
289  - Added smart detection to differentiate user-initiated vs programmatic zoom changes
290  - Toast now only appears when manually adjusting zoom or entering a new domain
291  - Prevents annoying notifications during regular browsing within the same site
292- Links with `target="_blank"` now load in current window instead of being ignored:
293  - Added WebKit `create` signal handler to intercept new window requests
294  - Redirects popup/new tab links to current window for seamless single-window browsing
295  - Maintains user experience consistency in tab-less browser architecture
296
297## [0.5.0] - 2025-09-12
298
299### Added
300- Hardware video acceleration with automatic GPU detection:
301  - Multi-vendor GPU detection (AMD, NVIDIA, Intel) using glxinfo, lspci, and sysfs
302  - Automatic VA-API driver selection (radeonsi for AMD, vdpau for NVIDIA, iHD for Intel)
303  - WebKitGTK integration with GStreamer hardware acceleration backends
304  - Environment variable configuration support (LIBVA_DRIVER_NAME, GST_VAAPI_ALL_DRIVERS)
305  - Legacy VA-API fallback mode for compatibility with older systems
306  - Video decoding acceleration for H.264, HEVC, VP9, and AV1 codecs
307  - Significantly reduced CPU usage during video streaming (Twitch, YouTube, etc.)
308  - Smart conflict prevention between legacy and modern VA-API implementations
309- TLS certificate error handling with user confirmation dialog:
310  - Comprehensive certificate information display (subject, issuer, validity dates)
311  - Interactive warning dialog for untrusted certificate authorities
312  - Certificate exception management with per-host persistence
313  - Manual load triggering after user accepts certificate exceptions
314  - Proper integration with WebKitGTK 6.0 network session API
315- Zoom level toast notifications:
316  - Real-time zoom level display with format: "Zoom level: ±X% (Y%)"
317  - Smart debouncing to prevent notification spam during rapid zoom changes
318  - Automatic cleanup of stuck or colliding toast messages
319  - 150ms debounce timer with 2-second display duration
320  - Emergency cleanup function for orphaned toast elements
321- Comprehensive XDG-compliant logging system:
322  - Complete application output capture (Go logs, fmt prints, WebKit C logs)
323  - XDG Base Directory specification compliance (`~/.local/state/dumber/logs/`)
324  - Automatic log rotation with size/age-based cleanup and compression
325  - WebKit CGO log capture with GLib log handler integration
326  - CLI log management commands (`dumber logs list`, `logs tail`, `logs clean`)
327  - File-only logging for cache operations to prevent dmenu interference
328  - Multi-output support with timestamped, tagged log entries
329  - Configurable log levels, formats (text/JSON), and retention policies
330
331### Fixed
332- WebView background set to black to improve user experience during page loads
333- Multiple linting issues and code quality improvements (reduced from 211 to ~150 issues)
334- Omnibox responsive scaling and layout issues:
335  - Fixed over-aggressive viewport scaling that made omnibox disproportionately large at high zoom levels
336  - Resolved input field overflow extending beyond container boundaries
337  - Improved box-sizing model to prevent layout issues
338  - Added conditional separator display (hidden when no search results)
339  - Omnibox now scales proportionally with webpage content across all zoom levels
340- Dmenu history favicon display:
341  - Complete favicon caching system for fuzzel/dmenu integration with real website icons
342  - ICO file support using go-ico library for perfect Windows icon conversion to PNG
343  - Smart brightness detection and color inversion for dark theme visibility
344  - All cached favicons normalized to consistent 32x32 PNG format for uniform display
345  - Anti-aliasing preservation during color inversion to prevent edge noise and pixelation
346  - Asynchronous favicon downloading and caching with 7-day freshness and 30-day cleanup
347  - Fuzzel icon protocol integration (`\0icon\x1f<path>`) for native icon display
348  - Favicon URLs extracted from webpage metadata and stored in database during navigation
349  - Fallback system removed to ensure consistent sizing - shows real favicons or no icon
350  - XDG Base Directory compliance for favicon cache storage
351
352## [0.4.0] - 2025-09-10
353
354### Added
355- High-performance fuzzy cache system for dmenu history:
356  - Binary serialization with memory-mapped files for zero-copy access
357  - Trigram indexing (3-character sequences) for fast candidate filtering  
358  - Prefix trie (compressed tree structure) for prefix matching
359  - Pre-sorted entry indices for O(1) top entries retrieval
360  - Smart cache invalidation with filesystem persistence and background refresh
361  - Comprehensive fuzzy matching algorithms: Jaro-Winkler similarity, Levenshtein distance, tokenized matching
362  - Weighted scoring system combining URL, title, recency, and visit count scores
363  - XDG Base Directory Specification compliance (cache stored in state directory)
364  - Atomic operations for concurrent access control
365  - Dependency injection using interfaces and gomock for testing
366- Purge command for cleaning up dumber data and cache files:
367  - Selective purging with flags: `--database`, `--history-cache`, `--browser-cache`, `--browser-data`, `--state`, `--config`
368  - Clear distinction between history cache (dmenu fuzzy search) and browser cache (WebKit)
369  - Browser data includes cookies, localStorage, sessionStorage
370  - Confirmation prompt with `--force` flag to skip
371  - Targets all data locations: SQLite database, WebKit cache/data, dmenu fuzzy cache, configuration files
372- Ctrl+Shift+C keyboard shortcut to copy current URL to clipboard:
373  - Cross-platform clipboard support with wl-copy (Wayland) and xclip (X11) fallback
374  - Reusable toast notification system for user feedback
375  - Injectable JavaScript component for consistent styling across all websites
376  - Native backend integration for reliable clipboard access
377
378### Changed
379- Dmenu performance dramatically improved: 200ms → 4ms (98% faster)
380- GetTopEntries optimized from O(n log n) to O(1) using pre-sorted indices
381- Cache build time reduced to ~300μs for typical history datasets
382
383### Fixed
384- Dark theme detection now properly reads GNOME desktop interface color-scheme setting (`org.gnome.desktop.interface color-scheme`) instead of only checking `gtk-application-prefer-dark-theme`
385- Eliminated O(n log n) sorting bottleneck on every dmenu call
386- Memory-efficient compact entry storage with minimal footprint
387- Concurrent cache access with proper read/write locking
388- Process no longer hangs when closing window with Cmd+Q or window close button - implemented proper GTK4 `close-request` signal handling and OS signal handling for graceful shutdown
389
390## [0.3.0] - 2025-01-11
391
392### Added
393- WebKit memory controls (opt‑in):
394  - Env vars to tune memory/perf trade‑offs without code changes:
395    - `DUMBER_CACHE_MODEL`, `DUMBER_ENABLE_PAGE_CACHE`
396    - `DUMBER_ENABLE_MEMORY_MONITORING`, `DUMBER_MEMORY_LIMIT_MB`, `DUMBER_MEMORY_POLL_INTERVAL`
397    - `DUMBER_MEMORY_CONSERVATIVE`, `DUMBER_MEMORY_STRICT`, `DUMBER_MEMORY_KILL`
398    - `DUMBER_GC_INTERVAL`, `DUMBER_RECYCLE_THRESHOLD`
399  - Version‑guarded CGO wrappers for memory pressure and GC hooks; safe no‑ops on unsupported WebKitGTK builds.
400 - Find in page (Ctrl/Cmd+F):
401   - Omnibox refactored into a reusable component with dedicated "find" mode.
402   - Highlighting: yellow for all matches; active match in orange for clarity.
403   - Match list with context (right side stops at nearest punctuation: . , ; : -).
404   - Navigation UX:
405     - ArrowUp/Down move selection and scroll the overlay list (page scroll disabled while open).
406     - Enter centers on the active match and closes; Shift+Enter goes to previous; Alt+Enter centers without closing.
407     - Hover focuses input and selects list items; click outside closes the overlay.
408     - Faded overlay with subtle blur when reviewing matches; opacity restores on input focus/typing.
409   - Programmatic API: `OpenFind(initial)`, `FindQuery(q)`, `CloseFind()` on `WebView`.
410
411### Changed
412- Performance‑first defaults retained:
413  - Cache model set to “WebBrowser”, page cache enabled, DevTools available.
414  - No implicit memory pressure or GC enabled by default; all memory tuning is opt‑in.
415
416### Removed
417- Deprecated offline app‑cache calls eliminated (no‑ops) to avoid warnings and brittle builds.
418
419### Fixed
420- Homepage Recent History layout:
421  - Show single-line entries as “{Title} – {Domain} – {URL}”.
422  - Truncate long URLs with a gradient fade; prevent horizontal overflow.
423  - Adjusted styling so URL is darker for readability.
424- Search shortcuts and config interop:
425  - Backend SearchShortcut now serializes `url`/`description` with JSON tags.
426  - Frontend normalizes field casing and extracts base URLs, handling `%s` and `{query}` templates.
427  - Omnibox shortcut parsing now URL-encodes queries and supports `%s` placeholders.
428- Input and navigation reliability (GTK4/WebKitGTK 6):
429  - Capture-phase key controller to ensure accelerators fire consistently.
430  - Do not consume normal left/right clicks; only mouse buttons 8/9 trigger back/forward.
431  - Added Alt+ArrowLeft/Right navigation and enabled two-finger swipe back/forward when supported.
432  - Added Ctrl+scroll zoom in/out; refined accelerator matching so Ctrl− works across layouts.
433  - Removed layout-specific hacks; added diagnostic logs for raw minus key events.
434- Zoom persistence:
435  - Added WebView zoom-changed hook; save per-domain zoom to SQLite on every change.
436  - Log on successful save: “saved X.XX for domain.tld” and on load: “loaded X.XX for domain.tld”.
437  - Load and log initial zoom level on startup and on every navigation.
438- Build/dev ergonomics:
439  - Makefile loads `.env.local`; supports overriding `GOMODCACHE`, `GOCACHE`, `GOTMPDIR` for sandboxed builds.
440 - WebKit CGO hardening and API compatibility:
441   - Apply memory pressure settings to `WebKitNetworkSession` (correct signature) when enabled.
442   - Guarded C wrappers remove deprecation warnings across header variants; builds succeed on WebKitGTK 6.
443
444## [0.2.0] - 2025-09-10
445
446### Added
447- WebKitGTK 6 (GTK4) migration for the built‑in browser window:
448  - WebView constructed via `g_object_new(WEBKIT_TYPE_WEB_VIEW, …)` with a fresh `WebKitUserContentManager`.
449  - `WebKitNetworkSession` with persistent cookies (SQLite) and cache directories.
450- Native UCM messaging restored via `script-message-received::dumber` (JSCValue*), removing the JS fallback bridge.
451- Rendering mode controls:
452  - CLI flag `--rendering-mode=auto|gpu|cpu` and `DUMBER_RENDERING_MODE` env.
453  - In‑app status endpoint `dumb://homepage/api/rendering/status`.
454- Native zoom shortcuts at the WebKit layer (Ctrl/Cmd+=, +, −, 0) and GTK4 input controllers for keyboard/mouse.
455- AZERTY keyboard fix: treat underscore as minus for zoom‑out.
456- Runtime theme synchronization: watch GTK `gtk-application-prefer-dark-theme` and update page color‑scheme live.
457- Makefile target `check-webkit` to print `pkg-config` versions of GTK4/WebKitGTK 6.0/JSC 6.0.
458- Documentation updates:
459  - README now targets WebKitGTK 6 (GTK4) and lists GStreamer package requirements for Arch and Debian/Ubuntu.
460  - CLAUDE notes updated with migration status, GPU/Vulkan path, runtime theme sync, and persistence.
461
462### Changed
463- Build flags and includes now target `webkitgtk-6.0`, `gtk4`, and `javascriptcoregtk-6.0`.
464- GTK4 APIs for windowing and event handling (GtkEventController, GtkGestureClick) replace GTK3/GdkEvent paths.
465
466### Removed
467- Legacy WebKit2GTK constructors and container APIs.
468- JavaScript fallback for UCM message bridging.
469
470### Fixed
471- Header/enum compatibility for hardware acceleration policy and cookie policy across WebKit header variants.
472- Linker error for `on_theme_changed` and gpointer usage in signal connections.
473- Crashy paths mitigated by default “media safe” startup (can be disabled via `DUMBER_MEDIA_SAFE=0`).
474
475### Notes
476- GPU rendering path leverages GTK4’s renderer (Vulkan/OpenGL). Mode `auto` uses GPU when available and falls back gracefully to CPU.
477- WebKitGTK relies on GStreamer; install recommended packages for audio/video (see README).
478
479## [0.1.0] - 2025-09-09
480
481### Added
482- Initial project scaffolding, build system, and dependencies.
483- Unified CLI + GUI architecture with search shortcuts and fuzzy parsing.
484- Wails v3‑alpha browser integration (early phase).
485- Global keyboard controls with script injection (zoom/devtools, etc.).
486- Native WebKit2GTK backend migration:
487  - Custom `dumb://` scheme and `/api` endpoints: `/config`, `/history/recent`, `/history/search`, `/history/stats`.
488  - UserContentManager omnibox injection and theme initialization.
489  - Persistent WebsiteDataManager with cookies.sqlite; per‑domain zoom and title persistence.
490  - Keyboard/mouse accelerators (including mouse back/forward); debounced triggers.
491  - Homepage switched to first‑party API fetches; removed @wailsio/runtime usage.
492- Documentation and licensing: README enhancements and LICENSE added.
493
494### Changed
495- Replaced Wails runtime with native WebKit2GTK CGO bindings and homepage API.
496- Improved asset resolution and logging for the `dumb://homepage` scheme.
497
498### Fixed
499- Eliminated duplicate accelerator triggers via debouncing.
500- Corrected asset resolution and URL normalization in scheme handler.