@angular/material 20.1.0-next.1 → 20.1.0-rc.0

package/dialog/_dialog-theme.scss

@@ -1,48 +1,44 @@
 @use 'sass:map';
-@use '../core/style/sass-utils';
 @use './m2-dialog';
 @use './m3-dialog';
 @use '../core/tokens/token-utils';
-@use '../core/theming/theming';
 @use '../core/theming/inspection';
 @use '../core/typography/typography';
 
 @mixin base($theme) {
+  $tokens: map.get(m2-dialog.get-tokens($theme), base);
   @if inspection.get-theme-version($theme) == 1 {
-    @include token-utils.create-token-values(map.get(m3-dialog.get-tokens($theme), base));
-  } @else {
-    // Add default values for tokens not related to color, typography, or density.
-    @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values-mixed(m2-dialog.get-unthemable-tokens());
-    }
+    $tokens: map.get(m3-dialog.get-tokens($theme), base);
   }
+
+  @include token-utils.values($tokens);
 }
 
 @mixin color($theme) {
+  $tokens: map.get(m2-dialog.get-tokens($theme), color);
   @if inspection.get-theme-version($theme) == 1 {
-    @include token-utils.create-token-values(map.get(m3-dialog.get-tokens($theme), color));
-  } @else {
-    @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values-mixed(m2-dialog.get-color-tokens($theme));
-    }
+    $tokens: map.get(m3-dialog.get-tokens($theme), color);
   }
+
+  @include token-utils.values($tokens);
 }
 
 @mixin typography($theme) {
+  $tokens: map.get(m2-dialog.get-tokens($theme), typography);
   @if inspection.get-theme-version($theme) == 1 {
-    @include token-utils.create-token-values(map.get(m3-dialog.get-tokens($theme), typography));
-  } @else {
-    @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values-mixed(m2-dialog.get-typography-tokens($theme));
-    }
+    $tokens: map.get(m3-dialog.get-tokens($theme), typography);
   }
+
+  @include token-utils.values($tokens);
 }
 
 @mixin density($theme) {
+  $tokens: map.get(m2-dialog.get-tokens($theme), density);
   @if inspection.get-theme-version($theme) == 1 {
-    @include token-utils.create-token-values(map.get(m3-dialog.get-tokens($theme), density));
-  } @else {
+    $tokens: map.get(m3-dialog.get-tokens($theme), density);
   }
+
+  @include token-utils.values($tokens);
 }
 
 /// Defines the tokens that will be available in the `overrides` mixin and for docs extraction.
