macos_ui

✨ New ✨

• Add support for Swift package manager.

🔄 Updated 🔄

• Make text field cursor color follow the user’s accent color if not explicitly set (thanks, @driftwoodstudio).
• Expose the AccentColorListener class to macos_ui users.

🛠️ Fixed 🛠️

• Fix incorrect highlighting and focusing behavior of _MacosPopupMenuItemButton.
• Remove scrolling animation from dropdown menus when manipulating the focus with the keyboard to mimic native macOS behavior.

🛠️ Fixed 🛠️

• Fixed shownByDefault not being respected for the left sidebar of the MacosWindow (thanks, @ShayperCool).

🔄 Updated 🔄

• Expose WindowMainStateListener and implement overrideIsMainWindow method to allow for the window’s main state to be overridden.

🔄 Updated 🔄

• add section parameter to SidebarItem to display an unclickable widget in the sidebar as a section header (thanks, @whirlun).
• Fix incorrect barrier color when calling showMacosSheet when dark mode is enabled.

🛻 Migrated 🛻

• Migrate to Flutter’s new Color API.

🛠️ Fixed 🛠️

• Fix incorrect barrier color when calling showMacosAlertDialog when dark mode is enabled.

🛠️ Fixed 🛠️

• Fix ToolbarOverflowButton only reacting to every second click.

🛠️ Updated 🛠️

• Add “Older macOS versions” section to README
• Add Flutter version constraints to prevent the following error:

  Package validation found the following error:
  * pubspec.yaml allows Flutter SDK version 1.9.x, which does not support the flutter.plugin.platforms key.
    Please consider increasing the Flutter SDK requirement to ^1.10.0 (environment.sdk.flutter)
  

🛠️ Updated 🛠️

• Add expandDisclosureItems flag to SidebarItem to optionally (default not changed) expand disclosure items initially

🛠️ Updated 🛠️

• Fixed SidebarItem text overflowing.

🛠️ Updated 🛠️

• Made most widgets aware of the user’s accent color and window state by adding respective fields to MacosThemeData.
• MacosCheckbox has received a facelift to mimic the look and feel of native macOS checkboxes better.

🛠️ Updated 🛠️

• Implemented value equality for MacosThemeData.

🛠️ Fixed 🛠️

• Fixed MacosRadioButton check null value issue.

What's Changed

• Version 12.2.2 by @GroovinChip in #382
• Version 2.0.0 by @GroovinChip in #463
• Update CONTRIBUTING.md by @Piinks in #466
• Alter copy of mock_canvas to unblock moving to flutter_test by @Piinks in #467
• Fix compilation errors from mock canvas copy by @Piinks in #468
• Resolve #445 by @Adrian-Samoticha in #471
• Remove usages of '@image' directive by @srawlins in #483

New Contributors

• @Piinks made their first contribution in #466
• @srawlins made their first contribution in #483

Full Changelog: 2.0.0...2.0.2

What's Changed

🚨 Breaking Changes 🚨

