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

package/progress-spinner/testing/index.d.ts

@@ -1,8 +1,27 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-export * from './public-api';
+import { BaseHarnessFilters } from '@angular/cdk/testing';
+import { ComponentHarness } from '@angular/cdk/testing';
+import { HarnessPredicate } from '@angular/cdk/testing';
+import { ProgressSpinnerMode } from '@angular/material/progress-spinner';
+
+/** Harness for interacting with a standard mat-progress-spinner in tests. */
+export declare class MatProgressSpinnerHarness extends ComponentHarness {
+    /** The selector for the host element of a `MatProgressSpinner` instance. */
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a `MatProgressSpinnerHarness` that
+     * meets certain criteria.
+     * @param options Options for filtering which progress spinner instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with(options?: ProgressSpinnerHarnessFilters): HarnessPredicate<MatProgressSpinnerHarness>;
+    /** Gets the progress spinner's value. */
+    getValue(): Promise<number | null>;
+    /** Gets the progress spinner's mode. */
+    getMode(): Promise<ProgressSpinnerMode>;
+}
+
+/** A set of criteria that can be used to filter a list of `MatProgressSpinnerHarness` instances. */
+export declare interface ProgressSpinnerHarnessFilters extends BaseHarnessFilters {
+}
+
+export { }

package/radio/index.d.ts

@@ -1,8 +1,307 @@
+import { _AbstractConstructor } from '@angular/material/core';
+import { AfterContentInit } from '@angular/core';
+import { AfterViewInit } from '@angular/core';
+import { BooleanInput } from '@angular/cdk/coercion';
+import { CanDisableRipple } from '@angular/material/core';
+import { ChangeDetectorRef } from '@angular/core';
+import { _Constructor } from '@angular/material/core';
+import { ControlValueAccessor } from '@angular/forms';
+import { DoCheck } from '@angular/core';
+import { ElementRef } from '@angular/core';
+import { EventEmitter } from '@angular/core';
+import { FocusMonitor } from '@angular/cdk/a11y';
+import { FocusOrigin } from '@angular/cdk/a11y';
+import { HasTabIndex } from '@angular/material/core';
+import * as i0 from '@angular/core';
+import * as i2 from '@angular/material/core';
+import { InjectionToken } from '@angular/core';
+import { OnDestroy } from '@angular/core';
+import { OnInit } from '@angular/core';
+import { QueryList } from '@angular/core';
+import { ThemePalette } from '@angular/material/core';
+import { UniqueSelectionDispatcher } from '@angular/cdk/collections';
+
+declare namespace i1 {
+    export {
+        MAT_RADIO_DEFAULT_OPTIONS_FACTORY,
+        MatRadioDefaultOptions,
+        MAT_RADIO_DEFAULT_OPTIONS,
+        MAT_RADIO_GROUP_CONTROL_VALUE_ACCESSOR,
+        MatRadioChange,
+        MAT_RADIO_GROUP,
+        _MatRadioGroupBase,
+        MatRadioGroup,
+        _MatRadioButtonBase,
+        MatRadioButton
+    }
+}
+
+export declare const MAT_RADIO_DEFAULT_OPTIONS: InjectionToken<MatRadioDefaultOptions>;
+
+export declare function MAT_RADIO_DEFAULT_OPTIONS_FACTORY(): MatRadioDefaultOptions;
+
 /**
- * @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
+ * Injection token that can be used to inject instances of `MatRadioGroup`. It serves as
+ * alternative token to the actual `MatRadioGroup` class which could cause unnecessary
+ * retention of the class and its component metadata.
  */
