@angular/cdk-experimental 14.0.0-next.0 → 14.0.0-next.11

package/combobox/combobox-module.d.ts

@@ -1,10 +1,9 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./combobox";
-import * as i2 from "./combobox-panel";
-import * as i3 from "./combobox-popup";
-import * as i4 from "@angular/cdk/overlay";
+import * as i2 from "./combobox-popup";
+import * as i3 from "@angular/cdk/overlay";
 export declare class CdkComboboxModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<CdkComboboxModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<CdkComboboxModule, [typeof i1.CdkCombobox, typeof i2.CdkComboboxPanel, typeof i3.CdkComboboxPopup], [typeof i4.OverlayModule], [typeof i1.CdkCombobox, typeof i2.CdkComboboxPanel, typeof i3.CdkComboboxPopup]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<CdkComboboxModule, [typeof i1.CdkCombobox, typeof i2.CdkComboboxPopup], [typeof i3.OverlayModule], [typeof i1.CdkCombobox, typeof i2.CdkComboboxPopup]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<CdkComboboxModule>;
 }

package/combobox/combobox-popup.d.ts

@@ -5,13 +5,12 @@
  * 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
  */
-import { ElementRef, InjectionToken, OnInit } from '@angular/core';
-import { AriaHasPopupValue, CdkComboboxPanel } from './combobox-panel';
+import { ElementRef, OnInit } from '@angular/core';
+import { AriaHasPopupValue, CdkCombobox } from './combobox';
 import * as i0 from "@angular/core";
