werkbank

Prepare for 0.18.2 release

• Add "Side by Side" semantics mode to semantics inspector.
  • In this mode, the normal use case view is shown on one side and its semantics visualization on the other side.
  • This allows you to interact with the use case as well as select semantics nodes at the same time. In contrast the "Inspection" and "Overlay" modes allow you to only do one.
  • You can switch between a vertical and horizontal split.

Prepare for 0.18.1 release

• Add support for flutter 3.38.x

Prepare for 0.18.1+1 release

• Limit slang version to <4.11.0 because of breaking change made without raising the major version.

Prepare for 0.18.0 release

• Add new required themeBrightnessBuilder parameter to AppConfig() and AppConfig.widget() constructors. (BREAKING CHANGE)
  • AppConfig.material() and AppConfig.cupertino() are not affected.
• Improve colorsUseCaseBuilder, textStylesUseCaseBuilder and iconsUseCaseBuilder.
  • They now adapt to the brightness of the use case theme.
  • The design has been improved.
  • colorsUseCaseBuilder now shows a checkerboard pattern behind transparent colors.
  • Add some more parameters for customizability.
  • textStylesUseCaseBuilder now shows properties like fontSize, fontWeight and letterSpacing.
• Make some changes to accessors
  • Rename UseCaseAccessorMixin to UseCaseAccessor in order to be more consistent with other accessor mixins. (BREAKING CHANGE)
  • AddonAccessor.addonsOf(context) has been moved to MaybeWerkbankAppAccessor and WerkbankAppOnlyAccessor and was renamed to addonSpecificationsOf(context). (BREAKING CHANGE)
  • The AddonDescriptionAccessor no longer has access to methods in the WerkbankAppOnlyAccessor. (BREAKING CHANGE)
  • Add new AddonAccessor.addonsOf(context) that returns a list of active addons. (BREAKING CHANGE)
  • Add AddonAccessor.addonByIdOf(context, addonId) to get an addon by its id.
  • Add AddonAccessor.isAddonActive(context, addonId) to check if an addon is active.
• Increase maximum go_router version to 17.x.x.
• Mark release as incompatible with Flutter 3.38.x due to breaking changes in Flutter.
• Add missing properties from SemanticsNode to the semantics inspector. These are indexInParent, tags, linkUrl, locale, validationResult, inputType and controlsNodes.

Limit slang version and prepare for release

• Limit slang version to <4.11.0 because of breaking change made without raising the major version.

Prepare for 0.17.3 release

• When nodes of a tree in the UI become selected, their parents now expand, and they now scroll into view. This applies to:
  • Use cases, components and folders in the navigation panel, when they are selected, for example via the overview.
  • Semantics nodes in the semantics inspector, when they are selected, for example via inspection.
  • The WTreeView component, which now has support for this behavior.
• Add new IDE Live Templates/Snippets to the documentation.
  • Check them out at https://pub.dev/documentation/werkbank/latest/topics/IDE%20Integration-topic.html
• Add static key UseCase.key that can be used in widget tests to verify that the use case widget has been built.

Prepare for 0.17.2 release

• Components now combine their use cases into a single tile in a folder or root overview.
  • The tile will periodically switch between the thumbnails of the contained use cases.
  • Dragging on the pagination dots will switch the thumbnails manually.
  • When overviewing a component itself, the use cases are still shown separately.

Add hotfix and prepare for 0.17.2+1 release

• Fix that switching between the use case thumbnails in a component overview tile was not resetting the state of the use case.

Prepare for 0.17.1 release

• Improve semantics inspector
  • Fix that merged semantics nodes were shown by default.
  • Make showing merged nodes an option. (Hidden by default.)
  • Make showing hidden nodes an option. (Shown by default.)
    • They are always shown in the tree though, because hierarchy information would be lost otherwise.
  • Merged and hidden nodes are now clearly marked as such in the tree.
  • Add the properties isMergedIntoParent, mergeAllDescendantsIntoThisNode and areUserActionsBlocked to the "Active Semantics Node" section.
  • Make background of semantics node visualization boxes slightly more transparent.
  • Add option to change the inspection scope. The choices are:
    • "Use Case" (new default)
      • Only the semantics of the use case itself is shown.
    • "App" (previous implicit behavior)
      • The semantics of the whole use case-app (so the app as defined by the AppConfig, not the whole WerkbankApp) is shown.
      • This scope allows you to see the semantics of routes or other overlays introduced by the use case.
      • However, it usually shows two additional semantics nodes as parents of your use case semantics that are introduced by the app and routing. Most of the time these nodes are not interesting.

Prepare for 0.17.0 release

