@angular/material 14.0.0-next.9 → 14.0.0-rc.0

package/badge/testing/index.d.ts

@@ -1,8 +1,36 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-export * from './public-api';
+import { BaseHarnessFilters } from '@angular/cdk/testing';
+import { ComponentHarness } from '@angular/cdk/testing';
+import { HarnessPredicate } from '@angular/cdk/testing';
+import { MatBadgePosition } from '@angular/material/badge';
+import { MatBadgeSize } from '@angular/material/badge';
+
+export declare interface BadgeHarnessFilters extends BaseHarnessFilters {
+    text?: string | RegExp;
+}
+
+/** Harness for interacting with a standard Material badge in tests. */
+export declare class MatBadgeHarness extends ComponentHarness {
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a badge with specific attributes.
+     * @param options Options for narrowing the search:
+     *   - `text` finds a badge host with a particular text.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with(options?: BadgeHarnessFilters): HarnessPredicate<MatBadgeHarness>;
+    private _badgeElement;
+    /** Gets a promise for the badge text. */
+    getText(): Promise<string>;
+    /** Gets whether the badge is overlapping the content. */
+    isOverlapping(): Promise<boolean>;
+    /** Gets the position of the badge. */
+    getPosition(): Promise<MatBadgePosition>;
+    /** Gets the size of the badge. */
+    getSize(): Promise<MatBadgeSize>;
+    /** Gets whether the badge is hidden. */
+    isHidden(): Promise<boolean>;
+    /** Gets whether the badge is disabled. */
+    isDisabled(): Promise<boolean>;
+}
+
+export { }

package/bottom-sheet/index.d.ts

@@ -1,8 +1,268 @@
+import { AnimationEvent as AnimationEvent_2 } from '@angular/animations';
+import { AnimationTriggerMetadata } from '@angular/animations';
+import { BasePortalOutlet } from '@angular/cdk/portal';
+import { BreakpointObserver } from '@angular/cdk/layout';
+import { CdkPortalOutlet } from '@angular/cdk/portal';
+import { ChangeDetectorRef } from '@angular/core';
+import { ComponentPortal } from '@angular/cdk/portal';
+import { ComponentRef } from '@angular/core';
+import { ComponentType } from '@angular/cdk/portal';
+import { Direction } from '@angular/cdk/bidi';
+import { DomPortal } from '@angular/cdk/portal';
+import { ElementRef } from '@angular/core';
+import { EmbeddedViewRef } from '@angular/core';
+import { EventEmitter } from '@angular/core';
+import { FocusTrapFactory } from '@angular/cdk/a11y';
+import * as i0 from '@angular/core';
+import * as i2 from '@angular/cdk/overlay';
+import * as i3 from '@angular/material/core';
+import * as i4 from '@angular/cdk/portal';
+import { InjectionToken } from '@angular/core';
+import { Injector } from '@angular/core';
+import { InteractivityChecker } from '@angular/cdk/a11y';
+import { NgZone } from '@angular/core';
+import { Observable } from 'rxjs';
+import { OnDestroy } from '@angular/core';
+import { Overlay } from '@angular/cdk/overlay';
+import { OverlayRef } from '@angular/cdk/overlay';
+import { ScrollStrategy } from '@angular/cdk/overlay';
+import { TemplatePortal } from '@angular/cdk/portal';
+import { TemplateRef } from '@angular/core';
+import { ViewContainerRef } from '@angular/core';
+
+/** Options for where to set focus to automatically on dialog open */
+export declare type AutoFocusTarget = 'dialog' | 'first-tabbable' | 'first-heading';
+
+declare namespace i1 {
+    export {
+        MatBottomSheetContainer
+    }
+}
+
+/** Injection token that can be used to access the data that was passed in to a bottom sheet. */
+export declare const MAT_BOTTOM_SHEET_DATA: InjectionToken<any>;
+
+/** Injection token that can be used to specify default bottom sheet options. */
+export declare const MAT_BOTTOM_SHEET_DEFAULT_OPTIONS: InjectionToken<MatBottomSheetConfig<any>>;
+
 /**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
+ * Service to trigger Material Design bottom sheets.
  */
