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

package/option.d-6f493d78.d.ts

@@ -0,0 +1,146 @@
+import { FocusableOption, FocusOrigin } from '@angular/cdk/a11y';
+import * as i0 from '@angular/core';
+import { InjectionToken, AfterViewChecked, OnDestroy, ChangeDetectorRef, EventEmitter, ElementRef, QueryList } from '@angular/core';
+import { Subject } from 'rxjs';
+
+/**
+ * Injection token that can be used to reference instances of `MatOptgroup`. It serves as
+ * alternative token to the actual `MatOptgroup` class which could cause unnecessary
+ * retention of the class and its component metadata.
+ */
+declare const MAT_OPTGROUP: InjectionToken<MatOptgroup>;
+/**
+ * Component that is used to group instances of `mat-option`.
+ */
+declare class MatOptgroup {
+    /** Label for the option group. */
+    label: string;
+    /** whether the option group is disabled. */
+    disabled: boolean;
+    /** Unique id for the underlying label. */
+    _labelId: string;
+    /** Whether the group is in inert a11y mode. */
+    _inert: boolean;
+    constructor(...args: unknown[]);
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatOptgroup, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatOptgroup, "mat-optgroup", ["matOptgroup"], { "label": { "alias": "label"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, {}, never, ["*", "mat-option, ng-container"], true, never>;
+    static ngAcceptInputType_disabled: unknown;
+}
+
+/** Event object emitted by MatOption when selected or deselected. */
+declare class MatOptionSelectionChange<T = any> {
+    /** Reference to the option that emitted the event. */
+    source: MatOption<T>;
+    /** Whether the change in the option's value was a result of a user action. */
+    isUserInput: boolean;
+    constructor(
+    /** Reference to the option that emitted the event. */
+    source: MatOption<T>, 
+    /** Whether the change in the option's value was a result of a user action. */
+    isUserInput?: boolean);
+}
+/**
+ * Single option inside of a `<mat-select>` element.
+ */
+declare class MatOption<T = any> implements FocusableOption, AfterViewChecked, OnDestroy {
+    private _element;
+    _changeDetectorRef: ChangeDetectorRef;
+    private _parent;
+    group: MatOptgroup | null;
+    private _signalDisableRipple;
+    private _selected;
+    private _active;
+    private _disabled;
+    private _mostRecentViewValue;
+    /** Whether the wrapping component is in multiple selection mode. */
+    get multiple(): boolean | null | undefined;
+    /** Whether or not the option is currently selected. */
+    get selected(): boolean;
+    /** The form value of the option. */
+    value: T;
+    /** The unique ID of the option. */
+    id: string;
+    /** Whether the option is disabled. */
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    /** Whether ripples for the option are disabled. */
+    get disableRipple(): boolean;
+    /** Whether to display checkmark for single-selection. */
+    get hideSingleSelectionIndicator(): boolean;
+    /** Event emitted when the option is selected or deselected. */
+    readonly onSelectionChange: EventEmitter<MatOptionSelectionChange<T>>;
+    /** Element containing the option's text. */
+    _text: ElementRef<HTMLElement> | undefined;
+    /** Emits when the state of the option changes and any parents have to be notified. */
+    readonly _stateChanges: Subject<void>;
+    constructor(...args: unknown[]);
+    /**
+     * Whether or not the option is currently active and ready to be selected.
+     * An active option displays styles as if it is focused, but the
+     * focus is actually retained somewhere else. This comes in handy
+     * for components like autocomplete where focus must remain on the input.
+     */
+    get active(): boolean;
+    /**
+     * The displayed value of the option. It is necessary to show the selected option in the
+     * select's trigger.
+     */
+    get viewValue(): string;
+    /** Selects the option. */
+    select(emitEvent?: boolean): void;
+    /** Deselects the option. */
+    deselect(emitEvent?: boolean): void;
+    /** Sets focus onto this option. */
+    focus(_origin?: FocusOrigin, options?: FocusOptions): void;
+    /**
+     * This method sets display styles on the option to make it appear
+     * active. This is used by the ActiveDescendantKeyManager so key
+     * events will display the proper options as active on arrow key events.
+     */
+    setActiveStyles(): void;
+    /**
+     * This method removes display styles on the option that made it appear
+     * active. This is used by the ActiveDescendantKeyManager so key
+     * events will display the proper options as active on arrow key events.
+     */
+    setInactiveStyles(): void;
+    /** Gets the label to be used when determining whether the option should be focused. */
+    getLabel(): string;
+    /** Ensures the option is selected when activated from the keyboard. */
+    _handleKeydown(event: KeyboardEvent): void;
+    /**
+     * `Selects the option while indicating the selection came from the user. Used to
+     * determine if the select's view -> model callback should be invoked.`
+     */
+    _selectViaInteraction(): void;
+    /** Returns the correct tabindex for the option depending on disabled state. */
+    _getTabIndex(): string;
+    /** Gets the host DOM element. */
+    _getHostElement(): HTMLElement;
+    ngAfterViewChecked(): void;
+    ngOnDestroy(): void;
+    /** Emits the selection change event. */
+    private _emitSelectionChangeEvent;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatOption<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatOption<any>, "mat-option", ["matOption"], { "value": { "alias": "value"; "required": false; }; "id": { "alias": "id"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "onSelectionChange": "onSelectionChange"; }, never, ["mat-icon", "*"], true, never>;
+    static ngAcceptInputType_disabled: unknown;
+}
+/**
+ * Counts the amount of option group labels that precede the specified option.
+ * @param optionIndex Index of the option at which to start counting.
+ * @param options Flat list of all of the options.
+ * @param optionGroups Flat list of all of the option groups.
+ * @docs-private
+ */
+declare function _countGroupLabelsBeforeOption(optionIndex: number, options: QueryList<MatOption>, optionGroups: QueryList<MatOptgroup>): number;
+/**
+ * Determines the position to which to scroll a panel in order for an option to be into view.
+ * @param optionOffset Offset of the option from the top of the panel.
+ * @param optionHeight Height of the options.
+ * @param currentScrollPosition Current scroll position of the panel.
+ * @param panelHeight Height of the panel.
+ * @docs-private
+ */
+declare function _getOptionScrollPosition(optionOffset: number, optionHeight: number, currentScrollPosition: number, panelHeight: number): number;
+
+export { MatOption as M, _countGroupLabelsBeforeOption as _, MatOptgroup as a, MatOptionSelectionChange as b, _getOptionScrollPosition as c, MAT_OPTGROUP as d };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/material",
-  "version": "20.0.0-next.0",
+  "version": "20.0.0-next.2",
   "description": "Angular Material",
   "repository": {
     "type": "git",
@@ -353,7 +353,7 @@
     }
   },
   "peerDependencies": {
-    "@angular/cdk": "20.0.0-next.0",
+    "@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,221 +1,36 @@
-import { EventEmitter } from '@angular/core';
 import * as i0 from '@angular/core';
-import * as i1 from '@angular/material/button';
-import * as i2 from '@angular/material/select';
-import * as i3 from '@angular/material/tooltip';
-import { InjectionToken } from '@angular/core';
-import { MatFormFieldAppearance } from '@angular/material/form-field';
-import { Observable } from 'rxjs';
-import { OnDestroy } from '@angular/core';
-import { OnInit } from '@angular/core';
-import { Optional } from '@angular/core';
-import { Subject } from 'rxjs';
-import { ThemePalette } from '@angular/material/core';
-
-declare namespace i4 {
-    export {
-        MatPaginatorSelectConfig,
-        PageEvent,
-        MatPaginatorDefaultOptions,
-        MAT_PAGINATOR_DEFAULT_OPTIONS,
-        MatPaginator
-    }
-}
-
-/** Injection token that can be used to provide the default options for the paginator module. */
-export declare const MAT_PAGINATOR_DEFAULT_OPTIONS: InjectionToken<MatPaginatorDefaultOptions>;
-
-/** @docs-private */
-export declare const MAT_PAGINATOR_INTL_PROVIDER: {
-    provide: typeof MatPaginatorIntl;
-    deps: Optional[][];
-    useFactory: typeof MAT_PAGINATOR_INTL_PROVIDER_FACTORY;
-};
-
-/** @docs-private */
-export declare function MAT_PAGINATOR_INTL_PROVIDER_FACTORY(parentIntl: MatPaginatorIntl): MatPaginatorIntl;
-
-/**
- * Component to provide navigation between paged information. Displays the size of the current
- * page, user-selectable options to change that size, what items are being shown, and
- * navigational button to go to the previous or next page.
- */
-export declare class MatPaginator implements OnInit, OnDestroy {
-    _intl: MatPaginatorIntl;
-    private _changeDetectorRef;
-    /** If set, styles the "page size" form field with the designated style. */
-    _formFieldAppearance?: MatFormFieldAppearance;
-    /** ID for the DOM node containing the paginator's items per page label. */
-    readonly _pageSizeLabelId: string;
-    private _intlChanges;
-    private _isInitialized;
-    private _initializedStream;
-    /**
-     * Theme color of the underlying form controls. 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/paginator/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;
-    /** The zero-based page index of the displayed list of items. Defaulted to 0. */
-    get pageIndex(): number;
-    set pageIndex(value: number);
-    private _pageIndex;
-    /** The length of the total number of items that are being paginated. Defaulted to 0. */
-    get length(): number;
-    set length(value: number);
-    private _length;
-    /** Number of items to display on a page. By default set to 50. */
-    get pageSize(): number;
-    set pageSize(value: number);
-    private _pageSize;
-    /** The set of provided page size options to display to the user. */
-    get pageSizeOptions(): number[];
-    set pageSizeOptions(value: number[] | readonly number[]);
-    private _pageSizeOptions;
-    /** Whether to hide the page size selection UI from the user. */
-    hidePageSize: boolean;
-    /** Whether to show the first/last buttons UI to the user. */
-    showFirstLastButtons: boolean;
-    /** Used to configure the underlying `MatSelect` inside the paginator. */
-    selectConfig: MatPaginatorSelectConfig;
-    /** Whether the paginator is disabled. */
-    disabled: boolean;
-    /** Event emitted when the paginator changes the page size or page index. */
-    readonly page: EventEmitter<PageEvent>;
-    /** Displayed set of page size options. Will be sorted and include current page size. */
-    _displayedPageSizeOptions: number[];
-    /** Emits when the paginator is initialized. */
-    initialized: Observable<void>;
-    /** Inserted by Angular inject() migration for backwards compatibility */
-    constructor(...args: unknown[]);
-    ngOnInit(): void;
-    ngOnDestroy(): void;
-    /** Advances to the next page if it exists. */
-    nextPage(): void;
-    /** Move back to the previous page if it exists. */
-    previousPage(): void;
-    /** Move to the first page if not already there. */
-    firstPage(): void;
-    /** Move to the last page if not already there. */
-    lastPage(): void;
-    /** Whether there is a previous page. */
-    hasPreviousPage(): boolean;
-    /** Whether there is a next page. */
-    hasNextPage(): boolean;
-    /** Calculate the number of pages */
-    getNumberOfPages(): number;
-    /**
-     * Changes the page size so that the first item displayed on the page will still be
-     * displayed using the new page size.
-     *
-     * For example, if the page size is 10 and on the second page (items indexed 10-19) then
-     * switching so that the page size is 5 will set the third page as the current page so
-     * that the 10th item will still be displayed.
-     */
-    _changePageSize(pageSize: number): void;
-    /** Checks whether the buttons for going forwards should be disabled. */
-    _nextButtonsDisabled(): boolean;
-    /** Checks whether the buttons for going backwards should be disabled. */
-    _previousButtonsDisabled(): boolean;
-    /**
-     * Updates the list of page size options to display to the user. Includes making sure that
-     * the page size is an option and that the list is sorted.
-     */
-    private _updateDisplayedPageSizeOptions;
-    /** Emits an event notifying that a change of the paginator's properties has been triggered. */
-    private _emitPageEvent;
-    /** Navigates to a specific page index. */
-    private _navigate;
-    /**
-     * Callback invoked when one of the navigation buttons is called.
-     * @param targetIndex Index to which the paginator should navigate.
-     * @param isDisabled Whether the button is disabled.
-     */
-    protected _buttonClicked(targetIndex: number, isDisabled: boolean): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatPaginator, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatPaginator, "mat-paginator", ["matPaginator"], { "color": { "alias": "color"; "required": false; }; "pageIndex": { "alias": "pageIndex"; "required": false; }; "length": { "alias": "length"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; }; "hidePageSize": { "alias": "hidePageSize"; "required": false; }; "showFirstLastButtons": { "alias": "showFirstLastButtons"; "required": false; }; "selectConfig": { "alias": "selectConfig"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "page": "page"; }, never, never, true, never>;
-    static ngAcceptInputType_pageIndex: unknown;
-    static ngAcceptInputType_length: unknown;
-    static ngAcceptInputType_pageSize: unknown;
-    static ngAcceptInputType_hidePageSize: unknown;
-    static ngAcceptInputType_showFirstLastButtons: unknown;
-    static ngAcceptInputType_disabled: unknown;
-}
-
-/** Object that can be used to configure the default options for the paginator module. */
-export declare interface MatPaginatorDefaultOptions {
-    /** Number of items to display on a page. By default set to 50. */
-    pageSize?: number;
-    /** The set of provided page size options to display to the user. */
-    pageSizeOptions?: number[];
-    /** Whether to hide the page size selection UI from the user. */
-    hidePageSize?: boolean;
-    /** Whether to show the first/last buttons UI to the user. */
-    showFirstLastButtons?: boolean;
-    /** The default form-field appearance to apply to the page size options selector. */
-    formFieldAppearance?: MatFormFieldAppearance;
-}
-
-/**
- * To modify the labels and text displayed, create a new instance of MatPaginatorIntl and
- * include it in a custom provider
- */
-export declare class MatPaginatorIntl {
-    /**
-     * Stream to emit from when labels are changed. Use this to notify components when the labels have
-     * changed after initialization.
-     */
-    readonly changes: Subject<void>;
-    /** A label for the page size selector. */
-    itemsPerPageLabel: string;
-    /** A label for the button that increments the current page. */
-    nextPageLabel: string;
-    /** A label for the button that decrements the current page. */
-    previousPageLabel: string;
-    /** A label for the button that moves to the first page. */
-    firstPageLabel: string;
-    /** A label for the button that moves to the last page. */
-    lastPageLabel: string;
-    /** A label for the range of items within the current page and the length of the whole list. */
-    getRangeLabel: (page: number, pageSize: number, length: number) => string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatPaginatorIntl, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<MatPaginatorIntl>;
-}
-
-export declare class MatPaginatorModule {
+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';
+export { c as MAT_PAGINATOR_DEFAULT_OPTIONS, f as MAT_PAGINATOR_INTL_PROVIDER, e as MAT_PAGINATOR_INTL_PROVIDER_FACTORY, M as MatPaginator, b as MatPaginatorDefaultOptions, d as MatPaginatorIntl, a as MatPaginatorSelectConfig, P as PageEvent } from '../paginator.d-40b1766e.js';
+import '../common-module.d-0e6515ae.js';
+import '@angular/cdk/bidi';
+import '../index.d-0536b706.js';
+import '../ripple.d-2fb57d04.js';
+import '@angular/cdk/platform';
+import '@angular/cdk/a11y';
+import '../palette.d-ec4a617c.js';
+import '../ripple-loader.d-8aac2988.js';
+import '@angular/cdk/overlay';
+import '../index.d-37e31cd3.js';
+import '../pseudo-checkbox-module.d-3abc0461.js';
+import '../option.d-6f493d78.js';
+import 'rxjs';
+import '@angular/cdk/collections';
+import '@angular/cdk/scrolling';
+import '@angular/forms';
+import '../error-options.d-448d9046.js';
+import '../form-field.d-2edbc094.js';
+import '@angular/cdk/coercion';
+import '../form-field-control.d-eb86711c.js';
+import '../module.d-c17c834e.js';
+import '@angular/cdk/observers';
+
+declare class MatPaginatorModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<MatPaginatorModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<MatPaginatorModule, never, [typeof i1.MatButtonModule, typeof i2.MatSelectModule, typeof i3.MatTooltipModule, typeof i4.MatPaginator], [typeof i4.MatPaginator]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatPaginatorModule, never, [typeof MatButtonModule, typeof MatSelectModule, typeof MatTooltipModule, typeof MatPaginator], [typeof MatPaginator]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<MatPaginatorModule>;
 }
 
-/** Object that can used to configure the underlying `MatSelect` inside a `MatPaginator`. */
-export declare interface MatPaginatorSelectConfig {
-    /** Whether to center the active option over the trigger. */
-    disableOptionCentering?: boolean;
-    /** Classes to be passed to the select panel. */
-    panelClass?: string | string[] | Set<string> | {
-        [key: string]: any;
-    };
-}
-
-/**
- * Change event object that is emitted when the user selects a
- * different page size or navigates to another page.
- */
-export declare class PageEvent {
-    /** The current page index. */
-    pageIndex: number;
-    /**
-     * Index of the page that was selected previously.
-     * @breaking-change 8.0.0 To be made into a required property.
-     */
-    previousPageIndex?: number;
-    /** The current page size. */
-    pageSize: number;
-    /** The current total number of items being paged. */
-    length: number;
-}
-
-export { }
+export { MatPaginatorModule };

package/paginator/testing/index.d.ts

@@ -1,22 +1,25 @@
-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 { MatSelectHarness } from '@angular/material/select/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';
+import { M as MatSelectHarness } from '../../select-harness.d-7441a7ac.js';
+import '../../option-harness.d-3d33fc9a.js';
+import '../../optgroup-harness.d-7f741f69.js';
+import '../../form-field-control-harness.d-2d91f25a.js';
+
+/** A set of criteria that can be used to filter a list of `MatPaginatorHarness` instances. */
+interface PaginatorHarnessFilters extends BaseHarnessFilters {
+}
 
 /** Harness for interacting with a mat-paginator in tests. */
-export declare class MatPaginatorHarness extends ComponentHarness {
+declare class MatPaginatorHarness extends ComponentHarness {
     /** Selector used to find paginator instances. */
     static hostSelector: string;
     private _nextButton;
     private _previousButton;
     private _firstPageButton;
     private _lastPageButton;
-    _select: AsyncFactoryFn<MatSelectHarness | null>;
+    _select: _angular_cdk_testing.AsyncFactoryFn<MatSelectHarness | null>;
     private _pageSizeFallback;
-    _rangeLabel: AsyncFactoryFn<TestElement>;
+    _rangeLabel: _angular_cdk_testing.AsyncFactoryFn<_angular_cdk_testing.TestElement>;
     /**
      * Gets a `HarnessPredicate` that can be used to search for a paginator with specific attributes.
      * @param options Options for filtering which paginator instances are considered a match.
@@ -45,8 +48,4 @@ export declare class MatPaginatorHarness extends ComponentHarness {
     getRangeLabel(): Promise<string>;
 }
 
-/** A set of criteria that can be used to filter a list of `MatPaginatorHarness` instances. */
-export declare interface PaginatorHarnessFilters extends BaseHarnessFilters {
-}
-
-export { }
+export { MatPaginatorHarness, type PaginatorHarnessFilters };