@angular/material 14.0.0-next.12 → 14.0.0-next.13

package/menu/index.d.ts

@@ -1,8 +1,620 @@
+import { _AbstractConstructor } from '@angular/material/core';
+import { AfterContentInit } from '@angular/core';
+import { AfterViewInit } from '@angular/core';
+import { AnimationEvent as AnimationEvent_2 } from '@angular/animations';
+import { AnimationTriggerMetadata } from '@angular/animations';
+import { ApplicationRef } from '@angular/core';
+import { BooleanInput } from '@angular/cdk/coercion';
+import { CanDisable } from '@angular/material/core';
+import { CanDisableRipple } from '@angular/material/core';
+import { ChangeDetectorRef } from '@angular/core';
+import { ComponentFactoryResolver } from '@angular/core';
+import { _Constructor } from '@angular/material/core';
+import { Direction } from '@angular/cdk/bidi';
+import { Directionality } from '@angular/cdk/bidi';
+import { ElementRef } from '@angular/core';
+import { EventEmitter } 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 i5 from '@angular/common';
+import * as i6 from '@angular/material/core';
+import * as i7 from '@angular/cdk/overlay';
+import * as i8 from '@angular/cdk/scrolling';
+import { InjectionToken } from '@angular/core';
+import { Injector } from '@angular/core';
+import { NgZone } from '@angular/core';
+import { Observable } from 'rxjs';
+import { OnDestroy } from '@angular/core';
+import { OnInit } from '@angular/core';
+import { Overlay } from '@angular/cdk/overlay';
+import { QueryList } from '@angular/core';
+import { ScrollStrategy } from '@angular/cdk/overlay';
+import { Subject } from 'rxjs';
+import { TemplateRef } from '@angular/core';
+import { ViewContainerRef } 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
+ * @deprecated
+ * @breaking-change 8.0.0
+ * @docs-private
  */
