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

package/chips/index.d.ts

@@ -1,139 +1,113 @@
-import { AfterContentInit } from '@angular/core';
-import { AfterViewInit } from '@angular/core';
-import { ChangeDetectorRef } from '@angular/core';
-import { ControlValueAccessor } from '@angular/forms';
-import { DoCheck } from '@angular/core';
-import { ElementRef } from '@angular/core';
-import { ErrorStateMatcher } from '@angular/material/core';
-import { EventEmitter } from '@angular/core';
-import { FocusKeyManager } from '@angular/cdk/a11y';
 import * as i0 from '@angular/core';
-import * as i1 from '@angular/material/core';
-import { InjectionToken } from '@angular/core';
-import { Injector } from '@angular/core';
-import { MatFormFieldControl } from '@angular/material/form-field';
-import { NgControl } from '@angular/forms';
-import { NgZone } from '@angular/core';
-import { Observable } from 'rxjs';
-import { OnChanges } from '@angular/core';
-import { OnDestroy } from '@angular/core';
-import { OnInit } from '@angular/core';
-import { QueryList } from '@angular/core';
-import { Subject } from 'rxjs';
-
-declare namespace i10 {
-    export {
-        MatChipEditedEvent,
-        MatChipRow
-    }
-}
-
-declare namespace i11 {
-    export {
-        MatChipSet
-    }
-}
-
-declare namespace i2 {
-    export {
-        MatChipAction
-    }
-}
-
-declare namespace i3 {
-    export {
-        MatChipEvent,
-        MatChip
-    }
-}
-
-declare namespace i4 {
-    export {
-        MatChipAvatar,
-        MatChipTrailingIcon,
-        MatChipRemove
-    }
-}
-
-declare namespace i5 {
-    export {
-        MatChipEditInput
-    }
-}
-
-declare namespace i6 {
-    export {
-        MatChipGridChange,
-        MatChipGrid
-    }
-}
-
-declare namespace i7 {
-    export {
-        MatChipInputEvent,
-        MatChipInput
-    }
-}
-
-declare namespace i8 {
-    export {
-        MatChipListboxChange,
-        MAT_CHIP_LISTBOX_CONTROL_VALUE_ACCESSOR,
-        MatChipListbox
-    }
-}
-
-declare namespace i9 {
-    export {
-        MatChipSelectionChange,
-        MatChipOption
-    }
-}
-
-/**
- * Injection token used to avoid a circular dependency between the `MatChip` and `MatChipAction`.
- */
-export declare const MAT_CHIP: InjectionToken<unknown>;
-
-/**
- * Injection token that can be used to reference instances of `MatChipAvatar`. It serves as
- * alternative token to the actual `MatChipAvatar` class which could cause unnecessary
- * retention of the class and its directive metadata.
- */
-export declare const MAT_CHIP_AVATAR: InjectionToken<unknown>;
+import { ElementRef, OnInit, AfterViewInit, AfterContentInit, DoCheck, OnDestroy, ChangeDetectorRef, NgZone, QueryList, EventEmitter, Injector, OnChanges, InjectionToken } from '@angular/core';
+import { Subject, Observable } from 'rxjs';
+import { FocusKeyManager } from '@angular/cdk/a11y';
+import { ControlValueAccessor, NgControl } from '@angular/forms';
+import { E as ErrorStateMatcher } from '../error-options.d-CGdTZUYk.js';
+import { M as MatFormFieldControl } from '../form-field-control.d-DvB4ZVlf.js';
+import { M as MatCommonModule } from '../common-module.d-C8xzHJDr.js';
+import { M as MatRippleModule } from '../index.d-C5neTPvr.js';
+import '@angular/cdk/bidi';
+import '../ripple.d-BT30YVLB.js';
+import '@angular/cdk/platform';
 
 /**
- * Provider Expression that allows mat-chip-listbox to register as a ControlValueAccessor.
- * This allows it to support [(ngModel)].
+ * Section within a chip.
  * @docs-private
  */