• macos_ui has been migrated to utilize macos_window_utils under the hood, which provides the following benefits:

  • Window animation smoothness is drastically improved, particularly when miniaturizing and deminiaturizing the application window.
  • Some visual artifacts that occurred while the window was being (de)miniaturized (such as the application's shadow going missing) no longer occur.
  • The sidebar remains transparent when the app's brightness setting mismatches the OS setting.
  • Wallpaper tinting is now supported.
  • To migrate an existing application, please refer to the “Modern window look” section in the README.

• Support for Flutter 3.10 and Dart 3

• PushButton has been updated to support the ControlSize enum.

  • The buttonSize property has been changed to controlSize.
  • Buttons can now be any of the following sizes: mini, small, regular, or large.

• PushButton.isSecondary is now PushButton.secondary.

• MacosAlertDialog: primaryButton and secondaryButton are now declared to be of type PushButton.

• RelevanceIndicator has been deprecated

• MacosTypography white and black are now factory constructors called darkOpaque() and lightOpaque() to reflect
  Apple's naming conventions.

✨ New ✨

• MacosSwitch has been completely rewritten and now matches the native macOS switch in appearance and behavior.
• A ControlSize enum has been introduced, which will allow widgets to more closely match their native counterparts.
• MacosTypography
  • You can now call MacosTypography.of(context) as a shorthand for retrieving the typography used in your MacosTheme.
  • MacosFontWeight allows using Apple-specific font weights like w510, w590, and w860.
• Localization
  • Added support for weekdayAbbreviations and monthAbbreviations to MacosDatePicker.
  • Added support for dateFormat to MacosDatePicker.
  • Added support for startWeekOnMonday to MacosDatePicker.

🔄 Updated 🔄

• MacosColor has been updated with some previously missing elements.
• PushButton
  • Now uses the correct body text style instead of the incorrect headline
• PushButton's secondary and disabled colors more closely match their native counterparts.
• MacosCheckbox appearance more closely matches its native counterpart.
• MacosAlertDialog
  • primaryButton and secondaryButton are now required to have controlSizes of ControlSize.large.
  • Docs now suggest that appIcon should be of size 64x64.
• Toolbar now uses the correct title3 text style instead of the incorrect headline
• MacosTheme sets the global typography more efficiently
• HelpButton now sizes itself according to specification
• ResizablePane can now disallow the usage of its internal scrollbar via the ReziablePane.noScrollBar constructor.

🛠️ Fixed 🛠️

• Clicking on the calendar elements in MacosDatePicker has better UX
• ToolBars in use where a SideBar is not present will now have their title's avoid the traffic lights (native window controls).
• MacosTypography.darkOpaque() and MacosTypography.lightOpaque() now conform to specification by using MacosColors.labelColor
• Ensure builds targeting web do not utilize any macos_window_utils code
• Ensure builds targeting web are themed correctly

New Contributors

• @rxlabz made their first contribution in #398
• @eliasyishak made their first contribution in #402
• @Maksimka101 made their first contribution in #400
• @the-best-is-best made their first contribution in #426
• @bernaferrari made their first contribution in #419

Full Changelog: 1.12.2...2.0.0

What's Changed

• Version 1.12.1 by @GroovinChip in #375
• fix(docs): Remove "+" character from example by @cbenhagen in #363
• fix: typo in month abbreviation by @rklos in #370
• Version 1.12.1 (#375) by @GroovinChip in #378
• Version 1.12.1+1 by @GroovinChip in #379
• When toolbar item is clicked, first pop the route and then call its callback - Fixes #346 by @whiplashoo in #381

New Contributors

• @cbenhagen made their first contribution in #363
• @rklos made their first contribution in #370

Full Changelog: 1.12.1...1.12.2

What's Changed

• fix(docs): Remove "+" character from example by @cbenhagen in #363
• fix: typo in month abbreviation by @rklos in #370

New Contributors

• @cbenhagen made their first contribution in #363
• @rklos made their first contribution in #370

Full Changelog: 1.12.1...1.12.1+1

What's Changed

• release: Version 1.11.1 by @GroovinChip in #367
• Version 1.12.0 by @GroovinChip in #373
• fix(SidebarItem): use theme's primary color instead of hardcoded value by @GroovinChip in #374

Full Changelog: 1.12.0...1.12.1

What's Changed

• feat: Sliver toolbar by @GroovinChip in #368

Full Changelog: 1.11.1...1.12.0

What's Changed

• feat: update flutter_analysis workflow by @GroovinChip in #356
• Bottom resizable pane by @stMerlHin in #349
• fix: SearchField overlay actions are not performed by @FelixMethe in #357

New Contributors

• @FelixMethe made their first contribution in #357

Full Changelog: 1.10.0...1.11.1

What's Changed

• feat: implement MacosDisclosureButton by @Umar1312 in #326
• docs(MacosApp): fix constructor docs error by @GroovinChip in #347
• make CapacityIndicator work with other values of splits, not only splits:10 by @schilken in #305
• Scrollbar overhaul & more by @GroovinChip in #342

New Contributors

• @Umar1312 made their first contribution in #326
• @schilken made their first contribution in #305

Full Changelog: 1.9.1...1.10.0

• Adds optional initialDate to MacosDatePicker

• Implement MacosSlider

• Fixed a bug where MacosPopupButton would report that a ScrollController was not attached to any views

• Addressed Flutter 3.3 analyzer warnings

• Added backgroundColor to MacosSheet

• Fixed an issue where the title property of TitleBar did not apply a fitting DefaultTextStyle

• Fixed an issue where end sidebar window breakpoints were not respected

• ✨ New
  • MacosImageIcon widget. Identical to the ImageIcon from flutter/widgets.dart except it will obey a MacosIconThemeData instead of an IconThemeData
  • SidebarItemSize enum, which determines the height of sidebar items and the maximum size their leading widgets.
  • SidebarItem now accepts an optional trailing widget.
• 🔄 Updated
  • SidebarItems now supports SidebarItemSize via the itemSize property, which defaults to SidebarItemSize.medium. The widget has been updated to manage the item's height, the maximum size of the item's leading widget, and the font size of the item's label widget according to the given SidebarItemSize.
  • The example app has been tweaked to use some icons from the SF Symbols 4 Beta via the new MacosImageIcon widget.

• Correct the placement of the leading widget in disclosure sidebar items #268
• Improve the sizing of the disclosure item indicator

• Adds endSidebar to MacosWindow

• Update pubspec.yaml with repository and new homepage field.

• Fixes an issue where if the app was displayed in full screen mode, an opaque empty toolbar would appear at the top #249

• Migration to Flutter 3.0
  • Minimum dart sdk version is now 2.17.0
  • Use new super parameters feature
  • Update to flutter_lints: ^2.0.1 with subsequent fixes
  • MacosScrollbar API more closely matches its material counterpart
• Update MacosColor to more closely match the Color class
  • Adds MacosColor.fromARGB constructor
  • Adds MacosColor.fromRGBO constructor
  • Adds alphaBlend function
  • Adds getAlphaFromOpacity function

• Add a top property to Sidebar
• Tweak the default primaryColor value in MacosThemeData.

• Fixes issue with error thrown when toolbar actions are modified programmatically #239

• Improved styling for MacosTooltip:
  • Better color and shadows.
  • Displays left-aligned, below the mouse cursor.
• New widget: ToolBarDivider that can be used as a divider (vertical/horizontal line) in the ToolBar #231.
• All toolbar widgets can now receive a tooltipMessage property to display a MacosTooltip when user hovers over them #232.

• Minor improvements to README.md

• New functionality for MacosSearchField
  • Shows a list of search results in an overlay below the field
  • A result can be selected and customized.
• A MacosOverlayFilter widget can now be used to apply the blurry "frosted glass" effect on surfaces.
• New widget: CustomToolbarItem that enables any widget to be used in the Toolbar.

• Minor documentation fix for [MacosColorWell]

• First stable release 🎉

• New widget: MacosTimePicker (textual style only!)

• New widget: MacosColorWell

• New widget: ToolBar, which can be used to create a toolbar at the top of the MacosScaffold. Toolbar items include ToolBarIconButton, ToolBarPulldownButton, and ToolBarSpacer widgets.
• New widget: MacosSearchField, which creates a macOS-style search field.
• Breaking change: the title bar (TitleBar) should now be set via the titlebar property of MacosWindow (was previously a property of MacosScaffold). If you are using a title bar in your app, please note a small change you would need to make in your macos/Runner/MainFlutterWindow.swift file, described in the "Modern window look" section of the README file.
• Fix the graphical version of MacosDatePicker having an incorrect current day text color in light theme

• Minor style fixes for MacosTextField

• Switch over to flutter_lints

• Move theme classes to their own files in the /theme directory

• Improve visual design of MacosPopupButton and MacosPulldownButton, to better match the styling and translucency effect of Apple design.
• Remove unnecessary properties of MacosPopupButton

• Adds missing merge methods to MacosThemeData and widget ThemeData classes, making it possible to use them properly with any number of user-provided custom properties.