@angular/material 14.0.0-next.8 → 14.0.0-rc.1

package/input/index.d.ts

@@ -1,8 +1,211 @@
+import { _AbstractConstructor } from '@angular/material/core';
+import { AfterViewInit } from '@angular/core';
+import { AutofillMonitor } from '@angular/cdk/text-field';
+import { BooleanInput } from '@angular/cdk/coercion';
+import { CanUpdateErrorState } from '@angular/material/core';
+import { _Constructor } from '@angular/material/core';
+import { DoCheck } from '@angular/core';
+import { ElementRef } from '@angular/core';
+import { ErrorStateMatcher } from '@angular/material/core';
+import { FormGroupDirective } from '@angular/forms';
+import * as i0 from '@angular/core';
+import * as i2 from '@angular/cdk/text-field';
+import * as i3 from '@angular/material/form-field';
+import * as i4 from '@angular/material/core';
+import { InjectionToken } from '@angular/core';
+import { MatFormField } from '@angular/material/form-field';
+import { MatFormFieldControl } from '@angular/material/form-field';
+import { NgControl } from '@angular/forms';
+import { NgForm } from '@angular/forms';
+import { NgZone } from '@angular/core';
+import { OnChanges } from '@angular/core';
+import { OnDestroy } from '@angular/core';
+import { Platform } from '@angular/cdk/platform';
+import { Subject } from 'rxjs';
+
+
+/** @docs-private */
+export declare function getMatInputUnsupportedTypeError(type: string): Error;
+
+declare namespace i1 {
+    export {
+        MatInput
+    }
+}
+
 /**
- * @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
+ * This token is used to inject the object whose value should be set into `MatInput`. If none is
+ * provided, the native `HTMLInputElement` is used. Directives like `MatDatepickerInput` can provide
+ * themselves for this token, in order to make `MatInput` delegate the getting and setting of the
+ * value to them.
  */