-export * from './public-api';
+export declare const MAT_RADIO_GROUP: InjectionToken<_MatRadioGroupBase<_MatRadioButtonBase>>;
+
+/**
+ * Provider Expression that allows mat-radio-group to register as a ControlValueAccessor. This
+ * allows it to support [(ngModel)] and ngControl.
+ * @docs-private
+ */
+export declare const MAT_RADIO_GROUP_CONTROL_VALUE_ACCESSOR: any;
+
+/**
+ * A Material design radio-button. Typically placed inside of `<mat-radio-group>` elements.
+ */
+export declare class MatRadioButton extends _MatRadioButtonBase {
+    constructor(radioGroup: MatRadioGroup, elementRef: ElementRef, changeDetector: ChangeDetectorRef, focusMonitor: FocusMonitor, radioDispatcher: UniqueSelectionDispatcher, animationMode?: string, providerOverride?: MatRadioDefaultOptions, tabIndex?: string);
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatRadioButton, [{ optional: true; }, null, null, null, null, { optional: true; }, { optional: true; }, { attribute: "tabindex"; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatRadioButton, "mat-radio-button", ["matRadioButton"], { "disableRipple": "disableRipple"; "tabIndex": "tabIndex"; }, {}, never, ["*"], false>;
+}
+
+/** @docs-private */
+declare abstract class MatRadioButtonBase {
+    _elementRef: ElementRef;
+    abstract disabled: boolean;
+    constructor(_elementRef: ElementRef);
+}
+
+/**
+ * Base class with all of the `MatRadioButton` functionality.
+ * @docs-private
+ */
+export declare abstract class _MatRadioButtonBase extends _MatRadioButtonMixinBase implements OnInit, AfterViewInit, DoCheck, OnDestroy, CanDisableRipple, HasTabIndex {
+    protected _changeDetector: ChangeDetectorRef;
+    private _focusMonitor;
+    private _radioDispatcher;
+    private _providerOverride?;
+    private _uniqueId;
+    /** The unique ID for the radio button. */
+    id: string;
+    /** Analog to HTML 'name' attribute used to group radios for unique selection. */
+    name: string;
+    /** Used to set the 'aria-label' attribute on the underlying input element. */
+    ariaLabel: string;
+    /** The 'aria-labelledby' attribute takes precedence as the element's text alternative. */
+    ariaLabelledby: string;
+    /** The 'aria-describedby' attribute is read after the element's label and field type. */
+    ariaDescribedby: string;
+    /** Whether this radio button is checked. */
+    get checked(): boolean;
+    set checked(value: BooleanInput);
+    /** The value of this radio button. */
+    get value(): any;
+    set value(value: any);
+    /** Whether the label should appear after or before the radio button. Defaults to 'after' */
+    get labelPosition(): 'before' | 'after';
+    set labelPosition(value: 'before' | 'after');
+    private _labelPosition;
+    /** Whether the radio button is disabled. */
+    get disabled(): boolean;
+    set disabled(value: BooleanInput);
+    /** Whether the radio button is required. */
+    get required(): boolean;
+    set required(value: BooleanInput);
+    /** Theme color of the radio button. */
+    get color(): ThemePalette;
+    set color(newValue: ThemePalette);
+    private _color;
+    /**
+     * Event emitted when the checked state of this radio button changes.
+     * Change events are only emitted when the value changes due to user interaction with
+     * the radio button (the same behavior as `<input type-"radio">`).
+     */
+    readonly change: EventEmitter<MatRadioChange>;
+    /** The parent radio group. May or may not be present. */
+    radioGroup: _MatRadioGroupBase<_MatRadioButtonBase>;
+    /** ID of the native input element inside `<mat-radio-button>` */
+    get inputId(): string;
+    /** Whether this radio is checked. */
+    private _checked;
+    /** Whether this radio is disabled. */
+    private _disabled;
+    /** Whether this radio is required. */
+    private _required;
+    /** Value assigned to this radio. */
+    private _value;
+    /** Unregister function for _radioDispatcher */
+    private _removeUniqueSelectionListener;
+    /** Previous value of the input's tabindex. */
+    private _previousTabIndex;
+    /** The native `<input type=radio>` element */
+    _inputElement: ElementRef<HTMLInputElement>;
+    /** Whether animations are disabled. */
+    _noopAnimations: boolean;
+    constructor(radioGroup: _MatRadioGroupBase<_MatRadioButtonBase>, elementRef: ElementRef, _changeDetector: ChangeDetectorRef, _focusMonitor: FocusMonitor, _radioDispatcher: UniqueSelectionDispatcher, animationMode?: string, _providerOverride?: MatRadioDefaultOptions | undefined, tabIndex?: string);
+    /** Focuses the radio button. */
+    focus(options?: FocusOptions, origin?: FocusOrigin): void;
+    /**
+     * Marks the radio button as needing checking for change detection.
+     * This method is exposed because the parent radio group will directly
+     * update bound properties of the radio button.
+     */
+    _markForCheck(): void;
+    ngOnInit(): void;
+    ngDoCheck(): void;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    /** Dispatch change event with current value. */
+    private _emitChangeEvent;
+    _isRippleDisabled(): boolean;
+    _onInputClick(event: Event): void;
+    /** Triggered when the radio button receives an interaction from the user. */
+    _onInputInteraction(event: Event): void;
+    /** Sets the disabled state and marks for check if a change occurred. */
+    protected _setDisabled(value: boolean): void;
+    /** Gets the tabindex for the underlying input element. */
+    private _updateTabIndex;
+    static ɵfac: i0.ɵɵFactoryDeclaration<_MatRadioButtonBase, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<_MatRadioButtonBase, never, never, { "id": "id"; "name": "name"; "ariaLabel": "aria-label"; "ariaLabelledby": "aria-labelledby"; "ariaDescribedby": "aria-describedby"; "checked": "checked"; "value": "value"; "labelPosition": "labelPosition"; "disabled": "disabled"; "required": "required"; "color": "color"; }, { "change": "change"; }, never, never, false>;
+}
+
+declare const _MatRadioButtonMixinBase: _Constructor<CanDisableRipple> & _AbstractConstructor<CanDisableRipple> & _Constructor<HasTabIndex> & _AbstractConstructor<HasTabIndex> & typeof MatRadioButtonBase;
+
+/** Change event object emitted by MatRadio and MatRadioGroup. */
+export declare class MatRadioChange {
+    /** The MatRadioButton that emits the change event. */
+    source: _MatRadioButtonBase;
+    /** The value of the MatRadioButton. */
+    value: any;
+    constructor(
+    /** The MatRadioButton that emits the change event. */
+    source: _MatRadioButtonBase, 
+    /** The value of the MatRadioButton. */
+    value: any);
+}
+
+export declare interface MatRadioDefaultOptions {
+    color: ThemePalette;
+}
+
+/**
+ * A group of radio buttons. May contain one or more `<mat-radio-button>` elements.
+ */
+export declare class MatRadioGroup extends _MatRadioGroupBase<MatRadioButton> {
+    _radios: QueryList<MatRadioButton>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatRadioGroup, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatRadioGroup, "mat-radio-group", ["matRadioGroup"], {}, {}, ["_radios"], never, false>;
+}
+
+/**
+ * Base class with all of the `MatRadioGroup` functionality.
+ * @docs-private
+ */
+export declare abstract class _MatRadioGroupBase<T extends _MatRadioButtonBase> implements AfterContentInit, ControlValueAccessor {
+    private _changeDetector;
+    /** Selected value for the radio group. */
+    private _value;
+    /** The HTML name attribute applied to radio buttons in this group. */
+    private _name;
+    /** The currently selected radio button. Should match value. */
+    private _selected;
+    /** Whether the `value` has been set to its initial value. */
+    private _isInitialized;
+    /** Whether the labels should appear after or before the radio-buttons. Defaults to 'after' */
+    private _labelPosition;
+    /** Whether the radio group is disabled. */
+    private _disabled;
+    /** Whether the radio group is required. */
+    private _required;
+    /** The method to be called in order to update ngModel */
+    _controlValueAccessorChangeFn: (value: any) => void;
+    /**
+     * onTouch function registered via registerOnTouch (ControlValueAccessor).
+     * @docs-private
+     */
+    onTouched: () => any;
+    /**
+     * Event emitted when the group value changes.
+     * Change events are only emitted when the value changes due to user interaction with
+     * a radio button (the same behavior as `<input type-"radio">`).
+     */
+    readonly change: EventEmitter<MatRadioChange>;
+    /** Child radio buttons. */
+    abstract _radios: QueryList<T>;
+    /** Theme color for all of the radio buttons in the group. */
+    color: ThemePalette;
+    /** Name of the radio button group. All radio buttons inside this group will use this name. */
+    get name(): string;
+    set name(value: string);
+    /** Whether the labels should appear after or before the radio-buttons. Defaults to 'after' */
+    get labelPosition(): 'before' | 'after';
+    set labelPosition(v: 'before' | 'after');
+    /**
+     * Value for the radio-group. Should equal the value of the selected radio button if there is
+     * a corresponding radio button with a matching value. If there is not such a corresponding
+     * radio button, this value persists to be applied in case a new radio button is added with a
+     * matching value.
+     */
+    get value(): any;
+    set value(newValue: any);
+    _checkSelectedRadioButton(): void;
+    /**
+     * The currently selected radio button. If set to a new radio button, the radio group value
+     * will be updated to match the new selected button.
+     */
+    get selected(): T | null;
+    set selected(selected: T | null);
+    /** Whether the radio group is disabled */
+    get disabled(): boolean;
+    set disabled(value: BooleanInput);
+    /** Whether the radio group is required */
+    get required(): boolean;
+    set required(value: BooleanInput);
+    constructor(_changeDetector: ChangeDetectorRef);
+    /**
+     * Initialize properties once content children are available.
+     * This allows us to propagate relevant attributes to associated buttons.
+     */
+    ngAfterContentInit(): void;
+    /**
+     * Mark this group as being "touched" (for ngModel). Meant to be called by the contained
+     * radio buttons upon their blur.
+     */
+    _touch(): void;
+    private _updateRadioButtonNames;
+    /** Updates the `selected` radio button from the internal _value state. */
+    private _updateSelectedRadioFromValue;
+    /** Dispatch change event with current selection and group value. */
+    _emitChangeEvent(): void;
+    _markRadiosForCheck(): void;
+    /**
+     * Sets the model value. Implemented as part of ControlValueAccessor.
+     * @param value
+     */
+    writeValue(value: any): void;
+    /**
+     * Registers a callback to be triggered when the model value changes.
+     * Implemented as part of ControlValueAccessor.
+     * @param fn Callback to be registered.
+     */
+    registerOnChange(fn: (value: any) => void): void;
+    /**
+     * Registers a callback to be triggered when the control is touched.
+     * Implemented as part of ControlValueAccessor.
+     * @param fn Callback to be registered.
+     */
+    registerOnTouched(fn: any): void;
+    /**
+     * Sets the disabled state of the control. Implemented as a part of ControlValueAccessor.
+     * @param isDisabled Whether the control should be disabled.
+     */
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<_MatRadioGroupBase<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<_MatRadioGroupBase<any>, never, never, { "color": "color"; "name": "name"; "labelPosition": "labelPosition"; "value": "value"; "selected": "selected"; "disabled": "disabled"; "required": "required"; }, { "change": "change"; }, never, never, false>;
+}
+
+export declare class MatRadioModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatRadioModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatRadioModule, [typeof i1.MatRadioGroup, typeof i1.MatRadioButton], [typeof i2.MatRippleModule, typeof i2.MatCommonModule], [typeof i1.MatRadioGroup, typeof i1.MatRadioButton, typeof i2.MatCommonModule]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatRadioModule>;
+}
+
+export { }

package/radio/testing/index.d.ts

@@ -1,8 +1,130 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-export * from './public-api';
+import { AsyncFactoryFn } from '@angular/cdk/testing';
+import { BaseHarnessFilters } from '@angular/cdk/testing';
+import { ComponentHarness } from '@angular/cdk/testing';
+import { ComponentHarnessConstructor } from '@angular/cdk/testing';
+import { HarnessPredicate } from '@angular/cdk/testing';
+import { TestElement } from '@angular/cdk/testing';
+
+/** Harness for interacting with a standard mat-radio-button in tests. */
+export declare class MatRadioButtonHarness extends _MatRadioButtonHarnessBase {
+    /** The selector for the host element of a `MatRadioButton` instance. */
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a `MatRadioButtonHarness` that meets
+     * certain criteria.
+     * @param options Options for filtering which radio button instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with(options?: RadioButtonHarnessFilters): HarnessPredicate<MatRadioButtonHarness>;
+    protected _textLabel: AsyncFactoryFn<TestElement>;
+    protected _clickLabel: AsyncFactoryFn<TestElement>;
+}
+
+export declare abstract class _MatRadioButtonHarnessBase extends ComponentHarness {
+    protected abstract _textLabel: AsyncFactoryFn<TestElement>;
+    protected abstract _clickLabel: AsyncFactoryFn<TestElement>;
+    private _input;
+    /** Whether the radio-button is checked. */
+    isChecked(): Promise<boolean>;
+    /** Whether the radio-button is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Whether the radio-button is required. */
+    isRequired(): Promise<boolean>;
+    /** Gets the radio-button's name. */
+    getName(): Promise<string | null>;
+    /** Gets the radio-button's id. */
+    getId(): Promise<string | null>;
+    /**
+     * Gets the value of the radio-button. The radio-button value will be converted to a string.
+     *
+     * Note: This means that for radio-button's with an object as a value `[object Object]` is
+     * intentionally returned.
+     */
+    getValue(): Promise<string | null>;
+    /** Gets the radio-button's label text. */
+    getLabelText(): Promise<string>;
+    /** Focuses the radio-button. */
+    focus(): Promise<void>;
+    /** Blurs the radio-button. */
+    blur(): Promise<void>;
+    /** Whether the radio-button is focused. */
+    isFocused(): Promise<boolean>;
+    /**
+     * Puts the radio-button in a checked state by clicking it if it is currently unchecked,
+     * or doing nothing if it is already checked.
+     */
+    check(): Promise<void>;
+}
+
+/** Harness for interacting with a standard mat-radio-group in tests. */
+export declare class MatRadioGroupHarness extends _MatRadioGroupHarnessBase<typeof MatRadioButtonHarness, MatRadioButtonHarness, RadioButtonHarnessFilters> {
+    /** The selector for the host element of a `MatRadioGroup` instance. */
+    static hostSelector: string;
+    protected _buttonClass: typeof MatRadioButtonHarness;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a `MatRadioGroupHarness` that meets
+     * certain criteria.
+     * @param options Options for filtering which radio group instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with(options?: RadioGroupHarnessFilters): HarnessPredicate<MatRadioGroupHarness>;
+}
+
+export declare abstract class _MatRadioGroupHarnessBase<ButtonType extends ComponentHarnessConstructor<Button> & {
+    with: (options?: ButtonFilters) => HarnessPredicate<Button>;
+}, Button extends ComponentHarness & {
+    isChecked(): Promise<boolean>;
+    getValue(): Promise<string | null>;
+    getName(): Promise<string | null>;
+    check(): Promise<void>;
+}, ButtonFilters extends BaseHarnessFilters> extends ComponentHarness {
+    protected abstract _buttonClass: ButtonType;
+    /** Gets the name of the radio-group. */
+    getName(): Promise<string | null>;
+    /** Gets the id of the radio-group. */
+    getId(): Promise<string | null>;
+    /** Gets the checked radio-button in a radio-group. */
+    getCheckedRadioButton(): Promise<Button | null>;
+    /** Gets the checked value of the radio-group. */
+    getCheckedValue(): Promise<string | null>;
+    /**
+     * Gets a list of radio buttons which are part of the radio-group.
+     * @param filter Optionally filters which radio buttons are included.
+     */
+    getRadioButtons(filter?: ButtonFilters): Promise<Button[]>;
+    /**
+     * Checks a radio button in this group.
+     * @param filter An optional filter to apply to the child radio buttons. The first tab matching
+     *     the filter will be selected.
+     */
+    checkRadioButton(filter?: ButtonFilters): Promise<void>;
+    /** Gets the name attribute of the host element. */
+    private _getGroupNameFromHost;
+    /** Gets a list of the name attributes of all child radio buttons. */
+    private _getNamesFromRadioButtons;
+    /** Checks if the specified radio names are all equal. */
+    private _checkRadioNamesInGroupEqual;
+    /**
+     * Checks if a radio-group harness has the given name. Throws if a radio-group with
+     * matching name could be found but has mismatching radio-button names.
+     */
+    protected static _checkRadioGroupName(harness: _MatRadioGroupHarnessBase<any, any, any>, name: string): Promise<boolean>;
+}
+
+/** A set of criteria that can be used to filter a list of `MatRadioButtonHarness` instances. */
+export declare interface RadioButtonHarnessFilters extends BaseHarnessFilters {
+    /** Only find instances whose label matches the given value. */
+    label?: string | RegExp;
+    /** Only find instances whose name attribute is the given value. */
+    name?: string;
+    /** Only find instances with the given checked value. */
+    checked?: boolean;
+}
+
+/** A set of criteria that can be used to filter a list of `MatRadioGroupHarness` instances. */
+export declare interface RadioGroupHarnessFilters extends BaseHarnessFilters {
+    /** Only find instances whose name attribute is the given value. */
+    name?: string;
+}
+
+export { }

package/schematics/ng-add/index.js

@@ -18,7 +18,7 @@ const package_config_1 = require("./package-config");
  * Note that the fallback version range does not use caret, but tilde because that is
  * the default for Angular framework dependencies in CLI projects.
  */
-const fallbackMaterialVersionRange = `~14.0.0-next.12`;
+const fallbackMaterialVersionRange = `~14.0.0-next.13`;
 /**
  * Schematic factory entry-point for the `ng-add` schematic. The ng-add schematic will be
  * automatically executed if developers run `ng add @angular/material`.

package/schematics/ng-add/index.mjs

@@ -18,7 +18,7 @@ const package_config_1 = require("./package-config");
  * Note that the fallback version range does not use caret, but tilde because that is
  * the default for Angular framework dependencies in CLI projects.
  */
-const fallbackMaterialVersionRange = `~14.0.0-next.12`;
+const fallbackMaterialVersionRange = `~14.0.0-next.13`;
 /**
  * Schematic factory entry-point for the `ng-add` schematic. The ng-add schematic will be
  * automatically executed if developers run `ng add @angular/material`.