1# Changelog
2
3All notable changes to this project will be documented in this file.
4
5## [Unreleased]
6
7## [0.24.0] - 2026-01-06
8
9### Added
10- **Auto-copy on selection**: Text selected in web pages is automatically copied to the clipboard (like zellij/tmux). Shows brief "Copied to clipboard" toast notification. Configurable via `clipboard.auto_copy_on_selection` (default: true). Fixes #83.
11- **Font availability detection**: On first run, detects available system fonts using fontconfig (`fc-list`) and selects the best font from a fallback chain instead of hardcoding `Fira Sans` / `Fira Code`. Fallback chains: sans-serif (Fira Sans, Noto Sans, DejaVu Sans, Liberation Sans, FreeSans), serif (Noto Serif, DejaVu Serif, Liberation Serif, FreeSerif), monospace (Fira Code, JetBrains Mono, Noto Sans Mono, DejaVu Sans Mono, Liberation Mono, FreeMono). Falls back to generic CSS fonts if none available. Fixes #85.
12- **Stacked pane close buttons**: Close buttons in stacked pane title bars allow closing individual panes directly. Includes proper signal cleanup on removal.
13- **AUR git package CI**: Automated CI workflow to publish `dumber-browser-git` AUR package on push to main branch.
14
15### Changed
16- **Flatpak runtime**: Bumped to GNOME 49 runtime.
17- **Focus method refactored**: `Focus()` now delegates to `ApplyFocusChange()` to ensure stack index is updated when focusing stacked panes.
18
19### Fixed
20- **Flatpak locale crash**: Attempted fix for crash on systems with certain locale configurations by adding proper locale data to the Flatpak bundle.
21- **Stacked pane vertical splits**: Vertical splits from stacked panes now correctly split around the entire stack instead of just the active pane.
22- **Pane border focus**: Fixed stale border remaining on previously hovered pane when using keyboard navigation to switch focus. Fixes #89.
23- **Geometric focus navigation**: Fixed focus jumping to wrong pane when navigating left/right in complex layouts. Navigation now prioritizes panes at the same vertical level (for left/right) or horizontal level (for up/down).
24- **Link status overlay auto-hide**: Link URL overlay now automatically hides after 10 seconds of inactivity instead of staying visible indefinitely. Timer resets when hovering new links. Fixes #82.
25- **Omnibox multi-word search**: History search now matches all words in query (AND logic) and searches both URL and title fields. Prefix matching enabled (e.g., "git iss" matches "github.com/issues"). FTS5 special characters are now sanitized to prevent syntax errors. Results interleave URL and title matches for better balance. Fixes #87.
26
27## [0.23.2] - 2025-12-31
28
29### Added
30- **AUR packaging support**: Dumber is now available on the Arch User Repository (AUR).
31  - `dumber-browser-bin`: Pre-built binary package from GitHub releases (recommended).
32  - `dumber-browser-git`: Build from source, tracks latest git.
33  - Install with `yay -S dumber-browser-bin` or `paru -S dumber-browser-bin`.
34  - Automatic AUR updates via GitHub Actions (1 hour delay after Flatpak build for safety).
35- **Pacman/AUR install detection**: Self-updater is disabled when installed via pacman/AUR (uses `pacman -Qo` to detect package ownership). Shows specific message: "use your package manager instead".
36- **Improved update error messages**: Self-update now shows specific messages for Flatpak ("use 'flatpak update'") and pacman/AUR ("use your package manager") installs instead of generic "binary not writable" error.
37
38## [0.23.1] - 2025-12-30
39
40### Added
41- **Flatpak packaging support**: Dumber is now available as a Flatpak bundle for easy installation with all dependencies included.
42  - `dumber.flatpak` bundle attached to each GitHub release.
43  - Install with `flatpak install --user dumber.flatpak`.
44  - Includes Wayland, GPU, audio, webcam, and PipeWire permissions.
45  - Automatic builds via GitHub Actions on every release.
46- **Flatpak runtime detection**: Skip pkg-config runtime checks when running inside Flatpak sandbox (GNOME runtime provides all dependencies).
47- **Self-updater disabled in Flatpak**: Binary self-update is disabled when running as Flatpak (use Flatpak update mechanisms instead).
48
49## [0.23.0] - 2025-12-30
50
51### Added
52- **macOS-style accent picker**: Long-press (400ms) on keys with accent variants (e, a, o, u, i, c, n, s, y, z) shows a popup with accented character options. Select with number keys 1-9, arrow keys + Enter, or click. Works in omnibox, find bar (Ctrl+F), and web page inputs. Implements dead keys/compose sequence alternative for users who can't use system-level input methods.
53- **Performance profiles (WebKit tuning presets)**: New `performance.profile` setting (`default`, `lite`, `max`, `custom`) plus WebUI support for selecting and editing performance tuning values.
54- **dmenu history enhancements**: New `dumber dmenu --days N` (time-window history) and `--most-visited` (sort by visit count).
55
56### Changed
57- **Color scheme detection architecture**: Refactored theme preference detection into a priority-based `ColorSchemeResolver` with multiple detectors (libadwaita/GTK/gsettings/env) and a change notification API for consistent dark-mode behavior.
58- **dmenu history limiting**: dmenu history limiting is now time-based (days) instead of a fixed max item count.
59- **WebKit dependency**: Bumped `github.com/bnema/puregotk-webkit` to `v0.0.9`.
60
61### Fixed
62- **Dark mode detection on internal pages**: Fixed `dumb://home` and other internal pages showing light theme despite system being in dark mode. Refactored color scheme detection to use a priority-based resolver with proper initialization ordering. The libadwaita detector (highest priority) is now correctly enabled only after `adw.Init()` completes, ensuring WebViews created during bootstrap get the correct theme preference.
63- **External site form theming artifacts**: Removed injected `color-scheme` overrides that caused odd styling in some forms/inputs on regular websites.
64- **WebKit memory pressure stability**: Fixed an assertion by applying strict memory thresholds before conservative thresholds when configuring WebKit’s memory pressure handlers.
65- **Web process termination on perf tuning**: Removed the “memory kill” threshold because it could terminate the web process immediately in some environments.
66- **`dumb://` scheme context mismatch**: Fixed internal pages sometimes using a different WebKit context than expected by always using the default context.
67- **Accent picker Escape behavior**: Fixed cases where Escape wouldn’t dismiss the accent picker after mouse interaction by restoring focus appropriately.
68- **dmenu history days edge case**: Fixed `dumber dmenu --days 0` to mean “all history”, and added validation for invalid day values.
69
70## [0.22.0] - 2025-12-28
71
72### Added
73- **Omnibox bang shortcuts UI**: Typing `!` in the omnibox now shows all configured bangs (search shortcuts) with filtering and Enter-to-autocomplete, plus a header badge when a bang is recognized.
74- **Loading skeleton with app logo**: New panes show a centered 512x512 faded app logo with a spinner while loading, replacing the blank/white flash. Uses `--muted` theme color for the spinner.
75- **App logo favicon for internal pages**: `dumb://` URLs now display the dumber logo as favicon in history, favorites, omnibox suggestions, and dmenu/rofi. WebUI and CLI tools share consistent branding.
76- **Omnibox favorite indicator**: History items that are also bookmarked now display a yellowish left border and subtle background tint in the omnibox. Uses parallel async loading to avoid blocking browser startup.
77- **Mode indicator toaster**: Visual notification showing current modal mode (PANE MODE, TAB MODE, SESSION MODE, RESIZE MODE) at bottom-left corner with mode-specific colors. Configurable via `workspace.styling.mode_indicator_toaster_enabled` (default: true).
78- **Config migration system**: Detects missing config keys when new settings are added in updates and provides tools to add them.
79  - `dumber config status`: Shows config file path and number of new settings available.
80  - `dumber config migrate`: Lists missing keys with types/defaults and adds them to config file.
81  - GUI toast notification on startup when new settings are available (configurable via `update.notify_on_new_settings`).
82- **CLI self-update command**: New `dumber update` command to check for and install updates from the command line.
83  - Interactive spinner animation during check and download phases.
84  - `--force` / `-f` flag to skip version check and reinstall the current version.
85  - Reuses existing auto-update infrastructure (check, download, stage, apply on exit).
86  - Theme-aware styling consistent with other CLI commands.
87- **Config open command**: New `dumber config open` command to open the config file in your preferred editor. Uses `$EDITOR`, then `$VISUAL`, with fallback to nano/vim/vi.
88- **Config schema command**: New `dumber config schema` command that displays all configuration keys with their types, defaults, descriptions, and valid values. Supports `--json` flag for machine-readable output.
89- **CLI gen-docs command**: New `dumber gen-docs` command to generate documentation from CLI command definitions. Supports man pages (installed to `~/.local/share/man/man1/`) and markdown formats. Use `--format markdown` for markdown output or `--output` for custom directory.
90- **Move pane to tab**: New pane-mode actions to move the active pane to another tab.
91  - `Ctrl+P → m`: Opens a tab picker modal.
92  - `Ctrl+P → M`: Moves the active pane to the next tab (creates a new tab if needed).
93  - New config: `workspace.switch_to_tab_on_move` (default: true).
94
95### Changed
96- **Cold start optimization**: Reduced startup time by ~150ms (29% faster) through parallel initialization.
97  - New `internal/bootstrap` package encapsulates all startup orchestration.
98  - `RunParallelInit()` runs 5 goroutines concurrently: directory resolution, pkg-config check, GStreamer check, theme manager creation, and SQLite WASM pre-compilation.
99  - WebView pool prewarming creates one WebView synchronously so first `Acquire()` is instant.
100  - Async session cleanup: stale session marking runs in background, doesn't block startup.
101  - `StartupTimer` logs timing for each bootstrap phase (parallel init, DB/WebKit, app creation).
102  - Database initialization runs in background goroutine while WebKit stack initializes on main thread.
103  - Database path now resolved via `config.GetDatabaseFile()` following clean architecture.
104  - Added connection pool settings optimized for SQLite (`SetMaxOpenConns(1)`, keep-alive).
105  - Reduced `mmap_size` from 30GB to 256MB (reasonable for browser history DB).
106  - Added `PRAGMA foreign_keys = ON` for referential integrity.
107- **Startup deferrals**: Runtime/media checks and SQLite WASM precompile now run after first paint, and DB initialization uses lazy repositories when auto-restore is off to cut cold-start latency further.
108- **Console logging**: Standardized console timestamps to `HH:MM:SS` across bootstrap and session logging.
109
110### Fixed
111- **Omnibox favorite toggle reactivity**: Fixed space key toggle in omnibox not updating UI reactively. Now properly toggles favorites (add if not favorite, remove if favorite) with immediate visual feedback (yellow indicator) and toast notifications. Business logic moved to `ManageFavoritesUseCase.Toggle()` for testability.
112- **Config migration type matching**: Fixed migration incorrectly matching keys of different types (e.g., `_width` int keys with `_color` string keys) during rename detection, preventing value swapping.
113- **Config migrate removes deprecated settings**: Fixed `dumber config migrate` not removing deprecated settings from the config file. Previously deprecated keys were preserved but unused; now they are properly deleted. Supports TOML, YAML, and JSON config formats.
114- **Fullscreen video tab bar**: Fixed tab bar remaining visible during fullscreen video playback. Now hides automatically when entering fullscreen and restores based on normal visibility logic when exiting.
115- **Dark mode navigation flash**: Fixed a brief white flash between the loading skeleton and page content when navigating in dark mode.
116- **Progress bar stuck state**: Added 30-second timeout to progress bar to auto-hide if page load stalls and never completes.
117- **OAuth popup login**: Fixed parent page going blank after OAuth popup closes (e.g., Google login on claude.ai, notion.com). Related WebViews share a web process with their parent; destroying the popup was terminating the shared process, killing the parent. Now skips `TerminateWebProcess()` for popup WebViews.
118- Startup: defer WebView pool prewarm until after initial tab creation to reduce cold-start navigation latency.
119- README CLI examples: updated to match current commands/flags (`purge --force` only, `logs` usage, `sessions list --limit`, removed deprecated `--dmenu` root flag).
120
121## [0.21.0] - 2025-12-26
122
123### Added
124- **Configurable new-pane defaults**: New `workspace.new_pane_url` (default: `about:blank`, supports `dumb://`) and `omnibox.auto_open_on_new_pane` (default: false).
125- **Consume-or-expel panes (very alpha)**: Niri-style pane consume/expel operation to merge a leaf into a sibling stack or expel a stacked pane into a split. Default global shortcuts: `Alt+[` / `Alt+]` (and `Alt+Shift+[` / `Alt+Shift+]`).
126- **Zellij-style pane resize mode**: New modal resize mode (`Ctrl+N`) to adjust split sizes with keyboard (`h/j/k/l` or arrow keys, `+/-` smart resize). Shows a per-pane border indicator and keeps the timeout alive while you resize.
127- **Mouse-driven pane resizing**: Drag split dividers with the mouse; split ratios are persisted in session snapshots (rounded to 2 decimals) and restored on resurrection.
128- **Dynamic window title**: Window title now displays the active pane's page title in format `<Page Title> - Dumber`. Updates when switching tabs/panes or navigating. Truncated at 255 characters.
129- **Link URL status overlay**: Shows destination URL in bottom-left corner when hovering over links, images, or media elements. Standard browser UX pattern with 100ms show delay to avoid flicker and 150ms CSS fade transitions. Configurable via CSS.
130- **Local file path support**: `dumber browse test.html` now correctly opens local HTML files by converting existing file paths to `file://` URLs. Supports absolute paths, relative paths, and `~/` home directory expansion.
131- **Auto-update system**: Automatic update checking and self-updating binary replacement following clean architecture.
132  - **Update check on startup**: Async check against GitHub releases API (configurable via `update.enable_on_startup`, default: true).
133  - **Toast notifications**: Non-intrusive auto-dismiss notifications for update availability.
134  - **Auto-download**: Optional background download with binary staging (configurable via `update.auto_download`, default: false).
135  - **Binary self-update**: Atomic binary replacement on clean exit with `.old` backup. Only works if binary is user-writable (e.g., `~/.local/bin/`).
136  - **CLI update check**: `dumber about` now displays update availability.
137  - **Version-less release archives**: Goreleaser now produces `dumber_linux_x86_64.tar.gz` (version in directory inside) enabling stable GitHub `/releases/latest/download/` URLs.
138- **Session management & resurrection**: Zellij-inspired session management system allowing users to save, list, and restore browser sessions.
139  - **Automatic session snapshots**: Debounced state saving (configurable interval, default 5s) captures tabs, panes, splits, stacks, URLs, titles, and zoom levels.
140  - **Session Manager modal**: Access via `Ctrl+O → s/w` or `Ctrl+Shift+S` to browse and restore sessions with inline preview of tabs and panes.
141  - **Session mode**: New modal mode (`Ctrl+O`) with purple border indicator, similar to pane/tab modes.
142  - **CLI session commands**: `dumber sessions` opens interactive TUI browser; `dumber sessions list` shows saved sessions; `dumber sessions restore <id>` resurrects a session in a new window; `dumber sessions delete <id>` removes a session.
143  - **Session purging**: Integrated into `dumber purge` command for cleaning up old session data. Simplified UI with single "Sessions" toggle instead of individual selection.
144  - **Automatic session cleanup**: Sessions are automatically cleaned up on startup based on `max_exited_sessions` (default: 50) and `max_exited_session_age_days` (default: 7 days).
145  - **Configuration options**: `session.auto_restore`, `session.snapshot_interval_ms`, `session.max_exited_sessions`, `session.max_exited_session_age_days`, plus session mode shortcuts and styling.
146
147### Fixed
148- **Alt/Ctrl+number shortcuts on non-QWERTY keyboards**: Fixed Alt+1-9/0 tab switching and Ctrl+1-9/0 omnibox shortcuts not working on AZERTY, QWERTZ, Dvorak, and other non-QWERTY keyboard layouts. Uses hardware keycodes as fallback when keyval lookup fails, enabling shortcuts to work based on physical key position regardless of layout.
149- **Idle inhibition leak on pane close**: Fixed D-Bus idle inhibit request not being released when closing a pane/tab while in fullscreen or playing audio. The inhibition would remain active until the app exited. Now properly tracks fullscreen and audio state and releases inhibition before destroying WebView.
150- **Audio-based idle inhibition**: Extended idle inhibition to also activate when a page is playing audio (e.g., video/music playback), not just in fullscreen mode. Uses WebKit's `notify::is-playing-audio` signal. The inhibitor uses refcounting, so both fullscreen and audio can be active simultaneously.
151
152## [0.20.1] - 2025-12-25
153
154### Fixed
155- **Stacked pane favicon and title updates**: Fixed favicon and title not updating in stacked pane title bars by tracking pane IDs in StackedView and properly routing update events to the correct pane.
156- **WebKit process leak on pane close**: Fixed zombie WebKit web processes not being terminated when panes were closed. `WebView.Destroy()` now properly calls `TerminateWebProcess()` and unparents GTK widgets, freeing GPU resources (VA-API, DMA-BUF, GL contexts). This should significantly improve video playback stability and reduce memory usage when opening/closing many panes.
157- **White flash on navigation**: Eliminated white page flash when navigating in dark mode by setting WebView background color to match theme and hiding WebView until content commits.
158- **Dark mode detection on websites**: Fixed `prefers-color-scheme: dark` detection by improving matchMedia query normalization and adding proper event listener stubs. Sites like Reddit now correctly detect dark mode preference.
159- **Alt+number tab switching**: Fixed Alt+1-9 shortcuts not working when WebView has focus by using GtkShortcutController with global scope instead of EventControllerKey.
160- **System locking during fullscreen video**: Added idle inhibition via XDG Desktop Portal when WebView enters fullscreen mode. Prevents system from locking/sleeping during fullscreen video playback on Wayland (works with all compositors: GNOME, KDE, sway, hyprland, etc.).
161- **Navigation performance**: Significantly faster page navigation through multiple optimizations:
162  - Async history recording via background worker (SQLite writes no longer block GTK main thread)
163  - LRU cache for per-domain zoom levels (repeat visits skip database queries)
164  - Async favicon preload (cache lookup doesn't block navigation start)
165  - Progress callback throttling at ~60fps (reduces UI callback overhead)
166  - Increased WebView pool prewarm from 2 to 4 for faster initial tab creation
167
168### Changed
169- **Custom color picker and confirm dialogs**: Replaced native GTK color picker and confirm dialogs with custom Svelte components using bits-ui AlertDialog. Fixes Wayland compatibility issues where native dialogs would not display properly (fixes #12).
170- **GSK renderer default**: Changed default from `vulkan` to `auto` to let GTK choose the best renderer and avoid potential DMA-BUF synchronization conflicts with WebKit.
171- **Removed invalid GStreamer config**: Removed `video_buffer_size_mb` and `queue_buffer_time_sec` config options as these were not valid GStreamer environment variables (they are element properties that cannot be set via env vars).
172
173### Added
174- **Performance config section**: New `performance` config section with `zoom_cache_size` (default: 256) and `webview_pool_prewarm_count` (default: 4) for tuning. Not exposed in UI but can be set in config file.
175- **Clean-architecture rewrite (pure Go)**: Major refactor to a ports/adapters style architecture with explicit `domain`, `application` (use cases), `infrastructure`, and `ui` layers.
176- **New CLI commands**: `doctor` (runtime dependency checks), `about` (build info), `setup` (desktop integration), plus expanded `purge` with an interactive TUI.
177- **WebUI config improvements**: Search shortcut management (CRUD) and reset-to-defaults support.
178- **Find-in-page**: New find UI and shortcut handling.
179- Migrated GUI stack to `puregotk` + `puregotk-webkit` and disabled CGO for pure Go compilation.
180- **Omnibox rewrite**: Replaced injected Svelte/JS omnibox with a native GTK4 widget overlay.
181- Startup defers non-critical work, adds DNS prefetching and a warmed WebView pool for faster tab/pane creation.
182- SQLite WAL checkpoints happen less frequently to reduce contention.
183- Content filters skip caching invalid rules; EasyList parser prefers if-domain over unless-domain.
184- Workspace border overlays can now receive pointer input.
185- Session-based logging and session management for CLI/GUI runs.
186
187## [0.15.0] - 2025-11-29
188
189### Added
190- **Inline URL suggestions**: Fish/zsh-style ghost text completion in omnibox. As you type, shows grayed-out URL completion from history. Accept with Right Arrow (full) or Ctrl+Right (word). Ctrl+Y also accepts full suggestion. Uses trie-based prefix search with debounced queries for smooth typing.
191- **Filter list auto-update**: Async version checking using HTTP HEAD request with ETag. 2-minute startup delay, skips if checked within 24 hours. Stores version per filter list.
192- **Configurable filter lists**: New `content_filtering.filter_lists` config option. Defaults include EasyList, EasyPrivacy, and uBlock filters (annoyances, quick-fixes).
193- **Demo video**: Added feature showcase video to README (docs/media/dumber-demo.mp4).
194- **Page load progress bar**: Thin animated indicator at window bottom showing web page loading progress. Tracks WebView load events with gradient animation, auto-hides when complete.
195- **Omnibox initial history display**: Configurable behavior when opening empty omnibox via `omnibox.initial_behavior` ("recent", "most_visited", "none"). Shows initial history on open and when input is cleared. Default: recent visits.
196- **Omnibox keyboard blocking**: Prevent page scripts from stealing focus while omnibox is active.
197- **Configurable border widths**: Added `pane_mode_border_width` and `tab_mode_border_width` configuration options (default: 4px) for full border customization.
198- **Content filter caching**: Centralized content blocking service compiles filters once and caches them for instant reuse across all WebViews.
199- **CLI purge enhancements**: Separate `--cookies` and `--history` flags for granular data deletion.
200- **URL normalization**: Consistent URL storage across browser, CLI, and favicon services (strips trailing slashes, normalizes schemes).
201
202### Fixed
203- **Filter compilation race condition**: Fixed concurrent map crash when multiple filter lists compile simultaneously by using local converter instead of shared state.
204- **Omnibox search performance**: Debounce search with 2-character minimum threshold to prevent UI freeze on first keystroke. Applies to both URL/history search and find-in-page modes.
205- **Omnibox flash on load**: Load the injected GUI bundle at document-start and initialize the omnibox as soon as DOM is ready, ensuring it is ready without briefly flashing during page startup or new pane creation.
206- **Zoom toast suppression**: Suppress zoom toast notifications during browser initialization to prevent UI flash.
207- **Cosmetic filter injection**: Inject rules immediately and fix selector normalization for better ad blocking.
208
209### Changed
210- **Refactor keyboard blocking**: Move logic to main-world.ts, reduce handler.go verbosity.
211- **Border overlay architecture**: All borders (active pane, pane mode, tab mode) now use GTK overlay pattern preventing layout shifts when borders appear/disappear. Removed inactive border styling - only active panes show borders.
212- **Simplified border configuration**: Removed `inactive_border_width`, `inactive_border_color`, `show_stacked_title_border`, and `border_radius` config options. All borders are now overlay-based with no layout impact.
213- **Remove Turnstile workaround**: Removed temporary Cloudflare Turnstile CORS allowlist (no longer needed).
214
215## [0.14.1] - 2025-11-18
216
217### Added
218- **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.
219- **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).
220- **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.
221
222### Fixed
223- **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.
224- **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).
225- **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.
226- **Video codec fallback**: Unblocked VP8 codec to allow fallback for ad segments, preventing playback interruptions when ads use different codecs than main content.
227- **Video buffering**: Increased buffer sizes (64 MB, 20s) to handle bursty Twitch/AV1 segments and improve streaming reliability on variable bitrate platforms.
228
229### Changed
230- **Console output cleanup**: Disabled WebKit console.log() messages to stdout to prevent page script spam. DevTools console (F12) still shows all messages.
231- **Content filtering configuration**: Refactored `content_filtering_whitelist` into structured `content_filtering` config with `enabled` boolean and `whitelist` array for better organization.
232
233## [0.14.0] - 2025-11-18
234
235### Added
236- **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).
237- **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.
238- **Click-to-activate stacked panes**: Click on any collapsed title bar to instantly activate that pane. Uses GTK4 gesture clicks for native interaction feel.
239- **Title bar visual separators**: Subtle 1px borders between stacked title bars. Theme-aware colors automatically adjust for light/dark mode.
240- **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).
241- **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.
242- **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.).
243- **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.
244- **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.
245- **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"`).
246
247### Changed
248- **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.
249- **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.
250- **Code cleanup**: Removed dead code files and emojis from GUI modules
251- **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).
252- **Omnibox spacing**: Increased vertical spacing between suggestion items from 0.65rem to 0.85rem for better readability
253- **Smart Escape key**: First press clears input text, second press closes omnibox. Empty input closes immediately.
254
255### Fixed
256- **Ctrl+Tab shortcuts**: Fixed focus cycling behavior, now properly switches between tabs
257- **Active tab visibility**: Fixed identical styling - active tab now clearly visible with distinct gray shade
258- **AZERTY keyboard support**: Alt+number shortcuts now work on all keyboard layouts using hardware keycodes
259- **Keyboard layout detection**: Fixed always detecting "en" - now correctly detects fr/de/etc layouts
260- **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.
261- **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`.
262- **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.
263- **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.
264- **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.
265
266## [0.13.0] - 2025-10-24
267
268### Added
269- **Color scheme config**: `appearance.color_scheme` setting to force dark/light theme (`"prefer-dark"`, `"prefer-light"`, `"default"`)
270- **DNS prefetch**: Added capability to prefetch DNS for links to speed up future requests
271- **Page cache (bfcache)**: Enabled WebKit back/forward cache for instant navigation
272- **Smooth scrolling**: Enabled WebKit smooth scrolling for better UX
273- **JSON Schema**: Auto-generated config schema for IDE autocompletion and validation
274- **Parallel cache loading**: Zoom, certificate, and fuzzy caches load concurrently at startup (<100ms target)
275- **Certificate validation cache**: In-memory cache for TLS certificate decisions with graceful shutdown flushing
276
277### Changed
278- **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
279- **Zoom performance**: In-memory cache eliminates database reads during page transitions
280- **History writes**: Batched writes with background processor (flush every 5s or 50 items) to reduce I/O overhead
281- **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.
282- **Cache management**: Graceful cache flushing on shutdown prevents data loss; startup timing instrumentation with performance warnings
283
284### Fixed
285- **Graceful shutdown deadlock**: Resolved GTK main loop deadlock on Ctrl+Q by removing mutex locks and GTK calls after main loop exit
286- **CSS provider error handling**: Now properly handles errors from GTK CSS provider with logging
287- **Cache operations**: Added context timeouts to cache flush and history queue operations for graceful failure
288- Command typos now show proper error instead of opening in browser
289- History queue now uses buffered channel to prevent blocking on shutdown
290
291## [0.12.1] - 2025-10-18
292
293### Added
294- **Favicon refactoring**: WebKitGTK FaviconDatabase as single source of truth, removing fragile file-based cache and ico/bmp conversion dependencies
295  - Native favicon detection and automatic PNG export at 32x32 for CLI (dmenu)
296  - SVG favicon rasterization support
297  - Async texture loading with callbacks for non-blocking UI updates
298  - FaviconService handles favicon collection across all panes
299
300### Changed
301- Removed old favicon cache system (go-ico, go-bmp dependencies)
302- Simplified omnibox favicon handling: uses database favicon_url only
303
304### Fixed
305- Mouse button navigation: Added support for hardware mouse buttons 8/9 (back/forward)
306- Touchpad gestures: Two-finger horizontal swipe for back/forward navigation
307- Web app shortcuts: Ctrl+C, Ctrl+V, Ctrl+A now work in Gmail, VSCode web, etc.
308- Dark mode flash on startup: Set GTK dark theme preference and WebView background color before window/content creation
309- Cmd+Q and window close button now trigger graceful shutdown instead of killing the browser process
310- WebView cleanup: Properly destroy WebViews to prevent memory leaks and duplicate handler registrations when closing stacked panes
311- CLI help: Running `dumber` without arguments now shows available commands (use `--gui` or `browse` to launch GUI)
312
313## [0.12.0] - 2025-10-16
314
315### Added
316- **Native favicon support**: WebKit FaviconDatabase integration with automatic detection and caching for all panes
317- ENV=dev support to isolate test builds from production config/data in .dev/dumber/ directory
318- Content filtering whitelist config (Twitch enabled by default)
319- `dumber config` command to open config file in $VISUAL/$EDITOR or print path with `--path`
320- **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
321- **Popup behavior configuration**: Added `popup_behavior` config with four modes: `split` (default), `stacked`, `tabbed`, and `windowed` for user control over popup placement
322- **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.
323- **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
324
325### Changed
326- **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
327- **GUI bootstrap refactoring**: Extracted 400+ lines of common initialization logic into reusable bootstrap.ts module shared between injected pages and special schemes (homepage, etc.)
328- **Workspace pane mode**: Moved ~450 lines of JavaScript state machine to Go backend for more reliable keyboard handling and eliminated race conditions between webviews
329
330### Fixed
331- **TLS certificate validation restored**: Re-implemented persistent certificate error handling (broken during gotk4 migration)
332  - Interactive three-option dialog: "Go Back", "Proceed Once (Unsafe)", and "Always Accept This Site"
333  - SQLite-based hostname decision storage (hostname-only matching - GIO certificate properties are unstable)
334  - Smart expiration: "Proceed Once" temporary (not stored), "Always Accept" persists for 30 days
335  - Automatic cleanup of expired validations on application startup
336  - **Known issue**: Accepted certificates not pre-loaded into WebKit session on startup - stored decisions only apply when TLS error occurs again
337- **Content blocking restored**: Re-implemented WebKit native ad/tracker blocking (broken during gotk4 migration) using UserContentFilterStore API
338- **Script injection spam**: Fixed 100+ duplicate "Sending color palettes" messages by injecting scripts only in top frame instead of all iframes
339- **Favicon race conditions**: Eliminated duplicate downloads and file handle errors via mutex protection and proper handler registration
340- **Homepage theme switching**: Fixed color palette application for proper light/dark mode transitions
341- **Workspace pane borders**: Hide active pane border when only one pane exists to match Zellij UX
342- Enabled missing WebKitGTK6 features: WebRTC, MediaSource, LocalStorage, WebAudio, MediaStream, Clipboard
343- Cosmetic filter duplicate injection in frames
344- Config file duplicate keys (snake_case/camelCase) by using Viper's SafeWriteConfigAs
345- Config not reading newly created default config file
346- Config writing to disk on every load/reload
347- **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
348- **GTK focus event duplicates**: Added timestamp-based deduplication to prevent multiple focus enter/leave events in the same millisecond from WebKitGTK nested widgets
349- **Popup close behavior**: Fixed app exit when closing popups by excluding them from remaining pane count check
350- **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
351- **Stacked pane active border**: Fixed active border incorrectly appearing on stacked pane containers instead of individual panes
352- **Stacked pane creation**: Fixed premature Realize() call causing widget lifecycle issues during stack creation
353- **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
354- **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
355
356## [0.11.0] - 2025-10-07
357
358### Added
359- **Auto-open omnibox on blank panes**: Omnibox automatically opens when a new pane is created with about:blank, providing immediate search/navigation access
360- **Configurable default zoom**: Added `default_zoom` config (defaults to 1.2/120%). Per-domain zoom still overrides this
361- **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
362- **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
363- **Stacked pane favicons**: Title bars display site favicons with async caching. Click title bars to switch between stacked panes
364- **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
365- **Search shortcut badges**: Visual badges in omnibox input showing active shortcut prefix (e.g., "gh:", "npm:") with description labels
366- **Search shortcuts API**: Frontend bridge to fetch search shortcuts from backend `/api/config` endpoint with automatic normalization
367
368### Changed
369- **Terminal-style UI theme**: Monospace fonts (JetBrains Mono, Fira Code), sharp corners (no border-radius), dashed borders, adjusted shadows and spacing throughout omnibox components
370- **History suggestions**: Use favicon from database when available, omit automatic search shortcuts from suggestions (rely on explicit prefix commands)
371- **Search shortcuts defaults**: Updated defaults to include ddg, go, mdn, npm packages while reordering others
372- **Chrome user agent**: Updated to version 141.0.0.0 for better site compatibility
373- **CSS color system**: Removed hardcoded theme colors, now use dynamic CSS custom properties from Go-injected palette
374- **History item layout**: Removed "• domain" from titles, now highlight domain within the full URL using same color as title text
375- **Quick access logic**: Removed 20-item limit, now shows all sites with 2+ visits (pinned sites bypass visit requirement)
376- **History pagination**: Show 15 items initially (up from 10) with "Show N more" button
377- **Homepage layout**: Redesigned with improved visual hierarchy and dynamic color tokens
378- **Favicon handlers**: All webviews now register favicon change handlers for consistent caching across panes
379
380### Fixed
381- **Mobile URL overflow**: Fixed long URLs breaking layout on narrow screens by adding proper width constraints and CSS fixes
382- **GTK shortcut GLib-CRITICAL error**: Fixed NULL string assertion in shortcut callback system
383- **SVG favicon handling**: Skip SVG favicons to prevent conversion errors (no raster conversion dependencies)
384- **Focus management architecture**: Refactored workspace focus system from `active` field to `currentlyFocused` with dedicated FocusManager for improved reliability and consistency across pane operations
385- **Stacked pane focus conflicts**: Fixed focus stealing issues in stacked panes by implementing focus-aware navigation that preserves active pane when spawning siblings
386- **WebView title updates**: Enhanced webview title change handling to properly update stacked pane title bars in addition to database storage
387- **GTK4 widget lifecycle**: Improved widget parenting/unparenting operations with proper GTK4 validation and automatic cleanup to prevent critical warnings
388- **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
389- **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
390
391## [0.10.0] - 2025-09-24
392
393### Added
394- **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
395- **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
396
397### Changed
398- **Homepage redesign**: Brutal design with component-scoped styling, dynamic height matching, inline domain-URL layout with fade effects, and tighter spacing
399
400### Fixed
401- **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
402- **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
403- **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
404- **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
405- **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
406- **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
407- **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
408- **Workspace architecture**: Simplified focus tracking by removing URI change handlers and pane ID injection complexity, improving reliability and reducing codebase by 85 lines
409- **WebView ID propagation**: Added webview ID request/response mechanism for stub builds to ensure JavaScript side knows its webview ID for proper focus validation
410- **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)
411- **GTK window background**: Added theme-aware window and pane background colors to prevent white bleeding through transparent elements
412- **Print dialog window handling**: Fixed GTK window destroy errors during WebView cleanup by only destroying windows when CreateWindow was actually enabled
413- **Modifier key logging noise**: Filtered out Ctrl, Shift, Alt, and Super key presses from accelerator miss logging to reduce console spam
414
415## [0.9.0] - 2025-09-22
416
417### Added
418- **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)
419- **Multi-pane WebView architecture**: Container-based widget management with proper reparenting, lifecycle handling, and per-pane controllers
420- **Window-level global shortcuts**: Centralized shortcut handling to prevent conflicts between multiple WebView instances
421- **Workspace configuration**: New config section with Zellij controls toggle, pane mode bindings, tab shortcuts, and popup behavior settings
422- **Configurable workspace styling**: Pane border appearance (width, color, transition duration, radius) now customizable via config with proper viewport stability
423- **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
424- **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
425- **Advanced popup deduplication system**: Intelligent duplicate popup prevention with SHA256 fingerprinting and 200ms debounce window to eliminate popup spam
426- **OAuth auto-close integration**: RFC 6749 compliant OAuth callback detection with automatic popup closure for seamless authentication flows
427- **Cross-WebView popup communication**: localStorage-based parent-popup bridge enabling proper `window.opener` functionality in tiling workspace environment
428- **WebView identity tracking**: Unique WebView ID system for precise popup targeting and enhanced debugging capabilities
429
430### Improved
431- WebKit integration now forces GPU compositing by default while still honoring explicit config overrides.
432- Smooth scrolling is enabled (when supported) so wheel and gesture animations feel closer to Chromium/Firefox.
433- 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.
434- Added optional DOM-level zoom (enabled by default) to avoid native viewport rescaling; falls back to WebKit zoom if the CSS path fails.
435- 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%.
436- Native accelerator bridge debounces duplicate GTK key events earlier, so Ctrl±/Ctrl+0 only fires once per physical key press.
437- Omnibox-triggered navigations now reuse the navigation controller, so saved zoom levels are applied before first paint and redundant lookups are avoided.
438- Configuration loading writes the missing `use_dom_zoom` flag into existing config files so DOM zoom defaults persist without manual edits.
439- Omnibox UI now relies on shared Tailwind theme tokens and the injected color-scheme service for light/dark parity.
440- Omnibox overlay now self-heals if hostile pages remove the injected shadow host, ensuring Ctrl/Cmd+L works everywhere.
441- Navigation shortcuts changed from Alt+Arrow to Ctrl/Cmd+Arrow for better workspace compatibility.
442- GUI components now support workspace-aware focus management with pane-specific event handling.
443- **Global zoom shortcuts**: Unified zoom handling at window level (Ctrl+/=/0/-) ensuring zoom applies to currently active pane in multi-pane workspace
444- **Workspace focus management**: Enhanced focus throttling (100ms) and active state tracking to prevent infinite loops and conflicts between panes
445- **Popup management**: Intelligent popup vs tab detection based on window features, with improved auto-close logic for OAuth and login flows
446- **Console logging**: WebView ID context injection for better debugging and log correlation across multiple panes
447
448### Changed
449- **Zoom shortcuts architecture**: Moved from per-WebView registration to centralized window-level handling for consistency with other global shortcuts
450
451## [0.8.0] - 2025-09-17
452
453### Added
454- **GTK color scheme bridge**: Dedicated document-start module keeps WebKit theme in sync with GTK preferences and exposes unified runtime updater
455- **Color scheme build pipeline**: Separate Vite entry produces reusable `color-scheme.js` asset shared between native and injected contexts
456- **Complete Svelte 5 GUI migration**: Omnibox and find components migrated from raw JavaScript to modern Svelte 5 with runes
457- **Tailwind CSS v4 integration**: Unified design system with PostCSS and JIT compilation
458- **TypeScript keyboard service**: Centralized shortcut management with full type safety
459- **Click-anywhere-to-close**: Omnibox closes when clicking outside for better UX
460- **Homepage Svelte 5 component**: New standalone homepage with history display and keyboard shortcuts reference
461- **Page generator system**: Vite plugin for generating dumb:// protocol pages (homepage, config, about) with extensible architecture
462- **History deletion API**: New DELETE endpoint at `/history/delete?id=N` for removing individual history entries
463- **Database migrations**: Embedded migrations now run automatically at startup to keep sqlite schema in sync
464- **Inline CSS type declarations**: Ambient module definitions for raw CSS imports improve TypeScript ergonomics in injected bundles
465- **Global Shadow DOM system**: Unified shadow host utility for component isolation with shared ShadowRoot and CSS reset management
466- **Unified page-world bridge**: Integrated API bridge with event-driven communication between page-world and isolated-world contexts
467
468### Improved
469- **Asset MIME detection**: Expanded scheme handler lookup covers fonts, images, and JSON to prevent incorrect `text/plain` responses
470- **Toast theming**: Runtime theme observer syncs toast styling with the browser's dark mode state for consistent visuals
471- **Shadow host styling**: Injected GUI now adopts Tailwind design tokens inside the shared shadow root with automatic dark-mode mirroring
472- **Omnibox/Find system**: Complete migration from 500-line raw JavaScript to modular Svelte 5 components
473- **Toast notifications**: Migrated from raw JavaScript to Svelte 5 components with proper animations
474- **GUI build pipeline**: Vite-based bundling with hot reload and TypeScript support
475- **Keyboard shortcuts**: Fixed Ctrl+F not working by adding missing 'f' key to keyboard dispatcher
476- **State management**: Proper cleanup between omnibox and find modes prevents state conflicts
477- **Homepage UX**: Enhanced layout with 70/30 flex ratio, compact keyboard shortcuts table, and statistics display
478- **Interactive delete**: History entries show trash icon on hover with smooth fade-out animation on deletion
479- **Top 5 most visited**: New section displaying frequently accessed sites with visit counts
480- **Performance**: Instant shortcut response with pre-mounted DOM elements
481
482### Changed
483- **Homepage icons**: Replaced Lucide dependency with inline SVG/Unicode fallbacks to shrink bundle size while debugging upstream build issues
484- **Major architecture shift**: Removed HTTP API routes in favor of direct WebKit message bridge communication for better performance and reduced complexity
485- **API token support**: Added optional API security configuration with token-based authentication system
486- **Shadow DOM improvements**: Enhanced isolation with WeakSet tracking to prevent duplicate reset injection and global shadow host utility for component sharing
487- **Message handler refactoring**: Unified keyboard shortcut forwarding between native handlers and GUI components with DOM event bridge
488- **Omnibox suggestions**: Native Go-based suggestion computation with search shortcuts and history integration, eliminating HTTP fetch dependencies
489- **Toast styling**: Migrated from Tailwind CSS classes to inline styles within component scope for better Shadow DOM compatibility and isolation
490- **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.
491
492### Fixed
493- **Service worker residue**: Homepage clears stale caches and unregisters old service workers to avoid 404s for legacy `_app` assets
494- **Keyboard debounce**: Native accelerator bridge filters duplicate shortcut events within 120ms for DOM and CGO handlers
495- **Ctrl+F shortcut**: Added missing 'f' key case in keyboard_cgo.go dispatcher
496- **Browser freeze**: Removed infinite loop in mode switching reactive effects
497- **State persistence**: Proper cleanup when switching between Ctrl+L and Ctrl+F modes
498- **Homepage protocol**: Fixed dumb://homepage not working after GUI migration with proper Svelte 5 component and API integration
499- **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
500- **Find mode persistence**: Fixed find view persisting after pressing Esc when reopening with Ctrl+L by ensuring toggle() resets mode to 'omnibox'
501- **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
502- **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
503- **Omnibox accessibility**: Added keyboard navigation support with Tab/Enter activation for suggestion items and proper ARIA attributes for screen readers
504- **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
505
506## [0.7.0] - 2025-09-14
507
508### Added
509- **Content blocking system**: Native WebKit ad blocking with EasyList integration, cosmetic filtering, and filter cache management
510- **Filter cache purging**: New `--filter-cache/-F` flag in purge command
511- **WebKit debug system**: Comprehensive debugging support with configurable categories for troubleshooting WebKit internal errors
512- **Enhanced error handling**: Robust content filter injection with retry mechanisms and graceful fallbacks
513- **Parallel compilation**: Multi-core GCC compilation support for faster builds
514
515### Improved
516- **Content filter timing**: Optimized script injection timing to prevent interference with WebKit preconnect operations
517- **Anti-breakage scriptlets**: Safer JavaScript modifications that avoid WebKit internal conflicts
518- **Build system**: Added parallel compilation with automatic core detection and success indicators
519- **Persistent TLS certificate validation system**:
520  - **Three-option certificate dialog**: "Go Back", "Proceed Once (Unsafe)", and "Always Accept This Site"
521  - **Database-backed certificate storage**: SQLite-based persistence for user certificate decisions with SHA256 certificate hashing
522  - **Smart decision handling**: Automatic application of stored decisions without repeated prompts
523  - **Temporary vs permanent choices**: "Proceed Once" expires after 24 hours, "Always Accept" persists indefinitely
524  - **Seamless user experience**: No more repetitive certificate warnings for trusted sites
525- **Performance-optimized WebKit memory configuration system**:
526  - **New `WebkitMemoryConfig`** configuration section with performance-focused defaults for faster page loading
527  - **Aggressive caching strategy**: `web_browser` cache model with page cache enabled for instant back/forward navigation
528  - **Balanced memory pressure management**: Conservative (40%), strict (60%), and kill (80%) thresholds optimized for performance vs stability
529  - **Smart garbage collection**: 2-minute JavaScript GC intervals with process recycling after 50 page loads
530  - **Reduced monitoring overhead**: 45-second memory monitoring intervals to minimize performance impact
531  - **Environment variable overrides**: All memory settings configurable via `DUMBER_*` environment variables (`DUMBER_CACHE_MODEL`, `DUMBER_MEMORY_CONSERVATIVE`, etc.)
532- **Early crash handling initialization**: Moved crash handler setup to application entry point for better crash recovery
533
534### Changed
535- **Modernized GTK dialog system**: Migrated from deprecated GTK 4.10 dialog functions to modern `GtkAlertDialog` API
536  - **Future-proof implementation**: Eliminated all deprecation warnings by replacing `gtk_message_dialog_*` and `gtk_dialog_*` functions
537  - **Async-first architecture**: Native async dialog handling with proper event loop integration
538  - **Improved accessibility**: Better screen reader support and GTK4 theme integration
539- **Major main.go refactoring**: Massive code reduction from 1071 lines to 61 lines (~95% reduction)
540  - **Extracted browser application logic** to dedicated `internal/app/browser` package for better separation of concerns
541  - **Streamlined entry point**: Clean main function focusing only on CLI vs GUI mode detection and application bootstrapping
542  - **Improved maintainability**: Modular architecture with clear responsibilities between CLI and browser components
543- **Refactored memory configuration architecture**:
544  - Integrated WebKit memory settings into unified config system with Viper environment variable bindings
545  - Eliminated redundant environment variable parsing in favor of centralized configuration management
546  - Simplified webview initialization with direct config-to-WebKit conversion
547- **Improved CLI logs command description**: Enhanced help text for better user experience
548
549## [0.6.0] - 2025-09-12
550
551### Added
552- **Smart AV1 codec negotiation system for YouTube high-resolution streaming**:
553  - **Resolution-aware MediaCapabilities API reporting**: Intelligent codec capability reporting based on video resolution, enabling YouTube to select optimal codecs for different quality levels
554  - **YouTube format manifest manipulation**: Real-time format list reordering to prioritize AV1 for ≤1080p content while allowing VP9 fallback for higher resolutions
555  - **Graduated codec preference system**: Smart localStorage preference (`2048`) instead of forced AV1 (`8192`), giving YouTube flexibility for optimal codec selection
556  - **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
557  - **Configurable AV1 resolution limits**: New `av1_max_resolution` config option with environment variable support (`DUMBER_AV1_MAX_RES`)
558  - **Automatic codec fallback logic**: Seamless VP9 fallback for resolutions where AV1 performance may be suboptimal
559  - **High bitrate streaming support**: Enables premium quality streaming (650+ Mbps) with proper buffer management
560  - Fixes previous limitation where forcing AV1 would cap YouTube playback at 1080p maximum
561- Page refresh functionality with standard keyboard shortcuts:
562  - **Ctrl+R** / **Cmd+R**: Reload current page
563  - **Ctrl+Shift+R** / **Cmd+Shift+R**: Hard reload (bypass cache)
564  - **F5**: Alternative reload key
565  - WebKit integration with proper `webkit_web_view_reload()` and `webkit_web_view_reload_bypass_cache()` calls
566- **Twitch theater mode and fullscreen stability fix**:
567  - **Complete removal of codec interference on Twitch**: Eliminates aggressive codec control that caused theater mode and fullscreen freezing
568  - **Native Twitch codec selection**: Allows Twitch to handle codec negotiation without browser intervention
569  - Fixes theater mode freeze and fullscreen black screen issues on Twitch
570
571### Fixed
572- Zoom level toast no longer shows on every page navigation within the same domain:
573  - Added smart detection to differentiate user-initiated vs programmatic zoom changes
574  - Toast now only appears when manually adjusting zoom or entering a new domain
575  - Prevents annoying notifications during regular browsing within the same site
576- Links with `target="_blank"` now load in current window instead of being ignored:
577  - Added WebKit `create` signal handler to intercept new window requests
578  - Redirects popup/new tab links to current window for seamless single-window browsing
579  - Maintains user experience consistency in tab-less browser architecture
580
581## [0.5.0] - 2025-09-12
582
583### Added
584- Hardware video acceleration with automatic GPU detection:
585  - Multi-vendor GPU detection (AMD, NVIDIA, Intel) using glxinfo, lspci, and sysfs
586  - Automatic VA-API driver selection (radeonsi for AMD, vdpau for NVIDIA, iHD for Intel)
587  - WebKitGTK integration with GStreamer hardware acceleration backends
588  - Environment variable configuration support (LIBVA_DRIVER_NAME, GST_VAAPI_ALL_DRIVERS)
589  - Legacy VA-API fallback mode for compatibility with older systems
590  - Video decoding acceleration for H.264, HEVC, VP9, and AV1 codecs
591  - Significantly reduced CPU usage during video streaming (Twitch, YouTube, etc.)
592  - Smart conflict prevention between legacy and modern VA-API implementations
593- TLS certificate error handling with user confirmation dialog:
594  - Comprehensive certificate information display (subject, issuer, validity dates)
595  - Interactive warning dialog for untrusted certificate authorities
596  - Certificate exception management with per-host persistence
597  - Manual load triggering after user accepts certificate exceptions
598  - Proper integration with WebKitGTK 6.0 network session API
599- Zoom level toast notifications:
600  - Real-time zoom level display with format: "Zoom level: ±X% (Y%)"
601  - Smart debouncing to prevent notification spam during rapid zoom changes
602  - Automatic cleanup of stuck or colliding toast messages
603  - 150ms debounce timer with 2-second display duration
604  - Emergency cleanup function for orphaned toast elements
605- Comprehensive XDG-compliant logging system:
606  - Complete application output capture (Go logs, fmt prints, WebKit C logs)
607  - XDG Base Directory specification compliance (`~/.local/state/dumber/logs/`)
608  - Automatic log rotation with size/age-based cleanup and compression
609  - WebKit CGO log capture with GLib log handler integration
610  - CLI log management commands (`dumber logs list`, `logs tail`, `logs clean`)
611  - File-only logging for cache operations to prevent dmenu interference
612  - Multi-output support with timestamped, tagged log entries
613  - Configurable log levels, formats (text/JSON), and retention policies
614
615### Fixed
616- WebView background set to black to improve user experience during page loads
617- Multiple linting issues and code quality improvements (reduced from 211 to ~150 issues)
618- Omnibox responsive scaling and layout issues:
619  - Fixed over-aggressive viewport scaling that made omnibox disproportionately large at high zoom levels
620  - Resolved input field overflow extending beyond container boundaries
621  - Improved box-sizing model to prevent layout issues
622  - Added conditional separator display (hidden when no search results)
623  - Omnibox now scales proportionally with webpage content across all zoom levels
624- Dmenu history favicon display:
625  - Complete favicon caching system for fuzzel/dmenu integration with real website icons
626  - ICO file support using go-ico library for perfect Windows icon conversion to PNG
627  - Smart brightness detection and color inversion for dark theme visibility
628  - All cached favicons normalized to consistent 32x32 PNG format for uniform display
629  - Anti-aliasing preservation during color inversion to prevent edge noise and pixelation
630  - Asynchronous favicon downloading and caching with 7-day freshness and 30-day cleanup
631  - Fuzzel icon protocol integration (`\0icon\x1f<path>`) for native icon display
632  - Favicon URLs extracted from webpage metadata and stored in database during navigation
633  - Fallback system removed to ensure consistent sizing - shows real favicons or no icon
634  - XDG Base Directory compliance for favicon cache storage
635
636## [0.4.0] - 2025-09-10
637
638### Added
639- High-performance fuzzy cache system for dmenu history:
640  - Binary serialization with memory-mapped files for zero-copy access
641  - Trigram indexing (3-character sequences) for fast candidate filtering  
642  - Prefix trie (compressed tree structure) for prefix matching
643  - Pre-sorted entry indices for O(1) top entries retrieval
644  - Smart cache invalidation with filesystem persistence and background refresh
645  - Comprehensive fuzzy matching algorithms: Jaro-Winkler similarity, Levenshtein distance, tokenized matching
646  - Weighted scoring system combining URL, title, recency, and visit count scores
647  - XDG Base Directory Specification compliance (cache stored in state directory)
648  - Atomic operations for concurrent access control
649  - Dependency injection using interfaces and gomock for testing
650- Purge command for cleaning up dumber data and cache files:
651  - Selective purging with flags: `--database`, `--history-cache`, `--browser-cache`, `--browser-data`, `--state`, `--config`
652  - Clear distinction between history cache (dmenu fuzzy search) and browser cache (WebKit)
653  - Browser data includes cookies, localStorage, sessionStorage
654  - Confirmation prompt with `--force` flag to skip
655  - Targets all data locations: SQLite database, WebKit cache/data, dmenu fuzzy cache, configuration files
656- Ctrl+Shift+C keyboard shortcut to copy current URL to clipboard:
657  - Cross-platform clipboard support with wl-copy (Wayland) and xclip (X11) fallback
658  - Reusable toast notification system for user feedback
659  - Injectable JavaScript component for consistent styling across all websites
660  - Native backend integration for reliable clipboard access
661
662### Changed
663- Dmenu performance dramatically improved: 200ms → 4ms (98% faster)
664- GetTopEntries optimized from O(n log n) to O(1) using pre-sorted indices
665- Cache build time reduced to ~300μs for typical history datasets
666
667### Fixed
668- 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`
669- Eliminated O(n log n) sorting bottleneck on every dmenu call
670- Memory-efficient compact entry storage with minimal footprint
671- Concurrent cache access with proper read/write locking
672- 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
673
674## [0.3.0] - 2025-01-11
675
676### Added
677- WebKit memory controls (opt‑in):
678  - Env vars to tune memory/perf trade‑offs without code changes:
679    - `DUMBER_CACHE_MODEL`, `DUMBER_ENABLE_PAGE_CACHE`
680    - `DUMBER_ENABLE_MEMORY_MONITORING`, `DUMBER_MEMORY_LIMIT_MB`, `DUMBER_MEMORY_POLL_INTERVAL`
681    - `DUMBER_MEMORY_CONSERVATIVE`, `DUMBER_MEMORY_STRICT`, `DUMBER_MEMORY_KILL`
682    - `DUMBER_GC_INTERVAL`, `DUMBER_RECYCLE_THRESHOLD`
683  - Version‑guarded CGO wrappers for memory pressure and GC hooks; safe no‑ops on unsupported WebKitGTK builds.
684 - Find in page (Ctrl/Cmd+F):
685   - Omnibox refactored into a reusable component with dedicated "find" mode.
686   - Highlighting: yellow for all matches; active match in orange for clarity.
687   - Match list with context (right side stops at nearest punctuation: . , ; : -).
688   - Navigation UX:
689     - ArrowUp/Down move selection and scroll the overlay list (page scroll disabled while open).
690     - Enter centers on the active match and closes; Shift+Enter goes to previous; Alt+Enter centers without closing.
691     - Hover focuses input and selects list items; click outside closes the overlay.
692     - Faded overlay with subtle blur when reviewing matches; opacity restores on input focus/typing.
693   - Programmatic API: `OpenFind(initial)`, `FindQuery(q)`, `CloseFind()` on `WebView`.
694
695### Changed
696- Performance‑first defaults retained:
697  - Cache model set to “WebBrowser”, page cache enabled, DevTools available.
698  - No implicit memory pressure or GC enabled by default; all memory tuning is opt‑in.
699
700### Removed
701- Deprecated offline app‑cache calls eliminated (no‑ops) to avoid warnings and brittle builds.
702
703### Fixed
704- Homepage Recent History layout:
705  - Show single-line entries as “{Title} – {Domain} – {URL}”.
706  - Truncate long URLs with a gradient fade; prevent horizontal overflow.
707  - Adjusted styling so URL is darker for readability.
708- Search shortcuts and config interop:
709  - Backend SearchShortcut now serializes `url`/`description` with JSON tags.
710  - Frontend normalizes field casing and extracts base URLs, handling `%s` and `{query}` templates.
711  - Omnibox shortcut parsing now URL-encodes queries and supports `%s` placeholders.
712- Input and navigation reliability (GTK4/WebKitGTK 6):
713  - Capture-phase key controller to ensure accelerators fire consistently.
714  - Do not consume normal left/right clicks; only mouse buttons 8/9 trigger back/forward.
715  - Added Alt+ArrowLeft/Right navigation and enabled two-finger swipe back/forward when supported.
716  - Added Ctrl+scroll zoom in/out; refined accelerator matching so Ctrl− works across layouts.
717  - Removed layout-specific hacks; added diagnostic logs for raw minus key events.
718- Zoom persistence:
719  - Added WebView zoom-changed hook; save per-domain zoom to SQLite on every change.
720  - Log on successful save: “saved X.XX for domain.tld” and on load: “loaded X.XX for domain.tld”.
721  - Load and log initial zoom level on startup and on every navigation.
722- Build/dev ergonomics:
723  - Makefile loads `.env.local`; supports overriding `GOMODCACHE`, `GOCACHE`, `GOTMPDIR` for sandboxed builds.
724 - WebKit CGO hardening and API compatibility:
725   - Apply memory pressure settings to `WebKitNetworkSession` (correct signature) when enabled.
726   - Guarded C wrappers remove deprecation warnings across header variants; builds succeed on WebKitGTK 6.
727
728## [0.2.0] - 2025-09-10
729
730### Added
731- WebKitGTK 6 (GTK4) migration for the built‑in browser window:
732  - WebView constructed via `g_object_new(WEBKIT_TYPE_WEB_VIEW, …)` with a fresh `WebKitUserContentManager`.
733  - `WebKitNetworkSession` with persistent cookies (SQLite) and cache directories.
734- Native UCM messaging restored via `script-message-received::dumber` (JSCValue*), removing the JS fallback bridge.
735- Rendering mode controls:
736  - CLI flag `--rendering-mode=auto|gpu|cpu` and `DUMBER_RENDERING_MODE` env.
737  - In‑app status endpoint `dumb://homepage/api/rendering/status`.
738- Native zoom shortcuts at the WebKit layer (Ctrl/Cmd+=, +, −, 0) and GTK4 input controllers for keyboard/mouse.
739- AZERTY keyboard fix: treat underscore as minus for zoom‑out.
740- Runtime theme synchronization: watch GTK `gtk-application-prefer-dark-theme` and update page color‑scheme live.
741- Makefile target `check-webkit` to print `pkg-config` versions of GTK4/WebKitGTK 6.0/JSC 6.0.
742- Documentation updates:
743  - README now targets WebKitGTK 6 (GTK4) and lists GStreamer package requirements for Arch and Debian/Ubuntu.
744  - CLAUDE notes updated with migration status, GPU/Vulkan path, runtime theme sync, and persistence.
745
746### Changed
747- Build flags and includes now target `webkitgtk-6.0`, `gtk4`, and `javascriptcoregtk-6.0`.
748- GTK4 APIs for windowing and event handling (GtkEventController, GtkGestureClick) replace GTK3/GdkEvent paths.
749
750### Removed
751- Legacy WebKit2GTK constructors and container APIs.
752- JavaScript fallback for UCM message bridging.
753
754### Fixed
755- Header/enum compatibility for hardware acceleration policy and cookie policy across WebKit header variants.
756- Linker error for `on_theme_changed` and gpointer usage in signal connections.
757- Crashy paths mitigated by default “media safe” startup (can be disabled via `DUMBER_MEDIA_SAFE=0`).
758
759### Notes
760- GPU rendering path leverages GTK4’s renderer (Vulkan/OpenGL). Mode `auto` uses GPU when available and falls back gracefully to CPU.
761- WebKitGTK relies on GStreamer; install recommended packages for audio/video (see README).
762
763## [0.1.0] - 2025-09-09
764
765### Added
766- Initial project scaffolding, build system, and dependencies.
767- Unified CLI + GUI architecture with search shortcuts and fuzzy parsing.
768- Wails v3‑alpha browser integration (early phase).
769- Global keyboard controls with script injection (zoom/devtools, etc.).
770- Native WebKit2GTK backend migration:
771  - Custom `dumb://` scheme and `/api` endpoints: `/config`, `/history/recent`, `/history/search`, `/history/stats`.
772  - UserContentManager omnibox injection and theme initialization.
773  - Persistent WebsiteDataManager with cookies.sqlite; per‑domain zoom and title persistence.
774  - Keyboard/mouse accelerators (including mouse back/forward); debounced triggers.
775  - Homepage switched to first‑party API fetches; removed @wailsio/runtime usage.
776- Documentation and licensing: README enhancements and LICENSE added.
777
778### Changed
779- Replaced Wails runtime with native WebKit2GTK CGO bindings and homepage API.
780- Improved asset resolution and logging for the `dumb://homepage` scheme.
781
782### Fixed
783- Eliminated duplicate accelerator triggers via debouncing.
784- Corrected asset resolution and URL normalization in scheme handler.