widgetbook

• FIX: Rebuild the workbench preview when switching between stories
  of the same component, instead of keeping the previously selected
  story's state.
  (#1994)

• FEAT: Add excludeFromTests to Story and Scenario to skip a
  story or scenario during testWidgetbook snapshot generation while
  keeping it browsable in the app. Excluded items are reported as skipped
  by flutter test.
  (#1978)
• FIX: Reset the image cache between scenarios in testWidgetbook
  so a failed or still-pending image load in one story no longer leaks
  into and fails a later, unrelated one.
  (#1977)

chore(widgetbook): release v4.0.0-beta.9 (#1972)

• FIX: Rebuild the workbench preview when switching stories or
  changing knobs while a viewport is active.
  (#1948)
• FIX: Assign $generatedName to args created via the generated
  _Args.fixed(...) constructor, mirroring the default constructor.
  (#1947)

Releases widgetbook_cli 4.0.0-beta.6 → 4.0.0-beta.7, in sync
with widgetbook (see #1944).

Changes

• version in packages/widgetbook_cli/pubspec.yaml and
  packageVersion in metadata.dart.
• Bumped widgetbookVersion (the widgetbook version installed by
  widgetbook init) 4.0.0-beta.6 → 4.0.0-beta.7, keeping init in
  sync with the latest widgetbook (matches the beta.6 release).
• Renamed the ## Unreleased changelog section to ## 4.0.0-beta.7 and
  added a **FIX** entry for the init version bump.
• cli version variable in docs.json (widgetbook value owned by
  #1944).

Notes

• Pairs with the widgetbook release in #1944 so both packages land on
  4.0.0-beta.7.
• widgetbook init now targets widgetbook 4.0.0-beta.7, so
  widgetbook 4.0.0-beta.7 should be published before/with this for
  init to resolve.
• This and #1944 each edit an adjacent line in docs.json (cli vs
  widgetbook), so whichever merges second may need a trivial conflict
  resolution.

chore(widgetbook): release v3.25.0 (#1949)

• FEAT: Add units parameter to the duration knob to choose which time units (days to microseconds) are shown. (#1915 - by @EArminjon)

• BREAKING: Set minimum Flutter version to 3.44.0. (#1924)

• FEAT: Add defaultToNull parameter to nullable knobs to make them start in a null (i.e. unchecked) state while having a non-null initial value. (#1790 - by @youpelegrace)
• REFACTOR: Allow inspector 4.x. (#1901)
• FEAT: Add headerPadding parameter to customize the padding around the navigation panel header. (#1882 - by @EArminjon)

• FIX: Ensure slider label use max size (#1823 - by @EArminjon)
• BREAKING: Set minimum SDK version to 3.10.0 & minimum Flutter version to 3.38.0. (#1803)

• BREAKING: Set minimum SDK version to 3.9.0 & minimum Flutter version to 3.35.0. (#1803)
• FIX: Hide navigation tree items when search query has no matches; instead of showing the full tree. (#1786 - by @EArminjon)
• REFACTOR: Change DurationField to be 3 inputs with the format of HH:MM:SS instead of a single one for milliseconds. (#1769 - by @youpelegrace)
• FIX: Prevent use-case rebuilds when WidgetbookTheme changes. (#1795 - by @EArminjon)

• FIX: Consider NumberSliderField's min label width when calculating the labels' max width. (#1757 - by @EArminjon)

• REFACTOR: Set minimum accessibility_tools version to 2.6.0. (#1739)

• BREAKING: Set minimum SDK version to 3.8.0 & minimum Flutter version to 3.32.0. (#1719)
• FEAT: Support dynamic knobs. (#1709 - by @EArminjon)
• FEAT: Expose precision parameter in DoubleSliderField and knobs.double.slider. The default value is currently 1, to get the old behavior, set it to null. (#1706 - by @EArminjon)
• FIX: Allow IterableSegmentedField to parse unknown values. (#1703 - by @EArminjon)

• FEAT: Add color picker to ColorField. (#1659 - by @EArminjon)
• FEAT: Add enableLeafComponent parameter to Widgetbook to allow enabling/disabling leaf components (i.e. components with a single use-case) behavior. (#1680 - by @EArminjon)
• FEAT: Add iterable.segmented knob, along with its IterableSegmentedField. (#1678 - by @EArminjon)

• BREAKING: Remove next library. (#1634)

• FIX: Clamp NumSliderField value to avoid exceptions when the boundaries change. (#1590 - by @EArminjon)
• FIX: Upscale SemanticsAddon to make it fill the entire viewport. (#1611 - by @EArminjon)
• REFACTOR: Show selected state in SemanticsAddon. (#1614 - by @EArminjon)

• FEAT: Expose Widgetbook's own scroll behavior to allow customizing it. (#1524 - by @EArminjon)
• FIX: Support Flutter 3.35.0. (#1565)
• REFACTOR: Deprecate WidgetbookLeafComponent in favor of WidgetbookComponent which will now have similar behavior when it has a single use-case. (#1573)
• FIX: Allow knobs to be re-registered. This makes it possible for a knob to mutate other knobs. (#1578 - by @EArminjon)
• FIX: Allow nullable knobs first interaction, by introducing a Field.defaultValue, that will be used for setting the value when initial value is null. (#1581 - by @EArminjon)
• FIX: Re-enable nullified knobs on change. (#1586 - by @EArminjon)

• BREAKING: Set minimum SDK version to 3.7.0 & minimum Flutter version to 3.29.0. (#1541)
• FEAT: Add object.segmented knob. (#1478 - by @Sourav-Sonkar)
• REFACTOR: Deprecate ListField in favor of ObjectDropdownField. (#1541)
• REFACTOR: Deprecate knobs.list in favor of object.dropdown. (#1547)

• REFACTOR: Deprecate DeviceFrameAddon in favor of ViewportAddon. (#1494)
• REFACTOR: Remove @experimental annotation from ViewportAddon. (#1493)
• REFACTOR: Improve API docs. (#1531)
• CHORE: Update license. (#1529)

• FIX: Unify background color between the workbench and DeviceFrameAddon. (#1461 - by @ValentinVignal)
• FIX: Fix memory leaks by disposing WidgetbookState's KnobsRegistry. (#1487 - by @ValentinVignal)
• FIX: Add hints to TextFields to improve accessibility. (#1483 - by @lsaudon)
• FIX: Preserve Viewport's title style when a custom ThemeData is used in the appBuilder. (#1489)
• REFACTOR: Support device_frame_plus v1.5.0. (#1481)

• FIX: Tighten device_frame_plus version constraints; to prevent the breaking changes introduced in v1.4.0. (#1475 - by @Peetee06)

• FIX: Support Flutter 3.32.0. (#1467)

• FEAT: Add header parameter to Widgetbook to allow adding a custom header to the navigation sidebar. (#1443 - by @Sourav-Sonkar)
• FEAT: Add panels query param to show/hide panels when embedding Widgetbook. (#1439)
• FEAT: Rework nullable knobs to allow them to be expressed in the URL. To indicate that a knob is null it can be expressed as ?? (e.g. /?path=my-use-case&knobs={my_knob:??}). (#1450)
• FEAT: Add safeAreas to viewports. (#1452)
• REFACTOR: Remove ViewportData.id in favor of ViewportData.name. (#1454)
• FIX: Ensure a fresh state is used when building the use-case. This prevented some rebuilds from happening, causing knobs to not be registered properly. (#1441)
• FIX: Handle null in durationOrNull knob. (#1444)
• FIX: Unify color knob fields' heights. (#1445)
• FIX: Prevent falling back to initial/default values when changing NumInputField, DurationField and DateTimeField values. (#1446)
• FIX: Rebuild DateTimeField after using the picker. (#1447)

• FIX: Add missing fields to NoneDevice. These fields were introduced in device_frame_plus v1.3.1. (#1430)

• FEAT: Add the experimental (subject to breaking changes) SemanticsAddon. (#1402)
• FEAT: Add a banner to the bottom of the navigation panel that shows the total number of components and use-cases. (#1405)
• FEAT: Add home widget to customize the startup screen. (#1418)
• REFACTOR: Allow inspector package v3. (#1407)
• REFACTOR: Replace device_frame package with device_frame_plus package. (#1411)
• REFACTOR: Change mobile breakpoint to 840px. (#1416 - by @Goddchen)
• FIX: Remove ExcludeSemantics from Widgetbook UI; to allow screen readers. (#1401 - by @Goddchen)

• FEAT: Add the experimental (subject to breaking changes) ViewportAddon alongside its ViewportAddonConfig. This new addon will replace the DeviceFrameAddon in the future. (#1318)

• BREAKING: Set minimum SDK version to 3.3.0 & minimum Flutter version to 3.19.0. (#1349)
• REFACTOR: Deprecate WidgetbookCloudIntegration as it is not used anymore, and can be safely removed. (#1372)

• FEAT: Add WidgetbookState.maybeOf. (#1342 - by @ABausG)

• FIX: Expose WidgetbookScope to allow importing it in tests. (#1325)
• FIX: Allow special characters in search query. (#1293 - by @07Abhinavkapoor)

• REFACTOR: Use a slider instead of a dropdown for TextScaleAddon. The scales parameter is deprecated, and can be removed or replaced with a combination of min, max and divisions parameters if the default values are not sufficient. (#1224 - by @ash14)
• REFACTOR: Expand DropdownMenu to the full width of the sidebar. (#1287)
• REFACTOR: Use tabs instead of accordion for the sidebar. (#1290)

• BREAKING: Set minimum SDK version to 3.0.0 & minimum Flutter version to 3.16.0. (#1243)
• FEAT: Allow changing Widgetbook's theme and mode. (#1225 - by @Mastersam07)
• REFACTOR: Use MediaQuery.textScaler instead of MediaQuery.textScaleFactor for TextScaleAddon. (#1244)
• REFACTOR: Use GridPaper for GridAddon. (#1259)
• FIX: Skip decoding non-ascii characters in URLs. (#1218 - by @shigomany)
• FIX: Encode all fields values to allow reserved characters (e.g. commas, colons and curly brackets). (#1214)
• FIX: Remove default value (i.e. first item) from listOrNull knob. (#1233)

• FIX: Show popup routes (e.g. dialogs and modal sheets) inside the boundaries on the device frame. (#1209)

• FIX: Maintain theme in Flutter v3.22. (#1184)
• FIX: Allow colons (and other special characters) in fields' names. (#1165 - by @maudFrz)
• FIX: Guard list knob against null values when searching. (#1152 - by @bramp)
• REFACTOR: Deprecate AccessibilityAddon in favor of BuilderAddon. Check out the setup guide to know how to migrate. (#1193)

• REFACTOR: Wrap workbench with Scaffold. (#1091)
• FIX: Update DoubleInputField regex to accept more digits before the decimal point. (#1117)
• FIX: Use T codecs for NumInputField; to differentiate between the parsing of double & int. (#1118)
• FIX: Allow negative numbers for numeric field. (#1119)

• FIX: Enable InspectorAddon on release builds. (#1087)
• EXPERIMENTAL: Add EnumArg. (#1073)
• EXPERIMENTAL: Add SingleArg. (#1075)
• EXPERIMENTAL: Add BuilderArg. (#1079)
• EXPERIMENTAL: Change Arg.value to be positional parameter instead of named one. (#1077)
• EXPERIMENTAL: Allow overriding Arg.name. (#1078)
• EXPERIMENTAL: Support custom args via MetaWithArgs. (#1080)
• EXPERIMENTAL: Add args parameter to Story.setup. (#1081)
• EXPERIMENTAL: Use setup in Scenarios. (#1082)
• EXPERIMENTAL: Add LeafComponent. (#1083)
• EXPERIMENTAL: Support optional parameters arg-generation. (#1084)

• REFACTOR: Use const named constructors for Widgetbook, instead of static methods. (#1066)
• EXPERIMENTAL: Add setup to Story. (#1069)

• FIX Ignore deprecated MediaQuery.textScaleFactor; to maintain compatibility with Flutter versions < 3.16.0. (#1053)
• EXPERIMENTAL: Add support for SAM Architecture. (#1064)

• FIX: Use MediaQuery.of(context).size instead of MediaQuery.sizeOf, to maintain compatibility with Flutter v3.7. (#1049)
• FIX: Highlight selected WidgetbookLeafComponent. (#1047)

• BREAKING: Set minimum SDK version to 2.19.0 & minimum Flutter version to 3.7.0. (#1030)
• FEAT: Add mobile support. (#1019 - by @Mastersam07)
• FEAT: Add light theme support. (#919 - by @07Abhinavkapoor)
• FEAT: Introduce WidgetbookLeafComponent navigation node for components with a single use-case. (#1015)
• FEAT: Add designLink to WidgetbookUseCase. (#926 - by @Mastersam07)
• FEAT: Add spaces to color knob. (#986 - by @francescovallone)
• FEAT: Add colorOrNull knob. (#1027)
• FEAT: Add duration knob. (#934 - by @Mastersam07)
• FEAT: Add dateTime knob. (#940 - by @logickoder)
• FEAT: Add int knob. (#942 - by @Mastersam07)
• FEAT: Add Inspector Addon. (#985 - by @Mastersam07)
• FEAT: Add Accessibility Addon. (#1020)
• FEAT: Add Grid Addon. (#943 - by @Mastersam07)
• FEAT: Add Zoom Addon. (#968 - by @Mastersam07)
• FEAT: Add q query param for search. (#950 - by @boredcity)
• FIX: Use MapMixin instead of MapBase for KnobsRegistry. (#903)
• FIX: Maintain navigation panel state on reload. (#932 - by @khurramrizvi)
• FIX: Add default values for slider knobs' parameters. (#1016)
• FIX: Change booleanOrNull knobs's initialValue to null; to match other orNull knobs. (#1026)
• FIX: Add DefaultTextStyle to ThemeAddons. (#1041)
• REFACTOR: Deprecate WidgetbookAddon's initialSetting. Should be replaced by a local field in relevant addons. (#1023)
• REFACTOR: Deprecate Field.onChanged. (#1024)
• REFACTOR: Deprecate Knob.value & KnobsRegistry.updateValue in favor of Knob.initialValue. (#1025)
• REFACTOR: Add default value to color knobs's initialValue parameter. (#1039)

• FEAT: Add Builder Addon. (#895)
• FEAT: Add Experimental Time Dilation Addon. (#887)
• FEAT: Add WidgetbookState.updateQueryField. (#888)
• REFACTOR: Change WidgetbookState.knobs type from Map<String, Knob> to KnobsRegistry. (#885)
• REFACTOR: Deprecate WidgetbookState.updateKnobValue in favor of WidgetbookState.knobs.updateValue. (#885)
• FIX: Remove false overriding for listOrNull knob. (#881)

• BREAKING: DeviceFrameAddon.devices is no longer nullable, in favor of the new NoneDevice. (#854)
• REFACTOR: Support Flutter 3.13.0. (#847)
• REFACTOR: Update DropdownMenu theme. (#844)
• REFACTOR: Make appBuilder optional. (#843)
• REFACTOR: Replace MultiChildNavigationData with WidgetbookNode. (#833)
• REFACTOR: Deprecate WidgetbookUseCase.center in favor of [AlignmentAddon]. (#826)
• FIX: Make path the first query parameter. (#855)
• FIX: Correct initial Checkbox value for null knobs. (#851)
• FIX: Ensure widget is mounted on change. (#814)
• FIX: Allow commas in string knobs. (#817)
• FIX: Correct listOrNull knob type cast. (#818)

• FEAT: Add Alignment Addon. (#798)
• FEAT: Add initialRoute. (#794)
• FEAT: Preserve current state on web after doing hot restart or refresh from the browser. (#782)
• BREAKING: Replace the Scaffold around use-cases with a ColoredBox below the Theme widget. ThemeAddon should be now added to Widgetbook.addons after the DeviceFrameAddon, and not before as in previous versions. (#789)
• FIX: Add Material widget through default appBuilder of Widgetbook.material. (#792)

Check out the migration guide for more information.

• FEAT: Support hot reloading. (#759)
• FEAT: Make side panels resizable. (#738)
• FEAT: Add listOrNull knob. (#741)
• FEAT: Add initialOption to list knob. (#733)
• BREAKING: Create FieldsComposable to unify addons/knobs APIs. (#749)
• REFACTOR: Add SafeArea to device addon. (#760)
• REFACTOR: Move widgetbook_core package to widgetbook package. (#742)
• REFACTOR: Export WidgetbookState. (#724)
• REFACTOR: Export fields to be used for custom addons/knobs. (#728)
• REFACTOR: Make KnobsBuilder.onKnobAdded public. (#727)
• REFACTOR: Add value label to double.slider knob. (#757)
• FIX: Use addons/knobs initial values. (#746)
• FIX: Use related type checks when comparing device's frame state to its query parameter. (#715)
• FIX: Add missing type parameter to LabelBuilder, which affected the list knob. (#718)
• FIX: Use labelBuilder-based string comparison in list knob. (#729)
• FIX: Add key to use cases to prevent out-of-sync builds. (#720)
• Fix: Prevent onNodeSelected from being called if the node is already selected. (#725)
• Fix: Use ListView for SettingsPanel. (#732)
• Fix: Use fresh context while retrieving state to avoid out-of-sync UI. (#751)

• Check out the migration guide for more details.
• FEAT: Add Dart 3 and Flutter 3.10 support. (#676)
• FEAT: Add buildUseCase methods to Addons, that act as micro-appBuilders. (#646)
• FEAT: Add preview query param instead of disable-navigation, disable-properties and panels query params. (#687)
• FEAT: Create WidgetbookState. (#674)
• FEAT: Add integrations and WidgetbookCloudIntegration. (#689)
• BREAKING: Drop Flutter 2 support. (#676)
• BREAKING: Use type-based knob names. (#695)
• BREAKING: Cleanup Addons constructors by removing the setting parameter. (#652)
• BREAKING: Remove FrameAddon in favor of the new DeviceFrameAddon. (#632, #686)
• BREAKING: Rename WidgetbookAddOn to WidgetbookAddon. (#711)
• BREAKING: Remove configureMaterialAddons and configureCupertinoAddons functions. (#677)
• REFACTOR: Drop provider dependency. (#682)
• REFACTOR: Drop go_router dependency. (#625)
• REFACTOR: Drop flutter_bloc dependency. (#705)
• REFACTOR: Drop freezed dependency. (#703)
• REFACTOR: Made Widgetbook's addons parameter optional. (#690)
• FIX: Remove StyledScaffold that made focus not work properly. (#650)

• REFACTOR: :recycle: addon multi property preview.
• REFACTOR: :recycle: removed package analysis_options files.
• REFACTOR: :recycle: warnings.
• REFACTOR: :recycle: AddOn API.
• REFACTOR: :recycle: improve API interface of addons.
• REFACTOR: :recycle: warnings.
• REFACTOR: :recycle: settings.
• REFACTOR: navigation logic.
• REFACTOR: 🛠️ uses new NavigationTree.
• REFACTOR: :recycle: adjust content.
• REFACTOR: :recycle: adjust generator to AddOn implemementation.
• REFACTOR: :zap: refactored addons.
• REFACTOR: DeviceAddon.
• REFACTOR: adjusted code to match linter.
• FIX: :test_tube: fixed broken test.
• FIX: :bug: requires directories to be not empty.
• FIX: :bug: properties resetting when changing locale.
• FIX: :bug: properties not changing on navigate.
• FIX: inserted scaffold messenger.
• FIX: expanding of elements within the navigation is not working.
• FIX: :bug: addons property cannot be empty.
• FIX: navigation tree collapsing and expanding does not work.
• FIX: orientation defaults to landscape.
• FIX: :bug: provider not found.
• FIX: knob values do not update when usecase changes.
• FIX: :bug: remove go_router diagnostics.
• FIX: :bug: improve Canvas.
• FIX: :bug: navigation resets when use case changes.
• FIX: :bug: addons show incorrect item.
• FIX: custom painter Widgets are incorrectly rendered.
• FIX: :bug: hot reload of directories.
• FIX: :bug: selected items not shown for addon.
• FIX: dialog shows up in Widgetbook instead of the simulated device.
• FIX: add packages/widgetbook prefix.
• FIX: change ttf files with fonts.google ones.
• FIX: :bug: ignores country codes.
• FIX: added MediaQuery for WidgetbookDeviceFrame.
• FIX: preview app shows debug banner.
• FIX: preview app shows debug banner in other theme than material.
• FIX: useCaseBuilder is called with old context.
• FEAT: :sparkles: addon multi property preview.
• FEAT: :sparkles: addon routing.
• FEAT: :sparkles: text scale addon.
• FEAT: :sparkles: device addon.
• FEAT: :sparkles: cupertino theme addon.
• FEAT: :sparkles: remove obsolete classes.
• FEAT: :sparkles: theme addon.
• FEAT: :sparkles: Theme needs to be accessible via the app builder function.
• FEAT: :zap: added text knob multiline.
• FEAT: :zap: added text knob multiline.
• FEAT: :zap: added color knob.
• FEAT: add panels query param (#612).
• FEAT: added feature to toggle the orientation of a device.
• FEAT: added textScaleFactors for font accessibility.
• FEAT: :sparkles: addons and localization addon.
• DOCS: added how to use widgetbook with a package.

• FIX(widgetbook): :bug: remove go_router diagnostics. (a5395ee7)

• Update a dependency to the latest release.

• FIX: :bug: requires directories to be not empty. (8e9b7aa1)

• REFACTOR: :recycle: AddOn API. (31734f9e)
• FIX: :bug: addons property cannot be empty. (67e1734f)