@angular/material 19.1.0-next.0 → 19.1.0-next.2

package/select/index.d.ts

@@ -100,6 +100,7 @@ export declare class MatSelect implements AfterContentInit, OnChanges, OnDestroy
     ngControl: NgControl;
     private _liveAnnouncer;
     protected _defaultOptions: MatSelectConfig | null;
+    private _initialized;
     /** All of the defined select options. */
     options: QueryList<MatOption>;
     /** All of the defined groups of options. */
@@ -249,7 +250,13 @@ export declare class MatSelect implements AfterContentInit, OnChanges, OnDestroy
      * If set to null or an empty string, the panel will grow to match the longest option's text.
      */
     panelWidth: string | number | null;
-    private _initialized;
+    /**
+     * By default selecting an option with a `null` or `undefined` value will reset the select's
+     * value. Enable this option if the reset behavior doesn't match your requirements and instead
+     * the nullable options should become selected. The value of this input can be controlled app-wide
+     * using the `MAT_SELECT_CONFIG` injection token.
+     */
+    canSelectNullableOptions: boolean;
     /** Combined stream of all of the child options' change events. */
     readonly optionSelectionChanges: Observable<MatOptionSelectionChange>;
     /** Event emitted when the select panel has been toggled. */
@@ -427,7 +434,7 @@ export declare class MatSelect implements AfterContentInit, OnChanges, OnDestroy
      */
     get shouldLabelFloat(): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<MatSelect, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatSelect, "mat-select", ["matSelect"], { "userAriaDescribedBy": { "alias": "aria-describedby"; "required": false; }; "panelClass": { "alias": "panelClass"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "disableRipple": { "alias": "disableRipple"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "hideSingleSelectionIndicator": { "alias": "hideSingleSelectionIndicator"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "required": { "alias": "required"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "disableOptionCentering": { "alias": "disableOptionCentering"; "required": false; }; "compareWith": { "alias": "compareWith"; "required": false; }; "value": { "alias": "value"; "required": false; }; "ariaLabel": { "alias": "aria-label"; "required": false; }; "ariaLabelledby": { "alias": "aria-labelledby"; "required": false; }; "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; }; "typeaheadDebounceInterval": { "alias": "typeaheadDebounceInterval"; "required": false; }; "sortComparator": { "alias": "sortComparator"; "required": false; }; "id": { "alias": "id"; "required": false; }; "panelWidth": { "alias": "panelWidth"; "required": false; }; }, { "openedChange": "openedChange"; "_openedStream": "opened"; "_closedStream": "closed"; "selectionChange": "selectionChange"; "valueChange": "valueChange"; }, ["customTrigger", "options", "optionGroups"], ["mat-select-trigger", "*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatSelect, "mat-select", ["matSelect"], { "userAriaDescribedBy": { "alias": "aria-describedby"; "required": false; }; "panelClass": { "alias": "panelClass"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "disableRipple": { "alias": "disableRipple"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "hideSingleSelectionIndicator": { "alias": "hideSingleSelectionIndicator"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "required": { "alias": "required"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "disableOptionCentering": { "alias": "disableOptionCentering"; "required": false; }; "compareWith": { "alias": "compareWith"; "required": false; }; "value": { "alias": "value"; "required": false; }; "ariaLabel": { "alias": "aria-label"; "required": false; }; "ariaLabelledby": { "alias": "aria-labelledby"; "required": false; }; "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; }; "typeaheadDebounceInterval": { "alias": "typeaheadDebounceInterval"; "required": false; }; "sortComparator": { "alias": "sortComparator"; "required": false; }; "id": { "alias": "id"; "required": false; }; "panelWidth": { "alias": "panelWidth"; "required": false; }; "canSelectNullableOptions": { "alias": "canSelectNullableOptions"; "required": false; }; }, { "openedChange": "openedChange"; "_openedStream": "opened"; "_closedStream": "closed"; "selectionChange": "selectionChange"; "valueChange": "valueChange"; }, ["customTrigger", "options", "optionGroups"], ["mat-select-trigger", "*"], true, never>;
     static ngAcceptInputType_disabled: unknown;
     static ngAcceptInputType_disableRipple: unknown;
     static ngAcceptInputType_tabIndex: unknown;
@@ -436,6 +443,7 @@ export declare class MatSelect implements AfterContentInit, OnChanges, OnDestroy
     static ngAcceptInputType_multiple: unknown;
     static ngAcceptInputType_disableOptionCentering: unknown;
     static ngAcceptInputType_typeaheadDebounceInterval: unknown;
+    static ngAcceptInputType_canSelectNullableOptions: unknown;
 }
 
 /**
@@ -482,6 +490,11 @@ export declare interface MatSelectConfig {
      * If set to null or an empty string, the panel will grow to match the longest option's text.
      */
     panelWidth?: string | number | null;
+    /**
+     * Whether nullable options can be selected by default.
+     * See `MatSelect.canSelectNullableOptions` for more information.
+     */
+    canSelectNullableOptions?: boolean;
 }
 
 export declare class MatSelectModule {

package/sort/index.d.ts

@@ -10,6 +10,7 @@ import { OnDestroy } from '@angular/core';
 import { OnInit } from '@angular/core';
 import { Optional } from '@angular/core';
 import { Subject } from 'rxjs';
+import { WritableSignal } from '@angular/core';
 
 /**
  * Valid positions for the arrow to be in for its opacity and translation. If the state is a
@@ -18,6 +19,8 @@ import { Subject } from 'rxjs';
  * be fully opaque in the center.
  *
  * @docs-private
+ * @deprecated No longer being used, to be removed.
+ * @breaking-change 21.0.0
  */
 export declare type ArrowViewState = SortDirection | 'hint' | 'active';
 
@@ -25,6 +28,8 @@ export declare type ArrowViewState = SortDirection | 'hint' | 'active';
  * States describing the arrow's animated position (animating fromState to toState).
  * If the fromState is not defined, there will be no animated transition to the toState.
  * @docs-private
+ * @deprecated No longer being used, to be removed.
+ * @breaking-change 21.0.0
  */
 export declare interface ArrowViewStateTransition {
     fromState?: ArrowViewState;
@@ -130,6 +135,8 @@ export declare interface MatSortable {
 /**
  * Animations used by MatSort.
  * @docs-private
+ * @deprecated No longer being used, to be removed.
+ * @breaking-change 21.0.0
  */
 export declare const matSortAnimations: {
     readonly indicator: AnimationTriggerMetadata;
@@ -159,35 +166,24 @@ export declare interface MatSortDefaultOptions {
  */
 export declare class MatSortHeader implements MatSortable, OnDestroy, OnInit, AfterViewInit {
     _intl: MatSortHeaderIntl;
-    private _changeDetectorRef;
     _sort: MatSort;
     _columnDef: MatSortHeaderColumnDef | null;
+    private _changeDetectorRef;
     private _focusMonitor;
     private _elementRef;
     private _ariaDescriber;
-    private _rerenderSubscription;
+    private _renderChanges;
+    protected _animationModule: "NoopAnimations" | "BrowserAnimations" | null;
+    /**
+     * Indicates which state was just cleared from the sort header.
+     * Will be reset on the next interaction. Used for coordinating animations.
+     */
+    protected _recentlyCleared: WritableSignal<SortDirection | null>;
     /**
      * The element with role="button" inside this component's view. We need this
      * in order to apply a description with AriaDescriber.
      */
     private _sortButton;
-    /**
-     * Flag set to true when the indicator should be displayed while the sort is not active. Used to
-     * provide an affordance that the header is sortable by showing on focus and hover.
-     */
-    _showIndicatorHint: boolean;
-    /**
-     * The view transition state of the arrow (translation/ opacity) - indicates its `from` and `to`
-     * position through the animation. If animations are currently disabled, the fromState is removed
-     * so that there is no animation displayed.
-     */
-    _viewState: ArrowViewStateTransition;
-    /** The direction the arrow should be facing according to the current state. */
-    _arrowDirection: SortDirection;
-    /**
-     * Whether the view state animation should show the transition between the `from` and `to` states.
-     */
-    _disableViewStateAnimation: boolean;
     /**
      * ID of this sort header. If used within the context of a CdkColumnDef, this will default to
      * the column's name.
@@ -212,38 +208,11 @@ export declare class MatSortHeader implements MatSortable, OnDestroy, OnInit, Af
     ngOnInit(): void;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
-    /**
-     * Sets the "hint" state such that the arrow will be semi-transparently displayed as a hint to the
-     * user showing what the active sort will become. If set to false, the arrow will fade away.
-     */
-    _setIndicatorHintVisible(visible: boolean): void;
-    /**
-     * Sets the animation transition view state for the arrow's position and opacity. If the
-     * `disableViewStateAnimation` flag is set to true, the `fromState` will be ignored so that
-     * no animation appears.
-     */
-    _setAnimationTransitionState(viewState: ArrowViewStateTransition): void;
     /** Triggers the sort on this sort header and removes the indicator hint. */
     _toggleOnInteraction(): void;
-    _handleClick(): void;
     _handleKeydown(event: KeyboardEvent): void;
     /** Whether this MatSortHeader is currently sorted in either ascending or descending order. */
     _isSorted(): boolean;
-    /** Returns the animation state for the arrow direction (indicator and pointers). */
-    _getArrowDirectionState(): string;
-    /** Returns the arrow position state (opacity, translation). */
-    _getArrowViewState(): string;
-    /**
-     * Updates the direction the arrow should be pointing. If it is not sorted, the arrow should be
-     * facing the start direction. Otherwise if it is sorted, the arrow should point in the currently
-     * active sorted direction. The reason this is updated through a function is because the direction
-     * should only be changed at specific times - when deactivated but the hint is displayed and when
-     * the sort is active and the direction changes. Otherwise the arrow's direction should linger
-     * in cases such as the sort becoming deactivated but we want to animate the arrow away while
-     * preserving its direction, even though the next sort direction is actually different and should
-     * only be changed once the arrow displays again (hint or activation).
-     */
-    _updateArrowDirection(): void;
     _isDisabled(): boolean;
     /**
      * Gets the aria-sort attribute that should be applied to this sort header. If this header
@@ -255,8 +224,6 @@ export declare class MatSortHeader implements MatSortable, OnDestroy, OnInit, Af
     /** Whether the arrow inside the sort header should be rendered. */
     _renderArrow(): boolean;
     private _updateSortActionDescription;
-    /** Handles changes in the sorting state. */
-    private _handleStateChanges;
     static ɵfac: i0.ɵɵFactoryDeclaration<MatSortHeader, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MatSortHeader, "[mat-sort-header]", ["matSortHeader"], { "id": { "alias": "mat-sort-header"; "required": false; }; "arrowPosition": { "alias": "arrowPosition"; "required": false; }; "start": { "alias": "start"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "sortActionDescription": { "alias": "sortActionDescription"; "required": false; }; "disableClear": { "alias": "disableClear"; "required": false; }; }, {}, never, ["*"], true, never>;
     static ngAcceptInputType_disabled: unknown;

package/timepicker/index.d.ts

@@ -93,6 +93,8 @@ export declare class MatTimepicker<D> implements OnDestroy, MatOptionParentCompo
     readonly ariaLabel: InputSignal<string | null>;
     /** ID of the label element for the timepicker panel. */
     readonly ariaLabelledby: InputSignal<string | null>;
+    /** Whether the timepicker is currently disabled. */
+    readonly disabled: Signal<boolean>;
     constructor();
     /** Opens the timepicker. */
     open(): void;
@@ -281,6 +283,7 @@ export declare interface MatTimepickerSelected<D> {
 export declare class MatTimepickerToggle<D> {
     private _defaultConfig;
     private _defaultTabIndex;
+    protected _isDisabled: Signal<boolean>;
     /** Timepicker instance that the button will toggle. */
     readonly timepicker: InputSignal<MatTimepicker<D>>;
     /** Screen-reader label for the button. */