1# Changelog
2
3All notable changes to this project will be documented in this file.
4
5## [0.4.0] - 2025-09-10
6
7### Added
8- High-performance fuzzy cache system for dmenu history:
9  - Binary serialization with memory-mapped files for zero-copy access
10  - Trigram indexing (3-character sequences) for fast candidate filtering  
11  - Prefix trie (compressed tree structure) for prefix matching
12  - Pre-sorted entry indices for O(1) top entries retrieval
13  - Smart cache invalidation with filesystem persistence and background refresh
14  - Comprehensive fuzzy matching algorithms: Jaro-Winkler similarity, Levenshtein distance, tokenized matching
15  - Weighted scoring system combining URL, title, recency, and visit count scores
16  - XDG Base Directory Specification compliance (cache stored in state directory)
17  - Atomic operations for concurrent access control
18  - Dependency injection using interfaces and gomock for testing
19- Purge command for cleaning up dumber data and cache files:
20  - Selective purging with flags: `--database`, `--history-cache`, `--browser-cache`, `--browser-data`, `--state`, `--config`
21  - Clear distinction between history cache (dmenu fuzzy search) and browser cache (WebKit)
22  - Browser data includes cookies, localStorage, sessionStorage
23  - Confirmation prompt with `--force` flag to skip
24  - Targets all data locations: SQLite database, WebKit cache/data, dmenu fuzzy cache, configuration files
25- Ctrl+Shift+C keyboard shortcut to copy current URL to clipboard:
26  - Cross-platform clipboard support with wl-copy (Wayland) and xclip (X11) fallback
27  - Reusable toast notification system for user feedback
28  - Injectable JavaScript component for consistent styling across all websites
29  - Native backend integration for reliable clipboard access
30
31### Changed
32- Dmenu performance dramatically improved: 5 seconds → 4ms (99.92% faster)
33- GetTopEntries optimized from O(n log n) to O(1) using pre-sorted indices
34- Cache build time reduced to ~300μs for typical history datasets
35
36### Fixed
37- 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`
38- Eliminated O(n log n) sorting bottleneck on every dmenu call
39- Memory-efficient compact entry storage with minimal footprint
40- Concurrent cache access with proper read/write locking
41- 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
42
43## [0.3.0] - 2025-01-11
44
45### Added
46- WebKit memory controls (opt‑in):
47  - Env vars to tune memory/perf trade‑offs without code changes:
48    - `DUMBER_CACHE_MODEL`, `DUMBER_ENABLE_PAGE_CACHE`
49    - `DUMBER_ENABLE_MEMORY_MONITORING`, `DUMBER_MEMORY_LIMIT_MB`, `DUMBER_MEMORY_POLL_INTERVAL`
50    - `DUMBER_MEMORY_CONSERVATIVE`, `DUMBER_MEMORY_STRICT`, `DUMBER_MEMORY_KILL`
51    - `DUMBER_GC_INTERVAL`, `DUMBER_RECYCLE_THRESHOLD`
52  - Version‑guarded CGO wrappers for memory pressure and GC hooks; safe no‑ops on unsupported WebKitGTK builds.
53 - Find in page (Ctrl/Cmd+F):
54   - Omnibox refactored into a reusable component with dedicated "find" mode.
55   - Highlighting: yellow for all matches; active match in orange for clarity.
56   - Match list with context (right side stops at nearest punctuation: . , ; : -).
57   - Navigation UX:
58     - ArrowUp/Down move selection and scroll the overlay list (page scroll disabled while open).
59     - Enter centers on the active match and closes; Shift+Enter goes to previous; Alt+Enter centers without closing.
60     - Hover focuses input and selects list items; click outside closes the overlay.
61     - Faded overlay with subtle blur when reviewing matches; opacity restores on input focus/typing.
62   - Programmatic API: `OpenFind(initial)`, `FindQuery(q)`, `CloseFind()` on `WebView`.
63
64### Changed
65- Performance‑first defaults retained:
66  - Cache model set to “WebBrowser”, page cache enabled, DevTools available.
67  - No implicit memory pressure or GC enabled by default; all memory tuning is opt‑in.
68
69### Removed
70- Deprecated offline app‑cache calls eliminated (no‑ops) to avoid warnings and brittle builds.
71
72### Fixed
73- Homepage Recent History layout:
74  - Show single-line entries as “{Title} – {Domain} – {URL}”.
75  - Truncate long URLs with a gradient fade; prevent horizontal overflow.
76  - Adjusted styling so URL is darker for readability.
77- Search shortcuts and config interop:
78  - Backend SearchShortcut now serializes `url`/`description` with JSON tags.
79  - Frontend normalizes field casing and extracts base URLs, handling `%s` and `{query}` templates.
80  - Omnibox shortcut parsing now URL-encodes queries and supports `%s` placeholders.
81- Input and navigation reliability (GTK4/WebKitGTK 6):
82  - Capture-phase key controller to ensure accelerators fire consistently.
83  - Do not consume normal left/right clicks; only mouse buttons 8/9 trigger back/forward.
84  - Added Alt+ArrowLeft/Right navigation and enabled two-finger swipe back/forward when supported.
85  - Added Ctrl+scroll zoom in/out; refined accelerator matching so Ctrl− works across layouts.
86  - Removed layout-specific hacks; added diagnostic logs for raw minus key events.
87- Zoom persistence:
88  - Added WebView zoom-changed hook; save per-domain zoom to SQLite on every change.
89  - Log on successful save: “saved X.XX for domain.tld” and on load: “loaded X.XX for domain.tld”.
90  - Load and log initial zoom level on startup and on every navigation.
91- Build/dev ergonomics:
92  - Makefile loads `.env.local`; supports overriding `GOMODCACHE`, `GOCACHE`, `GOTMPDIR` for sandboxed builds.
93 - WebKit CGO hardening and API compatibility:
94   - Apply memory pressure settings to `WebKitNetworkSession` (correct signature) when enabled.
95   - Guarded C wrappers remove deprecation warnings across header variants; builds succeed on WebKitGTK 6.
96
97## [0.2.0] - 2025-09-10
98
99### Added
100- WebKitGTK 6 (GTK4) migration for the built‑in browser window:
101  - WebView constructed via `g_object_new(WEBKIT_TYPE_WEB_VIEW, …)` with a fresh `WebKitUserContentManager`.
102  - `WebKitNetworkSession` with persistent cookies (SQLite) and cache directories.
103- Native UCM messaging restored via `script-message-received::dumber` (JSCValue*), removing the JS fallback bridge.
104- Rendering mode controls:
105  - CLI flag `--rendering-mode=auto|gpu|cpu` and `DUMBER_RENDERING_MODE` env.
106  - In‑app status endpoint `dumb://homepage/api/rendering/status`.
107- Native zoom shortcuts at the WebKit layer (Ctrl/Cmd+=, +, −, 0) and GTK4 input controllers for keyboard/mouse.
108- AZERTY keyboard fix: treat underscore as minus for zoom‑out.
109- Runtime theme synchronization: watch GTK `gtk-application-prefer-dark-theme` and update page color‑scheme live.
110- Makefile target `check-webkit` to print `pkg-config` versions of GTK4/WebKitGTK 6.0/JSC 6.0.
111- Documentation updates:
112  - README now targets WebKitGTK 6 (GTK4) and lists GStreamer package requirements for Arch and Debian/Ubuntu.
113  - CLAUDE notes updated with migration status, GPU/Vulkan path, runtime theme sync, and persistence.
114
115### Changed
116- Build flags and includes now target `webkitgtk-6.0`, `gtk4`, and `javascriptcoregtk-6.0`.
117- GTK4 APIs for windowing and event handling (GtkEventController, GtkGestureClick) replace GTK3/GdkEvent paths.
118
119### Removed
120- Legacy WebKit2GTK constructors and container APIs.
121- JavaScript fallback for UCM message bridging.
122
123### Fixed
124- Header/enum compatibility for hardware acceleration policy and cookie policy across WebKit header variants.
125- Linker error for `on_theme_changed` and gpointer usage in signal connections.
126- Crashy paths mitigated by default “media safe” startup (can be disabled via `DUMBER_MEDIA_SAFE=0`).
127
128### Notes
129- GPU rendering path leverages GTK4’s renderer (Vulkan/OpenGL). Mode `auto` uses GPU when available and falls back gracefully to CPU.
130- WebKitGTK relies on GStreamer; install recommended packages for audio/video (see README).
131
132## [0.1.0] - 2025-09-09
133
134### Added
135- Initial project scaffolding, build system, and dependencies.
136- Unified CLI + GUI architecture with search shortcuts and fuzzy parsing.
137- Wails v3‑alpha browser integration (early phase).
138- Global keyboard controls with script injection (zoom/devtools, etc.).
139- Native WebKit2GTK backend migration:
140  - Custom `dumb://` scheme and `/api` endpoints: `/config`, `/history/recent`, `/history/search`, `/history/stats`.
141  - UserContentManager omnibox injection and theme initialization.
142  - Persistent WebsiteDataManager with cookies.sqlite; per‑domain zoom and title persistence.
143  - Keyboard/mouse accelerators (including mouse back/forward); debounced triggers.
144  - Homepage switched to first‑party API fetches; removed @wailsio/runtime usage.
145- Documentation and licensing: README enhancements and LICENSE added.
146
147### Changed
148- Replaced Wails runtime with native WebKit2GTK CGO bindings and homepage API.
149- Improved asset resolution and logging for the `dumb://homepage` scheme.
150
151### Fixed
152- Eliminated duplicate accelerator triggers via debouncing.
153- Corrected asset resolution and URL normalization in scheme handler.