-export * from './public-api';
+export declare const MAT_INPUT_VALUE_ACCESSOR: InjectionToken<{
+    value: any;
+}>;
+
+/** Directive that allows a native input to work inside a `MatFormField`. */
+export declare class MatInput extends _MatInputBase implements MatFormFieldControl<any>, OnChanges, OnDestroy, AfterViewInit, DoCheck, CanUpdateErrorState {
+    protected _elementRef: ElementRef<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement>;
+    protected _platform: Platform;
+    private _autofillMonitor;
+    private _formField?;
+    protected _uid: string;
+    protected _previousNativeValue: any;
+    private _inputValueAccessor;
+    private _previousPlaceholder;
+    /** Whether the component is being rendered on the server. */
+    readonly _isServer: boolean;
+    /** Whether the component is a native html select. */
+    readonly _isNativeSelect: boolean;
+    /** Whether the component is a textarea. */
+    readonly _isTextarea: boolean;
+    /** Whether the input is inside of a form field. */
+    readonly _isInFormField: boolean;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    focused: boolean;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    readonly stateChanges: Subject<void>;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    controlType: string;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    autofilled: boolean;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    get disabled(): boolean;
+    set disabled(value: BooleanInput);
+    protected _disabled: boolean;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    get id(): string;
+    set id(value: string);
+    protected _id: string;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    placeholder: string;
+    /**
+     * Name of the input.
+     * @docs-private
+     */
+    name: string;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    get required(): boolean;
+    set required(value: BooleanInput);
+    protected _required: boolean | undefined;
+    /** Input type of the element. */
+    get type(): string;
+    set type(value: string);
+    protected _type: string;
+    /** An object used to control when error messages are shown. */
+    errorStateMatcher: ErrorStateMatcher;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    userAriaDescribedBy: string;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    get value(): string;
+    set value(value: any);
+    /** Whether the element is readonly. */
+    get readonly(): boolean;
+    set readonly(value: BooleanInput);
+    private _readonly;
+    protected _neverEmptyInputTypes: string[];
+    constructor(_elementRef: ElementRef<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement>, _platform: Platform, ngControl: NgControl, _parentForm: NgForm, _parentFormGroup: FormGroupDirective, _defaultErrorStateMatcher: ErrorStateMatcher, inputValueAccessor: any, _autofillMonitor: AutofillMonitor, ngZone: NgZone, _formField?: MatFormField | undefined);
+    ngAfterViewInit(): void;
+    ngOnChanges(): void;
+    ngOnDestroy(): void;
+    ngDoCheck(): void;
+    /** Focuses the input. */
+    focus(options?: FocusOptions): void;
+    /** Callback for the cases where the focused state of the input changes. */
+    _focusChanged(isFocused: boolean): void;
+    _onInput(): void;
+    /** Does some manual dirty checking on the native input `placeholder` attribute. */
+    private _dirtyCheckPlaceholder;
+    /** Does some manual dirty checking on the native input `value` property. */
+    protected _dirtyCheckNativeValue(): void;
+    /** Make sure the input is a supported type. */
+    protected _validateType(): void;
+    /** Checks whether the input type is one of the types that are never empty. */
+    protected _isNeverEmpty(): boolean;
+    /** Checks whether the input is invalid based on the native validation. */
+    protected _isBadInput(): boolean;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    get empty(): boolean;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    get shouldLabelFloat(): boolean;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    setDescribedByIds(ids: string[]): void;
+    /**
+     * Implemented as part of MatFormFieldControl.
+     * @docs-private
+     */
+    onContainerClick(): void;
+    /** Whether the form control is a native select that is displayed inline. */
+    _isInlineSelect(): boolean;
+    private _iOSKeyupListener;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatInput, [null, null, { optional: true; self: true; }, { optional: true; }, { optional: true; }, null, { optional: true; self: true; }, null, null, { optional: true; }]>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatInput, "input[matInput], textarea[matInput], select[matNativeControl],      input[matNativeControl], textarea[matNativeControl]", ["matInput"], { "disabled": "disabled"; "id": "id"; "placeholder": "placeholder"; "name": "name"; "required": "required"; "type": "type"; "errorStateMatcher": "errorStateMatcher"; "userAriaDescribedBy": "aria-describedby"; "value": "value"; "readonly": "readonly"; }, {}, never, never, false>;
+}
+
+/** @docs-private */
+declare const _MatInputBase: _Constructor<CanUpdateErrorState> & _AbstractConstructor<CanUpdateErrorState> & {
+    new (_defaultErrorStateMatcher: ErrorStateMatcher, _parentForm: NgForm, _parentFormGroup: FormGroupDirective, ngControl: NgControl): {
+        /**
+         * 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>;
+        _defaultErrorStateMatcher: ErrorStateMatcher;
+        _parentForm: NgForm;
+        _parentFormGroup: FormGroupDirective;
+        /**
+         * Form control bound to the component.
+         * Implemented as part of `MatFormFieldControl`.
+         * @docs-private
+         */
+        ngControl: NgControl;
+    };
+};
+
+export declare class MatInputModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatInputModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatInputModule, [typeof i1.MatInput], [typeof i2.TextFieldModule, typeof i3.MatFormFieldModule, typeof i4.MatCommonModule], [typeof i2.TextFieldModule, typeof i3.MatFormFieldModule, typeof i1.MatInput]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatInputModule>;
+}
+
+export { }

package/input/testing/index.d.ts