-export * from './public-api';
+export declare const fadeInItems: AnimationTriggerMetadata;
+
+declare namespace i1 {
+    export {
+        MAT_MENU_DEFAULT_OPTIONS_FACTORY,
+        MatMenuDefaultOptions,
+        MAT_MENU_DEFAULT_OPTIONS,
+        MenuCloseReason,
+        _MatMenuBase,
+        MatMenu
+    }
+}
+
+declare namespace i2 {
+    export {
+        MatMenuItem
+    }
+}
+
+declare namespace i3 {
+    export {
+        MAT_MENU_SCROLL_STRATEGY_FACTORY,
+        MAT_MENU_SCROLL_STRATEGY,
+        MAT_MENU_SCROLL_STRATEGY_FACTORY_PROVIDER,
+        MENU_PANEL_TOP_PADDING,
+        _MatMenuTriggerBase,
+        MatMenuTrigger
+    }
+}
+
+declare namespace i4 {
+    export {
+        MAT_MENU_CONTENT,
+        _MatMenuContentBase,
+        MatMenuContent
+    }
+}
+
+/**
+ * Injection token that can be used to reference instances of `MatMenuContent`. It serves
+ * as alternative token to the actual `MatMenuContent` class which could cause unnecessary
+ * retention of the class and its directive metadata.
+ */
+export declare const MAT_MENU_CONTENT: InjectionToken<MatMenuContent>;
+
+/** Injection token to be used to override the default options for `mat-menu`. */
+export declare const MAT_MENU_DEFAULT_OPTIONS: InjectionToken<MatMenuDefaultOptions>;
+
+/** @docs-private */
+declare function MAT_MENU_DEFAULT_OPTIONS_FACTORY(): MatMenuDefaultOptions;
+
+/**
+ * Injection token used to provide the parent menu to menu-specific components.
+ * @docs-private
+ */
+export declare const MAT_MENU_PANEL: InjectionToken<MatMenuPanel<any>>;
+
+/** Injection token that determines the scroll handling while the menu is open. */
+export declare const MAT_MENU_SCROLL_STRATEGY: InjectionToken<() => ScrollStrategy>;
+
+/** @docs-private */
+declare function MAT_MENU_SCROLL_STRATEGY_FACTORY(overlay: Overlay): () => ScrollStrategy;
+
+/** @docs-private */
+declare const MAT_MENU_SCROLL_STRATEGY_FACTORY_PROVIDER: {
+    provide: InjectionToken<() => ScrollStrategy>;
+    deps: (typeof Overlay)[];
+    useFactory: typeof MAT_MENU_SCROLL_STRATEGY_FACTORY;
+};
+
+/** @docs-public MatMenu */
+export declare class MatMenu extends _MatMenuBase {
+    protected _elevationPrefix: string;
+    protected _baseElevation: number;
+    /**
+     * @deprecated `changeDetectorRef` parameter will become a required parameter.
+     * @breaking-change 15.0.0
+     */
+    constructor(elementRef: ElementRef<HTMLElement>, ngZone: NgZone, defaultOptions: MatMenuDefaultOptions);
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatMenu, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatMenu, "mat-menu", ["matMenu"], {}, {}, never, ["*"], false>;
+}
+
+/**
+ * Animations used by the mat-menu component.
+ * Animation duration and timing values are based on:
+ * https://material.io/guidelines/components/menus.html#menus-usage
+ * @docs-private
+ */
+export declare const matMenuAnimations: {
+    readonly transformMenu: AnimationTriggerMetadata;
+    readonly fadeInItems: AnimationTriggerMetadata;
+};
+
+/** Base class with all of the `MatMenu` functionality. */
+export declare class _MatMenuBase implements AfterContentInit, MatMenuPanel<MatMenuItem>, OnInit, OnDestroy {
+    private _elementRef;
+    private _ngZone;
+    private _defaultOptions;
+    private _changeDetectorRef?;
+    private _keyManager;
+    private _xPosition;
+    private _yPosition;
+    private _previousElevation;
+    protected _elevationPrefix: string;
+    protected _baseElevation: number;
+    /** All items inside the menu. Includes items nested inside another menu. */
+    _allItems: QueryList<MatMenuItem>;
+    /** Only the direct descendant menu items. */
+    _directDescendantItems: QueryList<MatMenuItem>;
+    /** Subscription to tab events on the menu panel */
+    private _tabSubscription;
+    /** Config object to be passed into the menu's ngClass */
+    _classList: {
+        [key: string]: boolean;
+    };
+    /** Current state of the panel animation. */
+    _panelAnimationState: 'void' | 'enter';
+    /** Emits whenever an animation on the menu completes. */
+    readonly _animationDone: Subject<AnimationEvent_2>;
+    /** Whether the menu is animating. */
+    _isAnimating: boolean;
+    /** Parent menu of the current menu panel. */
+    parentMenu: MatMenuPanel | undefined;
+    /** Layout direction of the menu. */
+    direction: Direction;
+    /** Class or list of classes to be added to the overlay panel. */
+    overlayPanelClass: string | string[];
+    /** Class to be added to the backdrop element. */
+    backdropClass: string;
+    /** aria-label for the menu panel. */
+    ariaLabel: string;
+    /** aria-labelledby for the menu panel. */
+    ariaLabelledby: string;
+    /** aria-describedby for the menu panel. */
+    ariaDescribedby: string;
+    /** Position of the menu in the X axis. */
+    get xPosition(): MenuPositionX;
+    set xPosition(value: MenuPositionX);
+    /** Position of the menu in the Y axis. */
+    get yPosition(): MenuPositionY;
+    set yPosition(value: MenuPositionY);
+    /** @docs-private */
+    templateRef: TemplateRef<any>;
+    /**
+     * List of the items inside of a menu.
+     * @deprecated
+     * @breaking-change 8.0.0
+     */
+    items: QueryList<MatMenuItem>;
+    /**
+     * Menu content that will be rendered lazily.
+     * @docs-private
+     */
+    lazyContent: MatMenuContent;
+    /** Whether the menu should overlap its trigger. */
+    get overlapTrigger(): boolean;
+    set overlapTrigger(value: BooleanInput);
+    private _overlapTrigger;
+    /** Whether the menu has a backdrop. */
+    get hasBackdrop(): boolean | undefined;
+    set hasBackdrop(value: BooleanInput);
+    private _hasBackdrop;
+    /**
+     * This method takes classes set on the host mat-menu element and applies them on the
+     * menu template that displays in the overlay container.  Otherwise, it's difficult
+     * to style the containing menu from outside the component.
+     * @param classes list of class names
+     */
+    set panelClass(classes: string);
+    private _previousPanelClass;
+    /**
+     * This method takes classes set on the host mat-menu element and applies them on the
+     * menu template that displays in the overlay container.  Otherwise, it's difficult
+     * to style the containing menu from outside the component.
+     * @deprecated Use `panelClass` instead.
+     * @breaking-change 8.0.0
+     */
+    get classList(): string;
+    set classList(classes: string);
+    /** Event emitted when the menu is closed. */
+    readonly closed: EventEmitter<MenuCloseReason>;
+    /**
+     * Event emitted when the menu is closed.
+     * @deprecated Switch to `closed` instead
+     * @breaking-change 8.0.0
+     */
+    readonly close: EventEmitter<MenuCloseReason>;
+    readonly panelId: string;
+    constructor(elementRef: ElementRef<HTMLElement>, ngZone: NgZone, defaultOptions: MatMenuDefaultOptions, changeDetectorRef: ChangeDetectorRef);
+    /**
+     * @deprecated `_changeDetectorRef` to become a required parameter.
+     * @breaking-change 15.0.0
+     */
+    constructor(elementRef: ElementRef<HTMLElement>, ngZone: NgZone, defaultOptions: MatMenuDefaultOptions, changeDetectorRef?: ChangeDetectorRef);
+    ngOnInit(): void;
+    ngAfterContentInit(): void;
+    ngOnDestroy(): void;
+    /** Stream that emits whenever the hovered menu item changes. */
+    _hovered(): Observable<MatMenuItem>;
+    addItem(_item: MatMenuItem): void;
+    /**
+     * Removes an item from the menu.
+     * @docs-private
+     * @deprecated No longer being used. To be removed.
+     * @breaking-change 9.0.0
+     */
+    removeItem(_item: MatMenuItem): void;
+    /** Handle a keyboard event from the menu, delegating to the appropriate action. */
+    _handleKeydown(event: KeyboardEvent): void;
+    /**
+     * Focus the first item in the menu.
+     * @param origin Action from which the focus originated. Used to set the correct styling.
+     */
+    focusFirstItem(origin?: FocusOrigin): void;
+    /**
+     * Actual implementation that focuses the first item. Needs to be separated
+     * out so we don't repeat the same logic in the public `focusFirstItem` method.
+     */
+    private _focusFirstItem;
+    /**
+     * Resets the active item in the menu. This is used when the menu is opened, allowing
+     * the user to start from the first option when pressing the down arrow.
+     */
+    resetActiveItem(): void;
+    /**
+     * Sets the menu panel elevation.
+     * @param depth Number of parent menus that come before the menu.
+     */
+    setElevation(depth: number): void;
+    /**
+     * Adds classes to the menu panel based on its position. Can be used by
+     * consumers to add specific styling based on the position.
+     * @param posX Position of the menu along the x axis.
+     * @param posY Position of the menu along the y axis.
+     * @docs-private
+     */
+    setPositionClasses(posX?: MenuPositionX, posY?: MenuPositionY): void;
+    /** Starts the enter animation. */
+    _startAnimation(): void;
+    /** Resets the panel animation to its initial state. */
+    _resetAnimation(): void;
+    /** Callback that is invoked when the panel animation completes. */
+    _onAnimationDone(event: AnimationEvent_2): void;
+    _onAnimationStart(event: AnimationEvent_2): void;
+    /**
+     * Sets up a stream that will keep track of any newly-added menu items and will update the list
+     * of direct descendants. We collect the descendants this way, because `_allItems` can include
+     * items that are part of child menus, and using a custom way of registering items is unreliable
+     * when it comes to maintaining the item order.
+     */
+    private _updateDirectDescendants;
+    static ɵfac: i0.ɵɵFactoryDeclaration<_MatMenuBase, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<_MatMenuBase, never, never, { "backdropClass": "backdropClass"; "ariaLabel": "aria-label"; "ariaLabelledby": "aria-labelledby"; "ariaDescribedby": "aria-describedby"; "xPosition": "xPosition"; "yPosition": "yPosition"; "overlapTrigger": "overlapTrigger"; "hasBackdrop": "hasBackdrop"; "panelClass": "class"; "classList": "classList"; }, { "closed": "closed"; "close": "close"; }, ["lazyContent", "_allItems", "items"], never, false>;
+}
+
+/**
+ * Menu content that will be rendered lazily once the menu is opened.
+ */
+export declare class MatMenuContent extends _MatMenuContentBase {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatMenuContent, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatMenuContent, "ng-template[matMenuContent]", never, {}, {}, never, never, false>;
+}
+
+export declare abstract class _MatMenuContentBase implements OnDestroy {
+    private _template;
+    private _componentFactoryResolver;
+    private _appRef;
+    private _injector;
+    private _viewContainerRef;
+    private _document;
+    private _changeDetectorRef?;
+    private _portal;
+    private _outlet;
+    /** Emits when the menu content has been attached. */
+    readonly _attached: Subject<void>;
+    constructor(template: TemplateRef<any>, componentFactoryResolver: ComponentFactoryResolver, appRef: ApplicationRef, injector: Injector, viewContainerRef: ViewContainerRef, document: any, changeDetectorRef: ChangeDetectorRef);
+    /**
+     * @deprecated `changeDetectorRef` is now a required parameter.
+     * @breaking-change 9.0.0
+     */
+    constructor(template: TemplateRef<any>, componentFactoryResolver: ComponentFactoryResolver, appRef: ApplicationRef, injector: Injector, viewContainerRef: ViewContainerRef, document: any, changeDetectorRef?: ChangeDetectorRef);
+    /**
+     * Attaches the content with a particular context.
+     * @docs-private
+     */
+    attach(context?: any): void;
+    /**
+     * Detaches the content.
+     * @docs-private
+     */
+    detach(): void;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<_MatMenuContentBase, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<_MatMenuContentBase, never, never, {}, {}, never, never, false>;
+}
+
+/** Default `mat-menu` options that can be overridden. */
+export declare interface MatMenuDefaultOptions {
+    /** The x-axis position of the menu. */
+    xPosition: MenuPositionX;
+    /** The y-axis position of the menu. */
+    yPosition: MenuPositionY;
+    /** Whether the menu should overlap the menu trigger. */
+    overlapTrigger: boolean;
+    /** Class to be applied to the menu's backdrop. */
+    backdropClass: string;
+    /** Class or list of classes to be applied to the menu's overlay panel. */
+    overlayPanelClass?: string | string[];
+    /** Whether the menu has a backdrop. */
+    hasBackdrop?: boolean;
+}
+
+/**
+ * Single item inside of a `mat-menu`. Provides the menu item styling and accessibility treatment.
+ */
+export declare class MatMenuItem extends _MatMenuItemBase implements FocusableOption, CanDisable, CanDisableRipple, AfterViewInit, OnDestroy {
+    private _elementRef;
+    private _document?;
+    private _focusMonitor?;
+    _parentMenu?: MatMenuPanel<MatMenuItem> | undefined;
+    private _changeDetectorRef?;
+    /** ARIA role for the menu item. */
+    role: 'menuitem' | 'menuitemradio' | 'menuitemcheckbox';
+    /** Stream that emits when the menu item is hovered. */
+    readonly _hovered: Subject<MatMenuItem>;
+    /** Stream that emits when the menu item is focused. */
+    readonly _focused: Subject<MatMenuItem>;
+    /** Whether the menu item is highlighted. */
+    _highlighted: boolean;
+    /** Whether the menu item acts as a trigger for a sub-menu. */
+    _triggersSubmenu: boolean;
+    constructor(elementRef: ElementRef<HTMLElement>, document: any, focusMonitor: FocusMonitor, parentMenu: MatMenuPanel<MatMenuItem> | undefined, changeDetectorRef: ChangeDetectorRef);
+    /**
+     * @deprecated `document`, `changeDetectorRef` and `focusMonitor` to become required.
+     * @breaking-change 12.0.0
+     */
+    constructor(elementRef: ElementRef<HTMLElement>, document?: any, focusMonitor?: FocusMonitor, parentMenu?: MatMenuPanel<MatMenuItem>, changeDetectorRef?: ChangeDetectorRef);
+    /** Focuses the menu item. */
+    focus(origin?: FocusOrigin, options?: FocusOptions): void;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    /** Used to set the `tabindex`. */
+    _getTabIndex(): string;
+    /** Returns the host DOM element. */
+    _getHostElement(): HTMLElement;
+    /** Prevents the default element actions if it is disabled. */
+    _checkDisabled(event: Event): void;
+    /** Emits to the hover stream. */
+    _handleMouseEnter(): void;
+    /** Gets the label to be used when determining whether the option should be focused. */
+    getLabel(): string;
+    _setHighlighted(isHighlighted: boolean): void;
+    _hasFocus(): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatMenuItem, [null, null, null, { optional: true; }, null]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatMenuItem, "[mat-menu-item]", ["matMenuItem"], { "disabled": "disabled"; "disableRipple": "disableRipple"; "role": "role"; }, {}, never, ["*"], false>;
+}
+
+/** @docs-private */
+declare const _MatMenuItemBase: _Constructor<CanDisableRipple> & _AbstractConstructor<CanDisableRipple> & _Constructor<CanDisable> & _AbstractConstructor<CanDisable> & {
+    new (): {};
+};
+
+export declare class MatMenuModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatMenuModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatMenuModule, [typeof i1.MatMenu, typeof i2.MatMenuItem, typeof i3.MatMenuTrigger, typeof i4.MatMenuContent], [typeof i5.CommonModule, typeof i6.MatCommonModule, typeof i6.MatRippleModule, typeof i7.OverlayModule], [typeof i8.CdkScrollableModule, typeof i6.MatCommonModule, typeof i1.MatMenu, typeof i2.MatMenuItem, typeof i3.MatMenuTrigger, typeof i4.MatMenuContent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatMenuModule>;
+}
+
+/**
+ * Interface for a custom menu panel that can be used with `matMenuTriggerFor`.
+ * @docs-private
+ */
+export declare interface MatMenuPanel<T = any> {
+    xPosition: MenuPositionX;
+    yPosition: MenuPositionY;
+    overlapTrigger: boolean;
+    templateRef: TemplateRef<any>;
+    readonly close: EventEmitter<void | 'click' | 'keydown' | 'tab'>;
+    parentMenu?: MatMenuPanel | undefined;
+    direction?: Direction;
+    focusFirstItem: (origin?: FocusOrigin) => void;
+    resetActiveItem: () => void;
+    setPositionClasses?: (x: MenuPositionX, y: MenuPositionY) => void;
+    setElevation?(depth: number): void;
+    lazyContent?: MatMenuContent;
+    backdropClass?: string;
+    overlayPanelClass?: string | string[];
+    hasBackdrop?: boolean;
+    readonly panelId?: string;
+    /**
+     * @deprecated To be removed.
+     * @breaking-change 8.0.0
+     */
+    addItem?: (item: T) => void;
+    /**
+     * @deprecated To be removed.
+     * @breaking-change 8.0.0
+     */
+    removeItem?: (item: T) => void;
+}
+
+/** Directive applied to an element that should trigger a `mat-menu`. */
+export declare class MatMenuTrigger extends _MatMenuTriggerBase {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatMenuTrigger, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatMenuTrigger, "[mat-menu-trigger-for], [matMenuTriggerFor]", ["matMenuTrigger"], {}, {}, never, never, false>;
+}
+
+export declare abstract class _MatMenuTriggerBase implements AfterContentInit, OnDestroy {
+    private _overlay;
+    private _element;
+    private _viewContainerRef;
+    private _menuItemInstance;
+    private _dir;
+    private _focusMonitor;
+    private _ngZone?;
+    private _portal;
+    private _overlayRef;
+    private _menuOpen;
+    private _closingActionsSubscription;
+    private _hoverSubscription;
+    private _menuCloseSubscription;
+    private _scrollStrategy;
+    /**
+     * We're specifically looking for a `MatMenu` here since the generic `MatMenuPanel`
+     * interface lacks some functionality around nested menus and animations.
+     */
+    private _parentMaterialMenu;
+    /**
+     * Cached value of the padding of the parent menu panel.
+     * Used to offset sub-menus to compensate for the padding.
+     */
+    private _parentInnerPadding;
+    /**
+     * Handles touch start events on the trigger.
+     * Needs to be an arrow function so we can easily use addEventListener and removeEventListener.
+     */
+    private _handleTouchStart;
+    _openedBy: Exclude<FocusOrigin, 'program' | null> | undefined;
+    /**
+     * @deprecated
+     * @breaking-change 8.0.0
+     */
+    get _deprecatedMatMenuTriggerFor(): MatMenuPanel | null;
+    set _deprecatedMatMenuTriggerFor(v: MatMenuPanel | null);
+    /** References the menu instance that the trigger is associated with. */
+    get menu(): MatMenuPanel | null;
+    set menu(menu: MatMenuPanel | null);
+    private _menu;
+    /** Data to be passed along to any lazily-rendered content. */
+    menuData: any;
+    /**
+     * Whether focus should be restored when the menu is closed.
+     * Note that disabling this option can have accessibility implications
+     * and it's up to you to manage focus, if you decide to turn it off.
+     */
+    restoreFocus: boolean;
+    /** Event emitted when the associated menu is opened. */
+    readonly menuOpened: EventEmitter<void>;
+    /**
+     * Event emitted when the associated menu is opened.
+     * @deprecated Switch to `menuOpened` instead
+     * @breaking-change 8.0.0
+     */
+    readonly onMenuOpen: EventEmitter<void>;
+    /** Event emitted when the associated menu is closed. */
+    readonly menuClosed: EventEmitter<void>;
+    /**
+     * Event emitted when the associated menu is closed.
+     * @deprecated Switch to `menuClosed` instead
+     * @breaking-change 8.0.0
+     */
+    readonly onMenuClose: EventEmitter<void>;
+    constructor(overlay: Overlay, element: ElementRef<HTMLElement>, viewContainerRef: ViewContainerRef, scrollStrategy: any, parentMenu: MatMenuPanel, menuItemInstance: MatMenuItem, dir: Directionality, focusMonitor: FocusMonitor, ngZone: NgZone);
+    /**
+     * @deprecated `focusMonitor` will become a required parameter.
+     * @breaking-change 8.0.0
+     */
+    constructor(overlay: Overlay, element: ElementRef<HTMLElement>, viewContainerRef: ViewContainerRef, scrollStrategy: any, parentMenu: MatMenuPanel, menuItemInstance: MatMenuItem, dir: Directionality, focusMonitor?: FocusMonitor | null);
+    /**
+     * @deprecated `ngZone` will become a required parameter.
+     * @breaking-change 15.0.0
+     */
+    constructor(overlay: Overlay, element: ElementRef<HTMLElement>, viewContainerRef: ViewContainerRef, scrollStrategy: any, parentMenu: MatMenuPanel, menuItemInstance: MatMenuItem, dir: Directionality, focusMonitor: FocusMonitor);
+    ngAfterContentInit(): void;
+    ngOnDestroy(): void;
+    /** Whether the menu is open. */
+    get menuOpen(): boolean;
+    /** The text direction of the containing app. */
+    get dir(): Direction;
+    /** Whether the menu triggers a sub-menu or a top-level one. */
+    triggersSubmenu(): boolean;
+    /** Toggles the menu between the open and closed states. */
+    toggleMenu(): void;
+    /** Opens the menu. */
+    openMenu(): void;
+    /** Closes the menu. */
+    closeMenu(): void;
+    /**
+     * Focuses the menu trigger.
+     * @param origin Source of the menu trigger's focus.
+     */
+    focus(origin?: FocusOrigin, options?: FocusOptions): void;
+    /**
+     * Updates the position of the menu to ensure that it fits all options within the viewport.
+     */
+    updatePosition(): void;
+    /** Closes the menu and does the necessary cleanup. */
+    private _destroyMenu;
+    /**
+     * This method sets the menu state to open and focuses the first item if
+     * the menu was opened via the keyboard.
+     */
+    private _initMenu;
+    /** Updates the menu elevation based on the amount of parent menus that it has. */
+    private _setMenuElevation;
+    private _setIsMenuOpen;
+    /**
+     * This method creates the overlay from the provided menu's template and saves its
+     * OverlayRef so that it can be attached to the DOM when openMenu is called.
+     */
+    private _createOverlay;
+    /**
+     * This method builds the configuration object needed to create the overlay, the OverlayState.
+     * @returns OverlayConfig
+     */
+    private _getOverlayConfig;
+    /**
+     * Listens to changes in the position of the overlay and sets the correct classes
+     * on the menu based on the new position. This ensures the animation origin is always
+     * correct, even if a fallback position is used for the overlay.
+     */
+    private _subscribeToPositions;
+    /**
+     * Sets the appropriate positions on a position strategy
+     * so the overlay connects with the trigger correctly.
+     * @param positionStrategy Strategy whose position to update.
+     */
+    private _setPosition;
+    /** Returns a stream that emits whenever an action that should close the menu occurs. */
+    private _menuClosingActions;
+    /** Handles mouse presses on the trigger. */
+    _handleMousedown(event: MouseEvent): void;
+    /** Handles key presses on the trigger. */
+    _handleKeydown(event: KeyboardEvent): void;
+    /** Handles click events on the trigger. */
+    _handleClick(event: MouseEvent): void;
+    /** Handles the cases where the user hovers over the trigger. */
+    private _handleHover;
+    /** Gets the portal that should be attached to the overlay. */
+    private _getPortal;
+    static ɵfac: i0.ɵɵFactoryDeclaration<_MatMenuTriggerBase, [null, null, null, null, { optional: true; }, { optional: true; self: true; }, { optional: true; }, null, null]>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<_MatMenuTriggerBase, never, never, { "_deprecatedMatMenuTriggerFor": "mat-menu-trigger-for"; "menu": "matMenuTriggerFor"; "menuData": "matMenuTriggerData"; "restoreFocus": "matMenuTriggerRestoreFocus"; }, { "menuOpened": "menuOpened"; "onMenuOpen": "onMenuOpen"; "menuClosed": "menuClosed"; "onMenuClose": "onMenuClose"; }, never, never, false>;
+}
+
+/**
+ * Default top padding of the menu panel.
+ * @deprecated No longer being used. Will be removed.
+ * @breaking-change 15.0.0
+ */
+declare const MENU_PANEL_TOP_PADDING = 8;
+
+/** Reason why the menu was closed. */
+declare type MenuCloseReason = void | 'click' | 'keydown' | 'tab';
+
+
+export declare type MenuPositionX = 'before' | 'after';
+
+export declare type MenuPositionY = 'above' | 'below';
+
+/**
+ * @deprecated
+ * @breaking-change 8.0.0
+ * @docs-private
+ */
+export declare const transformMenu: AnimationTriggerMetadata;
+
+export { }