@ukic/web-components 2.1.0-beta.9 → 2.3.0

package/dist/collection/components/ic-text-field/ic-text-field.js

@@ -1,6 +1,6 @@
 import { Host, h, } from "@stencil/core";
-import { IcInformationStatus } from "../../utils/types";
-import { inheritAttributes, debounceEvent, getInputDescribedByText, renderHiddenInput, isEmptyString, onComponentRequiredPropUndefined, addFormResetListener, removeFormResetListener, isSlotUsed, } from "../../utils/helpers";
+import { IcInformationStatus, } from "../../utils/types";
+import { inheritAttributes, debounceEvent, getInputDescribedByText, renderHiddenInput, isEmptyString, onComponentRequiredPropUndefined, addFormResetListener, removeFormResetListener, isSlotUsed, removeDisabledFalse, } from "../../utils/helpers";
 import { IC_INHERITED_ARIA } from "../../utils/constants";
 let inputIds = 0;
 /**
@@ -25,54 +25,60 @@ export class TextField {
     this.isTextArea = () => {
       return this.rows > 1;
     };
+    this.getInlineValidationText = () => {
+      this.getValidationText.emit({ value: this.validationText });
+    };
     this.hasStatus = (status) => {
       return status !== "" && !this.disabled;
     };
     this.showStatusText = (status) => {
-      if (this.hasStatus(status) &&
-        !(status == IcInformationStatus.Success && this.validationInline)) {
-        return true;
-      }
-      return false;
+      return (this.hasStatus(status) &&
+        !(status == IcInformationStatus.Success && this.validationInline) &&
+        !this.validationInlineInternal);
     };
     this.handleFormReset = () => {
       this.value = this.initialValue;
     };
-    this.inputId = `ic-text-field-input-${inputIds++}`;
-    this.label = undefined;
-    this.required = false;
-    this.disabled = false;
-    this.readonly = false;
-    this.placeholder = "";
-    this.fullWidth = false;
-    this.hideLabel = false;
-    this.helperText = "";
-    this.rows = 1;
-    this.resize = false;
-    this.small = false;
-    this.value = "";
-    this.maxLength = 0;
-    this.validationStatus = "";
-    this.validationText = "";
-    this.validationInline = false;
+    this.numChars = 0;
+    this.maxLengthExceeded = false;
+    this.maxValueExceeded = false;
+    this.minValueUnattained = false;
+    this.ariaActiveDescendant = undefined;
+    this.ariaAutocomplete = undefined;
+    this.ariaExpanded = undefined;
+    this.ariaOwns = undefined;
     this.autocapitalize = "off";
     this.autocomplete = "off";
     this.autocorrect = "off";
     this.autoFocus = false;
-    this.debounce = 0;
-    this.type = "text";
+    this.disabled = false;
+    this.fullWidth = false;
+    this.helperText = "";
+    this.hideLabel = false;
+    this.hiddenInput = true;
+    this.inputId = `ic-text-field-input-${inputIds++}`;
     this.inputmode = "text";
+    this.label = undefined;
+    this.max = undefined;
+    this.maxLength = 0;
+    this.min = undefined;
     this.name = this.inputId;
+    this.placeholder = "";
+    this.readonly = false;
+    this.required = false;
+    this.resize = false;
+    this.role = undefined;
+    this.rows = 1;
+    this.small = false;
     this.spellcheck = false;
-    this.ariaActiveDescendant = undefined;
     this.truncateValue = undefined;
-    this.ariaExpanded = undefined;
-    this.ariaOwns = undefined;
-    this.ariaAutocomplete = undefined;
-    this.role = undefined;
-    this.hiddenInput = true;
-    this.numChars = 0;
-    this.maxLengthExceeded = false;
+    this.type = "text";
+    this.validationInline = false;
+    this.validationInlineInternal = false;
+    this.validationStatus = "";
+    this.validationText = "";
+    this.debounce = 0;
+    this.value = "";
     this.initialValue = this.value;
   }
   debounceChanged() {
@@ -82,8 +88,22 @@ export class TextField {
     if (this.inputEl && this.inputEl.value !== newValue) {
       this.inputEl.value = newValue;
     }
+    this.numChars = newValue.length;
+    if (this.type === "number") {
+      if (newValue && Number(newValue) < Number(this.min)) {
+        this.minValueUnattained = true;
+      }
+      else {
+        this.minValueUnattained = false;
+      }
+      if (Number(newValue) > Number(this.max)) {
+        this.maxValueExceeded = true;
+      }
+      else {
+        this.maxValueExceeded = false;
+      }
+    }
     if (this.maxLength > 0) {
-      this.numChars = newValue.length;
       if (newValue.length > this.maxLength) {
         this.maxLengthExceeded = true;
       }
@@ -93,29 +113,12 @@ export class TextField {
     }
     this.icChange.emit({ value: newValue });
   }
-  /**
-   * Sets focus on the native `input`.
-   */
-  async setFocus() {
-    if (this.inputEl) {
-      this.inputEl.focus();
-    }
-  }
-  //stop keydown event bubbling up to storybook
-  handleKeyDown(ev) {
-    this.icKeydown.emit({ event: ev });
-    ev.cancelBubble = true;
-  }
-  hasLeftIconSlot() {
-    const iconEl = this.el.querySelector(`[slot="icon"]`);
-    if (iconEl != null) {
-      return true;
-    }
-    return false;
-  }
   connectedCallback() {
     this.debounceChanged();
   }
