@angular/material 19.2.3 → 20.0.0-next.1

package/progress-spinner/index.d.ts

@@ -1,103 +1,14 @@
+import { M as MatProgressSpinner } from '../progress-spinner.d-1fc040c5.js';
+export { b as MAT_PROGRESS_SPINNER_DEFAULT_OPTIONS, c as MAT_PROGRESS_SPINNER_DEFAULT_OPTIONS_FACTORY, M as MatProgressSpinner, a as MatProgressSpinnerDefaultOptions, d as MatSpinner, P as ProgressSpinnerMode } from '../progress-spinner.d-1fc040c5.js';
 import * as i0 from '@angular/core';
-import { InjectionToken, ElementRef } from '@angular/core';
-import * as i1 from '@angular/material/core';
-import { ThemePalette } from '@angular/material/core';
-
-/** Possible mode for a progress spinner. */
-type ProgressSpinnerMode = 'determinate' | 'indeterminate';
-/** Default `mat-progress-spinner` options that can be overridden. */
-interface MatProgressSpinnerDefaultOptions {
-    /**
-     * Default theme color of the progress spinner. This API is supported in M2 themes only, it
-     * has no effect in M3 themes. For color customization in M3, see https://material.angular.io/components/progress-spinner/styling.
-     *
-     * For information on applying color variants in M3, see
-     * https://material.angular.io/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
-     */
-    color?: ThemePalette;
-    /** Diameter of the spinner. */
-    diameter?: number;
-    /** Width of the spinner's stroke. */
-    strokeWidth?: number;
-    /**
-     * Whether the animations should be force to be enabled, ignoring if the current environment is
-     * using NoopAnimationsModule.
-     */
-    _forceAnimations?: boolean;
-}
-/** Injection token to be used to override the default options for `mat-progress-spinner`. */
-declare const MAT_PROGRESS_SPINNER_DEFAULT_OPTIONS: InjectionToken<MatProgressSpinnerDefaultOptions>;
-/**
- * @docs-private
- * @deprecated No longer used, will be removed.
- * @breaking-change 21.0.0
- */
-declare function MAT_PROGRESS_SPINNER_DEFAULT_OPTIONS_FACTORY(): MatProgressSpinnerDefaultOptions;
-declare class MatProgressSpinner {
-    readonly _elementRef: ElementRef<HTMLElement>;
-    /** Whether the _mat-animation-noopable class should be applied, disabling animations.  */
-    _noopAnimations: boolean;
-    /**
-     * Theme color of the progress spinner. This API is supported in M2 themes only, it
-     * has no effect in M3 themes. For color customization in M3, see https://material.angular.io/components/progress-spinner/styling.
-     *
-     * For information on applying color variants in M3, see
-     * https://material.angular.io/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
-     */
-    get color(): string | null | undefined;
-    set color(value: string | null | undefined);
-    private _color;
-    private _defaultColor;
-    /** The element of the determinate spinner. */
-    _determinateCircle: ElementRef<HTMLElement>;
-    constructor(...args: unknown[]);
-    /**
-     * Mode of the progress bar.
-     *
-     * Input must be one of these values: determinate, indeterminate, buffer, query, defaults to
-     * 'determinate'.
-     * Mirrored to mode attribute.
-     */
-    mode: ProgressSpinnerMode;
-    /** Value of the progress bar. Defaults to zero. Mirrored to aria-valuenow. */
-    get value(): number;
-    set value(v: number);
-    private _value;
-    /** The diameter of the progress spinner (will set width and height of svg). */
-    get diameter(): number;
-    set diameter(size: number);
-    private _diameter;
-    /** Stroke width of the progress spinner. */
-    get strokeWidth(): number;
-    set strokeWidth(value: number);
-    private _strokeWidth;
-    /** The radius of the spinner, adjusted for stroke width. */
-    _circleRadius(): number;
-    /** The view box of the spinner's svg element. */
-    _viewBox(): string;
-    /** The stroke circumference of the svg circle. */
-    _strokeCircumference(): number;
-    /** The dash offset of the svg circle. */
-    _strokeDashOffset(): number | null;
-    /** Stroke width of the circle in percent. */
-    _circleStrokeWidth(): number;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatProgressSpinner, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatProgressSpinner, "mat-progress-spinner, mat-spinner", ["matProgressSpinner"], { "color": { "alias": "color"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "value": { "alias": "value"; "required": false; }; "diameter": { "alias": "diameter"; "required": false; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; }; }, {}, never, never, true, never>;
-    static ngAcceptInputType_value: unknown;
-    static ngAcceptInputType_diameter: unknown;
-    static ngAcceptInputType_strokeWidth: unknown;
-}
-/**
- * @deprecated Import Progress Spinner instead. Note that the
- *    `mat-spinner` selector isn't deprecated.
- * @breaking-change 16.0.0
- */
-declare const MatSpinner: typeof MatProgressSpinner;
+import { M as MatCommonModule } from '../common-module.d-0e6515ae.js';
+import '../palette.d-ec4a617c.js';
+import '@angular/cdk/bidi';
 
 declare class MatProgressSpinnerModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<MatProgressSpinnerModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<MatProgressSpinnerModule, never, [typeof MatProgressSpinner, typeof MatProgressSpinner], [typeof MatProgressSpinner, typeof MatProgressSpinner, typeof i1.MatCommonModule]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatProgressSpinnerModule, never, [typeof MatProgressSpinner, typeof MatProgressSpinner], [typeof MatProgressSpinner, typeof MatProgressSpinner, typeof MatCommonModule]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<MatProgressSpinnerModule>;
 }
 
