• Add act.dragUntilVisible() #59

• Support for Flutter 3.22
• Remove unused dependencies #55

• Breaking Offstage support. By default Offstage widgets are not found by spot<W>(). Use spotOffstage().spot<W>() to find them. spotAllWidgets() returns onstage and offstage widgets. Use .overrideWidgetPresence(WidgetPresence.offstage) to modify a WidgetSelector to search for offstage, onstage or combined #45
• New: act.enterText(spot<TextField>(), 'Hello World!') allows to enter text into a EditableText #51
• Negating parents is not yet supported (spot<ListView>().withParent(spot<Scaffold>().atMost(0))). It now throws to prevent unexpected behavior. #50
• act.tap(spot<ElevatedButton>()) now pumps automatically after the tap #52

• Add support for Flutter 3.20
• Update checks to 0.3.0 #48
• Remove deprecated property selector from withProp() and hasProp(). Use elementSelector instead
• Widen test_api version range to include 0.7.X

High-level API changes #

• Breaking spotText('dash') can now return multiple widgets
• New: .atLeast(n) and .atMost(n) and .amount(n) to force the number of expected widgets. .atMost(0) can be used to test that a widget does not exist!
• Deprecated: spotSingle<W>() is now deprecated. Use spot<W>() instead, or spot<W>().atMost(1) to indicate that only a single widget is expected.
• Fix: .first() and .last()
• New: .atIndex(n) allows to get the widget at a specific index (when multiple are found)
• Deprecate: allWidgets in favor of spotAllWidgets() to avoid conflicts with local variables
• New: getDiagnosticProp<T>('name') for easy access to the values of a diagnostic property #40
• New: hasEffectiveTextStyle, withEffectiveTextStyleMatching(), withEffectiveTextStyle() #36, #38
• Improve: WidgetSelector.toString() has been improved, has now separators for stages and adds braces. Example: Center with child SizedBox ❯ with parent (Scaffold ᗕ Row)
• Added tons of documentation and examples

Advanced API changes #

Those changes can be breaking for packages that depend on spot or advanced usages, but should not affect most users.

• Breaking WidgetSelector now has List<ElementFilter> stages, replacing the previous props, parents, children and elementFilters.
• Breaking WidgetSelector constructor and copyWith signature changed, reflecting the new properties. createElementFilters(), createCandidateGenerator() and toStringWithoutParents() have been removed.
• WidgetSelector now has a quantityConstraint property (deprecates expectedQuantity) that allows setting the min and max number of expected widgets.
• WidgetSelector replaces SingleWidgetSelector and MultiWidgetSelector
• Breaking Quantity assertions like .doesNotExist() or .existsOnce() now return WidgetMatcher/MultiWidgetMatcher instead of WidgetSnapshot. To get the WidgetSnapshot use snapshot() instead.
• Breaking Remove WidgetSelector.cast because it lost information and was untested
• Breaking PropFilter has been renamed to PredicateFilter
• Breaking PredicateWithDescription has been removed
• Breaking CandidateGenerator has been removed
• Explicitly export all classes/extensions/functions to prevent accidental leaks of internal APIs

This release contains breaking changes to the "internal" WidgetSelector API. Unless you are using the WidgetSelector directly, you should not be affected by this.

The end-user spot API is not affected.

• Breaking WidgetSelector now has List<ElementFilter> stages, replacing the previous props, parents, children and elementFilters.
• Breaking WidgetSelector constructor and copyWith signature changed, reflecting the new properties. createElementFilters(), createCandidateGenerator() and toStringWithoutParents() have been removed.
• Breaking PropFilter has been renamed to PredicateFilter
• Breaking PredicateWithDescription has been removed
• Breaking CandidateGenerator has been removed
• WidgetSelector.toString() has been improved, has now separators for stages and adds braces. Example: Center with child SizedBox ❯ with parent (Scaffold ᗕ Row)
• Fix .atIndex(n) to be executed at the right time, not after all other filters.

• New getDiagnosticProp<T>('name') for easy access to the values of a diagnostic property #40
• New hasEffectiveTextStyle, withEffectiveTextStyleMatching(), withEffectiveTextStyle() #36, #38
• Tons of documentation and examples #37, #39
• Restructure of internal files

Eventually Breaking, but only the class names. The end user API stays the same.

• spotSingle<W>() is now deprecated. Use spot<W>() instead, or spot<W>().atMost(1) to indicate that only a single widget is expected.
• WidgetSelector replaces SingleWidgetSelector and MultiWidgetSelector
• WidgetSelector now has a quantityConstraint property (deprecates expectedQuantity) that allows setting the min and max number of expected widgets.
• New: .atIndex(n) allows to get the widget at a specific index (when multiple are found)
• Fix: .first() and .last() now work after calling .copyWith()
• Breaking Quantity assertions like .doesNotExist() or .existsOnce() now return WidgetMatcher/MultiWidgetMatcher instead of WidgetSnapshot. To get the WidgetSnapshot use snapshot() instead.
• spotText('a') can now return multiple widgets
• Breaking remove WidgetSelector.cast because it lost information and was untested

