@angular/cdk 14.0.0-next.9 → 14.0.0-rc.0

package/testing/selenium-webdriver/index.d.ts

@@ -1,8 +1,134 @@
-/**
- * @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 { ElementDimensions } from '@angular/cdk/testing';
+import { EventData } from '@angular/cdk/testing';
+import { HarnessEnvironment } from '@angular/cdk/testing';
+import { HarnessLoader } from '@angular/cdk/testing';
+import { ModifierKeys } from '@angular/cdk/testing';
+import { TestElement } from '@angular/cdk/testing';
+import { TestKey } from '@angular/cdk/testing';
+import { TextOptions } from '@angular/cdk/testing';
+import * as webdriver from 'selenium-webdriver';
+
+/** A `TestElement` implementation for WebDriver. */
+export declare class SeleniumWebDriverElement implements TestElement {
+    readonly element: () => webdriver.WebElement;
+    private _stabilize;
+    constructor(element: () => webdriver.WebElement, _stabilize: () => Promise<void>);
+    /** Blur the element. */
+    blur(): Promise<void>;
+    /** Clear the element's input (for input and textarea elements only). */
+    clear(): Promise<void>;
+    /**
+     * Click the element at the default location for the current environment. If you need to guarantee
+     * the element is clicked at a specific location, consider using `click('center')` or
+     * `click(x, y)` instead.
+     */
+    click(modifiers?: ModifierKeys): Promise<void>;
+    /** Click the element at the element's center. */
+    click(location: 'center', modifiers?: ModifierKeys): Promise<void>;
+    /**
+     * Click the element at the specified coordinates relative to the top-left of the element.
+     * @param relativeX Coordinate within the element, along the X-axis at which to click.
+     * @param relativeY Coordinate within the element, along the Y-axis at which to click.
+     * @param modifiers Modifier keys held while clicking
+     */
+    click(relativeX: number, relativeY: number, modifiers?: ModifierKeys): Promise<void>;
+    /**
+     * Right clicks on the element at the specified coordinates relative to the top-left of it.
+     * @param relativeX Coordinate within the element, along the X-axis at which to click.
+     * @param relativeY Coordinate within the element, along the Y-axis at which to click.
+     * @param modifiers Modifier keys held while clicking
+     */
+    rightClick(relativeX: number, relativeY: number, modifiers?: ModifierKeys): Promise<void>;
+    /** Focus the element. */
+    focus(): Promise<void>;
+    /** Get the computed value of the given CSS property for the element. */
+    getCssValue(property: string): Promise<string>;
+    /** Hovers the mouse over the element. */
+    hover(): Promise<void>;
+    /** Moves the mouse away from the element. */
+    mouseAway(): Promise<void>;
+    /**
+     * Sends the given string to the input as a series of key presses. Also fires input events
+     * and attempts to add the string to the Element's value.
+     */
+    sendKeys(...keys: (string | TestKey)[]): Promise<void>;
+    /**
+     * Sends the given string to the input as a series of key presses. Also fires input events
+     * and attempts to add the string to the Element's value.
+     */
+    sendKeys(modifiers: ModifierKeys, ...keys: (string | TestKey)[]): Promise<void>;
+    /**
+     * Gets the text from the element.
+     * @param options Options that affect what text is included.
+     */
+    text(options?: TextOptions): Promise<string>;
+    /** Gets the value for the given attribute from the element. */
+    getAttribute(name: string): Promise<string | null>;
+    /** Checks whether the element has the given class. */
+    hasClass(name: string): Promise<boolean>;
+    /** Gets the dimensions of the element. */
+    getDimensions(): Promise<ElementDimensions>;
+    /** Gets the value of a property of an element. */
+    getProperty<T = any>(name: string): Promise<T>;
+    /** Sets the value of a property of an input. */
+    setInputValue(newValue: string): Promise<void>;
+    /** Selects the options at the specified indexes inside of a native `select` element. */
+    selectOptions(...optionIndexes: number[]): Promise<void>;
+    /** Checks whether this element matches the given selector. */
+    matchesSelector(selector: string): Promise<boolean>;
+    /** Checks whether the element is focused. */
+    isFocused(): Promise<boolean>;
+    /**
+     * Dispatches an event with a particular name.
+     * @param name Name of the event to be dispatched.
+     */
+    dispatchEvent(name: string, data?: Record<string, EventData>): Promise<void>;
+    /** Gets the webdriver action sequence. */
+    private _actions;
+    /** Executes a function in the browser. */
+    private _executeScript;
+    /** Dispatches all the events that are part of a click event sequence. */
+    private _dispatchClickEventSequence;
+}
+
+/** A `HarnessEnvironment` implementation for WebDriver. */
+export declare class SeleniumWebDriverHarnessEnvironment extends HarnessEnvironment<() => webdriver.WebElement> {
+    /** The options for this environment. */
+    private _options;
+    /** Environment stabilization callback passed to the created test elements. */
+    private _stabilizeCallback;
+    protected constructor(rawRootElement: () => webdriver.WebElement, options?: WebDriverHarnessEnvironmentOptions);
+    /** Gets the ElementFinder corresponding to the given TestElement. */
+    static getNativeElement(el: TestElement): webdriver.WebElement;
+    /** Creates a `HarnessLoader` rooted at the document root. */
+    static loader(driver: webdriver.WebDriver, options?: WebDriverHarnessEnvironmentOptions): HarnessLoader;
+    /**
+     * Flushes change detection and async tasks captured in the Angular zone.
+     * In most cases it should not be necessary to call this manually. However, there may be some edge
+     * cases where it is needed to fully flush animation events.
+     */
+    forceStabilize(): Promise<void>;
+    /** @docs-private */
+    waitForTasksOutsideAngular(): Promise<void>;
+    /** Gets the root element for the document. */
+    protected getDocumentRoot(): () => webdriver.WebElement;
+    /** Creates a `TestElement` from a raw element. */
+    protected createTestElement(element: () => webdriver.WebElement): TestElement;
+    /** Creates a `HarnessLoader` rooted at the given raw element. */
+    protected createEnvironment(element: () => webdriver.WebElement): HarnessEnvironment<() => webdriver.WebElement>;
+    /**
+     * Gets a list of all elements matching the given selector under this environment's root element.
+     */
+    protected getAllRawElements(selector: string): Promise<(() => webdriver.WebElement)[]>;
+}
+
+/** Waits for angular to be ready after the page load. */
+export declare function waitForAngularReady(wd: webdriver.WebDriver): Promise<void>;
+
+/** Options to configure the environment. */
+export declare interface WebDriverHarnessEnvironmentOptions {
+    /** The query function used to find DOM elements. */
+    queryFn: (selector: string, root: () => webdriver.WebElement) => Promise<webdriver.WebElement[]>;
+}
+
+export { }

