Skip to content

v1.3.0

Latest

Choose a tag to compare

@pjBooms pjBooms released this 20 Nov 09:59

Release Summary

Compose Hot Reload 1.3.0 is here 🎉

This release is focused on error recovery: when a hot reload leaves your UI in a broken state, Compose Hot Reload detects it, shows an appropriate error message and can recover once you fix the problem in the sources.

Highlights

  • Subcompositions error recovery — since CMP 1.13.0, errors thrown in subcompostions are now recoverable
  • Hard reset recovery — the application window is recreated to recover from corrupted state after an erroneous reload for Reset UI tools window action (can be used as a fallback for CMP < 1.13.0)
  • Richer error reporting — errors thrown in subcompositions are now surfaced

Error Recovery

  • Errors thrown in subcompositions after a reload are now reported instead of silently ignored (using the Recomposer error-state API, available since Compose Runtime 1.11.0). Moreover such errors are recoverable since Compose Runtime 1.13.0.
  • The new hard reset strategy recreates the application window to recover from state corrupted by an erroneous reload. It is now the default behavior of the Reset UI action; opt out with -Dcompose.reload.compositionHardResetEnabled=false to fall back to the lighter reset.

MCP Server

  • Screenshots are now captured natively via ComposeDesktopEntryPoint.captureContentToImage() since CMP 1.13.0, falling back to the previous AWT Robot approach on older versions — making take_screenshot more accurate and consistent.
  • Scrollable nodes in the semantic tree now expose scrollX / scrollY fields describing their scroll state (CMP-10878).
  • New experimental headless tools: run_headless launches an app in headless mode starting from a provided composable, close_headless stops it, and take_screenshot accepts a session_id to capture arbitrary screenshots of headless sessions. Opt in with compose.reload.mcp.headlessToolsEnabled=true.

Dev Tools

  • The error overlay and notification now refresh when the error changes after a reload, so the displayed message and stack trace are always up to date.
  • Fixed tooltips being rendered behind the error overlay.

Gradle

  • Fixed deprecation warnings on Gradle 9.8 (CMP-10862).

Thanks to everyone who filed issues, tested pre-releases, and contributed to this release 🙏