-export declare const PANEL: InjectionToken<CdkComboboxPanel<unknown>>;
 export declare class CdkComboboxPopup<T = unknown> implements OnInit {
     private readonly _elementRef;
-    readonly _parentPanel?: CdkComboboxPanel<T> | undefined;
+    private readonly _combobox;
     get role(): AriaHasPopupValue;
     set role(value: AriaHasPopupValue);
     private _role;
@@ -19,11 +18,10 @@ export declare class CdkComboboxPopup<T = unknown> implements OnInit {
     set firstFocus(id: HTMLElement);
     private _firstFocusElement;
     id: string;
-    private readonly _explicitPanel;
-    constructor(_elementRef: ElementRef<HTMLElement>, _parentPanel?: CdkComboboxPanel<T> | undefined);
+    constructor(_elementRef: ElementRef<HTMLElement>, _combobox: CdkCombobox);
     ngOnInit(): void;
     registerWithPanel(): void;
     focusFirstElement(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<CdkComboboxPopup<any>, [null, { optional: true; }]>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<CdkComboboxPopup<any>, "[cdkComboboxPopup]", ["cdkComboboxPopup"], { "role": "role"; "firstFocus": "firstFocus"; "id": "id"; "_explicitPanel": "parentPanel"; }, {}, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CdkComboboxPopup<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CdkComboboxPopup<any>, "[cdkComboboxPopup]", ["cdkComboboxPopup"], { "role": "role"; "firstFocus": "firstFocus"; "id": "id"; }, {}, never>;
 }

package/combobox/combobox.d.ts

@@ -1,26 +1,20 @@
-import { AfterContentInit, ElementRef, EventEmitter, OnDestroy, ViewContainerRef } from '@angular/core';
-import { CdkComboboxPanel, AriaHasPopupValue } from './combobox-panel';
+import { ElementRef, EventEmitter, InjectionToken, Injector, OnDestroy, TemplateRef, ViewContainerRef } from '@angular/core';
 import { Overlay } from '@angular/cdk/overlay';
 import { Directionality } from '@angular/cdk/bidi';
 import { BooleanInput } from '@angular/cdk/coercion';
 import * as i0 from "@angular/core";
-/**
- * @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 declare type AriaHasPopupValue = 'false' | 'true' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';
 export declare type OpenAction = 'focus' | 'click' | 'downKey' | 'toggle';
 export declare type OpenActionInput = OpenAction | OpenAction[] | string | null | undefined;
-export declare class CdkCombobox<T = unknown> implements OnDestroy, AfterContentInit {
+export declare const CDK_COMBOBOX: InjectionToken<CdkCombobox<unknown>>;
+export declare class CdkCombobox<T = unknown> implements OnDestroy {
     private readonly _elementRef;
     private readonly _overlay;
     protected readonly _viewContainerRef: ViewContainerRef;
+    private readonly _injector;
+    private readonly _doc;
     private readonly _directionality?;
-    get panel(): CdkComboboxPanel<T> | undefined;
-    set panel(panel: CdkComboboxPanel<T> | undefined);
-    private _panel;
+    _panelTemplateRef: TemplateRef<unknown>;
     value: T | T[];
     get disabled(): boolean;
     set disabled(value: BooleanInput);
@@ -36,11 +30,10 @@ export declare class CdkCombobox<T = unknown> implements OnDestroy, AfterContent
     readonly closed: EventEmitter<void>;
     readonly panelValueChanged: EventEmitter<T[]>;
     private _overlayRef;
-    private _panelContent;
+    private _panelPortal;
     contentId: string;
     contentType: AriaHasPopupValue;
-    constructor(_elementRef: ElementRef<HTMLElement>, _overlay: Overlay, _viewContainerRef: ViewContainerRef, _directionality?: Directionality | undefined);
-    ngAfterContentInit(): void;
+    constructor(_elementRef: ElementRef<HTMLElement>, _overlay: Overlay, _viewContainerRef: ViewContainerRef, _injector: Injector, _doc: any, _directionality?: Directionality | undefined);
     ngOnDestroy(): void;
     _keydown(event: KeyboardEvent): void;
     /** Handles click or focus interactions. */
@@ -59,13 +52,17 @@ export declare class CdkCombobox<T = unknown> implements OnDestroy, AfterContent
     hasPanel(): boolean;
     _getTabIndex(): string | null;
     private _setComboboxValue;
+    updateAndClose(value: T | T[]): void;
     private _setTextContent;
     private _isTextTrigger;
     private _getOverlayConfig;
     private _getOverlayPositionStrategy;
     private _getOverlayPositions;
+    private _getPanelInjector;
     private _getPanelContent;
     private _coerceOpenActionProperty;
-    static ɵfac: i0.ɵɵFactoryDeclaration<CdkCombobox<any>, [null, null, null, { optional: true; }]>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<CdkCombobox<any>, "[cdkCombobox]", ["cdkCombobox"], { "panel": "cdkComboboxTriggerFor"; "value": "value"; "disabled": "disabled"; "openActions": "openActions"; "autoSetText": "autoSetText"; }, { "opened": "comboboxPanelOpened"; "closed": "comboboxPanelClosed"; "panelValueChanged": "panelValueChanged"; }, never>;
+    /** Registers the content's id and the content type with the panel. */
+    _registerContent(contentId: string, contentType: AriaHasPopupValue): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CdkCombobox<any>, [null, null, null, null, null, { optional: true; }]>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CdkCombobox<any>, "[cdkCombobox]", ["cdkCombobox"], { "_panelTemplateRef": "cdkComboboxTriggerFor"; "value": "value"; "disabled": "disabled"; "openActions": "openActions"; "autoSetText": "autoSetText"; }, { "opened": "comboboxPanelOpened"; "closed": "comboboxPanelClosed"; "panelValueChanged": "panelValueChanged"; }, never>;
 }

package/combobox/public-api.d.ts

@@ -7,5 +7,4 @@
  */
 export * from './combobox-module';
 export * from './combobox';
-export * from './combobox-panel';
 export * from './combobox-popup';

package/dialog/dialog-config.d.ts

@@ -5,24 +5,16 @@
  * 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
  */
-import { ViewContainerRef } from '@angular/core';
+import { ViewContainerRef, ComponentFactoryResolver, Injector, StaticProvider, Type } from '@angular/core';
 import { Direction } from '@angular/cdk/bidi';
-import { ComponentType } from '@angular/cdk/overlay';
-import { CdkDialogContainer } from './dialog-container';
+import { PositionStrategy, ScrollStrategy } from '@angular/cdk/overlay';
+import { BasePortalOutlet } from '@angular/cdk/portal';
 /** Options for where to set focus to automatically on dialog open */
 export declare type AutoFocusTarget = 'dialog' | 'first-tabbable' | 'first-heading';
-/** Valid ARIA roles for a dialog element. */
+/** Valid ARIA roles for a dialog. */
 export declare type DialogRole = 'dialog' | 'alertdialog';
-/** Possible overrides for a dialog's position. */
-export interface DialogPosition {
-    top?: string;
-    bottom?: string;
-    left?: string;
-    right?: string;
-}
-export declare class DialogConfig<D = any> {
-    /** Component to use as the container for the dialog. */
-    containerComponent?: ComponentType<CdkDialogContainer>;
+/** Configuration for opening a modal dialog. */
+export declare class DialogConfig<D = unknown, R = unknown, C extends BasePortalOutlet = BasePortalOutlet> {
     /**
      * Where the attached component should live in Angular's *logical* component tree.
      * This affects what is available for injection and the change detection order for the
@@ -30,48 +22,90 @@ export declare class DialogConfig<D = any> {
      * content will be rendered.
      */
     viewContainerRef?: ViewContainerRef;
-    /** The id of the dialog. */
+    /**
+     * Injector used for the instantiation of the component to be attached. If provided,
+     * takes precedence over the injector indirectly provided by `ViewContainerRef`.
+     */
+    injector?: Injector;
+    /** ID for the dialog. If omitted, a unique one will be generated. */
     id?: string;
-    /** The ARIA role of the dialog. */
+    /** The ARIA role of the dialog element. */
     role?: DialogRole;
-    /** Custom class(es) for the overlay panel. */
+    /** Optional CSS class or classes applied to the overlay panel. */
     panelClass?: string | string[];
-    /** Whether the dialog has a background. */
+    /** Whether the dialog has a backdrop. */
     hasBackdrop?: boolean;
-    /** Custom class(es) for the backdrop. */
-    backdropClass?: string | undefined;
-    /** Whether the dialog can be closed by user interaction. */
+    /** Optional CSS class or classes applied to the overlay backdrop. */
+    backdropClass?: string | string[];
+    /** Whether the dialog closes with the escape key or pointer events outside the panel element. */
     disableClose?: boolean;
-    /** The width of the dialog. */
+    /** Width of the dialog. */
     width?: string;
-    /** The height of the dialog. */
+    /** Height of the dialog. */
     height?: string;
-    /** The minimum width of the dialog. */
-    minWidth?: string | number;
-    /** The minimum height of the dialog. */
-    minHeight?: string | number;
-    /** The maximum width of the dialog. */
-    maxWidth?: string | number;
-    /** The maximum height of the dialog. */
-    maxHeight?: string | number;
-    /** The position of the dialog. */
-    position?: DialogPosition;
-    /** Data to be injected into the dialog content. */
+    /** Min-width of the dialog. If a number is provided, assumes pixel units. */
+    minWidth?: number | string;
+    /** Min-height of the dialog. If a number is provided, assumes pixel units. */
+    minHeight?: number | string;
+    /** Max-width of the dialog. If a number is provided, assumes pixel units. Defaults to 80vw. */
+    maxWidth?: number | string;
+    /** Max-height of the dialog. If a number is provided, assumes pixel units. */
+    maxHeight?: number | string;
+    /** Strategy to use when positioning the dialog. Defaults to centering it on the page. */
+    positionStrategy?: PositionStrategy;
+    /** Data being injected into the child component. */
     data?: D | null;
-    /** The layout direction for the dialog content. */
+    /** Layout direction for the dialog's content. */
     direction?: Direction;
     /** ID of the element that describes the dialog. */
     ariaDescribedBy?: string | null;
-    /** Aria label to assign to the dialog element */
+    /** ID of the element that labels the dialog. */
+    ariaLabelledBy?: string | null;
+    /** Dialog label applied via `aria-label` */
     ariaLabel?: string | null;
+    /** Whether this a modal dialog. Used to set the `aria-modal` attribute. */
+    ariaModal?: boolean;
     /**
      * Where the dialog should focus on open.
      * @breaking-change 14.0.0 Remove boolean option from autoFocus. Use string or
      * AutoFocusTarget instead.
      */
     autoFocus?: AutoFocusTarget | string | boolean;
-    /** Duration of the enter animation. Has to be a valid CSS value (e.g. 100ms). */
-    enterAnimationDuration?: string;
-    /** Duration of the exit animation. Has to be a valid CSS value (e.g. 50ms). */
-    exitAnimationDuration?: string;
+    /**
+     * Whether the dialog should restore focus to the
+     * previously-focused element upon closing.
+     */
+    restoreFocus?: boolean;
+    /**
+     * Scroll strategy to be used for the dialog. This determines how
+     * the dialog responds to scrolling underneath the panel element.
+     */
+    scrollStrategy?: ScrollStrategy;
+    /**
+     * Whether the dialog should close when the user navigates backwards or forwards through browser
+     * history. This does not apply to navigation via anchor element unless using URL-hash based
+     * routing (`HashLocationStrategy` in the Angular router).
+     */
+    closeOnNavigation?: boolean;
+    /** Alternate `ComponentFactoryResolver` to use when resolving the associated component. */
+    componentFactoryResolver?: ComponentFactoryResolver;
+    /**
+     * Providers that will be exposed to the contents of the dialog. Can also
+     * be provided as a function in order to generate the providers lazily.
+     */
+    providers?: StaticProvider[] | ((dialogRef: R, config: DialogConfig<D, R, C>, container: C) => StaticProvider[]);
+    /**
+     * Component into which the dialog content will be rendered. Defaults to `CdkDialogContainer`.
+     * A configuration object can be passed in to customize the providers that will be exposed
+     * to the dialog container.
+     */
+    container?: Type<C> | {
+        type: Type<C>;
+        providers: (config: DialogConfig<D, R, C>) => StaticProvider[];
+    };
+    /**
+     * Context that will be passed to template-based dialogs.
+     * A function can be passed in to resolve the context lazily.
+     */
+    templateContext?: Record<string, any> | (() => Record<string, any>);
 }

package/dialog/dialog-container.d.ts

@@ -5,11 +5,10 @@
  * 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
  */
-import { AnimationEvent } from '@angular/animations';
-import { FocusTrapFactory, InteractivityChecker } from '@angular/cdk/a11y';
+import { FocusMonitor, FocusOrigin, FocusTrapFactory, InteractivityChecker } from '@angular/cdk/a11y';
+import { OverlayRef } from '@angular/cdk/overlay';
 import { BasePortalOutlet, CdkPortalOutlet, ComponentPortal, DomPortal, TemplatePortal } from '@angular/cdk/portal';
-import { ChangeDetectorRef, ComponentRef, ElementRef, EmbeddedViewRef, NgZone, OnDestroy } from '@angular/core';
-import { Subject } from 'rxjs';
+import { AfterViewInit, ComponentRef, ElementRef, EmbeddedViewRef, NgZone, OnDestroy } from '@angular/core';
 import { DialogConfig } from './dialog-config';
 import * as i0 from "@angular/core";
 export declare function throwDialogContentAlreadyAttachedError(): void;
@@ -17,39 +16,36 @@ export declare function throwDialogContentAlreadyAttachedError(): void;
  * Internal component that wraps user-provided dialog content.
  * @docs-private
  */
-export declare class CdkDialogContainer extends BasePortalOutlet implements OnDestroy {
-    private _elementRef;
-    private _focusTrapFactory;
-    private _changeDetectorRef;
-    private readonly _interactivityChecker;
-    private readonly _ngZone;
-    /** The dialog configuration. */
-    _config: DialogConfig;
-    private readonly _document;
-    /** State of the dialog animation. */
-    _state: 'void' | 'enter' | 'exit';
-    /** Element that was focused before the dialog was opened. Save this to restore upon close. */
-    private _elementFocusedBeforeDialogWasOpened;
+export declare class CdkDialogContainer<C extends DialogConfig = DialogConfig> extends BasePortalOutlet implements AfterViewInit, OnDestroy {
+    protected _elementRef: ElementRef;
+    protected _focusTrapFactory: FocusTrapFactory;
+    readonly _config: C;
+    private _interactivityChecker;
+    private _ngZone;
+    private _overlayRef;
+    private _focusMonitor?;
+    protected _document: Document;
+    /** The portal outlet inside of this container into which the dialog content will be loaded. */
+    _portalOutlet: CdkPortalOutlet;
     /** The class that traps and manages focus within the dialog. */
     private _focusTrap;
-    /** The portal host inside of this container into which the dialog content will be loaded. */
-    _portalHost: CdkPortalOutlet;
-    /** A subject emitting before the dialog enters the view. */
-    readonly _beforeEnter: Subject<void>;
-    /** A subject emitting after the dialog enters the view. */
-    readonly _afterEnter: Subject<void>;
-    /** A subject emitting before the dialog exits the view. */
-    readonly _beforeExit: Subject<void>;
-    /** A subject emitting after the dialog exits the view. */
-    readonly _afterExit: Subject<void>;
-    /** Stream of animation `done` events. */
-    readonly _animationDone: Subject<AnimationEvent>;
-    constructor(_elementRef: ElementRef<HTMLElement>, _focusTrapFactory: FocusTrapFactory, _changeDetectorRef: ChangeDetectorRef, _interactivityChecker: InteractivityChecker, _ngZone: NgZone, _document: any, 
-    /** The dialog configuration. */
-    _config: DialogConfig);
-    /** Initializes the dialog container with the attached content. */
-    _initializeWithAttachedContent(): void;
-    /** Destroy focus trap to place focus back to the element focused before the dialog opened. */
+    /** Element that was focused before the dialog was opened. Save this to restore upon close. */
+    private _elementFocusedBeforeDialogWasOpened;
+    /**
+     * Type of interaction that led to the dialog being closed. This is used to determine
+     * whether the focus style will be applied when returning focus to its original location
+     * after the dialog is closed.
+     */
+    _closeInteractionType: FocusOrigin | null;
+    /** ID of the element that should be considered as the dialog's label. */
+    _ariaLabelledBy: string | null;
+    constructor(_elementRef: ElementRef, _focusTrapFactory: FocusTrapFactory, _document: any, _config: C, _interactivityChecker: InteractivityChecker, _ngZone: NgZone, _overlayRef: OverlayRef, _focusMonitor?: FocusMonitor | undefined);
+    ngAfterViewInit(): void;
+    /**
+     * Can be used by child classes to customize the initial focus
+     * capturing behavior (e.g. if it's tied to an animation).
+     */
+    protected _captureInitialFocus(): void;
     ngOnDestroy(): void;
     /**
      * Attach a ComponentPortal as content to this dialog container.
@@ -60,7 +56,7 @@ export declare class CdkDialogContainer extends BasePortalOutlet implements OnDe
      * Attach a TemplatePortal as content to this dialog container.
      * @param portal Portal to be attached as the dialog content.
      */
-    attachTemplatePortal<C>(portal: TemplatePortal<C>): EmbeddedViewRef<C>;
+    attachTemplatePortal<T>(portal: TemplatePortal<T>): EmbeddedViewRef<T>;
     /**
      * Attaches a DOM portal to the dialog container.
      * @param portal Portal to be attached.
@@ -68,14 +64,6 @@ export declare class CdkDialogContainer extends BasePortalOutlet implements OnDe
      * @breaking-change 10.0.0
      */
     attachDomPortal: (portal: DomPortal) => void;
-    /** Emit lifecycle events based on animation `start` callback. */
-    _onAnimationStart(event: AnimationEvent): void;
-    /** Starts the dialog exit animation. */
-    _startExiting(): void;
-    /** Saves a reference to the element that was focused before the dialog was opened. */
-    private _savePreviouslyFocusedElement;
-    /** Focuses the dialog container. */
-    private _focusDialogContainer;
     /**
      * 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.
@@ -88,12 +76,20 @@ export declare class CdkDialogContainer extends BasePortalOutlet implements OnDe
      */
     private _focusByCssSelector;
     /**
-     * Autofocus the element specified by the autoFocus field. When autoFocus is not 'dialog', if
-     * for some reason the element cannot be focused, the dialog container will be focused.
+     * Moves the focus inside the focus trap. When autoFocus is not set to 'dialog', if focus
+     * cannot be moved then focus will go to the dialog container.
      */
-    private _autoFocus;
-    /** Returns the focus to the element focused before the dialog was open. */
-    private _returnFocusAfterDialog;
-    static ɵfac: i0.ɵɵFactoryDeclaration<CdkDialogContainer, [null, null, null, null, null, { optional: true; }, null]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CdkDialogContainer, "cdk-dialog-container", never, {}, {}, never, never>;
+    protected _trapFocus(): void;
+    /** Restores focus to the element that was focused before the dialog opened. */
+    private _restoreFocus;
+    /** Focuses the dialog container. */
+    private _focusDialogContainer;
+    /** Returns whether focus is inside the dialog. */
+    private _containsFocus;
+    /** Sets up the focus trap. */
+    private _initializeFocusTrap;
+    /** Sets up the listener that handles clicks on the dialog backdrop. */
+    private _handleBackdropClicks;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CdkDialogContainer<any>, [null, null, { optional: true; }, null, null, null, null, null]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CdkDialogContainer<any>, "cdk-dialog-container", never, {}, {}, never, never>;
 }

package/dialog/dialog-injectors.d.ts

@@ -6,25 +6,19 @@
  * found in the LICENSE file at https://angular.io/license
  */
 import { InjectionToken } from '@angular/core';
-import { ComponentType, Overlay, ScrollStrategy } from '@angular/cdk/overlay';
-import { DialogRef } from './dialog-ref';
-import { CdkDialogContainer } from './dialog-container';
+import { Overlay, ScrollStrategy } from '@angular/cdk/overlay';
 import { DialogConfig } from './dialog-config';
 /** Injection token for the Dialog's ScrollStrategy. */
 export declare const DIALOG_SCROLL_STRATEGY: InjectionToken<() => ScrollStrategy>;
 /** Injection token for the Dialog's Data. */
 export declare const DIALOG_DATA: InjectionToken<any>;
-/** Injection token for the DialogRef constructor. */
-export declare const DIALOG_REF: InjectionToken<DialogRef<any, any>>;
-/** Injection token for the DialogConfig. */
-export declare const DIALOG_CONFIG: InjectionToken<DialogConfig<any>>;
-/** Injection token for the Dialog's DialogContainer component. */
-export declare const DIALOG_CONTAINER: InjectionToken<ComponentType<CdkDialogContainer>>;
+/** Injection token that can be used to provide default options for the dialog module. */
+export declare const DEFAULT_DIALOG_CONFIG: InjectionToken<DialogConfig<unknown, unknown, import("@angular/cdk/portal").BasePortalOutlet>>;
 /** @docs-private */
-export declare function MAT_DIALOG_SCROLL_STRATEGY_PROVIDER_FACTORY(overlay: Overlay): () => ScrollStrategy;
+export declare function DIALOG_SCROLL_STRATEGY_PROVIDER_FACTORY(overlay: Overlay): () => ScrollStrategy;
 /** @docs-private */
-export declare const MAT_DIALOG_SCROLL_STRATEGY_PROVIDER: {
+export declare const DIALOG_SCROLL_STRATEGY_PROVIDER: {
     provide: InjectionToken<() => ScrollStrategy>;
     deps: (typeof Overlay)[];
-    useFactory: typeof MAT_DIALOG_SCROLL_STRATEGY_PROVIDER_FACTORY;
+    useFactory: typeof DIALOG_SCROLL_STRATEGY_PROVIDER_FACTORY;
 };

package/dialog/dialog-ref.d.ts

@@ -5,53 +5,60 @@
  * 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
  */
-import { OverlayRef, OverlaySizeConfig } from '@angular/cdk/overlay';
+import { OverlayRef } from '@angular/cdk/overlay';
 import { Observable } from 'rxjs';
-import { DialogPosition } from './dialog-config';
-import { CdkDialogContainer } from './dialog-container';
+import { DialogConfig } from './dialog-config';
+import { FocusOrigin } from '@angular/cdk/a11y';
+import { BasePortalOutlet } from '@angular/cdk/portal';
+/** Additional options that can be passed in when closing a dialog. */
+export interface DialogCloseOptions {
+    /** Focus original to use when restoring focus. */
+    focusOrigin?: FocusOrigin;
+}
 /**
  * Reference to a dialog opened via the Dialog service.
  */
-export declare class DialogRef<T, R = any> {
-    _overlayRef: OverlayRef;
-    protected _containerInstance: CdkDialogContainer;
-    readonly id: string;
-    /** The instance of the component in the dialog. */
-    componentInstance: T;
+export declare class DialogRef<R = unknown, C = unknown> {
+    readonly overlayRef: OverlayRef;
+    readonly config: DialogConfig<any, DialogRef<R, C>, BasePortalOutlet>;
+    /**
+     * Instance of component opened into the dialog. Will be
+     * null when the dialog is opened using a `TemplateRef`.
+     */
+    componentInstance: C | null;
+    /** Instance of the container that is rendering out the dialog content. */
+    containerInstance: BasePortalOutlet & {
+        _closeInteractionType?: FocusOrigin;
+    };
     /** Whether the user is allowed to close the dialog. */
     disableClose: boolean | undefined;
-    /** Result to be passed to afterClosed. */
-    private _result;
-    constructor(_overlayRef: OverlayRef, _containerInstance: CdkDialogContainer, id?: string);
-    /** Gets an observable that emits when the overlay's backdrop has been clicked. */
-    backdropClick(): Observable<MouseEvent>;
+    /** Emits when the dialog has been closed. */
+    readonly closed: Observable<R | undefined>;
+    /** Emits when the backdrop of the dialog is clicked. */
+    readonly backdropClick: Observable<MouseEvent>;
+    /** Emits when on keyboard events within the dialog. */
+    readonly keydownEvents: Observable<KeyboardEvent>;
+    /** Emits on pointer events that happen outside of the dialog. */
+    readonly outsidePointerEvents: Observable<MouseEvent>;
+    /** Unique ID for the dialog. */
+    readonly id: string;
+    constructor(overlayRef: OverlayRef, config: DialogConfig<any, DialogRef<R, C>, BasePortalOutlet>);
     /**
      * Close the dialog.
-     * @param dialogResult Optional result to return to the dialog opener.
-     */
-    close(dialogResult?: R): void;
-    /**
-     * Updates the dialog's position.
-     * @param position New dialog position.
-     */
-    updatePosition(position?: DialogPosition): this;
-    /**
-     * Gets an observable that emits when keydown events are targeted on the overlay.
+     * @param result Optional result to return to the dialog opener.
+     * @param options Additional options to customize the closing behavior.
      */
-    keydownEvents(): Observable<KeyboardEvent>;
+    close(result?: R, options?: DialogCloseOptions): void;
+    /** Updates the dialog's position. */
+    updatePosition(): this;
     /**
-     * Updates the dialog's width and height, defined, min and max.
-     * @param size New size for the overlay.
+     * Updates the dialog's width and height.
+     * @param width New width of the dialog.
+     * @param height New height of the dialog.
      */
-    updateSize(size: OverlaySizeConfig): this;
-    /** Fetches the position strategy object from the overlay ref. */
-    private _getPositionStrategy;
-    /** Gets an observable that emits when dialog begins opening. */
-    beforeOpened(): Observable<void>;
-    /** Gets an observable that emits when dialog is finished opening. */
-    afterOpened(): Observable<void>;
-    /** Gets an observable that emits when dialog begins closing. */
-    beforeClosed(): Observable<R | undefined>;
-    /** Gets an observable that emits when dialog is finished closing. */
-    afterClosed(): Observable<R | undefined>;
+    updateSize(width?: string, height?: string): this;
+    /** Add a CSS class or an array of classes to the overlay pane. */
+    addPanelClass(classes: string | string[]): this;
+    /** Remove a CSS class or an array of classes from the overlay pane. */
+    removePanelClass(classes: string | string[]): this;
 }