# ChangeLog ## v0.8.7 - 2026-11-10 ### Breaking Changes: - break(abi): rebuild native binary apps for the expanded app and system interfaces and GUI descriptors. ### Enhancements: - feat(gui): select GSP or LVGL with backend-specific dependencies and resources. - feat(gsp): host native and JavaScript apps with deployable bundles, theme start scenes, and GUI event delivery. - feat(gsp): add JavaScript text, value, property, and scene updates for the active application. - feat(shell): add a paginated GSP launcher, shared keyboard and dialogs, and saved language/theme restoration. - feat(app): expose runtime app removal through the system service. - feat(linux): run the GSP shell and app manager on desktop displays with platform support checks. ### Bug Fixes: - fix(gsp): stop partially started app and modal sessions before restoring the foreground application. - fix(lifecycle): stop all sessions before uninstalling apps so deinit retries cannot repeat uninstall callbacks. - fix(app): validate recovery targets against install metadata and transaction ownership before moving directories. - fix(app): reject runtime packages whose declared GUI backend conflicts with their descriptor or the firmware. - fix(app): restore previous versions after failed updates and recover interrupted installations at startup. - fix(build): isolate staged backend resources while preserving simulator app data across rebuilds. - fix(gsp): retain borrowed resources during deferred stop and retry modal resumption or return to the launcher. - fix(gsp): queue lifecycle callbacks without re-entering their synchronization gates. - fix(gsp): validate and bound cached updates, and retain the previous scene when a page change fails. - fix(app): protect the system shell and restrict service-driven removal to managed runtime apps. - fix(app): synchronize app-record maps and retain records while tasks still reference them. ### Documentation: - docs(gsp): describe backend selection, shared input, session lifetimes, and Linux modal request behavior. ## v0.8.6 - 2026-10-27 ### Enhancements: - feat(system): expose `gui_binding_flush_stats()` behind `BROOKESIA_SYSTEM_CORE_ENABLE_GUI_BINDING_PROBE` (default n) so the flush-apply metric costs nothing in shipped builds. - feat(system): drive the GUI backend from `System::process_timers()` so deferred work advances on the timer path. - feat(system): make `system_gui_load_json` / `system_gui_mount_screen` / `system_gui_unmount_screen` / `system_gui_unload` public so a firmware carrier without a derived App can drive the GUI. - feat(system): add and expose `system_gui_load_theme_file` / `system_gui_set_theme` so a carrier can register and activate a theme before loading GUI documents. ### Bug Fixes: - fix(system): post the GUI binding-flush re-arm as a real queue hop instead of running it inline. - fix(build): include `esp_timer.h` only when the GUI binding probe is enabled. ## v0.8.5 - 2026-10-27 ### Enhancements: - feat(gui): build non-entry app screens on demand or during idle. - feat(gui): preload app documents without building screens. - feat(profiling): log lifecycle memory snapshots when profile logging is enabled. ### Bug Fixes: - fix(deps): require GUI Interface `>=0.8.3,<0.9` for deferred screen loading. ### Documentation: - docs(usb): update package and command names for the brookesia-usb CLI. ## v0.8.4 - 2026-08-31 ### Breaking Changes: - break(runtime): require declarations for every non-system service RPC used by runtime apps. ### Enhancements: - feat(app): parse service dependencies and expose them through app information. - feat(app): block runtime package installation or app startup when declared services are unavailable. - feat(runtime): reject undeclared named service access outside the three system RPCs. ### Documentation: - docs(app): document service declarations, version compatibility, and runtime enforcement. ## v0.8.3 - 2026-08-04 ### Enhancements: - feat(usb): add the USB Serial/JTAG host-control and runtime package bridge. - feat(app): expose runtime package installation to system-level integrations. ### Bug Fixes: - fix(app): warn and continue when manifests contain unsupported fields. ## v0.8.2 - 2026-07-27 ### Enhancements: - feat(build): split runtime, service, and GUI orchestration implementation units. - chore(build): use lightweight static schema and utility APIs. ## v0.8.1 - 2026-07-13 ### Breaking Changes: - break(gui): return explicit errors when native apps cannot update GUI view debug state. ### Enhancements: - feat(service): register a description for Manager metadata queries. - feat(build): use `idf_component.yml` as the single component version source on PC. - feat(logging): print the component version during system initialization. - feat(gui): add native app image preload and release helpers. - feat(runtime): expose SystemGui PreloadImages and ReleaseImages for runtime apps. - feat(app): support preloading app GUI documents at install time to reduce launch latency. - feat(gui): add batch action subscriptions, absolute scrolling, and theme-language queries. - feat(gui): expose GUI view debug control directly through the native app GUI runtime. - feat(service): register the component version for built-in system service version queries. - chore(scheduler): remove the Worker suffix from default thread names on ESP and PC. ### Documentation: - docs(gui): document image preload services and resource permission scope. ### Bug Fixes: - fix(storage): bind Storage for the System lifecycle and route app file operations through its service APIs. ## v0.8.0 - 2026-06-28 ### Initial Release: - Initial release of `brookesia_system_core` with native and runtime app installation, lifecycle, and package scanning. - Provides app-scoped GUI, storage, timer, and service bridge foundations.