Skip to content

Commit 157b8c9

Browse files
committed
docs(changelog): add v1.6.4–v1.10.0 release notes
1 parent 8d8a765 commit 157b8c9

1 file changed

Lines changed: 253 additions & 0 deletions

File tree

docs/changelog.md

Lines changed: 253 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,258 @@
11
# Changelog
22

3+
## v1.10.0
4+
5+
**Released: 2026-04-12**
6+
7+
### New Modules
8+
9+
- **System Info** (`nucleus.system-info`) — Cross-platform system information module with JNI native implementations for Linux, Windows, and macOS. Exposes CPU, memory, and GPU metrics in real-time.
10+
- **GPU detection and live metrics** — Temperature, usage, VRAM, clock speeds, power draw, and fan speed on all platforms
11+
- **macOS**: IOKit & SMC for GPU metrics, supports Apple Silicon and discrete GPUs
12+
- **Windows**: DXGI for GPU enumeration, NVIDIA NVML + AMD ADL2 + Intel IGCL for live metrics, WMI thermal zone sensors, performance data for real-time CPU frequency
13+
- **Linux**: NVIDIA NVML, AMD, and Intel GPU support
14+
- Includes a demo application (`system-info-demo`) with lets-plot charting for CPU temperature history
15+
16+
### Bug Fixes
17+
18+
- **Fix `latest.yml` not generated for MSI and Portable formats** — Update YML generation was limited to NSIS; it now covers MSI and Portable installers as well
19+
- **Fix `releaseDate` precision in `latest.yml`** — Use millisecond precision to match the electron-builder format expected by the auto-updater
20+
21+
---
22+
23+
## v1.9.1
24+
25+
**Released: 2026-04-10**
26+
27+
### Bug Fixes
28+
29+
- **Fix DMG background image corruption** — Preserve TIFF background byte-for-byte instead of re-encoding; adjust DMG window size to match the image rather than padding the image
30+
31+
---
32+
33+
## v1.9.0
34+
35+
**Released: 2026-04-09**
36+
37+
### New Features
38+
39+
- **`controlButtonIconColor` / `controlButtonIconHoverColor`** — New styling properties on `DecoratedWindow` to customize the color of window control button icons (close, minimize, maximize) and their hover state
40+
- **`titleBarClickable`** — New property to fix click handling in macOS fullscreen mode, ensuring title bar buttons remain interactive
41+
42+
### Bug Fixes
43+
44+
- **Fix macOS resize lag in decorated windows** — Remove `presentsWithTransaction` which caused visible lag during window resize on macOS
45+
- **Fix fullscreen title bar clicks on non-notch macOS screens** — Title bar buttons were unresponsive in fullscreen on Macs without a notch
46+
- **Fix crashes on macOS < 26 during resize and drag** — Guard against Liquid Glass APIs unavailable on older macOS versions
47+
- **Fix DPI scaling for min/max window size on Windows** — Apply per-axis DPI scaling to `minSize`/`maxSize` constraints, and clean up resources on window dispose
48+
- **Fix stale lock files in SingleInstanceManager** — Detect and clean up orphaned lock files from previous crashed instances
49+
- **Fix DMG background image self-destruction** — Prevent the background image from being overwritten during the `dmg-assets` copy phase
50+
- **Fix AppImage + Maximum compression warning** — Remove invalid `Fast` compression level and warn when `Maximum` is used with AppImage (unsupported by `mksquashfs`)
51+
- **Remove unused `TitleBarIcons` API** — Clean up deprecated API from `decorated-window`
52+
53+
---
54+
55+
## v1.8.8
56+
57+
**Released: 2026-03-31**
58+
59+
### Bug Fixes
60+
61+
- **Fix macOS RTL detection** — Use `NSLocale` instead of `NSApplication` for layout direction detection, which works correctly in headless and early-startup contexts
62+
63+
---
64+
65+
## v1.8.7
66+
67+
**Released: 2026-03-30**
68+
69+
### New Features
70+
71+
- **Localized Window/Help menu titles** — macOS native menus now display localized titles based on the system locale, with a fix for GraalVM system locale initialization
72+
- **Linux native layout direction detection** — Detect RTL/LTR layout direction on Linux via Pango JNI, replacing the AWT `ComponentOrientation` approach that failed in native image builds
73+
74+
### Bug Fixes
75+
76+
- **Gracefully handle missing platform-specific native libraries** — Runtime modules no longer crash when a native library is unavailable for the current platform; they fall back silently
77+
78+
---
79+
80+
## v1.8.6
81+
82+
**Released: 2026-03-30**
83+
84+
### Bug Fixes
85+
86+
- **Fix macOS input method crash in GraalVM native image** — Add missing reflection entries for macOS input method classes to platform metadata
87+
88+
---
89+
90+
## v1.8.5
91+
92+
**Released: 2026-03-30**
93+
94+
### Improvements
95+
96+
- **CI: menu-macos native build steps** — Add menu-macos native library build and verification to all CI workflows
97+
98+
---
99+
100+
## v1.8.4
101+
102+
**Released: 2026-03-30**
103+
104+
### New Features
105+
106+
- **Native Access documentation** — Comprehensive guide for the Nucleus Native Access API covering lifecycle details, supported types, and unsupported features
107+
108+
### Bug Fixes
109+
110+
- **Fix DMG background generation crash** — Check `ImageIO.write` return value to prevent `FileNotFoundException` when the image format is unsupported
111+
112+
---
113+
114+
## v1.8.3
115+
116+
**Released: 2026-03-30**
117+
118+
### Bug Fixes
119+
120+
- **Fix artifact naming** — Revert example `packageName` to simple form for clean installer artifact names
121+
122+
---
123+
124+
## v1.8.0
125+
126+
**Released: 2026-03-28**
127+
128+
### New Modules
129+
130+
- **Notification macOS** (`nucleus.notification-macos`) — Full UserNotifications API mapping via JNI. Supports rich notifications with title, subtitle, body, sound, badge, categories with actions, and delivery scheduling. Thread safety with EDT dispatch for delegate callbacks.
131+
132+
- **Notification Linux** (`nucleus.notification-linux`) — Full freedesktop Desktop Notifications API mapping via JNI (D-Bus `org.freedesktop.Notifications`). Supports notification actions, icons, urgency levels, and expiration.
133+
134+
- **Notification Windows** (`nucleus.notification-windows`) — Full Windows Toast Notifications API via JNI (WinRT). Rich toast templates with text, images, buttons, and audio.
135+
136+
- **Launcher Linux** (`nucleus.launcher-linux`) — Full Unity Launcher API mapping via JNI (`com.canonical.Unity.LauncherEntry` + `com.canonical.dbusmenu`). Badge count, progress bar, urgency flag, and quicklist menus with D-Bus menu support. Compatible with GNOME, KDE Plasma, and other DEs.
137+
138+
- **Launcher macOS** (`nucleus.launcher-macos`) — Dock menu API via JNI. Custom Dock context menu items with native callbacks. Requires `CRITICAL_ALERT` entitlement for certain notification features.
139+
140+
- **Launcher Windows** (`nucleus.launcher-windows`) — Windows Launcher API via JNI (WinRT/COM). Badge notifications, Jump Lists (`ICustomDestinationList`), overlay icons, and thumbnail toolbar buttons (`ITaskbarList3`) on the taskbar.
141+
142+
- **Freedesktop Icons** (`nucleus.freedesktop-icons`) — Type-safe constants for the freedesktop Icon Naming Specification. Shared dependency between `notification-linux` and `launcher-linux`.
143+
144+
- **Global Hotkey** (`nucleus.global-hotkey`) — Cross-platform global keyboard shortcut registration.
145+
- **Windows**: Low-level keyboard hook
146+
- **macOS**: Carbon API (`RegisterEventHotKey`)
147+
- **Linux**: X11 key grabbing + Wayland portal (`org.freedesktop.portal.GlobalShortcuts`)
148+
- Thread-safe registration/unregistration with synchronized init
149+
150+
- **Menu macOS** (`nucleus.menu-macos`) — Native macOS menu bar API via JNI. Includes GraalVM reachability metadata for JNI callbacks.
151+
152+
- **SF Symbols** (`nucleus.sf-symbols`) — Apple SF Symbols integration module.
153+
154+
### Bug Fixes
155+
156+
- **Fix global hotkey UI freeze on Linux** — Make portal binding non-blocking to avoid freezing the UI thread on Wayland, then dispatch to `Dispatchers.IO`
157+
- **Fix `Dispatchers.Main` crash in example** — Add `coroutines-swing` dependency for desktop `Dispatchers.Main` support
158+
159+
---
160+
161+
## v1.7.2
162+
163+
**Released: 2026-03-25**
164+
165+
### New Features
166+
167+
- **Webview, JNA, and SQLite JNI metadata** — Add missing GraalVM reachability metadata for webview, JNA, and SQLite JNI classes to L1
168+
- **`Companion.serializer()` metadata for `@Serializable` classes** — The static analyzer now emits reflection entries for kotlinx.serialization `Companion.serializer()` methods automatically
169+
170+
### Bug Fixes
171+
172+
- **Fix proxy entries in `cleanupGraalvmMetadata` task** — Handle proxy configuration entries that could cause the cleanup task to fail
173+
174+
---
175+
176+
## v1.7.1
177+
178+
**Released: 2026-03-25**
179+
180+
### New Features
181+
182+
- **Expanded L1 library metadata** — Additional agent-captured entries for common libraries
183+
- **FileKit GraalVM metadata** — Add reachability metadata for FileKit along with complete JDK/JNA entries
184+
185+
### Bug Fixes
186+
187+
- **Fix configuration cache serialization for `nativeImageCompile`** — Resolve serialization errors when Gradle configuration cache is enabled by building native-image arguments at execution time
188+
189+
---
190+
191+
## v1.7.0
192+
193+
**Released: 2026-03-24**
194+
195+
### New Features
196+
197+
- **Static bytecode analyzer for GraalVM reflection metadata** — New `AnalyzeStaticMetadataTask` that scans compiled bytecode to automatically detect classes requiring reflection, JNI, and resource configuration. Eliminates most manual metadata authoring:
198+
- JNI callback detection — finds native methods and their parameter/return types
199+
- Resource scanning — detects `getResource`/`getResourceAsStream` calls
200+
- Class loading wrappers — identifies `Class.forName`, `MethodHandles.Lookup.findClass` patterns
201+
- JNI superclass resolution — includes parent classes needed for field access
202+
- Enriched class entries — adds non-native methods and fields to JNI class metadata
203+
204+
- **`CleanupGraalvmMetadataTask`** — New Gradle task that removes entries from your manual `reachability-metadata.json` that are already covered by Nucleus library metadata (L1/L2/L3). Keeps manual config minimal.
205+
206+
- **File association support for GraalVM native image on macOS** — Register file type associations in the native image `.app` bundle so macOS opens files with your application.
207+
208+
- **macOS deployment target and SDK version patching** — Automatically patch the Mach-O deployment target and SDK version in GraalVM native image binaries for macOS Liquid Glass compatibility.
209+
210+
- **Per-library L1 metadata** — Split the monolithic L1 metadata file into per-library files with conditional filtering, so only relevant metadata is included based on actual classpath dependencies.
211+
212+
- **JNA GraalVM metadata** — Add core JNA JNI requirements to L1 metadata.
213+
214+
- **AWT drag-and-drop and file open handler metadata** — Add GraalVM reachability metadata for AWT drag-and-drop classes and macOS file open handlers.
215+
216+
- **Ktor CIO, SLF4J, and common JDK resource metadata** — Additional L1 entries for Ktor CIO engine, SLF4J, and commonly used JDK internal classes.
217+
218+
### Bug Fixes
219+
220+
- **Fix agent metadata duplication** — Deduplicate tracing agent output against Oracle Reachability Metadata Repository and static analysis results
221+
- **Fix configuration cache serialization in `runWithNativeAgent`** — Resolve Gradle serialization errors when configuration cache is enabled
222+
- **Fix Aqua LAF resource pattern** — Add glob pattern for Aqua Look-and-Feel resources to prevent agent duplication on macOS
223+
- **Fix unsupported class file version in `NativeMethodDetector`** — Handle newer class file versions gracefully instead of crashing
224+
- **Fix `JarResourceDetector` false positives** — Narrow path matching to avoid detecting unrelated resources
225+
226+
### Breaking Changes
227+
228+
- **Default GraalVM config directory changed** — The default directory for manual GraalVM metadata is now `graalvm/` instead of `resources/`. Existing projects should move their `reachability-metadata.json` to the new location.
229+
230+
---
231+
232+
## v1.6.5
233+
234+
**Released: 2026-03-23**
235+
236+
### New Features
237+
238+
- **File association support for GraalVM native image on macOS** — Register file type associations (`CFBundleDocumentTypes`) in the GraalVM native image `.app` bundle
239+
240+
### Bug Fixes
241+
242+
- **Fix ktlint violations in `configureGraalvmApplication.kt`**
243+
244+
---
245+
246+
## v1.6.4
247+
248+
**Released: 2026-03-23**
249+
250+
### Bug Fixes
251+
252+
- **Fix infinite recursion in fullscreen mouse event forwarding** — Prevent stack overflow when forwarding mouse events in decorated window fullscreen mode
253+
254+
---
255+
3256
## v1.6.2
4257

5258
**Released: 2026-03-22**

0 commit comments

Comments
 (0)