@angular/material 20.0.0-next.1 → 20.0.0-next.2

package/{module.d-18a67f56.d.ts → module.d-792a497c.d.ts}

@@ -6,20 +6,28 @@ import { FocusOrigin } from '@angular/cdk/a11y';
 import { T as ThemePalette } from './palette.d-ec4a617c.js';
 import { M as MatRippleLoader } from './ripple-loader.d-8aac2988.js';
 
+/**
+ * Possible appearances for a `MatButton`.
+ * See https://m3.material.io/components/buttons/overview
+ */
+type MatButtonAppearance = 'text' | 'filled' | 'elevated' | 'outlined' | 'tonal';
 /** Object that can be used to configure the default options for the button component. */
 interface MatButtonConfig {
     /** Whether disabled buttons should be interactive. */
     disabledInteractive?: boolean;
     /** Default palette color to apply to buttons. */
     color?: ThemePalette;
+    /** Default appearance for plain buttons (not icon buttons or FABs). */
+    defaultAppearance?: MatButtonAppearance;
 }
 /** Injection token that can be used to provide the default options the button component. */
 declare const MAT_BUTTON_CONFIG: InjectionToken<MatButtonConfig>;
-/** Base class for all buttons.  */
+/** Base class for all buttons. */
 declare class MatButtonBase implements AfterViewInit, OnDestroy {
-    _elementRef: ElementRef<any>;
-    _ngZone: NgZone;
-    _animationMode: "NoopAnimations" | "BrowserAnimations" | null;
+    _elementRef: ElementRef<HTMLElement>;
+    protected _ngZone: NgZone;
+    protected _animationMode: "NoopAnimations" | "BrowserAnimations" | null;
+    protected readonly _config: MatButtonConfig | null;
     private readonly _focusMonitor;
     private _cleanupClick;
     private _renderer;
@@ -53,7 +61,9 @@ declare class MatButtonBase implements AfterViewInit, OnDestroy {
     /**
      * Natively disabled buttons prevent focus and any pointer events from reaching the button.
      * In some scenarios this might not be desirable, because it can prevent users from finding out
-     * why the button is disabled (e.g. via tooltip).
+     * why the button is disabled (e.g. via tooltip). This is also useful for buttons that may
+     * become disabled when activated, which would cause focus to be transferred to the document
+     * body instead of remaining on the button.
      *
      * Enabling this input will change the button so that it is styled to be disabled and will be
      * marked as `aria-disabled`, but it will allow the button to receive events and focus.
@@ -91,26 +101,23 @@ declare class MatButtonBase implements AfterViewInit, OnDestroy {
 
 /**
  * Material Design button component. Users interact with a button to perform an action.
- * See https://material.io/components/buttons
- *
- * The `MatButton` class applies to native button elements and captures the appearances for
- * "text button", "outlined button", and "contained button" per the Material Design
- * specification. `MatButton` additionally captures an additional "flat" appearance, which matches
- * "contained" but without elevation.
+ * See https://m3.material.io/components/buttons/overview
  */
 declare class MatButton extends MatButtonBase {
+    /** Appearance of the button. */
+    get appearance(): MatButtonAppearance | null;
+    set appearance(value: MatButtonAppearance | '');
+    private _appearance;
+    constructor(...args: unknown[]);
+    /** Programmatically sets the appearance of the button. */
+    setAppearance(appearance: MatButtonAppearance): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<MatButton, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatButton, "    button[mat-button], button[mat-raised-button], button[mat-flat-button],    button[mat-stroked-button], a[mat-button], a[mat-raised-button], a[mat-flat-button],    a[mat-stroked-button]  ", ["matButton", "matAnchor"], {}, {}, never, [".material-icons:not([iconPositionEnd]), mat-icon:not([iconPositionEnd]), [matButtonIcon]:not([iconPositionEnd])", "*", ".material-icons[iconPositionEnd], mat-icon[iconPositionEnd], [matButtonIcon][iconPositionEnd]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatButton, "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", ["matButton", "matAnchor"], { "appearance": { "alias": "matButton"; "required": false; }; }, {}, never, [".material-icons:not([iconPositionEnd]), mat-icon:not([iconPositionEnd]), [matButtonIcon]:not([iconPositionEnd])", "*", ".material-icons[iconPositionEnd], mat-icon[iconPositionEnd], [matButtonIcon][iconPositionEnd]"], true, never>;
 }
 /**
  * Material Design button component for anchor elements. Anchor elements are used to provide
  * links for the user to navigate across different routes or pages.
- * See https://material.io/components/buttons
- *
- * The `MatAnchor` class applies to native anchor elements and captures the appearances for
- * "text button", "outlined button", and "contained button" per the Material Design
- * specification. `MatAnchor` additionally captures an additional "flat" appearance, which matches
- * "contained" but without elevation.
+ * See https://m3.material.io/components/buttons/overview
  */
 declare const MatAnchor: typeof MatButton;
 type MatAnchor = MatButton;
@@ -137,7 +144,7 @@ declare function MAT_FAB_DEFAULT_OPTIONS_FACTORY(): MatFabDefaultOptions;
 /**
  * Material Design floating action button (FAB) component. These buttons represent the primary
  * or most common action for users to interact with.
- * See https://material.io/components/buttons-floating-action-button/
+ * See https://m3.material.io/components/floating-action-button/overview
  *
  * The `MatFabButton` class has two appearances: normal and extended.
  */
@@ -147,25 +154,25 @@ declare class MatFabButton extends MatButtonBase {
     extended: boolean;
     constructor(...args: unknown[]);
     static ɵfac: i0.ɵɵFactoryDeclaration<MatFabButton, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatFabButton, "button[mat-fab], a[mat-fab]", ["matButton", "matAnchor"], { "extended": { "alias": "extended"; "required": false; }; }, {}, never, [".material-icons:not([iconPositionEnd]), mat-icon:not([iconPositionEnd]), [matButtonIcon]:not([iconPositionEnd])", "*", ".material-icons[iconPositionEnd], mat-icon[iconPositionEnd], [matButtonIcon][iconPositionEnd]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatFabButton, "button[mat-fab], a[mat-fab], button[matFab], a[matFab]", ["matButton", "matAnchor"], { "extended": { "alias": "extended"; "required": false; }; }, {}, never, [".material-icons:not([iconPositionEnd]), mat-icon:not([iconPositionEnd]), [matButtonIcon]:not([iconPositionEnd])", "*", ".material-icons[iconPositionEnd], mat-icon[iconPositionEnd], [matButtonIcon][iconPositionEnd]"], true, never>;
     static ngAcceptInputType_extended: unknown;
 }
 /**
  * Material Design mini floating action button (FAB) component. These buttons represent the primary
  * or most common action for users to interact with.
- * See https://material.io/components/buttons-floating-action-button/
+ * See https://m3.material.io/components/floating-action-button/overview
  */
 declare class MatMiniFabButton extends MatButtonBase {
     private _options;
     _isFab: boolean;
     constructor(...args: unknown[]);
     static ɵfac: i0.ɵɵFactoryDeclaration<MatMiniFabButton, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatMiniFabButton, "button[mat-mini-fab], a[mat-mini-fab]", ["matButton", "matAnchor"], {}, {}, never, [".material-icons:not([iconPositionEnd]), mat-icon:not([iconPositionEnd]), [matButtonIcon]:not([iconPositionEnd])", "*", ".material-icons[iconPositionEnd], mat-icon[iconPositionEnd], [matButtonIcon][iconPositionEnd]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatMiniFabButton, "button[mat-mini-fab], a[mat-mini-fab], button[matMiniFab], a[matMiniFab]", ["matButton", "matAnchor"], {}, {}, never, [".material-icons:not([iconPositionEnd]), mat-icon:not([iconPositionEnd]), [matButtonIcon]:not([iconPositionEnd])", "*", ".material-icons[iconPositionEnd], mat-icon[iconPositionEnd], [matButtonIcon][iconPositionEnd]"], true, never>;
 }
 /**
  * Material Design floating action button (FAB) component for anchor elements. Anchor elements
  * are used to provide links for the user to navigate across different routes or pages.
- * See https://material.io/components/buttons-floating-action-button/
+ * See https://m3.material.io/components/floating-action-button/overview
  *
  * The `MatFabAnchor` class has two appearances: normal and extended.
  */
@@ -174,7 +181,7 @@ type MatFabAnchor = MatFabButton;
 /**
  * Material Design mini floating action button (FAB) component for anchor elements. Anchor elements
  * are used to provide links for the user to navigate across different routes or pages.
- * See https://material.io/components/buttons-floating-action-button/
+ * See https://m3.material.io/components/floating-action-button/overview
  */
 declare const MatMiniFabAnchor: typeof MatMiniFabButton;
 type MatMiniFabAnchor = MatMiniFabButton;
@@ -187,7 +194,7 @@ type MatMiniFabAnchor = MatMiniFabButton;
 declare class MatIconButton extends MatButtonBase {
     constructor(...args: unknown[]);
     static ɵfac: i0.ɵɵFactoryDeclaration<MatIconButton, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatIconButton, "button[mat-icon-button], a[mat-icon-button]", ["matButton", "matAnchor"], {}, {}, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatIconButton, "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", ["matButton", "matAnchor"], {}, {}, never, ["*"], true, never>;
 }
 /**
  * Material Design icon button component for anchor elements. This button displays a single
@@ -203,4 +210,4 @@ declare class MatButtonModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<MatButtonModule>;
 }
 
-export { MAT_BUTTON_CONFIG as M, type MatButtonConfig as a, MatButton as b, MatAnchor as c, type MatFabDefaultOptions as d, MAT_FAB_DEFAULT_OPTIONS as e, MAT_FAB_DEFAULT_OPTIONS_FACTORY as f, MatFabButton as g, MatMiniFabButton as h, MatFabAnchor as i, MatMiniFabAnchor as j, MatIconButton as k, MatIconAnchor as l, MatButtonModule as m };
+export { MAT_BUTTON_CONFIG as M, type MatButtonAppearance as a, type MatButtonConfig as b, MatButton as c, MatAnchor as d, type MatFabDefaultOptions as e, MAT_FAB_DEFAULT_OPTIONS as f, MAT_FAB_DEFAULT_OPTIONS_FACTORY as g, MatFabButton as h, MatMiniFabButton as i, MatFabAnchor as j, MatMiniFabAnchor as k, MatIconButton as l, MatIconAnchor as m, MatButtonModule as n };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/material",
-  "version": "20.0.0-next.1",
+  "version": "20.0.0-next.2",
   "description": "Angular Material",
   "repository": {
     "type": "git",
@@ -353,7 +353,7 @@
     }
   },
   "peerDependencies": {
-    "@angular/cdk": "20.0.0-next.1",
+    "@angular/cdk": "20.0.0-next.2",
     "@angular/core": "^20.0.0-0 || ^20.1.0-0 || ^20.2.0-0 || ^20.3.0-0 || ^21.0.0-0",
     "@angular/common": "^20.0.0-0 || ^20.1.0-0 || ^20.2.0-0 || ^20.3.0-0 || ^21.0.0-0",
     "@angular/forms": "^20.0.0-0 || ^20.1.0-0 || ^20.2.0-0 || ^20.3.0-0 || ^21.0.0-0",

package/paginator/_paginator-theme.scss

@@ -20,7 +20,7 @@
     @include _theme-from-tokens(inspection.get-theme-tokens($theme, color));
   } @else {
     @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values(
+      @include token-utils.create-token-values-mixed(
         tokens-mat-paginator.$prefix,
         tokens-mat-paginator.get-color-tokens($theme)
       );
@@ -33,7 +33,7 @@
     @include _theme-from-tokens(inspection.get-theme-tokens($theme, typography));
   } @else {
     @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values(
+      @include token-utils.create-token-values-mixed(
         tokens-mat-paginator.$prefix,
         tokens-mat-paginator.get-typography-tokens($theme)
       );
@@ -54,7 +54,7 @@
     @include _theme-from-tokens(inspection.get-theme-tokens($theme, density));
   } @else {
     @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values(
+      @include token-utils.create-token-values-mixed(
         tokens-mat-paginator.$prefix,
         tokens-mat-paginator.get-density-tokens($theme)
       );

package/paginator/index.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { m as MatButtonModule } from '../module.d-18a67f56.js';
+import { n as MatButtonModule } from '../module.d-792a497c.js';
 import { M as MatSelectModule } from '../module.d-ba05faa6.js';
 import { M as MatTooltipModule } from '../module.d-74a721b9.js';
 import { M as MatPaginator } from '../paginator.d-40b1766e.js';