• New prop API with hasWidgetProp() makes it easy to filter and assert properties of Widgets. This replaces the old hasProp() method which was based on way to complicated package:checks context.

  // Old ⛈️
  spotSingle<Checkbox>().existsOnce().hasProp(
      selector: (e) => e.context.nest(
        () => ['Checkbox', 'value'],
        (e) => Extracted.value((e.widget as Checkbox).value),
      ),
      match: (it) => it.equals(true),
    );
  

  // New ✨
  spotSingle<Checkbox>().existsOnce().hasWidgetProp(
      prop: widgetProp('value', (widget) => widget.value),
      match: (value) => value.isTrue(),
    );
  

  The prop API is also available for Element and RenderObject.

  ├── Interface "NamedWidgetProp" added 
  ├── Interface "NamedElementProp" added 
  ├── Interface "NamedRenderObjectProp" added 
  ├── Function "widgetProp" added 
  ├── Function "elementProp" added 
  ├── Function "renderObjectProp" added 
  ├─┬ Class SelectorQueries
  │ ├── Method "whereWidgetProp" added 
  │ ├── Method "whereElementProp" added 
  │ └── Method "whereRenderObjectProp" added 
  └─┬ Class WidgetMatcherExtensions
  ├── Method "getWidgetProp" added 
  ├── Method "hasWidgetProp" added 
  ├── Method "getElementProp" added 
  ├── Method "hasElementProp" added 
  ├── Method "getRenderObjectProp" added 
  └── Method "hasRenderObjectProp" added 
  

• Never miss asserting your WidgetSelector. All methods returning a WidgetSelector are now annotated with @useResult. This will cause a lint warning when you only define a WidgetSelector without asserting it.

  spot<FloatingActionButton>().withChild(spotIcon(Icons.add)); // warning, no assertion
    
  final plusFab = spot<FloatingActionButton>().withChild(spotIcon(Icons.add)); // ok, assigned
  spot<FloatingActionButton>().withChild(spotIcon(Icons.add)).existsOnce(); // ok, asserted
  

• It is now easy to directly access the Widget of a SingleWidgetSelector with snapshotWidget(). It also works for the associated Element and RenderObject. Use snapshotElement() and snapshotRenderObject().

  -final checkbox = spotSingle<Checkbox>().snapshot().widget;
  +final checkbox = spotSingle<Checkbox>().snapshotWidget();
  print(checkbox.checkColor);
  

• Add matchers .existsAtMostOnce() and .existsAtMostNTimes(x) #19
• Add selector .withParent(parent)/.withParents([...]) #21
• Add selector .withChild(child)/.withChildren([...]) #21
• Child selectors now only match children #22
• You can call act.tap() now with any WidgetSelector that returns a single widget #23

• Breaking act.tap is now async, use await act.tap() #17
• New: spotText('foo') finds any text on screen using "contains". The new AnyText widget combines Text, SelectableText, RichText and EditableText #18
• New: spotTextWhere((text) => ) allows to match text with custom logic #18
• Deprecated: spotSingleText and spotTexts are deprecated in favor of spotText and the basic spot<Text>(), spot<SelectableText>(), ... #18
• Fix: hasProp matcher can now check for null values with (it) => it.isNull() #18
• Improvement: withDiagnosticProp now falls back to the default value of a DiagnosticNode #18

• Remove unused dependencies. Fixes incompatibility with latest test_api versions #55

• Switch to renderView.size to get the window size

• Added screenshot methods #14

  /// Takes a screenshot of the entire window
  await takeScreenshot();
    
  /// Takes a screenshot of a single Screen/Widget
  final homePage = spotSingle<HomePage>();
  await takeScreenshot(selector: homePage);
    
  /// Use it as extension
  await spotSingle<HomePage>().takeScreenshot();
  

• Export all types from checks.dart which are required to use hasProp
• Update for Flutter 3.13

• Added act.tap(button) to tap widgets #9
• Raise min Flutter version to 3.10.0
• Switch to the official checks package #12
• Rename SingleWidgetSnapshot.discoveredElements -> SingleWidgetSnapshot.discoveredElement #11

• Widen test_api range to support Flutter 3.22

• Export all types from checks.dart which are required to use hasProp

• Fix compilation error with Flutter 3.0.0

• spotTexts now matches EditableText and SelectableText #5
• spotTexts now has generic type <W> instead of static Text. This changes the return type from MultiWidgetSelector<Text> -> MultiWidgetSelector<W> #5
• Changed signature of SingleWidgetSelector.withProp and MultiWidgetSelector.withProp.
• New matchers for EditableText, ListTile, SelectableText

• Support for Flutter 3.0.0 / Dart 2.17

• Fix WidgetSelector with parents that have parents #4
• Require all children selector to match, not just one #4

• Reworked spot API #3
• Allow defining WidgetSelector with children
• Allow defining WidgetSelector with parents
• Interop with Finder API
• Match properties of widgets (via DiagnosticsNode)
• Allow matching of nested properties (with checks API)
• Generate code for custom properties for Flutter widgets
• Allow generating code for properties of 3rd party widgets

• Update package description
• Add issue_tracker link
• Add example folder

• Extraction from wiredash repository