1# Changelog
2
3All notable changes to this project will be documented in this file.
4
5## [Unreleased]
6
7## [0.8.0] - 2025-09-17
8
9### Added
10- **GTK color scheme bridge**: Dedicated document-start module keeps WebKit theme in sync with GTK preferences and exposes unified runtime updater
11- **Color scheme build pipeline**: Separate Vite entry produces reusable `color-scheme.js` asset shared between native and injected contexts
12- **Complete Svelte 5 GUI migration**: Omnibox and find components migrated from raw JavaScript to modern Svelte 5 with runes
13- **Tailwind CSS v4 integration**: Unified design system with PostCSS and JIT compilation
14- **TypeScript keyboard service**: Centralized shortcut management with full type safety
15- **Click-anywhere-to-close**: Omnibox closes when clicking outside for better UX
16- **Homepage Svelte 5 component**: New standalone homepage with history display and keyboard shortcuts reference
17- **Page generator system**: Vite plugin for generating dumb:// protocol pages (homepage, config, about) with extensible architecture
18- **History deletion API**: New DELETE endpoint at `/history/delete?id=N` for removing individual history entries
19- **Database migrations**: Embedded migrations now run automatically at startup to keep sqlite schema in sync
20- **Inline CSS type declarations**: Ambient module definitions for raw CSS imports improve TypeScript ergonomics in injected bundles
21- **Global Shadow DOM system**: Unified shadow host utility for component isolation with shared ShadowRoot and CSS reset management
22- **Unified page-world bridge**: Integrated API bridge with event-driven communication between page-world and isolated-world contexts
23
24### Improved
25- **Asset MIME detection**: Expanded scheme handler lookup covers fonts, images, and JSON to prevent incorrect `text/plain` responses
26- **Toast theming**: Runtime theme observer syncs toast styling with the browser's dark mode state for consistent visuals
27- **Shadow host styling**: Injected GUI now adopts Tailwind design tokens inside the shared shadow root with automatic dark-mode mirroring
28- **Omnibox/Find system**: Complete migration from 500-line raw JavaScript to modular Svelte 5 components
29- **Toast notifications**: Migrated from raw JavaScript to Svelte 5 components with proper animations
30- **GUI build pipeline**: Vite-based bundling with hot reload and TypeScript support
31- **Keyboard shortcuts**: Fixed Ctrl+F not working by adding missing 'f' key to keyboard dispatcher
32- **State management**: Proper cleanup between omnibox and find modes prevents state conflicts
33- **Homepage UX**: Enhanced layout with 70/30 flex ratio, compact keyboard shortcuts table, and statistics display
34- **Interactive delete**: History entries show trash icon on hover with smooth fade-out animation on deletion
35- **Top 5 most visited**: New section displaying frequently accessed sites with visit counts
36- **Performance**: Instant shortcut response with pre-mounted DOM elements
37
38### Changed
39- **Homepage icons**: Replaced Lucide dependency with inline SVG/Unicode fallbacks to shrink bundle size while debugging upstream build issues
40- **Major architecture shift**: Removed HTTP API routes in favor of direct WebKit message bridge communication for better performance and reduced complexity
41- **API token support**: Added optional API security configuration with token-based authentication system
42- **Shadow DOM improvements**: Enhanced isolation with WeakSet tracking to prevent duplicate reset injection and global shadow host utility for component sharing
43- **Message handler refactoring**: Unified keyboard shortcut forwarding between native handlers and GUI components with DOM event bridge
44- **Omnibox suggestions**: Native Go-based suggestion computation with search shortcuts and history integration, eliminating HTTP fetch dependencies
45- **Toast styling**: Migrated from Tailwind CSS classes to inline styles within component scope for better Shadow DOM compatibility and isolation
46- **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.
47
48### Fixed
49- **Service worker residue**: Homepage clears stale caches and unregisters old service workers to avoid 404s for legacy `_app` assets
50- **Keyboard debounce**: Native accelerator bridge filters duplicate shortcut events within 120ms for DOM and CGO handlers
51- **Ctrl+F shortcut**: Added missing 'f' key case in keyboard_cgo.go dispatcher
52- **Browser freeze**: Removed infinite loop in mode switching reactive effects
53- **State persistence**: Proper cleanup when switching between Ctrl+L and Ctrl+F modes
54- **Homepage protocol**: Fixed dumb://homepage not working after GUI migration with proper Svelte 5 component and API integration
55- **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
56- **Find mode persistence**: Fixed find view persisting after pressing Esc when reopening with Ctrl+L by ensuring toggle() resets mode to 'omnibox'
57- **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
58- **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
59- **Omnibox accessibility**: Added keyboard navigation support with Tab/Enter activation for suggestion items and proper ARIA attributes for screen readers
60- **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
61
62## [0.7.0] - 2025-09-14
63
64### Added
65- **Content blocking system**: Native WebKit ad blocking with EasyList integration, cosmetic filtering, and filter cache management
66- **Filter cache purging**: New `--filter-cache/-F` flag in purge command
67- **WebKit debug system**: Comprehensive debugging support with configurable categories for troubleshooting WebKit internal errors
68- **Enhanced error handling**: Robust content filter injection with retry mechanisms and graceful fallbacks
69- **Parallel compilation**: Multi-core GCC compilation support for faster builds
70
71### Improved
72- **Content filter timing**: Optimized script injection timing to prevent interference with WebKit preconnect operations
73- **Anti-breakage scriptlets**: Safer JavaScript modifications that avoid WebKit internal conflicts
74- **Build system**: Added parallel compilation with automatic core detection and success indicators
75- **Persistent TLS certificate validation system**:
76  - **Three-option certificate dialog**: "Go Back", "Proceed Once (Unsafe)", and "Always Accept This Site"
77  - **Database-backed certificate storage**: SQLite-based persistence for user certificate decisions with SHA256 certificate hashing
78  - **Smart decision handling**: Automatic application of stored decisions without repeated prompts
79  - **Temporary vs permanent choices**: "Proceed Once" expires after 24 hours, "Always Accept" persists indefinitely
80  - **Seamless user experience**: No more repetitive certificate warnings for trusted sites
81- **Performance-optimized WebKit memory configuration system**:
82  - **New `WebkitMemoryConfig`** configuration section with performance-focused defaults for faster page loading
83  - **Aggressive caching strategy**: `web_browser` cache model with page cache enabled for instant back/forward navigation
84  - **Balanced memory pressure management**: Conservative (40%), strict (60%), and kill (80%) thresholds optimized for performance vs stability
85  - **Smart garbage collection**: 2-minute JavaScript GC intervals with process recycling after 50 page loads
86  - **Reduced monitoring overhead**: 45-second memory monitoring intervals to minimize performance impact
87  - **Environment variable overrides**: All memory settings configurable via `DUMBER_*` environment variables (`DUMBER_CACHE_MODEL`, `DUMBER_MEMORY_CONSERVATIVE`, etc.)
88- **Early crash handling initialization**: Moved crash handler setup to application entry point for better crash recovery
89
90### Changed
91- **Modernized GTK dialog system**: Migrated from deprecated GTK 4.10 dialog functions to modern `GtkAlertDialog` API
92  - **Future-proof implementation**: Eliminated all deprecation warnings by replacing `gtk_message_dialog_*` and `gtk_dialog_*` functions
93  - **Async-first architecture**: Native async dialog handling with proper event loop integration
94  - **Improved accessibility**: Better screen reader support and GTK4 theme integration
95- **Major main.go refactoring**: Massive code reduction from 1071 lines to 61 lines (~95% reduction)
96  - **Extracted browser application logic** to dedicated `internal/app/browser` package for better separation of concerns
97  - **Streamlined entry point**: Clean main function focusing only on CLI vs GUI mode detection and application bootstrapping
98  - **Improved maintainability**: Modular architecture with clear responsibilities between CLI and browser components
99- **Refactored memory configuration architecture**:
100  - Integrated WebKit memory settings into unified config system with Viper environment variable bindings
101  - Eliminated redundant environment variable parsing in favor of centralized configuration management
102  - Simplified webview initialization with direct config-to-WebKit conversion
103- **Improved CLI logs command description**: Enhanced help text for better user experience
104
105## [0.6.0] - 2025-09-12
106
107### Added
108- **Smart AV1 codec negotiation system for YouTube high-resolution streaming**:
109  - **Resolution-aware MediaCapabilities API reporting**: Intelligent codec capability reporting based on video resolution, enabling YouTube to select optimal codecs for different quality levels
110  - **YouTube format manifest manipulation**: Real-time format list reordering to prioritize AV1 for ≤1080p content while allowing VP9 fallback for higher resolutions
111  - **Graduated codec preference system**: Smart localStorage preference (`2048`) instead of forced AV1 (`8192`), giving YouTube flexibility for optimal codec selection
112  - **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
113  - **Configurable AV1 resolution limits**: New `av1_max_resolution` config option with environment variable support (`DUMBER_AV1_MAX_RES`)
114  - **Automatic codec fallback logic**: Seamless VP9 fallback for resolutions where AV1 performance may be suboptimal
115  - **High bitrate streaming support**: Enables premium quality streaming (650+ Mbps) with proper buffer management
116  - Fixes previous limitation where forcing AV1 would cap YouTube playback at 1080p maximum
117- Page refresh functionality with standard keyboard shortcuts:
118  - **Ctrl+R** / **Cmd+R**: Reload current page
119  - **Ctrl+Shift+R** / **Cmd+Shift+R**: Hard reload (bypass cache)
120  - **F5**: Alternative reload key
121  - WebKit integration with proper `webkit_web_view_reload()` and `webkit_web_view_reload_bypass_cache()` calls
122- **Twitch theater mode and fullscreen stability fix**:
123  - **Complete removal of codec interference on Twitch**: Eliminates aggressive codec control that caused theater mode and fullscreen freezing
124  - **Native Twitch codec selection**: Allows Twitch to handle codec negotiation without browser intervention
125  - Fixes theater mode freeze and fullscreen black screen issues on Twitch
126
127### Fixed
128- Zoom level toast no longer shows on every page navigation within the same domain:
129  - Added smart detection to differentiate user-initiated vs programmatic zoom changes
130  - Toast now only appears when manually adjusting zoom or entering a new domain
131  - Prevents annoying notifications during regular browsing within the same site
132- Links with `target="_blank"` now load in current window instead of being ignored:
133  - Added WebKit `create` signal handler to intercept new window requests
134  - Redirects popup/new tab links to current window for seamless single-window browsing
135  - Maintains user experience consistency in tab-less browser architecture
136
137## [0.5.0] - 2025-09-12
138
139### Added
140- Hardware video acceleration with automatic GPU detection:
141  - Multi-vendor GPU detection (AMD, NVIDIA, Intel) using glxinfo, lspci, and sysfs
142  - Automatic VA-API driver selection (radeonsi for AMD, vdpau for NVIDIA, iHD for Intel)
143  - WebKitGTK integration with GStreamer hardware acceleration backends
144  - Environment variable configuration support (LIBVA_DRIVER_NAME, GST_VAAPI_ALL_DRIVERS)
145  - Legacy VA-API fallback mode for compatibility with older systems
146  - Video decoding acceleration for H.264, HEVC, VP9, and AV1 codecs
147  - Significantly reduced CPU usage during video streaming (Twitch, YouTube, etc.)
148  - Smart conflict prevention between legacy and modern VA-API implementations
149- TLS certificate error handling with user confirmation dialog:
150  - Comprehensive certificate information display (subject, issuer, validity dates)
151  - Interactive warning dialog for untrusted certificate authorities
152  - Certificate exception management with per-host persistence
153  - Manual load triggering after user accepts certificate exceptions
154  - Proper integration with WebKitGTK 6.0 network session API
155- Zoom level toast notifications:
156  - Real-time zoom level display with format: "Zoom level: ±X% (Y%)"
157  - Smart debouncing to prevent notification spam during rapid zoom changes
158  - Automatic cleanup of stuck or colliding toast messages
159  - 150ms debounce timer with 2-second display duration
160  - Emergency cleanup function for orphaned toast elements
161- Comprehensive XDG-compliant logging system:
162  - Complete application output capture (Go logs, fmt prints, WebKit C logs)
163  - XDG Base Directory specification compliance (`~/.local/state/dumber/logs/`)
164  - Automatic log rotation with size/age-based cleanup and compression
165  - WebKit CGO log capture with GLib log handler integration
166  - CLI log management commands (`dumber logs list`, `logs tail`, `logs clean`)
167  - File-only logging for cache operations to prevent dmenu interference
168  - Multi-output support with timestamped, tagged log entries
169  - Configurable log levels, formats (text/JSON), and retention policies
170
171### Fixed
172- WebView background set to black to improve user experience during page loads
173- Multiple linting issues and code quality improvements (reduced from 211 to ~150 issues)
174- Omnibox responsive scaling and layout issues:
175  - Fixed over-aggressive viewport scaling that made omnibox disproportionately large at high zoom levels
176  - Resolved input field overflow extending beyond container boundaries
177  - Improved box-sizing model to prevent layout issues
178  - Added conditional separator display (hidden when no search results)
179  - Omnibox now scales proportionally with webpage content across all zoom levels
180- Dmenu history favicon display:
181  - Complete favicon caching system for fuzzel/dmenu integration with real website icons
182  - ICO file support using go-ico library for perfect Windows icon conversion to PNG
183  - Smart brightness detection and color inversion for dark theme visibility
184  - All cached favicons normalized to consistent 32x32 PNG format for uniform display
185  - Anti-aliasing preservation during color inversion to prevent edge noise and pixelation
186  - Asynchronous favicon downloading and caching with 7-day freshness and 30-day cleanup
187  - Fuzzel icon protocol integration (`\0icon\x1f<path>`) for native icon display
188  - Favicon URLs extracted from webpage metadata and stored in database during navigation
189  - Fallback system removed to ensure consistent sizing - shows real favicons or no icon
190  - XDG Base Directory compliance for favicon cache storage
191
192## [0.4.0] - 2025-09-10
193
194### Added
195- High-performance fuzzy cache system for dmenu history:
196  - Binary serialization with memory-mapped files for zero-copy access
197  - Trigram indexing (3-character sequences) for fast candidate filtering  
198  - Prefix trie (compressed tree structure) for prefix matching
199  - Pre-sorted entry indices for O(1) top entries retrieval
200  - Smart cache invalidation with filesystem persistence and background refresh
201  - Comprehensive fuzzy matching algorithms: Jaro-Winkler similarity, Levenshtein distance, tokenized matching
202  - Weighted scoring system combining URL, title, recency, and visit count scores
203  - XDG Base Directory Specification compliance (cache stored in state directory)
204  - Atomic operations for concurrent access control
205  - Dependency injection using interfaces and gomock for testing
206- Purge command for cleaning up dumber data and cache files:
207  - Selective purging with flags: `--database`, `--history-cache`, `--browser-cache`, `--browser-data`, `--state`, `--config`
208  - Clear distinction between history cache (dmenu fuzzy search) and browser cache (WebKit)
209  - Browser data includes cookies, localStorage, sessionStorage
210  - Confirmation prompt with `--force` flag to skip
211  - Targets all data locations: SQLite database, WebKit cache/data, dmenu fuzzy cache, configuration files
212- Ctrl+Shift+C keyboard shortcut to copy current URL to clipboard:
213  - Cross-platform clipboard support with wl-copy (Wayland) and xclip (X11) fallback
214  - Reusable toast notification system for user feedback
215  - Injectable JavaScript component for consistent styling across all websites
216  - Native backend integration for reliable clipboard access
217
218### Changed
219- Dmenu performance dramatically improved: 200ms → 4ms (98% faster)
220- GetTopEntries optimized from O(n log n) to O(1) using pre-sorted indices
221- Cache build time reduced to ~300μs for typical history datasets
222
223### Fixed
224- 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`
225- Eliminated O(n log n) sorting bottleneck on every dmenu call
226- Memory-efficient compact entry storage with minimal footprint
227- Concurrent cache access with proper read/write locking
228- 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
229
230## [0.3.0] - 2025-01-11
231
232### Added
233- WebKit memory controls (opt‑in):
234  - Env vars to tune memory/perf trade‑offs without code changes:
235    - `DUMBER_CACHE_MODEL`, `DUMBER_ENABLE_PAGE_CACHE`
236    - `DUMBER_ENABLE_MEMORY_MONITORING`, `DUMBER_MEMORY_LIMIT_MB`, `DUMBER_MEMORY_POLL_INTERVAL`
237    - `DUMBER_MEMORY_CONSERVATIVE`, `DUMBER_MEMORY_STRICT`, `DUMBER_MEMORY_KILL`
238    - `DUMBER_GC_INTERVAL`, `DUMBER_RECYCLE_THRESHOLD`
239  - Version‑guarded CGO wrappers for memory pressure and GC hooks; safe no‑ops on unsupported WebKitGTK builds.
240 - Find in page (Ctrl/Cmd+F):
241   - Omnibox refactored into a reusable component with dedicated "find" mode.
242   - Highlighting: yellow for all matches; active match in orange for clarity.
243   - Match list with context (right side stops at nearest punctuation: . , ; : -).
244   - Navigation UX:
245     - ArrowUp/Down move selection and scroll the overlay list (page scroll disabled while open).
246     - Enter centers on the active match and closes; Shift+Enter goes to previous; Alt+Enter centers without closing.
247     - Hover focuses input and selects list items; click outside closes the overlay.
248     - Faded overlay with subtle blur when reviewing matches; opacity restores on input focus/typing.
249   - Programmatic API: `OpenFind(initial)`, `FindQuery(q)`, `CloseFind()` on `WebView`.
250
251### Changed
252- Performance‑first defaults retained:
253  - Cache model set to “WebBrowser”, page cache enabled, DevTools available.
254  - No implicit memory pressure or GC enabled by default; all memory tuning is opt‑in.
255
256### Removed
257- Deprecated offline app‑cache calls eliminated (no‑ops) to avoid warnings and brittle builds.
258
259### Fixed
260- Homepage Recent History layout:
261  - Show single-line entries as “{Title} – {Domain} – {URL}”.
262  - Truncate long URLs with a gradient fade; prevent horizontal overflow.
263  - Adjusted styling so URL is darker for readability.
264- Search shortcuts and config interop:
265  - Backend SearchShortcut now serializes `url`/`description` with JSON tags.
266  - Frontend normalizes field casing and extracts base URLs, handling `%s` and `{query}` templates.
267  - Omnibox shortcut parsing now URL-encodes queries and supports `%s` placeholders.
268- Input and navigation reliability (GTK4/WebKitGTK 6):
269  - Capture-phase key controller to ensure accelerators fire consistently.
270  - Do not consume normal left/right clicks; only mouse buttons 8/9 trigger back/forward.
271  - Added Alt+ArrowLeft/Right navigation and enabled two-finger swipe back/forward when supported.
272  - Added Ctrl+scroll zoom in/out; refined accelerator matching so Ctrl− works across layouts.
273  - Removed layout-specific hacks; added diagnostic logs for raw minus key events.
274- Zoom persistence:
275  - Added WebView zoom-changed hook; save per-domain zoom to SQLite on every change.
276  - Log on successful save: “saved X.XX for domain.tld” and on load: “loaded X.XX for domain.tld”.
277  - Load and log initial zoom level on startup and on every navigation.
278- Build/dev ergonomics:
279  - Makefile loads `.env.local`; supports overriding `GOMODCACHE`, `GOCACHE`, `GOTMPDIR` for sandboxed builds.
280 - WebKit CGO hardening and API compatibility:
281   - Apply memory pressure settings to `WebKitNetworkSession` (correct signature) when enabled.
282   - Guarded C wrappers remove deprecation warnings across header variants; builds succeed on WebKitGTK 6.
283
284## [0.2.0] - 2025-09-10
285
286### Added
287- WebKitGTK 6 (GTK4) migration for the built‑in browser window:
288  - WebView constructed via `g_object_new(WEBKIT_TYPE_WEB_VIEW, …)` with a fresh `WebKitUserContentManager`.
289  - `WebKitNetworkSession` with persistent cookies (SQLite) and cache directories.
290- Native UCM messaging restored via `script-message-received::dumber` (JSCValue*), removing the JS fallback bridge.
291- Rendering mode controls:
292  - CLI flag `--rendering-mode=auto|gpu|cpu` and `DUMBER_RENDERING_MODE` env.
293  - In‑app status endpoint `dumb://homepage/api/rendering/status`.
294- Native zoom shortcuts at the WebKit layer (Ctrl/Cmd+=, +, −, 0) and GTK4 input controllers for keyboard/mouse.
295- AZERTY keyboard fix: treat underscore as minus for zoom‑out.
296- Runtime theme synchronization: watch GTK `gtk-application-prefer-dark-theme` and update page color‑scheme live.
297- Makefile target `check-webkit` to print `pkg-config` versions of GTK4/WebKitGTK 6.0/JSC 6.0.
298- Documentation updates:
299  - README now targets WebKitGTK 6 (GTK4) and lists GStreamer package requirements for Arch and Debian/Ubuntu.
300  - CLAUDE notes updated with migration status, GPU/Vulkan path, runtime theme sync, and persistence.
301
302### Changed
303- Build flags and includes now target `webkitgtk-6.0`, `gtk4`, and `javascriptcoregtk-6.0`.
304- GTK4 APIs for windowing and event handling (GtkEventController, GtkGestureClick) replace GTK3/GdkEvent paths.
305
306### Removed
307- Legacy WebKit2GTK constructors and container APIs.
308- JavaScript fallback for UCM message bridging.
309
310### Fixed
311- Header/enum compatibility for hardware acceleration policy and cookie policy across WebKit header variants.
312- Linker error for `on_theme_changed` and gpointer usage in signal connections.
313- Crashy paths mitigated by default “media safe” startup (can be disabled via `DUMBER_MEDIA_SAFE=0`).
314
315### Notes
316- GPU rendering path leverages GTK4’s renderer (Vulkan/OpenGL). Mode `auto` uses GPU when available and falls back gracefully to CPU.
317- WebKitGTK relies on GStreamer; install recommended packages for audio/video (see README).
318
319## [0.1.0] - 2025-09-09
320
321### Added
322- Initial project scaffolding, build system, and dependencies.
323- Unified CLI + GUI architecture with search shortcuts and fuzzy parsing.
324- Wails v3‑alpha browser integration (early phase).
325- Global keyboard controls with script injection (zoom/devtools, etc.).
326- Native WebKit2GTK backend migration:
327  - Custom `dumb://` scheme and `/api` endpoints: `/config`, `/history/recent`, `/history/search`, `/history/stats`.
328  - UserContentManager omnibox injection and theme initialization.
329  - Persistent WebsiteDataManager with cookies.sqlite; per‑domain zoom and title persistence.
330  - Keyboard/mouse accelerators (including mouse back/forward); debounced triggers.
331  - Homepage switched to first‑party API fetches; removed @wailsio/runtime usage.
332- Documentation and licensing: README enhancements and LICENSE added.
333
334### Changed
335- Replaced Wails runtime with native WebKit2GTK CGO bindings and homepage API.
336- Improved asset resolution and logging for the `dumb://homepage` scheme.
337
338### Fixed
339- Eliminated duplicate accelerator triggers via debouncing.
340- Corrected asset resolution and URL normalization in scheme handler.