-export { MAT_PROGRESS_SPINNER_DEFAULT_OPTIONS, MAT_PROGRESS_SPINNER_DEFAULT_OPTIONS_FACTORY, MatProgressSpinner, type MatProgressSpinnerDefaultOptions, MatProgressSpinnerModule, MatSpinner, type ProgressSpinnerMode };
+export { MatProgressSpinnerModule };

package/progress-spinner/testing/index.d.ts

@@ -1,5 +1,7 @@
 import { BaseHarnessFilters, ComponentHarness, ComponentHarnessConstructor, HarnessPredicate } from '@angular/cdk/testing';
-import { ProgressSpinnerMode } from '@angular/material/progress-spinner';
+import { P as ProgressSpinnerMode } from '../../progress-spinner.d-1fc040c5.js';
+import '@angular/core';
+import '../../palette.d-ec4a617c.js';
 
 /** A set of criteria that can be used to filter a list of `MatProgressSpinnerHarness` instances. */
 interface ProgressSpinnerHarnessFilters extends BaseHarnessFilters {

package/progress-spinner.d-1fc040c5.d.ts

@@ -0,0 +1,96 @@
+import * as i0 from '@angular/core';
+import { InjectionToken, ElementRef } from '@angular/core';
+import { T as ThemePalette } from './palette.d-ec4a617c.js';
+
+/** Possible mode for a progress spinner. */
+type ProgressSpinnerMode = 'determinate' | 'indeterminate';
+/** Default `mat-progress-spinner` options that can be overridden. */
+interface MatProgressSpinnerDefaultOptions {
+    /**
+     * Default theme color of the progress spinner. This API is supported in M2 themes only, it
+     * has no effect in M3 themes. For color customization in M3, see https://material.angular.io/components/progress-spinner/styling.
+     *
+     * For information on applying color variants in M3, see
+     * https://material.angular.io/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
+     */
+    color?: ThemePalette;
+    /** Diameter of the spinner. */
+    diameter?: number;
+    /** Width of the spinner's stroke. */
+    strokeWidth?: number;
+    /**
+     * Whether the animations should be force to be enabled, ignoring if the current environment is
+     * using NoopAnimationsModule.
+     */
+    _forceAnimations?: boolean;
+}
+/** Injection token to be used to override the default options for `mat-progress-spinner`. */
+declare const MAT_PROGRESS_SPINNER_DEFAULT_OPTIONS: InjectionToken<MatProgressSpinnerDefaultOptions>;
+/**
+ * @docs-private
+ * @deprecated No longer used, will be removed.
+ * @breaking-change 21.0.0
+ */
+declare function MAT_PROGRESS_SPINNER_DEFAULT_OPTIONS_FACTORY(): MatProgressSpinnerDefaultOptions;
+declare class MatProgressSpinner {
+    readonly _elementRef: ElementRef<HTMLElement>;
+    /** Whether the _mat-animation-noopable class should be applied, disabling animations.  */
+    _noopAnimations: boolean;
+    /**
+     * Theme color of the progress spinner. This API is supported in M2 themes only, it
+     * has no effect in M3 themes. For color customization in M3, see https://material.angular.io/components/progress-spinner/styling.
+     *
+     * For information on applying color variants in M3, see
+     * https://material.angular.io/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
+     */
+    get color(): string | null | undefined;
+    set color(value: string | null | undefined);
+    private _color;
+    private _defaultColor;
+    /** The element of the determinate spinner. */
+    _determinateCircle: ElementRef<HTMLElement>;
+    constructor(...args: unknown[]);
+    /**
+     * Mode of the progress bar.
+     *
+     * Input must be one of these values: determinate, indeterminate, buffer, query, defaults to
+     * 'determinate'.
+     * Mirrored to mode attribute.
+     */
+    mode: ProgressSpinnerMode;
+    /** Value of the progress bar. Defaults to zero. Mirrored to aria-valuenow. */
+    get value(): number;
+    set value(v: number);
+    private _value;
+    /** The diameter of the progress spinner (will set width and height of svg). */
+    get diameter(): number;
+    set diameter(size: number);
+    private _diameter;
+    /** Stroke width of the progress spinner. */
+    get strokeWidth(): number;
+    set strokeWidth(value: number);
+    private _strokeWidth;
+    /** The radius of the spinner, adjusted for stroke width. */
+    _circleRadius(): number;
+    /** The view box of the spinner's svg element. */
+    _viewBox(): string;
+    /** The stroke circumference of the svg circle. */
+    _strokeCircumference(): number;
+    /** The dash offset of the svg circle. */
+    _strokeDashOffset(): number | null;
+    /** Stroke width of the circle in percent. */
+    _circleStrokeWidth(): number;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatProgressSpinner, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatProgressSpinner, "mat-progress-spinner, mat-spinner", ["matProgressSpinner"], { "color": { "alias": "color"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "value": { "alias": "value"; "required": false; }; "diameter": { "alias": "diameter"; "required": false; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; }; }, {}, never, never, true, never>;
+    static ngAcceptInputType_value: unknown;
+    static ngAcceptInputType_diameter: unknown;
+    static ngAcceptInputType_strokeWidth: unknown;
+}
+/**
+ * @deprecated Import Progress Spinner instead. Note that the
+ *    `mat-spinner` selector isn't deprecated.
+ * @breaking-change 16.0.0
+ */
+declare const MatSpinner: typeof MatProgressSpinner;
+
+export { MatProgressSpinner as M, type ProgressSpinnerMode as P, type MatProgressSpinnerDefaultOptions as a, MAT_PROGRESS_SPINNER_DEFAULT_OPTIONS as b, MAT_PROGRESS_SPINNER_DEFAULT_OPTIONS_FACTORY as c, MatSpinner as d };

package/pseudo-checkbox-module.d-3abc0461.d.ts

@@ -0,0 +1,44 @@
+import * as i0 from '@angular/core';
+import { M as MatCommonModule } from './common-module.d-0e6515ae.js';
+
+/**
+ * Possible states for a pseudo checkbox.
+ * @docs-private
+ */
+type MatPseudoCheckboxState = 'unchecked' | 'checked' | 'indeterminate';
+/**
+ * Component that shows a simplified checkbox without including any kind of "real" checkbox.
+ * Meant to be used when the checkbox is purely decorative and a large number of them will be
+ * included, such as for the options in a multi-select. Uses no SVGs or complex animations.
+ * Note that theming is meant to be handled by the parent element, e.g.
+ * `mat-primary .mat-pseudo-checkbox`.
+ *
+ * Note that this component will be completely invisible to screen-reader users. This is *not*
+ * interchangeable with `<mat-checkbox>` and should *not* be used if the user would directly
+ * interact with the checkbox. The pseudo-checkbox should only be used as an implementation detail
+ * of more complex components that appropriately handle selected / checked state.
+ * @docs-private
+ */
+declare class MatPseudoCheckbox {
+    _animationMode?: "NoopAnimations" | "BrowserAnimations" | null | undefined;
+    /** Display state of the checkbox. */
+    state: MatPseudoCheckboxState;
+    /** Whether the checkbox is disabled. */
+    disabled: boolean;
+    /**
+     * Appearance of the pseudo checkbox. Default appearance of 'full' renders a checkmark/mixedmark
+     * indicator inside a square box. 'minimal' appearance only renders the checkmark/mixedmark.
+     */
+    appearance: 'minimal' | 'full';
+    constructor(...args: unknown[]);
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatPseudoCheckbox, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatPseudoCheckbox, "mat-pseudo-checkbox", never, { "state": { "alias": "state"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "appearance": { "alias": "appearance"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+declare class MatPseudoCheckboxModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatPseudoCheckboxModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatPseudoCheckboxModule, never, [typeof MatCommonModule, typeof MatPseudoCheckbox], [typeof MatPseudoCheckbox]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatPseudoCheckboxModule>;
+}
+
+export { MatPseudoCheckboxModule as M, type MatPseudoCheckboxState as a, MatPseudoCheckbox as b };

package/radio/index.d.ts

@@ -2,8 +2,12 @@ import { FocusOrigin } from '@angular/cdk/a11y';
 import * as i0 from '@angular/core';
 import { InjectionToken, AfterContentInit, OnDestroy, EventEmitter, QueryList, OnInit, AfterViewInit, DoCheck, ElementRef } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
-import * as i1 from '@angular/material/core';
-import { ThemePalette } from '@angular/material/core';
+import { T as ThemePalette } from '../palette.d-ec4a617c.js';
+import { M as MatCommonModule } from '../common-module.d-0e6515ae.js';
+import { M as MatRippleModule } from '../index.d-0536b706.js';
+import '@angular/cdk/bidi';
+import '../ripple.d-2fb57d04.js';
+import '@angular/cdk/platform';
 
 /** Change event object emitted by radio button and radio group. */
 declare class MatRadioChange<T = any> {
@@ -290,7 +294,7 @@ declare class MatRadioButton implements OnInit, AfterViewInit, DoCheck, OnDestro
 
 declare class MatRadioModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<MatRadioModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<MatRadioModule, never, [typeof i1.MatCommonModule, typeof i1.MatRippleModule, typeof MatRadioGroup, typeof MatRadioButton], [typeof i1.MatCommonModule, typeof MatRadioGroup, typeof MatRadioButton]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatRadioModule, never, [typeof MatCommonModule, typeof MatRippleModule, typeof MatRadioGroup, typeof MatRadioButton], [typeof MatCommonModule, typeof MatRadioGroup, typeof MatRadioButton]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<MatRadioModule>;
 }
 

package/ripple-loader.d-8aac2988.d.ts

@@ -0,0 +1,48 @@
+import * as i0 from '@angular/core';
+import { OnDestroy } from '@angular/core';
+
+/**
+ * Handles attaching ripples on demand.
+ *
+ * This service allows us to avoid eagerly creating & attaching MatRipples.
+ * It works by creating & attaching a ripple only when a component is first interacted with.
+ *
+ * @docs-private
+ */
+declare class MatRippleLoader implements OnDestroy {
+    private _document;
+    private _animationMode;
+    private _globalRippleOptions;
+    private _platform;
+    private _ngZone;
+    private _injector;
+    private _eventCleanups;
+    private _hosts;
+    constructor();
+    ngOnDestroy(): void;
+    /**
+     * Configures the ripple that will be rendered by the ripple loader.
+     *
+     * Stores the given information about how the ripple should be configured on the host
+     * element so that it can later be retrived & used when the ripple is actually created.
+     */
+    configureRipple(host: HTMLElement, config: {
+        className?: string;
+        centered?: boolean;
+        disabled?: boolean;
+    }): void;
+    /** Sets the disabled state on the ripple instance corresponding to the given host element. */
+    setDisabled(host: HTMLElement, disabled: boolean): void;
+    /**
+     * Handles creating and attaching component internals
+     * when a component is initially interacted with.
+     */
+    private _onInteraction;
+    /** Creates a MatRipple and appends it to the given element. */
+    private _createRipple;
+    destroyRipple(host: HTMLElement): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatRippleLoader, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MatRippleLoader>;
+}
+
+export { MatRippleLoader as M };

package/ripple.d-2fb57d04.d.ts

@@ -0,0 +1,255 @@
+import * as i0 from '@angular/core';
+import { NgZone, ElementRef, Injector, InjectionToken, OnInit, OnDestroy } from '@angular/core';
+import { Platform } from '@angular/cdk/platform';
+
+/** Possible states for a ripple element. */
+declare enum RippleState {
+    FADING_IN = 0,
+    VISIBLE = 1,
+    FADING_OUT = 2,
+    HIDDEN = 3
+}
+type RippleConfig = {
+    color?: string;
+    centered?: boolean;
+    radius?: number;
+    persistent?: boolean;
+    animation?: RippleAnimationConfig;
+    terminateOnPointerUp?: boolean;
+};
+/**
+ * Interface that describes the configuration for the animation of a ripple.
+ * There are two animation phases with different durations for the ripples.
+ */
+interface RippleAnimationConfig {
+    /** Duration in milliseconds for the enter animation (expansion from point of contact). */
+    enterDuration?: number;
+    /** Duration in milliseconds for the exit animation (fade-out). */
+    exitDuration?: number;
+}
+/**
+ * Reference to a previously launched ripple element.
+ */
+declare class RippleRef {
+    private _renderer;
+    /** Reference to the ripple HTML element. */
+    element: HTMLElement;
+    /** Ripple configuration used for the ripple. */
+    config: RippleConfig;
+    _animationForciblyDisabledThroughCss: boolean;
+    /** Current state of the ripple. */
+    state: RippleState;
+    constructor(_renderer: {
+        fadeOutRipple(ref: RippleRef): void;
+    }, 
+    /** Reference to the ripple HTML element. */
+    element: HTMLElement, 
+    /** Ripple configuration used for the ripple. */
+    config: RippleConfig, _animationForciblyDisabledThroughCss?: boolean);
+    /** Fades out the ripple element. */
+    fadeOut(): void;
+}
+
+/**
+ * Interface that describes the target for launching ripples.
+ * It defines the ripple configuration and disabled state for interaction ripples.
+ * @docs-private
+ */
+interface RippleTarget {
+    /** Configuration for ripples that are launched on pointer down. */
+    rippleConfig: RippleConfig;
+    /** Whether ripples on pointer down should be disabled. */
+    rippleDisabled: boolean;
+}
+/**
+ * Default ripple animation configuration for ripples without an explicit
+ * animation config specified.
+ */
+declare const defaultRippleAnimationConfig: {
+    enterDuration: number;
+    exitDuration: number;
+};
+/**
+ * Helper service that performs DOM manipulations. Not intended to be used outside this module.
+ * The constructor takes a reference to the ripple directive's host element and a map of DOM
+ * event handlers to be installed on the element that triggers ripple animations.
+ * This will eventually become a custom renderer once Angular support exists.
+ * @docs-private
+ */
+declare class RippleRenderer implements EventListenerObject {
+    private _target;
+    private _ngZone;
+    private _platform;
+    /** Element where the ripples are being added to. */
+    private _containerElement;
+    /** Element which triggers the ripple elements on mouse events. */
+    private _triggerElement;
+    /** Whether the pointer is currently down or not. */
+    private _isPointerDown;
+    /**
+     * Map of currently active ripple references.
+     * The ripple reference is mapped to its element event listeners.
+     * The reason why `| null` is used is that event listeners are added only
+     * when the condition is truthy (see the `_startFadeOutTransition` method).
+     */
+    private _activeRipples;
+    /** Latest non-persistent ripple that was triggered. */
+    private _mostRecentTransientRipple;
+    /** Time in milliseconds when the last touchstart event happened. */
+    private _lastTouchStartEvent;
+    /** Whether pointer-up event listeners have been registered. */
+    private _pointerUpEventsRegistered;
+    /**
+     * Cached dimensions of the ripple container. Set when the first
+     * ripple is shown and cleared once no more ripples are visible.
+     */
+    private _containerRect;
+    private static _eventManager;
+    constructor(_target: RippleTarget, _ngZone: NgZone, elementOrElementRef: HTMLElement | ElementRef<HTMLElement>, _platform: Platform, injector?: Injector);
+    /**
+     * Fades in a ripple at the given coordinates.
+     * @param x Coordinate within the element, along the X axis at which to start the ripple.
+     * @param y Coordinate within the element, along the Y axis at which to start the ripple.
+     * @param config Extra ripple options.
+     */
+    fadeInRipple(x: number, y: number, config?: RippleConfig): RippleRef;
+    /** Fades out a ripple reference. */
+    fadeOutRipple(rippleRef: RippleRef): void;
+    /** Fades out all currently active ripples. */
+    fadeOutAll(): void;
+    /** Fades out all currently active non-persistent ripples. */
+    fadeOutAllNonPersistent(): void;
+    /** Sets up the trigger event listeners */
+    setupTriggerEvents(elementOrElementRef: HTMLElement | ElementRef<HTMLElement>): void;
+    /**
+     * Handles all registered events.
+     * @docs-private
+     */
+    handleEvent(event: Event): void;
+    /** Method that will be called if the fade-in or fade-in transition completed. */
+    private _finishRippleTransition;
+    /**
+     * Starts the fade-out transition of the given ripple if it's not persistent and the pointer
+     * is not held down anymore.
+     */
+    private _startFadeOutTransition;
+    /** Destroys the given ripple by removing it from the DOM and updating its state. */
+    private _destroyRipple;
+    /** Function being called whenever the trigger is being pressed using mouse. */
+    private _onMousedown;
+    /** Function being called whenever the trigger is being pressed using touch. */
+    private _onTouchStart;
+    /** Function being called whenever the trigger is being released. */
+    private _onPointerUp;
+    private _getActiveRipples;
+    /** Removes previously registered event listeners from the trigger element. */
+    _removeTriggerEvents(): void;
+}
+
+/** Configurable options for `matRipple`. */
+interface RippleGlobalOptions {
+    /**
+     * Whether ripples should be disabled. Ripples can be still launched manually by using
+     * the `launch()` method. Therefore focus indicators will still show up.
+     */
+    disabled?: boolean;
+    /**
+     * Default configuration for the animation duration of the ripples. There are two phases with
+     * different durations for the ripples: `enter` and `leave`. The durations will be overwritten
+     * by the value of `matRippleAnimation` or if the `NoopAnimationsModule` is included.
+     */
+    animation?: RippleAnimationConfig;
+    /**
+     * Whether ripples should start fading out immediately after the mouse or touch is released. By
+     * default, ripples will wait for the enter animation to complete and for mouse or touch release.
+     */
+    terminateOnPointerUp?: boolean;
+    /**
+     * A namespace to use for ripple loader to allow multiple instances to exist on the same page.
+     */
+    namespace?: string;
+}
+/** Injection token that can be used to specify the global ripple options. */
+declare const MAT_RIPPLE_GLOBAL_OPTIONS: InjectionToken<RippleGlobalOptions>;
+declare class MatRipple implements OnInit, OnDestroy, RippleTarget {
+    private _elementRef;
+    private _animationMode;
+    /** Custom color for all ripples. */
+    color: string;
+    /** Whether the ripples should be visible outside the component's bounds. */
+    unbounded: boolean;
+    /**
+     * Whether the ripple always originates from the center of the host element's bounds, rather
+     * than originating from the location of the click event.
+     */
+    centered: boolean;
+    /**
+     * If set, the radius in pixels of foreground ripples when fully expanded. If unset, the radius
+     * will be the distance from the center of the ripple to the furthest corner of the host element's
+     * bounding rectangle.
+     */
+    radius: number;
+    /**
+     * Configuration for the ripple animation. Allows modifying the enter and exit animation
+     * duration of the ripples. The animation durations will be overwritten if the
+     * `NoopAnimationsModule` is being used.
+     */
+    animation: RippleAnimationConfig;
+    /**
+     * Whether click events will not trigger the ripple. Ripples can be still launched manually
+     * by using the `launch()` method.
+     */
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    private _disabled;
+    /**
+     * The element that triggers the ripple when click events are received.
+     * Defaults to the directive's host element.
+     */
+    get trigger(): HTMLElement;
+    set trigger(trigger: HTMLElement);
+    private _trigger;
+    /** Renderer for the ripple DOM manipulations. */
+    private _rippleRenderer;
+    /** Options that are set globally for all ripples. */
+    private _globalOptions;
+    /** @docs-private Whether ripple directive is initialized and the input bindings are set. */
+    _isInitialized: boolean;
+    constructor(...args: unknown[]);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    /** Fades out all currently showing ripple elements. */
+    fadeOutAll(): void;
+    /** Fades out all currently showing non-persistent ripple elements. */
+    fadeOutAllNonPersistent(): void;
+    /**
+     * Ripple configuration from the directive's input values.
+     * @docs-private Implemented as part of RippleTarget
+     */
+    get rippleConfig(): RippleConfig;
+    /**
+     * Whether ripples on pointer-down are disabled or not.
+     * @docs-private Implemented as part of RippleTarget
+     */
+    get rippleDisabled(): boolean;
+    /** Sets up the trigger event listeners if ripples are enabled. */
+    private _setupTriggerEventsIfEnabled;
+    /**
+     * Launches a manual ripple using the specified ripple configuration.
+     * @param config Configuration for the manual ripple.
+     */
+    launch(config: RippleConfig): RippleRef;
+    /**
+     * Launches a manual ripple at the specified coordinates relative to the viewport.
+     * @param x Coordinate along the X axis at which to fade-in the ripple. Coordinate
+     *   should be relative to the viewport.
+     * @param y Coordinate along the Y axis at which to fade-in the ripple. Coordinate
+     *   should be relative to the viewport.
+     * @param config Optional ripple configuration for the manual ripple.
+     */
+    launch(x: number, y: number, config?: RippleConfig): RippleRef;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatRipple, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatRipple, "[mat-ripple], [matRipple]", ["matRipple"], { "color": { "alias": "matRippleColor"; "required": false; }; "unbounded": { "alias": "matRippleUnbounded"; "required": false; }; "centered": { "alias": "matRippleCentered"; "required": false; }; "radius": { "alias": "matRippleRadius"; "required": false; }; "animation": { "alias": "matRippleAnimation"; "required": false; }; "disabled": { "alias": "matRippleDisabled"; "required": false; }; "trigger": { "alias": "matRippleTrigger"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+export { MatRipple as M, RippleRenderer as R, type RippleTarget as a, type RippleGlobalOptions as b, MAT_RIPPLE_GLOBAL_OPTIONS as c, defaultRippleAnimationConfig as d, RippleState as e, type RippleConfig as f, type RippleAnimationConfig as g, RippleRef as h };

package/schematics/migration.json

@@ -1,10 +1,10 @@
 {
   "$schema": "./node_modules/@angular-devkit/schematics/collection-schema.json",
   "schematics": {
-    "migration-v19": {
-      "version": "19.0.0-0",
-      "description": "Updates Angular Material to v19",
-      "factory": "./ng-update/index_bundled#updateToV19"
+    "migration-v20": {
+      "version": "20.0.0-0",
+      "description": "Updates Angular Material to v20",
+      "factory": "./ng-update/index_bundled#updateToV20"
     }
   }
 }

package/schematics/ng-add/index.js

@@ -19,7 +19,7 @@ const package_config_1 = require("./package-config");
  * Note that the fallback version range does not use caret, but tilde because that is
  * the default for Angular framework dependencies in CLI projects.
  */
-const fallbackMaterialVersionRange = `~19.2.3`;
+const fallbackMaterialVersionRange = `~20.0.0-next.1`;
 /**
  * Schematic factory entry-point for the `ng-add` schematic. The ng-add schematic will be
  * automatically executed if developers run `ng add @angular/material`.
@@ -34,7 +34,7 @@ function default_1(options) {
         // have the same version tag if possible.
         const ngCoreVersionTag = (0, package_config_1.getPackageVersionFromPackageJson)(host, '@angular/core');
         const materialVersionRange = (0, package_config_1.getPackageVersionFromPackageJson)(host, '@angular/material');
-        const angularDependencyVersion = ngCoreVersionTag || `^19.0.0 || ^20.0.0`;
+        const angularDependencyVersion = ngCoreVersionTag || `^20.0.0-0 || ^20.1.0-0 || ^20.2.0-0 || ^20.3.0-0 || ^21.0.0-0`;
         // The CLI inserts `@angular/material` into the `package.json` before this schematic runs.
         // This means that we do not need to insert Angular Material into `package.json` files again.
         // In some cases though, it could happen that this schematic runs outside of the CLI `ng add`

package/schematics/ng-add/index.mjs

@@ -19,7 +19,7 @@ const package_config_1 = require("./package-config");
  * Note that the fallback version range does not use caret, but tilde because that is
  * the default for Angular framework dependencies in CLI projects.
  */
-const fallbackMaterialVersionRange = `~19.2.3`;
+const fallbackMaterialVersionRange = `~20.0.0-next.1`;
 /**
  * Schematic factory entry-point for the `ng-add` schematic. The ng-add schematic will be
  * automatically executed if developers run `ng add @angular/material`.
@@ -34,7 +34,7 @@ function default_1(options) {
         // have the same version tag if possible.
         const ngCoreVersionTag = (0, package_config_1.getPackageVersionFromPackageJson)(host, '@angular/core');
         const materialVersionRange = (0, package_config_1.getPackageVersionFromPackageJson)(host, '@angular/material');
-        const angularDependencyVersion = ngCoreVersionTag || `^19.0.0 || ^20.0.0`;
+        const angularDependencyVersion = ngCoreVersionTag || `^20.0.0-0 || ^20.1.0-0 || ^20.2.0-0 || ^20.3.0-0 || ^21.0.0-0`;
         // The CLI inserts `@angular/material` into the `package.json` before this schematic runs.
         // This means that we do not need to insert Angular Material into `package.json` files again.
         // In some cases though, it could happen that this schematic runs outside of the CLI `ng add`