@angular/material-experimental 14.2.1 → 15.0.0-next.0

package/mdc-list/index.d.ts

@@ -1,534 +0,0 @@
-import { AfterViewInit } from '@angular/core';
-import { BooleanInput } from '@angular/cdk/coercion';
-import { ChangeDetectorRef } from '@angular/core';
-import { ControlValueAccessor } from '@angular/forms';
-import { ElementRef } from '@angular/core';
-import { EventEmitter } from '@angular/core';
-import * as i0 from '@angular/core';
-import * as i10 from '@angular/material-experimental/mdc-core';
-import * as i11 from '@angular/material/divider';
-import * as i8 from '@angular/cdk/observers';
-import * as i9 from '@angular/common';
-import { InjectionToken } from '@angular/core';
-import { MAT_LIST } from '@angular/material/list';
-import { MAT_NAV_LIST } from '@angular/material/list';
-import { MAT_SELECTION_LIST_VALUE_ACCESSOR } from '@angular/material/list';
-import { NgZone } from '@angular/core';
-import { OnChanges } from '@angular/core';
-import { OnDestroy } from '@angular/core';
-import { OnInit } from '@angular/core';
-import { Platform } from '@angular/cdk/platform';
-import { QueryList } from '@angular/core';
-import { RippleConfig } from '@angular/material-experimental/mdc-core';
-import { RippleGlobalOptions } from '@angular/material-experimental/mdc-core';
-import { RippleTarget } from '@angular/material-experimental/mdc-core';
-import { SelectionModel } from '@angular/cdk/collections';
-import { SimpleChanges } from '@angular/core';
-import { ThemePalette } from '@angular/material-experimental/mdc-core';
-
-declare namespace i1 {
-    export {
-        MatList,
-        MatListItem
-    }
-}
-
-declare namespace i2 {
-    export {
-        MatActionList
-    }
-}
-
-declare namespace i3 {
-    export {
-        MatNavList
-    }
-}
-
-declare namespace i4 {
-    export {
-        MatSelectionListChange,
-        MatSelectionList
-    }
-}
-
-declare namespace i5 {
-    export {
-        SELECTION_LIST,
-        SelectionList,
-        MatListOption
-    }
-}
-
-declare namespace i6 {
-    export {
-        MatListSubheaderCssMatStyler
-    }
-}
-
-declare namespace i7 {
-    export {
-        MatListItemTitle,
-        MatListItemLine,
-        MatListItemMeta,
-        _MatListItemGraphicBase,
-        MatListItemAvatar,
-        MatListItemIcon
-    }
-}
-
-/**
- * Interface describing a list option. This is used to avoid circular
- * dependencies between the list-option and the styler directives.
- * @docs-private
- */
-declare interface ListOption {
-    _getCheckboxPosition(): MatListOptionCheckboxPosition;
-}
-
-export { MAT_LIST }
-
-export { MAT_NAV_LIST }
-
-export { MAT_SELECTION_LIST_VALUE_ACCESSOR }
-
-export declare class MatActionList extends MatListBase {
-    _isNonInteractive: boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatActionList, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatActionList, "mat-action-list", ["matActionList"], {}, {}, never, ["*"], false>;
-}
-
-export declare class MatList extends MatListBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatList, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatList, "mat-list", ["matList"], {}, {}, never, ["*"], false>;
-}
-
-declare abstract class MatListBase {
-    _isNonInteractive: boolean;
-    /** Whether ripples for all list items is disabled. */
-    get disableRipple(): boolean;
-    set disableRipple(value: BooleanInput);
-    private _disableRipple;
-    /** Whether all list items are disabled. */
-    get disabled(): boolean;
-    set disabled(value: BooleanInput);
-    private _disabled;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatListBase, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatListBase, never, never, { "disableRipple": "disableRipple"; "disabled": "disabled"; }, {}, never, never, false>;
-}
-
-export declare class MatListItem extends MatListItemBase {
-    _lines: QueryList<MatListItemLine>;
-    _titles: QueryList<MatListItemTitle>;
-    _meta: QueryList<MatListItemMeta>;
-    _unscopedContent: ElementRef<HTMLSpanElement>;
-    _itemText: ElementRef<HTMLElement>;
-    /** Indicates whether an item in a `<mat-nav-list>` is the currently active page. */
-    get activated(): boolean;
-    set activated(activated: boolean);
-    _activated: boolean;
-    constructor(element: ElementRef, ngZone: NgZone, listBase: MatListBase, platform: Platform, globalRippleOptions?: RippleGlobalOptions, animationMode?: string);
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatListItem, [null, null, null, null, { optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatListItem, "mat-list-item, a[mat-list-item], button[mat-list-item]", ["matListItem"], { "activated": "activated"; }, {}, ["_lines", "_titles", "_meta"], ["[matListItemAvatar],[matListItemIcon]", "[matListItemTitle]", "[matListItemLine]", "*", "[matListItemMeta]", "mat-divider"], false>;
-}
-
-/**
- * Directive matching an optional avatar within a list item.
- *
- * List items can reserve space at the beginning of an item to display an avatar.
- */
-export declare class MatListItemAvatar extends _MatListItemGraphicBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatListItemAvatar, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatListItemAvatar, "[matListItemAvatar]", never, {}, {}, never, never, false>;
-}
-
-declare abstract class MatListItemBase implements AfterViewInit, OnDestroy, RippleTarget {
-    _elementRef: ElementRef<HTMLElement>;
-    protected _ngZone: NgZone;
-    private _listBase;
-    private _platform;
-    /** Query list matching list-item line elements. */
-    abstract _lines: QueryList<MatListItemLine> | undefined;
-    /** Query list matching list-item title elements. */
-    abstract _titles: QueryList<MatListItemTitle> | undefined;
-    /**
-     * Element reference to the unscoped content in a list item.
-     *
-     * Unscoped content is user-projected text content in a list item that is
-     * not part of an explicit line or title.
-     */
-    abstract _unscopedContent: ElementRef<HTMLSpanElement> | undefined;
-    /** Host element for the list item. */
-    _hostElement: HTMLElement;
-    /** Whether animations are disabled. */
-    _noopAnimations: boolean;
-    _avatars: QueryList<never>;
-    _icons: QueryList<never>;
-    /**
-     * The number of lines this list item should reserve space for. If not specified,
-     * lines are inferred based on the projected content.
-     *
-     * Explicitly specifying the number of lines is useful if you want to acquire additional
-     * space and enable the wrapping of text. The unscoped text content of a list item will
-     * always be able to take up the remaining space of the item, unless it represents the title.
-     *
-     * A maximum of three lines is supported as per the Material Design specification.
-     */
-    set lines(lines: number | string | null);
-    _explicitLines: number | null;
-    get disableRipple(): boolean;
-    set disableRipple(value: boolean);
-    private _disableRipple;
-    /** Whether the list-item is disabled. */
-    get disabled(): boolean;
-    set disabled(value: BooleanInput);
-    private _disabled;
-    private _subscriptions;
-    private _rippleRenderer;
-    /** Whether the list item has unscoped text content. */
-    _hasUnscopedTextContent: boolean;
-    /**
-     * Implemented as part of `RippleTarget`.
-     * @docs-private
-     */
-    rippleConfig: RippleConfig & RippleGlobalOptions;
-    /**
-     * Implemented as part of `RippleTarget`.
-     * @docs-private
-     */
-    get rippleDisabled(): boolean;
-    constructor(_elementRef: ElementRef<HTMLElement>, _ngZone: NgZone, _listBase: MatListBase, _platform: Platform, globalRippleOptions?: RippleGlobalOptions, animationMode?: string);
-    ngAfterViewInit(): void;
-    ngOnDestroy(): void;
-    /** Whether the list item has icons or avatars. */
-    _hasIconOrAvatar(): boolean;
-    private _initInteractiveListItem;
-    /**
-     * Subscribes to changes in the projected title and lines. Triggers a
-     * item lines update whenever a change occurs.
-     */
-    private _monitorProjectedLinesAndTitle;
-    /**
-     * Updates the lines of the list item. Based on the projected user content and optional
-     * explicit lines setting, the visual appearance of the list item is determined.
-     *
-     * This method should be invoked whenever the projected user content changes, or
-     * when the explicit lines have been updated.
-     *
-     * @param recheckUnscopedContent Whether the projected unscoped content should be re-checked.
-     *   The unscoped content is not re-checked for every update as it is a rather expensive check
-     *   for content that is expected to not change very often.
-     */
-    _updateItemLines(recheckUnscopedContent: boolean): void;
-    /**
-     * Infers the number of lines based on the projected user content. This is useful
-     * if no explicit number of lines has been specified on the list item.
-     *
-     * The number of lines is inferred based on whether there is a title, the number of
-     * additional lines (secondary/tertiary). An additional line is acquired if there is
-     * unscoped text content.
-     */
-    private _inferLinesFromContent;
-    /** Checks whether the list item has unscoped text content. */
-    private _checkDomForUnscopedTextContent;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatListItemBase, [null, null, null, null, { optional: true; }, { optional: true; }]>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatListItemBase, never, never, { "lines": "lines"; "disableRipple": "disableRipple"; "disabled": "disabled"; }, {}, ["_avatars", "_icons"], never, false>;
-}
-
-/**
- * @docs-private
- *
- * MDC uses the very intuitively named classes `.mdc-list-item__start` and `.mat-list-item__end`
- * to position content such as icons or checkboxes that comes either before or after the text
- * content respectively. This directive detects the placement of the checkbox and applies the
- * correct MDC class to position the icon/avatar on the opposite side.
- */
-export declare class _MatListItemGraphicBase {
-    _listOption: ListOption;
-    constructor(_listOption: ListOption);
-    _isAlignedAtStart(): boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<_MatListItemGraphicBase, [{ optional: true; }]>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<_MatListItemGraphicBase, never, never, {}, {}, never, never, false>;
-}
-
-/**
- * Directive matching an optional icon within a list item.
- *
- * List items can reserve space at the beginning of an item to display an icon.
- */
-export declare class MatListItemIcon extends _MatListItemGraphicBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatListItemIcon, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatListItemIcon, "[matListItemIcon]", never, {}, {}, never, never, false>;
-}
-
-/**
- * Directive capturing a line in a list item. A list item usually consists of a
- * title and optional secondary or tertiary lines.
- *
- * Text content inside a line never wraps. There can be at maximum two lines per list item.
- */
-export declare class MatListItemLine {
-    _elementRef: ElementRef<HTMLElement>;
-    constructor(_elementRef: ElementRef<HTMLElement>);
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatListItemLine, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatListItemLine, "[matListItemLine]", never, {}, {}, never, never, false>;
-}
-
-/**
- * Directive matching an optional meta section for list items.
- *
- * List items can reserve space at the end of an item to display a control,
- * button or additional text content.
- */
-export declare class MatListItemMeta {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatListItemMeta, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatListItemMeta, "[matListItemMeta]", never, {}, {}, never, never, false>;
-}
-
-/**
- * Directive capturing the title of a list item. A list item usually consists of a
- * title and optional secondary or tertiary lines.
- *
- * Text content for the title never wraps. There can only be a single title per list item.
- */
-export declare class MatListItemTitle {
-    _elementRef: ElementRef<HTMLElement>;
-    constructor(_elementRef: ElementRef<HTMLElement>);
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatListItemTitle, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatListItemTitle, "[matListItemTitle]", never, {}, {}, never, never, false>;
-}
-
-export declare class MatListModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatListModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<MatListModule, [typeof i1.MatList, typeof i2.MatActionList, typeof i3.MatNavList, typeof i4.MatSelectionList, typeof i1.MatListItem, typeof i5.MatListOption, typeof i6.MatListSubheaderCssMatStyler, typeof i7.MatListItemAvatar, typeof i7.MatListItemIcon, typeof i7.MatListItemLine, typeof i7.MatListItemTitle, typeof i7.MatListItemMeta], [typeof i8.ObserversModule, typeof i9.CommonModule, typeof i10.MatCommonModule, typeof i10.MatRippleModule, typeof i10.MatPseudoCheckboxModule], [typeof i1.MatList, typeof i2.MatActionList, typeof i3.MatNavList, typeof i4.MatSelectionList, typeof i1.MatListItem, typeof i5.MatListOption, typeof i7.MatListItemAvatar, typeof i7.MatListItemIcon, typeof i6.MatListSubheaderCssMatStyler, typeof i11.MatDividerModule, typeof i7.MatListItemLine, typeof i7.MatListItemTitle, typeof i7.MatListItemMeta]>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<MatListModule>;
-}
-
-export declare class MatListOption extends MatListItemBase implements ListOption, OnInit, OnDestroy {
-    private _selectionList;
-    private _changeDetectorRef;
-    _lines: QueryList<MatListItemLine>;
-    _titles: QueryList<MatListItemTitle>;
-    _unscopedContent: ElementRef<HTMLSpanElement>;
-    /**
-     * Emits when the selected state of the option has changed.
-     * Use to facilitate two-data binding to the `selected` property.
-     * @docs-private
-     */
-    readonly selectedChange: EventEmitter<boolean>;
-    /** Whether the label should appear before or after the checkbox. Defaults to 'after' */
-    checkboxPosition: MatListOptionCheckboxPosition;
-    /** Theme color of the list option. This sets the color of the checkbox. */
-    get color(): ThemePalette;
-    set color(newValue: ThemePalette);
-    private _color;
-    /** Value of the option */
-    get value(): any;
-    set value(newValue: any);
-    private _value;
-    /** Whether the option is selected. */
-    get selected(): boolean;
-    set selected(value: BooleanInput);
-    private _selected;
-    /**
-     * This is set to true after the first OnChanges cycle so we don't
-     * clear the value of `selected` in the first cycle.
-     */
-    private _inputsInitialized;
-    constructor(elementRef: ElementRef<HTMLElement>, ngZone: NgZone, _selectionList: SelectionList, platform: Platform, _changeDetectorRef: ChangeDetectorRef, globalRippleOptions?: RippleGlobalOptions, animationMode?: string);
-    ngOnInit(): void;
-    ngOnDestroy(): void;
-    /** Toggles the selection state of the option. */
-    toggle(): void;
-    /** Allows for programmatic focusing of the option. */
-    focus(): void;
-    /** Gets the text label of the list option. Used for the typeahead functionality in the list. */
-    getLabel(): string;
-    /** Whether a checkbox is shown at the given position. */
-    _hasCheckboxAt(position: MatListOptionCheckboxPosition): boolean;
-    /** Whether icons or avatars are shown at the given position. */
-    _hasIconsOrAvatarsAt(position: 'before' | 'after'): boolean;
-    /** Gets whether the given type of element is projected at the specified position. */
-    _hasProjected(type: 'icons' | 'avatars', position: 'before' | 'after'): boolean;
-    _handleBlur(): void;
-    /** Gets the current position of the checkbox. */
-    _getCheckboxPosition(): MatListOptionCheckboxPosition;
-    /**
-     * Sets the selected state of the option.
-     * @returns Whether the value has changed.
-     */
-    _setSelected(selected: boolean): boolean;
-    /**
-     * Notifies Angular that the option needs to be checked in the next change detection run.
-     * Mainly used to trigger an update of the list option if the disabled state of the selection
-     * list changed.
-     */
-    _markForCheck(): void;
-    /** Toggles the option's value based on a user interaction. */
-    _toggleOnInteraction(): void;
-    /** Sets the tabindex of the list option. */
-    _setTabindex(value: number): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatListOption, [null, null, null, null, null, { optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatListOption, "mat-list-option", ["matListOption"], { "checkboxPosition": "checkboxPosition"; "color": "color"; "value": "value"; "selected": "selected"; }, { "selectedChange": "selectedChange"; }, ["_lines", "_titles"], ["[matListItemAvatar],[matListItemIcon]", "[matListItemTitle]", "[matListItemLine]", "*", "mat-divider"], false>;
-}
-
-/**
- * Type describing possible positions of a checkbox in a list option
- * with respect to the list item's text.
- */
-export declare type MatListOptionCheckboxPosition = 'before' | 'after';
-
-/**
- * Directive whose purpose is to add the mat- CSS styling to this selector.
- * @docs-private
- */
-export declare class MatListSubheaderCssMatStyler {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatListSubheaderCssMatStyler, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatListSubheaderCssMatStyler, "[mat-subheader], [matSubheader]", never, {}, {}, never, never, false>;
-}
-
-export declare class MatNavList extends MatListBase {
-    _isNonInteractive: boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatNavList, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatNavList, "mat-nav-list", ["matNavList"], {}, {}, never, ["*"], false>;
-}
-
-export declare class MatSelectionList extends MatListBase implements SelectionList, ControlValueAccessor, AfterViewInit, OnChanges, OnDestroy {
-    _element: ElementRef<HTMLElement>;
-    private _ngZone;
-    private _initialized;
-    private _keyManager;
-    /** Emits when the list has been destroyed. */
-    private _destroyed;
-    /** Whether the list has been destroyed. */
-    private _isDestroyed;
-    /** View to model callback that should be called whenever the selected options change. */
-    private _onChange;
-    _items: QueryList<MatListOption>;
-    /** Emits a change event whenever the selected state of an option changes. */
-    readonly selectionChange: EventEmitter<MatSelectionListChange>;
-    /** Theme color of the selection list. This sets the checkbox color for all list options. */
-    color: ThemePalette;
-    /**
-     * Function used for comparing an option against the selected value when determining which
-     * options should appear as selected. The first argument is the value of an options. The second
-     * one is a value from the selected value. A boolean must be returned.
-     */
-    compareWith: (o1: any, o2: any) => boolean;
-    /** Whether selection is limited to one or multiple items (default multiple). */
-    get multiple(): boolean;
-    set multiple(value: BooleanInput);
-    private _multiple;
-    /** The currently selected options. */
-    selectedOptions: SelectionModel<MatListOption>;
-    /** Keeps track of the currently-selected value. */
-    _value: string[] | null;
-    /** View to model callback that should be called if the list or its options lost focus. */
-    _onTouched: () => void;
-    constructor(_element: ElementRef<HTMLElement>, _ngZone: NgZone);
-    ngAfterViewInit(): void;
-    ngOnChanges(changes: SimpleChanges): void;
-    ngOnDestroy(): void;
-    /** Focuses the selection list. */
-    focus(options?: FocusOptions): void;
-    /** Selects all of the options. Returns the options that changed as a result. */
-    selectAll(): MatListOption[];
-    /** Deselects all of the options. Returns the options that changed as a result. */
-    deselectAll(): MatListOption[];
-    /** Reports a value change to the ControlValueAccessor */
-    _reportValueChange(): void;
-    /** Emits a change event if the selected state of an option changed. */
-    _emitChangeEvent(options: MatListOption[]): void;
-    /** Implemented as part of ControlValueAccessor. */
-    writeValue(values: string[]): void;
-    /** Implemented as a part of ControlValueAccessor. */
-    setDisabledState(isDisabled: boolean): void;
-    /** Implemented as part of ControlValueAccessor. */
-    registerOnChange(fn: (value: any) => void): void;
-    /** Implemented as part of ControlValueAccessor. */
-    registerOnTouched(fn: () => void): void;
-    /** Watches for changes in the selected state of the options and updates the list accordingly. */
-    private _watchForSelectionChange;
-    /** Sets the selected options based on the specified values. */
-    private _setOptionsFromValues;
-    /** Returns the values of the selected options. */
-    private _getSelectedOptionValues;
-    /** Marks all the options to be checked in the next change detection run. */
-    private _markOptionsForCheck;
-    /**
-     * Sets the selected state on all of the options
-     * and emits an event if anything changed.
-     */
-    private _setAllOptionsSelected;
-    /** The option components contained within this selection-list. */
-    get options(): QueryList<MatListOption>;
-    /** Handles keydown events within the list. */
-    _handleKeydown(event: KeyboardEvent): void;
-    /** Handles focusout events within the list. */
-    private _handleFocusout;
-    /** Handles focusin events within the list. */
-    private _handleFocusin;
-    /** Sets up the logic for maintaining the roving tabindex. */
-    private _setupRovingTabindex;
-    /**
-     * Sets an option as active.
-     * @param index Index of the active option. If set to -1, no option will be active.
-     */
-    private _setActiveOption;
-    /** Resets the active option to the first selected option. */
-    private _resetActiveOption;
-    /** Returns whether the focus is currently within the list. */
-    private _containsFocus;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatSelectionList, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatSelectionList, "mat-selection-list", ["matSelectionList"], { "color": "color"; "compareWith": "compareWith"; "multiple": "multiple"; }, { "selectionChange": "selectionChange"; }, ["_items"], ["*"], false>;
-}
-
-/** Change event that is being fired whenever the selected state of an option changes. */
-export declare class MatSelectionListChange {
-    /** Reference to the selection list that emitted the event. */
-    source: MatSelectionList;
-    /**
-     * Reference to the option that has been changed.
-     * @deprecated Use `options` instead, because some events may change more than one option.
-     * @breaking-change 12.0.0
-     */
-    option: MatListOption;
-    /** Reference to the options that have been changed. */
-    options: MatListOption[];
-    constructor(
-    /** Reference to the selection list that emitted the event. */
-    source: MatSelectionList, 
-    /**
-     * Reference to the option that has been changed.
-     * @deprecated Use `options` instead, because some events may change more than one option.
-     * @breaking-change 12.0.0
-     */
-    option: MatListOption, 
-    /** Reference to the options that have been changed. */
-    options: MatListOption[]);
-}
-
-/**
- * Injection token that can be used to reference instances of an `SelectionList`. It serves
- * as alternative token to an actual implementation which would result in circular references.
- * @docs-private
- */
-export declare const SELECTION_LIST: InjectionToken<SelectionList>;
-
-/**
- * Interface describing the containing list of an list option. This is used to avoid
- * circular dependencies between the list-option and the selection list.
- * @docs-private
- */
-export declare interface SelectionList extends MatListBase {
-    multiple: boolean;
-    color: ThemePalette;
-    selectedOptions: SelectionModel<MatListOption>;
-    compareWith: (o1: any, o2: any) => boolean;
-    _value: string[] | null;
-    _reportValueChange(): void;
-    _emitChangeEvent(options: MatListOption[]): void;
-    _onTouched(): void;
-}
-
-export { }