• Add StateKeepingAddon to keep states in the use case.
  • The feature is similar to knobs, just without controls in the UI and with a support for a wider range of types.
  • Immutable state, like primitive values or data classes, can be added by calling c.states.immutable(...).
  • Mutable state, like controllers, can be added by calling c.states.mutable(...).
  • Read the documentation topic at https://pub.dev/documentation/werkbank/latest/topics/Keeping%20State-topic.html
• Add "Writing Use Cases" documentation topic that provides an overview of techniques you can use to customize your use cases.
  • Give it a read at https://pub.dev/documentation/werkbank/latest/topics/Writing%20Use%20Cases-topic.html
• Update to Flutter 3.35.x. (BREAKING CHANGE)
  • Since we now use the new APIs, you will need to update your Flutter SDK to at least 3.35.0.
• Make changes to BackgroundOption constructors to be more consistent with c.background.<...> functions in the BackgroundComposer.
  • The unnamed BackgroundOption(...) constructor is now BackgroundOption.widget(...). (BREAKING CHANGE)
  • Changed BackgroundOption.color(...) constructor to allow specifying a color directly. (BREAKING CHANGE)
  • The old BackgroundOption.color(...) constructor is now BackgroundOption.colorBuilder(...). (BREAKING CHANGE)
  • The BackgroundOption.builder(...) constructor is now BackgroundOption.widgetBuilder(...). (BREAKING CHANGE)
  • Some parameter names have also been renamed.
• Fix merging behavior of tags.
• Navigating back to home using "ESC" or the top-left project info area no longer clears the search text field
• Fix that Markdown link did not work in some places such as in reports.
• Remove some things related to knobs that were deprecated in 0.16.1. (BREAKING CHANGE)
• Fix that the semantics of backgrounds were not excluded. (For example the checkered background was showing up as an image in the semantics inspector.)

• Increase maximum go_router version to 16.x.x and lower minimum version to 13.1.0. This should lower the risk of dependency conflicts.

• Added a Werkbank System theme, which will always match your system. It's also default now.
• Add a "Knobs" documentation topic which explains how to create your own knobs.
• Deprecate list knob. Use customDropdown instead.
• Rename valueFormatter parameters in doubleSlider and intSlider knobs to valueLabel. The old parameter names are still available but deprecated.
• Add customDropdown knob.
  • Compared to list, some parameters were changed to be more consistent with other knobs.
• Add new knobs with generic return types that allow you to create custom knobs with little effort:
  • c.knobs.customField<T>(...) and c.knobs.customFieldMultiLine<T>(...) (for custom text field controlled knobs)
  • c.knobs.customSlider<T>(...) (for custom slider controlled knobs)
  • c.knobs.customSwitch<T>(...) (for custom switch controlled knobs)
  • And the corresponding nullable variants.
• Add intField and doubleField knobs.
• Add falseLabel and trueLabel parameters to c.knobs.boolean(...) to allow customizing the labels of the switch.
• Rename NullableKnobs to NullableKnobsComposer. The old type is still available but deprecated.
• Improve code documentation of knobs.

• Add c.background.colorBuilder(...) and c.background.widgetBuilder(...) to allow easier use of theme colors in backgrounds.
• Fix that pointer could interact with use case while trying to change constraints.
• Make small changes to the tree UI to make it easier to overview the items and find the selected item.
• Change icons of use cases and components.
• Add WerkbankLogo widget.
• Rename WerkbankSections to WerkbankRoot. (BREAKING CHANGE)
  • This also means that the sections parameter of WerkbankApp has been renamed to root.
• Rename UseCaseControlSection to ConfigureControlSection and InfoControlSection to InspectControlSection. (BREAKING CHANGE)
  • This change should only affect custom addon authors.
  • The tabs had been renamed from "USE CASE" to "CONFIGURE" and from "INFO" to "INSPECT" some time ago. However, these classes were missed.
• Rename UseCaseMetadataBuilder to UseCaseParentBuilder. (BREAKING CHANGE)
• Extend Report's to be collapsible when enabled; this is now used for shortcuts on the homepage.

• Make some improvements to use case descriptions
  • Rename the "About" section for descriptions to "Description".
  • Calling c.description(...) multiple times in the same node will now merge the descriptions instead of always overwriting them.
    • How the descriptions are merged can be controlled by the new mergeStrategy parameter.
  • Added forUseCase parameter for c.description(...) to specify whether the description is for the use case or the current node.
  • The name of a WerkbankFolder or WerkbankComponent is now displayed above its description.
• Fix that semantics inspector in "Inspection" mode would not allow to select semantic boxes in the main view on web.
• Add custom semantics actions to semantics inspector.
• Add advanced search features. TL;DR: fuzzy text, <field>:fuzzy text, "precise text", <field>:"precise text"
• Add ability to check if an addon is active using the UseCaseComposer by doing c.isAddonActive(SomeAddon.addonId).
• Replace a few dependencies and fix lints to make pub.dev happy.

• Initial release