5.0.1 - 2025-12-15

• Replaced usages of kotlinx.datetime.Clock with kotlin.time.Clock
• Replaced usages of kotlinx.datetime.Instant with kotlin.time.Instant
• Ballast debugger client is now supported on WasmJS targets
• Kotlin updated to 2.2.20.
• Compose updated to 1.8.2.
• kotlinx-serialization updated to 1.9.0.
• kotlinx-datetime updated to 0.7.1.
• ktor client updated to 3.3.0.

• Increased Kotlin version to 1.9.23
• Increased Compose version to 1.6.1
• Updated other libraries to latest versions:
  • Kotlinx.Coroutines -> 1.8.1
  • Kotlinx.Serialization -> 1.6.3
  • Ktor -> 2.3.11
• Added experimental WASM target, fixing Issue #54. Please note the following limitations:
  • Only wasmJs is supported. wasmWasi target is not currently supported due to lack of support from kotlinx.coroutines
  • :ballast-debugger-client does not support wasmJs, because stable builds of Ktor Client don't support wasmJs yet.
  • :ballast-firebase-analytics and :ballast-firebase-crashlytics do not support any targets other than Android, thus these modules are not available on wasmJs. However, the more generic version of those modules, :ballast-analytics and :ballast-crash-reporting are supported on wasmJs.
  • All other Ballast modules do support wasmJs targets, including :ballast-navigation.
  • BrowserHashNavigationInterceptor and BrowserHistoryNavigationInterceptor are also ported to the wasmJs target, but a shared sourceset between js and wasmJs is not available. it must be configured separately in each target.
• :ballast-navigation no longer depends on the ktor-http library. It was previously using this library for parsing URIs, but because that library includes a lot of extra stuff related to HTTP that wasn't needed in Ballast Navigation, it increased binary size considerably. URI parsing is now handled by eygraber/uri-kmp. This fixes Issue #35.
• [ballast-schedules]: Slight improvement for using Android WorkManager with BallastScheduler. A new method has been added, SchedulerCallback.configureWorkRequest(), which allows you to configure the OneTimeWorkRequest.Builder. This can be used to apply constraints, mark the job as expedited, etc.

• Increased Kotlin version to 1.9.23
• Increased Compose version to 1.6.1
• Updated other libraries to latest versions:
  • Kotlinx.Coroutines -> 1.8.1
  • Kotlinx.Serialization -> 1.6.3
  • Ktor -> 2.3.11
• Added experimental WASM target, fixing Issue #54. Please note the following limitations:
  • Only wasmJs is supported. wasmWasi target is not currently supported due to lack of support from kotlinx.coroutines
  • :ballast-debugger-client does not support wasmJs, because stable builds of Ktor Client don't support wasmJs yet.
  • :ballast-firebase-analytics and :ballast-firebase-crashlytics do not support any targets other than Android, thus these modules are not available on wasmJs. However, the more generic version of those modules, :ballast-analytics and :ballast-crash-reporting are supported on wasmJs.
  • All other Ballast modules do support wasmJs targets, including :ballast-navigation.
• :ballast-navigation no longer depends on the ktor-http library. It was previously using this library for parsing URIs, but because that library includes a lot of extra stuff related to HTTP that wasn't needed in Ballast Navigation, it increased binary size considerably. URI parsing is now handled by eygraber/uri-kmp. This fixes Issue #35.
• [ballast-schedules]: Slight improvement for using Android WorkManager with BallastScheduler. A new method has been added, SchedulerCallback.configureWorkRequest(), which allows you to configure the OneTimeWorkRequest.Builder. This can be used to apply constraints, mark the job as expedited, etc.

• Updates to Kotlin 1.9.22
• Adds custom toString() implementations for many classes
• ballast-navigation: Adds override of RoutingTable.fromEnum which accepts EnumEntries<T>
• ballast-navigation: Adds override of BallastViewModelConfiguration.Builder.withRouter which accepts a deepLink URL
• Adds ballast-schedules module, for sending Inputs at regularly-scheduled intervals.

• Updates to Kotlin 1.9.10
• The Debugger IntelliJ plugin now has functionality to send States and Inputs to connected ViewModels as JSON, which gets parsed and handled on the device.
• Several API improvements, including some breaking changes. See v4 Migration Guide for full list of changes and instructions for updating your project.

• Fixes regression where awaitViewModelStart() never calls a terminal Flow operator and doesn't actually suspend.

• Fixes regression in BallastSavedStateInterceptor

• Updates to Kotlin 1.8.20
• Drops support for deprecated KMPP targets:
  • JS Legacy
  • iosArm32
• Several API improvements, including some breaking changes. See v3 Migration Guide for full list of changes and instructions for updating your project.

• Adds new experimental ballast-navigation module for handling URL-based routing
• Breaks examples into their own projects, to focus on Ballast itself instead of bogging it down with the overhead of multiplatform architecture.
  • examples/android uses Ballast purely within the older MVC-style Views, showing how the MVI pattern is not limited to Compose or declarative UI toolkits
  • examples/desktop uses Ballast in a Compose Desktop application with Material UI. Most of what's in here could be directly translated into Android Compose with Material UI
  • examples/web uses Ballast in a Compose/Web (DOM) application. In particular, it uses the hash-based Router interceptor, and is what is embedded into the documentation site

• Adds new experimental ballast-sync module for synchronizing ViewModel states. Out-of-the-box only in-memory synchronization is supported, but it is possible to write your own network adapter.
• Adds new experimental ballast-undo module for adding State-based undo/redo functionality to any ViewModel.
• Fixed an issue where exceptions thrown by an Interceptor would crash the entire ViewModel without logging the exception. Now, those exceptions are caught and sent to the BallastLogger as a BallastNotification.UnhandledError.