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