+  disconnectedCallback() {
+    removeFormResetListener(this.el, this.handleFormReset);
+  }
   componentWillLoad() {
     this.watchValueHandler(this.value);
     this.inheritedAttributes = inheritAttributes(this.el, [
@@ -126,27 +129,51 @@ export class TextField {
     ]);
     if (this.readonly) {
       this.maxLengthExceeded = false;
+      this.maxValueExceeded = false;
+      this.minValueUnattained = false;
     }
     addFormResetListener(this.el, this.handleFormReset);
+    removeDisabledFalse(this.disabled, this.el);
   }
   componentDidLoad() {
     onComponentRequiredPropUndefined([{ prop: this.label, propName: "label" }], "Text Field");
+    if (this.validationInlineInternal) {
+      this.getInlineValidationText();
+    }
   }
-  disconnectedCallback() {
-    removeFormResetListener(this.el, this.handleFormReset);
+  handleKeyDown(ev) {
+    this.icKeydown.emit({ event: ev });
+  }
+  /**
+   * Sets focus on the native `input`.
+   */
+  async setFocus() {
+    if (this.inputEl) {
+      this.inputEl.focus();
+    }
+  }
+  hasLeftIconSlot() {
+    const iconEl = this.el.querySelector(`[slot="icon"]`);
+    return iconEl !== null;
   }
   render() {
-    const { inputId, name, label, required, small, placeholder, helperText, rows, resize, disabled, value, maxLength, numChars, readonly, maxLengthExceeded, validationStatus, validationText, validationInline, spellcheck, inputmode, fullWidth, truncateValue, hiddenInput, } = this;
+    const { inputId, name, label, required, small, placeholder, helperText, rows, resize, disabled, value, min, max, maxLength, numChars, readonly, maxLengthExceeded, minValueUnattained, maxValueExceeded, validationStatus, validationText, validationInline, validationInlineInternal, spellcheck, inputmode, fullWidth, truncateValue, hiddenInput, } = this;
     const disabledMode = readonly ? true : disabled;
     const placeholderText = disabled ? "" : placeholder;
-    const currentStatus = maxLengthExceeded
+    const currentStatus = maxLengthExceeded || maxValueExceeded || minValueUnattained
       ? IcInformationStatus.Error
       : validationStatus;
     const currentValidationText = maxLengthExceeded
       ? "Maximum length exceeded"
-      : validationText;
+      : maxValueExceeded
+        ? `Maximum value of ${max} exceeded`
+        : minValueUnattained
+          ? `Minimum value of ${min} not met`
+          : validationText;
     const maxNumChars = readonly ? 0 : maxLength;
     const messageAriaLive = maxLengthExceeded ||
+      maxValueExceeded ||
+      minValueUnattained ||
       (maxLength === 0 && currentStatus === IcInformationStatus.Error)
       ? "assertive"
       : "polite";
@@ -156,10 +183,8 @@ export class TextField {
     const describedBy = (hiddenCharCountDescId +
       " " +
       getInputDescribedByText(inputId, helperText !== "", showStatusText)).trim();
-    if (this.showLeftIcon) {
-      if (!readonly && disabledMode) {
-        this.showLeftIcon = false;
-      }
+    if (this.showLeftIcon && !readonly && disabledMode) {
+      this.showLeftIcon = false;
     }
     const invalid = currentStatus === IcInformationStatus.Error ? "true" : "false";
     const disabledText = disabledMode && !readonly;
@@ -169,7 +194,7 @@ export class TextField {
     return (h(Host, { class: { ["fullwidth"]: fullWidth } }, h("ic-input-container", { readonly: readonly, disabled: disabledMode }, !this.hideLabel && (h("ic-input-label", { for: inputId, label: label, helperText: helperText, required: required, disabled: disabledText, readonly: readonly })), h("ic-input-component-container", { small: small, validationStatus: currentStatus, multiLine: multiline, disabled: disabledMode, readonly: readonly, validationInline: validationInline, fullWidth: fullWidth }, this.showLeftIcon && (h("span", { class: {
         ["readonly"]: readonly,
         ["has-value"]: value.length > 0,
-      }, slot: "left-icon" }, h("slot", { name: "icon" }))), !multiline && (h("input", Object.assign({ id: inputId, name: name, ref: (el) => (this.inputEl = el), type: this.type, value: value, class: {
+      }, slot: "left-icon" }, h("slot", { name: "icon" }))), !multiline && (h("input", Object.assign({ id: inputId, name: name, ref: (el) => (this.inputEl = el), type: this.type, min: min, max: max, value: value, class: {
         ["no-left-pad"]: !this.showLeftIcon && readonly,
         ["readonly"]: readonly,
         ["truncate-value"]: truncateValue,
@@ -179,13 +204,17 @@ export class TextField {
         ["readonly"]: readonly,
       }, name: name, ref: (el) => (this.inputEl = el), value: value, rows: rows, required: required, disabled: disabledMode, placeholder: placeholderText, readonly: readonly, onInput: this.onInput, onBlur: this.onBlur, onFocus: this.onFocus, "aria-label": label, "aria-describedby": describedBy, "aria-invalid": invalid, autocapitalize: this.autocapitalize, autoFocus: this.autoFocus, spellcheck: spellcheck, inputmode: inputmode }, this.inheritedAttributes))), isSlotUsed(this.el, "clear-button") && (h("slot", { name: "clear-button" })), isSlotUsed(this.el, "search-submit-button") && (h("slot", { name: "search-submit-button" }))), isSlotUsed(this.el, "menu") && h("slot", { name: "menu" }), (!isEmptyString(validationStatus) ||
       !isEmptyString(validationText) ||
-      maxNumChars > 0) && (h("ic-input-validation", { status: this.hasStatus(currentStatus) === false ||
+      maxNumChars > 0 ||
+      maxValueExceeded ||
+      minValueUnattained) &&
+      !validationInlineInternal && (h("ic-input-validation", { status: this.hasStatus(currentStatus) === false ||
         (currentStatus === IcInformationStatus.Success &&
-          validationInline)
+          validationInline) ||
+        validationInlineInternal
         ? ""
         : currentStatus, message: showStatusText ? currentValidationText : "", ariaLiveMode: messageAriaLive, for: inputId, fullWidth: fullWidth }, !readonly && maxNumChars > 0 && (h("div", { slot: "validation-message-adornment" }, h("ic-typography", { variant: "caption", class: {
         ["maxlengthtext"]: true,
-        ["exceeded"]: maxLengthExceeded,
+        ["error"]: maxLengthExceeded,
         ["disabled"]: disabledText,
       } }, h("span", { "aria-live": "polite", id: `${inputId}-charcount`, class: "charcount" }, numChars, "/", maxNumChars), h("span", { hidden: true, id: hiddenCharCountDescId }, "Field can contain a maximum of ", maxNumChars, " characters.")))))))));
   }
@@ -203,7 +232,7 @@ export class TextField {
   }
   static get properties() {
     return {
-      "inputId": {
+      "ariaActiveDescendant": {
         "type": "string",
         "mutable": false,
         "complexType": {
@@ -214,14 +243,42 @@ export class TextField {
         "required": false,
         "optional": true,
         "docs": {
-          "tags": [],
-          "text": "The ID for the input."
+          "tags": [{
+              "name": "internal",
+              "text": "The active element when focus is on the ic-menu items."
+            }],
+          "text": ""
         },
-        "attribute": "input-id",
+        "attribute": "aria-active-descendant",
+        "reflect": false
+      },
+      "ariaAutocomplete": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "IcAriaAutocompleteTypes",
+          "resolved": "\"inline\" | \"list\"",
+          "references": {
+            "IcAriaAutocompleteTypes": {
+              "location": "import",
+              "path": "./ic-text-field.types"
+            }
+          }
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "internal",
+              "text": "Used to identify whether inputting any text triggers more predictions"
+            }],
+          "text": ""
+        },
+        "attribute": "aria-autocomplete",
         "reflect": false,
-        "defaultValue": "`ic-text-field-input-${inputIds++}`"
+        "defaultValue": "undefined"
       },
-      "label": {
+      "ariaExpanded": {
         "type": "string",
         "mutable": false,
         "complexType": {
@@ -229,88 +286,121 @@ export class TextField {
           "resolved": "string",
           "references": {}
         },
-        "required": true,
+        "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
-          "text": "The label for the input."
+          "tags": [{
+              "name": "internal",
+              "text": "Used to identify if the slotted menu is rendered"
+            }],
+          "text": ""
         },
-        "attribute": "label",
+        "attribute": "aria-expanded",
         "reflect": false
       },
-      "required": {
-        "type": "boolean",
+      "ariaOwns": {
+        "type": "string",
         "mutable": false,
         "complexType": {
-          "original": "boolean",
-          "resolved": "boolean",
+          "original": "string",
+          "resolved": "string",
           "references": {}
         },
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
-          "text": "If `true`, the input will require a value."
+          "tags": [{
+              "name": "internal",
+              "text": "Used to identify any related child component"
+            }],
+          "text": ""
         },
-        "attribute": "required",
-        "reflect": false,
-        "defaultValue": "false"
+        "attribute": "aria-owns",
+        "reflect": false
       },
-      "disabled": {
-        "type": "boolean",
+      "autocapitalize": {
+        "type": "string",
         "mutable": false,
         "complexType": {
-          "original": "boolean",
-          "resolved": "boolean",
+          "original": "string",
+          "resolved": "string",
           "references": {}
         },
         "required": false,
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "If `true`, the disabled state will be set."
+          "text": "The automatic capitalisation of the text value as it is entered/edited by the user.\nAvailable options: \"off\", \"none\", \"on\", \"sentences\", \"words\", \"characters\"."
         },
-        "attribute": "disabled",
+        "attribute": "autocapitalize",
         "reflect": false,
-        "defaultValue": "false"
+        "defaultValue": "\"off\""
       },
-      "readonly": {
-        "type": "boolean",
+      "autocomplete": {
+        "type": "string",
         "mutable": false,
         "complexType": {
-          "original": "boolean",
-          "resolved": "boolean",
-          "references": {}
+          "original": "IcAutocompleteTypes",
+          "resolved": "\"name\" | \"on\" | \"off\" | \"honorific-prefix\" | \"given-name\" | \"additional-name\" | \"family-name\" | \"honorific-suffix\" | \"nickname\" | \"email\" | \"username\" | \"new-password\" | \"current-password\" | \"one-time-code\" | \"organization-title\" | \"organization\" | \"street-address\" | \"address-line1\" | \"address-line2\" | \"address-line3\" | \"address-level4\" | \"address-level3\" | \"address-level2\" | \"address-level1\" | \"country\" | \"country-name\" | \"postal-code\" | \"cc-name\" | \"cc-given-name\" | \"cc-additional-name\" | \"cc-family-name\" | \"cc-number\" | \"cc-exp\" | \"cc-exp-month\" | \"cc-exp-year\" | \"cc-csc\" | \"cc-type\" | \"transaction-currency\" | \"transaction-amount\" | \"language\" | \"bday\" | \"bday-day\" | \"bday-month\" | \"bday-year\" | \"sex\" | \"tel\" | \"tel-country-code\" | \"tel-national\" | \"tel-area-code\" | \"tel-local\" | \"tel-extension\" | \"impp\" | \"url\" | \"photo\"",
+          "references": {
+            "IcAutocompleteTypes": {
+              "location": "import",
+              "path": "../../utils/types"
+            }
+          }
         },
         "required": false,
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "If `true`, the read only state will be set."
+          "text": "The state of autocompletion the browser can apply on the text value."
         },
-        "attribute": "readonly",
-        "reflect": true,
-        "defaultValue": "false"
+        "attribute": "autocomplete",
+        "reflect": false,
+        "defaultValue": "\"off\""
       },
-      "placeholder": {
+      "autocorrect": {
         "type": "string",
         "mutable": false,
         "complexType": {
-          "original": "string",
-          "resolved": "string",
+          "original": "IcAutocorrectStates",
+          "resolved": "\"off\" | \"on\"",
+          "references": {
+            "IcAutocorrectStates": {
+              "location": "import",
+              "path": "../../utils/types"
+            }
+          }
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [],
+          "text": "The state of autocorrection the browser can apply when the user is entering/editing the text value."
+        },
+        "attribute": "autocorrect",
+        "reflect": false,
+        "defaultValue": "\"off\""
+      },
+      "autoFocus": {
+        "type": "boolean",
+        "mutable": false,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
           "references": {}
         },
         "required": false,
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The placeholder value to be displayed."
+          "text": "If `true`, the form control will have input focus when the page loads."
         },
-        "attribute": "placeholder",
+        "attribute": "auto-focus",
         "reflect": false,
-        "defaultValue": "\"\""
+        "defaultValue": "false"
       },
-      "fullWidth": {
+      "disabled": {
         "type": "boolean",
         "mutable": false,
         "complexType": {
@@ -322,13 +412,13 @@ export class TextField {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Specify whether the text field fills the full width of the container.\nIf `true`, this overrides the --input-width CSS variable."
+          "text": "If `true`, the disabled state will be set."
         },
-        "attribute": "full-width",
+        "attribute": "disabled",
         "reflect": false,
         "defaultValue": "false"
       },
-      "hideLabel": {
+      "fullWidth": {
         "type": "boolean",
         "mutable": false,
         "complexType": {
@@ -340,9 +430,9 @@ export class TextField {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "If `true`, the label will be hidden and the required label value will be applied as an aria-label."
+          "text": "Specify whether the text field fills the full width of the container.\nIf `true`, this overrides the --input-width CSS variable."
         },
-        "attribute": "hide-label",
+        "attribute": "full-width",
         "reflect": false,
         "defaultValue": "false"
       },
@@ -364,25 +454,25 @@ export class TextField {
         "reflect": false,
         "defaultValue": "\"\""
       },
-      "rows": {
-        "type": "number",
+      "hideLabel": {
+        "type": "boolean",
         "mutable": false,
         "complexType": {
-          "original": "number",
-          "resolved": "number",
+          "original": "boolean",
+          "resolved": "boolean",
           "references": {}
         },
         "required": false,
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The number of rows to transform the text field into a text area with a specific height."
+          "text": "If `true`, the label will be hidden and the required label value will be applied as an aria-label."
         },
-        "attribute": "rows",
+        "attribute": "hide-label",
         "reflect": false,
-        "defaultValue": "1"
+        "defaultValue": "false"
       },
-      "resize": {
+      "hiddenInput": {
         "type": "boolean",
         "mutable": false,
         "complexType": {
@@ -393,127 +483,129 @@ export class TextField {
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
-          "text": "If `true`, the multiline text area will be resizeable."
+          "tags": [{
+              "name": "internal",
+              "text": "If `true`, the hidden form input will stop rendering for form submission."
+            }],
+          "text": ""
         },
-        "attribute": "resize",
+        "attribute": "hidden-input",
         "reflect": false,
-        "defaultValue": "false"
+        "defaultValue": "true"
       },
-      "small": {
-        "type": "boolean",
+      "inputId": {
+        "type": "string",
         "mutable": false,
         "complexType": {
-          "original": "boolean",
-          "resolved": "boolean",
+          "original": "string",
+          "resolved": "string",
           "references": {}
         },
         "required": false,
-        "optional": false,
+        "optional": true,
         "docs": {
           "tags": [],
-          "text": "If `true`, the small styling will be applied to the text field."
+          "text": "The ID for the input."
         },
-        "attribute": "small",
-        "reflect": true,
-        "defaultValue": "false"
+        "attribute": "input-id",
+        "reflect": false,
+        "defaultValue": "`ic-text-field-input-${inputIds++}`"
       },
-      "value": {
+      "inputmode": {
         "type": "string",
-        "mutable": true,
+        "mutable": false,
         "complexType": {
-          "original": "string",
-          "resolved": "string",
-          "references": {}
+          "original": "IcTextFieldInputModes",
+          "resolved": "\"decimal\" | \"email\" | \"none\" | \"numeric\" | \"search\" | \"tel\" | \"text\" | \"url\"",
+          "references": {
+            "IcTextFieldInputModes": {
+              "location": "import",
+              "path": "./ic-text-field.types"
+            }
+          }
         },
         "required": false,
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The value of the text field."
+          "text": "A hint to the browser for which keyboard to display.\nPossible values: `\"none\"`, `\"text\"`, `\"tel\"`, `\"url\"`,\n`\"email\"`, `\"numeric\"`, `\"decimal\"`, and `\"search\"`."
         },
-        "attribute": "value",
-        "reflect": true,
-        "defaultValue": "\"\""
+        "attribute": "inputmode",
+        "reflect": false,
+        "defaultValue": "\"text\""
       },
-      "maxLength": {
-        "type": "number",
+      "label": {
+        "type": "string",
         "mutable": false,
         "complexType": {
-          "original": "number",
-          "resolved": "number",
+          "original": "string",
+          "resolved": "string",
           "references": {}
         },
-        "required": false,
+        "required": true,
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The maximum number of characters that can be entered in the field."
+          "text": "The label for the input."
         },
-        "attribute": "max-length",
-        "reflect": false,
-        "defaultValue": "0"
+        "attribute": "label",
+        "reflect": false
       },
-      "validationStatus": {
-        "type": "string",
+      "max": {
+        "type": "any",
         "mutable": false,
         "complexType": {
-          "original": "IcInformationStatusOrEmpty",
-          "resolved": "\"\" | \"error\" | \"success\" | \"warning\"",
-          "references": {
-            "IcInformationStatusOrEmpty": {
-              "location": "import",
-              "path": "../../interface"
-            }
-          }
+          "original": "string | number",
+          "resolved": "number | string",
+          "references": {}
         },
         "required": false,
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The validation state - e.g. 'error' | 'warning' | 'success'."
+          "text": "The maximum number that can be accepted as a value, when `type` is `number` and `rows` is `1`. (NOTE: Ensure to include visual indication of max value in `helperText` or `label`)"
         },
-        "attribute": "validation-status",
+        "attribute": "max",
         "reflect": false,
-        "defaultValue": "\"\""
+        "defaultValue": "undefined"
       },
-      "validationText": {
-        "type": "string",
+      "maxLength": {
+        "type": "number",
         "mutable": false,
         "complexType": {
-          "original": "string",
-          "resolved": "string",
+          "original": "number",
+          "resolved": "number",
           "references": {}
         },
         "required": false,
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The validation state - e.g. 'error' | 'warning' | 'success'."
+          "text": "The maximum number of characters that can be entered in the field."
         },
-        "attribute": "validation-text",
+        "attribute": "max-length",
         "reflect": false,
-        "defaultValue": "\"\""
+        "defaultValue": "0"
       },
-      "validationInline": {
-        "type": "boolean",
+      "min": {
+        "type": "any",
         "mutable": false,
         "complexType": {
-          "original": "boolean",
-          "resolved": "boolean",
+          "original": "string | number",
+          "resolved": "number | string",
           "references": {}
         },
         "required": false,
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "If `true`, the icon in input control will be displayed - only applies when validationStatus ='success'."
+          "text": "The minimum number that can be accepted as a value, when `type` is `number` and `rows` is `1`. (NOTE: Ensure to include visual indication of min value in `helperText` or `label`)"
         },
-        "attribute": "validation-inline",
+        "attribute": "min",
         "reflect": false,
-        "defaultValue": "false"
+        "defaultValue": "undefined"
       },
-      "autocapitalize": {
+      "name": {
         "type": "string",
         "mutable": false,
         "complexType": {
@@ -525,59 +617,49 @@ export class TextField {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The automatic capitalisation of the text value as it is entered/edited by the user.\nAvailable options: \"off\", \"none\", \"on\", \"sentences\", \"words\", \"characters\"."
+          "text": "The name of the control, which is submitted with the form data."
         },
-        "attribute": "autocapitalize",
+        "attribute": "name",
         "reflect": false,
-        "defaultValue": "\"off\""
+        "defaultValue": "this.inputId"
       },
-      "autocomplete": {
+      "placeholder": {
         "type": "string",
         "mutable": false,
         "complexType": {
-          "original": "IcAutocompleteTypes",
-          "resolved": "\"name\" | \"on\" | \"off\" | \"honorific-prefix\" | \"given-name\" | \"additional-name\" | \"family-name\" | \"honorific-suffix\" | \"nickname\" | \"email\" | \"username\" | \"new-password\" | \"current-password\" | \"one-time-code\" | \"organization-title\" | \"organization\" | \"street-address\" | \"address-line1\" | \"address-line2\" | \"address-line3\" | \"address-level4\" | \"address-level3\" | \"address-level2\" | \"address-level1\" | \"country\" | \"country-name\" | \"postal-code\" | \"cc-name\" | \"cc-given-name\" | \"cc-additional-name\" | \"cc-family-name\" | \"cc-number\" | \"cc-exp\" | \"cc-exp-month\" | \"cc-exp-year\" | \"cc-csc\" | \"cc-type\" | \"transaction-currency\" | \"transaction-amount\" | \"language\" | \"bday\" | \"bday-day\" | \"bday-month\" | \"bday-year\" | \"sex\" | \"tel\" | \"tel-country-code\" | \"tel-national\" | \"tel-area-code\" | \"tel-local\" | \"tel-extension\" | \"impp\" | \"url\" | \"photo\"",
-          "references": {
-            "IcAutocompleteTypes": {
-              "location": "import",
-              "path": "../../interface"
-            }
-          }
+          "original": "string",
+          "resolved": "string",
+          "references": {}
         },
         "required": false,
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The state of autocompletion the browser can apply on the text value."
+          "text": "The placeholder value to be displayed."
         },
-        "attribute": "autocomplete",
+        "attribute": "placeholder",
         "reflect": false,
-        "defaultValue": "\"off\""
+        "defaultValue": "\"\""
       },
-      "autocorrect": {
-        "type": "string",
+      "readonly": {
+        "type": "boolean",
         "mutable": false,
         "complexType": {
-          "original": "IcAutocorrectStates",
-          "resolved": "\"off\" | \"on\"",
-          "references": {
-            "IcAutocorrectStates": {
-              "location": "import",
-              "path": "../../interface"
-            }
-          }
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
         },
         "required": false,
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The state of autocorrection the browser can apply when the user is entering/editing the text value."
+          "text": "If `true`, the read only state will be set."
         },
-        "attribute": "autocorrect",
-        "reflect": false,
-        "defaultValue": "\"off\""
+        "attribute": "readonly",
+        "reflect": true,
+        "defaultValue": "false"
       },
-      "autoFocus": {
+      "required": {
         "type": "boolean",
         "mutable": false,
         "complexType": {
@@ -589,93 +671,85 @@ export class TextField {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "If `true`, the form control will have input focus when the page loads."
+          "text": "If `true`, the input will require a value."
         },
-        "attribute": "auto-focus",
+        "attribute": "required",
         "reflect": false,
         "defaultValue": "false"
       },
-      "debounce": {
-        "type": "number",
+      "resize": {
+        "type": "boolean",
         "mutable": false,
         "complexType": {
-          "original": "number",
-          "resolved": "number",
+          "original": "boolean",
+          "resolved": "boolean",
           "references": {}
         },
         "required": false,
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The amount of time, in milliseconds, to wait to trigger the `icChange` event after each keystroke."
+          "text": "If `true`, the multiline text area will be resizeable."
         },
-        "attribute": "debounce",
+        "attribute": "resize",
         "reflect": false,
-        "defaultValue": "0"
+        "defaultValue": "false"
       },
-      "type": {
+      "role": {
         "type": "string",
         "mutable": false,
         "complexType": {
-          "original": "IcTextFieldTypes",
-          "resolved": "\"email\" | \"number\" | \"password\" | \"search\" | \"tel\" | \"text\" | \"url\"",
-          "references": {
-            "IcTextFieldTypes": {
-              "location": "import",
-              "path": "./ic-text-field.types"
-            }
-          }
+          "original": "string",
+          "resolved": "string",
+          "references": {}
         },
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
-          "text": "The type of control to display. The default type is text."
+          "tags": [{
+              "name": "internal",
+              "text": "Used to set the role if not default textbox;"
+            }],
+          "text": ""
         },
-        "attribute": "type",
-        "reflect": false,
-        "defaultValue": "\"text\""
+        "attribute": "role",
+        "reflect": false
       },
-      "inputmode": {
-        "type": "string",
+      "rows": {
+        "type": "number",
         "mutable": false,
         "complexType": {
-          "original": "IcTextFieldInputModes",
-          "resolved": "\"decimal\" | \"email\" | \"none\" | \"numeric\" | \"search\" | \"tel\" | \"text\" | \"url\"",
-          "references": {
-            "IcTextFieldInputModes": {
-              "location": "import",
-              "path": "./ic-text-field.types"
-            }
-          }
+          "original": "number",
+          "resolved": "number",
+          "references": {}
         },
         "required": false,
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "A hint to the browser for which keyboard to display.\nPossible values: `\"none\"`, `\"text\"`, `\"tel\"`, `\"url\"`,\n`\"email\"`, `\"numeric\"`, `\"decimal\"`, and `\"search\"`."
+          "text": "The number of rows to transform the text field into a text area with a specific height."
         },
-        "attribute": "inputmode",
+        "attribute": "rows",
         "reflect": false,
-        "defaultValue": "\"text\""
+        "defaultValue": "1"
       },
-      "name": {
-        "type": "string",
+      "small": {
+        "type": "boolean",
         "mutable": false,
         "complexType": {
-          "original": "string",
-          "resolved": "string",
+          "original": "boolean",
+          "resolved": "boolean",
           "references": {}
         },
         "required": false,
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The name of the control, which is submitted with the form data."
+          "text": "If `true`, the small styling will be applied to the text field."
         },
-        "attribute": "name",
-        "reflect": false,
-        "defaultValue": "this.inputId"
+        "attribute": "small",
+        "reflect": true,
+        "defaultValue": "false"
       },
       "spellcheck": {
         "type": "boolean",
@@ -695,26 +769,6 @@ export class TextField {
         "reflect": false,
         "defaultValue": "false"
       },
-      "ariaActiveDescendant": {
-        "type": "string",
-        "mutable": false,
-        "complexType": {
-          "original": "string",
-          "resolved": "string",
-          "references": {}
-        },
-        "required": false,
-        "optional": true,
-        "docs": {
-          "tags": [{
-              "name": "internal",
-              "text": "The active element when focus is on the ic-menu items."
-            }],
-          "text": ""
-        },
-        "attribute": "aria-active-descendant",
-        "reflect": false
-      },
       "truncateValue": {
         "type": "boolean",
         "mutable": false,
@@ -735,32 +789,53 @@ export class TextField {
         "attribute": "truncate-value",
         "reflect": false
       },
-      "ariaExpanded": {
+      "type": {
         "type": "string",
         "mutable": false,
         "complexType": {
-          "original": "string",
-          "resolved": "string",
+          "original": "IcTextFieldTypes",
+          "resolved": "\"email\" | \"number\" | \"password\" | \"search\" | \"tel\" | \"text\" | \"url\"",
+          "references": {
+            "IcTextFieldTypes": {
+              "location": "import",
+              "path": "./ic-text-field.types"
+            }
+          }
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [],
+          "text": "The type of control to display. The default type is text."
+        },
+        "attribute": "type",
+        "reflect": false,
+        "defaultValue": "\"text\""
+      },
+      "validationInline": {
+        "type": "boolean",
+        "mutable": false,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
           "references": {}
         },
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [{
-              "name": "internal",
-              "text": "Used to identify if the slotted menu is rendered"
-            }],
-          "text": ""
+          "tags": [],
+          "text": "If `true`, the icon in input control will be displayed - only applies when validationStatus ='success'."
         },
-        "attribute": "aria-expanded",
-        "reflect": false
+        "attribute": "validation-inline",
+        "reflect": false,
+        "defaultValue": "false"
       },
-      "ariaOwns": {
-        "type": "string",
+      "validationInlineInternal": {
+        "type": "boolean",
         "mutable": false,
         "complexType": {
-          "original": "string",
-          "resolved": "string",
+          "original": "boolean",
+          "resolved": "boolean",
           "references": {}
         },
         "required": false,
@@ -768,40 +843,38 @@ export class TextField {
         "docs": {
           "tags": [{
               "name": "internal",
-              "text": "Used to identify any related child component"
+              "text": "If `true`, the validation will display inline."
             }],
           "text": ""
         },
-        "attribute": "aria-owns",
-        "reflect": false
+        "attribute": "validation-inline-internal",
+        "reflect": false,
+        "defaultValue": "false"
       },
-      "ariaAutocomplete": {
+      "validationStatus": {
         "type": "string",
         "mutable": false,
         "complexType": {
-          "original": "IcAriaAutocompleteTypes",
-          "resolved": "\"inline\" | \"list\"",
+          "original": "IcInformationStatusOrEmpty",
+          "resolved": "\"\" | \"error\" | \"success\" | \"warning\"",
           "references": {
-            "IcAriaAutocompleteTypes": {
+            "IcInformationStatusOrEmpty": {
               "location": "import",
-              "path": "./ic-text-field.types"
+              "path": "../../utils/types"
             }
           }
         },
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [{
-              "name": "internal",
-              "text": "Used to identify whether inputting any text triggers more predictions"
-            }],
-          "text": ""
+          "tags": [],
+          "text": "The validation state - e.g. 'error' | 'warning' | 'success'."
         },
-        "attribute": "aria-autocomplete",
+        "attribute": "validation-status",
         "reflect": false,
-        "defaultValue": "undefined"
+        "defaultValue": "\"\""
       },
-      "role": {
+      "validationText": {
         "type": "string",
         "mutable": false,
         "complexType": {
@@ -812,35 +885,48 @@ export class TextField {
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [{
-              "name": "internal",
-              "text": "Used to set the role if not default textbox;"
-            }],
-          "text": ""
+          "tags": [],
+          "text": "The validation state - e.g. 'error' | 'warning' | 'success'."
         },
-        "attribute": "role",
-        "reflect": false
+        "attribute": "validation-text",
+        "reflect": false,
+        "defaultValue": "\"\""
       },
-      "hiddenInput": {
-        "type": "boolean",
+      "debounce": {
+        "type": "number",
         "mutable": false,
         "complexType": {
-          "original": "boolean",
-          "resolved": "boolean",
+          "original": "number",
+          "resolved": "number",
           "references": {}
         },
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [{
-              "name": "internal",
-              "text": "If `true`, the hidden form input will stop rendering for form submission."
-            }],
-          "text": ""
+          "tags": [],
+          "text": "The amount of time, in milliseconds, to wait to trigger the `icChange` event after each keystroke."
         },
-        "attribute": "hidden-input",
+        "attribute": "debounce",
         "reflect": false,
-        "defaultValue": "true"
+        "defaultValue": "0"
+      },
+      "value": {
+        "type": "string",
+        "mutable": true,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [],
+          "text": "The value of the text field."
+        },
+        "attribute": "value",
+        "reflect": true,
+        "defaultValue": "\"\""
       }
     };
   }
@@ -848,38 +934,44 @@ export class TextField {
     return {
       "numChars": {},
       "maxLengthExceeded": {},
+      "maxValueExceeded": {},
+      "minValueUnattained": {},
       "initialValue": {}
     };
   }
   static get events() {
     return [{
-        "method": "icKeydown",
-        "name": "icKeydown",
+        "method": "getValidationText",
+        "name": "getValidationText",
         "bubbles": true,
         "cancelable": true,
         "composed": true,
         "docs": {
-          "tags": [],
-          "text": "Emitted when a keydown event occurred."
+          "tags": [{
+              "name": "internal",
+              "text": "Emitted when the validationInlineInternal is `true`"
+            }],
+          "text": ""
         },
         "complexType": {
-          "original": "{ event: KeyboardEvent }",
-          "resolved": "{ event: KeyboardEvent; }",
+          "original": "IcValueEventDetail",
+          "resolved": "IcValueEventDetail",
           "references": {
-            "KeyboardEvent": {
-              "location": "global"
+            "IcValueEventDetail": {
+              "location": "import",
+              "path": "../../utils/types"
             }
           }
         }
       }, {
-        "method": "icInput",
-        "name": "icInput",
+        "method": "icBlur",
+        "name": "icBlur",
         "bubbles": true,
         "cancelable": true,
         "composed": true,
         "docs": {
           "tags": [],
-          "text": "Emitted when a keyboard input occurred."
+          "text": "Emitted when input loses focus."
         },
         "complexType": {
           "original": "IcValueEventDetail",
@@ -887,19 +979,19 @@ export class TextField {
           "references": {
             "IcValueEventDetail": {
               "location": "import",
-              "path": "../../interface"
+              "path": "../../utils/types"
             }
           }
         }
       }, {
-        "method": "icBlur",
-        "name": "icBlur",
+        "method": "icChange",
+        "name": "icChange",
         "bubbles": true,
         "cancelable": true,
         "composed": true,
         "docs": {
           "tags": [],
-          "text": "Emitted when input loses focus."
+          "text": "Emitted when the value has changed."
         },
         "complexType": {
           "original": "IcValueEventDetail",
@@ -907,7 +999,7 @@ export class TextField {
           "references": {
             "IcValueEventDetail": {
               "location": "import",
-              "path": "../../interface"
+              "path": "../../utils/types"
             }
           }
         }
@@ -927,19 +1019,19 @@ export class TextField {
           "references": {
             "IcValueEventDetail": {
               "location": "import",
-              "path": "../../interface"
+              "path": "../../utils/types"
             }
           }
         }
       }, {
-        "method": "icChange",
-        "name": "icChange",
+        "method": "icInput",
+        "name": "icInput",
         "bubbles": true,
         "cancelable": true,
         "composed": true,
         "docs": {
           "tags": [],
-          "text": "Emitted when the value has changed."
+          "text": "Emitted when a keyboard input occurred."
         },
         "complexType": {
           "original": "IcValueEventDetail",
@@ -947,7 +1039,26 @@ export class TextField {
           "references": {
             "IcValueEventDetail": {
               "location": "import",
-              "path": "../../interface"
+              "path": "../../utils/types"
+            }
+          }
+        }
+      }, {
+        "method": "icKeydown",
+        "name": "icKeydown",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Emitted when a keydown event occurred."
+        },
+        "complexType": {
+          "original": "{ event: KeyboardEvent }",
+          "resolved": "{ event: KeyboardEvent; }",
+          "references": {
+            "KeyboardEvent": {
+              "location": "global"
             }
           }
         }