package/testing/testbed/index.d.ts

@@ -1,8 +1,161 @@
-/**
- * @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 { ComponentFixture } from '@angular/core/testing';
+import { ComponentHarness } from '@angular/cdk/testing';
+import { ComponentHarnessConstructor } from '@angular/cdk/testing';
+import { ElementDimensions } from '@angular/cdk/testing';
+import { EventData } from '@angular/cdk/testing';
+import { HarnessEnvironment } from '@angular/cdk/testing';
+import { HarnessLoader } from '@angular/cdk/testing';
+import { ModifierKeys } from '@angular/cdk/testing';
+import { TestElement } from '@angular/cdk/testing';
+import { TestKey } from '@angular/cdk/testing';
+import { TextOptions } from '@angular/cdk/testing';
+
+/** A `HarnessEnvironment` implementation for Angular's Testbed. */
+export declare class TestbedHarnessEnvironment extends HarnessEnvironment<Element> {
+    private _fixture;
+    /** Whether the environment has been destroyed. */
+    private _destroyed;
+    /** Observable that emits whenever the test task state changes. */
+    private _taskState;
+    /** The options for this environment. */
+    private _options;
+    /** Environment stabilization callback passed to the created test elements. */
+    private _stabilizeCallback;
+    protected constructor(rawRootElement: Element, _fixture: ComponentFixture<unknown>, options?: TestbedHarnessEnvironmentOptions);
+    /** Creates a `HarnessLoader` rooted at the given fixture's root element. */
+    static loader(fixture: ComponentFixture<unknown>, options?: TestbedHarnessEnvironmentOptions): HarnessLoader;
+    /**
+     * Creates a `HarnessLoader` at the document root. This can be used if harnesses are
+     * located outside of a fixture (e.g. overlays appended to the document body).
+     */
+    static documentRootLoader(fixture: ComponentFixture<unknown>, options?: TestbedHarnessEnvironmentOptions): HarnessLoader;
+    /** Gets the native DOM element corresponding to the given TestElement. */
+    static getNativeElement(el: TestElement): Element;
+    /**
+     * Creates an instance of the given harness type, using the fixture's root element as the
+     * harness's host element. This method should be used when creating a harness for the root element
+     * of a fixture, as components do not have the correct selector when they are created as the root
+     * of the fixture.
+     */
+    static harnessForFixture<T extends ComponentHarness>(fixture: ComponentFixture<unknown>, harnessType: ComponentHarnessConstructor<T>, options?: TestbedHarnessEnvironmentOptions): Promise<T>;
+    /**
+     * Flushes change detection and async tasks captured in the Angular zone.
+     * In most cases it should not be necessary to call this manually. However, there may be some edge
+     * cases where it is needed to fully flush animation events.
+     */
+    forceStabilize(): Promise<void>;
+    /**
+     * Waits for all scheduled or running async tasks to complete. This allows harness
+     * authors to wait for async tasks outside of the Angular zone.
+     */
+    waitForTasksOutsideAngular(): Promise<void>;
+    /** Gets the root element for the document. */
+    protected getDocumentRoot(): Element;
+    /** Creates a `TestElement` from a raw element. */
+    protected createTestElement(element: Element): TestElement;
+    /** Creates a `HarnessLoader` rooted at the given raw element. */
+    protected createEnvironment(element: Element): HarnessEnvironment<Element>;
+    /**
+     * Gets a list of all elements matching the given selector under this environment's root element.
+     */
+    protected getAllRawElements(selector: string): Promise<Element[]>;
+}
+
+/** Options to configure the environment. */
+export declare interface TestbedHarnessEnvironmentOptions {
+    /** The query function used to find DOM elements. */
+    queryFn: (selector: string, root: Element) => Iterable<Element> | ArrayLike<Element>;
+}
+
+/** A `TestElement` implementation for unit tests. */
+export declare class UnitTestElement implements TestElement {
+    readonly element: Element;
+    private _stabilize;
+    constructor(element: Element, _stabilize: () => Promise<void>);
+    /** Blur the element. */
+    blur(): Promise<void>;
+    /** Clear the element's input (for input and textarea elements only). */
+    clear(): Promise<void>;
+    /**
+     * Click the element at the default location for the current environment. If you need to guarantee
+     * the element is clicked at a specific location, consider using `click('center')` or
+     * `click(x, y)` instead.
+     */
+    click(modifiers?: ModifierKeys): Promise<void>;
+    /** Click the element at the element's center. */
+    click(location: 'center', modifiers?: ModifierKeys): Promise<void>;
+    /**
+     * Click the element at the specified coordinates relative to the top-left of the element.
+     * @param relativeX Coordinate within the element, along the X-axis at which to click.
+     * @param relativeY Coordinate within the element, along the Y-axis at which to click.
+     * @param modifiers Modifier keys held while clicking
+     */
+    click(relativeX: number, relativeY: number, modifiers?: ModifierKeys): Promise<void>;
+    /**
+     * Right clicks on the element at the specified coordinates relative to the top-left of it.
+     * @param relativeX Coordinate within the element, along the X-axis at which to click.
+     * @param relativeY Coordinate within the element, along the Y-axis at which to click.
+     * @param modifiers Modifier keys held while clicking
+     */
+    rightClick(relativeX: number, relativeY: number, modifiers?: ModifierKeys): Promise<void>;
+    /** Focus the element. */
+    focus(): Promise<void>;
+    /** Get the computed value of the given CSS property for the element. */
+    getCssValue(property: string): Promise<string>;
+    /** Hovers the mouse over the element. */
+    hover(): Promise<void>;
+    /** Moves the mouse away from the element. */
+    mouseAway(): Promise<void>;
+    /**
+     * Sends the given string to the input as a series of key presses. Also fires input events
+     * and attempts to add the string to the Element's value. Note that this cannot
+     * reproduce native browser behavior for keyboard shortcuts such as Tab, Ctrl + A, etc.
+     */
+    sendKeys(...keys: (string | TestKey)[]): Promise<void>;
+    /**
+     * Sends the given string to the input as a series of key presses. Also fires input events
+     * and attempts to add the string to the Element's value.
+     */
+    sendKeys(modifiers: ModifierKeys, ...keys: (string | TestKey)[]): Promise<void>;
+    /**
+     * Gets the text from the element.
+     * @param options Options that affect what text is included.
+     */
+    text(options?: TextOptions): Promise<string>;
+    /** Gets the value for the given attribute from the element. */
+    getAttribute(name: string): Promise<string | null>;
+    /** Checks whether the element has the given class. */
+    hasClass(name: string): Promise<boolean>;
+    /** Gets the dimensions of the element. */
+    getDimensions(): Promise<ElementDimensions>;
+    /** Gets the value of a property of an element. */
+    getProperty<T = any>(name: string): Promise<T>;
+    /** Sets the value of a property of an input. */
+    setInputValue(value: string): Promise<void>;
+    /** Selects the options at the specified indexes inside of a native `select` element. */
+    selectOptions(...optionIndexes: number[]): Promise<void>;
+    /** Checks whether this element matches the given selector. */
+    matchesSelector(selector: string): Promise<boolean>;
+    /** Checks whether the element is focused. */
+    isFocused(): Promise<boolean>;
+    /**
+     * Dispatches an event with a particular name.
+     * @param name Name of the event to be dispatched.
+     */
+    dispatchEvent(name: string, data?: Record<string, EventData>): Promise<void>;
+    /**
+     * Dispatches a pointer event on the current element if the browser supports it.
+     * @param name Name of the pointer event to be dispatched.
+     * @param clientX Coordinate of the user's pointer along the X axis.
+     * @param clientY Coordinate of the user's pointer along the Y axis.
+     * @param button Mouse button that should be pressed when dispatching the event.
+     */
+    private _dispatchPointerEventIfSupported;
+    /**
+     * Dispatches all the events that are part of a mouse event sequence
+     * and then emits a given primary event at the end, if speciifed.
+     */
+    private _dispatchMouseEventSequence;
+}
+
+export { }

