• 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.

• Restores the Debugger UI in the Ballast Intellij Plugin
• Removed deprecated AndroidViewModel.attachEventHandler() version that should have been removed in 2.0.0, adds new AndroidViewModel.runOnLifecycle() to combine attaching an eventHandler and observing states with 1 method

• Fixed issue publishing Intellij Plugin

• Updates to Kotlin 1.7.10
• Updates Ktor to 2.1.0
• Updates other dependencies to latest versions
• Removes Debugger UI from IntelliJ plugin, so the that plugin can be republished without the Compose dependency, allowing the templating feature in the latest IntelliJ versions, at least

New/Updated Features

• Adds BootstrapInterceptor for sending an Input when the ViewModel is created, instead of making the UI send the initial Input
• InputStrategy is now typed with the same type parameters as everything else in the DefaultViewModelConfiguration
• Some configuration DSL methods are deprecated:
  • builder.forViewModel() should be replaced with builder.withViewModel().build()
  • BallastRepository now takes BallastViewModelConfiguration in its primary constructor instead of BallastViewModelConfiguration.Builder. Use builder.withRepository().build() instead of the old constructor.
• Adds a configuration callback to BallastSavedStateInterceptor to allow user-specified buffering/filtering on the States as they are sent to be saved

• Update IntelliJ Plugin to support 2022.1.4. It still cannot support 2022.2 or higher because it's blocked by the Compose plugin that it depends on, which does not support 2022.2 yet.

• Don't check for cleared in trySend (fixes #25)
• Improved KDoc documentation for all classes/functions in core module

• Improvements to AndroidViewModel
  • Adds attachEventHandler() override which runs on a CoroutineScope rather than a Lifecycle, which is better-suited for Compose EventHandlers
  • Adds attachEventHandlerOnLifecycle() to be more explicit about when the eventHandler is running on a Lifecycle
  • Original attachEventHandler() is now marked as deprecated, and should be replaced with attachEventHandlerOnLifecycle()
  • Adds observeStatesOnLifecycle() method for more easily collecting states in XML-based Views

• Many improvements to the Intellij plugin
  • Allow Debugger to work with all 1.x.x client versions
  • The Debugger's port can now be changed in the Preferences dialog
  • File templates are now provided to quickly generate components from the Right-click > New menu
  • The values and errors show for inputs, events, states, and sideJobs in the debugger are now more nicely formatted

• Ballast is now considered stable with its first 1.0.0 release!
• Adds Repository fetchWithCache function to observe a Flow rather than emit a one-shot data source
• Adopt Flow/Coroutine adapters from KaMPKit instead of using home-grown ones

• Fix bug in IntelliJ plugin where settings were not being saved
• Removes "sample" from IntelliJ plugin, as that example and several more are available from the documentation site

• Fix several bugs in Debugger UI
  • Kotlin coroutines versions were in conflict and crashing the debugger
  • Timestamps not correctly reported once ViewModel was refreshed
  • Connection Ballast Version not reported correctly once refreshed
• Adds new ballast-saved-state module
• Adds ballast-test API for isolating a single input
• Reverts Coroutines version back to 1.5.2. To use Ballast on iOS with the new memory model, manually include the 1.6.0 dependency

• Attempts to get iOS support working and documented, with M1 Simulator support
• Updates Coroutines to 1.6.0, for the Native's new memory model support

• [BUG FIX] Fix regression in debugger, where you could not view or rollback to previous States.

• [BREAKING CHANGE] Renames ballast-crashlytics module to ballast-firebase-crashlytics
• [BREAKING CHANGE] Renames sideEffect() to sideJob() to be more accurate and less confusing in comparison to other Kotlin MVI libraries.
• [BREAKING CHANGE] BallastViewModel no longer implements the SendChannel interface, it exposes the send and trySend methods directly. It also adds sendAndAwaitCompletion() to send an Input and wait for it to completely finish processing.
• [BREAKING CHANGE] The logger property of BallastViewModelConfiguration.Builder is now a function, which receives the viewModel name when built, to pass as the tag of a logger.
• [BREAKING CHANGE] Moves annotations for Firebase into commonMain and renames them:
  • @FirebaseCrashlyticsInterceptor.Ignore --> @FirebaseCrashlyticsIgnore
  • @FirebaseAnalyticsInterceptor.TrackInput --> @FirebaseAnalyticsTrackInput