-export declare const MAT_CHIP_LISTBOX_CONTROL_VALUE_ACCESSOR: any;
-
-/**
- * Injection token that can be used to reference instances of `MatChipRemove`. It serves as
- * alternative token to the actual `MatChipRemove` class which could cause unnecessary
- * retention of the class and its directive metadata.
- */
-export declare const MAT_CHIP_REMOVE: InjectionToken<unknown>;
+declare class MatChipAction {
+    _elementRef: ElementRef<HTMLElement>;
+    protected _parentChip: {
+        _handlePrimaryActionInteraction(): void;
+        remove(): void;
+        disabled: boolean;
+        _isEditing?: boolean;
+    };
+    /** Whether the action is interactive. */
+    isInteractive: boolean;
+    /** Whether this is the primary action in the chip. */
+    _isPrimary: boolean;
+    /** Whether the action is disabled. */
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    private _disabled;
+    /** Tab index of the action. */
+    tabIndex: number;
+    /**
+     * Private API to allow focusing this chip when it is disabled.
+     */
+    private _allowFocusWhenDisabled;
+    /**
+     * Determine the value of the disabled attribute for this chip action.
+     */
+    protected _getDisabledAttribute(): string | null;
+    /**
+     * Determine the value of the tabindex attribute for this chip action.
+     */
+    protected _getTabindex(): string | null;
+    constructor(...args: unknown[]);
+    focus(): void;
+    _handleClick(event: MouseEvent): void;
+    _handleKeydown(event: KeyboardEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipAction, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatChipAction, "[matChipAction]", never, { "isInteractive": { "alias": "isInteractive"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "_allowFocusWhenDisabled": { "alias": "_allowFocusWhenDisabled"; "required": false; }; }, {}, never, never, true, never>;
+    static ngAcceptInputType_disabled: unknown;
+    static ngAcceptInputType_tabIndex: unknown;
+}
 
+/** Avatar image within a chip. */
+declare class MatChipAvatar {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipAvatar, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatChipAvatar, "mat-chip-avatar, [matChipAvatar]", never, {}, {}, never, never, true, never>;
+}
+/** Non-interactive trailing icon in a chip. */
+declare class MatChipTrailingIcon extends MatChipAction {
+    /**
+     * MDC considers all trailing actions as a remove icon,
+     * but we support non-interactive trailing icons.
+     */
+    isInteractive: boolean;
+    _isPrimary: boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipTrailingIcon, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatChipTrailingIcon, "mat-chip-trailing-icon, [matChipTrailingIcon]", never, {}, {}, never, never, true, never>;
+}
 /**
- * Injection token that can be used to reference instances of `MatChipTrailingIcon`. It serves as
- * alternative token to the actual `MatChipTrailingIcon` class which could cause unnecessary
- * retention of the class and its directive metadata.
+ * Directive to remove the parent chip when the trailing icon is clicked or
+ * when the ENTER key is pressed on it.
+ *
+ * Recommended for use with the Material Design "cancel" icon
+ * available at https://material.io/icons/#ic_cancel.
+ *
+ * Example:
+ *
+ * ```
+ * <mat-chip>
+ *   <mat-icon matChipRemove>cancel</mat-icon>
+ * </mat-chip>
+ * ```
  */
-export declare const MAT_CHIP_TRAILING_ICON: InjectionToken<unknown>;
-
-/** Injection token to be used to override the default options for the chips module. */
-export declare const MAT_CHIPS_DEFAULT_OPTIONS: InjectionToken<MatChipsDefaultOptions>;
+declare class MatChipRemove extends MatChipAction {
+    _isPrimary: boolean;
+    _handleClick(event: MouseEvent): void;
+    _handleKeydown(event: KeyboardEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipRemove, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatChipRemove, "[matChipRemove]", never, {}, {}, never, never, true, never>;
+}
 
+/** Represents an event fired on an individual `mat-chip`. */
+interface MatChipEvent {
+    /** The chip the event was fired on. */
+    chip: MatChip;
+}
 /**
  * Material design styled Chip base component. Used inside the MatChipSet component.
  *
  * Extended by MatChipOption and MatChipRow for different interaction patterns.
  */
-export declare class MatChip implements OnInit, AfterViewInit, AfterContentInit, DoCheck, OnDestroy {
+declare class MatChip implements OnInit, AfterViewInit, AfterContentInit, DoCheck, OnDestroy {
     _changeDetectorRef: ChangeDetectorRef;
     _elementRef: ElementRef<HTMLElement>;
+    private readonly _tagName;
     protected _ngZone: NgZone;
     private _focusMonitor;
     private _globalRippleOptions;
@@ -257,67 +231,92 @@ export declare class MatChip implements OnInit, AfterViewInit, AfterContentInit,
     static ngAcceptInputType_disabled: unknown;
 }
 
+/** Event object emitted by MatChipOption when selected or deselected. */
+declare class MatChipSelectionChange {
+    /** Reference to the chip that emitted the event. */
+    source: MatChipOption;
+    /** Whether the chip that emitted the event is selected. */
+    selected: boolean;
+    /** Whether the selection change was a result of a user interaction. */
+    isUserInput: boolean;
+    constructor(
+    /** Reference to the chip that emitted the event. */
+    source: MatChipOption, 
+    /** Whether the chip that emitted the event is selected. */
+    selected: boolean, 
+    /** Whether the selection change was a result of a user interaction. */
+    isUserInput?: boolean);
+}
 /**
- * Section within a chip.
- * @docs-private
+ * An extension of the MatChip component that supports chip selection. Used with MatChipListbox.
+ *
+ * Unlike other chips, the user can focus on disabled chip options inside a MatChipListbox. The
+ * user cannot click disabled chips.
  */
-declare class MatChipAction {
-    _elementRef: ElementRef<HTMLElement>;
-    protected _parentChip: {
-        _handlePrimaryActionInteraction(): void;
-        remove(): void;
-        disabled: boolean;
-        _isEditing?: boolean;
-    };
-    /** Whether the action is interactive. */
-    isInteractive: boolean;
-    /** Whether this is the primary action in the chip. */
-    _isPrimary: boolean;
-    /** Whether the action is disabled. */
-    get disabled(): boolean;
-    set disabled(value: boolean);
-    private _disabled;
-    /** Tab index of the action. */
-    tabIndex: number;
-    /**
-     * Private API to allow focusing this chip when it is disabled.
-     */
-    private _allowFocusWhenDisabled;
+declare class MatChipOption extends MatChip implements OnInit {
+    /** Default chip options. */
+    private _defaultOptions;
+    /** Whether the chip list is selectable. */
+    chipListSelectable: boolean;
+    /** Whether the chip list is in multi-selection mode. */
+    _chipListMultiple: boolean;
+    /** Whether the chip list hides single-selection indicator. */
+    _chipListHideSingleSelectionIndicator: boolean;
     /**
-     * Determine the value of the disabled attribute for this chip action.
+     * Whether or not the chip is selectable.
+     *
+     * When a chip is not selectable, changes to its selected state are always
+     * ignored. By default an option chip is selectable, and it becomes
+     * non-selectable if its parent chip list is not selectable.
      */
-    protected _getDisabledAttribute(): string | null;
+    get selectable(): boolean;
+    set selectable(value: boolean);
+    protected _selectable: boolean;
+    /** Whether the chip is selected. */
+    get selected(): boolean;
+    set selected(value: boolean);
+    private _selected;
     /**
-     * Determine the value of the tabindex attribute for this chip action.
+     * The ARIA selected applied to the chip. Conforms to WAI ARIA best practices for listbox
+     * interaction patterns.
+     *
+     * From [WAI ARIA Listbox authoring practices guide](
+     * https://www.w3.org/WAI/ARIA/apg/patterns/listbox/):
+     *  "If any options are selected, each selected option has either aria-selected or aria-checked
+     *  set to true. All options that are selectable but not selected have either aria-selected or
+     *  aria-checked set to false."
+     *
+     * Set `aria-selected="false"` on not-selected listbox options that are selectable to fix
+     * VoiceOver reading every option as "selected" (#25736).
      */
-    protected _getTabindex(): string | null;
-    constructor(...args: unknown[]);
-    focus(): void;
-    _handleClick(event: MouseEvent): void;
-    _handleKeydown(event: KeyboardEvent): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipAction, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatChipAction, "[matChipAction]", never, { "isInteractive": { "alias": "isInteractive"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "_allowFocusWhenDisabled": { "alias": "_allowFocusWhenDisabled"; "required": false; }; }, {}, never, never, true, never>;
-    static ngAcceptInputType_disabled: unknown;
-    static ngAcceptInputType_tabIndex: unknown;
-}
-
-/** Avatar image within a chip. */
-export declare class MatChipAvatar {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipAvatar, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatChipAvatar, "mat-chip-avatar, [matChipAvatar]", never, {}, {}, never, never, true, never>;
-}
-
-/** Represents an event fired on an individual `mat-chip` when it is edited. */
-export declare interface MatChipEditedEvent extends MatChipEvent {
-    /** The final edit value. */
-    value: string;
+    get ariaSelected(): string | null;
+    /** The unstyled chip selector for this component. */
+    protected basicChipAttrName: string;
+    /** Emitted when the chip is selected or deselected. */
+    readonly selectionChange: EventEmitter<MatChipSelectionChange>;
+    ngOnInit(): void;
+    /** Selects the chip. */
+    select(): void;
+    /** Deselects the chip. */
+    deselect(): void;
+    /** Selects this chip and emits userInputSelection event */
+    selectViaInteraction(): void;
+    /** Toggles the current selected state of this chip. */
+    toggleSelected(isUserInput?: boolean): boolean;
+    _handlePrimaryActionInteraction(): void;
+    _hasLeadingGraphic(): boolean;
+    _setSelectedState(isSelected: boolean, isUserInput: boolean, emitEvent: boolean): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipOption, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatChipOption, "mat-basic-chip-option, [mat-basic-chip-option], mat-chip-option, [mat-chip-option]", never, { "selectable": { "alias": "selectable"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; }, { "selectionChange": "selectionChange"; }, never, ["mat-chip-avatar, [matChipAvatar]", "*", "mat-chip-trailing-icon,[matChipRemove],[matChipTrailingIcon]"], true, never>;
+    static ngAcceptInputType_selectable: unknown;
+    static ngAcceptInputType_selected: unknown;
 }
 
 /**
  * A directive that makes a span editable and exposes functions to modify and retrieve the
  * element's contents.
  */
-export declare class MatChipEditInput {
+declare class MatChipEditInput {
     private readonly _elementRef;
     private readonly _document;
     constructor(...args: unknown[]);
@@ -330,130 +329,225 @@ export declare class MatChipEditInput {
     static ɵdir: i0.ɵɵDirectiveDeclaration<MatChipEditInput, "span[matChipEditInput]", never, {}, {}, never, never, true, never>;
 }
 
-/** Represents an event fired on an individual `mat-chip`. */
-export declare interface MatChipEvent {
-    /** The chip the event was fired on. */
-    chip: MatChip;
+/** Represents an event fired on an individual `mat-chip` when it is edited. */
+interface MatChipEditedEvent extends MatChipEvent {
+    /** The final edit value. */
+    value: string;
 }
-
 /**
- * An extension of the MatChipSet component used with MatChipRow chips and
+ * An extension of the MatChip component used with MatChipGrid and
  * the matChipInputFor directive.
  */
-export declare class MatChipGrid extends MatChipSet implements AfterContentInit, AfterViewInit, ControlValueAccessor, DoCheck, MatFormFieldControl<any>, OnDestroy {
-    ngControl: NgControl;
+declare class MatChipRow extends MatChip implements AfterViewInit {
+    protected basicChipAttrName: string;
     /**
-     * Implemented as part of MatFormFieldControl.
-     * @docs-private
+     * The editing action has to be triggered in a timeout. While we're waiting on it, a blur
+     * event might occur which will interrupt the editing. This flag is used to avoid interruptions
+     * while the editing action is being initialized.
      */
-    readonly controlType: string;
-    /** The chip input to add more chips */
-    protected _chipInput: MatChipTextControl;
-    protected _defaultRole: string;
-    private _errorStateTracker;
+    private _editStartPending;
+    editable: boolean;
+    /** Emitted when the chip is edited. */
+    readonly edited: EventEmitter<MatChipEditedEvent>;
+    /** The default chip edit input that is used if none is projected into this chip row. */
+    defaultEditInput?: MatChipEditInput;
+    /** The projected chip edit input. */
+    contentEditInput?: MatChipEditInput;
+    _isEditing: boolean;
+    constructor(...args: unknown[]);
+    _hasTrailingIcon(): boolean;
+    /** Sends focus to the first gridcell when the user clicks anywhere inside the chip. */
+    _handleFocus(): void;
+    _handleKeydown(event: KeyboardEvent): void;
+    _handleDoubleclick(event: MouseEvent): void;
+    private _startEditing;
+    private _onEditFinish;
+    _isRippleDisabled(): boolean;
     /**
-     * List of element ids to propagate to the chipInput's aria-describedby attribute.
+     * Gets the projected chip edit input, or the default input if none is projected in. One of these
+     * two values is guaranteed to be defined.
      */
-    private _ariaDescribedbyIds;
+    private _getEditInput;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipRow, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatChipRow, "mat-chip-row, [mat-chip-row], mat-basic-chip-row, [mat-basic-chip-row]", never, { "editable": { "alias": "editable"; "required": false; }; }, { "edited": "edited"; }, ["contentEditInput"], ["mat-chip-avatar, [matChipAvatar]", "[matChipEditInput]", "*", "mat-chip-trailing-icon,[matChipRemove],[matChipTrailingIcon]"], true, never>;
+}
+
+/**
+ * Basic container component for the MatChip component.
+ *
+ * Extended by MatChipListbox and MatChipGrid for different interaction patterns.
+ */
+declare class MatChipSet implements AfterViewInit, OnDestroy {
+    protected _elementRef: ElementRef<HTMLElement>;
+    protected _changeDetectorRef: ChangeDetectorRef;
+    private _dir;
+    /** Index of the last destroyed chip that had focus. */
+    private _lastDestroyedFocusedChipIndex;
+    /** Used to manage focus within the chip list. */
+    protected _keyManager: FocusKeyManager<MatChipAction>;
+    /** Subject that emits when the component has been destroyed. */
+    protected _destroyed: Subject<void>;
+    /** Role to use if it hasn't been overwritten by the user. */
+    protected _defaultRole: string;
+    /** Combined stream of all of the child chips' focus events. */
+    get chipFocusChanges(): Observable<MatChipEvent>;
+    /** Combined stream of all of the child chips' destroy events. */
+    get chipDestroyedChanges(): Observable<MatChipEvent>;
+    /** Combined stream of all of the child chips' remove events. */
+    get chipRemovedChanges(): Observable<MatChipEvent>;
+    /** Whether the chip set is disabled. */
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    protected _disabled: boolean;
+    /** Whether the chip list contains chips or not. */
+    get empty(): boolean;
+    /** The ARIA role applied to the chip set. */
+    get role(): string | null;
+    /** Tabindex of the chip set. */
+    tabIndex: number;
+    set role(value: string | null);
+    private _explicitRole;
+    /** Whether any of the chips inside of this chip-set has focus. */
+    get focused(): boolean;
+    /** The chips that are part of this chip set. */
+    _chips: QueryList<MatChip>;
+    /** Flat list of all the actions contained within the chips. */
+    _chipActions: QueryList<MatChipAction>;
+    constructor(...args: unknown[]);
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    /** Checks whether any of the chips is focused. */
+    protected _hasFocusedChip(): boolean;
+    /** Syncs the chip-set's state with the individual chips. */
+    protected _syncChipsState(): void;
+    /** Dummy method for subclasses to override. Base chip set cannot be focused. */
+    focus(): void;
+    /** Handles keyboard events on the chip set. */
+    _handleKeydown(event: KeyboardEvent): void;
     /**
-     * Function when touched. Set as part of ControlValueAccessor implementation.
-     * @docs-private
+     * Utility to ensure all indexes are valid.
+     *
+     * @param index The index to be checked.
+     * @returns True if the index is valid for our list of chips.
      */
-    _onTouched: () => void;
+    protected _isValidIndex(index: number): boolean;
     /**
-     * Function when changed. Set as part of ControlValueAccessor implementation.
-     * @docs-private
+     * Removes the `tabindex` from the chip set and resets it back afterwards, allowing the
+     * user to tab out of it. This prevents the set from capturing focus and redirecting
+     * it back to the first chip, creating a focus trap, if it user tries to tab away.
      */
-    _onChange: (value: any) => void;
+    protected _allowFocusEscape(): void;
     /**
-     * Implemented as part of MatFormFieldControl.
-     * @docs-private
+     * Gets a stream of events from all the chips within the set.
+     * The stream will automatically incorporate any newly-added chips.
      */
-    get disabled(): boolean;
-    set disabled(value: boolean);
+    protected _getChipStream<T, C extends MatChip = MatChip>(mappingFunction: (chip: C) => Observable<T>): Observable<T>;
+    /** Checks whether an event comes from inside a chip element. */
+    protected _originatesFromChip(event: Event): boolean;
+    /** Sets up the chip set's focus management logic. */
+    private _setUpFocusManagement;
     /**
-     * Implemented as part of MatFormFieldControl.
-     * @docs-private
+     * Determines if key manager should avoid putting a given chip action in the tab index. Skip
+     * non-interactive and disabled actions since the user can't do anything with them.
      */
-    get id(): string;
+    protected _skipPredicate(action: MatChipAction): boolean;
+    /** Listens to changes in the chip set and syncs up the state of the individual chips. */
+    private _trackChipSetChanges;
+    /** Starts tracking the destroyed chips in order to capture the focused one. */
+    private _trackDestroyedFocusedChip;
     /**
-     * Implemented as part of MatFormFieldControl.
-     * @docs-private
+     * Finds the next appropriate chip to move focus to,
+     * if the currently-focused chip is destroyed.
      */
-    get empty(): boolean;
+    private _redirectDestroyedChipFocus;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipSet, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatChipSet, "mat-chip-set", never, { "disabled": { "alias": "disabled"; "required": false; }; "role": { "alias": "role"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; }, {}, ["_chips"], ["*"], true, never>;
+    static ngAcceptInputType_disabled: unknown;
+    static ngAcceptInputType_tabIndex: unknown;
+}
+
+/** Change event object that is emitted when the chip listbox value has changed. */
+declare class MatChipListboxChange {
+    /** Chip listbox that emitted the event. */
+    source: MatChipListbox;
+    /** Value of the chip listbox when the event was emitted. */
+    value: any;
+    constructor(
+    /** Chip listbox that emitted the event. */
+    source: MatChipListbox, 
+    /** Value of the chip listbox when the event was emitted. */
+    value: any);
+}
+/**
+ * Provider Expression that allows mat-chip-listbox to register as a ControlValueAccessor.
+ * This allows it to support [(ngModel)].
+ * @docs-private
+ */
+declare const MAT_CHIP_LISTBOX_CONTROL_VALUE_ACCESSOR: any;
+/**
+ * An extension of the MatChipSet component that supports chip selection.
+ * Used with MatChipOption chips.
+ */
+declare class MatChipListbox extends MatChipSet implements AfterContentInit, OnDestroy, ControlValueAccessor {
     /**
-     * Implemented as part of MatFormFieldControl.
+     * Function when touched. Set as part of ControlValueAccessor implementation.
      * @docs-private
      */
-    get placeholder(): string;
-    set placeholder(value: string);
-    protected _placeholder: string;
-    /** Whether any chips or the matChipInput inside of this chip-grid has focus. */
-    get focused(): boolean;
+    _onTouched: () => void;
     /**
-     * Implemented as part of MatFormFieldControl.
+     * Function when changed. Set as part of ControlValueAccessor implementation.
      * @docs-private
      */
-    get required(): boolean;
-    set required(value: boolean);
-    protected _required: boolean | undefined;
+    _onChange: (value: any) => void;
+    protected _defaultRole: string;
+    /** Default chip options. */
+    private _defaultOptions;
+    /** Whether the user should be allowed to select multiple chips. */
+    get multiple(): boolean;
+    set multiple(value: boolean);
+    private _multiple;
+    /** The array of selected chips inside the chip listbox. */
+    get selected(): MatChipOption[] | MatChipOption;
+    /** Orientation of the chip list. */
+    ariaOrientation: 'horizontal' | 'vertical';
     /**
-     * Implemented as part of MatFormFieldControl.
-     * @docs-private
+     * Whether or not this chip listbox is selectable.
+     *
+     * When a chip listbox is not selectable, the selected states for all
+     * the chips inside the chip listbox are always ignored.
      */
-    get shouldLabelFloat(): boolean;
+    get selectable(): boolean;
+    set selectable(value: boolean);
+    protected _selectable: boolean;
     /**
-     * Implemented as part of MatFormFieldControl.
-     * @docs-private
+     * A function to compare the option values with the selected values. The first argument
+     * is a value from an option. The second is a value from the selection. A boolean
+     * should be returned.
      */
-    get value(): any;
-    set value(value: any);
-    protected _value: any[];
-    /** An object used to control when error messages are shown. */
-    get errorStateMatcher(): ErrorStateMatcher;
-    set errorStateMatcher(value: ErrorStateMatcher);
+    compareWith: (o1: any, o2: any) => boolean;
+    /** Whether this chip listbox is required. */
+    required: boolean;
+    /** Whether checkmark indicator for single-selection options is hidden. */
+    get hideSingleSelectionIndicator(): boolean;
+    set hideSingleSelectionIndicator(value: boolean);
+    private _hideSingleSelectionIndicator;
+    /** Combined stream of all of the child chips' selection change events. */
+    get chipSelectionChanges(): Observable<MatChipSelectionChange>;
     /** Combined stream of all of the child chips' blur events. */
     get chipBlurChanges(): Observable<MatChipEvent>;
-    /** Emits when the chip grid value has been changed by the user. */
-    readonly change: EventEmitter<MatChipGridChange>;
-    /**
-     * Emits whenever the raw value of the chip-grid changes. This is here primarily
-     * to facilitate the two-way binding for the `value` input.
-     * @docs-private
-     */
-    readonly valueChange: EventEmitter<any>;
-    _chips: QueryList<MatChipRow>;
-    /**
-     * Emits whenever the component state changes and should cause the parent
-     * form-field to update. Implemented as part of `MatFormFieldControl`.
-     * @docs-private
-     */
-    readonly stateChanges: Subject<void>;
-    /** Whether the chip grid is in an error state. */
-    get errorState(): boolean;
-    set errorState(value: boolean);
-    constructor(...args: unknown[]);
+    /** The value of the listbox, which is the combined value of the selected chips. */
+    get value(): any;
+    set value(value: any);
+    protected _value: any;
+    /** Event emitted when the selected chip listbox value has been changed by the user. */
+    readonly change: EventEmitter<MatChipListboxChange>;
+    _chips: QueryList<MatChipOption>;
     ngAfterContentInit(): void;
-    ngAfterViewInit(): void;
-    ngDoCheck(): void;
-    ngOnDestroy(): void;
-    /** Associates an HTML input element with this chip grid. */
-    registerInput(inputElement: MatChipTextControl): void;
-    /**
-     * Implemented as part of MatFormFieldControl.
-     * @docs-private
-     */
-    onContainerClick(event: MouseEvent): void;
     /**
-     * Focuses the first chip in this chip grid, or the associated input when there
-     * are no eligible chips.
+     * Focuses the first selected chip in this chip listbox, or the first non-disabled chip when there
+     * are no selected chips.
      */
     focus(): void;
-    /**
-     * Implemented as part of MatFormFieldControl.
-     * @docs-private
-     */
-    setDescribedByIds(ids: string[]): void;
     /**
      * Implemented as part of ControlValueAccessor.
      * @docs-private
@@ -474,9 +568,218 @@ export declare class MatChipGrid extends MatChipSet implements AfterContentInit,
      * @docs-private
      */
     setDisabledState(isDisabled: boolean): void;
-    /** Refreshes the error state of the chip grid. */
-    updateErrorState(): void;
-    /** When blurred, mark the field as touched when focus moved outside the chip grid. */
+    /** Selects all chips with value. */
+    _setSelectionByValue(value: any, isUserInput?: boolean): void;
+    /** When blurred, marks the field as touched when focus moved outside the chip listbox. */
+    _blur(): void;
+    _keydown(event: KeyboardEvent): void;
+    /** Marks the field as touched */
+    private _markAsTouched;
+    /** Emits change event to set the model value. */
+    private _propagateChanges;
+    /**
+     * Deselects every chip in the listbox.
+     * @param skip Chip that should not be deselected.
+     */
+    private _clearSelection;
+    /**
+     * Finds and selects the chip based on its value.
+     * @returns Chip that has the corresponding value.
+     */
+    private _selectValue;
+    /** Syncs the chip-listbox selection state with the individual chips. */
+    private _syncListboxProperties;
+    /** Returns the first selected chip in this listbox, or undefined if no chips are selected. */
+    private _getFirstSelectedChip;
+    /**
+     * Determines if key manager should avoid putting a given chip action in the tab index. Skip
+     * non-interactive actions since the user can't do anything with them.
+     */
+    protected _skipPredicate(action: MatChipAction): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipListbox, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatChipListbox, "mat-chip-listbox", never, { "multiple": { "alias": "multiple"; "required": false; }; "ariaOrientation": { "alias": "aria-orientation"; "required": false; }; "selectable": { "alias": "selectable"; "required": false; }; "compareWith": { "alias": "compareWith"; "required": false; }; "required": { "alias": "required"; "required": false; }; "hideSingleSelectionIndicator": { "alias": "hideSingleSelectionIndicator"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "change": "change"; }, ["_chips"], ["*"], true, never>;
+    static ngAcceptInputType_multiple: unknown;
+    static ngAcceptInputType_selectable: unknown;
+    static ngAcceptInputType_required: unknown;
+    static ngAcceptInputType_hideSingleSelectionIndicator: unknown;
+}
+
+/** Interface for a text control that is used to drive interaction with a mat-chip-list. */
+interface MatChipTextControl {
+    /** Unique identifier for the text control. */
+    id: string;
+    /** The text control's placeholder text. */
+    placeholder: string;
+    /** Whether the text control has browser focus. */
+    focused: boolean;
+    /** Whether the text control is empty. */
+    empty: boolean;
+    /** Focuses the text control. */
+    focus(): void;
+    /** Gets the list of ids the input is described by. */
+    readonly describedByIds?: string[];
+    /** Sets the list of ids the input is described by. */
+    setDescribedByIds(ids: string[]): void;
+}
+
+/** Change event object that is emitted when the chip grid value has changed. */
+declare class MatChipGridChange {
+    /** Chip grid that emitted the event. */
+    source: MatChipGrid;
+    /** Value of the chip grid when the event was emitted. */
+    value: any;
+    constructor(
+    /** Chip grid that emitted the event. */
+    source: MatChipGrid, 
+    /** Value of the chip grid when the event was emitted. */
+    value: any);
+}
+/**
+ * An extension of the MatChipSet component used with MatChipRow chips and
+ * the matChipInputFor directive.
+ */
+declare class MatChipGrid extends MatChipSet implements AfterContentInit, AfterViewInit, ControlValueAccessor, DoCheck, MatFormFieldControl<any>, OnDestroy {
+    ngControl: NgControl;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    readonly controlType: string;
+    /** The chip input to add more chips */
+    protected _chipInput: MatChipTextControl;
+    protected _defaultRole: string;
+    private _errorStateTracker;
+    /**
+     * List of element ids to propagate to the chipInput's aria-describedby attribute.
+     */
+    private _ariaDescribedbyIds;
+    /**
+     * Function when touched. Set as part of ControlValueAccessor implementation.
+     * @docs-private
+     */
+    _onTouched: () => void;
+    /**
+     * Function when changed. Set as part of ControlValueAccessor implementation.
+     * @docs-private
+     */
+    _onChange: (value: any) => void;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    get id(): string;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    get empty(): boolean;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    get placeholder(): string;
+    set placeholder(value: string);
+    protected _placeholder: string;
+    /** Whether any chips or the matChipInput inside of this chip-grid has focus. */
+    get focused(): boolean;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    get required(): boolean;
+    set required(value: boolean);
+    protected _required: boolean | undefined;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    get shouldLabelFloat(): boolean;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    get value(): any;
+    set value(value: any);
+    protected _value: any[];
+    /** An object used to control when error messages are shown. */
+    get errorStateMatcher(): ErrorStateMatcher;
+    set errorStateMatcher(value: ErrorStateMatcher);
+    /** Combined stream of all of the child chips' blur events. */
+    get chipBlurChanges(): Observable<MatChipEvent>;
+    /** Emits when the chip grid value has been changed by the user. */
+    readonly change: EventEmitter<MatChipGridChange>;
+    /**
+     * Emits whenever the raw value of the chip-grid changes. This is here primarily
+     * to facilitate the two-way binding for the `value` input.
+     * @docs-private
+     */
+    readonly valueChange: EventEmitter<any>;
+    _chips: QueryList<MatChipRow>;
+    /**
+     * Emits whenever the component state changes and should cause the parent
+     * form-field to update. Implemented as part of `MatFormFieldControl`.
+     * @docs-private
+     */
+    readonly stateChanges: Subject<void>;
+    /** Whether the chip grid is in an error state. */
+    get errorState(): boolean;
+    set errorState(value: boolean);
+    constructor(...args: unknown[]);
+    ngAfterContentInit(): void;
+    ngAfterViewInit(): void;
+    ngDoCheck(): void;
+    ngOnDestroy(): void;
+    /** Associates an HTML input element with this chip grid. */
+    registerInput(inputElement: MatChipTextControl): void;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    onContainerClick(event: MouseEvent): void;
+    /**
+     * Focuses the first chip in this chip grid, or the associated input when there
+     * are no eligible chips.
+     */
+    focus(): void;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    get describedByIds(): string[];
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    setDescribedByIds(ids: string[]): void;
+    /**
+     * Implemented as part of ControlValueAccessor.
+     * @docs-private
+     */
+    writeValue(value: any): void;
+    /**
+     * Implemented as part of ControlValueAccessor.
+     * @docs-private
+     */
+    registerOnChange(fn: (value: any) => void): void;
+    /**
+     * Implemented as part of ControlValueAccessor.
+     * @docs-private
+     */
+    registerOnTouched(fn: () => void): void;
+    /**
+     * Implemented as part of ControlValueAccessor.
+     * @docs-private
+     */
+    setDisabledState(isDisabled: boolean): void;
+    /** Refreshes the error state of the chip grid. */
+    updateErrorState(): void;
+    /** When blurred, mark the field as touched when focus moved outside the chip grid. */
     _blur(): void;
     /**
      * Removes the `tabindex` from the chip grid and resets it back afterwards, allowing the
@@ -497,31 +800,31 @@ export declare class MatChipGrid extends MatChipSet implements AfterContentInit,
     static ngAcceptInputType_required: unknown;
 }
 
-/** Change event object that is emitted when the chip grid value has changed. */
-export declare class MatChipGridChange {
-    /** Chip grid that emitted the event. */
-    source: MatChipGrid;
-    /** Value of the chip grid when the event was emitted. */
-    value: any;
-    constructor(
-    /** Chip grid that emitted the event. */
-    source: MatChipGrid, 
-    /** Value of the chip grid when the event was emitted. */
-    value: any);
+/** Represents an input event on a `matChipInput`. */
+interface MatChipInputEvent {
+    /**
+     * The native `<input>` element that the event is being fired for.
+     * @deprecated Use `MatChipInputEvent#chipInput.inputElement` instead.
+     * @breaking-change 13.0.0 This property will be removed.
+     */
+    input: HTMLInputElement;
+    /** The value of the input. */
+    value: string;
+    /** Reference to the chip input that emitted the event. */
+    chipInput: MatChipInput;
 }
-
 /**
  * Directive that adds chip-specific behaviors to an input element inside `<mat-form-field>`.
  * May be placed inside or outside of a `<mat-chip-grid>`.
  */
-export declare class MatChipInput implements MatChipTextControl, OnChanges, OnDestroy {
+declare class MatChipInput implements MatChipTextControl, OnChanges, OnDestroy {
     protected _elementRef: ElementRef<HTMLInputElement>;
     /** Whether the control is focused. */
     focused: boolean;
     /** Register input for chip list */
     get chipGrid(): MatChipGrid;
     set chipGrid(value: MatChipGrid);
-    private _chipGrid;
+    protected _chipGrid: MatChipGrid;
     /**
      * Whether or not the chipEnd event will be emitted when the input is blurred.
      */
@@ -542,6 +845,10 @@ export declare class MatChipInput implements MatChipTextControl, OnChanges, OnDe
     get disabled(): boolean;
     set disabled(value: boolean);
     private _disabled;
+    /** Whether the input is readonly. */
+    readonly: boolean;
+    /** Whether the input should remain interactive when it is disabled. */
+    disabledInteractive: boolean;
     /** Whether the input is empty. */
     get empty(): boolean;
     /** The native input element to which this directive is attached. */
@@ -561,440 +868,63 @@ export declare class MatChipInput implements MatChipTextControl, OnChanges, OnDe
     focus(): void;
     /** Clears the input */
     clear(): void;
+    /**
+     * Implemented as part of MatChipTextControl.
+     * @docs-private
+     */
+    get describedByIds(): string[];
     setDescribedByIds(ids: string[]): void;
     /** Checks whether a keycode is one of the configured separators. */
     private _isSeparatorKey;
+    /** Gets the value to set on the `readonly` attribute. */
+    protected _getReadonlyAttribute(): string | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<MatChipInput, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatChipInput, "input[matChipInputFor]", ["matChipInput", "matChipInputFor"], { "chipGrid": { "alias": "matChipInputFor"; "required": false; }; "addOnBlur": { "alias": "matChipInputAddOnBlur"; "required": false; }; "separatorKeyCodes": { "alias": "matChipInputSeparatorKeyCodes"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "id": { "alias": "id"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "chipEnd": "matChipInputTokenEnd"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatChipInput, "input[matChipInputFor]", ["matChipInput", "matChipInputFor"], { "chipGrid": { "alias": "matChipInputFor"; "required": false; }; "addOnBlur": { "alias": "matChipInputAddOnBlur"; "required": false; }; "separatorKeyCodes": { "alias": "matChipInputSeparatorKeyCodes"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "id": { "alias": "id"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "disabledInteractive": { "alias": "matChipInputDisabledInteractive"; "required": false; }; }, { "chipEnd": "matChipInputTokenEnd"; }, never, never, true, never>;
     static ngAcceptInputType_addOnBlur: unknown;
     static ngAcceptInputType_disabled: unknown;
+    static ngAcceptInputType_readonly: unknown;
+    static ngAcceptInputType_disabledInteractive: unknown;
 }
 
-/** Represents an input event on a `matChipInput`. */
-export declare interface MatChipInputEvent {
-    /**
-     * The native `<input>` element that the event is being fired for.
-     * @deprecated Use `MatChipInputEvent#chipInput.inputElement` instead.
-     * @breaking-change 13.0.0 This property will be removed.
-     */
-    input: HTMLInputElement;
-    /** The value of the input. */
-    value: string;
-    /** Reference to the chip input that emitted the event. */
-    chipInput: MatChipInput;
+declare class MatChipsModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipsModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatChipsModule, never, [typeof MatCommonModule, typeof MatRippleModule, typeof MatChipAction, typeof MatChip, typeof MatChipAvatar, typeof MatChipEditInput, typeof MatChipGrid, typeof MatChipInput, typeof MatChipListbox, typeof MatChipOption, typeof MatChipRemove, typeof MatChipRow, typeof MatChipSet, typeof MatChipTrailingIcon], [typeof MatCommonModule, typeof MatChip, typeof MatChipAvatar, typeof MatChipEditInput, typeof MatChipGrid, typeof MatChipInput, typeof MatChipListbox, typeof MatChipOption, typeof MatChipRemove, typeof MatChipRow, typeof MatChipSet, typeof MatChipTrailingIcon]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatChipsModule>;
 }
 
+/** Default options, for the chips module, that can be overridden. */
+interface MatChipsDefaultOptions {
+    /** The list of key codes that will trigger a chipEnd event. */
+    separatorKeyCodes: readonly number[] | ReadonlySet<number>;
+    /** Whether icon indicators should be hidden for single-selection. */
+    hideSingleSelectionIndicator?: boolean;
+    /** Whether the chip input should be interactive while disabled by default. */
+    inputDisabledInteractive?: boolean;
+}
+/** Injection token to be used to override the default options for the chips module. */
+declare const MAT_CHIPS_DEFAULT_OPTIONS: InjectionToken<MatChipsDefaultOptions>;
 /**
- * An extension of the MatChipSet component that supports chip selection.
- * Used with MatChipOption chips.
+ * Injection token that can be used to reference instances of `MatChipAvatar`. It serves as
+ * alternative token to the actual `MatChipAvatar` class which could cause unnecessary
+ * retention of the class and its directive metadata.
  */
-export declare class MatChipListbox extends MatChipSet implements AfterContentInit, OnDestroy, ControlValueAccessor {
-    /**
-     * Function when touched. Set as part of ControlValueAccessor implementation.
-     * @docs-private
-     */
-    _onTouched: () => void;
-    /**
-     * Function when changed. Set as part of ControlValueAccessor implementation.
-     * @docs-private
-     */
-    _onChange: (value: any) => void;
-    protected _defaultRole: string;
-    /** Default chip options. */
-    private _defaultOptions;
-    /** Whether the user should be allowed to select multiple chips. */
-    get multiple(): boolean;
-    set multiple(value: boolean);
-    private _multiple;
-    /** The array of selected chips inside the chip listbox. */
-    get selected(): MatChipOption[] | MatChipOption;
-    /** Orientation of the chip list. */
-    ariaOrientation: 'horizontal' | 'vertical';
-    /**
-     * Whether or not this chip listbox is selectable.
-     *
-     * When a chip listbox is not selectable, the selected states for all
-     * the chips inside the chip listbox are always ignored.
-     */
-    get selectable(): boolean;
-    set selectable(value: boolean);
-    protected _selectable: boolean;
-    /**
-     * A function to compare the option values with the selected values. The first argument
-     * is a value from an option. The second is a value from the selection. A boolean
-     * should be returned.
-     */
-    compareWith: (o1: any, o2: any) => boolean;
-    /** Whether this chip listbox is required. */
-    required: boolean;
-    /** Whether checkmark indicator for single-selection options is hidden. */
-    get hideSingleSelectionIndicator(): boolean;
-    set hideSingleSelectionIndicator(value: boolean);
-    private _hideSingleSelectionIndicator;
-    /** Combined stream of all of the child chips' selection change events. */
-    get chipSelectionChanges(): Observable<MatChipSelectionChange>;
-    /** Combined stream of all of the child chips' blur events. */
-    get chipBlurChanges(): Observable<MatChipEvent>;
-    /** The value of the listbox, which is the combined value of the selected chips. */
-    get value(): any;
-    set value(value: any);
-    protected _value: any;
-    /** Event emitted when the selected chip listbox value has been changed by the user. */
-    readonly change: EventEmitter<MatChipListboxChange>;
-    _chips: QueryList<MatChipOption>;
-    ngAfterContentInit(): void;
-    /**
-     * Focuses the first selected chip in this chip listbox, or the first non-disabled chip when there
-     * are no selected chips.
-     */
-    focus(): void;
-    /**
-     * Implemented as part of ControlValueAccessor.
-     * @docs-private
-     */
-    writeValue(value: any): void;
-    /**
-     * Implemented as part of ControlValueAccessor.
-     * @docs-private
-     */
-    registerOnChange(fn: (value: any) => void): void;
-    /**
-     * Implemented as part of ControlValueAccessor.
-     * @docs-private
-     */
-    registerOnTouched(fn: () => void): void;
-    /**
-     * Implemented as part of ControlValueAccessor.
-     * @docs-private
-     */
-    setDisabledState(isDisabled: boolean): void;
-    /** Selects all chips with value. */
-    _setSelectionByValue(value: any, isUserInput?: boolean): void;
-    /** When blurred, marks the field as touched when focus moved outside the chip listbox. */
-    _blur(): void;
-    _keydown(event: KeyboardEvent): void;
-    /** Marks the field as touched */
-    private _markAsTouched;
-    /** Emits change event to set the model value. */
-    private _propagateChanges;
-    /**
-     * Deselects every chip in the listbox.
-     * @param skip Chip that should not be deselected.
-     */
-    private _clearSelection;
-    /**
-     * Finds and selects the chip based on its value.
-     * @returns Chip that has the corresponding value.
-     */
-    private _selectValue;
-    /** Syncs the chip-listbox selection state with the individual chips. */
-    private _syncListboxProperties;
-    /** Returns the first selected chip in this listbox, or undefined if no chips are selected. */
-    private _getFirstSelectedChip;
-    /**
-     * Determines if key manager should avoid putting a given chip action in the tab index. Skip
-     * non-interactive actions since the user can't do anything with them.
-     */
-    protected _skipPredicate(action: MatChipAction): boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipListbox, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatChipListbox, "mat-chip-listbox", never, { "multiple": { "alias": "multiple"; "required": false; }; "ariaOrientation": { "alias": "aria-orientation"; "required": false; }; "selectable": { "alias": "selectable"; "required": false; }; "compareWith": { "alias": "compareWith"; "required": false; }; "required": { "alias": "required"; "required": false; }; "hideSingleSelectionIndicator": { "alias": "hideSingleSelectionIndicator"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "change": "change"; }, ["_chips"], ["*"], true, never>;
-    static ngAcceptInputType_multiple: unknown;
-    static ngAcceptInputType_selectable: unknown;
-    static ngAcceptInputType_required: unknown;
-    static ngAcceptInputType_hideSingleSelectionIndicator: unknown;
-}
-
-/** Change event object that is emitted when the chip listbox value has changed. */
-export declare class MatChipListboxChange {
-    /** Chip listbox that emitted the event. */
-    source: MatChipListbox;
-    /** Value of the chip listbox when the event was emitted. */
-    value: any;
-    constructor(
-    /** Chip listbox that emitted the event. */
-    source: MatChipListbox, 
-    /** Value of the chip listbox when the event was emitted. */
-    value: any);
-}
-
-/**
- * An extension of the MatChip component that supports chip selection. Used with MatChipListbox.
- *
- * Unlike other chips, the user can focus on disabled chip options inside a MatChipListbox. The
- * user cannot click disabled chips.
- */
-export declare class MatChipOption extends MatChip implements OnInit {
-    /** Default chip options. */
-    private _defaultOptions;
-    /** Whether the chip list is selectable. */
-    chipListSelectable: boolean;
-    /** Whether the chip list is in multi-selection mode. */
-    _chipListMultiple: boolean;
-    /** Whether the chip list hides single-selection indicator. */
-    _chipListHideSingleSelectionIndicator: boolean;
-    /**
-     * Whether or not the chip is selectable.
-     *
-     * When a chip is not selectable, changes to its selected state are always
-     * ignored. By default an option chip is selectable, and it becomes
-     * non-selectable if its parent chip list is not selectable.
-     */
-    get selectable(): boolean;
-    set selectable(value: boolean);
-    protected _selectable: boolean;
-    /** Whether the chip is selected. */
-    get selected(): boolean;
-    set selected(value: boolean);
-    private _selected;
-    /**
-     * The ARIA selected applied to the chip. Conforms to WAI ARIA best practices for listbox
-     * interaction patterns.
-     *
-     * From [WAI ARIA Listbox authoring practices guide](
-     * https://www.w3.org/WAI/ARIA/apg/patterns/listbox/):
-     *  "If any options are selected, each selected option has either aria-selected or aria-checked
-     *  set to true. All options that are selectable but not selected have either aria-selected or
-     *  aria-checked set to false."
-     *
-     * Set `aria-selected="false"` on not-selected listbox options that are selectable to fix
-     * VoiceOver reading every option as "selected" (#25736).
-     */
-    get ariaSelected(): string | null;
-    /** The unstyled chip selector for this component. */
-    protected basicChipAttrName: string;
-    /** Emitted when the chip is selected or deselected. */
-    readonly selectionChange: EventEmitter<MatChipSelectionChange>;
-    ngOnInit(): void;
-    /** Selects the chip. */
-    select(): void;
-    /** Deselects the chip. */
-    deselect(): void;
-    /** Selects this chip and emits userInputSelection event */
-    selectViaInteraction(): void;
-    /** Toggles the current selected state of this chip. */
-    toggleSelected(isUserInput?: boolean): boolean;
-    _handlePrimaryActionInteraction(): void;
-    _hasLeadingGraphic(): boolean;
-    _setSelectedState(isSelected: boolean, isUserInput: boolean, emitEvent: boolean): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipOption, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatChipOption, "mat-basic-chip-option, [mat-basic-chip-option], mat-chip-option, [mat-chip-option]", never, { "selectable": { "alias": "selectable"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; }, { "selectionChange": "selectionChange"; }, never, ["mat-chip-avatar, [matChipAvatar]", "*", "mat-chip-trailing-icon,[matChipRemove],[matChipTrailingIcon]"], true, never>;
-    static ngAcceptInputType_selectable: unknown;
-    static ngAcceptInputType_selected: unknown;
-}
-
+declare const MAT_CHIP_AVATAR: InjectionToken<unknown>;
 /**
- * Directive to remove the parent chip when the trailing icon is clicked or
- * when the ENTER key is pressed on it.
- *
- * Recommended for use with the Material Design "cancel" icon
- * available at https://material.io/icons/#ic_cancel.
- *
- * Example:
- *
- * ```
- * <mat-chip>
- *   <mat-icon matChipRemove>cancel</mat-icon>
- * </mat-chip>
- * ```
+ * Injection token that can be used to reference instances of `MatChipTrailingIcon`. It serves as
+ * alternative token to the actual `MatChipTrailingIcon` class which could cause unnecessary
+ * retention of the class and its directive metadata.
  */
-export declare class MatChipRemove extends MatChipAction {
-    _isPrimary: boolean;
-    _handleClick(event: MouseEvent): void;
-    _handleKeydown(event: KeyboardEvent): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipRemove, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatChipRemove, "[matChipRemove]", never, {}, {}, never, never, true, never>;
-}
-
+declare const MAT_CHIP_TRAILING_ICON: InjectionToken<unknown>;
 /**
- * An extension of the MatChip component used with MatChipGrid and
- * the matChipInputFor directive.
+ * Injection token that can be used to reference instances of `MatChipRemove`. It serves as
+ * alternative token to the actual `MatChipRemove` class which could cause unnecessary
+ * retention of the class and its directive metadata.
  */
-export declare class MatChipRow extends MatChip implements AfterViewInit {
-    protected basicChipAttrName: string;
-    /**
-     * The editing action has to be triggered in a timeout. While we're waiting on it, a blur
-     * event might occur which will interrupt the editing. This flag is used to avoid interruptions
-     * while the editing action is being initialized.
-     */
-    private _editStartPending;
-    editable: boolean;
-    /** Emitted when the chip is edited. */
-    readonly edited: EventEmitter<MatChipEditedEvent>;
-    /** The default chip edit input that is used if none is projected into this chip row. */
-    defaultEditInput?: MatChipEditInput;
-    /** The projected chip edit input. */
-    contentEditInput?: MatChipEditInput;
-    _isEditing: boolean;
-    constructor(...args: unknown[]);
-    _hasTrailingIcon(): boolean;
-    /** Sends focus to the first gridcell when the user clicks anywhere inside the chip. */
-    _handleFocus(): void;
-    _handleKeydown(event: KeyboardEvent): void;
-    _handleDoubleclick(event: MouseEvent): void;
-    private _startEditing;
-    private _onEditFinish;
-    _isRippleDisabled(): boolean;
-    /**
-     * Gets the projected chip edit input, or the default input if none is projected in. One of these
-     * two values is guaranteed to be defined.
-     */
-    private _getEditInput;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipRow, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatChipRow, "mat-chip-row, [mat-chip-row], mat-basic-chip-row, [mat-basic-chip-row]", never, { "editable": { "alias": "editable"; "required": false; }; }, { "edited": "edited"; }, ["contentEditInput"], ["mat-chip-avatar, [matChipAvatar]", "[matChipEditInput]", "*", "mat-chip-trailing-icon,[matChipRemove],[matChipTrailingIcon]"], true, never>;
-}
-
-/** Default options, for the chips module, that can be overridden. */
-export declare interface MatChipsDefaultOptions {
-    /** The list of key codes that will trigger a chipEnd event. */
-    separatorKeyCodes: readonly number[] | ReadonlySet<number>;
-    /** Whether icon indicators should be hidden for single-selection. */
-    hideSingleSelectionIndicator?: boolean;
-}
-
-/** Event object emitted by MatChipOption when selected or deselected. */
-export declare class MatChipSelectionChange {
-    /** Reference to the chip that emitted the event. */
-    source: MatChipOption;
-    /** Whether the chip that emitted the event is selected. */
-    selected: boolean;
-    /** Whether the selection change was a result of a user interaction. */
-    isUserInput: boolean;
-    constructor(
-    /** Reference to the chip that emitted the event. */
-    source: MatChipOption, 
-    /** Whether the chip that emitted the event is selected. */
-    selected: boolean, 
-    /** Whether the selection change was a result of a user interaction. */
-    isUserInput?: boolean);
-}
-
+declare const MAT_CHIP_REMOVE: InjectionToken<unknown>;
 /**
- * Basic container component for the MatChip component.
- *
- * Extended by MatChipListbox and MatChipGrid for different interaction patterns.
+ * Injection token used to avoid a circular dependency between the `MatChip` and `MatChipAction`.
  */
-export declare class MatChipSet implements AfterViewInit, OnDestroy {
-    protected _elementRef: ElementRef<HTMLElement>;
-    protected _changeDetectorRef: ChangeDetectorRef;
-    private _dir;
-    /** Index of the last destroyed chip that had focus. */
-    private _lastDestroyedFocusedChipIndex;
-    /** Used to manage focus within the chip list. */
-    protected _keyManager: FocusKeyManager<MatChipAction>;
-    /** Subject that emits when the component has been destroyed. */
-    protected _destroyed: Subject<void>;
-    /** Role to use if it hasn't been overwritten by the user. */
-    protected _defaultRole: string;
-    /** Combined stream of all of the child chips' focus events. */
-    get chipFocusChanges(): Observable<MatChipEvent>;
-    /** Combined stream of all of the child chips' destroy events. */
-    get chipDestroyedChanges(): Observable<MatChipEvent>;
-    /** Combined stream of all of the child chips' remove events. */
-    get chipRemovedChanges(): Observable<MatChipEvent>;
-    /** Whether the chip set is disabled. */
-    get disabled(): boolean;
-    set disabled(value: boolean);
-    protected _disabled: boolean;
-    /** Whether the chip list contains chips or not. */
-    get empty(): boolean;
-    /** The ARIA role applied to the chip set. */
-    get role(): string | null;
-    /** Tabindex of the chip set. */
-    tabIndex: number;
-    set role(value: string | null);
-    private _explicitRole;
-    /** Whether any of the chips inside of this chip-set has focus. */
-    get focused(): boolean;
-    /** The chips that are part of this chip set. */
-    _chips: QueryList<MatChip>;
-    /** Flat list of all the actions contained within the chips. */
-    _chipActions: QueryList<MatChipAction>;
-    constructor(...args: unknown[]);
-    ngAfterViewInit(): void;
-    ngOnDestroy(): void;
-    /** Checks whether any of the chips is focused. */
-    protected _hasFocusedChip(): boolean;
-    /** Syncs the chip-set's state with the individual chips. */
-    protected _syncChipsState(): void;
-    /** Dummy method for subclasses to override. Base chip set cannot be focused. */
-    focus(): void;
-    /** Handles keyboard events on the chip set. */
-    _handleKeydown(event: KeyboardEvent): void;
-    /**
-     * Utility to ensure all indexes are valid.
-     *
-     * @param index The index to be checked.
-     * @returns True if the index is valid for our list of chips.
-     */
-    protected _isValidIndex(index: number): boolean;
-    /**
-     * Removes the `tabindex` from the chip set and resets it back afterwards, allowing the
-     * user to tab out of it. This prevents the set from capturing focus and redirecting
-     * it back to the first chip, creating a focus trap, if it user tries to tab away.
-     */
-    protected _allowFocusEscape(): void;
-    /**
-     * Gets a stream of events from all the chips within the set.
-     * The stream will automatically incorporate any newly-added chips.
-     */
-    protected _getChipStream<T, C extends MatChip = MatChip>(mappingFunction: (chip: C) => Observable<T>): Observable<T>;
-    /** Checks whether an event comes from inside a chip element. */
-    protected _originatesFromChip(event: Event): boolean;
-    /** Sets up the chip set's focus management logic. */
-    private _setUpFocusManagement;
-    /**
-     * Determines if key manager should avoid putting a given chip action in the tab index. Skip
-     * non-interactive and disabled actions since the user can't do anything with them.
-     */
-    protected _skipPredicate(action: MatChipAction): boolean;
-    /** Listens to changes in the chip set and syncs up the state of the individual chips. */
-    private _trackChipSetChanges;
-    /** Starts tracking the destroyed chips in order to capture the focused one. */
-    private _trackDestroyedFocusedChip;
-    /**
-     * Finds the next appropriate chip to move focus to,
-     * if the currently-focused chip is destroyed.
-     */
-    private _redirectDestroyedChipFocus;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipSet, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatChipSet, "mat-chip-set", never, { "disabled": { "alias": "disabled"; "required": false; }; "role": { "alias": "role"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; }, {}, ["_chips"], ["*"], true, never>;
-    static ngAcceptInputType_disabled: unknown;
-    static ngAcceptInputType_tabIndex: unknown;
-}
-
-export declare class MatChipsModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipsModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<MatChipsModule, never, [typeof i1.MatCommonModule, typeof i1.MatRippleModule, typeof i2.MatChipAction, typeof i3.MatChip, typeof i4.MatChipAvatar, typeof i5.MatChipEditInput, typeof i6.MatChipGrid, typeof i7.MatChipInput, typeof i8.MatChipListbox, typeof i9.MatChipOption, typeof i4.MatChipRemove, typeof i10.MatChipRow, typeof i11.MatChipSet, typeof i4.MatChipTrailingIcon], [typeof i1.MatCommonModule, typeof i3.MatChip, typeof i4.MatChipAvatar, typeof i5.MatChipEditInput, typeof i6.MatChipGrid, typeof i7.MatChipInput, typeof i8.MatChipListbox, typeof i9.MatChipOption, typeof i4.MatChipRemove, typeof i10.MatChipRow, typeof i11.MatChipSet, typeof i4.MatChipTrailingIcon]>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<MatChipsModule>;
-}
-
-
-/** Interface for a text control that is used to drive interaction with a mat-chip-list. */
-export declare interface MatChipTextControl {
-    /** Unique identifier for the text control. */
-    id: string;
-    /** The text control's placeholder text. */
-    placeholder: string;
-    /** Whether the text control has browser focus. */
-    focused: boolean;
-    /** Whether the text control is empty. */
-    empty: boolean;
-    /** Focuses the text control. */
-    focus(): void;
-    /** Sets the list of ids the input is described by. */
-    setDescribedByIds(ids: string[]): void;
-}
-
-/** Non-interactive trailing icon in a chip. */
-export declare class MatChipTrailingIcon extends MatChipAction {
-    /**
-     * MDC considers all trailing actions as a remove icon,
-     * but we support non-interactive trailing icons.
-     */
-    isInteractive: boolean;
-    _isPrimary: boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatChipTrailingIcon, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatChipTrailingIcon, "mat-chip-trailing-icon, [matChipTrailingIcon]", never, {}, {}, never, never, true, never>;
-}
+declare const MAT_CHIP: InjectionToken<unknown>;
 
-export { }
+export { MAT_CHIP, MAT_CHIPS_DEFAULT_OPTIONS, MAT_CHIP_AVATAR, MAT_CHIP_LISTBOX_CONTROL_VALUE_ACCESSOR, MAT_CHIP_REMOVE, MAT_CHIP_TRAILING_ICON, MatChip, MatChipAvatar, MatChipEditInput, MatChipGrid, MatChipGridChange, MatChipInput, MatChipListbox, MatChipListboxChange, MatChipOption, MatChipRemove, MatChipRow, MatChipSelectionChange, MatChipSet, MatChipTrailingIcon, MatChipsModule };
+export type { MatChipEditedEvent, MatChipEvent, MatChipInputEvent, MatChipTextControl, MatChipsDefaultOptions };