-export * from './public-api';
+export declare class MatBottomSheet implements OnDestroy {
+    private _overlay;
+    private _injector;
+    private _parentBottomSheet;
+    private _defaultOptions?;
+    private _bottomSheetRefAtThisLevel;
+    /** Reference to the currently opened bottom sheet. */
+    get _openedBottomSheetRef(): MatBottomSheetRef<any> | null;
+    set _openedBottomSheetRef(value: MatBottomSheetRef<any> | null);
+    constructor(_overlay: Overlay, _injector: Injector, _parentBottomSheet: MatBottomSheet, _defaultOptions?: MatBottomSheetConfig<any> | undefined);
+    /**
+     * Opens a bottom sheet containing the given component.
+     * @param component Type of the component to load into the bottom sheet.
+     * @param config Extra configuration options.
+     * @returns Reference to the newly-opened bottom sheet.
+     */
+    open<T, D = any, R = any>(component: ComponentType<T>, config?: MatBottomSheetConfig<D>): MatBottomSheetRef<T, R>;
+    /**
+     * Opens a bottom sheet containing the given template.
+     * @param template TemplateRef to instantiate as the bottom sheet content.
+     * @param config Extra configuration options.
+     * @returns Reference to the newly-opened bottom sheet.
+     */
+    open<T, D = any, R = any>(template: TemplateRef<T>, config?: MatBottomSheetConfig<D>): MatBottomSheetRef<T, R>;
+    /**
+     * Dismisses the currently-visible bottom sheet.
+     * @param result Data to pass to the bottom sheet instance.
+     */
+    dismiss<R = any>(result?: R): void;
+    ngOnDestroy(): void;
+    /**
+     * Attaches the bottom sheet container component to the overlay.
+     */
+    private _attachContainer;
+    /**
+     * Creates a new overlay and places it in the correct location.
+     * @param config The user-specified bottom sheet config.
+     */
+    private _createOverlay;
+    /**
+     * Creates an injector to be used inside of a bottom sheet component.
+     * @param config Config that was used to create the bottom sheet.
+     * @param bottomSheetRef Reference to the bottom sheet.
+     */
+    private _createInjector;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatBottomSheet, [null, null, { optional: true; skipSelf: true; }, { optional: true; }]>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MatBottomSheet>;
+}
+
+/** Animations used by the Material bottom sheet. */
+export declare const matBottomSheetAnimations: {
+    readonly bottomSheetState: AnimationTriggerMetadata;
+};
+
+/**
+ * Configuration used when opening a bottom sheet.
+ */
+export declare class MatBottomSheetConfig<D = any> {
+    /** The view container to place the overlay for the bottom sheet into. */
+    viewContainerRef?: ViewContainerRef;
+    /** Extra CSS classes to be added to the bottom sheet container. */
+    panelClass?: string | string[];
+    /** Text layout direction for the bottom sheet. */
+    direction?: Direction;
+    /** Data being injected into the child component. */
+    data?: D | null;
+    /** Whether the bottom sheet has a backdrop. */
+    hasBackdrop?: boolean;
+    /** Custom class for the backdrop. */
+    backdropClass?: string;
+    /** Whether the user can use escape or clicking outside to close the bottom sheet. */
+    disableClose?: boolean;
+    /** Aria label to assign to the bottom sheet element. */
+    ariaLabel?: string | null;
+    /**
+     * Whether the bottom sheet should close when the user goes backwards/forwards in history.
+     * Note that this usually doesn't include clicking on links (unless the user is using
+     * the `HashLocationStrategy`).
+     */
+    closeOnNavigation?: boolean;
+    /**
+     * Where the bottom sheet should focus on open.
+     * @breaking-change 14.0.0 Remove boolean option from autoFocus. Use string or
+     * AutoFocusTarget instead.
+     */
+    autoFocus?: AutoFocusTarget | string | boolean;
+    /**
+     * Whether the bottom sheet should restore focus to the
+     * previously-focused element, after it's closed.
+     */
+    restoreFocus?: boolean;
+    /** Scroll strategy to be used for the bottom sheet. */
+    scrollStrategy?: ScrollStrategy;
+}
+
+/**
+ * Internal component that wraps user-provided bottom sheet content.
+ * @docs-private
+ */
+export declare class MatBottomSheetContainer extends BasePortalOutlet implements OnDestroy {
+    private _elementRef;
+    private _changeDetectorRef;
+    private _focusTrapFactory;
+    private readonly _interactivityChecker;
+    private readonly _ngZone;
+    /** The bottom sheet configuration. */
+    bottomSheetConfig: MatBottomSheetConfig;
+    private _breakpointSubscription;
+    /** The portal outlet inside of this container into which the content will be loaded. */
+    _portalOutlet: CdkPortalOutlet;
+    /** The state of the bottom sheet animations. */
+    _animationState: 'void' | 'visible' | 'hidden';
+    /** Emits whenever the state of the animation changes. */
+    _animationStateChanged: EventEmitter<AnimationEvent_2>;
+    /** The class that traps and manages focus within the bottom sheet. */
+    private _focusTrap;
+    /** Element that was focused before the bottom sheet was opened. */
+    private _elementFocusedBeforeOpened;
+    /** Server-side rendering-compatible reference to the global document object. */
+    private _document;
+    /** Whether the component has been destroyed. */
+    private _destroyed;
+    constructor(_elementRef: ElementRef<HTMLElement>, _changeDetectorRef: ChangeDetectorRef, _focusTrapFactory: FocusTrapFactory, _interactivityChecker: InteractivityChecker, _ngZone: NgZone, breakpointObserver: BreakpointObserver, document: any, 
+    /** The bottom sheet configuration. */
+    bottomSheetConfig: MatBottomSheetConfig);
+    /** Attach a component portal as content to this bottom sheet container. */
+    attachComponentPortal<T>(portal: ComponentPortal<T>): ComponentRef<T>;
+    /** Attach a template portal as content to this bottom sheet container. */
+    attachTemplatePortal<C>(portal: TemplatePortal<C>): EmbeddedViewRef<C>;
+    /**
+     * Attaches a DOM portal to the bottom sheet container.
+     * @deprecated To be turned into a method.
+     * @breaking-change 10.0.0
+     */
+    attachDomPortal: (portal: DomPortal) => void;
+    /** Begin animation of bottom sheet entrance into view. */
+    enter(): void;
+    /** Begin animation of the bottom sheet exiting from view. */
+    exit(): void;
+    ngOnDestroy(): void;
+    _onAnimationDone(event: AnimationEvent_2): void;
+    _onAnimationStart(event: AnimationEvent_2): void;
+    private _toggleClass;
+    private _validatePortalAttached;
+    private _setPanelClass;
+    /**
+     * Focuses the provided element. If the element is not focusable, it will add a tabIndex
+     * attribute to forcefully focus it. The attribute is removed after focus is moved.
+     * @param element The element to focus.
+     */
+    private _forceFocus;
+    /**
+     * Focuses the first element that matches the given selector within the focus trap.
+     * @param selector The CSS selector for the element to set focus to.
+     */
+    private _focusByCssSelector;
+    /**
+     * Moves the focus inside the focus trap. When autoFocus is not set to 'bottom-sheet',
+     * if focus cannot be moved then focus will go to the bottom sheet container.
+     */
+    private _trapFocus;
+    /** Restores focus to the element that was focused before the bottom sheet was opened. */
+    private _restoreFocus;
+    /** Saves a reference to the element that was focused before the bottom sheet was opened. */
+    private _savePreviouslyFocusedElement;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatBottomSheetContainer, [null, null, null, null, null, null, { optional: true; }, null]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatBottomSheetContainer, "mat-bottom-sheet-container", never, {}, {}, never, never, false>;
+}
+
+export declare class MatBottomSheetModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatBottomSheetModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatBottomSheetModule, [typeof i1.MatBottomSheetContainer], [typeof i2.OverlayModule, typeof i3.MatCommonModule, typeof i4.PortalModule], [typeof i1.MatBottomSheetContainer, typeof i3.MatCommonModule]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatBottomSheetModule>;
+}
+
+/**
+ * Reference to a bottom sheet dispatched from the bottom sheet service.
+ */
+export declare class MatBottomSheetRef<T = any, R = any> {
+    private _overlayRef;
+    /** Instance of the component making up the content of the bottom sheet. */
+    instance: T;
+    /**
+     * Instance of the component into which the bottom sheet content is projected.
+     * @docs-private
+     */
+    containerInstance: MatBottomSheetContainer;
+    /** Whether the user is allowed to close the bottom sheet. */
+    disableClose: boolean | undefined;
+    /** Subject for notifying the user that the bottom sheet has been dismissed. */
+    private readonly _afterDismissed;
+    /** Subject for notifying the user that the bottom sheet has opened and appeared. */
+    private readonly _afterOpened;
+    /** Result to be passed down to the `afterDismissed` stream. */
+    private _result;
+    /** Handle to the timeout that's running as a fallback in case the exit animation doesn't fire. */
+    private _closeFallbackTimeout;
+    constructor(containerInstance: MatBottomSheetContainer, _overlayRef: OverlayRef);
+    /**
+     * Dismisses the bottom sheet.
+     * @param result Data to be passed back to the bottom sheet opener.
+     */
+    dismiss(result?: R): void;
+    /** Gets an observable that is notified when the bottom sheet is finished closing. */
+    afterDismissed(): Observable<R | undefined>;
+    /** Gets an observable that is notified when the bottom sheet has opened and appeared. */
+    afterOpened(): Observable<void>;
+    /**
+     * Gets an observable that emits when the overlay's backdrop has been clicked.
+     */
+    backdropClick(): Observable<MouseEvent>;
+    /**
+     * Gets an observable that emits when keydown events are targeted on the overlay.
+     */
+    keydownEvents(): Observable<KeyboardEvent>;
+}
+
+export { }