@@ -1,8 +1,129 @@
-/**
- * @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 { MatFormFieldControlHarness } from '@angular/material/form-field/testing/control';
+
+/** A set of criteria that can be used to filter a list of `MatInputHarness` instances. */
+export declare interface InputHarnessFilters extends BaseHarnessFilters {
+    /** Filters based on the value of the input. */
+    value?: string | RegExp;
+    /** Filters based on the placeholder text of the input. */
+    placeholder?: string | RegExp;
+}
+
+/** Harness for interacting with a standard Material inputs in tests. */
+export declare class MatInputHarness extends MatFormFieldControlHarness {
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a `MatInputHarness` that meets
+     * certain criteria.
+     * @param options Options for filtering which input instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with(options?: InputHarnessFilters): HarnessPredicate<MatInputHarness>;
+    /** Whether the input is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Whether the input is required. */
+    isRequired(): Promise<boolean>;
+    /** Whether the input is readonly. */
+    isReadonly(): Promise<boolean>;
+    /** Gets the value of the input. */
+    getValue(): Promise<string>;
+    /** Gets the name of the input. */
+    getName(): Promise<string>;
+    /**
+     * Gets the type of the input. Returns "textarea" if the input is
+     * a textarea.
+     */
+    getType(): Promise<string>;
+    /** Gets the placeholder of the input. */
+    getPlaceholder(): Promise<string>;
+    /** Gets the id of the input. */
+    getId(): Promise<string>;
+    /**
+     * Focuses the input and returns a promise that indicates when the
+     * action is complete.
+     */
+    focus(): Promise<void>;
+    /**
+     * Blurs the input and returns a promise that indicates when the
+     * action is complete.
+     */
+    blur(): Promise<void>;
+    /** Whether the input is focused. */
+    isFocused(): Promise<boolean>;
+    /**
+     * Sets the value of the input. The value will be set by simulating
+     * keypresses that correspond to the given value.
+     */
+    setValue(newValue: string): Promise<void>;
+}
+
+/** Harness for interacting with a native `option` in tests. */
+export declare class MatNativeOptionHarness extends ComponentHarness {
+    /** Selector used to locate option instances. */
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a `MatNativeOptionHarness` that meets
+     * certain criteria.
+     * @param options Options for filtering which option instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with(options?: NativeOptionHarnessFilters): HarnessPredicate<MatNativeOptionHarness>;
+    /** Gets the option's label text. */
+    getText(): Promise<string>;
+    /** Index of the option within the native `select` element. */
+    getIndex(): Promise<number>;
+    /** Gets whether the option is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Gets whether the option is selected. */
+    isSelected(): Promise<boolean>;
+}
+
+/** Harness for interacting with a native `select` in tests. */
+export declare class MatNativeSelectHarness extends MatFormFieldControlHarness {
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a `MatNativeSelectHarness` that meets
+     * certain criteria.
+     * @param options Options for filtering which select instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with(options?: NativeSelectHarnessFilters): HarnessPredicate<MatNativeSelectHarness>;
+    /** Gets a boolean promise indicating if the select is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Gets a boolean promise indicating if the select is required. */
+    isRequired(): Promise<boolean>;
+    /** Gets a boolean promise indicating if the select is in multi-selection mode. */
+    isMultiple(): Promise<boolean>;
+    /** Gets the name of the select. */
+    getName(): Promise<string>;
+    /** Gets the id of the select. */
+    getId(): Promise<string>;
+    /** Focuses the select and returns a void promise that indicates when the action is complete. */
+    focus(): Promise<void>;
+    /** Blurs the select and returns a void promise that indicates when the action is complete. */
+    blur(): Promise<void>;
+    /** Whether the select is focused. */
+    isFocused(): Promise<boolean>;
+    /** Gets the options inside the select panel. */
+    getOptions(filter?: NativeOptionHarnessFilters): Promise<MatNativeOptionHarness[]>;
+    /**
+     * Selects the options that match the passed-in filter. If the select is in multi-selection
+     * mode all options will be clicked, otherwise the harness will pick the first matching option.
+     */
+    selectOptions(filter?: NativeOptionHarnessFilters): Promise<void>;
+}
+
+/** A set of criteria that can be used to filter a list of `MatNativeOptionHarness` instances. */
+export declare interface NativeOptionHarnessFilters extends BaseHarnessFilters {
+    text?: string | RegExp;
+    index?: number;
+    isSelected?: boolean;
+}
+
+/** A set of criteria that can be used to filter a list of `MatNativeSelectHarness` instances. */
+export declare interface NativeSelectHarnessFilters extends BaseHarnessFilters {
+}
+
+export { }