@@ -60,23 +56,21 @@
 }
 
 @mixin theme($theme) {
-  @include theming.private-check-duplicate-theme-styles($theme, 'mat-dialog') {
-    @if inspection.get-theme-version($theme) == 1 {
-      @include base($theme);
+  @if inspection.get-theme-version($theme) == 1 {
+    @include base($theme);
+    @include color($theme);
+    @include density($theme);
+    @include typography($theme);
+  } @else {
+    @include base($theme);
+    @if inspection.theme-has($theme, color) {
       @include color($theme);
+    }
+    @if inspection.theme-has($theme, density) {
       @include density($theme);
+    }
+    @if inspection.theme-has($theme, typography) {
       @include typography($theme);
-    } @else {
-      @include base($theme);
-      @if inspection.theme-has($theme, color) {
-        @include color($theme);
-      }
-      @if inspection.theme-has($theme, density) {
-        @include density($theme);
-      }
-      @if inspection.theme-has($theme, typography) {
-        @include typography($theme);
-      }
     }
   }
 }

package/dialog/_m2-dialog.scss

@@ -1,57 +1,43 @@
 @use '../core/style/elevation';
-@use '../core/theming/inspection';
 @use '../core/tokens/m2-utils';
 @use 'sass:map';
 
-// Tokens that can't be configured through Angular Material's current theming API,
-// but may be in a future version of the theming API.
-@function get-unthemable-tokens() {
-  @return (
-    dialog-container-shape: 4px,
-    dialog-container-elevation-shadow: elevation.get-box-shadow(24),
-    dialog-container-max-width: 80vw,
-    dialog-container-small-max-width: 80vw,
-    dialog-container-min-width: 0,
-    dialog-actions-alignment: start,
-    dialog-actions-padding: 8px,
-    dialog-content-padding: 20px 24px,
-    dialog-with-actions-content-padding: 20px 24px,
-
-    // Note: the CSS class is `title` while the M2 tokens call it `subhead`.
-    // M3 calls it `headline` which is what we're aligning with.
-    dialog-headline-padding: 0 24px 9px,
-  );
-}
-
-// Tokens that can be configured through Angular Material's color theming API.
-@function get-color-tokens($theme) {
+@function get-tokens($theme) {
   $system: m2-utils.get-system($theme);
-  @return (
-    dialog-container-color: map.get($system, surface),
-    dialog-subhead-color: map.get($system, on-surface),
-    dialog-supporting-text-color: map.get($system, on-surface-variant),
-  );
-}
 
-// Tokens that can be configured through Angular Material's typography theming API.
-@function get-typography-tokens($theme) {
   @return (
-    dialog-subhead-font: inspection.get-theme-typography($theme, headline-6, font-family),
-    dialog-subhead-line-height: inspection.get-theme-typography($theme, headline-6, line-height),
-    dialog-subhead-size: inspection.get-theme-typography($theme, headline-6, font-size),
-    dialog-subhead-weight: inspection.get-theme-typography($theme, headline-6, font-weight),
-    dialog-subhead-tracking: inspection.get-theme-typography($theme, headline-6, letter-spacing),
-    dialog-supporting-text-font: inspection.get-theme-typography($theme, body-1, font-family),
-    dialog-supporting-text-line-height:
-        inspection.get-theme-typography($theme, body-1, line-height),
-    dialog-supporting-text-size: inspection.get-theme-typography($theme, body-1, font-size),
-    dialog-supporting-text-weight: inspection.get-theme-typography($theme, body-1, font-weight),
-    dialog-supporting-text-tracking:
-        inspection.get-theme-typography($theme, body-1, letter-spacing),
-  );
-}
+    base: (
+      dialog-container-shape: 4px,
+      dialog-container-elevation-shadow: elevation.get-box-shadow(24),
+      dialog-container-max-width: 80vw,
+      dialog-container-small-max-width: 80vw,
+      dialog-container-min-width: 0,
+      dialog-actions-alignment: start,
+      dialog-actions-padding: 8px,
+      dialog-content-padding: 20px 24px,
+      dialog-with-actions-content-padding: 20px 24px,
 
-// Tokens that can be configured through Angular Material's density theming API.
-@function get-density-tokens($theme) {
-  @return ();
+      // Note: the CSS class is `title` while the M2 tokens call it `subhead`.
+      // M3 calls it `headline` which is what we're aligning with.
+      dialog-headline-padding: 0 24px 9px,
+    ),
+    color: (
+      dialog-container-color: map.get($system, surface),
+      dialog-subhead-color: map.get($system, on-surface),
+      dialog-supporting-text-color: map.get($system, on-surface-variant),
+    ),
+    typography: (
+      dialog-subhead-font: map.get($system, title-small-font),
+      dialog-subhead-line-height: map.get($system, title-small-line-height),
+      dialog-subhead-size: map.get($system, title-small-size),
+      dialog-subhead-weight: map.get($system, title-small-weight),
+      dialog-subhead-tracking: map.get($system, title-small-tracking),
+      dialog-supporting-text-font: map.get($system, body-large-font),
+      dialog-supporting-text-line-height: map.get($system, body-large-line-height),
+      dialog-supporting-text-size: map.get($system, body-large-size),
+      dialog-supporting-text-weight: map.get($system, body-large-weight),
+      dialog-supporting-text-tracking: map.get($system, body-large-tracking),
+    ),
+    density: (),
+  );
 }

package/divider/_divider-theme.scss

@@ -1,43 +1,43 @@
 @use 'sass:map';
-@use '../core/style/sass-utils';
-@use '../core/theming/theming';
 @use '../core/theming/inspection';
 @use '../core/tokens/token-utils';
 @use './m2-divider';
 @use './m3-divider';
 
 @mixin base($theme) {
+  $tokens: map.get(m2-divider.get-tokens($theme), base);
   @if inspection.get-theme-version($theme) == 1 {
-    @include token-utils.create-token-values(map.get(m3-divider.get-tokens($theme), base));
-  } @else {
-    @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values-mixed(m2-divider.get-unthemable-tokens());
-    }
+    $tokens: map.get(m3-divider.get-tokens($theme), base);
   }
+
+  @include token-utils.values($tokens);
 }
 
 @mixin color($theme) {
+  $tokens: map.get(m2-divider.get-tokens($theme), color);
   @if inspection.get-theme-version($theme) == 1 {
-    @include token-utils.create-token-values(map.get(m3-divider.get-tokens($theme), color));
-  } @else {
-    @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values-mixed(m2-divider.get-color-tokens($theme));
-    }
+    $tokens: map.get(m3-divider.get-tokens($theme), color);
   }
+
+  @include token-utils.values($tokens);
 }
 
 @mixin typography($theme) {
+  $tokens: map.get(m2-divider.get-tokens($theme), typography);
   @if inspection.get-theme-version($theme) == 1 {
-    @include token-utils.create-token-values(map.get(m3-divider.get-tokens($theme), typography));
-  } @else {
+    $tokens: map.get(m3-divider.get-tokens($theme), typography);
   }
+
+  @include token-utils.values($tokens);
 }
 
 @mixin density($theme) {
+  $tokens: map.get(m2-divider.get-tokens($theme), density);
   @if inspection.get-theme-version($theme) == 1 {
-    @include token-utils.create-token-values(map.get(m3-divider.get-tokens($theme), density));
-  } @else {
+    $tokens: map.get(m3-divider.get-tokens($theme), density);
   }
+
+  @include token-utils.values($tokens);
 }
 
 /// Defines the tokens that will be available in the `overrides` mixin and for docs extraction.