package/bottom-sheet/testing/index.d.ts

@@ -1,8 +1,27 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-export * from './public-api';
+import { BaseHarnessFilters } from '@angular/cdk/testing';
+import { ContentContainerComponentHarness } from '@angular/cdk/testing';
+import { HarnessPredicate } from '@angular/cdk/testing';
+
+export declare interface BottomSheetHarnessFilters extends BaseHarnessFilters {
+}
+
+/** Harness for interacting with a standard MatBottomSheet in tests. */
+export declare class MatBottomSheetHarness extends ContentContainerComponentHarness<string> {
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a bottom sheet with
+     * specific attributes.
+     * @param options Options for narrowing the search.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with(options?: BottomSheetHarnessFilters): HarnessPredicate<MatBottomSheetHarness>;
+    /** Gets the value of the bottom sheet's "aria-label" attribute. */
+    getAriaLabel(): Promise<string | null>;
+    /**
+     * Dismisses the bottom sheet by pressing escape. Note that this method cannot
+     * be used if "disableClose" has been set to true via the config.
+     */
+    dismiss(): Promise<void>;
+}
+
+export { }

package/button/index.d.ts

@@ -1,8 +1,79 @@
+import { _AbstractConstructor } from '@angular/material/core';
+import { AfterViewInit } from '@angular/core';
+import { CanColor } from '@angular/material/core';
+import { CanDisable } from '@angular/material/core';
+import { CanDisableRipple } from '@angular/material/core';
+import { _Constructor } from '@angular/material/core';
+import { ElementRef } from '@angular/core';
+import { FocusableOption } from '@angular/cdk/a11y';
+import { FocusMonitor } from '@angular/cdk/a11y';
+import { FocusOrigin } from '@angular/cdk/a11y';
+import * as i0 from '@angular/core';
+import * as i2 from '@angular/material/core';
+import { MatRipple } from '@angular/material/core';
+import { NgZone } from '@angular/core';
+import { OnDestroy } from '@angular/core';
+
+declare namespace i1 {
+    export {
+        MatButton,
+        MatAnchor
+    }
+}
+
 /**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
+ * Material design anchor button.
  */
