compose-jb/CHANGELOG.md

1.1.1 (Mar 2022)

Desktop

Fixes

• Support textIndent
• Fix cursor placement inside ligature

API changes

• Compose doesn't depend on kotlinx-coroutines-swing

If you use Dispatchers.Swing or Dispatchers.Main in your code, add this dependency into build.gradle.kts:

dependencies {
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-swing:$coroutinesVersion")
}

Also, usage of Dispatchers.Swing or Dispatchers.Main inside internals of Compose is implementation details, and can be changed in the future. If you need to avoid race conditions with Compose UI, you can obtain appropriate coroutine scope via rememberCoroutineScope:

import androidx.compose.runtime.DisposableEffect
import androidx.compose.runtime.remember
import androidx.compose.runtime.rememberCoroutineScope
import androidx.compose.ui.ExperimentalComposeUiApi
import androidx.compose.ui.window.application

@OptIn(ExperimentalComposeUiApi::class, androidx.compose.foundation.ExperimentalFoundationApi::class)
fun main() = application {
    val scope = rememberCoroutineScope()
    val someApplicationObject = remember(scope) { SomeApplicationObject(scope) }
    
    DisposableEffect(Unit) {
        SomeGlobalObject.init(scope)
        onDispose {  }
    }
}

1.1.0 (Feb 2022)

Desktop

Features

• Implement experimental accessibility support for Windows
• Implement accessibility focus tracking by Tab
• All bugfixes/features between Jetpack Compose 1.1.0-beta02 and 1.1.0 (see the release notes for each module here)
• Android target depends on Jetpack Compose 1.1.0.

Fixes

• Fixes for TextField (1, 2, 3, 4)
• Fix exception when we initialize a window with visible = false, undecorated = true
• Fix crash in ImageComposeScene
• Fixes for situations, when hover state doesn't disappear during scrolling
• Fixes for Slider/Scrollbar dragging (1, 2)
• Fixed a case where [event.modifiersEx] does not provide info about the pressed mouse button (AWT)
• Fix TextField crashes after selecting the text and then deactivating the text field
• Fix consuming events by mouse clickable
• Hide top-level dialog from the taskbar

API changes

• The first frame of the window draws offscreen now. If your application has too long start, measure your first frame, and move the heavy logic to background or to the next frames. You can measure the first frame with this snippet:

import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.setValue
import androidx.compose.ui.window.singleWindowApplication

private var time by mutableStateOf(System.nanoTime())
private var frame by mutableStateOf(0)

fun main() = singleWindowApplication {
    if (frame == 0) {
        frame++
    } else if (frame == 1) {
        val duration = ((System.nanoTime() - time) / 1E6).toLong()
        println("First frame millis: $duration")
    }
}

• PointerEvent.awtEvent, KeyEvent.awtEvent are deprecated, use PointerEvent.awtEventOrNull, KeyEvent.awtEventOrNull instead. The event can be null, if it isn't sent by AWT (for example, Compose can send synthetic Move events on relayout)

1.0.1 (Dec 2021)

This is basically 1.0.0 that works with Kotlin 1.6.10

1.0.0 (Dec 2021)

Desktop

Features

• Experimental support for material3
• All clickable components are focusable and react to Enter key
• All clickable/draggable components no longer react to right clicks by default
• Show the default error dialog when an error occurs
• ContextMenu, AlertDialog, DropdownMenu close on Esc key by default
• Application by default calls exitProcess after its Composable is disposed

API changes

• Introduced experimental onPointerEvent (will replace mouseScrollFilter/pointerMoveFilter in the future)
• Introduced PointerEventType.Scroll, which can be used in common code
• MouseEvent.mouseEvent and KeyEvent.nativeKeyEvent are replaced by MouseEvent.awtEvent and KeyEvent.awtEvent
• Experimental overload for loading resources painterResource(String, ResourceLoader)

Web

API changes

• compose.web.widgets is deprecated
• All CSSSelectors can't be instantiated via constructor now (they're private). Please use functions provided in SelectorsScope instead
• Some functions were made internal (either not related to compose-web or not intended for usage in apps): buildCSS , StylePropertyList.nativeEquals , variableValue , buildCSSStyleRule , buildKeyframes , jsObject , CSSKeyframesRule.appendRule
• CSSMediaRule: functions feature and combine were made extensions functions on GenericStyleSheetBuilder. This makes them consistent with the rest of functions which create CSSMediaQuery.MediaFeature instances

1.0.0-beta (Oct 2021)

Common

• no Android artifacts are published anymore. Google-published artifacts are referenced instead. This approach eliminates compatibility issues.

Desktop

Features