@@ -55,23 +55,21 @@
 }
 
 @mixin theme($theme) {
-  @include theming.private-check-duplicate-theme-styles($theme, 'mat-divider') {
-    @if inspection.get-theme-version($theme) == 1 {
-      @include base($theme);
+  @if inspection.get-theme-version($theme) == 1 {
+    @include base($theme);
+    @include color($theme);
+    @include density($theme);
+    @include typography($theme);
+  } @else {
+    @include base($theme);
+    @if inspection.theme-has($theme, color) {
       @include color($theme);
+    }
+    @if inspection.theme-has($theme, density) {
       @include density($theme);
+    }
+    @if inspection.theme-has($theme, typography) {
       @include typography($theme);
-    } @else {
-      @include base($theme);
-      @if inspection.theme-has($theme, color) {
-        @include color($theme);
-      }
-      @if inspection.theme-has($theme, density) {
-        @include density($theme);
-      }
-      @if inspection.theme-has($theme, typography) {
-        @include typography($theme);
-      }
     }
   }
 }

package/divider/_m2-divider.scss

@@ -1,28 +1,17 @@
 @use '../core/tokens/m2-utils';
 @use 'sass:map';
 
-// Tokens that can't be configured through Angular Material's current theming API,
-// but may be in a future version of the theming API.
-@function get-unthemable-tokens() {
-  @return (
-    divider-width: 1px
-  );
-}
-
-// Tokens that can be configured through Angular Material's color theming API.
-@function get-color-tokens($theme) {
+@function get-tokens($theme) {
   $system: m2-utils.get-system($theme);
+
   @return (
-    divider-color: map.get($system, outline)
+    base: (
+      divider-width: 1px
+    ),
+    color: (
+      divider-color: map.get($system, outline)
+    ),
+    typography: (),
+    density: (),
   );
 }
-
-// Tokens that can be configured through Angular Material's typography theming API.
-@function get-typography-tokens($theme) {
-  @return ();
-}
-
-// Tokens that can be configured through Angular Material's density theming API.
-@function get-density-tokens($theme) {
-  @return ();
-}

package/expansion/_expansion-theme.scss

@@ -1,53 +1,44 @@
 @use 'sass:map';
-@use '../core/theming/theming';
 @use '../core/theming/inspection';
 @use '../core/typography/typography';
-@use '../core/style/sass-utils';
 @use '../core/tokens/token-utils';
 @use './m2-expansion';
 @use './m3-expansion';
 
 @mixin base($theme) {
+  $tokens: map.get(m2-expansion.get-tokens($theme), base);
   @if inspection.get-theme-version($theme) == 1 {
-    @include token-utils.create-token-values(map.get(m3-expansion.get-tokens($theme), base));
-  } @else {
-    @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values-mixed(m2-expansion.get-unthemable-tokens());
-    }
+    $tokens: map.get(m3-expansion.get-tokens($theme), base);
   }
+
+  @include token-utils.values($tokens);
 }
 
 @mixin color($theme) {
+  $tokens: map.get(m2-expansion.get-tokens($theme), color);
   @if inspection.get-theme-version($theme) == 1 {
-    @include token-utils.create-token-values(map.get(m3-expansion.get-tokens($theme), color));
-  } @else {
-    @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values-mixed(m2-expansion.get-color-tokens($theme));
-    }
+    $tokens: map.get(m3-expansion.get-tokens($theme), color);
   }
+
+  @include token-utils.values($tokens);
 }
 
 @mixin typography($theme) {
+  $tokens: map.get(m2-expansion.get-tokens($theme), typography);
   @if inspection.get-theme-version($theme) == 1 {
-    @include token-utils.create-token-values(map.get(m3-expansion.get-tokens($theme), typography));
-  } @else {
-    // TODO(mmalerba): Stop calling this and resolve resulting screen diffs.
-    $theme: inspection.private-get-typography-back-compat-theme($theme);
-
-    @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values-mixed(m2-expansion.get-typography-tokens($theme));
-    }
+    $tokens: map.get(m3-expansion.get-tokens($theme), typography);
   }
+
+  @include token-utils.values($tokens);
 }
 
 @mixin density($theme) {
+  $tokens: map.get(m2-expansion.get-tokens($theme), density);
   @if inspection.get-theme-version($theme) == 1 {
-    @include token-utils.create-token-values(map.get(m3-expansion.get-tokens($theme), density));
-  } @else {
-    @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values-mixed(m2-expansion.get-density-tokens($theme));
-    }
+    $tokens: map.get(m3-expansion.get-tokens($theme), density);
   }