-export * from './public-api';
+export declare class MatAnchor extends MatButton implements AfterViewInit, OnDestroy {
+    /** @breaking-change 14.0.0 _ngZone will be required. */
+    private _ngZone?;
+    /** Tabindex of the button. */
+    tabIndex: number;
+    constructor(focusMonitor: FocusMonitor, elementRef: ElementRef, animationMode: string, 
+    /** @breaking-change 14.0.0 _ngZone will be required. */
+    _ngZone?: NgZone | undefined);
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    _haltDisabledEvents: (event: Event) => void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatAnchor, [null, null, { optional: true; }, { optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatAnchor, "a[mat-button], a[mat-raised-button], a[mat-icon-button], a[mat-fab],             a[mat-mini-fab], a[mat-stroked-button], a[mat-flat-button]", ["matButton", "matAnchor"], { "disabled": "disabled"; "disableRipple": "disableRipple"; "color": "color"; "tabIndex": "tabIndex"; }, {}, never, ["*"], false>;
+}
+
+/**
+ * Material design button.
+ */
+export declare class MatButton extends _MatButtonBase implements AfterViewInit, OnDestroy, CanDisable, CanColor, CanDisableRipple, FocusableOption {
+    private _focusMonitor;
+    _animationMode: string;
+    /** Whether the button is round. */
+    readonly isRoundButton: boolean;
+    /** Whether the button is icon button. */
+    readonly isIconButton: boolean;
+    /** Reference to the MatRipple instance of the button. */
+    ripple: MatRipple;
+    constructor(elementRef: ElementRef, _focusMonitor: FocusMonitor, _animationMode: string);
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    /** Focuses the button. */
+    focus(origin?: FocusOrigin, options?: FocusOptions): void;
+    _getHostElement(): any;
+    _isRippleDisabled(): boolean;
+    /** Gets whether the button has one of the given attributes. */
+    _hasHostAttributes(...attributes: string[]): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatButton, [null, null, { optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatButton, "button[mat-button], button[mat-raised-button], button[mat-icon-button],             button[mat-fab], button[mat-mini-fab], button[mat-stroked-button],             button[mat-flat-button]", ["matButton"], { "disabled": "disabled"; "disableRipple": "disableRipple"; "color": "color"; }, {}, never, ["*"], false>;
+}
+
+declare const _MatButtonBase: _Constructor<CanColor> & _AbstractConstructor<CanColor> & _Constructor<CanDisable> & _AbstractConstructor<CanDisable> & _Constructor<CanDisableRipple> & _AbstractConstructor<CanDisableRipple> & {
+    new (_elementRef: ElementRef): {
+        _elementRef: ElementRef;
+    };
+};
+
+export declare class MatButtonModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatButtonModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatButtonModule, [typeof i1.MatButton, typeof i1.MatAnchor], [typeof i2.MatRippleModule, typeof i2.MatCommonModule], [typeof i1.MatButton, typeof i1.MatAnchor, typeof i2.MatCommonModule]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatButtonModule>;
+}
+
+export { }

package/button/testing/index.d.ts

@@ -1,8 +1,44 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-export * from './public-api';
+import { BaseHarnessFilters } from '@angular/cdk/testing';
+import { ContentContainerComponentHarness } from '@angular/cdk/testing';
+import { HarnessPredicate } from '@angular/cdk/testing';
+
+/** A set of criteria that can be used to filter a list of `MatButtonHarness` instances. */
+export declare interface ButtonHarnessFilters extends BaseHarnessFilters {
+    /** Only find instances whose text matches the given value. */
+    text?: string | RegExp;
+}
+
+/** Harness for interacting with a standard mat-button in tests. */
+export declare class MatButtonHarness extends ContentContainerComponentHarness {
+    /** The selector for the host element of a `MatButton` instance. */
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a `MatButtonHarness` that meets
+     * certain criteria.
+     * @param options Options for filtering which button instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with(options?: ButtonHarnessFilters): HarnessPredicate<MatButtonHarness>;
+    /**
+     * Clicks the button at the given position relative to its top-left.
+     * @param relativeX The relative x position of the click.
+     * @param relativeY The relative y position of the click.
+     */
+    click(relativeX: number, relativeY: number): Promise<void>;
+    /** Clicks the button at its center. */
+    click(location: 'center'): Promise<void>;
+    /** Clicks the button. */
+    click(): Promise<void>;
+    /** Whether the button is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Gets the button's label text. */
+    getText(): Promise<string>;
+    /** Focuses the button. */
+    focus(): Promise<void>;
+    /** Blurs the button. */
+    blur(): Promise<void>;
+    /** Whether the button is focused. */
+    isFocused(): Promise<boolean>;
+}
+
+export { }