• [FUNCTIONAL CHANGE] SideJobs are now posted to the VM immediately, rather than collected and dispatched explicitly after handling. The default implementation still requires that SideJobs are sent as the last statements of the InputHandler, though.
  • By writing a custom InputStrategy.Guardian, you could remove the restriction that sideJobs must be started at the end of the Input. This is dangerous and you shouldn't do it unless you really know what you're doing.
• [BUG FIX] Fixes issue where JS Debugger cannot connect because JS browser websocket clients can't send headers
• [NEW] Adds platform-specific BallastLogger implementations (AndroidBallastLogger, JsConsoleBallastLogger). The default logger of BallastViewModelConfiguration is still NoOpLogger().

• Fixes issue with inputHandler { } and eventHandler { } functions, which previously didn't actually send the input or event to the lambda
• Move all InputHandler checks into the Guardian, so any/all of them could be thrown away by the end-user if needed
• make a dedicated InputStrategyScope to match the pattern of all other pluggable features

• Adds "time-travel debugging" to Debugger IntelliJ plugin! Inputs can now be re-sent, and you can roll back the VM state to any previous point in time
• Makes configuration a builder instead of multiple constructors
• Allow BallastViewModelImpl to access the host VM, so the user-created VM is what's sent to Interceptors
• ViewModels now clear themselves when their coroutine scope is closed, rather than having to do it manually
• Adds a basic Logging facade, so all Ballast components have easy access to a common logger
• Tighten up the overall API a bit, to be more streamlined

• Updates to Kotlin 1.6.10
• Fixes issue running IntelliJ plugin on Windows
• Starts improving the Interceptor API to eventually allow Interceptors to inject Inputs and restore States

• Finishes Debugger UI, fully exposing all states of Inputs, Events, and SideEffects
• Converts Debugger UI to an IntelliJ Plugin, instead of a standalone desktop application
• Adds a few new BallastNotifications, to notify of Inputs and Events being queued, but not yet processed
• Fixed bug where SideEffect errors and cancellation was not being notified properly
• SideEffectcope is now also a CoroutineScope, so you can launch other coroutines directly within the sideEffect(key) { } block without having to manually wrap it in coroutineScope { }

• Fix issue with creating desktop packages.

• Fix issue with creating desktop packages.

This is a major release, with lots of new features, greatly improved safety, but with several significant breaking changes, as descibed below:

• Improves side-effects
  • They are now started through a Channel, instead of relying on a Mutex for safety
  • New BallastInterceptor methods added to track sideEffect starts/errors
  • SideEffects (and related APIs) now require a key to be provided, to avoid accidental restarting cause by disparate Inputs forgetting to provide a key
• Improves safety of ParallelInputStrategy to prevent multiple updates, rather than just throwing an error at the end of the Input handler block if it was used incorrectly
  • Replaces onCompleted callback with a Guardian interface, which each InputStrategy can create for itself to check accesses during the InputHandler, rather than at the end
• Rewrites Interceptor API
  • Instead of an interface, interceptors "events" are sent as a sealed class, BallastNotification. These Notifications are sent to a SharedFlow inside the core ViewModel, and each Interceptor observes this SharedFlow from its own coroutine, launched in the viewModel coroutineScope
• Improves Repository Cached DSL:
  • Adds getValueOrThrow()
  • Adds getCachedOrThrow()
• Introduces Ballast Debugger, a realtime desktop app for observing what is happening within your application's Ballast ViewModels

• Adds Repository module for app-wide caching and communication

• Improves DSL for restarting SideEffects

• Fixes issue with input Channel buffer that didn't do exactly what I expected

• Tweaks API a bit
• SideEffects must now be the last blocks called while handling an Input, to avoid confusion about dispatching the side effect but not actually running until the Input processing has completed

• Adds different strategies for accepting and processing inputs to allow for other use-cases.

• 0.2.0 - 2022-01-05

• Adds ballast-test

• Initial Commit