+
+  @include token-utils.values($tokens);
 }
 
 /// Defines the tokens that will be available in the `overrides` mixin and for docs extraction.
@@ -65,23 +56,21 @@
 }
 
 @mixin theme($theme) {
-  @include theming.private-check-duplicate-theme-styles($theme, 'mat-expansion') {
-    @if inspection.get-theme-version($theme) == 1 {
-      @include base($theme);
+  @if inspection.get-theme-version($theme) == 1 {
+    @include base($theme);
+    @include color($theme);
+    @include density($theme);
+    @include typography($theme);
+  } @else {
+    @include base($theme);
+    @if inspection.theme-has($theme, color) {
       @include color($theme);
+    }
+    @if inspection.theme-has($theme, density) {
       @include density($theme);
+    }
+    @if inspection.theme-has($theme, typography) {
       @include typography($theme);
-    } @else {
-      @include base($theme);
-      @if inspection.theme-has($theme, color) {
-        @include color($theme);
-      }
-      @if inspection.theme-has($theme, density) {
-        @include density($theme);
-      }
-      @if inspection.theme-has($theme, typography) {
-        @include typography($theme);
-      }
     }
   }
 }

package/expansion/_m2-expansion.scss

@@ -1,79 +1,64 @@
 @use 'sass:map';
 @use '../core/theming/theming';
-@use '../core/theming/inspection';
 @use '../core/tokens/m2-utils';
 @use '../core/tokens/m3-utils';
+@use '../core/style/elevation';
 
-// Tokens that can't be configured through Angular Material's current theming API,
-// but may be in a future version of the theming API.
-@function get-unthemable-tokens() {
-  @return (
-    expansion-container-shape: 4px,
-    expansion-legacy-header-indicator-display: inline-block,
-    expansion-header-indicator-display: none,
-  );
-}
-
-// Tokens that can be configured through Angular Material's color theming API.
-@function get-color-tokens($theme) {
+@function get-tokens($theme) {
   $system: m2-utils.get-system($theme);
-  @return (
-    expansion-container-background-color: map.get($system, surface),
-    expansion-container-text-color: map.get($system, on-surface),
-    expansion-actions-divider-color: map.get($system, outline),
-    expansion-header-hover-state-layer-color: m3-utils.color-with-opacity(
-        map.get($system, on-surface), map.get($system, hover-state-layer-opacity)),
-    expansion-header-focus-state-layer-color: m3-utils.color-with-opacity(
-        map.get($system, on-surface), map.get($system, focus-state-layer-opacity)),
-    expansion-header-disabled-state-text-color:
-        m3-utils.color-with-opacity(map.get($system, on-surface), 38%),
-    expansion-header-text-color: map.get($system, on-surface),
-    expansion-header-description-color: map.get($system, on-surface-variant),
-    expansion-header-indicator-color: map.get($system, on-surface-variant),
-  );
-}
+  $density-scale: theming.clamp-density(map.get($system, density-scale), -3);
 
-// Tokens that can be configured through Angular Material's typography theming API.
-@function get-typography-tokens($theme) {
   @return (
-    expansion-header-text-font: inspection.get-theme-typography($theme, subtitle-2, font-family),
-    expansion-header-text-size: inspection.get-theme-typography($theme, subtitle-2, font-size),
-    expansion-header-text-weight: inspection.get-theme-typography($theme, subtitle-2, font-weight),
+    base: (
+      expansion-container-shape: 4px,
+      expansion-container-elevation-shadow: elevation.get-box-shadow(2),
+      expansion-legacy-header-indicator-display: inline-block,
+      expansion-header-indicator-display: none,
+    ),
+    color: (
+      expansion-container-background-color: map.get($system, surface),
+      expansion-container-text-color: map.get($system, on-surface),
+      expansion-actions-divider-color: map.get($system, outline),
+      expansion-header-hover-state-layer-color: m3-utils.color-with-opacity(
+          map.get($system, on-surface), map.get($system, hover-state-layer-opacity)),
+      expansion-header-focus-state-layer-color: m3-utils.color-with-opacity(
+          map.get($system, on-surface), map.get($system, focus-state-layer-opacity)),
+      expansion-header-disabled-state-text-color:
+          m3-utils.color-with-opacity(map.get($system, on-surface), 38%),
+      expansion-header-text-color: map.get($system, on-surface),
+      expansion-header-description-color: map.get($system, on-surface-variant),
+      expansion-header-indicator-color: map.get($system, on-surface-variant),
+    ),
+    typography: (
+      expansion-header-text-font: map.get($system, label-medium-font),
+      expansion-header-text-size: map.get($system, label-medium-size),
+      expansion-header-text-weight: map.get($system, label-medium-weight),
 
-    // TODO(crisbeto): these two properties weren't set at all before the introduction of tokens,
-    // but it's inconsistent not to provide them since the container sets all of them. Eventually
-    // we should change the values to use come from `subtitle-2`.
-    expansion-header-text-line-height: inherit,
-    expansion-header-text-tracking: inherit,
+      // TODO(crisbeto): these two properties weren't set at all before the introduction of tokens,
+      // but it's inconsistent not to provide them since the container sets all of them. Eventually
+      // we should change the values to use come from `subtitle-2`.
+      expansion-header-text-line-height: inherit,
+      expansion-header-text-tracking: inherit,
 
-    expansion-container-text-font: inspection.get-theme-typography($theme, body-2, font-family),
-    expansion-container-text-line-height:
-        inspection.get-theme-typography($theme, body-2, line-height),
-    expansion-container-text-size: inspection.get-theme-typography($theme, body-2, font-size),
-    expansion-container-text-tracking:
-        inspection.get-theme-typography($theme, body-2, letter-spacing),
-    expansion-container-text-weight: inspection.get-theme-typography($theme, body-2, font-weight),
-  );
-}
-
-// Tokens that can be configured through Angular Material's density theming API.
-@function get-density-tokens($theme) {
-  $scale: theming.clamp-density(inspection.get-theme-density($theme), -3);
-  $collapsed-scale: (
-    0: 48px,
-    -1: 44px,
-    -2: 40px,
-    -3: 36px,
-  );
-  $expanded-scale: (
-    0: 64px,
-    -1: 60px,
-    -2: 56px,
-    -3: 48px,
-  );
-
-  @return (
-    expansion-header-collapsed-state-height: map.get($collapsed-scale, $scale),
-    expansion-header-expanded-state-height: map.get($expanded-scale, $scale),
+      expansion-container-text-font: map.get($system, body-medium-font),
+      expansion-container-text-line-height: map.get($system, body-medium-line-height),
+      expansion-container-text-size: map.get($system, body-medium-size),
+      expansion-container-text-tracking: map.get($system, body-medium-tracking),
+      expansion-container-text-weight: map.get($system, body-medium-weight),
+    ),
+    density: (
+      expansion-header-collapsed-state-height: map.get((
+        0: 48px,
+        -1: 44px,
+        -2: 40px,
+        -3: 36px,
+      ), $density-scale),
+      expansion-header-expanded-state-height: map.get((
+        0: 64px,
+        -1: 60px,
+        -2: 56px,
+        -3: 48px,
+      ), $density-scale),
+    ),
   );
 }

package/expansion/_m3-expansion.scss

@@ -2,8 +2,8 @@
 @use 'sass:list';
 @use '../core/tokens/m3-utils';
 @use '../core/theming/theming';
-@use '../core/theming/inspection';
 @use '../core/tokens/m3';
+@use '../core/style/elevation';
 
 // The prefix used to generate the fully qualified name for tokens in this file.
 $prefix: (mat, expansion);
@@ -17,6 +17,7 @@ $prefix: (mat, expansion);
       expansion-container-shape: 12px,
       expansion-header-indicator-display: inline-block,
       expansion-legacy-header-indicator-display: none,
+      expansion-container-elevation-shadow: elevation.get-box-shadow(2),
     ),
     color: (
       expansion-actions-divider-color: map.get($system, outline),
@@ -44,7 +45,7 @@ $prefix: (mat, expansion);
       expansion-header-text-tracking: map.get($system, title-medium-tracking),
       expansion-header-text-weight: map.get($system, title-medium-weight),
     ),
-    density: get-density-tokens(map.get($theme, inspection.$internals, density-scale)),
+    density: get-density-tokens(map.get($system, density-scale)),
   );
 }
 