package/text-field/index.d.ts

@@ -1,8 +1,177 @@
+import { AfterViewInit } from '@angular/core';
+import { BooleanInput } from '@angular/cdk/coercion';
+import { DoCheck } from '@angular/core';
+import { ElementRef } from '@angular/core';
+import { EventEmitter } from '@angular/core';
+import * as i0 from '@angular/core';
+import { NgZone } from '@angular/core';
+import { NumberInput } from '@angular/cdk/coercion';
+import { Observable } from 'rxjs';
+import { OnDestroy } from '@angular/core';
+import { OnInit } from '@angular/core';
+import { Platform } from '@angular/cdk/platform';
+
+/** An event that is emitted when the autofill state of an input changes. */
+export declare type AutofillEvent = {
+    /** The element whose autofill state changes. */
+    target: Element;
+    /** Whether the element is currently autofilled. */
+    isAutofilled: boolean;
+};
+
 /**
- * @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
+ * An injectable service that can be used to monitor the autofill state of an input.
+ * Based on the following blog post:
+ * https://medium.com/@brunn/detecting-autofilled-fields-in-javascript-aed598d25da7
  */
-export * from './public-api';
+export declare class AutofillMonitor implements OnDestroy {
+    private _platform;
+    private _ngZone;
+    private _monitoredElements;
+    constructor(_platform: Platform, _ngZone: NgZone);
+    /**
+     * Monitor for changes in the autofill state of the given input element.
+     * @param element The element to monitor.
+     * @return A stream of autofill state changes.
+     */
+    monitor(element: Element): Observable<AutofillEvent>;
+    /**
+     * Monitor for changes in the autofill state of the given input element.
+     * @param element The element to monitor.
+     * @return A stream of autofill state changes.
+     */
+    monitor(element: ElementRef<Element>): Observable<AutofillEvent>;
+    /**
+     * Stop monitoring the autofill state of the given input element.
+     * @param element The element to stop monitoring.
+     */
+    stopMonitoring(element: Element): void;
+    /**
+     * Stop monitoring the autofill state of the given input element.
+     * @param element The element to stop monitoring.
+     */
+    stopMonitoring(element: ElementRef<Element>): void;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AutofillMonitor, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AutofillMonitor>;
+}
+
+/** A directive that can be used to monitor the autofill state of an input. */
+export declare class CdkAutofill implements OnDestroy, OnInit {
+    private _elementRef;
+    private _autofillMonitor;
+    /** Emits when the autofill state of the element changes. */
+    readonly cdkAutofill: EventEmitter<AutofillEvent>;
+    constructor(_elementRef: ElementRef<HTMLElement>, _autofillMonitor: AutofillMonitor);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CdkAutofill, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CdkAutofill, "[cdkAutofill]", never, {}, { "cdkAutofill": "cdkAutofill"; }, never, never, false>;
+}
+
+/** Directive to automatically resize a textarea to fit its content. */
+export declare class CdkTextareaAutosize implements AfterViewInit, DoCheck, OnDestroy {
+    private _elementRef;
+    private _platform;
+    private _ngZone;
+    /** Keep track of the previous textarea value to avoid resizing when the value hasn't changed. */
+    private _previousValue?;
+    private _initialHeight;
+    private readonly _destroyed;
+    private _minRows;
+    private _maxRows;
+    private _enabled;
+    /**
+     * Value of minRows as of last resize. If the minRows has decreased, the
+     * height of the textarea needs to be recomputed to reflect the new minimum. The maxHeight
+     * does not have the same problem because it does not affect the textarea's scrollHeight.
+     */
+    private _previousMinRows;
+    private _textareaElement;
+    /** Minimum amount of rows in the textarea. */
+    get minRows(): number;
+    set minRows(value: NumberInput);
+    /** Maximum amount of rows in the textarea. */
+    get maxRows(): number;
+    set maxRows(value: NumberInput);
+    /** Whether autosizing is enabled or not */
+    get enabled(): boolean;
+    set enabled(value: BooleanInput);
+    get placeholder(): string;
+    set placeholder(value: string);
+    /** Cached height of a textarea with a single row. */
+    private _cachedLineHeight;
+    /** Cached height of a textarea with only the placeholder. */
+    private _cachedPlaceholderHeight?;
+    /** Used to reference correct document/window */
+    protected _document?: Document;
+    private _hasFocus;
+    private _isViewInited;
+    constructor(_elementRef: ElementRef<HTMLElement>, _platform: Platform, _ngZone: NgZone, 
+    /** @breaking-change 11.0.0 make document required */
+    document?: any);
+    /** Sets the minimum height of the textarea as determined by minRows. */
+    _setMinHeight(): void;
+    /** Sets the maximum height of the textarea as determined by maxRows. */
+    _setMaxHeight(): void;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    /**
+     * Cache the height of a single-row textarea if it has not already been cached.
+     *
+     * We need to know how large a single "row" of a textarea is in order to apply minRows and
+     * maxRows. For the initial version, we will assume that the height of a single line in the
+     * textarea does not ever change.
+     */
+    private _cacheTextareaLineHeight;
+    private _measureScrollHeight;
+    private _cacheTextareaPlaceholderHeight;
+    /** Handles `focus` and `blur` events. */
+    private _handleFocusEvent;
+    ngDoCheck(): void;
+    /**
+     * Resize the textarea to fit its content.
+     * @param force Whether to force a height recalculation. By default the height will be
+     *    recalculated only if the value changed since the last call.
+     */
+    resizeToFitContent(force?: boolean): void;
+    /**
+     * Resets the textarea to its original size
+     */
+    reset(): void;
+    _noopInputHandler(): void;
+    /** Access injected document if available or fallback to global document reference */
+    private _getDocument;
+    /** Use defaultView of injected document if available or fallback to global window reference */
+    private _getWindow;
+    /**
+     * Scrolls a textarea to the caret position. On Firefox resizing the textarea will
+     * prevent it from scrolling to the caret position. We need to re-set the selection
+     * in order for it to scroll to the proper position.
+     */
+    private _scrollToCaretPosition;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CdkTextareaAutosize, [null, null, null, { optional: true; }]>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CdkTextareaAutosize, "textarea[cdkTextareaAutosize]", ["cdkTextareaAutosize"], { "minRows": "cdkAutosizeMinRows"; "maxRows": "cdkAutosizeMaxRows"; "enabled": "cdkTextareaAutosize"; "placeholder": "placeholder"; }, {}, never, never, false>;
+}
+
+declare namespace i1 {
+    export {
+        AutofillEvent,
+        AutofillMonitor,
+        CdkAutofill
+    }
+}
+
+declare namespace i2 {
+    export {
+        CdkTextareaAutosize
+    }
+}
+
+export declare class TextFieldModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<TextFieldModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<TextFieldModule, [typeof i1.CdkAutofill, typeof i2.CdkTextareaAutosize], never, [typeof i1.CdkAutofill, typeof i2.CdkTextareaAutosize]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<TextFieldModule>;
+}
+
+export { }