feat(text-field): Convert JS to TypeScript

packages/mdc-textfield/README.md

@@ -374,17 +374,17 @@ Method Signature | Description
 `deregisterTextFieldInteractionHandler(evtType: string, handler: EventListener) => void` | Deregisters an event handler on the root element for a given event.
 `registerInputInteractionHandler(evtType: string, handler: EventListener) => void` | Registers an event listener on the native input element for a given event.
 `deregisterInputInteractionHandler(evtType: string, handler: EventListener) => void` | Deregisters an event listener on the native input element for a given event.
-`registerValidationAttributeChangeHandler(handler: function(!Array<string>) => undefined) => !MutationObserver` | Registers a validation attribute change listener on the input element. Handler accepts list of attribute changes.
+`registerValidationAttributeChangeHandler(handler: (attributeNames: string[]) => void) => MutationObserver` | Registers a validation attribute change listener on the input element. Handler accepts list of attribute changes.
 `deregisterValidationAttributeChangeHandler(!MutationObserver) => void` | Disconnects a validation attribute observer on the input element.
-`getNativeInput() => {value: string, disabled: boolean, badInput: boolean, checkValidity: () => boolean}?` | Returns an object representing the native text input element, with a similar API shape.
+`getNativeInput() => NativeInputType \| null` | Returns an object representing the native text input element, with a similar API shape. See [types.ts](types.ts).
 `isFocused() => boolean` | Returns whether the input is focused.
 `hasOutline() => boolean` | Returns whether there is an outline element.
 `notchOutline(labelWidth: number) => void` | Updates the notched outline path to open the notch and update the notch width for the label element.
 `closeOutline() => void` | Closes the notch in the notched outline element.
 
 #### `MDCTextFieldAdapter.getNativeInput()`
 
-Returns an object representing the native text input element, with a similar API shape. The object returned should include the `value`, `disabled` and `badInput` properties, as well as the `checkValidity()` function. We _never_ alter the value within our code, however we _do_ update the disabled property, so if you choose to duck-type the return value for this method in your implementation it's important to keep this in mind. Also note that this method can return null, which the foundation will handle gracefully.
+Returns an object representing the native text input element, with a similar API shape. We _never_ alter the value within our code, however we _do_ update the disabled property, so if you choose to duck-type the return value for this method in your implementation it's important to keep this in mind. Also note that this method can return null, which the foundation will handle gracefully.
 
 #### `MDCTextFieldAdapter.getIdleOutlineStyleValue(propertyName: string)`
 

packages/mdc-textfield/adapter.ts

@@ -0,0 +1,147 @@
+/**
+ * @license
+ * Copyright 2017 Google Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+import {EventType, SpecificEventListener} from '@material/base/types';
+import {NativeInputElement} from './types';
+
+/**
+ * Defines the shape of the adapter expected by the foundation.
+ * Implement this adapter for your framework of choice to delegate updates to
+ * the component in your framework of choice. See architecture documentation
+ * for more details.
+ * https://github.com/material-components/material-components-web/blob/master/docs/code/architecture.md
+ */
+interface MDCTextFieldAdapter {
+  /**
+   * Adds a class to the root Element.
+   */
+  addClass(className: string): void;
+
+  /**
+   * Removes a class from the root Element.
+   */
+  removeClass(className: string): void;
+
+  /**
+   * @return true if the root element contains the given class name.
+   */
+  hasClass(className: string): boolean;
+
+  /**
+   * Registers an event handler on the root element for a given event.
+   */
+  registerTextFieldInteractionHandler<E extends EventType>(evtType: E, handler: SpecificEventListener<E>): void;
+
+  /**
+   * Deregisters an event handler on the root element for a given event.
+   */
+  deregisterTextFieldInteractionHandler<E extends EventType>(evtType: E, handler: SpecificEventListener<E>): void;
+
+  /**
+   * Registers an event listener on the native input element for a given event.
+   */
+  registerInputInteractionHandler<E extends EventType>(evtType: E, handler: SpecificEventListener<E>): void;
+
+  /**
+   * Deregisters an event listener on the native input element for a given event.
+   */
+  deregisterInputInteractionHandler<E extends EventType>(evtType: E, handler: SpecificEventListener<E>): void;
+
+  /**
+   * Registers a validation attribute change listener on the input element.
+   * Handler accepts list of attribute names.
+   */
+  registerValidationAttributeChangeHandler(handler: (attributeNames: string[]) => void): MutationObserver;
+
+  /**
+   * Disconnects a validation attribute observer on the input element.
+   */
+  deregisterValidationAttributeChangeHandler(observer: MutationObserver): void;
+
+  /**
+   * @return The native `<input>` element, or an object with the same shape.
+   * Note that this method can return null, which the foundation will handle gracefully.
+   */
+  getNativeInput(): NativeInputElement | null;
+
+  /**
+   * @return true if the textfield is focused. We achieve this via `document.activeElement === this.root_`.
+   */
+  isFocused(): boolean;
+
+  /**
+   * Activates the line ripple.
+   */
+  activateLineRipple(): void;
+
+  /**
+   * Deactivates the line ripple.
+   */
+  deactivateLineRipple(): void;
+
+  /**
+   * Sets the transform origin of the line ripple.
+   */
+  setLineRippleTransformOrigin(normalizedX: number): void;
+
+  /**
+   * Only implement if label exists.
+   * Shakes label if shouldShake is true.
+   */
+  shakeLabel(shouldShake: boolean): void;
+
+  /**
+   * Only implement if label exists.
+   * Floats the label above the input element if shouldFloat is true.
+   */
+  floatLabel(shouldFloat: boolean): void;
+
+  /**
+   * @return true if label element exists, false if it doesn't.
+   */
+  hasLabel(): boolean;
+
+  /**
+   * Only implement if label exists.
+   * @return width of label in pixels.
+   */
+  getLabelWidth(): number;
+
+  /**
+   * @return true if outline element exists, false if it doesn't.
+   */
+  hasOutline(): boolean;
+
+  /**
+   * Only implement if outline element exists.
+   */
+  notchOutline(labelWidth: number): void;
+
+  /**
+   * Only implement if outline element exists.
+   * Closes notch in outline element.
+   */
+  closeOutline(): void;
+}
+
+export {MDCTextFieldAdapter as default, MDCTextFieldAdapter};