Upgrading

1.0.0 → 1.1.0

Update the version in every COUI coordinate you depend on:

kotlin {
    sourceSets {
        commonMain.dependencies {
            implementation("io.github.suqi8.coui.kmp:coui-ui:1.1.0")
            implementation("io.github.suqi8.coui.kmp:coui-preference:1.1.0")
            implementation("io.github.suqi8.coui.kmp:coui-icons:1.1.0")
        }
    }
}

This release recalibrates most components against ColorOS 16 — partly from decompiled resources, partly from measuring the real thing on a device. Two of them corrected values we had inherited from Miuix and never checked. Expect visible changes even where you changed nothing, and give your screens a look after upgrading.

One compile break

InfiniteProgressIndicator lost its orbitingDotSize parameter, along with ProgressIndicatorDefaults.DefaultInfiniteProgressIndicatorOrbitingDotSize. The indicator used to be a ring with a dot orbiting inside it — a Miuix design with no counterpart in COUI, which draws a bare arc whose sweep pulses as it spins. There is no dot left to size.

// Before
InfiniteProgressIndicator(size = 40.dp, strokeWidth = 3.dp, orbitingDotSize = 4.dp)

// After — drop the argument
InfiniteProgressIndicator(size = 40.dp, strokeWidth = 3.dp)

The same arc is also available directly as RotatingProgressIndicator, with the two size tiers COUI ships (16dp and 26dp).

Text is taller

Every entry in COUITheme.textStyles now carries the line-spacing multiplier its COUI text appearance declares, so text occupies more vertical space than it did in 1.0.0. headline1 also dropped from 17sp to 16sp: a preference title measured 21.71dp on a ColorOS 16 device, which is 16sp at COUI's multiplier, not the 17sp Miuix used.

If you sized a container to fit a specific string, re-check it. If you were compensating for the tightness with your own lineHeight, remove it — you will now be adding leading twice.

Rows and dialogs shifted

• A row's height now depends on its position in its card group: a standalone row is 4dp taller than a middle row, and a first or last row 2dp taller, on the edge that is rounded. Nothing changes unless you pass cardListPosition, which every preference component now accepts.
• Dialog button bars stack vertically when a label is too wide to fit, instead of squeezing it. The stacked tier has its own metrics, and the buttons reverse order — cancel moves from the far left to the bottom.
• Dialog bar buttons no longer shrink when pressed, and their press tint fills the whole cell as a square rather than a capsule. Button and TextButton gained pressScaleEnabled for this; it defaults to true, so your own buttons are unaffected.

Dropdown menus behave differently

The flat dropdown was rebuilt around COUI's own gesture model, so the interaction changed rather than just the pixels:

• On a menu short enough not to scroll, dragging moves the highlight between rows and releasing selects whichever row the finger is over — not the one first pressed. Each row crossed fires a haptic. Once the menu scrolls, dragging scrolls it instead.
• A dropdown opened from a preference row now appears at the point you tapped, not centred under the row.
• Menus no longer dim the content behind them. enableWindowDim now defaults to false on OverlayListPopup, WindowListPopup and both cascading popups; pass true if you want the old behaviour.
• Rows are separated by hairlines, and the ones next to the pressed row fade out while it is held.

New in this release

DialogButtonBar (with DialogButtonBarAction) replaces hand-rolled dialog button rows and handles the vertical stacking for you. Dropdown items gained a hint slot for a trailing badge, an alert flag for destructive entries, and DropdownEntry.title for in-menu group headers.

Older versions

Coming from Miuix rather than an earlier COUI release? See Migrating from Miuix.

Changelog

Last edited 12 minutes ago

View full history

e4e915c-docs: add an upgrade guide for 1.1.0