@angular/material 19.2.2 → 19.2.4

package/radio/testing/index.d.ts

@@ -1,58 +1,23 @@
-import { AsyncFactoryFn } from '@angular/cdk/testing';
-import { BaseHarnessFilters } from '@angular/cdk/testing';
-import { ComponentHarness } from '@angular/cdk/testing';
-import { ComponentHarnessConstructor } from '@angular/cdk/testing';
-import { HarnessPredicate } from '@angular/cdk/testing';
-import { TestElement } from '@angular/cdk/testing';
+import * as _angular_cdk_testing from '@angular/cdk/testing';
+import { BaseHarnessFilters, ComponentHarness, ComponentHarnessConstructor, HarnessPredicate } from '@angular/cdk/testing';
 
-/** Harness for interacting with a mat-radio-button in tests. */
-export declare class MatRadioButtonHarness extends ComponentHarness {
-    /** The selector for the host element of a `MatRadioButton` instance. */
-    static hostSelector: string;
-    /**
-     * Gets a `HarnessPredicate` that can be used to search for a radio button with specific
-     * attributes.
-     * @param options Options for filtering which radio button instances are considered a match.
-     * @return a `HarnessPredicate` configured with the given options.
-     */
-    static with<T extends MatRadioButtonHarness>(this: ComponentHarnessConstructor<T>, options?: RadioButtonHarnessFilters): HarnessPredicate<T>;
-    protected _textLabel: AsyncFactoryFn<TestElement>;
-    protected _clickLabel: AsyncFactoryFn<TestElement>;
-    private _input;
-    /** Whether the radio-button is checked. */
-    isChecked(): Promise<boolean>;
-    /** Whether the radio-button is disabled. */
-    isDisabled(): Promise<boolean>;
-    /** Whether the radio-button is required. */
-    isRequired(): Promise<boolean>;
-    /** Gets the radio-button's name. */
-    getName(): Promise<string | null>;
-    /** Gets the radio-button's id. */
-    getId(): Promise<string | null>;
-    /**
-     * Gets the value of the radio-button. The radio-button value will be converted to a string.
-     *
-     * Note: This means that for radio-button's with an object as a value `[object Object]` is
-     * intentionally returned.
-     */
-    getValue(): Promise<string | null>;
-    /** Gets the radio-button's label text. */
-    getLabelText(): Promise<string>;
-    /** Focuses the radio-button. */
-    focus(): Promise<void>;
-    /** Blurs the radio-button. */
-    blur(): Promise<void>;
-    /** Whether the radio-button is focused. */
-    isFocused(): Promise<boolean>;
-    /**
-     * Puts the radio-button in a checked state by clicking it if it is currently unchecked,
-     * or doing nothing if it is already checked.
-     */
-    check(): Promise<void>;
+/** A set of criteria that can be used to filter a list of `MatRadioGroupHarness` instances. */
+interface RadioGroupHarnessFilters extends BaseHarnessFilters {
+    /** Only find instances whose name attribute is the given value. */
+    name?: string;
+}
+/** A set of criteria that can be used to filter a list of `MatRadioButtonHarness` instances. */
+interface RadioButtonHarnessFilters extends BaseHarnessFilters {
+    /** Only find instances whose label matches the given value. */
+    label?: string | RegExp;
+    /** Only find instances whose name attribute is the given value. */
+    name?: string;
+    /** Only find instances with the given checked value. */
+    checked?: boolean;
 }
 
 /** Harness for interacting with a mat-radio-group in tests. */
-export declare class MatRadioGroupHarness extends ComponentHarness {
+declare class MatRadioGroupHarness extends ComponentHarness {
     /** The selector for the host element of a `MatRadioGroup` instance. */
     static hostSelector: string;
     private _buttonClass;
@@ -94,21 +59,50 @@ export declare class MatRadioGroupHarness extends ComponentHarness {
      */
     protected static _checkRadioGroupName(harness: MatRadioGroupHarness, name: string): Promise<boolean>;
 }
-
-/** A set of criteria that can be used to filter a list of `MatRadioButtonHarness` instances. */
-export declare interface RadioButtonHarnessFilters extends BaseHarnessFilters {
-    /** Only find instances whose label matches the given value. */
-    label?: string | RegExp;
-    /** Only find instances whose name attribute is the given value. */
-    name?: string;
-    /** Only find instances with the given checked value. */
-    checked?: boolean;
-}
-
-/** A set of criteria that can be used to filter a list of `MatRadioGroupHarness` instances. */
-export declare interface RadioGroupHarnessFilters extends BaseHarnessFilters {
-    /** Only find instances whose name attribute is the given value. */
-    name?: string;
+/** Harness for interacting with a mat-radio-button in tests. */
+declare class MatRadioButtonHarness extends ComponentHarness {
+    /** The selector for the host element of a `MatRadioButton` instance. */
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a radio button with specific
+     * attributes.
+     * @param options Options for filtering which radio button instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with<T extends MatRadioButtonHarness>(this: ComponentHarnessConstructor<T>, options?: RadioButtonHarnessFilters): HarnessPredicate<T>;
+    protected _textLabel: _angular_cdk_testing.AsyncFactoryFn<_angular_cdk_testing.TestElement>;
+    protected _clickLabel: _angular_cdk_testing.AsyncFactoryFn<_angular_cdk_testing.TestElement>;
+    private _input;
+    /** Whether the radio-button is checked. */
+    isChecked(): Promise<boolean>;
+    /** Whether the radio-button is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Whether the radio-button is required. */
+    isRequired(): Promise<boolean>;
+    /** Gets the radio-button's name. */
+    getName(): Promise<string | null>;
+    /** Gets the radio-button's id. */
+    getId(): Promise<string | null>;
+    /**
+     * Gets the value of the radio-button. The radio-button value will be converted to a string.
+     *
+     * Note: This means that for radio-button's with an object as a value `[object Object]` is
+     * intentionally returned.
+     */
+    getValue(): Promise<string | null>;
+    /** Gets the radio-button's label text. */
+    getLabelText(): Promise<string>;
+    /** Focuses the radio-button. */
+    focus(): Promise<void>;
+    /** Blurs the radio-button. */
+    blur(): Promise<void>;
+    /** Whether the radio-button is focused. */
+    isFocused(): Promise<boolean>;
+    /**
+     * Puts the radio-button in a checked state by clicking it if it is currently unchecked,
+     * or doing nothing if it is already checked.
+     */
+    check(): Promise<void>;
 }
 
-export { }
+export { MatRadioButtonHarness, MatRadioGroupHarness, type RadioButtonHarnessFilters, type RadioGroupHarnessFilters };

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/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.2`;
+const fallbackMaterialVersionRange = `~19.2.4`;
 /**
  * Schematic factory entry-point for the `ng-add` schematic. The ng-add schematic will be
  * automatically executed if developers run `ng add @angular/material`.

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.2`;
+const fallbackMaterialVersionRange = `~19.2.4`;
 /**
  * Schematic factory entry-point for the `ng-add` schematic. The ng-add schematic will be
  * automatically executed if developers run `ng add @angular/material`.

package/schematics/ng-generate/theme-color/index_bundled.js

@@ -50,7 +50,7 @@ var __async = (__this, __arguments, generator) => {
   });
 };
 
-// bazel-out/darwin_arm64-fastbuild/bin/src/material/schematics/ng-generate/theme-color/index.mjs
+// bazel-out/k8-fastbuild/bin/src/material/schematics/ng-generate/theme-color/index.mjs
 var theme_color_exports = {};
 __export(theme_color_exports, {
   default: () => theme_color_default,
@@ -2578,7 +2578,7 @@ function parseIntHex(value) {
   return parseInt(value, 16);
 }
 
-// bazel-out/darwin_arm64-fastbuild/bin/src/material/schematics/ng-generate/theme-color/index.mjs
+// bazel-out/k8-fastbuild/bin/src/material/schematics/ng-generate/theme-color/index.mjs
 var HUE_TONES = [0, 10, 20, 25, 30, 35, 40, 50, 60, 70, 80, 90, 95, 98, 99, 100];
 var NEUTRAL_HUES = /* @__PURE__ */ new Map([
   [4, { prev: 0, next: 10 }],

package/schematics/ng-generate/theme-color/schema.json

@@ -24,6 +24,16 @@
       "description": "Color for neutral color palette",
       "x-prompt": "What HEX color should be used represent the neutral color palette? (Leave blank to use generated colors from Material)"
     },
+    "neutralVariantColor": {
+      "type": "string",
+      "description": "Color for the neutral variant palette",
+      "x-prompt": "What HEX color should be used represent the neutral variant palette? (Leave blank to use generated colors from Material)"
+    },
+    "errorColor": {
+      "type": "string",
+      "description": "Color for the error palette",
+      "x-prompt": "What HEX color should be used represent the error palette? (Leave blank to use generated colors from Material)"
+    },
     "includeHighContrast": {
       "type": "boolean",
       "default": false,