Hello everyone,

we've released OOjs UI 0.19.0 today. It will be in MediaWiki core from 1.29.0-wmf.11, which will be deployed to Wikimedia production in the regular train, starting on Tuesday 07 February. As there are three breaking changes in this release, at least nominally, please carefully look over them to see if they affect your code.

Breaking changes since last release:

* ButtonWidget: Switch `box-sizing` over to `border-box` (Volker E) Switching `box-sizing` to `border-box` value, making it easier to calculate sizes and centralizing occurrences already in use by widgets with buttons. It also aligns with the current way other widgets are internally calculated. A rare, though possible side-effect could be that different sized buttons are changing the layout slightly. If you run into broken layouts with buttons, you'll need to adapt the size, `padding` and `border`.

* LabelElement: Drop no-op fitLabel() method. (James D. Forrester) This was a deprecated no-op since v0.16.0. Note that ProcessDialog#fitLabel() still exists and is not a no-op. We're now removing the old function; if you're still using it, you'll need to switch over.

* WindowManager: Error if `.static.name` is not defined when adding a window (Bartosz Dziewoński) WindowManager was already emitting a warning if `.static.name` was not defined, now it throws an error. If you're still adding windows without it defined, you'll need to do so.

Deprecations since last release: * MessageDialog: Default 'verbose' option to true (James D. Forrester) This was an arbitrary styling choice that eventually became the default in our designs; rather than keep actively choosing it, instead let's just do it always. We'll remove the ability to choose compact styling in an upcoming release.

* icons: Deprecate the 'beta' and 'ribbonPrize' icons (James D. Forrester) If you use them, be prepared that they'll removed from the libary in an upcoming release.

* icons: Rename '*Undo' to 'un*' (James D. Forrester) For consistency: ** blockUndo is now unBlock ** flagUndo is now unFlag ** trashUndo is now unTrash This fits in with the pre-existing unLock and unStar patterns.

* icons: Rename 'betaLaunch' to 'logoWikimediaDiscovery', move pack (James D. Forrester)

Additional details are in the full changelog[0]. If you have any further queries or need help dealing with breaking changes, please let me know. As always, a general set of library documentation is available on mediawiki.org[1], and there is some comprehensive generated code-level documentation and interactive demos hosted on doc.wikimedia.org[2].

[0] - https://phabricator.wikimedia.org/diffusion/GOJU/browse/master/History.md [1] - https://www.mediawiki.org/wiki/OOjs_UI [2] - https://doc.wikimedia.org/oojs-ui/master/

Best, Volker

-- Senior UX Engineer, Editing Wikimedia Foundation

volker.e [at] wikimedia | @Volker_E