• Accessibility support on MacOS
• Smart rendering fallback logic (no crashes on bad hardware/drivers anymore)
• Performance improvement of software rendering (up to 100%)
• Transparent window support
• clickable and toggleable components have a hoverable indication

API changes

• DesktopMaterialTheme is deprecated, use MaterialTheme instead
• WindowSize is deprecated, use DpSize instead
• Modifier.pointerMoveFilter marked as Experimental, stable alternatives are Modifier.hoverable or Modifier.pointerInput
• Modifier.mouseScrollFilter marked as Experimental, this API will likely change in the future

API breaking changes

• Old Window API (AppWindow, AppManager) was removed
• Modifier.pointerIcon is replaced with Modifier.pointerHoverIcon
• Tray can be used only inside ApplicationScope now
• Tray(hint=) replaced with Tray(tooltip=)

Web

Features

• SVG support

API changes

• Controlled Inputs were added
• New API for testing - test-utils was added

1.0.0-alpha (Aug 2021)

Common

• Desktop, Web, and Android artifacts publish at the same time with the same version

Desktop

Features

• Context menu support in selectable text
• Cursor change behavior in text and pointer icon API
• Mouse Clickable modifier
• Tab navigation between text fields by default
• Resource packing to native distribution
• Support @Preview annotation in desktopMain sourceSet's (when the Compose MPP plugin is installed in IDEA)
• New features for Composable menu (icons, shortcuts, mnemonics, radiob buttons, checkboxes
• Adaptive window size
• Support Linux on ARM64
• Support hidpi on some Linux distros
• Support resizing of undecorated resizable windows (Window(undecorated=true, resizable=true, ...))

API changes

• new Window API is no longer experimental
• old Window API is deprecated
• classes from android.compose.desktop.* moved to androidx.compose.ui.awt.* (ComposeWindow, ComposePanel, etc)
• svgResource/vectorXmlResource/imageResource replaced by painterResource

API breaking changes

• Window level keyboard API for the old Window API removed
• Window(icon: BufferedImage) replaced by Window(icon: Painter)
• ContextMenu renamed to CursorDropdownMenu

Web

API changes

• classes behave cumulatively
• removed content builder for empty elements
• Introduce CSS arithmetic operations
• Improved the types of Inputs and input events
• CSS Animations
• All event types expose native properties
• Added a complete list of HTML color aliases
• Introduce support for CSS Grid API
• Deprecate Color.RGB, Color.HSL etc. functions in favor of top-level rgb, hsl an so on
• negate CSSNumeric value directly

API breaking changes

• boolean like attributes don't have any parameters anymore
• removed input type specific event listeners
• replaced maxWidth/minWidth media queries with prefixed names
• Remove CSSVariables context and introduce specialized methods for adding String- and Number-valued CSS variables
• inline style builder was moved into AttributeBuilder scope

M4 (Jun 2021)

• New experimental Composable Window API
• Tooltips
• Use Metal renderer for macOS by default
• Expose a swing mouse event in Modifier.pointerInput
• Improved keyboard support in TextField
• Avoid forcing discrete GPU on multi-GPU MacOS machines in Skiko and native distributions
• Make DropdownMenu focusable by default
• Scrollbar. get rid of itemCount and averageItemSize from rememberScrollbarAdapte
• Support scrollbars for LazyColumn with reverseLayout = true
• Fix memory leak
• Fix Scroll NaN rounding bug, desktop version
• Fix Dragging prevents pointer move events
• Fix Dragging window to another display makes Icon show up incorrectly
• Fix "Padding must be non-negative" after resizing window with Slider and Box
• Breaking change old Dialog/Menubar/Tray are moved to androidx.compose.ui.window.v1

M3 (Feb 2021)

• Improve TextField
• Support SVG
• Support vsync, sync composition with rendering frames
• Support DirectX on Windows by default
• Support software rendering fallback
• Implement signing and notarization for macOS
• Improve Swing interoperability support Swing component in Compose hierarchy
• Support using Compose in IntelliJ plugins
• Skiko native binaries are now signed on macOS (x64 and arm)
• Fix Ambients are not transferred across pop ups
• Fix Laggy UI on Linux
• Fix Using AndroidX Compose specific dependencies for Android target

M2 (Dec 2020)

• Swing interoperability support (Compose in Swing frame)
• Support XML vector images
• Support for Gradle 6.6 and 6.7
• Support macOS 10.13 and 10.14
• Support Apple Silicon (arm64) natively
• Support letter spacing in text
• Implemented desktop "ActualDialog" and "ActualPopup"
• Fix input method bar positioning
• Fix text alignment
• Fix dropdown/popup positioning
• Fix using with Compose in same app as Java FX
• Added screenshots of example apps

M1 (Nov 2020)

• Initial release