package/fesm2022/autocomplete.mjs

@@ -15,7 +15,7 @@ import { TemplatePortal } from '@angular/cdk/portal';
 import { coerceArray } from '@angular/cdk/coercion';
 import { NG_VALUE_ACCESSOR } from '@angular/forms';
 import { filter, map, startWith, switchMap, tap, delay, take } from 'rxjs/operators';
-import { h as MAT_FORM_FIELD } from './form-field-C9DZXojn.mjs';
+import { h as MAT_FORM_FIELD } from './form-field-CFbrnFED.mjs';
 import { M as MatOptionModule } from './index-DwiL-HGk.mjs';
 import { M as MatCommonModule } from './common-module-cKSwHniA.mjs';
 import './ripple-BYgV4oZC.mjs';

package/fesm2022/button/testing.mjs

@@ -3,10 +3,13 @@ import { ContentContainerComponentHarness, HarnessPredicate } from '@angular/cdk
 
 /** Harness for interacting with a mat-button in tests. */
 class MatButtonHarness extends ContentContainerComponentHarness {
-    // TODO(jelbourn) use a single class, like `.mat-button-base`
-    static hostSelector = `[matButton], [mat-button], [matIconButton], [matFab], [matMiniFab],
-    [mat-raised-button], [mat-flat-button], [mat-icon-button], [mat-stroked-button], [mat-fab],
-    [mat-mini-fab]`;
+    // Note: `.mat-mdc-button-base` should be enough for all buttons, however some apps are using
+    // the harness without actually having an applied button. Keep the attributes for backwards
+    // compatibility.
+    /** Selector for the harness. */
+    static hostSelector = `.mat-mdc-button-base, [matButton], [mat-button], [matIconButton],
+    [matFab], [matMiniFab], [mat-raised-button], [mat-flat-button], [mat-icon-button],
+    [mat-stroked-button], [mat-fab], [mat-mini-fab]`;
     /**
      * Gets a `HarnessPredicate` that can be used to search for a button with specific attributes.
      * @param options Options for narrowing the search: